@openwop/spec-artifacts 2.9.1 → 2.10.0

package/CORPUS-STAMP.json

@@ -1,17 +1,17 @@
 {
   "_comment": "Provenance of @openwop/spec-artifacts (RFC 0168 §D.2). files: SHA-256 per file; the conformance suite compares the installed peer against dist/spec-artifacts.lock.json at start.",
   "package": "@openwop/spec-artifacts",
-  "version": "2.9.1",
-  "corpusTag": "v2.9.1",
+  "version": "2.10.0",
+  "corpusTag": "v2.10.0",
   "files": {
     "api/.redocly.lint-ignore.yaml": "bf5a8350b88a72fa43f59605ed8d903ed24b6cfccda5e45509c9f6ed9ee4e712",
     "api/asyncapi.yaml": "d5ecb9ee6114582be3b1f662c84bfac9ae96dae7bacb853e461168f70a8e1c7d",
     "api/grpc/openwop.proto": "c3e72bb17cba514ee98feb6434e6c9b6ea6795bfd086489ec69fd882dd1ad977",
     "api/openapi.yaml": "39081c59fb696159806b0f2f9a42e7e9ff830d622fcf2ad4159b21357580a955",
     "api/redocly.yaml": "b0604c89b2ca6d5076ec25725c539dad44a741a811fe524439ee6daef8baa09f",
-    "api/seams-v2.yaml": "2714a7e827e4c1dae106bee03662f4ba4707ca87f8846816c878a7a267e8fa35",
-    "api/v2/asyncapi.yaml": "17f9f44ca444434cab2fe273f3f23009ce9f480d0a803d234a6cbed0adaf5e05",
-    "api/v2/openapi.yaml": "d0d9fc04d38c8df99ed7d60a4760a5e9eab0926054ea8874a4745fe086b801ef",
+    "api/seams-v2.yaml": "e1f0047f910a03c7d92d44bb3f34447dd1910aef357e926b4289b6c5f4df9e42",
+    "api/v2/asyncapi.yaml": "531be1b674d73b2530b3dff9ffe4530b80d77ac6afbdada7fa924be0d27b13a5",
+    "api/v2/openapi.yaml": "bd2e7cdf05ac56dcffa6bd3b82364fcccbf470c5ca99fe8454f6ea65bf958e97",
     "api/v2/redocly.yaml": "1e66b60e6118ad11a823bb620678be464d99dfe50a40e3e6f93ec9429b88b34c",
     "schemas/README.md": "0c0b737ffcf8f30e7d2809cec8a498232de710f41443212922ad8337cdde0b51",
     "schemas/a2a-task-state.schema.json": "c9365918f993f943b4b619d42551eb066a1ed33a08d895d51b395432a5b1f1bc",
@@ -115,7 +115,7 @@
     "schemas/v2/artifact-type-pack-manifest.schema.json": "85630d1b760d0b41cf5a6fad2acfada39abaf7f0befd95cc4334e1e883e9615d",
     "schemas/v2/audit-verify-result.schema.json": "a748dfadb5155adfde8a91045e76b0db6695005fe559035d71670fdd55edb3ba",
     "schemas/v2/budget-policy.schema.json": "c7449daeb6e1d95e7a047b8c2814d3d54748697c27046972834874867d9b5f4c",
-    "schemas/v2/capabilities.schema.json": "4329d6a9a1a857afa327cc3428433a86aabf6c3cf4fde230855b29443992f693",
+    "schemas/v2/capabilities.schema.json": "ae1ece0c55cf467f11fe54d1374b42a249db57d8d69e45afc6f8d40e3712ca90",
     "schemas/v2/certification-bundle.schema.json": "0bcf8f297266505ca39d30eea8100e3c0fb048f2651717fd746da8129fcb7920",
     "schemas/v2/channel-presence-payload.schema.json": "1c20ad810cb311d47aa0b95d928490826b2468fd161f884cd29e867053e6782f",
     "schemas/v2/channel-written-payload.schema.json": "ccecff3c71a3275ad8db035ac0e04db25e6f8d23cf091ddbcd5a60d1be1cbb6b",
@@ -199,10 +199,10 @@
     "schemas/workload-identity.schema.json": "64ed93e12cc9f0657e56ff9b8f045e5d68d397df5276d103c07f42c7f34f0579",
     "schemas/workspace-file-create.schema.json": "70a23b92c2958c0165d7d29aea9020a045dc7816af82c80c5f50d0aac19c4856",
     "schemas/workspace-file.schema.json": "464de85c2a068243084ee9c1d969bc7cd5d8f7948574e58450d6493c38a0e1e4",
-    "spec/v1/alias-detectors.json": "e90916db12d2297e2e560b2d54d2c4702d6cb3bef7179a575844687a7ec17262",
+    "spec/v1/alias-detectors.json": "40069d5976eeb6ba1384a648e57e5cfd673db3fce36175115fb8293bee9664d4",
     "spec/v1/capability-declaration-classes.json": "e7729aed5c4b4e1dd02abab0530f14cc95f5d4070fe51fb139e7f5cccefa00c6",
-    "spec/v1/core-standard-manifest.json": "86e60c2f39387e12cd85021ec8a90ac052eb5f271a1e080beaa1c61f1193dfe0",
-    "spec/v1/deprecations.json": "c81c8f71460936c8d489d8270477c7661cf4a5d7b7bad86c98899750b5656027",
+    "spec/v1/core-standard-manifest.json": "eb6258dd220952cc4f310872c3c2cb0138bbe7ec692e292e93b164a3dfbfe9f9",
+    "spec/v1/deprecations.json": "307083ce29c23fd406015951f99a30d78d6187ff061d38dc9732f62191b40f3f",
     "spec/v1/deprecations.schema.json": "18c87e78bedc210431f795ae44c5b5d202f2f3317850d5cf86867d4f1fa1cdfb",
     "spec/v1/event-codemap.json": "3da60d884157793a360da532a9fcbbfb5285636db325a74cec94b34622186d97",
     "spec/v1/event-codemap.schema.json": "d05933b2e88103aff51a2f774df97b9bda065e0fc88dbd9b114cc47a32189174",
@@ -226,7 +226,7 @@
     "spec/v2/core/interop.md": "8d8f4b040cb3625044c6aa586c8dcf5e9d15797de3d3b1cea631f44b8924701c",
     "spec/v2/core/interrupt.md": "bdb2879a52a2504d84146e46108c4a4c2dd3a6f27865a295c80375b331cced21",
     "spec/v2/core/overview.md": "7dc00ace32d4e4ce929a383651f0029fc4b7091ec87487b1bf26ead1be209e0e",
-    "spec/v2/core/packs.md": "3254fd060c2b690cea70ef2b1b1a119711bb04fb5f13bf8936d4d718df9b2322",
+    "spec/v2/core/packs.md": "6e74aecc613b8f3592df0506fc9dfbddb5e51998c905e772ff7a38573b3ed95b",
     "spec/v2/core/persistence.md": "e9e64d0eb7f9cd6ae71a5973ee539ed30966eca309fad523f05e33adc79f9225",
     "spec/v2/core/replay.md": "13bf1f47573e0688ede28d2b1cc74cefd75e0a5c168ebf5d989f45b2cc2067b7",
     "spec/v2/core/runs.md": "b4c0bb2869077fcbf26e15bc6bbac06819f68b8241944b903a275a37db1c71fa",
@@ -234,7 +234,7 @@
     "spec/v2/core/versioning.md": "27b88cde88f9060567ef7e46f4897b6be8892ade9f4a46c2ab16e314c515eabd",
     "spec/v2/core/webhooks.md": "e08a736fd0bfdc79f5c2309c66f53caf96fac8d9954e0a184c2229de4ce286e9",
     "spec/v2/core/workflow-chain-packs.md": "26bb65721f826285b7d90c3cb62fa7e9fb2414c1bc6e0fd25b33209168c3102e",
-    "spec/v2/declaration.json": "c7338923f69aa72200977286b59d579ca797ba5462d2a911f50c24c5485a62f5",
+    "spec/v2/declaration.json": "83ba35c0d1d059f420edee62e4c1b96e3d8bd35394106e8a5ae684e502dcd99e",
     "spec/v2/declaration.schema.json": "c86e3083fb9789c1958ecb4576cc6f71aa90e6f339521139238543ed08211dd4",
     "spec/v2/errors.json": "aac91b12f954cc90574d310070ae3c651b131055d4389d2c6155242763765195",
     "spec/v2/event-codemap.json": "37869a03cdfd8758b57e6f350641a6ebbd383231cebda51f5473ad85f94ab74c",
@@ -264,6 +264,7 @@
     "spec/v2/facets/heartbeat.schema.json": "81d7fa1895a8b0241bd07cf00a7e7905bef0fd14eb3427325261c62eee5746a6",
     "spec/v2/facets/interrupt.schema.json": "c76c58c0abd99de619f8c8afad246568f5bc9cce3b7a0d097d16d87eba84be3a",
     "spec/v2/facets/mcp.schema.json": "f56609fe24ba6160ad29ae31aa16043354ff005e5cb6a0f3871c4d226087cc08",
+    "spec/v2/facets/packs.schema.json": "fc8307f9230d4c2a780912bc4e506c92cc26b78d3e7fdd63418b3e7df2b365bd",
     "spec/v2/facets/replay.schema.json": "0a5aefb0108c708c6794fadd533cf256709704c4f16dbf44cd63fa8980c78018",
     "spec/v2/facets/runList.schema.json": "6223e1baaebbb9f4faa71bfe968f8d22b4aa88046d0e43e8d5f56409e7f86e90",
     "spec/v2/facets/sandbox.schema.json": "e75f54486d387b2d089791aa93b5093cd1450f1920753a0f97fc23acdfe978ed",
@@ -273,8 +274,8 @@
     "spec/v2/path-manifest.json": "c123c9fd77dc1b3f9c2e9346ace80cdae007e6511138894956abda01e61ec1c6",
     "spec/v2/peer-dependency-aliases.json": "d10299280abee08258502925bc327293ee413e0108cd6e6ec75ff6110653308d",
     "spec/v2/profiles.json": "0636f19fceae625390003a347e70ef4797d84766b5c24ce8a02cea52aadebca4",
-    "spec/v2/release.json": "68384ffc6c06f2fe42ad85d553dc4da6bfa14160074c7746ee23d95bfbe654bb",
+    "spec/v2/release.json": "5bf2c0c64c9ccf6e8230d9d5172c55e3457bfca83111a3c0adea4c6cfc15a38e",
     "spec/v2/retention-floors.json": "eaf3722d95c79947af1d4269ef85117e126518c588cfcf1a2b21b97269f51624"
   },
-  "corpusCommit": "ab69b3aec36effd4597c0f9091acf88fa0f70c25"
+  "corpusCommit": "267511d1337f9e707ffe46f832ad1a3e15d95f6c"
 }

