Files
gstack/test/fixtures/docsync-invalid-first-attempt-public.json
Garry Tanandcapy-ai[bot] 7fa7f5f903 v1.92.31.0 fix(flaky): qa-callers child handoff and three ship-docsync detector gaps (2026-10-29 flaky pass, GSTA-162) (#3606)
* fix(flaky): qa-callers parents hand children literal commands and paths; Step 9 gate scan joins diff discovery

Nine paid ship qa-callers reds after #3553 (late-input, plan-checks, small-cli) had two causes,
replayed from their retained captures (2026-10-29 flaky pass, GSTA-162):
- six trials: the parent paraphrased its specialist prompt and the child ran the one refused call
  (git -C <dir> diff, or a cd into the checklist directory);
- three late-input trials hit error_max_turns at 25/25 after running Step 9's gate scan only after
  the receipt, or never.

The session prompt now tells the parent the child starts in the product directory, to write each
command exactly as it must run and each Read as one literal path; the ship scheduling contract lists
Step 9's review-plan command and gate-scan block with the first diff discovery. The detector is
unchanged. Seven new replay tests fail with the fixture prompt stashed.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* fix(flaky): docsync detectors accept a read given --help, the cap gate's wrong-path 127 and a full read before a failed separator; only the accepted docs attempt is parsed strictly

Replayed from the 2026-10-29 window's ship-docsync reds (GSTA-162):
- current 40822033640, completion 40815828320, store 40809051510: the parent joined
  `cat <candidate> --help 2>&1 | head -N` onto a line of reads; GNU cat printed its usage and
  read nothing. A declared read command given --help is neutral; its operands are still checked.
- stale-after 40749421675: the cap gate typed at the shard root exited 127, then ran at the
  declared path. The wrong-path 127 excuse now covers the cap gate as well as the candidate.
- failure 40828580338: phase.md printed in full, then zsh failed the `echo ======` separator.
  The read counts when the line's first unpiped cat printed the whole file first.
- completion 40805543956: the parent rejected attempt 1 (no documentation_section) and re-audited;
  the case now parses only the accepted attempt strictly.
Four public fixtures, registered as free fixtures.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* CHANGELOG: [Unreleased] entry for the 2026-10-29 flaky pass

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* docs: re-pin the ship-docsync completion/current detector-inventory row to its moved lines

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

---------

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
2026-11-01 15:32:09 +00:00

10 lines
4.7 KiB
JSON

{
"sourceRun": "40805543956 slice 3 ship-docsync-completion (PR #3567 screen @ 621baec9, tested sha 3b90122e)",
"sourceFileSha256": "ffac038f75a8f36ce487ff6756f38cf45a5169fe6c30552c99b01867fb03c62b",
"note": "The final output line (the completion JSON) of each of the two /document-release dispatches of the captured parent (calls 13 and 35), red on parseDocsCompletion \"completion fields\", green on the in-run rerun. Attempt 1 (status updated, one edit) omitted documentation_section; the parent saved it as rejected, re-snapshotted and re-audited; attempt 2 (status current, no edit) met the contract and its section went into the report.",
"completions": [
"{\"schema_version\":1,\"audit_id\":\"ship145-a1\",\"status\":\"updated\",\"files_updated\":[\"handbook/reference/commands/widget.md.tmpl\"],\"files_reviewed\":[\"AGENTS.md\",\"README.md\",\"handbook/reference/commands/widget.md.tmpl\",\"CHANGELOG.md\",\"TODOS.md\",\"VERSION\",\"package.json\",\"app.ts\",\"options.ts\"],\"blockers\":[],\"decisions\":[\"handbook/reference/commands/widget.md.tmpl: factual auto-update 'Default format: text.' -> 'Default format: json.' to match staged app.ts; 'KEEP THIS EXACTLY' line preserved.\",\"No generated page or generator for handbook/reference/commands/widget.md.tmpl exists in the repo; parent owns any regeneration.\",\"gstack-banned-terms check not run: outside the fixture's closed command interface.\",\"Metadata observation: package.json version 0.1.0 differs from VERSION 0.1.0.0; left untouched (parent owns metadata).\",\"CHANGELOG.md has no entry for the default format change to json; CHANGELOG not mutated (parent owns).\",\"CHANGELOG.md, TODOS.md, VERSION and package.json read for Step 6 consistency only; not edited.\",\"personal-note.txt and .qa-state/ excluded from the audit and not touched.\",\"Steps 5, 7, 8, cross-model review and 9 skipped per ship-owned mode.\"]}",
"{\"schema_version\":1,\"audit_id\":\"ship145-a2\",\"status\":\"current\",\"files_updated\":[],\"files_reviewed\":[\"AGENTS.md\",\"README.md\",\"handbook/reference/commands/widget.md.tmpl\",\"app.ts\",\"options.ts\",\"CHANGELOG.md\",\"TODOS.md\",\"VERSION\",\"package.json\"],\"blockers\":[],\"decisions\":[\"Confirmed SESSION_KIND: spawned from the gstack-skill-start echo (SESSION_ID 833-1793240595-854450a3); gstack-skill-end recorded outcome=success.\",\"The current hashes of app.ts, README.md, options.ts and handbook/reference/commands/widget.md.tmpl match candidate audit-ship145-a2.json.\",\"Kept the existing unstaged edit to handbook/reference/commands/widget.md.tmpl (Default format: json.) as current content; the KEEP THIS EXACTLY line is unchanged.\",\"Did not document options.ts export pretty: its meaning and whether users can set it are unclear, and coverage gaps are reported, not filled.\",\"Metadata: package.json version 0.1.0 differs from VERSION and CHANGELOG 0.1.0.0; left untouched for the parent.\",\"Metadata: CHANGELOG.md has no entry for the default format change from text to json; the parent owns CHANGELOG.\",\"Did not run gstack-banned-terms check because the fixture's closed command interface does not allow it.\",\"No regeneration needed: the only authored handbook doc is a .md.tmpl source and no generated page exists.\",\"Did not touch personal-note.txt or .qa-state/.\"],\"documentation_section\":\"**Status:** current. The docs already match the release; no edits were needed.\\n\\n**Scope:** branch feature/docs vs base c74d835 (no commits since base). Staged app.ts (default format changed from text to json), unstaged README.md and handbook/reference/commands/widget.md.tmpl, and the new file options.ts (export pretty = true). Docs audited: README.md, AGENTS.md, handbook/reference/commands/widget.md.tmpl, plus CHANGELOG.md and TODOS.md read for consistency.\\n\\n```\\nDocumentation health:\\n README.md Current (already says the default output format is JSON)\\n handbook/reference/commands/widget.md.tmpl Current (says Default format: json.; earlier edit kept)\\n AGENTS.md Current (the handbook/ and .md.tmpl rule was followed)\\n CHANGELOG.md Not edited (parent-owned; no entry for the format change)\\n TODOS.md Current (not edited)\\n```\\n\\n### Documentation Debt\\n\\n- Critical gap: `pretty` in options.ts has no reference, how-to, tutorial or explanation coverage. A reference line in handbook/reference/commands/widget.md.tmpl would fill it once its meaning is confirmed.\\n- Common gap: the JSON default format has reference coverage only (README.md, widget.md.tmpl) and no how-to example.\\n- Diagram drift: none; the repo has no diagrams.\\n\\nSuggest adding a docs-debt label and running /document-generate to fill the gaps.\"}"
]
}