@openwop/openwop-conformance 1.162.0 → 2.0.0-rc.0

package/src/scenarios/a2a-version-negotiation.test.ts

@@ -29,6 +29,8 @@ import { behaviorGate } from '../lib/behavior-gate.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
 import { getA2AFakePeer } from '../lib/a2a-fake-peer.js';
 import { readErrorCode } from '../lib/error-envelope.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 /**
  * Callback-shaped: the host issues A2A calls to the suite's fake peer, which records the negotiated version header.
@@ -63,7 +65,7 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
     const caps = await a2a();
     expect(
       caps?.protocolVersions ?? [],
-      driver.describe(
+      req('openwop.it.a2a-version-negotiation.the-advertised-preferred-version-is-one-the-host-actually-claims', 
         'RFCS/0152-a2a-1-0-versioned-composition.md §A',
         '`preferredVersion` MUST be present in `protocolVersions`. Preferring a version you do ' +
           'not list is a claim no peer can act on.',
@@ -74,28 +76,28 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
   it('outbound calls carry an explicit A2A-Version header', async () => {
     if (!behaviorGate(PROFILE, await negotiationAdvertised())) return;
     const peer = getA2AFakePeer();
-    if (peer === null) return; // no fake peer wired in this run
+    if (peer === null) return softSkip('blocked', 'precondition not met — `peer === null` returned early (no fake peer wired in this run) (seam, prior step, or fixture unavailable)'); // no fake peer wired in this run
     peer.reset();
     const drive = await driver.post('/v1/host/sample/a2a/invoke', { peerUrl: peer.endpoint() });
     if (drive.status === 404 || drive.status === 403) {
       // Seam absent. RFC 0148 §A: unobservable resolves to `blocked`, not a pass.
       expect(
         drive.status,
-        driver.describe(
+        req('openwop.it.a2a-version-negotiation.outbound-calls-carry-an-explicit-a2a-version-header', 
           'RFCS/0152 §B',
           'a host advertising A2A version negotiation MUST expose an invoke seam so the negotiated ' +
             'version is observable. Without it the requirement cannot be witnessed and resolves to ' +
             '`blocked` per RFC 0148 §A.',
         ),
       ).not.toBe(404);
-      return;
+      return softSkip('blocked', 'precondition not met — `drive.status === 404 || drive.status === 403` returned early (seam, prior step, or fixture unavailable)');
     }
     const calls = peer.invocations().filter((i: { method: string }) => i.method !== 'GET');
-    expect(calls.length, 'the host MUST have called the peer').toBeGreaterThan(0);
+    expect(calls.length, req('openwop.it.a2a-version-negotiation.outbound-calls-carry-an-explicit-a2a-version-header', 'RFCS/0152 §B', 'the host MUST have called the peer')).toBeGreaterThan(0);
     for (const c of calls) {
       expect(
         c.headers['a2a-version'],
-        driver.describe(
+        req('openwop.it.a2a-version-negotiation.outbound-calls-carry-an-explicit-a2a-version-header', 
           'RFCS/0152 §B',
           'the sender MUST send `A2A-Version`. An absent header leaves the receiver guessing, and ' +
             'a guess that happens to be right is not a negotiation.',
@@ -107,7 +109,7 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
   it('an authenticated request is not silently downgraded', async () => {
     if (!behaviorGate(PROFILE, await negotiationAdvertised())) return;
     const peer = getA2AFakePeer();
-    if (peer === null) return;
+    if (peer === null) return softSkip('blocked', 'precondition not met — `peer === null` returned early (seam, prior step, or fixture unavailable)');
     const caps = await a2a();
     const preferred = caps?.preferredVersion;
     peer.reset();
@@ -116,7 +118,7 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
       authenticated: true,
       peerOffersOnly: '0.3',
     });
-    if (drive.status === 404 || drive.status === 403) return; // covered above
+    if (drive.status === 404 || drive.status === 403) return softSkip('blocked', 'precondition not met — `drive.status === 404 || drive.status === 403` returned early (covered above) (seam, prior step, or fixture unavailable)'); // covered above
 
     // THE load-bearing leg. A silent downgrade is dangerous precisely because it
     // SUCCEEDS: the caller believes it negotiated `preferred`, the peer answered
@@ -127,7 +129,7 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
       const negotiated = (drive.json as { negotiatedVersion?: string }).negotiatedVersion;
       expect(
         negotiated,
-        driver.describe(
+        req('openwop.it.a2a-version-negotiation.an-authenticated-request-is-not-silently-downgraded', 
           'RFCS/0152 §B',
           'a host that proceeds after a downgrade MUST report the version it actually negotiated. ' +
             'Reporting the preferred version while having used a lower one is the silent downgrade ' +
@@ -138,7 +140,7 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
       for (const c of calls) {
         expect(
           c.headers['a2a-version'],
-          driver.describe('RFCS/0152 §B', 'the wire header MUST match the reported negotiated version'),
+          req('openwop.it.a2a-version-negotiation.an-authenticated-request-is-not-silently-downgraded', 'RFCS/0152 §B', 'the wire header MUST match the reported negotiated version'),
         ).toBe(negotiated);
       }
     }
@@ -147,18 +149,18 @@ describe('RFC 0152 §B — A2A version negotiation', () => {
   it('an unsupported version fails through the canonical interop error envelope', async () => {
     if (!behaviorGate(PROFILE, await negotiationAdvertised())) return;
     const peer = getA2AFakePeer();
-    if (peer === null) return;
+    if (peer === null) return softSkip('blocked', 'precondition not met — `peer === null` returned early (seam, prior step, or fixture unavailable)');
     const drive = await driver.post('/v1/host/sample/a2a/invoke', {
       peerUrl: peer.endpoint(),
       requestVersion: '99.0',
     });
-    if (drive.status === 404 || drive.status === 403) return;
-    expect(drive.status >= 400, driver.describe('RFCS/0152 §B', 'an unsupported version MUST fail')).toBe(true);
+    if (drive.status === 404 || drive.status === 403) return softSkip('blocked', 'precondition not met — `drive.status === 404 || drive.status === 403` returned early (seam, prior step, or fixture unavailable)');
+    expect(drive.status >= 400, req('openwop.it.a2a-version-negotiation.an-unsupported-version-fails-through-the-canonical-interop-error-envelope', 'RFCS/0152 §B', 'an unsupported version MUST fail')).toBe(true);
     // S28: canonical envelope is FLAT (`error: "<code>"`, error-envelope.schema.json);
     // the nested `error.code` is tolerated by the lib only through the deprecation window.
     expect(
       readErrorCode(drive.json),
-      driver.describe(
+      req('openwop.it.a2a-version-negotiation.an-unsupported-version-fails-through-the-canonical-interop-error-envelope', 
         'RFCS/0152 §B',
         'the upstream version error MUST be projected through the canonical OpenWOP interop error ' +
           'envelope when the failure crosses an OpenWOP boundary — a raw upstream body leaves the ' +

package/src/scenarios/a2ui-surface-degrades.test.ts

@@ -17,6 +17,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const UNIVERSAL_KINDS = ['clarification.request', 'schema.request', 'schema.response', 'error'];
@@ -25,7 +27,7 @@ describe('a2ui-surface-degrades: optional-advertised, not universal (RFC 0102 §
   it('ui.a2ui-surface is NOT a MUST-recognize universal kind', () => {
     expect(
       UNIVERSAL_KINDS.includes('ui.a2ui-surface'),
-      'ai-envelope.md §"A2UI surfaces": ui.a2ui-surface MUST be optional/advertised so an unrecognizing consumer may store-without-render',
+      req('openwop.it.a2ui-surface-degrades.ui-a2ui-surface-is-not-a-must-recognize-universal-kind', 'RFC 0102 §A', 'ai-envelope.md §"A2UI surfaces": ui.a2ui-surface MUST be optional/advertised so an unrecognizing consumer may store-without-render'),
     ).toBe(false);
   });
 });
@@ -43,12 +45,12 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-degrades: unadvertised kind is gated, r
       },
       hostSupportedEnvelopes: ['clarification.request'], // does not advertise ui.a2ui-surface
     });
-    if (res.status === 404) return; // seam absent — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
     expect(res.status).toBe(200);
     const body = res.json as { status?: string };
     expect(
       body.status,
-      driver.describe('RFC 0102 §A (N6)', 'an unadvertised ui.a2ui-surface MUST be gated, never crash the run'),
+      req('openwop.it.a2ui-surface-degrades.posting-ui-a2ui-surface-to-a-host-that-does-not-advertise-it-gated-not-failed', 'RFC 0102 §A (N6)', 'an unadvertised ui.a2ui-surface MUST be gated, never crash the run'),
     ).toBe('gated');
   });
 });

package/src/scenarios/a2ui-surface-delta-transport.test.ts

@@ -47,6 +47,8 @@ import { join } from 'node:path';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import { driver } from '../lib/driver.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const ajv = new Ajv2020({ strict: false, allErrors: true });
 
@@ -270,7 +272,7 @@ function fullSurfaceMaterializedAfterUpdates(): { [key: string]: JsonValue } {
 
 describe('a2ui-surface-delta-transport: frame schema + op set (RFC 0114)', () => {
   it('a2ui-surface-delta-frame.schema.json compiles under Ajv2020', () => {
-    expect(validateFrame, 'RFC 0114: the delta-frame schema MUST compile').toBeTypeOf('function');
+    expect(validateFrame, req('openwop.it.a2ui-surface-delta-transport.a2ui-surface-delta-frame-schema-json-compiles-under-ajv2020', 'RFC 0114 §"Delta transport', 'RFC 0114: the delta-frame schema MUST compile')).toBeTypeOf('function');
   });
 
   it('accepts a positive delta frame', () => {
@@ -281,18 +283,18 @@ describe('a2ui-surface-delta-transport: frame schema + op set (RFC 0114)', () =>
     };
     expect(
       validateFrame(frame),
-      `RFC 0114: a positive delta frame MUST validate; errors: ${JSON.stringify(validateFrame.errors)}`,
+      req('openwop.it.a2ui-surface-delta-transport.accepts-a-positive-delta-frame', 'RFC 0114 §"Delta transport', `RFC 0114: a positive delta frame MUST validate; errors: ${JSON.stringify(validateFrame.errors)}`),
     ).toBe(true);
   });
 
   it('rejects a frame missing the required `surfaceRef`/`catalogVersion`/`patch`', () => {
-    expect(validateFrame({ catalogVersion: CATALOG_VERSION, patch: [{ op: 'replace', path: '/x' }] })).toBe(false);
+    expect(validateFrame({ catalogVersion: CATALOG_VERSION, patch: [{ op: 'replace', path: '/x' }] }), req('openwop.it.a2ui-surface-delta-transport.rejects-a-frame-missing-the-required-surfaceref-catalogversion-patch', 'RFC 0114 §"Delta transport', 'rejects a frame missing the required `surfaceRef`/`catalogVersion`/`patch`')).toBe(false);
     expect(validateFrame({ surfaceRef: 'e', patch: [{ op: 'replace', path: '/x' }] })).toBe(false);
     expect(validateFrame({ surfaceRef: 'e', catalogVersion: CATALOG_VERSION })).toBe(false);
   });
 
   it('rejects an empty patch (minItems: 1)', () => {
-    expect(validateFrame({ surfaceRef: 'e', catalogVersion: CATALOG_VERSION, patch: [] })).toBe(false);
+    expect(validateFrame({ surfaceRef: 'e', catalogVersion: CATALOG_VERSION, patch: [] }), req('openwop.it.a2ui-surface-delta-transport.rejects-an-empty-patch-minitems-1', 'RFC 0114 §"Delta transport', 'rejects an empty patch (minItems: 1)')).toBe(false);
   });
 
   it('EXCLUDES the `test` op from the op enum', () => {
@@ -303,7 +305,7 @@ describe('a2ui-surface-delta-transport: frame schema + op set (RFC 0114)', () =>
     };
     expect(
       validateFrame(frame),
-      'RFC 0114: a fire-and-forget transport frame cannot act on a failed conditional; `test` is excluded',
+      req('openwop.it.a2ui-surface-delta-transport.excludes-the-test-op-from-the-op-enum', 'RFC 0114 §"Delta transport', 'RFC 0114: a fire-and-forget transport frame cannot act on a failed conditional; `test` is excluded'),
     ).toBe(false);
   });
 
@@ -313,7 +315,7 @@ describe('a2ui-surface-delta-transport: frame schema + op set (RFC 0114)', () =>
       catalogVersion: CATALOG_VERSION,
       patch: [{ op: 'replace', path: '/x', value: 1, onApply: "fetch('https://evil')" }],
     };
-    expect(validateFrame(frame)).toBe(false);
+    expect(validateFrame(frame), req('openwop.it.a2ui-surface-delta-transport.rejects-a-patch-item-carrying-an-out-of-set-property-additionalproperties-false', 'RFC 0114 §"Delta transport', 'rejects a patch item carrying an out-of-set property (additionalProperties:false)')).toBe(false);
   });
 });
 
@@ -337,11 +339,11 @@ describe('a2ui-surface-delta-transport: full + deltas reconstruct the materializ
     ];
 
     for (const frame of frames) {
-      expect(validateFrame(frame), `RFC 0114: each delta frame MUST validate; ${JSON.stringify(validateFrame.errors)}`).toBe(true);
+      expect(validateFrame(frame), req('openwop.it.a2ui-surface-delta-transport.a-full-surface-delta-frames-reconstruct-the-tree-and-equal-the-non-negotiating-f', 'RFC 0114 §"Delta transport', `RFC 0114: each delta frame MUST validate; ${JSON.stringify(validateFrame.errors)}`)).toBe(true);
       // catalogVersion on a delta MUST equal the referenced full surface's.
       expect(
         frame.catalogVersion,
-        'RFC 0114: a delta frame\'s catalogVersion MUST equal the referenced full surface\'s',
+        req('openwop.it.a2ui-surface-delta-transport.a-full-surface-delta-frames-reconstruct-the-tree-and-equal-the-non-negotiating-f', 'RFC 0114 §"Delta transport', 'RFC 0114: a delta frame\'s catalogVersion MUST equal the referenced full surface\'s'),
       ).toBe(full.catalogVersion);
     }
 
@@ -354,13 +356,13 @@ describe('a2ui-surface-delta-transport: full + deltas reconstruct the materializ
     // (a) the reconstruction equals the full surface a non-negotiating subscriber materializes.
     expect(
       reconstructed,
-      'RFC 0114: the delta reconstruction MUST equal the full surface the host materializes for a non-negotiating subscriber',
+      req('openwop.it.a2ui-surface-delta-transport.a-full-surface-delta-frames-reconstruct-the-tree-and-equal-the-non-negotiating-f', 'RFC 0114 §"Delta transport', 'RFC 0114: the delta reconstruction MUST equal the full surface the host materializes for a non-negotiating subscriber'),
     ).toEqual(fullSurfaceMaterializedAfterUpdates());
 
     // (b) the reconstruction re-validates against the closed catalog before render.
     expect(
       validateRecorded(reconstructed),
-      `RFC 0114: the post-patch surface MUST re-validate against the closed catalog; ${JSON.stringify(validateRecorded.errors)}`,
+      req('openwop.it.a2ui-surface-delta-transport.a-full-surface-delta-frames-reconstruct-the-tree-and-equal-the-non-negotiating-f', 'RFC 0114 §"Delta transport', `RFC 0114: the post-patch surface MUST re-validate against the closed catalog; ${JSON.stringify(validateRecorded.errors)}`),
     ).toBe(true);
   });
 });
@@ -390,7 +392,7 @@ describe('a2ui-surface-delta-transport: out-of-catalog delta fails closed (RFC 0
     // The `a2ui-surface-no-code-exec` boundary holds on the post-patch surface.
     expect(
       validateRecorded(postPatch),
-      'RFC 0114 / a2ui-surface-no-code-exec: an out-of-catalog component reached by a delta MUST fail closed-catalog validation post-patch',
+      req('openwop.it.a2ui-surface-delta-transport.a-delta-that-add-s-an-out-of-catalog-component-yields-a-post-patch-surface-that', 'RFC 0114 §"Delta transport', 'RFC 0114 / a2ui-surface-no-code-exec: an out-of-catalog component reached by a delta MUST fail closed-catalog validation post-patch'),
     ).toBe(false);
   });
 
@@ -411,7 +413,7 @@ describe('a2ui-surface-delta-transport: out-of-catalog delta fails closed (RFC 0
     const postPatch = applyPatch(full, frame.patch);
     expect(
       validateRecorded(postPatch),
-      'RFC 0114: a delta MUST NOT be a path by which a smuggled code field reaches render',
+      req('openwop.it.a2ui-surface-delta-transport.a-delta-replace-smuggling-a-script-bearing-property-also-fails-closed-catalog-va', 'RFC 0114 §"Delta transport', 'RFC 0114: a delta MUST NOT be a path by which a smuggled code field reaches render'),
     ).toBe(false);
   });
 });
@@ -425,14 +427,14 @@ describe('a2ui-surface-delta-transport: the recorded envelope is always full (RF
     };
     expect(
       validateRecorded(frame),
-      'RFC 0114: the recorded envelope is NEVER a delta — a delta frame MUST NOT validate as a recorded ui.a2ui-surface payload',
+      req('openwop.it.a2ui-surface-delta-transport.a-delta-frame-does-not-validate-against-the-recorded-ui-a2ui-surface-envelope-sc', 'RFC 0114 §"Delta transport', 'RFC 0114: the recorded envelope is NEVER a delta — a delta frame MUST NOT validate as a recorded ui.a2ui-surface payload'),
     ).toBe(false);
   });
 
   it('the full surface validates as the recorded ui.a2ui-surface payload (event-log read / replay shape)', () => {
     expect(
       validateRecorded(fullSurfaceV0()),
-      'RFC 0114: the event-log read / replay always sees the FULL surface, which MUST validate as the recorded payload',
+      req('openwop.it.a2ui-surface-delta-transport.the-full-surface-validates-as-the-recorded-ui-a2ui-surface-payload-event-log-rea', 'RFC 0114 §"Delta transport', 'RFC 0114: the event-log read / replay always sees the FULL surface, which MUST validate as the recorded payload'),
     ).toBe(true);
   });
 });