package/api/seams-v2.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OpenWOP conformance seams profile (openwop-conformance-seams-v2)
-  version: 2.9.1
+  version: 2.10.0
   description: 'GENERATED by scripts/derive-v2-api.py. RFC 0168 §C: the seams are a versioned conformance profile with their
     own document and path space (/conformance/seams/…), validated against the canonical v2 schemas with no tolerance path,
     forbidden from the capability namespace (a host advertises the profile, never a testSeams flag). This document carries

package/api/v2/asyncapi.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.1.0
 info:
   title: OpenWOP v2 event streams
-  version: 2.9.1
+  version: 2.10.0
   description: GENERATED by scripts/derive-v2-api.py (RFC 0171 §E.1, RFC 0172 §C.2). One run-events channel whose address
     is the OpenAPI path key; the server pathname is empty (bare origin). streamMode is a pattern over the closed set and its
     comma-separated combinations (`values` never combines). hostEvents has a real address (RFC 0171 §E.1) — the documented

package/api/v2/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OpenWOP v2 API
-  version: 2.9.1
+  version: 2.10.0
   summary: REST surface for declaring, executing, suspending, resuming, and observing multi-step workflows.
   description: GENERATED by scripts/derive-v2-api.py from api/openapi.yaml and the RFC 0167 children (v2 charter Phase 3,
     P3-C). Bare origin, unversioned path keys, negotiation by `OpenWOP-Version` + `protocolVersions[]` (RFC 0172 §A). No seam
