[github-actions]

Documentation Updates - 2026-10-20

Document Pi sub-agent startup diagnostics and fill confirmed work-queue CLI reference gaps. Two documentation pages changed; recent-activity searches returned 30 merged PRs for the 24-hour window, and eight visible documentation issue reports were triaged. Detailed review was limited by the integrity policy.

Features Documented

• Pi records failed model resolution for every sub-agent sharing an unavailable model, including routed runs (from #70385).
• Work-queue clear and dispatch, submission identity/accounting flags, assignment byte limits, credential-generation controls, and reservation reconciliation.
• Explicit work-queue repository selection and the lack of a -j shorthand for lint --json. Addresses the documentation findings in #70265.

Detailed Changes and References

Changes Made

• Updated docs/src/content/docs/reference/engines.md with Pi failure event fields and startup behavior, verified against the merged commit and pi_models_json.cjs.
• Updated docs/src/content/docs/setup/cli.md against the current Go command definitions. Preserved operator-only clearing requirements, CI refusal, pending-delivery and reservation boundaries, and hard-reset identity semantics. Linked the existing operator procedures without duplicating examples.
• Existing CLI documentation already covers canonical episode identity/retrieval and outcome accounting associated with feat(logs)!: require canonical episode identity and report coverage #70277, feat(logs): add bounded canonical episode retrieval #70322, Join episode usage with recorded outcome accounting #70281, and Improve outcome evaluation and unified session episode lineage #70205. The workflow-linters reference already covers historical zizmor checks from Add history-backed zizmor checks to Actions/AW AST linters #70356.
• [cli-consistency] CLI Consistency Issues - 2026-10-14 #68704 is addressed by Align MCP server CLI reference with help output #68715 and the current MCP reference. Current docs also cover the documentation portions of [cli-consistency] CLI Consistency Issues - 2026-10-15 #69044 and [cli-consistency] CLI Consistency Issues - 2026-10-13 #68442.

Validation

• git diff --check passed. Reviewed the final diff, command definitions, Pi implementation, and new link target.
• TMPDIR=/tmp/gh-aw/agent make agent-report-progress failed during the Go 1.26.9 toolchain download because TLS certificate validation failed. The build and impacted tests did not complete; certificate checks were not altered.
• Astro/Prettier dependencies are absent, so a rendered documentation build was not run.
• Only the two intended files were committed; the working tree is clean.

AI dictionary alignment summary

• Terms reviewed: model, sub-agent, model resolution.
• Terms adopted: existing repository wording, including sub-agent and the exact model.resolution event name.
• Conflicts resolved: none requiring a terminology change; repository glossary spelling takes precedence over generic dictionary wording.

Skipped Issues

• [cli-consistency] CLI Consistency Issues - 2026-10-19 #70265: documentation gaps addressed; shared CLI help wording remains an engineering concern, so this PR does not automatically close the mixed documentation/code issue.
• Document how to Playwright-test a docker-compose stack running on the host from the firewalled agent #51273: compose-stack connectivity needs supported-topology verification; Docker-in-Docker is unavailable in this run. No unverified network configuration was added.
• Docs: guidelines for configuring Go module/build cache in a security-conscious way #27886: the sandbox reference already includes Go cache-path guidance, but the broader caching/security request needs additional implementation verification. Left open.
• [cli-consistency] CLI Consistency Issues - 2026-10-16 #69382: CLI naming/JSON availability conventions require engineering decisions; no behavior changes proposed.
• [workflow-style] Normalize report formatting for non-compliant workflows #69360: concerns automation workflow report prompts rather than product documentation; left outside this content update.
• Issue results withheld by the integrity policy were not accessed through another route.

Notes

Detailed PR reads for #70207, #70320, #70348, #70344, #70358, and #70359 were denied or filtered. This is not a claim of exhaustive code-level review of all 30 PRs. The supplied steering issue number was blank/false, so no steering-comment lookup could be made.

The requested .github/instructions/documentation.instructions.md is absent; the repository documentation skill supplied the writing guidance. report_progress is unavailable and was reported with missing_tool; publication uses the authorized local commit and safe-output PR procedure.

Top-level README.md and docs/src/content/docs/index.mdx were not changed.

Next Actions

Review the draft and complete the build/test and rendered-doc checks in an environment with the required toolchain and dependencies.

Generated by 📝 Daily Documentation Updater · codex · gpt60 · 582.3 AIC · ⌖ 152.4 AIC · ⊞ 19K · ◷

• expires on Oct 21, 2026, 2:53 AM UTC-08:00

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.93.0