Skip to content

AdCP 3.0 rc2 prep: release notes, cleanup, and doc updates#1488

Merged
bokelley merged 10 commits into
mainfrom
bokelley/rc2-prep
Mar 15, 2026
Merged

AdCP 3.0 rc2 prep: release notes, cleanup, and doc updates#1488
bokelley merged 10 commits into
mainfrom
bokelley/rc2-prep

Conversation

@bokelley

@bokelley bokelley commented Mar 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Release notes & banners: Added rc2 release notes, updated version references across intro, homepage, roadmap, and FAQ
  • Protocol cleanup: Removed orphaned delete_content_standards task and get_property_features schema (never shipped)
  • AdCP 3.0 overview: Added rc2 features (brand rights, shows/episodes, AI media channel) to whats-new-in-v3.mdx
  • Changeset hygiene: Converted 59 non-protocol changesets to empty so they don't inflate the version bump
  • Channel count: Updated 19→20 everywhere (ai_media added in rc2)
  • Expert review fixes: Messaging tone, FAQ accuracy, learning module durations, schema version corrections

What happens on merge

The release workflow automatically:

  1. Runs changeset version → bumps to 3.0.0-rc.2
  2. Runs build:schemas --release → creates dist/schemas/3.0.0-rc.2/
  3. Creates GitHub release → triggers doc snapshot workflow

Test plan

  • Pre-push hooks pass (version sync, Mintlify link check, accessibility)
  • CI passes
  • Verify release workflow creates rc2 artifacts after merge

🤖 Generated with Claude Code