@@ -55,27 +55,6 @@ tags:
   description: Localized authored content — public delivery + tenant-scoped admin CRUD (RFC 0103; gated on `capabilities.content.supported`).
 - name: host
   description: Host-capability resources — e.g. the RFC 0059 agent workspace file store (gated on `capabilities.workspace.*`).
-- name: packs-test
-  description: 'RFC 0025 (`Draft`). Test-mode mirror of the production `/v1/packs/*` publish/get/delete/sig surface against
-
-    an isolated catalog. Gated on `capabilities.packs.testMode.supported: true` plus the reference impl''s
-
-    `OPENWOP_PACKS_TEST_NAMESPACE_ENABLED=true` env-gate. Lets the conformance suite exercise the documented
-
-    19-code publish error catalog without `packs:publish` scope on the real registry. Hosts that haven''t
-
-    mounted this surface MUST return `404 Not Found` for every path under `/v1/packs-test/`.
-
-
-    Scope note (RFC 0094 §I): the PRODUCTION `/v1/packs/*` surface these paths mirror is specified in
-
-    `spec/v1/registry-operations.md` + `node-packs.md` §"Registry HTTP API" and is served by a registry
-
-    service (a distinct deployable from the host), so it is intentionally NOT defined in this host
-
-    OpenAPI document.
-
-    '
 paths:
   /.well-known/openwop:
     get:
