# NEXT

Updated 2026-08-11. Replaces the old `HANDOFF.md`.

## State

Audit Phase 1 is implemented and green. Nothing is half-finished.

Changed on workpc: `worker_scene.py`, `worker_script.py`, `worker_vision.py`, `session_manager.py`.
Changed on homesrv (`/mnt/server/home/kami/docker-apps/manga-infra/orchestrator/`): `tracklets.py`,
`correctness.py`, `db.py`, `service.py`, `session_proxy.py`, `test_script_verify.py`,
`test_name_binding.py`.

What landed and why: `decisions/audit-phase1.md`. What was left open: `caveats/audit-open.md`.

Verification: CPU-only self-checks and the orchestrator test suite. 108 orchestrator tests pass
(`test_api.py` is excluded on workpc because fastapi is not installed in this venv). No GPU work ran
and no pipeline ran, so none of this is confirmed against a real chapter.

The orchestrator changes are edited in place on the SSHFS mount and are NOT committed. Its git root is
`/mnt/server/home/kami/docker-apps`. Its container also needs a rebuild or restart to pick them up.

## Next

1. Commit the orchestrator half in `/mnt/server/home/kami/docker-apps` and restart the container.
2. Run one labeled chapter end to end and record the baseline numbers from `ROADMAP.md`, especially the
   share of narrated lines with a named speaker. That number is the check on the largest Phase 1 fix.
3. Start Phase 2 from `ROADMAP.md`. Set SQLite `busy_timeout` before any concurrency work
   (`caveats/audit-open.md#sqlite-locking`).

## Open questions

Four Phase 1 items have no Vikunja task and were not created, because writing to the tracker was not
asked for: the speaker contract fix, the verifier rules, the tracklet constraints, and the flag
resolution path. Only [#203] existed and is now closed by `decisions/audit-phase1.md#unlocked-model-load`.

Three audit items are deliberately not done and are recorded as caveats rather than silently dropped:
honest stage clearing, ComfyUI under the session mutex, and reversible identity merges. Each needs a
design decision, not a patch.

Carried over from the reconstruction: `.venv` needs the ROCm torch wheel reinstalled, and `dots.tts/`,
`legacy/`, `RESUME_SPEC.md`, `pipeline-design-notes.md`, `spec-v2.md` are unrecoverable.