feat(review-packet): Step 14.5 docs audit as one read-only packet (GSTA-167)

gstack-review-packet build --audit docs --candidate <snapshot> writes one packet:
the auditor prompt from the documentation section, the candidate's doc surfaces,
doc lines naming a changed code path, and the docs-plus-code diff. The reader
proposes edits as findings; gstack-docs-candidate apply makes each unique-match
edit outside protected and generated files and prints the audit result line the
section already validates. On Capy the section dispatches the packet reader;
other hosts keep the /document-release subagent.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This commit is contained in:
garrytanandcapy-ai[bot] committed 2026-10-30 00:42:04 +00:00
1 parent dbe700417c
commit 890ba7bda8
9 files changed
+455 -17

No files matched your search

+5 -1
View File
@@ -384,7 +384,11 @@ The Red Team's packet waits for the specialists (`--only red-team --findings
test-coverage|plan-completion` writes a Step 7/8 audit packet from the generated
section's prompt. The coverage audit packet is read-only (three calls: read, write, reply;
the parent writes and runs the tests it proposes), and a diff with no code path (docs,
data and tests only) prints `AUDIT_SKIPPED:` and builds none. An outside backend gets the outside-voice packet as its prompt file.
data and tests only) prints `AUDIT_SKIPPED:` and builds none. `--audit docs --candidate <snapshot>`
writes Step 14.5's documentation audit on Capy: one read-only packet holding the documentation
section's auditor prompt, the candidate's doc surfaces, the doc lines that name a changed code
path and the diff of the changed docs plus that code. The reader proposes edits as findings;
`gstack-docs-candidate apply` makes the unique, permitted ones and prints the audit result. An outside backend gets the outside-voice packet as its prompt file.
`gstack-review-packet collect --dir <dir>` reads every output file and prints at most
60 lines: one `REVIEWER:` line per packet (`clean`, `findings`, `missing`, `invalid`