@@ -341,7 +320,7 @@ paths:
           $ref: '#/components/responses/RateLimited'
     get:
       tags:
-      - Runs
+      - runs
       operationId: listRuns
       summary: The caller's runs, newest first, cursor-paginated (RFC 0182)
       description: 'Tenant-scoped by construction: only runs whose tenant segment is the caller''s, every runId bound (identity.md
@@ -3001,7 +2980,7 @@ paths:
   /host/effect-seams:
     get:
       tags:
-      - Host
+      - host
       operationId: getEffectSeamManifest
       summary: The host-declared effect-seam manifest (RFC 0173 §C)
       description: Every outbound effect seam replay suppression covers. A seam omitted here is invisible to the suite; the
@@ -3025,7 +3004,7 @@ paths:
     - $ref: '#/components/parameters/RunId'
     get:
       tags:
-      - Runs
+      - runs
       operationId: getRunCompensation
       summary: Compensation plan and attempts for a run (RFC 0173 §C.1)
       description: The read projection that makes compensation a core obligation with a deployed-wire witness (RFC 0151 G9
@@ -3049,7 +3028,7 @@ paths:
     - $ref: '#/components/parameters/RunId'
     get:
       tags:
-      - Runs
+      - runs
       operationId: getRunEffects
       summary: The Layer-2 effect ledger for a run (RFC 0173 §C.2)
       description: Business-identity keyed effect records; the witness for the Layer-2 effect-identity obligation.
@@ -3070,7 +3049,7 @@ paths:
   /webhooks/{webhookId}/dead-letters:
     get:
       tags:
-      - Webhooks
+      - webhooks
       operationId: listWebhookDeadLetters
       summary: A subscription's dead-lettered deliveries (RFC 0188 §A.1)
       description: 'The read that makes `webhooks.md` §Durability observable. A delivery whose retries are exhausted, or a
@@ -3124,7 +3103,7 @@ paths:
   /host/events:
     get:
       tags:
-      - Host
+      - host
       operationId: streamHostEvents
       summary: Host-scoped events (heartbeat.*) as SSE (RFC 0171 §E.1)
       description: The documented default hostEvents address; a host MAY declare another under `heartbeat.deliveryChannel`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openwop/spec-artifacts",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "description": "The OpenWOP machine-readable contract: api/ (OpenAPI, AsyncAPI, the seams profile), schemas/ (v1 and v2 JSON Schemas), the spec/v1 and spec/v2 registries (errors, event codemap, declaration, deprecations, migrations, gaps) and CORPUS-STAMP.json — published from the openwop/openwop corpus tag; the peer dependency @openwop/openwop-conformance digest-checks at start (RFC 0168 §D.2).",
   "license": "Apache-2.0",
   "repository": {

package/schemas/v2/capabilities.schema.json

@@ -104,10 +104,12 @@
               "type": "boolean",
               "description": "Host exposes `POST /v1/host/sample/test/debug-bundle/export` returning the same payload shape as `GET /v1/runs/{runId}/debug-bundle` per `spec/v1/debug-bundle.md`. Conformance verifies the serialized bundle doesn't carry BYOK canaries. When advertised true, the host MUST serve a 200 response with the documented shape."
             }
-          }
+          },
+          "deprecated": true,
+          "x-openwop-remove-in": "3.0"
         }
       },
