Skip to content

Spec hub: carry the six extension drafts - #36

Merged
cbyrd01 merged 1 commit into
mainfrom
docs/extension-drafts
Nov 17, 2026
Merged

cbyrd01 merged 1 commit into
mainfrom
docs/extension-drafts

Conversation

@cbyrd01

@cbyrd01 cbyrd01 commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

What changed

  • scripts/sync-spec.mjs vendors the six extension drafts (Objects, Events, Delegation, Connectors, MCP facet, HTTP verbs) with the treatment the protocol and Presentation drafts get: author list reduced to the ins: line, the source checkout must be clean for every draft, every copied file is scanned for addresses, SOURCE.json records the commit (stackumi/restact 0de8381).
  • One dynamic route, src/pages/spec/[slug].astro, renders each draft with the same layout as the Presentation page. /spec/presentation-verbs/ is unchanged.
  • src/lib/specmd.ts: one table of draft files and their pages. Links to a draft file, reference targets (the target: of a reference to a sibling draft) and registry links now resolve to the on-site page and keep their fragment. Added titles for four RFCs the HTTP verbs draft cites (6234, 6266, 8187, 9421).
  • Hub "Every document" table, the specification group of the docs navigation, llms.txt, the sitemap (the dynamic route is listed explicitly), README and PRODUCT.md list the six.
  • scripts/vendored.mjs: a URL's userinfo with no password (https://user@partner.example/cb, in the HTTP verbs draft) is no longer counted as an email address; the sync and the site check now share that one check.

Slugs

/spec/objects/, /spec/events/, /spec/delegation/, /spec/connectors/, /spec/mcp/, /spec/http-verbs/

Verification

  • corepack pnpm verify exits 0 ("checked 18 pages, 0 errors").
  • Every /spec/ href in the eight rendered draft pages points at an existing dist file and, with a fragment, at an existing id: 0 misses. Links from the core draft page to the extension pages: objects 28, events 17, delegation 24, connectors 8, mcp 8, http-verbs 7, presentation 5. Extension to extension and extension to core links all resolve.
  • No vendored draft links to a file the site does not carry, apart from the reference host's decision records, which keep the existing behavior (no link).

Closes #35

Posted by Claude (AI assistant) on behalf of Christopher Byrd

🤖 Generated with Claude Code

https://claude.ai/code/session_012CEyiWTgkHU6w2pZ1FNCaP

Vendor the Objects, Events, Delegation, Connectors, MCP facet and HTTP verbs
drafts with the same sync step as the protocol and Presentation drafts, render
each at /spec/<slug>/ from one dynamic route, and resolve every cross-reference
between the eight drafts to the on-site page (reference targets, links to a
draft file, with or without a fragment). List them in the hub, navigation,
llms.txt, the sitemap and the README. A URL's userinfo (https://user@host) is
no longer counted as an email address by the shared check.

Closes #35

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012CEyiWTgkHU6w2pZ1FNCaP
@cbyrd01
cbyrd01 marked this pull request as ready for review November 17, 2026 14:41
@cbyrd01
cbyrd01 merged commit ae61f52 into main Nov 17, 2026
1 check passed
@cbyrd01
cbyrd01 deleted the docs/extension-drafts branch November 17, 2026 14:42
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.

Spec hub: carry the six extension drafts

1 participant