W5 — CLI hardening: init/forward [P2]

[mmcky]

Sub-issue of the 2026-08-10 work-plan tracker.

• init -f is repo-scoped: single-file mode rewrites .translate/config.yml and clobbers localized non-markdown assets #134/init: gap-fill into an existing edition needs manual clobber-recovery and TOC insertion #142 — init -f/gap-fill: copy-if-missing semantics (never overwrite existing target files), --copy-assets opt-in, and TOC insertion via init: gap-fill into an existing edition needs manual clobber-recovery and TOC insertion #142's source-order algorithm (also serves D2 if "yes"). writeConfig half already fixed (writeConfig: merge over the existing config.yml instead of rebuilding it #246); the Phase-4 clobber at init.ts:495 is the live half
• forward discovery misses content-stale files on unbootstrapped repos (found 12 of 41), and the summary miscounts what it did #106 — forward --from-status (consume status --check-sync output), content-triage fallback when state is absent, and a truthful run summary (bucket by what the pipeline did, not by triage verdict)
• translate init produced structurally transposed output (code-cell ↔ math) on 1 of 3 language runs; parity guard caught it #203 — bounded retry-on-parity-failure in init (the guard caught a transposed document; the ask is retry before hard-fail, plus a measured failure rate)
• F11 (from tech-debt T7: Give the CLI a shared spine: config precedence, one worker pool, shared state #175, pulled forward) — read .translate/config.yml's target-language; three commands hardcode zh-cn, so forward with no -l runs a French edition as Chinese, silently
• forward resync wrapped an entire document in a code fence and mis-derived its title (ak_aiyagari, v0.17.0) #118 residual — title-derivation sanity check (derived title must correspond to an actual H1); the fence-wrap class is already refused by checkStructuralParity on the forward path (forward.ts:384)

Member issues: #106 #118 #134 #142 #203 · part of #175

---

Generated by Claude Code