-      "additionalProperties": true,
+      "additionalProperties": false,
       "x-openwop-seeded-from": "v1"
     },
     "minClientVersion": {
@@ -6546,7 +6548,7 @@
         },
         "testMode": {
           "type": "object",
-          "description": "RFC 0025 §A. Optional `/v1/packs-test/*` mirror surface that exposes the production publish/get/delete/sig contract against an isolated catalog. Lets the conformance suite (`pack-registry-publish.test.ts`) exercise the documented 19-code publish error catalog without `packs:publish` scope on the real registry. Hosts that advertise `supported: true` MUST honor the §C isolation guarantees and MUST surface the same error envelopes and HTTP statuses as the production `/v1/packs/*` surface.",
+          "description": "Deprecated 2026-09-18, removeIn 3.0 (spec/v1/deprecations.json). A test-seam flag in the capability namespace, which spec/v2/core/conformance.md §\"The seams profile\" forbids: seams are the profile `openwop-conformance-seams-v2` in the /conformance/seams/ path space. NOT removed at 2.x because live v2 discovery documents advertise it and the v2 root is additionalProperties:false. RFC 0025 §A. Optional `/v1/packs-test/*` mirror surface that exposes the production publish/get/delete/sig contract against an isolated catalog. Lets the conformance suite (`pack-registry-publish.test.ts`) exercise the documented 19-code publish error catalog without `packs:publish` scope on the real registry. Hosts that advertise this facet MUST honor the §C isolation guarantees and MUST surface the same error envelopes and HTTP statuses as the production `/v1/packs/*` surface.",
           "properties": {
             "isolated": {
               "type": "boolean",
@@ -6574,7 +6576,9 @@
               "description": "RFC 0025 §A. Which namespace scopes the test catalog accepts in pack names. Public test catalogs SHOULD refuse `private` and `local` (matching the production-registry rule for `packs.openwop.dev`); private dev catalogs MAY accept all five. When omitted, the test catalog defaults to the same scope set as the production namespace it mirrors."
             }
           },
-          "additionalProperties": false
+          "additionalProperties": false,
+          "deprecated": true,
+          "x-openwop-remove-in": "3.0"
         }
       },
       "allOf": [
@@ -6613,7 +6617,7 @@
         }
       ],
       "description": "core/capabilities.md#packs — witness: claims-check; maturity experimental/none; RFC 0025",
-      "x-openwop-seeded-from": "v1"
+      "x-openwop-facets-from": "spec/v2/facets/packs.schema.json"
     },
     "mcp": {
       "type": "object",

package/spec/v1/alias-detectors.json

@@ -284,6 +284,18 @@
       "file": "spec/v2/core/identity.md",
       "token": "Through the overlap the bare form is admitted on a major-2 path parameter",
       "deprecation": "openwop.deprecation.bare-webhook-id"
+    },
+    {
+      "alias": "packs.testMode facet",
+      "file": "spec/v2/core/packs.md",
+      "token": "`testMode` is DEPRECATED",
+      "deprecation": "openwop.deprecation.packs-test-mode-facet"
+    },
+    {
+      "alias": "observability.testSeams facet",
+      "file": "schemas/v2/capabilities.schema.json",
+      "token": "testSeams",
+      "deprecation": "openwop.deprecation.observability-test-seams-facet"
     }
   ]
 }

