Skip to content

Auditability

Taken together, these concepts make a codeArbiter repository auditable after the fact. ADRs say why. The sprint log says what was auto-decided and how confidently. Checkpoints say what the sweeps found. An append-only override trail records every sanctioned bypass. The governance record can be assembled for any range of work on demand.

For the concrete catalog of what runs in each lane, see the auto-generated Reference.

/ca:audit is the command that synthesizes the record. It pulls together, by exact source:

SourceWhat it contributes
overrides.logevery sanctioned bypass
triage.logcheckpoint findings
decisions/ + decision-log.mdADRs and the decision ledger
sprint-log.mdautonomous auto-decisions and their confidence
checkpoints/*.mddated sweep reports
[CONFIRM-NN] itemsunresolved open questions
commitsgrouped by Conventional-Commit type

The range can be given as <from-ref> <to-ref>, --since-checkpoint, or --since <date>; with no arguments it defaults to the last tag through HEAD.

The result is written to .codearbiter/audits/<YYYY-MM-DD>.md and is never overwritten: a second audit on the same day gets a -2 suffix, a third -3. Override lines and low-confidence sprint entries are quoted verbatim rather than summarized, and a section with nothing to report says so explicitly instead of being omitted.