Recovery
The index is missing
./auwai index --repo /path/to/repo
The CLI also syncs the ledger. The old JSONL index and the SQLite ledger are rebuilt together.
The plan is missing
./auwai fullread plan --repo /path/to/repo --context-window 262144
A plan is stored in SQLite. A new plan does not delete old findings or reads.
A segment was interrupted
./auwai fullread status --repo /path/to/repo
./auwai fullread next --repo /path/to/repo
An active segment is returned before a pending one.
fullread read marks the chunks read again.
fullread done closes the segment.
A chunk is stale
./auwai refresh --repo /path/to/repo
./auwai recall --stale --repo /path/to/repo
A source edit changes the chunk id. The old finding remains and is marked stale. Re-read the new chunk and record a new finding.
The ledger is out of date
./auwai audit --repo /path/to/repo --repair
The audit checks hashes and refreshes the ledger when needed.
A raw read is blocked
The guard blocks a first-party file that is in the ledger.
Use auwai read or auwai fullread read.
For a deliberate exception, set [guard] allow_raw_read = true in config.toml.
The override is not a permanent setting.