Files
manga-recap-pipeline/caveats/CLAUDE.md
T
kami 54bd126cd7 Order bbox corners, and find the ground truth is for another manga
`_bbox_to_pixels` sorts each coordinate pair after clamping. Run B returned
`p007 person_1` as `[226, 417, 130, 551]`, x1 > x2, which cropped to nothing
and lost that detection silently. The third GPU cycle came back with 0
degenerate boxes over 119 detections.

The plan's first item cannot run as written. All 145 rows of `identity_labels`
belong to chapter 8ca8249b, a different manga. Chapter 7c944dd4 has none, so
`/review/identity` reports `accuracy: null`. Scoring 8ca8249b gives 7/138 on
an identity run that predates every fix.

The cycle also settled the coverage question. All 68 assignments landed on
face-bearing detections and none on a gated one, so recall among face-bearing
detections is 96%, up from 82%. Coverage is the `has_face` gate and nothing
else. What is now open is precision: the lead holds 36 of 68 assignments.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 22:21:52 +04:00

3.4 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