package/spec/v1/core-standard-manifest.json

@@ -4,7 +4,7 @@
   "provenance": {
     "suite": {
       "package": "@openwop/openwop-conformance",
-      "version": "2.9.1"
+      "version": "2.10.0"
     },
     "note": "Derived from the corpus at generation time. Regenerate with --write; verify with --check."
   },
@@ -419,5 +419,5 @@
       "$id": "https://openwop.dev/spec/v1/workspace-file.schema.json"
     }
   ],
-  "digest": "30cf52e2e90330d2b62e8a86a420966c01e2949ba127bac8bae33d0a2a3fe337"
+  "digest": "6ea59f73dbef234aee4cba37c331a92b9f35e72f314241add5266f6235ba085f"
 }

package/spec/v1/deprecations.json

@@ -826,14 +826,14 @@
     {
       "id": "openwop.deprecation.seam-operations-in-canonical-api",
       "status": "deprecated",
-      "surface": "the nine `/v1/host/sample/*`, `/v1/host/workspace/files*` and `/v1/packs-test/*` seam/test operations in `api/openapi.yaml` and `spec/v1/operation-path-manifest.json`, and the `testSeams` discovery-flag proposals",
+      "surface": "the nine `/v1/host/sample/*`, `/v1/host/workspace/files*` and `/v1/packs-test/*` seam/test OPERATIONS in `api/openapi.yaml` and `spec/v1/operation-path-manifest.json`",
       "kind": "path",
       "deprecatedIn": "RFC 0168 (v2.0)",
       "authority": "RFC 0168 §C (seams are the profile `openwop-conformance-seams-v2` with `api/seams-v2.yaml`; forbidden from the capability namespace)",
       "removeIn": "2.0",
       "replacement": "`api/seams-v2.yaml`; `profiles[]` membership",
       "codemod": null,
-      "note": "Proposed: a generated document, not a persisted artifact. Status flipped proposed→deprecated 2026-09-17: the surface has no occurrence in spec/v2, schemas/v2 or api/v2 (token grep, W7).",
+      "note": "Proposed: a generated document, not a persisted artifact. Status flipped proposed→deprecated 2026-09-17 on a token grep asserting the surface had no occurrence in spec/v2, schemas/v2 or api/v2. THAT CLAIM WAS FALSE — three residues were present: `packs.testMode` and `observability.testSeams` in schemas/v2/capabilities.schema.json, and an orphaned `packs-test` tag in api/v2/openapi.yaml. Corrected 2026-09-18 by NARROWING this row to the path operations, which its removeIn:2.0 genuinely did satisfy, and moving the two capability facets to their own removeIn:3.0 rows — they CANNOT be removed at 2.x because live v2 discovery documents advertise them (myndhyve emits both; openwop-host-v2-reference emits packs.testMode) and the v2 root is additionalProperties:false. The orphaned tag is deleted in this change. Two lessons: a row that bundles surfaces with different removal horizons cannot be honestly satisfied at either; and check-removal-dates.mjs only reads a row's declared sources[], so a row can certify its own absence by declaring too few.",
       "sources": [
         {
           "file": "spec/v1/operation-path-manifest.json",
@@ -916,6 +916,48 @@
           "token": "A host MUST NOT mint one after this RFC"
         }
       ]
+    },
+    {
+      "id": "openwop.deprecation.packs-test-mode-facet",
+      "status": "deprecated",
+      "surface": "`capabilities.packs.testMode` — the v2 advertisement of the v1 `/v1/packs-test/*` conformance-seam mirror",
+      "kind": "discovery-field",
+      "deprecatedIn": "2.10 (RFC 0189 Phase 1)",
+      "authority": "spec/v2/core/conformance.md §\"The seams profile\" (a test-seam capability flag MUST NOT be advertised) + spec/v2/path-manifest.json (no packs path in v2)",
+      "removeIn": "3.0",
+      "replacement": "`openwop-conformance-seams-v2` profile membership (`api/seams-v2.yaml`)",
+      "codemod": null,
+      "note": "NOT removed at 2.x. Unlike workflowChainPacks.deferredParameters/hostExpansionSeam (2.8.2), which no host advertised, TWO live v2 discovery documents carry this facet — evidence/v2-host-bundles/myndhyve.json and openwop-host-v2-reference.json — and the v2 root is additionalProperties:false, so removal breaks a published closed record with no host change (COMPATIBILITY.md §2.2; §3's second clause fails because deprecation is available and adequate).",
+      "sources": [
+        {
+          "file": "schemas/v2/capabilities.schema.json",
+          "token": "testMode"
+        },
+        {
+          "file": "spec/v2/core/packs.md",
+          "token": "`testMode` is DEPRECATED"
+        }
+      ],
+      "removalTrigger": "v1-end-of-support"
+    },
+    {
+      "id": "openwop.deprecation.observability-test-seams-facet",
+      "status": "deprecated",
+      "surface": "`capabilities.observability.testSeams` — a test-seam flag in the capability namespace",
+      "kind": "discovery-field",
+      "deprecatedIn": "2.10 (RFC 0189 Phase 1)",
+      "authority": "spec/v2/core/conformance.md §\"The seams profile\" (a `testSeams` capability flag does not exist and MUST NOT be advertised)",
+      "removeIn": "3.0",
+      "replacement": "`openwop-conformance-seams-v2` profile membership (`api/seams-v2.yaml`)",
+      "codemod": null,
+      "note": "NOT removed at 2.x. MyndHyve's live v2 discovery document advertises `observability.testSeams: {\"otelScrape\": true}` (evidence/v2-host-bundles/myndhyve.json), so this is the same closed-record hazard as packs.testMode — not the 2.8.2 zero-bundle case.",
+      "sources": [
+        {
+          "file": "schemas/v2/capabilities.schema.json",
+          "token": "testSeams"
+        }
+      ],
+      "removalTrigger": "v1-end-of-support"
     }
   ]
 }

