@openwop/openwop-conformance 1.163.0 → 2.0.0-rc.1

package/src/scenarios/a2a-task-roundtrip.test.ts

@@ -47,7 +47,8 @@ import { pollUntilTerminal, pollUntilStatus } from '../lib/polling.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
-import { seamAbsent } from '../lib/soft-skip.js';
+import { seamAbsent, softSkip } from '../lib/soft-skip.js';
+import { req } from '../lib/requirement-ids.js';
 
 /**
  * Callback-shaped: the host issues A2A JSON-RPC calls to the suite's fake peer.
@@ -113,7 +114,7 @@ describe('a2a-task-roundtrip: AgentCard + task lifecycle', () => {
         '[a2a-task-roundtrip] no A2A endpoint configured; set OPENWOP_A2A_FAKE_PEER=true ' +
           'or OPENWOP_A2A_REAL_PEER_URL=<base-url>',
       );
-      return;
+      return softSkip('blocked', 'precondition not met — `!probe` returned early (seam, prior step, or fixture unavailable)');
     }
     if (!probe.isReal) getA2AFakePeer()!.reset();
 
@@ -137,7 +138,7 @@ describe('a2a-task-roundtrip: AgentCard + task lifecycle', () => {
       cardJson.supportedInterfaces?.find((i) => typeof i.protocolVersion === 'string')?.protocolVersion;
     expect(
       typeof advertisedVersion,
-      'the card MUST advertise a protocol version — top-level (0.3) or per interface (1.0)',
+      req('openwop.it.a2a-task-roundtrip.agentcard-exposes-a-protocol-version-0-3-top-level-or-1-0-per-interface-skills-m', 'spec/v1/a2a-integration.md', 'the card MUST advertise a protocol version — top-level (0.3) or per interface (1.0)'),
     ).toBe('string');
     expect(Array.isArray(cardJson.skills)).toBe(true);
     expect((cardJson.skills ?? []).length).toBeGreaterThan(0);
@@ -181,7 +182,7 @@ describe('a2a-task-roundtrip: AgentCard + task lifecycle', () => {
         `[a2a-task-roundtrip] real-peer interop OK against ${probe.url} ` +
           `(skill=${firstSkill?.id ?? firstSkill?.name}, kind=${kind})`,
       );
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.isReal` returned early (seam, prior step, or fixture unavailable)');
     }
 
     // Fake-peer path: deterministic state forcing, assert verbatim.
@@ -224,14 +225,14 @@ describe('a2a-task-roundtrip: drift point #3 — AUTH_REQUIRED projects to waiti
     if (!peer) {
       // eslint-disable-next-line no-console
       console.warn('[a2a-task-roundtrip] peer not started; skipping drift-point #3 subtest');
-      return;
+      return softSkip('blocked', 'precondition not met — `!peer` returned early ([a2a-task-roundtrip] peer not started; skipping drift-point #3 subtest) (seam, prior step, or fixture unavailable)');
     }
     if (!isFixtureAdvertised(ROUNDTRIP_FIXTURE)) {
       // eslint-disable-next-line no-console
       console.warn(
         `[a2a-task-roundtrip] fixture ${ROUNDTRIP_FIXTURE} not advertised; skipping drift-point #3 subtest`,
       );
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!isFixtureAdvertised(ROUNDTRIP_FIXTURE)` returned early ([a2a-task-roundtrip] fixture … not advertised; skipping drift-point #3 subtest)');
     }
     peer.reset();
     peer.setNextState('AUTH_REQUIRED');
@@ -246,7 +247,7 @@ describe('a2a-task-roundtrip: drift point #3 — AUTH_REQUIRED projects to waiti
     // Host should project AUTH_REQUIRED into `waiting-input` per
     // a2a-integration.md §"State projection (reverse)".
     const snapshot = await pollUntilStatus(runId, 'waiting-input', { timeoutMs: 15_000 });
-    expect(snapshot.status, driver.describe(
+    expect(snapshot.status, req('openwop.it.a2a-task-roundtrip.host-consuming-an-a2a-peer-that-returns-auth-required-projects-to-waiting-input', 
       'a2a-integration.md §"State projection" drift point #3',
       "A2A AUTH_REQUIRED MUST project to openwop 'waiting-input' (no native auth-required kind in v1)",
     )).toBe('waiting-input');
@@ -264,10 +265,10 @@ describe('a2a-task-roundtrip: drift point #4 — REJECTED projects to failed', (
     if (!peer) {
       // eslint-disable-next-line no-console
       console.warn('[a2a-task-roundtrip] peer not started; skipping drift-point #4 subtest');
-      return;
+      return softSkip('blocked', 'precondition not met — `!peer` returned early ([a2a-task-roundtrip] peer not started; skipping drift-point #4 subtest) (seam, prior step, or fixture unavailable)');
     }
     if (!isFixtureAdvertised(ROUNDTRIP_FIXTURE)) {
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!isFixtureAdvertised(ROUNDTRIP_FIXTURE)` returned early');
     }
     peer.reset();
     peer.setNextState('REJECTED');
@@ -280,7 +281,7 @@ describe('a2a-task-roundtrip: drift point #4 — REJECTED projects to failed', (
     const runId = (create.json as { runId: string }).runId;
 
     const terminal = await pollUntilTerminal(runId, { timeoutMs: 15_000 });
-    expect(terminal.status, driver.describe(
+    expect(terminal.status, req('openwop.it.a2a-task-roundtrip.host-consuming-an-a2a-peer-that-returns-rejected-projects-to-failed-with-rejecte', 
       'a2a-integration.md §"State projection" drift point #4',
       'A2A REJECTED MUST project to openwop terminal status `failed`',
     )).toBe('failed');
@@ -289,7 +290,7 @@ describe('a2a-task-roundtrip: drift point #4 — REJECTED projects to failed', (
     // snapshot, the final node payload, or the run-level error envelope.
     // We accept any of those: stringify the snapshot and search.
     const haystack = JSON.stringify(terminal).toLowerCase();
-    expect(haystack.includes('rejected'), driver.describe(
+    expect(haystack.includes('rejected'), req('openwop.it.a2a-task-roundtrip.host-consuming-an-a2a-peer-that-returns-rejected-projects-to-failed-with-rejecte', 
       'a2a-integration.md §"State projection" drift point #4',
       "host SHOULD surface 'rejected_by_remote' (or equivalent) so observers can attribute the failure to the remote A2A peer",
     )).toBe(true);
@@ -322,14 +323,14 @@ describe('a2a-task-roundtrip: A2ATaskState + a2a capability shape (always-on, se
     };
     expect(
       validateTaskState(ok),
-      `a2a-task-state.schema.json MUST accept a conforming record. Errors: ${JSON.stringify(validateTaskState.errors)}`,
+      req('openwop.it.a2a-task-roundtrip.a-conforming-a2ataskstate-validates-with-the-lowercase-hyphen-state-enum-and-tas', 'spec/v1/a2a-integration.md', `a2a-task-state.schema.json MUST accept a conforming record. Errors: ${JSON.stringify(validateTaskState.errors)}`),
     ).toBe(true);
   });
 
   it('an UPPERCASE state fails (the persisted/wire form is the A2A v0.3 lowercase-hyphen variant)', () => {
     expect(
       validateTaskState({ taskId: 'r', runId: 'r', state: 'WORKING', updatedAt: '2026-06-13T19:00:00Z' }),
-      'a2a-integration.md spelling-drift note — the persisted A2ATaskState.state MUST be the lowercase-hyphen form',
+      req('openwop.it.a2a-task-roundtrip.an-uppercase-state-fails-the-persisted-wire-form-is-the-a2a-v0-3-lowercase-hyphe', 'spec/v1/a2a-integration.md', 'a2a-integration.md spelling-drift note — the persisted A2ATaskState.state MUST be the lowercase-hyphen form'),
     ).toBe(false);
   });
 
@@ -342,7 +343,7 @@ describe('a2a-task-roundtrip: A2ATaskState + a2a capability shape (always-on, se
         updatedAt: '2026-06-13T19:00:00Z',
         inputs: { secret: 'x' },
       }),
-      'SECURITY a2a-push-egress-ssrf / SR-1 — the persisted record MUST NOT carry run inputs/outputs/artifacts inline',
+      req('openwop.it.a2a-task-roundtrip.an-a2ataskstate-carrying-run-inputs-artifacts-inline-fails-additionalproperties', 'spec/v1/a2a-integration.md', 'SECURITY a2a-push-egress-ssrf / SR-1 — the persisted record MUST NOT carry run inputs/outputs/artifacts inline'),
     ).toBe(false);
   });
 
@@ -351,27 +352,27 @@ describe('a2a-task-roundtrip: A2ATaskState + a2a capability shape (always-on, se
       $ref: 'https://openwop.dev/spec/v1/a2a-task-state.schema.json#/$defs/PushConfig',
       $defs: taskStateSchema.$defs,
     });
-    expect(validatePush({ tokenFingerprint: 'a1b2' }), 'PushConfig MUST require `url`').toBe(false);
+    expect(validatePush({ tokenFingerprint: 'a1b2' }), req('openwop.it.a2a-task-roundtrip.a-pushconfig-requires-url-and-structurally-rejects-a-raw-non-truncated-push-toke', 'spec/v1/a2a-integration.md', 'PushConfig MUST require `url`')).toBe(false);
     expect(
       validatePush({ url: 'https://caller.example.com/push', tokenFingerprint: 'a'.repeat(33) }),
-      'SECURITY a2a-push-egress-ssrf — tokenFingerprint maxLength:32 structurally rejects a full-length raw token (SR-1)',
+      req('openwop.it.a2a-task-roundtrip.a-pushconfig-requires-url-and-structurally-rejects-a-raw-non-truncated-push-toke', 'spec/v1/a2a-integration.md', 'SECURITY a2a-push-egress-ssrf — tokenFingerprint maxLength:32 structurally rejects a full-length raw token (SR-1)'),
     ).toBe(false);
     expect(
       validatePush({ url: 'https://caller.example.com/push', tokenFingerprint: 'a1b2c3d4' }),
-      'a truncated fingerprint + uri url MUST validate',
+      req('openwop.it.a2a-task-roundtrip.a-pushconfig-requires-url-and-structurally-rejects-a-raw-non-truncated-push-toke', 'spec/v1/a2a-integration.md', 'a truncated fingerprint + uri url MUST validate'),
     ).toBe(true);
   });
 
   it('the capabilities.a2a block shape is declared (supported + agentCardUrl required; three optional booleans)', () => {
-    expect(a2aBlockSchema, 'capabilities.schema.json MUST declare the a2a block').toBeDefined();
+    expect(a2aBlockSchema, req('openwop.it.a2a-task-roundtrip.the-capabilities-a2a-block-shape-is-declared-supported-agentcardurl-required-thr', 'spec/v1/a2a-integration.md', 'capabilities.schema.json MUST declare the a2a block')).toBeDefined();
     expect(a2aBlockSchema.required).toEqual(expect.arrayContaining(['supported', 'agentCardUrl']));
     expect(a2aBlockSchema.additionalProperties).toBe(false);
     const validateA2A = ajv.compile({ ...a2aBlockSchema, $id: 'urn:test:a2a-block' });
     expect(
       validateA2A({ supported: true, agentCardUrl: 'https://example.com/.well-known/agent-card.json', durableTasks: true }),
-      `a conforming a2a block MUST validate. Errors: ${JSON.stringify(validateA2A.errors)}`,
+      req('openwop.it.a2a-task-roundtrip.the-capabilities-a2a-block-shape-is-declared-supported-agentcardurl-required-thr', 'spec/v1/a2a-integration.md', `a conforming a2a block MUST validate. Errors: ${JSON.stringify(validateA2A.errors)}`),
     ).toBe(true);
-    expect(validateA2A({ supported: true }), 'agentCardUrl is required').toBe(false);
+    expect(validateA2A({ supported: true }), req('openwop.it.a2a-task-roundtrip.the-capabilities-a2a-block-shape-is-declared-supported-agentcardurl-required-thr', 'spec/v1/a2a-integration.md', 'agentCardUrl is required')).toBe(false);
   });
 });
 
@@ -386,20 +387,20 @@ describe.skipIf(HTTP_SKIP)('a2a-task-roundtrip: durable tasks/get after disconne
     const start = await driver.post('/v1/host/sample/a2a/tasks/start', {
       scenario: 'paused-at-approval',
     });
-    if (start.status === 404 || start.status === 403) return; // seam unwired — soft-skip
+    if (start.status === 404 || start.status === 403) return softSkip('blocked', 'precondition not met — `start.status === 404 || start.status === 403` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
     const taskId = (start.json as { taskId?: string })?.taskId;
-    if (!taskId) return;
+    if (!taskId) return softSkip('blocked', 'precondition not met — `!taskId` returned early (seam, prior step, or fixture unavailable)');
 
     const read = await driver.get(`/v1/host/sample/a2a/tasks/${encodeURIComponent(taskId)}`);
-    if (read.status === 404 || read.status === 403) return;
+    if (read.status === 404 || read.status === 403) return softSkip('blocked', 'precondition not met — `read.status === 404 || read.status === 403` returned early (seam, prior step, or fixture unavailable)');
     const state = read.json as { state?: string; runId?: string; metadata?: { openwop?: { interrupt?: { kind?: string } } } };
     expect(
       state.state,
-      driver.describe('a2a-integration.md §"Async / durable Tasks"', 'tasks/get after disconnect MUST return the live input-required projection (not a stale working)'),
+      req('openwop.it.a2a-task-roundtrip.a-paused-at-hitl-run-projects-a-live-input-required-task-on-a-later-tasks-get-re', 'a2a-integration.md §"Async / durable Tasks"', 'tasks/get after disconnect MUST return the live input-required projection (not a stale working)'),
     ).toBe('input-required');
     expect(
       state.runId,
-      driver.describe('a2a-task-state.schema.json', 'taskId MUST equal the backing runId'),
+      req('openwop.it.a2a-task-roundtrip.a-paused-at-hitl-run-projects-a-live-input-required-task-on-a-later-tasks-get-re', 'a2a-task-state.schema.json', 'taskId MUST equal the backing runId'),
     ).toBe(taskId);
   });
 });
@@ -451,10 +452,10 @@ describe.skipIf(HTTP_SKIP)('a2a-task-roundtrip: push-config SSRF, two-sided (gat
     // `https` on purpose: this probe is refusable ONLY by the address arm, so a
     // host that implements the scheme arm alone cannot pass it by accident.
     const res = await registerPush('https://10.0.0.5/push');
-    if (res === null) return;
+    if (res === null) return softSkip('blocked', 'precondition not met — `res === null` returned early (seam, prior step, or fixture unavailable)');
     expect(
       res.status >= 400,
-      driver.describe(
+      req('openwop.it.a2a-task-roundtrip.address-arm-an-https-pushconfig-url-at-a-private-address-is-refused', 
         'a2a-integration.md §D.6 (address arm)',
         'a2a-push-egress-ssrf — a pushConfig.url at a private/loopback address MUST be refused before any push, even over https',
       ),
@@ -464,10 +465,10 @@ describe.skipIf(HTTP_SKIP)('a2a-task-roundtrip: push-config SSRF, two-sided (gat
   it('SCHEME arm: an http pushConfig.url at a public host is refused', async () => {
     // Public hostname on purpose: refusable ONLY by the scheme arm.
     const res = await registerPush('http://push.example.com/push');
-    if (res === null) return;
+    if (res === null) return softSkip('blocked', 'precondition not met — `res === null` returned early (seam, prior step, or fixture unavailable)');
     expect(
       res.status >= 400,
-      driver.describe(
+      req('openwop.it.a2a-task-roundtrip.scheme-arm-an-http-pushconfig-url-at-a-public-host-is-refused', 
         'a2a-integration.md §D.6 (scheme arm)',
         'a2a-push-egress-ssrf — a plaintext `http://` pushConfig.url MUST be refused before any push. '
           + 'The RFC 0093 webhook-egress guard is the `webhooks.md` §"SSRF protection" list IN FULL, whose first entry is '

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');
   });
 });