@openwop/spec-artifacts 2.42.6 → 2.42.8

package/spec/v2/README.md

@@ -3,15 +3,15 @@
 > **Status: released · current corpus.** The authoritative version is
 > [`release.json`](./release.json). Target v2 for new implementations.
 
-OpenWOP v2 is the current protocol major. Its contract consists of this
-directory, [`schemas/v2/`](../../schemas/v2/), and
-[`api/v2/`](../../api/v2/). Those artifacts are published together in
-`@openwop/spec-artifacts` and measured by `@openwop/openwop-conformance` 2.x.
+OpenWOP v2 is the current protocol major. Its contract is this directory,
+[`schemas/v2/`](../../schemas/v2/), and [`api/v2/`](../../api/v2/). They are
+published together as `@openwop/spec-artifacts` and tested by
+`@openwop/openwop-conformance` 2.x.
 
-v1 remains available during the overlap period. Dual-stack requirements and
-the retirement rule are defined in
-[`core/versioning.md`](./core/versioning.md#5-the-overlap-rfc-0167-b5-rfc-0176)
-and [`core/overview.md`](./core/overview.md).
+v1 is still supported during the overlap period.
+[`core/versioning.md`](./core/versioning.md#5-the-overlap)
+and [`core/overview.md`](./core/overview.md) define how a host serves both and
+when v1 ends.
 
 ## Start here
 
@@ -19,43 +19,41 @@ and [`core/overview.md`](./core/overview.md).
    lifecycle.
 2. [`core/versioning.md`](./core/versioning.md) — discovery and major-version
    negotiation.
-3. [`core/capabilities.md`](./core/capabilities.md) — the closed discovery
-   document.
+3. [`core/capabilities.md`](./core/capabilities.md) — the discovery document.
 4. [`core/runs.md`](./core/runs.md), [`core/events.md`](./core/events.md), and
    [`core/interrupt.md`](./core/interrupt.md) — the execution model.
 5. [`core/security-defaults.md`](./core/security-defaults.md) and
    [`core/conformance.md`](./core/conformance.md) — mandatory safety defaults
    and evidence rules.
 
-## Source-of-truth map
-
-| Path | Purpose |
-| --- | --- |
-| [`declaration.json`](./declaration.json) | Hand-reviewed inventory of discovery keys, capability families, maturity, witnesses, facets, profiles, and peer-dependency identifiers. |
-| [`declaration.schema.json`](./declaration.schema.json) | Schema for the declaration. |
-| [`core/`](./core/) | Normative protocol prose. |
-| [`ext/`](./ext/) | Optional extensions and explicitly non-core notes. See the extension maturity rules in [`ext/README.md`](./ext/README.md). |
-| [`facets/`](./facets/) | Hand-reviewed capability facet schemas. |
-| [`errors.json`](./errors.json) | Error-code registry. |
-| [`event-codemap.json`](./event-codemap.json) | v1-to-v2 event-name mapping. |
-| [`path-manifest.json`](./path-manifest.json) | Canonical operation and channel paths. |
-| [`profiles.json`](./profiles.json) | Generated profile predicates. |
-| [`peer-dependency-aliases.json`](./peer-dependency-aliases.json) | Generated v1 alias mapping. |
-| [`release.json`](./release.json) | Authoritative corpus release identity. |
-| [`migrations.json`](./migrations.json) | RFC 0197 — the v2→v2 migration register: what a 2.x minor replaced and which deprecation row schedules the old surface out. Empty is a legal state. |
-| [`corrections.json`](./corrections.json) | RFC 0197 §A.4 — W3C Class-3 corrections that changed a v2 shape, each with the bundle and registry census that showed nothing conforming stopped conforming. |
-| [`surface-baseline.json`](./surface-baseline.json) | RFC 0197 §A.1 — GENERATED census of every v2 surface, enumerated by instance path; `check-v2-surface-monotone.mjs` diffs the tree against it. Regenerated by the release PR. |
-
-Generated files identify their generator in `$comment` or their header. Do not
-edit generated outputs directly. Machine artifacts are published in
-`@openwop/spec-artifacts`; the conformance package consumes them as an
-exact-version peer dependency.
-
 ## Core documents
 
 | Area | Documents |
 | --- | --- |
-| Foundation | [`overview`](./core/overview.md), [`versioning`](./core/versioning.md), [`headers`](./core/headers.md), [`identity`](./core/identity.md), [`oauth`](./core/oauth.md), [`capabilities`](./core/capabilities.md) |
-| Execution | [`runs`](./core/runs.md), [`events`](./core/events.md), [`interrupt`](./core/interrupt.md), [`persistence`](./core/persistence.md), [`idempotency`](./core/idempotency.md), [`replay`](./core/replay.md) |
-| Integration | [`webhooks`](./core/webhooks.md), [`interop`](./core/interop.md), [`packs`](./core/packs.md), [`node-pack runtimes`](./core/node-pack-runtimes.md), [`connection packs`](./core/connection-packs.md), [`form-content packs`](./core/form-content-packs.md), [`workflow-chain packs`](./core/workflow-chain-packs.md) |
+| Foundation | [`overview`](./core/overview.md), [`versioning`](./core/versioning.md), [`headers`](./core/headers.md), [`identity`](./core/identity.md), [`oauth`](./core/oauth.md), [`capabilities`](./core/capabilities.md), [`i18n`](./core/i18n.md) |
+| Execution | [`runs`](./core/runs.md), [`events`](./core/events.md), [`interrupt`](./core/interrupt.md), [`conversation`](./core/conversation.md), [`persistence`](./core/persistence.md), [`idempotency`](./core/idempotency.md), [`replay`](./core/replay.md) |
+| Integration | [`webhooks`](./core/webhooks.md), [`interop`](./core/interop.md), [`host services`](./core/host-services.md), [`tool catalog`](./core/tool-catalog.md), [`portability`](./core/portability.md), [`packs`](./core/packs.md), [`node-pack runtimes`](./core/node-pack-runtimes.md), [`connection packs`](./core/connection-packs.md), [`form-content packs`](./core/form-content-packs.md), [`workflow-chain packs`](./core/workflow-chain-packs.md) |
 | Reliability | [`errors`](./core/errors.md), [`security defaults`](./core/security-defaults.md), [`conformance`](./core/conformance.md) |
+
+## Source-of-truth map
+
+| Path | Contents |
+| --- | --- |
+| [`core/`](./core/) | The normative protocol documents |
+| [`ext/`](./ext/) | Optional extensions and non-core notes ([maturity rules](./ext/README.md)) |
+| [`declaration.json`](./declaration.json) | Inventory of discovery keys, capability families, maturity, witnesses, facets, profiles, and peer-dependency ids |
+| [`declaration.schema.json`](./declaration.schema.json) | Schema for the declaration |
+| [`facets/`](./facets/) | Capability facet schemas |
+| [`errors.json`](./errors.json) | Error-code registry |
+| [`event-codemap.json`](./event-codemap.json) | v1-to-v2 event-name mapping |
+| [`path-manifest.json`](./path-manifest.json) | Canonical operation and channel paths |
+| [`profiles.json`](./profiles.json) | Profile predicates (generated) |
+| [`peer-dependency-aliases.json`](./peer-dependency-aliases.json) | v1 alias mapping (generated) |
+| [`release.json`](./release.json) | Corpus release identity |
+| [`migrations.json`](./migrations.json) | Surfaces a 2.x minor replaced, and the deprecation row that retires each |
+| [`corrections.json`](./corrections.json) | Corrections that changed a v2 shape without breaking a conforming host |
+| [`surface-baseline.json`](./surface-baseline.json) | Every v2 surface, used to check that minors only add (generated) |
+
+Do not edit generated files by hand; each names its generator in `$comment` or
+its header. Machine artifacts are published in `@openwop/spec-artifacts`, which
+the conformance package consumes as an exact-version peer dependency.