chore(openapi): regenerate registry.yaml from Zod source (catchup)#4515
Merged
Conversation
This was referenced May 14, 2026
The published yaml had drifted ~340 lines behind server/src/schemas/registry.ts
because npm run test:openapi (the freshness gate in package.json) is not wired
into build-check.yml. Zod-schema PRs land without triggering a regen, so drift
accumulates until someone happens to run npm run build:openapi locally.
This is a pure catchup — no schema-shape changes, no new endpoints, no
behavior change. Drift swept in: publisher.discovery_method/manager_domain,
publisher.hosting.{self_redirected,resolved_url,last_validated,
last_http_status,last_bytes}, verdict_source on the compliance response,
MemberAgentTypeInput schema split, required type on member-agent read/write
surfaces, removal of tracks_silent, tools_count/tools[] on the agent probe
response, and the /refresh, /monitoring/requeue, /manager-revalidation-request
endpoints.
Follow-up: add npm run test:openapi to build-check.yml so the gate fails its
own PR instead of letting drift accumulate.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bokelley
force-pushed
the
chore/regen-openapi-yaml
branch
from
4ec2850 to
59c4f60
Compare
bokelley
pushed a commit
that referenced
this pull request
May 14, 2026
The OpenAPI freshness script (tsx scripts/generate-openapi.ts && git diff --exit-code static/openapi/registry.yaml) already existed in package.json and ran inside the umbrella npm run test. But build-check.yml cherry-picks specific test scripts and never invoked it, so Zod-schema PRs were landing without regenerating static/openapi/registry.yaml. Drift accumulated until someone happened to run npm run build:openapi locally (e.g. #4515 absorbed ~340 lines). After this change any PR that edits server/src/schemas/registry.ts (or any schema reachable from generate-openapi.ts) without regenerating the yaml will fail its own CI with the existing error message: "OpenAPI spec is out of date. Run: npm run build:openapi". Workflow-only — no source schemas change. Closes #4516. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bokelley
pushed a commit
that referenced
this pull request
May 14, 2026
The OpenAPI freshness script (tsx scripts/generate-openapi.ts && git diff --exit-code static/openapi/registry.yaml) already existed in package.json and ran inside the umbrella npm run test. But build-check.yml cherry-picks specific test scripts and never invoked it, so Zod-schema PRs were landing without regenerating static/openapi/registry.yaml. Drift accumulated until someone happened to run npm run build:openapi locally (e.g. #4515 absorbed ~340 lines). After this change any PR that edits server/src/schemas/registry.ts (or any schema reachable from generate-openapi.ts) without regenerating the yaml will fail its own CI with the existing error message: "OpenAPI spec is out of date. Run: npm run build:openapi". Workflow-only — no source schemas change. Closes #4516. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Pure regen of
static/openapi/registry.yamlfrom the Zod source inserver/src/schemas/registry.ts. The published yaml had drifted ~340 lines behind. No schema-shape changes, no new endpoints, no behavior change.Why this PR exists
package.jsonhas both halves of a freshness check:build:openapi→tsx scripts/generate-openapi.ts(the regen)test:openapi→... && git diff --exit-code static/openapi/registry.yaml || (echo 'OpenAPI spec is out of date...' && exit 1)(the drift gate)But
test:openapilives only inside the umbrellanpm run testscript —build-check.ymlcherry-picks ~10 specific test scripts andtest:openapiis not one of them. So Zod-schema PRs land without triggering a regen, and drift accumulates until someone happens to runnpm run build:openapilocally as part of an unrelated PR (most recently #4513, which would otherwise have absorbed all this catchup and confused future blame).Drift swept in (already-shipped behavior, just being written down)
Publisher.discovery_method+manager_domain(one-hop ads.txt MANAGERDOMAIN delegation)Publisher.hosting.{self_redirected, resolved_url, last_validated, last_http_status, last_bytes}(verifier-grade chrome)verdict_sourceon the compliance responseMemberAgentTypeInputschema split + requiredtypeon POST/PATCH/api/me/agentsand on the stored read shapetracks_silent(storyboard run summary)tools_count+tools[]on the agent-probe responsePOST /api/registry/agents/{encodedUrl}/refresh,POST /api/registry/agents/{encodedUrl}/monitoring/requeue,POST /api/registry/manager-revalidation-requestFollow-up
Add
npm run test:openapito.github/workflows/build-check.ymlso the gate fails its own PR going forward. Filing as a separate issue.Test plan
npm run build:openapiis clean (idempotent — re-running produces no further diff)🤖 Generated with Claude Code