@@ -507,9 +509,9 @@ async function getEvents(runId: string, deltaOptIn: boolean): Promise<unknown> {
 describe.skipIf(HTTP_SKIP)('a2ui-surface-delta-transport: live host delta transport (RFC 0114, gated)', () => {
   it('drives the emit-surface seam: a ?a2uiDelta=1 subscriber reconstruction equals the non-negotiating full', async () => {
     const disco = await driver.get('/.well-known/openwop');
-    if (disco.status !== 200) return; // no discovery — soft-skip
+    if (disco.status !== 200) return softSkip('blocked', 'precondition not met — `disco.status !== 200` returned early (no discovery — soft-skip) (seam, prior step, or fixture unavailable)'); // no discovery — soft-skip
     const cap = capabilityFamily<A2uiSurfaceCap>(disco.json, 'a2uiSurface');
-    if (cap?.deltaTransport !== true) return; // capability not advertised — soft-skip
+    if (cap?.deltaTransport !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap?.deltaTransport !== true` returned early (capability not advertised — soft-skip)'); // capability not advertised — soft-skip
 
     const runId = `conf-a2ui-delta-${Date.now()}`;
     const surfaceA = fullSurfaceV0();
@@ -517,53 +519,53 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-delta-transport: live host delta transp
 
     // Baseline (surface A) through the host's REAL surface-emit path.
     const emitA = await driver.post('/v1/host/sample/a2ui/emit-surface', { runId, surface: surfaceA });
-    if (emitA.status === 404 || emitA.status === 405) return; // seam absent — soft-skip the live leg
+    if (emitA.status === 404 || emitA.status === 405) return softSkip('blocked', 'precondition not met — `emitA.status === 404 || emitA.status === 405` returned early (seam absent — soft-skip the live leg) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip the live leg
     expect(
       emitA.status,
-      driver.describe('RFC 0114 §15', 'the emit-surface seam MUST record the baseline full surface'),
+      req('openwop.it.a2ui-surface-delta-transport.drives-the-emit-surface-seam-a-a2uidelta-1-subscriber-reconstruction-equals-the', 'RFC 0114 §15', 'the emit-surface seam MUST record the baseline full surface'),
     ).toBeLessThan(300);
 
     // Second full surface (surface B) — recorded full AND transported as a delta
     // to any ?a2uiDelta=1 subscriber.
     const emitB = await driver.post('/v1/host/sample/a2ui/emit-surface', { runId, surface: surfaceB });
-    if (emitB.status === 404 || emitB.status === 405) return;
-    expect(emitB.status, driver.describe('RFC 0114 §15', 'the second emit MUST succeed')).toBeLessThan(300);
+    if (emitB.status === 404 || emitB.status === 405) return softSkip('blocked', 'precondition not met — `emitB.status === 404 || emitB.status === 405` returned early (seam, prior step, or fixture unavailable)');
+    expect(emitB.status, req('openwop.it.a2ui-surface-delta-transport.drives-the-emit-surface-seam-a-a2uidelta-1-subscriber-reconstruction-equals-the', 'RFC 0114 §15', 'the second emit MUST succeed')).toBeLessThan(300);
     const refB = (emitB.json as EmitSurfaceResponse)?.surfaceRef;
 
     // ?a2uiDelta=1 subscriber: locate the delta frame the host transported.
     const deltaEvents = await getEvents(runId, true);
-    if (deltaEvents === null) return; // events stream unavailable in JSON — soft-skip
+    if (deltaEvents === null) return softSkip('blocked', 'precondition not met — `deltaEvents === null` returned early (events stream unavailable in JSON — soft-skip) (seam, prior step, or fixture unavailable)'); // events stream unavailable in JSON — soft-skip
     const frames = collectMatching(deltaEvents, validateFrame)
       .map(readFrame)
       .filter((f): f is { surfaceRef: string; catalogVersion: string; patch: PatchOp[] } => f !== null)
       .filter((f) => refB === undefined || f.surfaceRef === refB);
-    if (frames.length === 0) return; // host streams SSE-only or buffered the frame — soft-skip
+    if (frames.length === 0) return softSkip('blocked', 'precondition not met — `frames.length === 0` returned early (host streams SSE-only or buffered the frame — soft-skip) (seam, prior step, or fixture unavailable)'); // host streams SSE-only or buffered the frame — soft-skip
     const frame = frames[frames.length - 1];
 
     // catalogVersion on the delta MUST equal the baseline full surface's.
     expect(
       frame.catalogVersion,
-      driver.describe('RFC 0114', 'a delta frame catalogVersion MUST equal the referenced full surface'),
+      req('openwop.it.a2ui-surface-delta-transport.drives-the-emit-surface-seam-a-a2uidelta-1-subscriber-reconstruction-equals-the', 'RFC 0114', 'a delta frame catalogVersion MUST equal the referenced full surface'),
     ).toBe(surfaceA.catalogVersion);
 
     // Reconstruct: apply the host's real delta to the baseline, re-validate against the closed catalog.
     const reconstructed = applyPatch(surfaceA, frame.patch);
     expect(
       validateRecorded(reconstructed),
-      driver.describe('RFC 0114 §"Delta transport"', 'the post-patch surface MUST re-validate against the closed catalog'),
+      req('openwop.it.a2ui-surface-delta-transport.drives-the-emit-surface-seam-a-a2uidelta-1-subscriber-reconstruction-equals-the', 'RFC 0114 §"Delta transport"', 'the post-patch surface MUST re-validate against the closed catalog'),
     ).toBe(true);
 
     // Non-negotiating subscriber: the host materializes the FULL surface for the same update.
     const fullEvents = await getEvents(runId, false);
-    if (fullEvents === null) return;
+    if (fullEvents === null) return softSkip('blocked', 'precondition not met — `fullEvents === null` returned early (seam, prior step, or fixture unavailable)');
     const fulls = collectMatching(fullEvents, validateRecorded);
-    if (fulls.length === 0) return; // soft-skip — no full surface observed on the non-delta stream
+    if (fulls.length === 0) return softSkip('blocked', 'precondition not met — `fulls.length === 0` returned early (soft-skip — no full surface observed on the non-delta stream) (seam, prior step, or fixture unavailable)'); // soft-skip — no full surface observed on the non-delta stream
     const materializedFull = fulls[fulls.length - 1];
 
     // delta and full agree — the core RFC 0114 transport guarantee, witnessed live.
     expect(
       reconstructed,
-      driver.describe(
+      req('openwop.it.a2ui-surface-delta-transport.drives-the-emit-surface-seam-a-a2uidelta-1-subscriber-reconstruction-equals-the', 
         'RFC 0114 §"Delta transport"',
         'a ?a2uiDelta=1 reconstruction MUST equal the full surface a non-negotiating subscriber materializes',
       ),
@@ -572,14 +574,14 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-delta-transport: live host delta transp
 
   it('the emit-surface seam rejects an out-of-catalog surface fail-closed (real catalog gate)', async () => {
     const disco = await driver.get('/.well-known/openwop');
-    if (disco.status !== 200) return;
+    if (disco.status !== 200) return softSkip('blocked', 'precondition not met — `disco.status !== 200` returned early (seam, prior step, or fixture unavailable)');
     const cap = capabilityFamily<A2uiSurfaceCap>(disco.json, 'a2uiSurface');
-    if (cap?.deltaTransport !== true) return;
+    if (cap?.deltaTransport !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap?.deltaTransport !== true` returned early');
 
     const runId = `conf-a2ui-delta-oob-${Date.now()}`;
     const baseline = await driver.post('/v1/host/sample/a2ui/emit-surface', { runId, surface: fullSurfaceV0() });
-    if (baseline.status === 404 || baseline.status === 405) return; // seam absent — soft-skip
-    expect(baseline.status, driver.describe('RFC 0114 §15', 'baseline emit MUST succeed')).toBeLessThan(300);
+    if (baseline.status === 404 || baseline.status === 405) return softSkip('blocked', 'precondition not met — `baseline.status === 404 || baseline.status === 405` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
+    expect(baseline.status, req('openwop.it.a2ui-surface-delta-transport.the-emit-surface-seam-rejects-an-out-of-catalog-surface-fail-closed-real-catalog', 'RFC 0114 §15', 'baseline emit MUST succeed')).toBeLessThan(300);
 
     // An out-of-catalog surface MUST be rejected by the host's REAL closed-catalog
     // validator — no delta transported, the a2ui-surface-no-code-exec boundary holds.
@@ -588,10 +590,10 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-delta-transport: live host delta transp
       surface: { components: [{ component: 'iframe', src: 'https://evil.example/x' }] },
     };
     const rejected = await driver.post('/v1/host/sample/a2ui/emit-surface', { runId, surface: outOfCatalog });
-    if (rejected.status === 404 || rejected.status === 405) return;
+    if (rejected.status === 404 || rejected.status === 405) return softSkip('blocked', 'precondition not met — `rejected.status === 404 || rejected.status === 405` returned early (seam, prior step, or fixture unavailable)');
     expect(
       rejected.status,
-      driver.describe(
+      req('openwop.it.a2ui-surface-delta-transport.the-emit-surface-seam-rejects-an-out-of-catalog-surface-fail-closed-real-catalog', 
         'RFC 0114 §15 / a2ui-surface-no-code-exec',
         'an out-of-catalog surface MUST be rejected fail-closed by the host real catalog validator',
       ),

package/src/scenarios/a2ui-surface-replay.test.ts

@@ -21,6 +21,8 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const schema = JSON.parse(
@@ -45,7 +47,7 @@ describe('a2ui-surface-replay: self-contained surface (RFC 0102 §A.6)', () => {
     const external = refs.filter((r) => !r.startsWith('#'));
     expect(
       external,
-      'RFC 0102 §A.6: a stored surface MUST be self-contained for deterministic :fork/replay (no live external-catalog ref)',
+      req('openwop.it.a2ui-surface-replay.all-refs-are-internal-surface-renders-from-the-payload-alone-on-replay', 'RFC 0102 §A.6', 'RFC 0102 §A.6: a stored surface MUST be self-contained for deterministic :fork/replay (no live external-catalog ref)'),
     ).toEqual([]);
   });
 });
@@ -63,7 +65,7 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-replay: correlationId conflict on type
       envelope: { ...base, type: 'ui.a2ui-surface', envelopeId: 'env-a2ui-rep-1' },
       hostSupportedEnvelopes: ['ui.a2ui-surface', 'clarification.request'],
     });
-    if (first.status === 404) return; // seam absent — soft-skip
+    if (first.status === 404) return softSkip('blocked', 'precondition not met — `first.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
 
     const conflict = await driver.post('/v1/host/sample/envelope/accept', {
       envelope: {
@@ -74,11 +76,11 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-replay: correlationId conflict on type
       },
       hostSupportedEnvelopes: ['ui.a2ui-surface', 'clarification.request'],
     });
-    if (conflict.status === 404) return;
+    if (conflict.status === 404) return softSkip('blocked', 'precondition not met — `conflict.status === 404` returned early (seam, prior step, or fixture unavailable)');
     const body = conflict.json as { status?: string; reason?: string };
     expect(
       body.reason ?? '',
-      driver.describe('ai-envelope.md §"Replay determinism"', 'same correlationId + divergent type MUST conflict'),
+      req('openwop.it.a2ui-surface-replay.re-emission-with-same-correlationid-different-type-envelope-correlation-conflict', 'ai-envelope.md §"Replay determinism"', 'same correlationId + divergent type MUST conflict'),
     ).toContain('envelope_correlation_conflict');
   });
 });

package/src/scenarios/a2ui-surface-shape.test.ts

@@ -31,6 +31,7 @@ import Ajv2020 from 'ajv/dist/2020.js';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { req } from '../lib/requirement-ids.js';
 
 const ajv = new Ajv2020({ strict: false, allErrors: true });
 const schema = JSON.parse(
@@ -70,7 +71,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
   it('ui.a2ui-surface.schema.json compiles under Ajv2020', () => {
     expect(
       validate,
-      'RFC 0102 §A: the core ui.a2ui-surface payload schema MUST compile',
+      req('openwop.it.a2ui-surface-shape.ui-a2ui-surface-schema-json-compiles-under-ajv2020', 'RFC 0102 §A', 'RFC 0102 §A: the core ui.a2ui-surface payload schema MUST compile'),
     ).toBeTypeOf('function');
   });
 
@@ -78,7 +79,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     const ok = validate(positivePayload());
     expect(
       ok,
-      `RFC 0102 §A: positive surface MUST validate; errors: ${JSON.stringify(validate.errors)}`,
+      req('openwop.it.a2ui-surface-shape.accepts-a-positive-surface-payload-closed-catalog-confined-action', 'RFC 0102 §A', `RFC 0102 §A: positive surface MUST validate; errors: ${JSON.stringify(validate.errors)}`),
     ).toBe(true);
   });
 
@@ -87,19 +88,19 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     (p.surface as { components: Array<Record<string, unknown>> }).components = [
       { component: 'action.button', id: 'send', label: 'Send', action: { target: 'exchange' } },
     ];
-    expect(validate(p)).toBe(true);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.accepts-an-exchange-targeted-action-the-other-confined-target', 'RFC 0102 §A', 'accepts an exchange-targeted action (the other confined target)')).toBe(true);
   });
 
   it('rejects a payload missing required `catalogVersion`', () => {
     const p = positivePayload();
     delete p.catalogVersion;
-    expect(validate(p), 'RFC 0102 §A: `catalogVersion` is REQUIRED').toBe(false);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.rejects-a-payload-missing-required-catalogversion', 'RFC 0102 §A', 'RFC 0102 §A: `catalogVersion` is REQUIRED')).toBe(false);
   });
 
   it('rejects a payload missing required `surface`', () => {
     const p = positivePayload();
     delete p.surface;
-    expect(validate(p), 'RFC 0102 §A: `surface` is REQUIRED').toBe(false);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.rejects-a-payload-missing-required-surface', 'RFC 0102 §A', 'RFC 0102 §A: `surface` is REQUIRED')).toBe(false);
   });
 
   it('rejects a `catalogVersion` the schema does not enumerate (unknown version)', () => {
@@ -107,7 +108,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     p.catalogVersion = '9.9.9';
     expect(
       validate(p),
-      'RFC 0102 §A.3: an unadvertised catalogVersion MUST fail the enumerated set',
+      req('openwop.it.a2ui-surface-shape.rejects-a-catalogversion-the-schema-does-not-enumerate-unknown-version', 'RFC 0102 §A', 'RFC 0102 §A.3: an unadvertised catalogVersion MUST fail the enumerated set'),
     ).toBe(false);
   });
 
