stado change review
Invocation
stado change review [OPTIONS] --findings <FINDINGS> --improvements <IMPROVEMENTS> <ID>Purpose
Record a review round over a queued or running candidate by the agent session this command runs in, as its harness names it (`tama sessions self`, else the transcript `PI_SESSION_FILE` names); the session that submitted the candidate is refused, and so is a command no session runs. The round is over the commit the next pass lands (the candidate written again on `main` by the last pass, else its own commit) and that commit's tree: its findings and improvements, each a file holding a JSON array. At the review before landing, each reviewer's newest round over the same tree counts: any finding refuses the candidate naming it, rounds that all found nothing admit it. Tama's harsh review runs only when no round over the tree is recorded
Required inputs and options
| Input or option | Contract |
|---|---|
<ID> | The candidate's id, whole or a unique prefix |
--findings <FINDINGS> | A file holding a JSON array of every finding, [] when none |
--improvements <IMPROVEMENTS> | A file holding a JSON array of what the change suggests would further improve the codebase, [] when nothing |
--json | Command option; required or optional as shown in the invocation. |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.