Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
docs(api): describe rule proof counts and status shape [A1,A2]
Corey Olsonf2ab171b6bd2
diff --git a/docs/api.md b/docs/api.mdindex b09d3fdb..96541f20 100644--- a/docs/api.md+++ b/docs/api.md@@ -74,6 +74,8 @@ For example: `flow: review wait average 61 min (1 measured; > 60 min); bottlenec`merged <id> <commit>` records only a commit reachable from the primary checkout's branch that contains the item's submitted commit or has the same stable patch id as the item's change from its claim base. Other commits are refused with `NOT_MERGED`; `--note "why"` records an exceptional receipt and keeps the note in that item's `merged` event.<!-- api-command-shapes:start -->+`status --json` and local API state carry `ruleCounts`: `approved`, `gated` (approved rows naming a gate), `ungated`, `proven`, `unproven`, and `contradicted`. Proof requires a green configured full-gate receipt on the current trunk whose supported test selection includes the row's test files. Opaque or unsupported coverage remains unproven. Contradicted counts approved rows whose gate files failed on the trunk in the last seven days; it is independent of proven, so a row can count in both after a later green. The API refreshes this window when evidence ages out, even without a board move.+| Command | Required top-level fields || --- | --- || `help` | `version:number`, `help:string` |@@ -104,7 +106,7 @@ For example: `flow: review wait average 61 min (1 measured; > 60 min); bottlenec| `milestone ship` | `version:number`, `milestone:object`, `into:string|null`, `moved:array`, `notMoved:array` || `show` | `version:number`, `item_id:number`, `item_title:string`, `item_lane:string`, `item_status:string`, `verdicts:array`, `thread:array` || `stats` | `version:number`, `stats:object`, `gateWaits:array` |-| `status` | `version:number`, `me:object`, `mine:array`, `stats:object`, `reviewQueue:object`, `unread:number`, `relay:object` |+| `status` | `version:number`, `me:object`, `mine:array`, `ruleCounts:object`, `stats:object`, `reviewQueue:object`, `unread:number`, `relay:object` || `doctor` | `version:number`, `problems:array` || `health` | `version:number`, `asOf:string`, `thresholds:object`, `stuck:array`, `waiting:array` || `skills` | `version:number`, `updated:array`, `current:array`, `customized:array` |