Audit
The audit checks saved hashes against the working tree.
Run
./auwai audit --repo /path/to/repo
./auwai audit --repo /path/to/repo --json
The report has three lists:
- changed: a saved file with a different hash;
- added: a file that is not in the saved state;
- removed: a saved file that is missing.
The exit code is zero when the tree is clean.
Repair
./auwai audit --repo /path/to/repo --repair
The repair runs the incremental refresh and the ledger sync, then audits again. A clean report after repair means the JSONL index and the coverage ledger agree with the tree.
Schedule
A nightly timer is enough for an idle repository. Run the audit after a branch switch, a large merge, or a watcher outage.
Limits
The audit hashes every changed file.
It does not hash an unchanged file again.
A file with the same size and mtime but different content is not detected.
Use a full index rebuild when that matters.