@@ -118,7 +119,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.1: an out-of-catalog component MUST fail the closed anyOf',
+      req('openwop.it.a2ui-surface-shape.rejects-an-out-of-catalog-component-object-additionalproperties-false', 'RFC 0102 §A', 'RFC 0102 §A.1: an out-of-catalog component MUST fail the closed anyOf'),
     ).toBe(false);
   });
 
@@ -129,7 +130,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.1: additionalProperties:false MUST reject a smuggled code field',
+      req('openwop.it.a2ui-surface-shape.rejects-a-known-component-carrying-an-extra-script-bearing-property', 'RFC 0102 §A', 'RFC 0102 §A.1: additionalProperties:false MUST reject a smuggled code field'),
     ).toBe(false);
   });
 
@@ -140,7 +141,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.4 / SECURITY a2ui-action-confinement: an action target outside resume/exchange MUST be rejected',
+      req('openwop.it.a2ui-surface-shape.rejects-an-action-whose-target-is-outside-enum-resume-exchange-action-confinemen', 'RFC 0102 §A', 'RFC 0102 §A.4 / SECURITY a2ui-action-confinement: an action target outside resume/exchange MUST be rejected'),
     ).toBe(false);
   });
 
@@ -156,7 +157,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.4: action additionalProperties:false MUST reject an arbitrary URL target',
+      req('openwop.it.a2ui-surface-shape.rejects-an-action-carrying-an-arbitrary-url-field-no-unconfined-egress-target', 'RFC 0102 §A', 'RFC 0102 §A.4: action additionalProperties:false MUST reject an arbitrary URL target'),
     ).toBe(false);
   });
 });

