From a7e3e9e3e46cdff84ac83a85e18d6add9e469b9b Mon Sep 17 00:00:00 2001 From: Christopher Byrd Date: Tue, 17 Nov 2026 08:11:48 -0600 Subject: [PATCH] docs(spec): match the spec hub summaries to the restructured draft The core draft moved object data access, history and delegated tokens into the extension drafts, and a wall-clock overrun now answers 504, not 408. Bring six section summaries and the home page's limits line in line. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_012CEyiXhfAFWQNVqTou37wi --- src/lib/spec-map.ts | 14 +++++++------- src/pages/index.astro | 2 +- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/src/lib/spec-map.ts b/src/lib/spec-map.ts index 1009630..7d58e0f 100644 --- a/src/lib/spec-map.ts +++ b/src/lib/spec-map.ts @@ -19,7 +19,7 @@ export const SECTION_MAP: Record = { }, terminology: { gist: 'The BCP 14 key words and the terms used throughout: object, verb, principal, capability.', tag: 'informative' }, 'protocol-overview': { gist: 'A tree of objects, each with data and verbs, and single inheritance down the path.', tag: 'informative' }, - conformance: { gist: 'The mandatory core, and how everything else is advertised as an optional feature.', tag: 'core' }, + conformance: { gist: 'The mandatory core, how everything else is advertised as an optional feature, and what extension drafts add.', tag: 'core' }, addressing: { gist: 'The path grammar in ABNF, with the colon as verb separator, and the three addressing forms.', tag: 'core' }, 'http-method-semantics': { gist: 'The standard methods on object data, the function and action rule for verbs, and verb properties.', @@ -27,14 +27,14 @@ export const SECTION_MAP: Record = { }, resolution: { gist: 'The search walks from the target object up to the root, and the first definition runs.', tag: 'core' }, representations: { - gist: 'Native JSON and its system fields, object policy, verb source and executable, deployment, history.', + gist: 'Native JSON and its system fields, object policy, verb source and executable, and deployment.', tag: 'optional', }, - capabilities: { gist: 'Layered host interfaces, deny by default; object data access and caller identity.', tag: 'core + optional' }, - limits: { gist: 'Wall-clock, compute and memory limits per invocation, answered with 408, 429 and 507.', tag: 'core' }, + capabilities: { gist: 'Layered host interfaces, deny by default; the guest contract and the read-only caller identity.', tag: 'core + optional' }, + limits: { gist: 'Wall-clock, compute and memory limits per invocation, answered with 504, 429 and 507.', tag: 'core' }, composition: { gist: 'One verb calls another through the host, under a declared call graph and a shared budget.', tag: 'optional' }, authz: { - gist: 'Bearer tokens, policy matchers, ownership, the execution identity, scoped and delegated tokens.', + gist: 'Authentication mechanisms, policy matchers, the simple profile, fixed ownership and the execution identity.', tag: 'core + optional', }, 'consistency-txn': { gist: 'Consistency levels from eventual to transactional, advertised and never over-claimed.', tag: 'optional' }, @@ -43,8 +43,8 @@ export const SECTION_MAP: Record = { 'admin-reset': { gist: 'An operator-authenticated reset of a server’s stored state, advertised as its own feature.', tag: 'optional' }, errors: { gist: 'RFC 9457 Problem Details, with the restact_code and restact_verb members.', tag: 'core' }, discovery: { gist: 'OPTIONS on object, verb and property paths, and the document at /.well-known/restact.', tag: 'core' }, - security: { gist: 'Hostile uploads, denial of wallet, side channels, confused deputies and delegation.', tag: 'core + optional' }, - iana: { gist: 'The media types, the well-known URI and the registries the draft requests.', tag: 'registry' }, + security: { gist: 'Hostile uploads, denial of wallet, side channels, confused deputies, cross-site requests and operator reset.', tag: 'core + optional' }, + iana: { gist: 'The media type, the well-known URI, the registries and the reserved paths the draft requests.', tag: 'registry' }, 'appendix-wit': { gist: 'The rest-act:plugin@0.1.0 interfaces and worlds a component targets.', tag: 'core + optional' }, 'appendix-pairwise': { gist: 'Test values for computing the pairwise subject a verb reads by default.', tag: 'informative' }, 'implementation-status-and-experience': { gist: 'What the reference implementation has demonstrated so far.', tag: 'informative' }, diff --git a/src/pages/index.astro b/src/pages/index.astro index f76cf5b..3b727c2 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -94,7 +94,7 @@ const core = { items: [ { name: 'Addressing and verb invocation', body: 'A colon separates the object path from the verb name, as in /v1/notes/42:wordCount.', href: `${DRAFT_URL}#addressing` }, { name: 'Capability confinement', body: 'A verb reaches only the host interfaces it imports. The server refuses an upload that imports one it does not grant.', href: `${DRAFT_URL}#capabilities` }, - { name: 'Resource limits', body: 'Every call has wall-clock, compute and memory limits, answered with 408, 429 and 507.', href: `${DRAFT_URL}#limits` }, + { name: 'Resource limits', body: 'Every call has wall-clock, compute and memory limits, answered with 504, 429 and 507.', href: `${DRAFT_URL}#limits` }, { name: 'Runs as the caller', body: 'A verb acts with the caller’s authority, narrowed by what the verb declared and by the target’s policy.', href: `${DRAFT_URL}#exec-identity` }, { name: 'Problem Details errors', body: 'Errors are RFC 9457 problem details carrying a restact_code.', href: `${DRAFT_URL}#errors` }, { name: 'A discovery document', body: '/.well-known/restact lists the server’s features, limits and verbs.', href: `${DRAFT_URL}#discovery` },