Merge branch 'feature/dump-provenance' into feature/opencv5

2026-07-31 16:53:58 +02:00
parent afca0524c9 a667caa313
commit 890f1946bf
3 changed files with 266 additions and 25 deletions
@@ -1521,9 +1521,11 @@ Persist pipeline state at the point where the expensive work ends.
  variable-length HDF5 types and reads straight into numpy.
 - Stores per frame: `timestamp_sec`, `frame_idx`, `is_cut`, `is_scene_boundary`.
  Per face: `embedding` [N,512], `bbox` [N,4], `landmarks` [N,10], `confidence`.
- Invariants: embeddings unit-norm; `face_offset` contiguous; bboxes already in
-  original resolution; frames with no faces still get a row so timestamps stay
-  dense; EOF sentinels not written.
+- Invariants: embeddings unit-norm; `face_offset` contiguous; bboxes and
+  landmarks in **decoded-frame** pixels with `bbox_upscale` recorded alongside
+  (the dump is a faithful tap, so it does not transform what the tracker saw —
+  see VR-010); frames with no faces still get a row so timestamps stay dense;
+  EOF sentinels not written.
 - Enabled by `--dump-embeddings out.h5`; teeing must not perturb the live result.

 Schema owned by [`scripts/optimizer/SCHEMA.md`](../scripts/optimizer/SCHEMA.md).