bokelley and others added 4 commits March 15, 2026 13:52
…s, everyone builds (#1482 #1483 #1484 #1485 #1487)

- FAQ: add buy-side and certification sections with CTAs (closes #1482)
- Intro: early audience fork (buy vs build) after narrative (closes #1483)
- Learning overview: urgency-driven opening, Addie description, "everyone builds" section, duration fixes (closes #1485)
- AI media: extract ad network section to standalone page (closes #1487)
- Surface "everyone builds" across buyer's guide, FAQ, agentic advertising explainer, intro, and A1 module (closes #1484)
- Expert review fixes: correct Basics to 3 modules/~50 min, membership caveat on cert pricing, accurate vibe coding framing, "discovers pricing" not "negotiates"

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
All top-level protocol, guide, reference, and certification groups
now start collapsed to reduce visual noise in the doc sidebar.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Images adcp-04-workflow.png and adcp-05-governance.png don't exist yet.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Mar 15, 2026

Copy link
Copy Markdown
Contributor

Schema Link Check Results

Commit: 4dafbee - fix: expert review — messaging, channel counts, and release notes cleanup

⚠️ Warnings (schema not yet released)

These schemas exist in source but haven't been released yet. The links will be broken until the next version is published:

  • https://adcontextprotocol.org/schemas/v3/creative/sync-creatives-request.json
    • Schema exists in latest (source) but not yet released in v3
    • Action: This link will work after next 3.x release is published
  • https://adcontextprotocol.org/schemas/v3/governance/check-governance-request.json
    • Schema exists in latest (source) but not yet released in v3
    • Action: This link will work after next 3.x release is published

To fix: Either:

  1. Wait for the next release and merge this PR after the release is published
  2. Use latest instead of a version alias if you need the link to work immediately (note: latest is the development version and may change)
  3. Coordinate with maintainers to cut a new release before merging

bokelley and others added 6 commits March 15, 2026 14:06
This concept belongs on the AAO site (about.html already covers it),
not in protocol docs. Intro.mdx and FAQ handle protocol-level context.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…eatures schema

delete_content_standards had a doc page but no JSON schema — content standards
should be archived via update, not deleted. get_property_features schema was
orphaned after property governance moved to the stateful property list model.

Also fixes broken certification-tools link to removed agentic-advertising page.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add Version 3.0.0-rc.2 section to release notes with 8 features and 5 breaking changes
- Update intro.mdx banner, homepage banner, and JSON-LD metadata to rc.2
- Update roadmap status to rc.2 released
- Fix schema version references (2.6.0 → 2.5.3, schema registry v2 → v3)
- Fix OpenRTB comparison table version reference
- Fix S3 signals specialist description to match module scope
- Fix role track durations to match database (103/92/89 min)
- Fix FAQ "buyer agent" → "advertising agent" for build project
- Fix geo-content-planner reference to removed agentic-advertising page
- Consolidate duplicate A1 module resource for intro page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Addie, website, admin UI, member features, docs-only fixes, and internal
tooling changes should not bump the protocol version. Converted from
patch/minor to empty changesets.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Brand rights lifecycle (get_rights, acquire_rights, update_rights)
- Visual guidelines on brand.json for generative creative
- Shows and episodes content dimension
- AI media channel (20th channel)
- Creative governance (get_creative_features)
- Brand tone structured format (breaking change)
- Account resolution removal (breaking change)
- Updated at-a-glance table, migration checklists, and removed-in-v3 table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…anup

- Simplify intro.mdx banner (stability caveat, not feature list)
- Rewrite homepage banner as outcome-oriented copy with "New:" prefix
- Update FAQ maturity to rc.2 and "suitable for pilot implementations"
- Add rc1→rc2 trajectory sentence to roadmap
- Move certification/docs to "Other Updates" in release notes
- Remove brand logo fields from breaking changes (additive, not breaking)
- Fix channel count 19→20 in 5 files (ai_media added in rc2)
- Add AI media to A1 channel list
- Fix FAQ Practitioner duration range (~90–105 min)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@bokelley bokelley changed the title docs: rc2 prep — doc issues, sidebar UX, broken links AdCP 3.0 rc2 prep: release notes, cleanup, and doc updates Mar 15, 2026
@bokelley
bokelley merged commit e1b019f into main Mar 15, 2026
13 checks passed
@bokelley
bokelley deleted the bokelley/rc2-prep branch March 15, 2026 21:36
bokelley added a commit that referenced this pull request May 3, 2026
Phase 1 BuyerAgentRegistry adoption per adcp-client#1269. Unblocked
by SDK 6.8.0's extra-forwarding fix (issue #1484 / PR #1488 — both
filed and reviewed in this session).

- SDK pin bumped to ^6.8.0.
- Bearer authenticator stamps extra: { demo_token: token } on the
  AuthPrincipal returned for demo-* test bearers. The token doesn't
  survive AdcpCredential normalization (api_key carries key_id:
  SHA-256(token)); extra is the documented escape hatch for
  prefix-based test conventions.
- New buyer-agent-registry.ts — BuyerAgentRegistry.bearerOnly
  resolver that reads extra.demo_token, delegates to
  commercial-relationships.ts for the principal → relationship
  lookup (single source of truth), and returns a BuyerAgent record
  with the appropriate billing_capabilities Set. Unrecognized
  credentials return null (uniform-response rule). Signed
  credentials are refused per the bearerOnly factory's posture.
- All six v6 tenant platforms wire agentRegistry:
  trainingBuyerAgentRegistry — sales, signals (v6-platform.ts),
  governance, creative, creative-builder, brand. Framework calls
  agentRegistry.resolve(authInfo) once per request before
  accounts.resolve and threads the resolved record through
  ctx.agent to platform handlers.

No gate-logic changes. commercial-relationships.ts remains the
source of truth and the legacy /mcp path keeps consuming it via
handleSyncAccounts. The v6 platforms now ALSO have
ctx.agent.billing_capabilities populated — forward-compat for SDK
Phase 2 (adcp-client#1292) framework-level enforcement of
BILLING_NOT_PERMITTED_FOR_AGENT.

Tests: 6 new unit tests on the registry resolver covering all
branches (prefix matching, missing extra, defensive type-checks,
http_sig refusal). Existing sync-accounts-gates integration test
(11 tests) and account-handlers unit test (22 tests) all pass —
proves the gate logic still fires correctly under the new wiring.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bokelley added a commit that referenced this pull request May 3, 2026
Phase 1 BuyerAgentRegistry adoption per adcp-client#1269. Unblocked
by SDK 6.8.0's extra-forwarding fix (issue #1484 / PR #1488 — both
filed and reviewed in this session).

- SDK pin bumped to ^6.8.0.
- Bearer authenticator stamps extra: { demo_token: token } on the
  AuthPrincipal returned for demo-* test bearers. The token doesn't
  survive AdcpCredential normalization (api_key carries key_id:
  SHA-256(token)); extra is the documented escape hatch for
  prefix-based test conventions.
- New buyer-agent-registry.ts — BuyerAgentRegistry.bearerOnly
  resolver that reads extra.demo_token, delegates to
  commercial-relationships.ts for the principal → relationship
  lookup (single source of truth), and returns a BuyerAgent record
  with the appropriate billing_capabilities Set. Unrecognized
  credentials return null (uniform-response rule). Signed
  credentials are refused per the bearerOnly factory's posture.
- All six v6 tenant platforms wire agentRegistry:
  trainingBuyerAgentRegistry — sales, signals (v6-platform.ts),
  governance, creative, creative-builder, brand. Framework calls
  agentRegistry.resolve(authInfo) once per request before
  accounts.resolve and threads the resolved record through
  ctx.agent to platform handlers.

No gate-logic changes. commercial-relationships.ts remains the
source of truth and the legacy /mcp path keeps consuming it via
handleSyncAccounts. The v6 platforms now ALSO have
ctx.agent.billing_capabilities populated — forward-compat for SDK
Phase 2 (adcp-client#1292) framework-level enforcement of
BILLING_NOT_PERMITTED_FOR_AGENT.

Tests: 6 new unit tests on the registry resolver covering all
branches (prefix matching, missing extra, defensive type-checks,
http_sig refusal). Existing sync-accounts-gates integration test
(11 tests) and account-handlers unit test (22 tests) all pass —
proves the gate logic still fires correctly under the new wiring.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

1 participant