Files
manga-recap-pipeline/caveats/CLAUDE.md
T
kami de7e34bc0f File the over-merge findings: two tracklet fixes, and cosine is not identity
The user checked the lead's crops. LIM SEONHO's 36 assignments cover at least
six different men, a chibi and a cat, so 36 of 68 is a bug. 22 came from
native resolves and 14 from reconcile merges.

Two fixes are written in the orchestrator repo, tested, not deployed and not
run on a GPU. `link_tracklets` caps a tracklet's panel span, because `window`
bounded each pair while transitivity was unbounded and the lead's 22 native
assignments came from tracklets spanning 22 and 30 panels. And one shared
appearance tokenizer drops generic words, because whole chains hung on the
word `short` and one pair on the word `hair`.

The obvious third fix is ruled out by measurement. Over all 22 crop
embeddings, the cat scores up to 0.82 against men, two different men score
0.93, and the highest pair is 0.96. No threshold separates them, so
crop-to-crop cosine is not a link signal.

Item 1 of the agreed plan, sending the live cast instead of a cosine top-k
gallery, is not started.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 23:35:15 +04:00

3.5 KiB

caveats/

One entry per known breakage, deferral, or trap. An entry names what fails, who pays for it, and the concrete trigger that makes fixing it worth the time.

A caveat that gets resolved moves to decisions/ or gets deleted. A caveat with no revisit trigger is a complaint, so give it one or drop it.

Rules for this directory

  • One file per source, one ## section per limit.
  • State the limit as what fails, not as a topic. "Reconcile deletes the losing character" beats "Reconcile".
  • Delete an entry the moment its trigger fires and the work lands.

Index

caveat source
Reconcile deletes the losing character irreversibly AUDIT.md
Clearing a stage does not undo what it wrote AUDIT.md
ComfyUI uses the GPU outside the session mutex AUDIT.md
The JSON repair pass can fabricate dialogue AUDIT.md
/review/preview pins a solo clip into the final video AUDIT.md
Stored embeddings carry no model or pooling version AUDIT.md
Worker endpoints block the event loop AUDIT.md
SQLite has no busy timeout, so parallelism will surface as lock errors AUDIT.md
layers runs after tts, so pipelined solo beats lose parallax AUDIT.md
completed means something different in each stage AUDIT.md
Identity worker caches characters the orchestrator has deleted AUDIT.md
A character seen once gets no assignment at all AUDIT.md
MinIO credentials are hardcoded in committed source AUDIT.md
Assemble marks a job completed with no clips AUDIT.md
Reviewer timestamps drift against the crossfaded video AUDIT.md
Nothing attributes a speaker in a multi-character panel 2026-08-11 run
One character id covers two different women 2026-08-11 run
The character registry carries five weeks of wrong names 2026-08-11 run
One invented word still halts the chapter 2026-08-11 run
A completed job keeps the error from an earlier failure 2026-08-11 run
layers reports success on an empty bucket 2026-08-11 run
Every bbox is read in the wrong coordinate space resolved, rerun pending
Identity cannot say "a person with no name" 2026-08-12 panel 7
Vision does not separate a background extra from cast 2026-08-12 panel 7
Cast reference profiles are enrolled from wrong crops 2026-08-12 panel 7
Identity coverage has fallen on every run since the gate landed before the next downstream run
Embedding cosine on a person crop cannot tell two people apart before building on cosine