Fix manual developer docs run mode default (#108)

Author: chubes4

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

@@ -2,6 +2,15 @@ name: Build With WordPress Developer Docs Agent
 
 on:
   workflow_dispatch:
+    inputs:
+      run_kind:
+        description: Documentation run mode
+        required: false
+        default: maintenance
+        type: choice
+        options:
+          - maintenance
+          - bootstrap
   push:
     branches:
       - trunk
@@ -21,7 +30,7 @@ jobs:
     uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@main
     with:
       audience: technical
-      run_kind: ${{ github.event_name == 'workflow_dispatch' && 'bootstrap' || 'maintenance' }}
+      run_kind: ${{ github.event.inputs.run_kind || 'maintenance' }}
       base_ref: trunk
       docs_branch: docs-agent/build-with-wordpress-developer-docs
       writable_paths: README.md,docs/**,plugins/**/README.md
@@ -42,7 +51,7 @@ jobs:
       prompt: |
         Maintain developer-facing documentation for Build with WordPress.
 
-        Manual dispatch runs the native technical documentation bootstrap package. Push-triggered runs use the native technical documentation maintenance package and should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when documentation is current.
+        Manual dispatch defaults to the native technical documentation maintenance package; select bootstrap only to intentionally re-bootstrap the documentation. Push-triggered runs use the native technical documentation maintenance package and should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when documentation is current.
 
         Write repository documentation with `docs/README.md` as the index, focused topic pages under `docs/**`, and `plugins/**/README.md` only when a plugin package needs local developer-facing contract notes. Cover the repository purpose, package layout, generated plugin artifacts, build and verification commands, skill packaging, Studio integration points, and contributor workflows.
 

docs/contributor-workflows.md

@@ -147,13 +147,13 @@ The repository includes GitHub Actions workflows for documentation maintenance a
 - `developer-docs-agent.yml` runs the technical documentation agent lane for bootstrap and maintenance documentation updates.
 - `skills-agent.yml` runs the skills maintenance lane.
 
-Manual documentation bootstrap runs should create or improve the initial documentation structure. Push-triggered maintenance runs should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when docs are current.
+Manual documentation runs default to maintenance and should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when docs are current. Select bootstrap only to intentionally create or improve the initial documentation structure.
 
 ### Developer docs workflow contract
 
 `developer-docs-agent.yml` calls the reusable `Automattic/docs-agent/.github/workflows/maintain-docs.yml` workflow for the technical documentation lane. The caller grants its `github.token` the publication permissions declared by the workflow and explicitly forwards `OPENAI_API_KEY` for live runs and the required `EXTERNAL_PACKAGE_SOURCE_POLICY` package allowlist.
 
-- `workflow_dispatch` runs with `run_kind: bootstrap`; pushes to `trunk` run with `run_kind: maintenance`.
+- `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 immutable reusable-workflow revision GitHub resolves for the run. The technical bootstrap lane requires a published PR; maintenance permits a no-change result.

tests/docs-agent-workflows.test.mjs

@@ -85,7 +85,10 @@ for (const workflow of workflows) {
   assert.doesNotMatch(source, /runtime-agent-full-run|runtime_(?:provider|profile|profiles|execution|dependencies|task|config)|datamachine|homeboy/i)
 
   if (workflow.runKind) {
-    assert.match(source, /run_kind: \$\{\{ github\.event_name == 'workflow_dispatch' && 'bootstrap' \|\| 'maintenance' \}\}/)
+    const dispatchInputs = source.match(/  workflow_dispatch:\n    inputs:\n([\s\S]*?)  push:/)?.[1]
+    assert.ok(dispatchInputs, "Developer Docs workflow must offer a manual run mode")
+    assert.match(dispatchInputs, /      run_kind:\n        description: Documentation run mode\n        required: false\n        default: maintenance\n        type: choice\n        options:\n          - maintenance\n          - bootstrap/)
+    assert.match(source, /run_kind: \$\{\{ github\.event\.inputs\.run_kind \|\| 'maintenance' \}\}/)
   } else {
     assert.doesNotMatch(source, /^      run_kind:/m)
   }