Use deterministic Docs Agent completion (#128)

Author: chubes4

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           repository: Automattic/docs-agent
-          ref: f887e392ad93db11efb997ed3669171e67018403
+          ref: 7b67d341eea16b75b8e055507d36a8d8e69a1fe3
           path: .producer/docs-agent
       - uses: actions/checkout@v4
         with:

.github/workflows/developer-docs-agent.yml

@@ -27,7 +27,7 @@ concurrency:
 jobs:
   developer-docs-agent:
     name: Maintain Developer Docs
-    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@f887e392ad93db11efb997ed3669171e67018403
+    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@7b67d341eea16b75b8e055507d36a8d8e69a1fe3
     with:
       audience: technical
       run_kind: ${{ github.event.inputs.run_kind || 'maintenance' }}

.github/workflows/skills-agent.yml

@@ -17,7 +17,7 @@ concurrency:
 jobs:
   skills-agent:
     name: Maintain Live Skills
-    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@f887e392ad93db11efb997ed3669171e67018403
+    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@7b67d341eea16b75b8e055507d36a8d8e69a1fe3
     with:
       audience: skills
       base_ref: trunk

docs/contributor-workflows.md

@@ -156,7 +156,7 @@ Manual documentation runs default to maintenance and should make the smallest so
 - `workflow_dispatch` offers `run_kind` choices of `maintenance` (the default) and `bootstrap`; pushes to `trunk` run with `run_kind: maintenance`.
 - `docs_branch` is `docs-agent/build-with-wordpress-developer-docs` and `base_ref` is `trunk`.
 - writable documentation paths are limited to `README.md`, `docs/**`, and `plugins/**/README.md`.
-- Docs Agent selects its native package from the reusable workflow revision pinned in this file: `Automattic/docs-agent/.github/workflows/maintain-docs.yml@f887e392ad93db11efb997ed3669171e67018403`.
+- Docs Agent selects its native package from the reusable workflow revision pinned in this file: `Automattic/docs-agent/.github/workflows/maintain-docs.yml@7b67d341eea16b75b8e055507d36a8d8e69a1fe3`.
 - maintenance is bounded to the known Figma Studio handoff diagnostics drift from [PR #100](https://github.com/Automattic/build-with-wordpress/pull/100) and requires an evidence-backed documentation update; bootstrap requires `README.md`, `docs/README.md`, at least three topic pages, and a README link to the docs index.
 - manual `workflow_dispatch` runs set `require_pr: true`; push-triggered maintenance runs do not require a PR and may finish with no changes when the documentation already matches source behavior.
 - verification commands are `pnpm install --frozen-lockfile`, `pnpm build`, and `pnpm verify`.
@@ -168,7 +168,7 @@ When changing the docs workflow, keep this contract aligned with the repository
 
 `skills-agent.yml` uses the same pinned reusable Docs Agent workflow with `audience: skills`. It is triggered manually and on a weekly Monday schedule, writes only to `skills/**`, generated skill copies under `plugins/**/skills/**`, and plugin README files, and runs the same install, build, and verify commands as the developer-docs workflow. Its bounded source delta covers the live skill sources, package generator scripts, and packaged skill outputs, and permits an evidence-backed no-change result when those surfaces are current. Its drift check is intentionally broad: `git diff --exit-code`, so generated skill package output must be committed after the build. The workflow does not pass `run_kind` or `require_pr`; the native skills lane should make the smallest source-grounded skill update needed or finish with no changes when skills are current. Keep this workflow focused on live skill content; generated package structure and developer documentation belong in the technical docs workflow and the generator/verifier source.
 
-The `CI` workflow provides automated validation for pull requests and pushes to `trunk` and `feat/native-docs-agent`. It checks out Docs Agent at `f887e392ad93db11efb997ed3669171e67018403` and the accepted WP Codebox reusable-workflow and helper revision at `a6fe2d208e990a8d04104aa74aacbb8d1539fbc1`, installs pnpm 10.8.1, runs `pnpm test`, then runs `pnpm build` and `pnpm verify`. The workflow contract test rejects producer revision, reusable workflow, source-delta, bootstrap, secret forwarding, writable path, verification command, drift check, or schema drift. This repository does not currently require the workflow as a merge gate.
+The `CI` workflow provides automated validation for pull requests and pushes to `trunk` and `feat/native-docs-agent`. It checks out Docs Agent at `7b67d341eea16b75b8e055507d36a8d8e69a1fe3` and the accepted WP Codebox reusable-workflow and helper revision at `a6fe2d208e990a8d04104aa74aacbb8d1539fbc1`, installs pnpm 10.8.1, runs `pnpm test`, then runs `pnpm build` and `pnpm verify`. The workflow contract test rejects producer revision, reusable workflow, source-delta, bootstrap, secret forwarding, writable path, verification command, drift check, or schema drift. This repository does not currently require the workflow as a merge gate.
 
 ## Pull request checklist
 

tests/docs-agent-workflows.test.mjs

@@ -4,7 +4,7 @@ import { readFile } from "node:fs/promises"
 import { resolve } from "node:path"
 
 const root = resolve(new URL("..", import.meta.url).pathname)
-const docsAgentRevision = "f887e392ad93db11efb997ed3669171e67018403"
+const docsAgentRevision = "7b67d341eea16b75b8e055507d36a8d8e69a1fe3"
 const docsAgentPackageRevision = "a39d9db230eb9e0b72ed84465f4d61bd8dda1bab"
 const wpCodeboxProducerRevision = "a6fe2d208e990a8d04104aa74aacbb8d1539fbc1"
 const wpCodeboxWorkflowRef = wpCodeboxProducerRevision