docs: prepare AdCP 3.2 beta release - #6633
Conversation
There was a problem hiding this comment.
Ladon verdict: Escalate to human review
Escalate — gated paths touched without required approval.
This PR touches .agents/** files (.agents/playbook.md, .agents/shortcuts/cut-beta.md), which fall under a hard, deterministic approval gate (gated_paths: true). The current review_decision is REVIEW_REQUIRED, not APPROVED, so per decision rule row 2 the gate is not satisfied and the outcome must be escalate rather than approve.
The reviewer found no Critical/High/Medium findings — this is a clean docs-and-runbook PR standing up the AdCP 3.2 beta program (new 3-2-beta / whats-new / migration pages, versions/versioning/release-notes updates, docs.json nav, cut-beta runbook, nav test). Internal links/anchors resolve, version strings are consistent, changeset is present and patch-scoped, and deleted changesets are all non-protocol. No static/schemas/source/**, task defs, or dist artifacts were touched, so there is no wire drift or artifact-immutability risk.
Escalation reasons
- Modifies gated path
.agents/playbook.md— requires human/CODEOWNERS approval (review_decision is REVIEW_REQUIRED, not APPROVED). - Modifies gated path
.agents/shortcuts/cut-beta.md— same gate.
Once a human/CODEOWNERS approval lands (review_decision → APPROVED), this clean diff can fall through to approve.
Why human review
- Modifies gated path
.agents/playbook.md— hard approval gate, review_decision is REVIEW_REQUIRED (not APPROVED); human/CODEOWNERS review required. - Modifies gated path
.agents/shortcuts/cut-beta.md— same gated-paths approval gate. - This PR touches a path under a hard, non-overridable approval gate (.agents/playbook.md (modified) matches
.agents/**; .agents/shortcuts/cut-beta.md (modified) matches.agents/**) and the current GitHub review decision is 'REVIEW_REQUIRED', not APPROVED. This is a hard gate enforced in code — Ladon cannot auto-approve until a human/CODEOWNERS approval is recorded, regardless of how clean the diff is.
Summary
Why
The ecosystem needs a single, explicit path for evaluating 3.2 before SDKs are available, tracking work still under consideration, migrating known breaking behavior, and converging on beta.1 after the SDK wave. This makes the prerelease sequence and readiness evidence discoverable before beta.0 ships.
Ecosystem impact
Expert review
Validation
npm run test:docs-navnpm run test:owned-linksnpm run test:release-docs-navnode scripts/check-changeset-protocol-scope.cjs origin/mainnpx --yes @changesets/cli@^2.31.0 status --since=origin/mainnpm run test:release-workflownpm run typecheckgit diff --check origin/main...HEAD