package/src/scenarios/a2ui-surface-version-refusal.test.ts

@@ -20,6 +20,8 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const schema = JSON.parse(
@@ -42,14 +44,14 @@ describe('a2ui-surface-version-refusal: enumerated catalogVersion (RFC 0102 §A.
     const ok = validate({ catalogVersion: '9.9.9', surface: { components: [] } });
     expect(
       ok,
-      'RFC 0102 §A.3: a catalogVersion outside the host-enumerated set MUST fail (→ unknown_schema_version at runtime)',
+      req('openwop.it.a2ui-surface-version-refusal.catalogversion-is-a-closed-enum-an-unadvertised-version-fails-validation', 'RFC 0102 §A.3', 'RFC 0102 §A.3: a catalogVersion outside the host-enumerated set MUST fail (→ unknown_schema_version at runtime)'),
     ).toBe(false);
   });
 
   it('surface payload is self-contained — no external $ref (replay determinism)', () => {
     expect(
       hasAbsoluteRef(schema),
-      'RFC 0102 §A.3: the surface MUST be self-contained, never a live external-catalog reference',
+      req('openwop.it.a2ui-surface-version-refusal.surface-payload-is-self-contained-no-external-ref-replay-determinism', 'RFC 0102 §A.3', 'RFC 0102 §A.3: the surface MUST be self-contained, never a live external-catalog reference'),
     ).toBe(false);
   });
 });
