Module review 

Implementation of the seshat review command. Implementation of the seshat review command.

Resolves the project DB, reads the active branch’s last_scanned_commit, and — unless --no-sync is passed — performs a blocking incremental sync to the current git rev-parse HEAD before opening the TUI. The TUI then reads conventions that reflect the on-disk state, not a potentially stale snapshot from a previous scan.

Enums

ReviewSyncOutcome

Outcome returned by prepare_review_sync so tests can drive the freshness gate without launching the (interactive) TUI.

Functions

prepare_review_sync

Run the freshness gate and (when stale) the blocking incremental sync.

run_review

Run the seshat review command end-to-end.

run_review_sync_with_freshness

Run the blocking incremental sync given an already-computed FreshnessCheck. Lets run_review consult the gate ONCE and then drive both its banner output and the actual sync from the same reading — pre-fix it ran the gate, then prepare_review_sync ran it AGAIN, opening a TOCTOU window where HEAD could move between the two reads (P23).