package/spec/v2/core/packs.md

@@ -10,6 +10,22 @@ Every one of the 282 pack versions published under v1 either pins `<2.0.0` or de
 
 A manifest's `engines.openwop` MUST match the grammar in `schemas/v2/node-pack-manifest.schema.json`: a `>=` lower bound and an explicit `<` major ceiling (`^>=\d+(\.\d+){0,2} <\d+\.0\.0$`). A v2 host MUST treat a range with no upper bound as bounded by `<2.0.0`. A host MUST refuse to install a version whose range does not admit the host's protocol major with `pack_engine_unsupported` (`spec/v2/errors.json`); `pack_runtime_requirement_unmet` remains a runtime-requirement code and MUST NOT be used for the protocol major. The check MUST run at install on every publication path — the canonical registry, a vendor registry's write API, and a mirror ingest — so no registry-side artifact can bypass it.
 
+## The `packs` capability
+
+A host advertises `packs` when it serves the registry surface above. The record
+is the advertisement: a host MUST NOT advertise `packs` unless it resolves pack
+references through a registry reachable from its discovery document, and a
+client MUST treat an absent record as "this host installs no packs" rather than
+as an unknown.
+
+`testMode` is DEPRECATED and MUST NOT be relied on by a client. It advertises
+the v1 `/v1/packs-test/*` mirror, a conformance seam — and `conformance.md`
+§"The seams profile" places seams in the `openwop-conformance-seams-v2` profile
+and the `/conformance/seams/` path space, not in the capability namespace. It
+remains advertisable through the overlap because hosts already publish it; it is
+removed at 3.0. A host mounting a test catalog SHOULD advertise the seams
+profile instead, and MUST NOT treat `testMode` as a second way to claim one.
+
 ## The registry tree
 
 The registry is versioned by tree, not header. It publishes `registry/v2/packs/<name>/-/<version>.{json,sbom.json,sig,tgz}` as a parallel tree of re-signed manifests with regenerated SBOMs and index; the v1 tree is frozen through the overlap, deliberately behind this one. A signed compatibility overlay MUST be rejected: signatures authorize by namespace, and a mirror re-derives the signer at ingest.