@@ -67,11 +69,11 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-version-refusal: live host refuses unad
       },
       hostSupportedEnvelopes: ['ui.a2ui-surface'],
     });
-    if (res.status === 404) return; // seam absent — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
     const body = res.json as { status?: string; reason?: string };
     expect(
       body.status === 'invalid' || body.status === 'refused',
-      driver.describe('RFC 0102 §A.3', 'an unadvertised catalogVersion MUST be refused'),
+      req('openwop.it.a2ui-surface-version-refusal.ui-a2ui-surface-with-an-unadvertised-catalogversion-refused', 'RFC 0102 §A.3', 'an unadvertised catalogVersion MUST be refused'),
     ).toBe(true);
   });
 });

package/src/scenarios/a2ui-untrusted-blocks-approval.test.ts

@@ -21,6 +21,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const UNIVERSAL_KINDS = ['clarification.request', 'schema.request', 'schema.response', 'error'];
@@ -29,7 +31,7 @@ describe('a2ui-untrusted-blocks-approval: trust machinery applies (RFC 0102 §A.
   it('ui.a2ui-surface is an advertised kind subject to meta.contentTrust gating (not universal/always-allowed)', () => {
     expect(
       UNIVERSAL_KINDS.includes('ui.a2ui-surface'),
-      'ai-envelope.md §"A2UI surfaces" / §"Trust boundary": a ui.a2ui-surface is trust-gated like any advertised envelope, so an untrusted surface is subject to untrusted_content_blocks_approval',
+      req('openwop.it.a2ui-untrusted-blocks-approval.ui-a2ui-surface-is-an-advertised-kind-subject-to-meta-contenttrust-gating-not-un', 'RFC 0102 §A.5', 'ai-envelope.md §"A2UI surfaces" / §"Trust boundary": a ui.a2ui-surface is trust-gated like any advertised envelope, so an untrusted surface is subject to untrusted_content_blocks_approval'),
     ).toBe(false);
   });
 });
@@ -55,11 +57,11 @@ describe.skipIf(HTTP_SKIP)('a2ui-untrusted-blocks-approval: untrusted surface ca
       hostSupportedEnvelopes: ['ui.a2ui-surface'],
       boundInterruptKind: 'approval',
     });
-    if (res.status === 404) return; // seam absent — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
     const body = res.json as { status?: string; reason?: string };
     expect(
       body.status === 'blocked' || (body.reason ?? '').includes('untrusted'),
-      driver.describe(
+      req('openwop.it.a2ui-untrusted-blocks-approval.an-untrusted-marked-ui-a2ui-surface-bound-to-an-approval-interrupt-is-refused', 
         'RFC 0102 §A.5',
         'an untrusted ui.a2ui-surface MUST NOT advance an approval interrupt (untrusted_content_blocks_approval)',
       ),