Skip to content

fix(workflow): run on WP Codebox v0.33.7, title docs PRs, and pin preserve-content packages - #192

Merged
chubes4 merged 1 commit into
mainfrom
fix/pin-v0.33.7-pr-title
Nov 15, 2026
Merged

chubes4 merged 1 commit into
mainfrom
fix/pin-v0.33.7-pr-title

Conversation

@chubes4

@chubes4 chubes4 commented Nov 15, 2026

Copy link
Copy Markdown
Contributor

Closes #190. Second part, after #191.

PR title (root cause)

WP Codebox titles the PR runner_workspace.title || workload.label. maintain-docs.yml passed no title and set workload_label: Run Docs Agent, so every docs PR was titled "Run Docs Agent". Docs Agent owns the lane and run kind, so it now builds the title itself:

  • new optional input docs_scope (default: repository name, validated to [A-Za-z0-9._/-]);
  • title and commit_message are docs(<scope>): <lane> docs <run_kind>, e.g. docs(extrachill-shop): user docs maintenance; skills runs use docs(<scope>): skills <run_kind>;
  • body links the workflow run and lists the writable paths and source-delta IDs, and asks for human review of every removed or rewritten line. WP Codebox v0.33.7 appends ### Changed files (N).

Branch

runner_workspace used to pass docs_branch as both branch and branch_prefix. WP Codebox ignored branch and built ${branch_prefix}${workload-id}, which produced docs-agent/extrachill-shop-user-docsdocs-agent-user-maintenance. Docs Agent now passes branch only, and v0.33.7 uses it as given. The fresh -<base-sha-12> rule still applies once when the branch exists without an open PR.

Pins

Tests

  • The contract test asserts the exact runner_workspace jq expression and its rendered JSON (branch, title, commit_message, body, and no branch_prefix), the docs_scope input, the title format, and the human-review body.
  • I rendered the prepare step locally: {"branch":"docs-agent/extrachill-shop-user-docs","title":"docs(extrachill-shop): user docs maintenance"}. An invalid scope fails closed.
  • All validators pass against the v0.33.7 checkout.

AI assistance: Extra Chill Bot (Claude), via a Roadie subagent.

…serve-content packages

- WP Codebox v0.33.7 (9764022) uses an explicit runner_workspace.branch as
  given and makes workspace_git_status/diff work against the seed baseline
  (Automattic/wp-codebox#2591, #2592)
- pass docs_branch only as branch (no longer as branch_prefix), so the head is
  no longer <docs_branch><workload-id>
- title PRs and commits docs(<docs_scope>): <lane> docs <run_kind> via a new
  optional docs_scope input (default: repository name); the body links the run,
  writable paths and source delta and asks for human review
- advance DOCS_AGENT_PACKAGE_REVISION to 2f83a20 (#191) with the new technical
  maintenance, user bootstrap, and user maintenance package digests

Closes #190

AI assistance: Extra Chill Bot (Claude), via a Roadie subagent.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Generated PRs titled 'Run Docs Agent'; maintenance runs strip accurate detail

1 participant