dtourolleandClaude Opus 5
a2c699a844
Making SceneDetectorFunc a pass-through does not work. TransNetV2 buffers 100 dense frames before it can score any of them and trusts only each window's centre, so a boundary at time T is not known until roughly 3.3s after T at 30 fps. The face pipeline runs on a parallel branch and has long since passed T. An association hint that arrives after the association is worthless. Three options recorded with their costs: two-pass (correct, doubles the decode that already dominates runtime), delaying the face branch (couples the two branches' timing, which invites heisenbugs under backpressure), or leaving it unwired. Leaving it unwired costs less than it looks, which is what makes this a decision rather than a defect. The redesign made cuts and boundaries do the same thing — both say "spatial continuity is broken, associate on embedding" — so TransNetV2 adds nothing over the histogram except on transitions the histogram cannot see: slow dissolves and fades. That gap is real but narrow. Where TransNetV2 still earns its cost is AR-019, whose promotion gate wants a span free of cuts and boundaries. A late answer is fine there, because promotion happens on track confirmation rather than per frame — so it can be wired offline against the collected boundary list, off the hot path entirely. Recommendation: leave the association path on is_cut alone, wire boundaries into AR-019, and revisit if dissolve-heavy material shows association failures. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> TRACES: AR-010, AR-019 | SR-002
42 KiB
42 KiB
Requirements traceability matrix
Generated: 2026-07-31T12:22:20+00:00
Denominators are read from requirements.md at run time, never hardcoded. Coverage counts a requirement only when it is tagged in source and has a verification tier this repo's CI host can execute (T1, T2, T3, static).
Summary
| Metric | Value |
|---|---|
| Source files scanned | 102 |
| TRACES tags found | 95 |
| EXCEPTION tags found | 0 |
| Requirements defined | 63 |
| Requirements covered | 28 |
| Coverage | 44.4% (28/63) |
| Coverage of CI-executable scope | 53.8% (28/52) |
| Tagged but unexecuted in CI | 3 |
| Orphan tags | 0 |
By type
| Type | Covered | Tagged but unexecuted | Defined |
|---|---|---|---|
| AR | 15 | 0 | 27 |
| DP | 2 | 0 | 8 |
| IR | 8 | 0 | 8 |
| GR | 3 | 0 | 9 |
| VR | 0 | 3 | 11 |
- UT tags present (separate taxonomy, not counted in coverage): UT-001, UT-101, UT-102, UT-103, UT-104
- IT tags present (separate taxonomy, not counted in coverage): IT-001
- PR tags present (separate taxonomy, not counted in coverage): PR-002, PR-004
- SR tags present (separate taxonomy, not counted in coverage): SR-001, SR-002, SR-003, SR-005
Not executable in CI
These requirements have no verification tier this repo's CI host can run, so a tag on them is evidence of intent, not of verification. They are never counted as covered.
| ID | Tiers | Tagged in source | Requirement |
|---|---|---|---|
| AR-027 | T4 | no | Throughput acceptable for arbitrary gallery size |
| VR-001 | out-of-ci | yes | HDF5 post-inference dump at the embedded-frame boundary |
| VR-002 | out-of-ci | yes | Replay drives the real KPN nodes, not a reimplementation |
| VR-003 | out-of-ci | yes | Scoring: micro-F1 against X-Ray, precision/recall logged at every eva… |
| VR-004 | out-of-ci | no | Reproducible validation corpus with ground truth |
| VR-005 | out-of-ci | no | Minimum face size study — TPI/FPI vs probe size, gallery held at nati… |
| VR-006 | out-of-ci | no | Re-tune scene_threshold once native-rate decode lands |
| VR-007 | out-of-ci | no | Expansion band, clustering threshold, and deferred-pass ablation |
| VR-008 | out-of-ci | no | Gallery scaling benchmark — throughput vs gallery size |
| VR-010 | out-of-ci | no | Dump provenance attributes — embedder model, detector settings, `dens… |
| VR-011 | out-of-ci | no | Rewrite the replay harness for the post-AR-012 output contract |
Tagged but unexecuted: VR-001, VR-002, VR-003 — a test exists and is tagged, but this CI host cannot run it. Report those runs separately.
Orphan tags
A tag naming an ID requirements.md does not define. This is what renumbering produces, and what a typo produces.
None.
Requirements tracing up to nothing
A register row whose Traces to cell names no parent. Work serving no stated goal is how scope creeps in, and it is invisible unless something looks.
None.
Recorded exceptions
Deliberate, documented departures from an invariant (EXCEPTION: XX-nnn <reason>). Reported separately and never counted as coverage — an exception is a decision to be reviewed, not evidence a requirement is met.
None.
Register
| ID | Status | Tier | Traces to | Trace state | Tagged in | Requirement |
|---|---|---|---|---|---|---|
| AR-001 | Done | T3 | SR-002 | covered | src/nodes/face_detector_node.hpp |
Detect faces in sampled frames; emit bbox, confidence, 5-point landma… |
| AR-002 | Planned | unset | SR-002 | untagged | - | Minimum face size 32×32 px (VR-005 measured), expressed in **orig… |
| AR-003 | Done — `max_fac… | T1, T2, T4 | SR-002 | covered | src/config.hpp, src/nodes/face_detector_node.hpp, src/nodes/identity_matcher_node.hpp |
No fixed per-frame face cap — crowd scenes must not lose background c… |
| AR-004 | Done — KPN node… | T1, T4 | SR-002 | covered | src/main.cpp, src/nodes/identity_matcher_node.hpp, tests/test_replay_fixtures.cpp |
Backpressure: unbounded faces/frame absorbed by slowing, never by dro… |
| AR-005 | Done | T1, T3 | SR-002 | covered | src/face_utils.hpp |
Align to 112×112 via ArcFace 5-point similarity transform |
| AR-006 | Done | T3 | SR-002 | untagged | - | 512-d L2-normalised embeddings, batched |
| AR-007 | Done — `track_a… | T2 | SR-002 | covered | src/config.hpp, src/main.cpp, src/nodes/face_tracker_node.hpp |
Associate detections by IoU + embedding, with frame-dependent wei… |
| AR-008 | Done — one pool… | T2 | SR-002 | covered | src/config.hpp, src/main.cpp, src/nodes/face_tracker_node.hpp |
One track pool keyed on last_seen; no separate revival path |
| AR-009 | Done | T2 | SR-002 | untagged | - | Camera-cut detection (histogram) as an association hint |
| AR-010 | Not started — `… | T2 | SR-002 | untagged | - | Scene-boundary detection (TransNetV2) as an association hint |
| AR-011 | Planned | T1, T2 | SR-002 | untagged | - | Every model is fed the input it was trained for — cost reduced by… |
| AR-012 | Done — `src/tra… | T2 | SR-002 | covered | src/main.cpp, src/nodes/identity_matcher_node.hpp, src/nodes/result_sink_node.hpp, src/track_registry.hpp, tests/test_replay_fixtures.cpp, tests/test_track_registry.cpp |
Presence follows track extent, not per-frame recognition |
| AR-013 | Done — `last_se… | T2 | SR-002 | covered | src/track_registry.hpp, tests/test_replay_fixtures.cpp, tests/test_track_registry.cpp |
last_seen optional state machine; window ends at last sighting, nev… |
| AR-014 | Done — swap clo… | T2 | SR-002 | covered | src/track_registry.hpp, tests/test_track_registry.cpp |
Belief swap A→B terminates the track and starts a new one |
| AR-015 | Done — reverse … | T2 | SR-002 | covered | src/track_registry.hpp, tests/test_track_registry.cpp |
Two live tracks owned by one actor ⇒ treat as a detected cut, re-asso… |
| AR-016 | Done — `flush()… | T2 | SR-002 | covered | src/main.cpp, src/nodes/result_sink_node.hpp, src/track_registry.hpp, tests/test_track_registry.cpp |
All tracks closed at EOF — a film ends with faces on screen |
| AR-017 | Done — `DeadTra… | T1, T2 | SR-002 | covered | src/nodes/result_sink_node.hpp, src/track_registry.hpp, tests/test_track_registry.cpp |
Every presence claim carries its belief and identification route |
| AR-018 | Planned | T1, T2 | SR-005 | untagged | - | Per-subject embedding store with banded admission (novel enough, safe… |
| AR-019 | In Progress | T2 | SR-005 | untagged | - | Per-film gallery annex from owned tracks; acquires the non-frontal vi… |
| AR-020 | Planned | T2 | SR-005 | untagged | - | Deferred re-identification of unknown tracks against the final expand… |
| AR-021 | Planned | T2 | SR-005 | untagged | - | Cluster unknown tracks into one entity per person, under temporal can… |
| AR-022 | Planned | T1, T2 | §4 | untagged | - | Capture still-unidentified tracks: embeddings, metadata, **context cr… |
| AR-023 | Done | T1 | SR-002 | covered | src/gallery/gallery_calibration.hpp, src/nodes/identity_matcher_node.hpp |
Fit sigmoid calibration from intra/inter similarity distributions |
| AR-024 | Done — associat… | T1, static | SR-002 | covered | src/config.hpp, src/evidence_discount.hpp, src/gallery/gallery_calibration.hpp, src/main.cpp, src/nodes/face_tracker_node.hpp, src/nodes/identity_matcher_node.hpp |
Always the calibrated probability, never a raw cosine — exception… |
| AR-025 | Done — log-odds… | T1 | SR-002 | covered | src/evidence_discount.hpp, src/nodes/identity_matcher_node.hpp |
Per-track Bayesian accumulation in log-odds, with correlated-observat… |
| AR-026 | In Progress | T1, T4 | SR-001 | untagged | - | All similarity computed as GEMM, including annex and deferred pass |
| AR-027 | Planned | T4 | SR-001 | untagged | - | Throughput acceptable for arbitrary gallery size |
| DP-001 | Done | T1, manual | PR-004 | covered | src/main.cpp |
One analysis core; modes are front-ends and must not fork pipeline lo… |
| DP-002 | Done | T1, manual | PR-004 | covered | src/main.cpp |
Batch CLI over one title |
| DP-003 | Planned | T1, manual | PR-004 | untagged | - | On-demand resident service with bounded, observable queue |
| DP-004 | Planned | T1, manual | PR-004 | untagged | - | Opportunistic/idle mode: external trigger, hard stop, implicit re-que… |
| DP-005 | Planned | T1, manual | PR-004 | untagged | - | Native installer, no Docker; Fedora + Arch |
| DP-006 | Planned | T1, manual | PR-003 | untagged | - | Background incremental gallery refresh on a timer |
| DP-007 | Planned | T1, manual | PR-004 | untagged | - | CI builder image, CPU-only, pinned by tag in the Gitea container regi… |
| DP-008 | Planned | T1, manual | PR-004 | untagged | - | Builder images + release jobs per backend (cpu / cuda / rocm); ship b… |
| IR-001 | Done | T1 | SR-003 | covered | src/nodes/result_sink_node.hpp |
Emit the JRay truth format as sibling .jray.json |
| IR-002 | Done — `schema_… | T1 | SR-003 | covered | src/config.hpp, src/main.cpp, src/nodes/result_sink_node.hpp |
Windows carry belief + route; extraction.* carries extinction_sec… |
| IR-003 | In Progress — s… | T1 | SR-003 | covered | src/main.cpp |
Output written after the deferred pass, not at EOF |
| IR-004 | Done — `src/aud… | T1 | SR-003 | covered | src/audio_signature.cpp, src/audio_signature.hpp, tests/test_audio_signature.cpp |
Compute the audio signature exactly per server spec §3 |
| IR-005 | Done — `tests/f… | T1 | SR-003 | covered | src/audio_signature.cpp, src/audio_signature.hpp, tests/test_audio_signature.cpp |
Golden-vector fixture shared with the plugin repo to prove bit-exactn… |
| IR-006 | Done | T1, manual | SR-001 | covered | scripts/run_from_jellyfin.py |
Jellyfin round-trip: pull pending queue, push complete results only |
| IR-007 | Done | T1 | SR-003 | covered | src/audio_signature.cpp, src/audio_signature.hpp, tests/test_audio_signature.cpp |
Media < 120 s: emit no signature, apply no sync offset — identical ru… |
| IR-008 | Done | T1 | SR-003 | covered | src/audio_signature.cpp, src/audio_signature.hpp, tests/test_audio_signature.cpp |
Emit and honour the signature's own v1: version prefix |
| GR-001 | Done | T1, T3 | SR-001, SR-005 | covered | scripts/make_jellyfin_gallery.py |
Build gallery from Jellyfin library cast, TMDB profile fallback |
| GR-002 | Done | T1, T3 | PR-003 | covered | scripts/make_jellyfin_gallery.py |
Incremental --merge refresh without re-embedding known actors |
| GR-003 | Planned | T1, T3 | SR-001 | untagged | - | Report coverage: zero-image actors, under-referenced actors, dedup, c… |
| GR-004 | Done — basename… | T1, T3 | SR-001 | covered | scripts/filter_gallery.py, scripts/make_gallery.py, scripts/make_jellyfin_gallery.py, scripts/movienet_eval.py, scripts/optimizer/fetch_missing_actors.py, scripts/optimizer/optimize.py, scripts/optimizer/reembed_gallery.py, scripts/optimizer/replay.py, scripts/sae_embed_loader.py, scripts/sae_gallery.py, scripts/sae_stamp.py, scripts/stamp_gallery.py, src/config.hpp, src/gallery/embedder_stamp.cpp, src/gallery/embedder_stamp.hpp, src/gallery/gallery_builder.cpp, src/gallery/gallery_store.cpp, src/kpn_bindings.cpp, src/main.cpp, src/nodes/embedding_dump_node.hpp, src/scene_preview.cpp, src/types.hpp, tests/test_gallery_store.cpp |
Stamp embedder identity into the gallery; hard startup error on m… |
| GR-005 | Done | T1, T3 | SR-005 | untagged | - | Gallery data never leaves the instance |
| GR-006 | Planned | T1 | SR-005 | untagged | - | Provenance tiers: baked / harvested / confirmed, distinguishable per … |
| GR-007 | Planned | T1 | SR-005 | untagged | - | Persist harvested embeddings flagged and reviewable, never silent… |
| GR-008 | Planned | T1 | SR-005 | untagged | - | Flag distributional outliers among an actor's references (poisoning g… |
| GR-009 | TBD | T1 | §4 | untagged | - | Human-confirmed associations persist and improve future extractions |
| VR-001 | Done | out-of-ci | PR-002 | tagged, unexecuted | src/nodes/embedding_dump_node.hpp, tests/test_replay_fixtures.cpp |
HDF5 post-inference dump at the embedded-frame boundary |
| VR-002 | Done — replay d… | out-of-ci | PR-002 | tagged, unexecuted | scripts/optimizer/replay.py, tests/test_replay_fixtures.cpp |
Replay drives the real KPN nodes, not a reimplementation |
| VR-003 | Done | out-of-ci | PR-002 | tagged, unexecuted | scripts/optimizer/second_score.py |
Scoring: micro-F1 against X-Ray, precision/recall logged at every eva… |
| VR-004 | Done | out-of-ci | PR-002 | untagged | - | Reproducible validation corpus with ground truth |
| VR-005 | Done — knee at … | out-of-ci | PR-002 | untagged | - | Minimum face size study — TPI/FPI vs probe size, gallery held at nati… |
| VR-006 | Planned | out-of-ci | PR-002 | untagged | - | Re-tune scene_threshold once native-rate decode lands |
| VR-007 | Planned | out-of-ci | PR-002 | untagged | - | Expansion band, clustering threshold, and deferred-pass ablation |
| VR-008 | Planned | out-of-ci | PR-002 | untagged | - | Gallery scaling benchmark — throughput vs gallery size |
| VR-009 | Planned | T1, out-of-ci | PR-002 | untagged | - | Verify accumulated posteriors are calibrated against held-out tracks |
| VR-010 | Planned | out-of-ci | PR-002 | untagged | - | Dump provenance attributes — embedder model, detector settings, `dens… |
| VR-011 | Planned | out-of-ci | PR-002 | untagged | - | Rewrite the replay harness for the post-AR-012 output contract |
Detailed mapping
AR-001
Locations: 1
src/nodes/face_detector_node.hpp:2—Unknown
AR-003
Locations: 3
src/config.hpp:44—Unknownsrc/nodes/face_detector_node.hpp:47—private:src/nodes/identity_matcher_node.hpp:149—std::vector<float> host_query(static_cast<size_t>(kMaxFaces) * 512);
AR-004
Locations: 3
src/main.cpp:285—std::lock_guard<std::mutex> lk(event_mtx);src/nodes/identity_matcher_node.hpp:149—std::vector<float> host_query(static_cast<size_t>(kMaxFaces) * 512);tests/test_replay_fixtures.cpp:3—Unknown
AR-005
Locations: 1
src/face_utils.hpp:2—inline cv::Mat align_face(const cv::Mat& img,
AR-007
Locations: 3
src/config.hpp:108—Unknownsrc/main.cpp:199—reg_cfg, EvidenceDiscounter(same_person));src/nodes/face_tracker_node.hpp:2—Unknown
AR-008
Locations: 3
src/config.hpp:108—Unknownsrc/main.cpp:199—reg_cfg, EvidenceDiscounter(same_person));src/nodes/face_tracker_node.hpp:2—Unknown
AR-012
Locations: 9
src/main.cpp:199—reg_cfg, EvidenceDiscounter(same_person));src/main.cpp:216—reg_cfg, EvidenceDiscounter(same_person));src/nodes/identity_matcher_node.hpp:119—const GalleryCalibration& calibration() const { return cal_; }src/nodes/identity_matcher_node.hpp:255—Unknownsrc/nodes/result_sink_node.hpp:49—static constexpr std::string_view label() { return "result_sink"; }src/nodes/result_sink_node.hpp:161—struct ActorMeta { std::string name, imdb_id, tmdb_id, jellyfin_id; };src/track_registry.hpp:2—Unknowntests/test_replay_fixtures.cpp:3—Unknowntests/test_track_registry.cpp:3—Unknown
AR-013
Locations: 3
src/track_registry.hpp:2—Unknowntests/test_replay_fixtures.cpp:3—Unknowntests/test_track_registry.cpp:3—Unknown
AR-014
Locations: 2
src/track_registry.hpp:2—Unknowntests/test_track_registry.cpp:3—Unknown
AR-015
Locations: 2
src/track_registry.hpp:2—Unknowntests/test_track_registry.cpp:3—Unknown
AR-016
Locations: 4
src/main.cpp:216—reg_cfg, EvidenceDiscounter(same_person));src/nodes/result_sink_node.hpp:63—void set_pre_write_hook(std::function<void(double)> fn) { pre_write_ = std::move(fn); }src/track_registry.hpp:2—Unknowntests/test_track_registry.cpp:3—Unknown
AR-017
Locations: 3
src/nodes/result_sink_node.hpp:49—static constexpr std::string_view label() { return "result_sink"; }src/track_registry.hpp:2—Unknowntests/test_track_registry.cpp:3—Unknown
AR-023
Locations: 3
src/gallery/gallery_calibration.hpp:2—Unknownsrc/gallery/gallery_calibration.hpp:53—float boundary_at(float p = 0.5f, float log_prior_odds = 0.f) constsrc/nodes/identity_matcher_node.hpp:111—const GalleryCalibration& calibration() const { return cal_; }
AR-024
Locations: 6
src/config.hpp:108—Unknownsrc/evidence_discount.hpp:2—Unknownsrc/gallery/gallery_calibration.hpp:53—float boundary_at(float p = 0.5f, float log_prior_odds = 0.f) constsrc/main.cpp:199—reg_cfg, EvidenceDiscounter(same_person));src/nodes/face_tracker_node.hpp:2—Unknownsrc/nodes/identity_matcher_node.hpp:111—const GalleryCalibration& calibration() const { return cal_; }
AR-025
Locations: 3
src/evidence_discount.hpp:2—Unknownsrc/nodes/identity_matcher_node.hpp:119—const GalleryCalibration& calibration() const { return cal_; }src/nodes/identity_matcher_node.hpp:255—Unknown
DP-001
Locations: 1
src/main.cpp:3—Unknown
DP-002
Locations: 1
src/main.cpp:3—Unknown
GR-001
Locations: 1
scripts/make_jellyfin_gallery.py:4—Unknown
GR-002
Locations: 1
scripts/make_jellyfin_gallery.py:4—Unknown
GR-004
Locations: 44
src/config.hpp:54—Unknownsrc/gallery/embedder_stamp.cpp:1—Unknownsrc/gallery/embedder_stamp.hpp:2—Unknownsrc/gallery/gallery_builder.cpp:45—ActorGallery build_gallery(const BuildConfig& cfg)src/gallery/gallery_store.cpp:82—H5::StrType str(H5::PredType::C_S1, H5T_VARIABLE);src/gallery/gallery_store.cpp:167—H5::DataSpace scalar(H5S_SCALAR);src/gallery/gallery_store.cpp:219—Unknownsrc/kpn_bindings.cpp:167—Unknownsrc/kpn_bindings.cpp:217—Unknownsrc/main.cpp:174—Unknownsrc/nodes/embedding_dump_node.hpp:30—static constexpr std::string_view label() { return "embedding_dump"; }src/nodes/embedding_dump_node.hpp:102—H5::StrType str(H5::PredType::C_S1, H5T_VARIABLE);src/scene_preview.cpp:133—int main(int argc, char** argv)src/types.hpp:141—struct Actortests/test_gallery_store.cpp:182—TempFile tf("gallery_stamped.h5");tests/test_gallery_store.cpp:201—TempFile tf("gallery_stamped.h5");tests/test_gallery_store.cpp:219—TempFile tf("gallery_unstamped.h5");tests/test_gallery_store.cpp:240—TempFile tf("gallery_json_stamp.json");tests/test_gallery_store.cpp:252—Unknowntests/test_gallery_store.cpp:268—Unknowntests/test_gallery_store.cpp:300—Unknowntests/test_gallery_store.cpp:309—Unknowntests/test_gallery_store.cpp:333—Unknowntests/test_gallery_store.cpp:348—Unknowntests/test_gallery_store.cpp:367—Unknowntests/test_gallery_store.cpp:384—TempFile tf("fake_model.onnx");scripts/filter_gallery.py:80—if actor_jellyfin_id(a) in cast_ids]scripts/make_gallery.py:181—Unknownscripts/make_jellyfin_gallery.py:448—Unknownscripts/make_jellyfin_gallery.py:456—Unknownscripts/movienet_eval.py:65—with open(args.gt) as f:scripts/optimizer/fetch_missing_actors.py:62—def fetch(missing_path, out_path, token, build_dir, models_dir, arcface,scripts/optimizer/fetch_missing_actors.py:109—def merge(base_path, add_path, out_path):scripts/optimizer/fetch_missing_actors.py:123—def merge(base_path, add_path, out_path):scripts/optimizer/optimize.py:186—Unknownscripts/optimizer/optimize.py:202—if not Path(f["dump"]).exists():scripts/optimizer/reembed_gallery.py:62—for i, a in enumerate(ref["actors"], 1):scripts/optimizer/replay.py:113—Unknownscripts/optimizer/replay.py:252—Unknownscripts/sae_embed_loader.py:22—return arcface if arcface else str(Path(models_dir) / DEFAULT_ARCFACE)scripts/sae_gallery.py:171—if not _stamp_empty(embedder):scripts/sae_gallery.py:199—for a in range(len(offset)):scripts/sae_stamp.py:3—Unknownscripts/stamp_gallery.py:4—Unknown
IR-001
Locations: 1
src/nodes/result_sink_node.hpp:2—Unknown
IR-002
Locations: 5
src/config.hpp:20—struct Configsrc/main.cpp:216—reg_cfg, EvidenceDiscounter(same_person));src/nodes/result_sink_node.hpp:49—static constexpr std::string_view label() { return "result_sink"; }src/nodes/result_sink_node.hpp:122—void write_output()src/nodes/result_sink_node.hpp:161—struct ActorMeta { std::string name, imdb_id, tmdb_id, jellyfin_id; };
IR-003
Locations: 1
src/main.cpp:216—reg_cfg, EvidenceDiscounter(same_person));
IR-004
Locations: 16
src/audio_signature.cpp:3—Unknownsrc/audio_signature.cpp:265—std::vector<std::uint8_t> pack_frames(const std::vector<float>& mono)src/audio_signature.cpp:320—std::optional<std::string> signature_from_mono(const std::vector<float>& mono)src/audio_signature.cpp:327—std::optional<std::vector<float>> decode_centre_window(const std::string& path)src/audio_signature.cpp:421—std::optional<std::string> compute_signature(const std::string& path)src/audio_signature.hpp:4—Unknowntests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:129—Unknowntests/test_audio_signature.cpp:151—Unknowntests/test_audio_signature.cpp:167—Unknowntests/test_audio_signature.cpp:236—Unknowntests/test_audio_signature.cpp:263—TempWav w("centred300");tests/test_audio_signature.cpp:301—Unknowntests/test_audio_signature.cpp:314—kNumBands * std::log10(1000.0 / kBandLoHz) / std::log10(kBandHiHz / kBandLoHz)));tests/test_audio_signature.cpp:328—std::vector<float> a(kWindowSamples / 50);tests/test_audio_signature.cpp:344—return base64_encode(reinterpret_cast<const std::uint8_t*>(s.data()), s.size());
IR-005
Locations: 5
src/audio_signature.cpp:421—std::optional<std::string> compute_signature(const std::string& path)src/audio_signature.hpp:4—Unknowntests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:129—Unknowntests/test_audio_signature.cpp:138—Unknown
IR-006
Locations: 1
scripts/run_from_jellyfin.py:4—Unknown
IR-007
Locations: 8
src/audio_signature.cpp:3—Unknownsrc/audio_signature.cpp:327—std::optional<std::vector<float>> decode_centre_window(const std::string& path)src/audio_signature.cpp:421—std::optional<std::string> compute_signature(const std::string& path)src/audio_signature.hpp:4—Unknowntests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:201—TempWav w("short30");tests/test_audio_signature.cpp:219—TempWav w("exact120");tests/test_audio_signature.cpp:229—TempWav w("exact120");
IR-008
Locations: 7
src/audio_signature.cpp:3—Unknownsrc/audio_signature.cpp:320—std::optional<std::string> signature_from_mono(const std::vector<float>& mono)src/audio_signature.cpp:421—std::optional<std::string> compute_signature(const std::string& path)src/audio_signature.hpp:4—Unknowntests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:129—Unknowntests/test_audio_signature.cpp:167—Unknown
IT-001
Locations: 1
tests/test_replay_fixtures.cpp:3—Unknown
PR-002
Locations: 3
src/nodes/embedding_dump_node.hpp:2—Unknownscripts/optimizer/replay.py:5—Reads an embedding dump (scripts/optimizer/SCHEMA.md), feeds each frame as anscripts/optimizer/second_score.py:5—Unknown
PR-004
Locations: 1
src/main.cpp:3—Unknown
SR-001
Locations: 46
src/config.hpp:54—Unknownsrc/gallery/embedder_stamp.cpp:1—Unknownsrc/gallery/embedder_stamp.hpp:2—Unknownsrc/gallery/gallery_builder.cpp:45—ActorGallery build_gallery(const BuildConfig& cfg)src/gallery/gallery_store.cpp:82—H5::StrType str(H5::PredType::C_S1, H5T_VARIABLE);src/gallery/gallery_store.cpp:167—H5::DataSpace scalar(H5S_SCALAR);src/gallery/gallery_store.cpp:219—Unknownsrc/kpn_bindings.cpp:167—Unknownsrc/kpn_bindings.cpp:217—Unknownsrc/main.cpp:174—Unknownsrc/nodes/embedding_dump_node.hpp:30—static constexpr std::string_view label() { return "embedding_dump"; }src/nodes/embedding_dump_node.hpp:102—H5::StrType str(H5::PredType::C_S1, H5T_VARIABLE);src/scene_preview.cpp:133—int main(int argc, char** argv)src/types.hpp:141—struct Actortests/test_gallery_store.cpp:182—TempFile tf("gallery_stamped.h5");tests/test_gallery_store.cpp:201—TempFile tf("gallery_stamped.h5");tests/test_gallery_store.cpp:219—TempFile tf("gallery_unstamped.h5");tests/test_gallery_store.cpp:240—TempFile tf("gallery_json_stamp.json");tests/test_gallery_store.cpp:252—Unknowntests/test_gallery_store.cpp:268—Unknowntests/test_gallery_store.cpp:300—Unknowntests/test_gallery_store.cpp:309—Unknowntests/test_gallery_store.cpp:333—Unknowntests/test_gallery_store.cpp:348—Unknowntests/test_gallery_store.cpp:367—Unknowntests/test_gallery_store.cpp:384—TempFile tf("fake_model.onnx");scripts/filter_gallery.py:80—if actor_jellyfin_id(a) in cast_ids]scripts/make_gallery.py:181—Unknownscripts/make_jellyfin_gallery.py:4—Unknownscripts/make_jellyfin_gallery.py:448—Unknownscripts/make_jellyfin_gallery.py:456—Unknownscripts/movienet_eval.py:65—with open(args.gt) as f:scripts/optimizer/fetch_missing_actors.py:62—def fetch(missing_path, out_path, token, build_dir, models_dir, arcface,scripts/optimizer/fetch_missing_actors.py:109—def merge(base_path, add_path, out_path):scripts/optimizer/fetch_missing_actors.py:123—def merge(base_path, add_path, out_path):scripts/optimizer/optimize.py:186—Unknownscripts/optimizer/optimize.py:202—if not Path(f["dump"]).exists():scripts/optimizer/reembed_gallery.py:62—for i, a in enumerate(ref["actors"], 1):scripts/optimizer/replay.py:113—Unknownscripts/optimizer/replay.py:252—Unknownscripts/run_from_jellyfin.py:4—Unknownscripts/sae_embed_loader.py:22—return arcface if arcface else str(Path(models_dir) / DEFAULT_ARCFACE)scripts/sae_gallery.py:171—if not _stamp_empty(embedder):scripts/sae_gallery.py:199—for a in range(len(offset)):scripts/sae_stamp.py:3—Unknownscripts/stamp_gallery.py:4—Unknown
SR-002
Locations: 20
src/config.hpp:44—Unknownsrc/config.hpp:108—Unknownsrc/evidence_discount.hpp:2—Unknownsrc/face_utils.hpp:2—inline cv::Mat align_face(const cv::Mat& img,src/gallery/gallery_calibration.hpp:2—Unknownsrc/gallery/gallery_calibration.hpp:53—float boundary_at(float p = 0.5f, float log_prior_odds = 0.f) constsrc/main.cpp:199—reg_cfg, EvidenceDiscounter(same_person));src/main.cpp:216—reg_cfg, EvidenceDiscounter(same_person));src/main.cpp:285—std::lock_guard<std::mutex> lk(event_mtx);src/nodes/face_detector_node.hpp:2—Unknownsrc/nodes/face_detector_node.hpp:47—private:src/nodes/face_tracker_node.hpp:2—Unknownsrc/nodes/identity_matcher_node.hpp:111—const GalleryCalibration& calibration() const { return cal_; }src/nodes/identity_matcher_node.hpp:119—const GalleryCalibration& calibration() const { return cal_; }src/nodes/identity_matcher_node.hpp:149—std::vector<float> host_query(static_cast<size_t>(kMaxFaces) * 512);src/nodes/identity_matcher_node.hpp:255—Unknownsrc/nodes/result_sink_node.hpp:49—static constexpr std::string_view label() { return "result_sink"; }src/nodes/result_sink_node.hpp:63—void set_pre_write_hook(std::function<void(double)> fn) { pre_write_ = std::move(fn); }src/nodes/result_sink_node.hpp:161—struct ActorMeta { std::string name, imdb_id, tmdb_id, jellyfin_id; };src/track_registry.hpp:2—Unknown
SR-003
Locations: 6
src/audio_signature.cpp:3—Unknownsrc/audio_signature.hpp:4—Unknownsrc/config.hpp:20—struct Configsrc/nodes/result_sink_node.hpp:2—Unknownsrc/nodes/result_sink_node.hpp:49—static constexpr std::string_view label() { return "result_sink"; }src/nodes/result_sink_node.hpp:122—void write_output()
SR-005
Locations: 1
scripts/make_jellyfin_gallery.py:4—Unknown
UT-001
Locations: 1
tests/test_track_registry.cpp:3—Unknown
UT-101
Locations: 5
tests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:129—Unknowntests/test_audio_signature.cpp:138—Unknowntests/test_audio_signature.cpp:151—Unknowntests/test_audio_signature.cpp:167—Unknown
UT-102
Locations: 5
tests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:201—TempWav w("short30");tests/test_audio_signature.cpp:219—TempWav w("exact120");tests/test_audio_signature.cpp:229—TempWav w("exact120");tests/test_audio_signature.cpp:236—Unknown
UT-103
Locations: 2
tests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:263—TempWav w("centred300");
UT-104
Locations: 5
tests/test_audio_signature.cpp:3—Unknowntests/test_audio_signature.cpp:301—Unknowntests/test_audio_signature.cpp:314—kNumBands * std::log10(1000.0 / kBandLoHz) / std::log10(kBandHiHz / kBandLoHz)));tests/test_audio_signature.cpp:328—std::vector<float> a(kWindowSamples / 50);tests/test_audio_signature.cpp:344—return base64_encode(reinterpret_cast<const std::uint8_t*>(s.data()), s.size());
VR-001
Locations: 2
src/nodes/embedding_dump_node.hpp:2—Unknowntests/test_replay_fixtures.cpp:3—Unknown
VR-002
Locations: 2
tests/test_replay_fixtures.cpp:3—Unknownscripts/optimizer/replay.py:5—Reads an embedding dump (scripts/optimizer/SCHEMA.md), feeds each frame as an
VR-003
Locations: 1
scripts/optimizer/second_score.py:5—Unknown
Tag diagnostics
Malformed tags:
scripts/filter_gallery.py:80— {'ignored': ['— a filtered gallery holds the SAME vectors as its']}scripts/make_gallery.py:181— {'ignored': ['— stamp with the model actually loaded', 'resolved']}scripts/make_jellyfin_gallery.py:456— {'ignored': ["— --merge keeps the existing actors' vectors and"]}scripts/movienet_eval.py:65— {'ignored': ['— match() below is a bare dot product against the']}scripts/optimizer/fetch_missing_actors.py:109— {'ignored': ['— the legacy JSON gallery carries the same stamp as']}scripts/optimizer/fetch_missing_actors.py:123— {'ignored': ['— merging two galleries from different models makes']}scripts/optimizer/optimize.py:202— {'ignored': ['— every (dump', 'gallery) pair is checked ONCE here']}scripts/optimizer/reembed_gallery.py:62— {'ignored': ['— this script exists to produce a gallery in a']}scripts/optimizer/replay.py:113— {'ignored': ['— checked here', 'before any network is built', 'so a']}scripts/optimizer/replay.py:252— {'ignored': ['— promote an unprovable gallery/dump binding from a']}scripts/sae_embed_loader.py:22— {'ignored': ['— single source of truth for "which model is this"']}scripts/sae_gallery.py:171— {'ignored': ['— omitted entirely when unknown', 'so "unstamped"']}scripts/sae_gallery.py:199— {'ignored': ['— carried through so a derived gallery (filter']}
Groups mixing requirement types (pipe separates types):
src/main.cpp:216— {'group': ['AR-012', 'AR-016', 'IR-002', 'IR-003']}src/nodes/result_sink_node.hpp:49— {'group': ['AR-012', 'AR-017', 'IR-002']}src/nodes/result_sink_node.hpp:161— {'group': ['AR-012', 'IR-002']}tests/test_replay_fixtures.cpp:3— {'group': ['AR-012', 'AR-013', 'AR-004', 'VR-001', 'VR-002']}