transcript-lake rebuild

Invocation#

transcript-lake [--data-dir <path>] rebuild --to <empty-path> [--source <runtime>]

Purpose#

Replay source history through the masker into a separate empty recovery Lake.

Inputs and options#

• Required --to <empty-path> names the destination root.
• Optional --source <runtime> limits replay to one of claude, codex, omp, droid, kimi, or hooks.
• Global --data-dir identifies the current Lake only for the safety comparison; replay writes exclusively to --to.

Output and state effect#

Mutates only the destination root. Emits a JSON summary containing per-runtime tallies, masking counts, failures, duration, and partial; failed names every input that could not be replayed (a source file, an invalid closed hook segment, or a runtime with no adapter), failures is how many it names, and partial is true when it names any. A partial replay returns non-zero. Source stores and the current Lake remain unchanged.

Exact refusals#

• Missing destination: rebuild requires --to <empty-path>.
• The selected current Lake: rebuild target must differ from the current Lake.
• Any occupied destination: rebuild requires an empty LAKE_DATA root so replay cannot duplicate or erase existing evidence.
• A destination that exists but cannot be listed: rebuild cannot tell whether <path> is empty: <cause>. An absent destination is empty and is created.
• An unsupported --source bogus: unknown source "bogus" (expected one of: claude, codex, omp, droid, kimi, jeden, …, aider, hooks; `transcript-lake sources` shows each with its roots on this machine), the list being every runtime of the adapter registry.
• A positional argument is refused as rebuild accepts flags only.

All long flags are exact and single-use. A value flag never consumes another --flag. Global --data-dir may appear anywhere in the invocation, must appear once, and selects an absolute root.

Back to the complete CLI command tree.