manga-recap-pipeline/HANDOFF.md

HANDOFF: repo reconstructed from agent transcripts (2026-08-11)

What was asked

The working copy at /home/kami/Programs/n8n-worker was deleted with rm, including .git. This repo is the workpc GPU-compute half of the manga pipeline. The ask was to rebuild it from the transcripts on disk, at minimum the transport layer and the pipeline flow.

Sources used

No backup and no remote survived. ~/.local/share/Trash is empty. No copy exists under /home/kami, /mnt/D, or /mnt/server. Gitea (/mnt/server/mnt/hdd2/gitea/git/repositories/) holds only correx, hexis, maven, model-training, muzick, orchestra, and test-e2e. There is no n8n-worker mirror.

Reconstruction replays three histories into one timeline, ordered by timestamp:

1. Claude Code transcripts, 25 sessions in ~/.claude/projects/-home-kami-Programs-n8n-worker/*.jsonl. Contributes Write and Edit content, full-file Read results, and @-mention attachments.
2. Codex rollouts, 5 sessions with cwd=/home/kami/Programs/n8n-worker under ~/.codex/sessions/2026/07/{13,15,16,18}/rollout-*.jsonl. Contributes 26 apply_patch blocks. The 4 that the log marks Script failed are skipped. These carry the 2026-07-18 correctness work (_dialogue_envelope, _normalize_claims, _annotate_speaker_methods, SOM_ATTRIBUTION=1) that exists in no Claude transcript.
3. ~/.claude/file-history/<session>/<hash>@vN pre-edit blobs, used as cross-checks only.

Scripts live in /tmp/claude-1000/-home-kami-Programs-n8n-worker/6a35d5d8-9f44-4412-955c-9cf088737ad5/scratchpad/. replay2.py is the merged replay. codex.py extracts and applies codex patches. backups.py compares against file-history. recon_final/_log.json holds the per-file event log.

Verification

• Replayed to 2026-07-18T13:13:44Z, line counts match the wc -l recorded in the transcript at that moment, for all 10 files it covered. crop 326, identity 314, layers 99, render 996, scene 159, script 300, tts 231, vision 871, session_manager 238, transport 216.
• Byte sizes match the ls -l recorded by the same command. AGENTS.md 867, CLAUDE.md 3678, manga-recap-pipeline-spec.md 11413, plan.md 16511, spec-v3.md 26170. .gitignore is 53.
• 18 files are byte-identical to their newest file-history blob. The 4 that differ (render, script, tts, spec-v3) differ only by edits made after that blob was taken.
• python3 -m py_compile *.py scripts/*.py attic/*.py passes. bash -n passes on all 3 shell scripts. Runtime self-checks such as python worker_vision.py were NOT run, because .venv/ is gone.

Recovered (live tree)

Workers worker_{crop,vision,identity,scene,script,tts,layers,render}.py, the GPU mutex session_manager.py, transport.py, helpers bubble_detect.py, face_detect.py, collage.py, test_vision_parse.py, start_workers.sh, systemd/install.sh, scripts/{analyze_video_frames.sh,pick_tts_voice.py}, requirements.txt, .gitignore, and the docs AGENTS.md, CLAUDE.md, plan.md, spec-v3.md, spec-correctness.md, manga-recap-pipeline-spec.md, identity-rework-task.md.

attic/ holds files that had been deleted from the tree before the rm. They are kept but not live: worker_ocr.py, worker_parse.py, plan-workpc.md, char-recognition.md.

Still open

• .venv/ is gone. Rebuild with python -m venv .venv && .venv/bin/pip install -r requirements.txt. The ROCm torch wheel is not pinned in requirements.txt, so install it the way workpc had it.
• dots.tts/ (gitignored external checkout) and legacy/ (pre-rewrite workers, moved there 2026-07-13) are not recoverable from transcripts. Re-clone dots.tts if TTS is needed.
• RESUME_SPEC.md, pipeline-design-notes.md, and spec-v2.md are unrecoverable. Neither agent ever read them in full. All three were already deleted from the working tree as of 2026-07-17.
• Git history is gone. A fresh git init plus one commit replaces it. Old commits are not recoverable.
• Two replay gaps were left unpatched. One Edit MISS in worker_render.py on 2026-07-14, and one orphan Edit against attic/plan-workpc.md on 2026-07-13. Both files were later replaced by a full-file snapshot, so the final content stays anchored.
• Edits made outside Claude and codex after 2026-07-18T14:35Z (the last recorded write) cannot be detected. unknown: whether any exist.

Next command

cd /home/kami/Programs/n8n-worker
python -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python worker_vision.py     # per-file __main__ self-checks, then ./start_workers.sh