Initial docstring pass focused on syntax/style; this pass verified each docstring against actual function behavior. Found and corrected: WRONG (claimed behavior didn't match): - _cmd_verify: claimed Q&A/audit verification — actually round-trips Merkle proofs on N random documents - _cmd_snapshot_verify: claimed Merkle proof round-trip — actually re-derives snapshot root and checks for drift - _cmd_evict: claimed 'archive unused content' — actually NULLs content and removes FTS row; cores never evict - _cmd_stats: listed 'index size' which is not in stats() output OVERSTATEMENT (claim stronger than contract): - _cmd_ask: 'grounded answer' — verifier may return UNGROUNDED - _cmd_snapshot_list: 'named' — snapshots have hash roots, not names MISSING IMPORTANT BEHAVIOR: - _cmd_rehydrate: didn't mention drift-detection exit code - _cmd_mesh_status: didn't mention 'enabled' flag (most important field) - _cmd_distill: didn't mention recursive core→core distillation - MerkleTree.proof(): didn't mention IndexError on out-of-range VAGUE: - _cmd_search: 'Search the corpus with FTS5' → mention output formats Sphinx rebuild successful (29 warnings, down from 31). |
||
|---|---|---|
| .. | ||
| _source | ||
| diagrams | ||
| tickets | ||
| bench-maxing.md | ||
| benchmarks.md | ||
| cti-architecture.md | ||
| mesh.md | ||
| qa-modes-bench.md | ||
| seven-point-program.md | ||
| TICKETS.md | ||