package/spec/v2/declaration.json

@@ -1396,6 +1396,9 @@
       "facets": [
         "testMode"
       ],
+      "normativeText": [
+        "spec/v2/core/packs.md"
+      ],
       "floorScenarios": [],
       "requirementIds": [],
       "owningRfc": "0025"

package/spec/v2/facets/packs.schema.json

@@ -0,0 +1,39 @@
+{
+  "$comment": "Hand-decided v2 facet set for `packs` (2.10.0). Exists so the deprecation of its seam facet is emitted BY generate-from-declaration.mjs rather than stamped on afterwards by generate-deprecation-annotations.mjs — the two generators write the same file, and these are the first discovery-field rows sourced to schemas/v2/, so that interaction had never been exercised. A facet's deprecation is a decision, and a decision belongs on the record.",
+  "properties": {
+    "testMode": {
+      "type": "object",
+      "description": "Deprecated 2026-09-18, removeIn 3.0 (spec/v1/deprecations.json). A test-seam flag in the capability namespace, which spec/v2/core/conformance.md §\"The seams profile\" forbids: seams are the profile `openwop-conformance-seams-v2` in the /conformance/seams/ path space. NOT removed at 2.x because live v2 discovery documents advertise it and the v2 root is additionalProperties:false. RFC 0025 §A. Optional `/v1/packs-test/*` mirror surface that exposes the production publish/get/delete/sig contract against an isolated catalog. Lets the conformance suite (`pack-registry-publish.test.ts`) exercise the documented 19-code publish error catalog without `packs:publish` scope on the real registry. Hosts that advertise this facet MUST honor the §C isolation guarantees and MUST surface the same error envelopes and HTTP statuses as the production `/v1/packs/*` surface.",
+      "properties": {
+        "isolated": {
+          "type": "boolean",
+          "description": "RFC 0025 §C point 1. MUST be `true` when `supported` is `true` — guarantees the test catalog is persisted distinctly from the production catalog and that a pack PUT'd via `/v1/packs-test/*` MUST NOT appear in `/v1/packs/*` listings."
+        },
+        "catalogResetEndpoint": {
+          "type": "string",
+          "description": "RFC 0025 §C point 4. Optional URL path (e.g. `/v1/packs-test/reset`) that clears the entire test catalog. When advertised, conformance-suite teardown SHOULD call it; the endpoint MUST be idempotent. Hosts MAY omit; in that case the suite leaves disposable timestamped pack names in place and relies on the next host restart to clear in-memory state.",
+          "pattern": "^/"
+        },
+        "scopes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "core",
+              "vendor",
+              "community",
+              "private",
+              "local"
+            ]
+          },
+          "uniqueItems": true,
+          "minItems": 1,
+          "description": "RFC 0025 §A. Which namespace scopes the test catalog accepts in pack names. Public test catalogs SHOULD refuse `private` and `local` (matching the production-registry rule for `packs.openwop.dev`); private dev catalogs MAY accept all five. When omitted, the test catalog defaults to the same scope set as the production namespace it mirrors."
+        }
+      },
+      "additionalProperties": false,
+      "deprecated": true,
+      "x-openwop-remove-in": "3.0"
+    }
+  }
+}

package/spec/v2/release.json

@@ -1,6 +1,6 @@
 {
   "$comment": "RFC 0172 §D.1 — the one release identity the v2 artifacts derive from. `version` is the next corpus tag `v<version>` (the publish workflow's coordinated-release tag pattern `v*`; RFC 0172's `openwop/v2.<minor>.<patch>` spelling is amended to this at its flip). api/v2/*.yaml info.version, the suite's 2.x version and @openwop/spec-artifacts read it. Bumped by the release PR that cuts the tag, never by hand elsewhere.",
-  "version": "2.9.1",
-  "corpusTag": "v2.9.1",
+  "version": "2.10.0",
+  "corpusTag": "v2.10.0",
   "updated": "2026-09-18"
 }