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

package/src/scenarios/voice-interim-not-durable.test.ts

@@ -20,6 +20,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const SEAM = '/v1/host/sample/ai/call-transcriber';
 
@@ -42,18 +44,18 @@ describe('voice-interim-not-durable (RFC 0106 §F INV-1)', () => {
     if (!behaviorGate('openwop-voice-interim-not-durable', advertised)) return;
 
     const res = await driver.post(SEAM, { audio: { streamRef: 'stream:conformance/mic' }, interimResults: true });
-    if (res.status === 404) return; // seam unwired — soft-skip
-    if (errCode(res.json) === 'transcription_unsupported') return; // §E live transport / no test-seam arm — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
+    if (errCode(res.json) === 'transcription_unsupported') return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `errCode(res.json) === \'transcription_unsupported\'` returned early (§E live transport / no test-seam arm — soft-skip)'); // §E live transport / no test-seam arm — soft-skip
 
     const events = eventsOf(res.json);
-    if (events.length === 0) return; // host returned only the result envelope — nothing observable to assert
+    if (events.length === 0) return softSkip('blocked', 'precondition not met — `events.length === 0` returned early (host returned only the result envelope — nothing observable to assert) (seam, prior step, or fixture unavailable)'); // host returned only the result envelope — nothing observable to assert
 
     const commitIdx = events.findIndex((e) => e.type === 'voice.turn_commit');
-    if (commitIdx < 0) return; // no commit observed — soft-skip
+    if (commitIdx < 0) return softSkip('blocked', 'precondition not met — `commitIdx < 0` returned early (no commit observed — soft-skip) (seam, prior step, or fixture unavailable)'); // no commit observed — soft-skip
     const afterCommit = events.slice(commitIdx + 1);
     expect(
       !afterCommit.some((e) => e.type === 'voice.transcript' && (e.payload ?? {}).isFinal === false),
-      driver.describe('RFC 0106 §F INV-1', 'a provisional (isFinal:false) transcript MUST NOT appear after voice.turn_commit'),
+      req('openwop.it.voice-interim-not-durable.no-provisional-isfinal-false-transcript-is-durable-past-voice-turn-commit', 'RFC 0106 §F INV-1', 'a provisional (isFinal:false) transcript MUST NOT appear after voice.turn_commit'),
     ).toBe(true);
   });
 });

package/src/scenarios/voice-streamref-tenant-bound.test.ts

@@ -22,6 +22,8 @@ import { readErrorCode } from '../lib/error-envelope.js';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const SEAM = '/v1/host/sample/ai/call-transcriber';
 
@@ -44,8 +46,8 @@ describe('voice-streamref-tenant-bound (RFC 0106 §F INV-4)', () => {
     // conduit to bind cross-tenant — soft-skip (the invariant stays reference-impl
     // until a host with live streamRef transport proves it).
     const res = await driver.post(SEAM, { audio: { streamRef: 'stream:tenant-a/mic' } });
-    if (res.status === 404) return;
-    if (errCode(res.json) === 'transcription_unsupported') return; // §E — no live transport on this host
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam, prior step, or fixture unavailable)');
+    if (errCode(res.json) === 'transcription_unsupported') return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `errCode(res.json) === \'transcription_unsupported\'` returned early (§E — no live transport on this host)'); // §E — no live transport on this host
 
     // A host that DOES accept a live streamRef must bind it: a second tenant presenting
     // tenant-A's streamRef MUST be rejected (cross-handle read forbidden). Exercising the
@@ -54,7 +56,7 @@ describe('voice-streamref-tenant-bound (RFC 0106 §F INV-4)', () => {
     // another tenant's buffered audio for an unknown streamRef.
     expect(
       res.status !== 200 || (res.json as { finalText?: unknown })?.finalText !== undefined,
-      driver.describe('RFC 0106 §F INV-4', 'a host honoring a live streamRef MUST bind it to its tenant+session'),
+      req('openwop.it.voice-streamref-tenant-bound.a-live-streamref-is-tenant-session-bound-host-internal-transport-per-e-soft-skip', 'RFC 0106 §F INV-4', 'a host honoring a live streamRef MUST bind it to its tenant+session'),
     ).toBe(true);
   });
 });

package/src/scenarios/voice-synthesis-streaming.test.ts

@@ -23,6 +23,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const SEAM = '/v1/host/sample/ai/call-speech-synthesizer';
 
@@ -42,36 +44,36 @@ describe('voice-synthesis-streaming (RFC 0106 §C)', () => {
     if (!behaviorGate('openwop-voice-synthesis', advertised)) return;
 
     const res = await driver.post(SEAM, { text: 'Welcome to the weekly digest.', voiceId: 'host:narrator-test', stream: true });
-    if (res.status === 404) return; // seam unwired — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
 
     expect(
       res.status === 200,
-      driver.describe('RFC 0106 §C', 'an advertised host MUST resolve stream:true with 200'),
+      req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'an advertised host MUST resolve stream:true with 200'),
     ).toBe(true);
 
     const audio = (res.json as { audio?: Record<string, unknown> })?.audio;
-    expect(audio !== undefined, driver.describe('RFC 0106 §C', 'the response MUST carry the finalized `audio` asset')).toBe(true);
+    expect(audio !== undefined, req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'the response MUST carry the finalized `audio` asset')).toBe(true);
     if (audio) {
       const hasUrl = typeof audio.url === 'string' && (audio.url as string).length > 0;
       const hasB64 = typeof audio.base64 === 'string' && (audio.base64 as string).length > 0;
-      expect(hasUrl !== hasB64, driver.describe('RFC 0106 §C', 'audio MUST carry EXACTLY ONE of url/base64')).toBe(true);
+      expect(hasUrl !== hasB64, req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'audio MUST carry EXACTLY ONE of url/base64')).toBe(true);
     }
 
     const chunks = eventsOf(res.json).filter((e) => e.type === 'voice.synthesis_chunk');
-    expect(chunks.length >= 1, driver.describe('RFC 0106 §C', 'MUST emit ≥1 voice.synthesis_chunk run-event')).toBe(true);
+    expect(chunks.length >= 1, req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'MUST emit ≥1 voice.synthesis_chunk run-event')).toBe(true);
     for (const c of chunks) {
       const p = c.payload ?? {};
-      expect(typeof p.seq === 'number', driver.describe('RFC 0106 §C', 'each chunk carries a numeric seq')).toBe(true);
-      expect(typeof p.mimeType === 'string', driver.describe('RFC 0106 §C', 'each chunk carries a mimeType')).toBe(true);
+      expect(typeof p.seq === 'number', req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'each chunk carries a numeric seq')).toBe(true);
+      expect(typeof p.mimeType === 'string', req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'each chunk carries a mimeType')).toBe(true);
       // Metadata-only: bytes by reference. An inline base64 is permitted ONLY under the host cap;
       // a chunk over the RFC 0055 256 KiB inline cap MUST be a url/streamRef reference.
       if (typeof p.base64 === 'string') {
-        expect((p.base64 as string).length <= 262144, driver.describe('RFC 0106 §C (G8)', 'inline chunk base64 MUST stay under the 256 KiB cap; else url/streamRef')).toBe(true);
+        expect((p.base64 as string).length <= 262144, req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C (G8)', 'inline chunk base64 MUST stay under the 256 KiB cap; else url/streamRef')).toBe(true);
       }
     }
     expect(
       chunks.some((c) => (c.payload ?? {}).final === true),
-      driver.describe('RFC 0106 §C', 'a terminal chunk MUST carry final:true'),
+      req('openwop.it.voice-synthesis-streaming.stream-true-resolves-the-finalized-asset-and-emits-metadata-only-voice-synthesis', 'RFC 0106 §C', 'a terminal chunk MUST carry final:true'),
     ).toBe(true);
   });
 });

package/src/scenarios/voice-transcription-streaming.test.ts

@@ -23,6 +23,8 @@ import { readErrorCode } from '../lib/error-envelope.js';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const SEAM = '/v1/host/sample/ai/call-transcriber';
 
@@ -45,21 +47,21 @@ describe('voice-transcription-streaming (RFC 0106 §B)', () => {
     if (!behaviorGate('openwop-voice-transcription', advertised)) return;
 
     const res = await driver.post(SEAM, { audio: { streamRef: 'stream:conformance/mic' }, languageCode: 'en-US' });
-    if (res.status === 404) return; // seam unwired — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
     // §E: a stateless host with no live transport honestly rejects a live streamRef.
-    if (errCode(res.json) === 'transcription_unsupported') return; // soft-skip (no live transport / no test-seam arm)
+    if (errCode(res.json) === 'transcription_unsupported') return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `errCode(res.json) === \'transcription_unsupported\'` returned early (soft-skip (no live transport / no test-seam arm))'); // soft-skip (no live transport / no test-seam arm)
 
-    expect(res.status === 200, driver.describe('RFC 0106 §B', 'a produced turn MUST return 200')).toBe(true);
+    expect(res.status === 200, req('openwop.it.voice-transcription-streaming.resolves-a-settled-turn-at-voice-turn-commit-with-untrusted-transcript-events', 'RFC 0106 §B', 'a produced turn MUST return 200')).toBe(true);
 
     const finalText = (res.json as { finalText?: unknown })?.finalText;
-    expect(typeof finalText === 'string' && (finalText as string).length > 0, driver.describe('RFC 0106 §B', 'the turn MUST resolve a non-empty finalText at turn_commit')).toBe(true);
+    expect(typeof finalText === 'string' && (finalText as string).length > 0, req('openwop.it.voice-transcription-streaming.resolves-a-settled-turn-at-voice-turn-commit-with-untrusted-transcript-events', 'RFC 0106 §B', 'the turn MUST resolve a non-empty finalText at turn_commit')).toBe(true);
 
     const events = eventsOf(res.json);
     if (events.length > 0) {
       for (const ev of events.filter((e) => e.type === 'voice.transcript')) {
-        expect((ev.payload ?? {}).contentTrust === 'untrusted', driver.describe('RFC 0106 §F INV-2', 'every voice.transcript MUST carry contentTrust:"untrusted"')).toBe(true);
+        expect((ev.payload ?? {}).contentTrust === 'untrusted', req('openwop.it.voice-transcription-streaming.resolves-a-settled-turn-at-voice-turn-commit-with-untrusted-transcript-events', 'RFC 0106 §F INV-2', 'every voice.transcript MUST carry contentTrust:"untrusted"')).toBe(true);
       }
-      expect(events.some((e) => e.type === 'voice.turn_commit'), driver.describe('RFC 0106 §B', 'the turn MUST terminate with voice.turn_commit')).toBe(true);
+      expect(events.some((e) => e.type === 'voice.turn_commit'), req('openwop.it.voice-transcription-streaming.resolves-a-settled-turn-at-voice-turn-commit-with-untrusted-transcript-events', 'RFC 0106 §B', 'the turn MUST terminate with voice.turn_commit')).toBe(true);
     }
   });
 });

package/src/scenarios/voice-transcription-unadvertised.test.ts

@@ -18,6 +18,8 @@ import { readErrorCode } from '../lib/error-envelope.js';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const SEAM = '/v1/host/sample/ai/call-transcriber';
 
@@ -36,12 +38,12 @@ describe('voice-transcription-unadvertised (RFC 0106 §B)', () => {
     if (!behaviorGate('openwop-voice-transcription-unadvertised', !advertised)) return;
 
     const res = await driver.post(SEAM, { audio: { streamRef: 'stream:conformance/mic' } });
-    if (res.status === 404) return; // seam unwired — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
 
-    expect(res.status !== 200, driver.describe('RFC 0106 §B', 'an unadvertising host MUST NOT return a 200 (never a no-op)')).toBe(true);
+    expect(res.status !== 200, req('openwop.it.voice-transcription-unadvertised.a-host-not-advertising-realtimevoice-transcription-must-reject-with-transcriptio', 'RFC 0106 §B', 'an unadvertising host MUST NOT return a 200 (never a no-op)')).toBe(true);
     expect(
       errCode(res.json) === 'transcription_unsupported',
-      driver.describe('RFC 0106 §B', 'the call MUST be rejected with `transcription_unsupported`'),
+      req('openwop.it.voice-transcription-unadvertised.a-host-not-advertising-realtimevoice-transcription-must-reject-with-transcriptio', 'RFC 0106 §B', 'the call MUST be rejected with `transcription_unsupported`'),
     ).toBe(true);
   });
 });

package/src/scenarios/wasm-pack-abi-version-rejection.test.ts

@@ -28,6 +28,7 @@ import { describe, it, expect } from 'vitest';
 import { softSkip } from '../lib/soft-skip.js';
 import { driver } from '../lib/driver.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const MISBEHAVING_PACK_NAME = 'vendor.openwop.misbehaving-abi';
 const WELL_BEHAVED_PACK_NAME = 'vendor.openwop.rust-hello';
@@ -40,7 +41,7 @@ describe('wasm-pack-abi-version-rejection: host advertises supported ABI version
 
     if (!wasm?.supported) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!wasm?.supported` returned early');
 
-    expect(Array.isArray(wasm.abiVersions), driver.describe(
+    expect(Array.isArray(wasm.abiVersions), req('openwop.it.wasm-pack-abi-version-rejection.abiversions-contains-positive-integers-loader-rejects-unsupported-versions', 
       'RFCS/0008-wasm-abi.md §H',
       'capabilities.nodePackRuntimes.wasm.abiVersions MUST be an array',
     )).toBe(true);
@@ -90,7 +91,7 @@ describe('wasm-pack-abi-version-rejection: positive path via misbehaving pack',
 
     // Core assertion: ABI 999 pack MUST NOT be in loadedPacks[]
     // regardless of filesystem state. The host's loader rejected it.
-    expect(wasm.loadedPacks.includes(MISBEHAVING_PACK_NAME), driver.describe(
+    expect(wasm.loadedPacks.includes(MISBEHAVING_PACK_NAME), req('openwop.it.wasm-pack-abi-version-rejection.misbehaving-abi-pack-declares-abi-999-must-not-appear-in-loadedpacks', 
       'RFCS/0008-wasm-abi.md §H',
       `host MUST reject packs whose declared ABI is not in abiVersions[]; ${MISBEHAVING_PACK_NAME} declares 999 and MUST NOT appear in loadedPacks[]`,
     )).toBe(false);

package/src/scenarios/wasm-pack-invoke-completed.test.ts

@@ -18,6 +18,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-wasm-pack-roundtrip';
 
@@ -45,7 +46,7 @@ describe('wasm-pack-invoke-completed: round-trip output', () => {
     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.wasm-pack-invoke-completed.greet-node-returns-hello-name-and-run-reaches-completed', 
       'RFCS/0008-wasm-abi.md §D',
       "WASM 'completed' outcome MUST drive terminal 'completed' run status",
     )).toBe('completed');
@@ -61,7 +62,7 @@ describe('wasm-pack-invoke-completed: round-trip output', () => {
     const fullLog = JSON.stringify(list).toLowerCase();
     expect(
       haystack.includes('hello, openwop') || fullLog.includes('hello, openwop'),
-      driver.describe(
+      req('openwop.it.wasm-pack-invoke-completed.greet-node-returns-hello-name-and-run-reaches-completed', 
         'RFCS/0008-wasm-abi.md §D',
         "WASM completion output MUST be surfaced somewhere in the run's event log so consumers can read it",
       ),

package/src/scenarios/wasm-pack-invoke-suspended.test.ts

@@ -22,6 +22,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-wasm-pack-roundtrip';
 
@@ -60,11 +61,11 @@ describe('wasm-pack-invoke-suspended: suspend → resume round-trip', () => {
       const ok =
         haystack.includes('wasm_suspend_not_implemented') ||
         haystack.includes('suspend_not_supported');
-      expect(ok, driver.describe(
+      expect(ok, req('openwop.it.wasm-pack-invoke-suspended.host-either-suspends-the-run-or-explicitly-reports-wasm-suspend-not-implemented', 
         'RFCS/0008-wasm-abi.md §D',
         "if a host doesn't implement WASM-driven suspends it MUST surface a recognizable code",
       )).toBe(true);
-      return;
+      return softSkip('blocked', 'precondition not met — `terminal.status === \'failed\'` returned early (seam, prior step, or fixture unavailable)');
     }
 
     // Completed path: the reference pack never suspends. Asserting

package/src/scenarios/wasm-pack-load.test.ts

@@ -17,6 +17,7 @@ import { softSkip } from '../lib/soft-skip.js';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-wasm-pack-roundtrip';
 
@@ -42,11 +43,11 @@ describe('wasm-pack-load: discovery surfaces WASM runtime support', () => {
       console.warn('[wasm-pack-load] host does not advertise WASM support; skipping');
       return softSkip('inapplicable', '[wasm-pack-load] host does not advertise WASM support; skipping');
     }
-    expect(Array.isArray(wasm.abiVersions), driver.describe(
+    expect(Array.isArray(wasm.abiVersions), req('openwop.it.wasm-pack-load.a-host-claiming-wasm-support-advertises-abiversions-including-1', 
       'RFCS/0008-wasm-abi.md §H',
       'capabilities.nodePackRuntimes.wasm.abiVersions MUST be an array',
     )).toBe(true);
-    expect(wasm.abiVersions?.includes(1), driver.describe(
+    expect(wasm.abiVersions?.includes(1), req('openwop.it.wasm-pack-load.a-host-claiming-wasm-support-advertises-abiversions-including-1', 
       'RFCS/0008-wasm-abi.md §H',
       'abiVersions MUST include 1 (this RFC) when supported',
     )).toBe(true);
@@ -66,7 +67,7 @@ describe('wasm-pack-load: loaded pack typeIds are dispatchable', () => {
     // WASM-provided typeId. A host that loaded the pack accepts the
     // POST /v1/runs; one that didn't would return 400/404.
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE, inputs: { name: 'world' } });
-    expect(create.status, driver.describe(
+    expect(create.status, req('openwop.it.wasm-pack-load.host-accepts-a-workflow-whose-node-typeid-is-provided-by-a-loaded-wasm-pack', 
       'RFCS/0008-wasm-abi.md §B + node-packs.md §Reserved typeIds',
       'host MUST accept runs whose nodes reference loaded-pack typeIds',
     )).toBe(201);

package/src/scenarios/wasm-pack-memory-cap.test.ts

@@ -28,6 +28,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const CAP_BREACH_FIXTURE = 'conformance-wasm-pack-memory-cap-breach';
 
@@ -41,7 +42,7 @@ describe('wasm-pack-memory-cap: host advertises maxMemoryBytes', () => {
 
     // The cap is REQUIRED to enforce §K. Hosts MUST surface the configured
     // ceiling so clients can size their packs accordingly.
-    expect(typeof wasm.maxMemoryBytes, driver.describe(
+    expect(typeof wasm.maxMemoryBytes, req('openwop.it.wasm-pack-memory-cap.capabilities-nodepackruntimes-wasm-maxmemorybytes-is-a-plausible-number', 
       'RFCS/0008-wasm-abi.md §K',
       'capabilities.nodePackRuntimes.wasm.maxMemoryBytes MUST be advertised as a number when WASM is supported',
     )).toBe('number');
@@ -75,7 +76,7 @@ describe('wasm-pack-memory-cap: positive path via misbehaving pack', () => {
     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.wasm-pack-memory-cap.misbehaving-pack-triggers-cap-breached-with-kind-wasm-memory-and-terminal-failed', 
       'RFCS/0008-wasm-abi.md §K',
       'WASM memory-cap breach MUST drive terminal `failed` (RFC 0008 §K: "kill the instance, emit cap.breached")',
     )).toBe('failed');
@@ -83,14 +84,14 @@ describe('wasm-pack-memory-cap: positive path via misbehaving pack', () => {
     const events = await driver.get(`/v1/runs/${encodeURIComponent(runId)}/events`);
     const list = (events.json as { events?: Array<{ type: string; payload?: unknown }> }).events ?? [];
     const breachEvent = list.find((e) => e.type === 'cap.breached');
-    expect(breachEvent, driver.describe(
+    expect(breachEvent, req('openwop.it.wasm-pack-memory-cap.misbehaving-pack-triggers-cap-breached-with-kind-wasm-memory-and-terminal-failed', 
       'RFCS/0008-wasm-abi.md §K',
       'host MUST emit cap.breached when a WASM module exceeds its memory ceiling',
     )).toBeDefined();
     // Event detail rides under the canonical `payload` envelope field (per
     // run-event-payloads.schema.json + every other event scenario), not `data`.
     const breachKind = (breachEvent?.payload as { kind?: string } | undefined)?.kind;
-    expect(breachKind, driver.describe(
+    expect(breachKind, req('openwop.it.wasm-pack-memory-cap.misbehaving-pack-triggers-cap-breached-with-kind-wasm-memory-and-terminal-failed', 
       'RFCS/0008-wasm-abi.md §K',
       'cap.breached payload MUST carry kind: "wasm-memory" for memory-ceiling breaches',
     )).toBe('wasm-memory');

package/src/scenarios/wasm-pack-replay-determinism.test.ts

@@ -16,6 +16,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-wasm-pack-roundtrip';
 
@@ -53,7 +54,7 @@ describe('wasm-pack-replay-determinism: same inputs → same output', () => {
     const a = await run();
     const b = await run();
 
-    expect(a, driver.describe(
+    expect(a, req('openwop.it.wasm-pack-replay-determinism.two-independent-runs-with-same-inputs-produce-same-wasm-output', 
       'RFCS/0008-wasm-abi.md §G',
       'WASM-node output MUST be reproducible given the same inputs',
     )).not.toBeNull();

package/src/scenarios/webhook-negative.test.ts

@@ -24,6 +24,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { discoveryFamilies } from '../lib/discovery-capabilities.js';
 import { discoverOwnedTenant } from '../lib/webhook-receiver.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 async function isWebhookSupported(): Promise<boolean> {
   const disco = await driver.get('/.well-known/openwop');
@@ -36,7 +38,7 @@ describe('webhook-negative: SSRF guard rejects private destinations', () => {
     if (!(await isWebhookSupported())) {
       // eslint-disable-next-line no-console
       console.warn('[webhook-negative] host does not advertise webhook support; skipping');
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isWebhookSupported())` returned early ([webhook-negative] host does not advertise webhook support; skipping)');
     }
     // Spec-complete except for the private URL, so validation passes and the
     // request reaches the SSRF guard. `{ url }` alone 400s `validation_error`
@@ -59,9 +61,9 @@ describe('webhook-negative: SSRF guard rejects private destinations', () => {
       if (body.subscriptionId) {
         await driver.delete(`/v1/webhooks/${encodeURIComponent(body.subscriptionId)}`);
       }
-      return;
+      return softSkip('blocked', 'precondition not met — `reg.status === 201` returned early ([webhook-negative] host accepts loopback destinations; SSRF guard not enforced) (seam, prior step, or fixture unavailable)');
     }
-    expect(reg.status, driver.describe(
+    expect(reg.status, req('openwop.it.webhook-negative.host-with-ssrf-guard-returns-400-webhook-url-rejected-for-loopback', 
       'webhooks.md + review §"Webhook SSRF guard"',
       'host with SSRF guard MUST return 400 for loopback / RFC1918 / link-local destinations',
     )).toBe(400);
@@ -72,17 +74,17 @@ describe('webhook-negative: SSRF guard rejects private destinations', () => {
 
 describe('webhook-negative: validation errors', () => {
   it('malformed url returns 400 validation_error', async () => {
-    if (!(await isWebhookSupported())) return;
+    if (!(await isWebhookSupported())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isWebhookSupported())` returned early');
     const reg = await driver.post('/v1/webhooks', { url: 'not a url' });
-    expect([400, 422]).toContain(reg.status);
+    expect([400, 422], req('openwop.it.webhook-negative.malformed-url-returns-400-validation-error', 'webhooks.md', 'malformed url returns 400 validation_error')).toContain(reg.status);
     const body = reg.json as { error?: string };
     expect(['validation_error', 'webhook_url_rejected']).toContain(body.error);
   });
 
   it('missing url returns 400 validation_error', async () => {
-    if (!(await isWebhookSupported())) return;
+    if (!(await isWebhookSupported())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isWebhookSupported())` returned early');
     const reg = await driver.post('/v1/webhooks', { eventTypes: ['run.completed'] });
-    expect(reg.status).toBe(400);
+    expect(reg.status, req('openwop.it.webhook-negative.missing-url-returns-400-validation-error', 'webhooks.md', 'missing url returns 400 validation_error')).toBe(400);
     const body = reg.json as { error?: string };
     expect(body.error).toBe('validation_error');
   });
@@ -90,9 +92,9 @@ describe('webhook-negative: validation errors', () => {
 
 describe('webhook-negative: unregister of unknown subscription', () => {
   it('DELETE /v1/webhooks/{unknown} returns 404 subscription_not_found', async () => {
-    if (!(await isWebhookSupported())) return;
+    if (!(await isWebhookSupported())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isWebhookSupported())` returned early');
     const del = await driver.delete('/v1/webhooks/wh-does-not-exist');
-    expect(del.status).toBe(404);
+    expect(del.status, req('openwop.it.webhook-negative.delete-v1-webhooks-unknown-returns-404-subscription-not-found', 'webhooks.md', 'DELETE /v1/webhooks/{unknown} returns 404 subscription_not_found')).toBe(404);
     const body = del.json as { error?: string };
     expect(body.error).toBe('subscription_not_found');
   });

package/src/scenarios/webhook-receiver-adversarial.test.ts

@@ -44,6 +44,7 @@ import {
   verifyWebhookDelivery,
   SIGNATURE_PREFIX,
 } from '../lib/webhook-receiver.js';
+import { req } from '../lib/requirement-ids.js';
 
 describe('webhook-receiver-adversarial: receiver rejects five canonical attacks', () => {
   const secret = 'test-secret-do-not-use-in-prod';
@@ -65,7 +66,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
     );
     expect(
       result.accepted,
-      'webhooks.md §"Signature recipe": valid signature + fresh timestamp + correct algorithm MUST be accepted',
+      req('openwop.it.webhook-receiver-adversarial.positive-control-receiver-accepts-a-freshly-signed-valid-delivery', 'spec/v1/webhooks.md', 'webhooks.md §"Signature recipe": valid signature + fresh timestamp + correct algorithm MUST be accepted'),
     ).toBe(true);
   });
 
@@ -86,7 +87,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
     if (!result.accepted) {
       expect(
         result.reason,
-        'webhooks.md §"Signature recipe": tampered body MUST be rejected with signature_mismatch',
+        req('openwop.it.webhook-receiver-adversarial.case-1-tampered-body-signature-mismatch', 'spec/v1/webhooks.md', 'webhooks.md §"Signature recipe": tampered body MUST be rejected with signature_mismatch'),
       ).toBe('signature_mismatch');
     }
   });
@@ -113,7 +114,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
       state,
       { nowSeconds: nowSec },
     );
-    expect(result.accepted).toBe(false);
+    expect(result.accepted, req('openwop.it.webhook-receiver-adversarial.case-2-tampered-hmac-signature-mismatch', 'spec/v1/webhooks.md', 'case 2: tampered HMAC → signature_mismatch')).toBe(false);
     if (!result.accepted) {
       expect(result.reason).toBe('signature_mismatch');
     }
@@ -136,7 +137,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
     if (!result.accepted) {
       expect(
         result.reason,
-        'webhooks.md §"Replay-attack resistance": timestamp older than freshness window MUST be rejected with timestamp_expired',
+        req('openwop.it.webhook-receiver-adversarial.case-3-stale-timestamp-timestamp-expired', 'spec/v1/webhooks.md', 'webhooks.md §"Replay-attack resistance": timestamp older than freshness window MUST be rejected with timestamp_expired'),
       ).toBe('timestamp_expired');
     }
   });
@@ -170,7 +171,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
     if (!replay.accepted) {
       expect(
         replay.reason,
-        'webhooks.md §"Replay-attack resistance": replay of an already-accepted signature MUST be rejected with duplicate_signature',
+        req('openwop.it.webhook-receiver-adversarial.case-4-replayed-signature-duplicate-signature', 'spec/v1/webhooks.md', 'webhooks.md §"Replay-attack resistance": replay of an already-accepted signature MUST be rejected with duplicate_signature'),
       ).toBe('duplicate_signature');
     }
   });
@@ -191,7 +192,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
     if (!result.accepted) {
       expect(
         result.reason,
-        'webhooks.md §"Signature algorithm versioning": algorithm other than v1 MUST be rejected with wrong_algorithm by a v1-only receiver',
+        req('openwop.it.webhook-receiver-adversarial.case-5-wrong-algorithm-wrong-algorithm', 'spec/v1/webhooks.md', 'webhooks.md §"Signature algorithm versioning": algorithm other than v1 MUST be rejected with wrong_algorithm by a v1-only receiver'),
       ).toBe('wrong_algorithm');
     }
   });
@@ -208,7 +209,7 @@ describe('webhook-receiver-adversarial: receiver rejects five canonical attacks'
       state,
       { nowSeconds: nowSec },
     );
-    expect(result.accepted).toBe(false);
+    expect(result.accepted, req('openwop.it.webhook-receiver-adversarial.case-6-malformed-signature-header-malformed-signature-header', 'spec/v1/webhooks.md', 'case 6: malformed signature header → malformed_signature_header')).toBe(false);
     if (!result.accepted) {
       expect(result.reason).toBe('malformed_signature_header');
     }

package/src/scenarios/webhook-sig-algorithm.test.ts

@@ -16,6 +16,8 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { discoveryFamilies } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface DiscoveryWebhooks {
   webhooks?: {
@@ -33,7 +35,7 @@ describe('webhook-sig-algorithm: host advertises supported algorithm set', () =>
     if (!webhooks?.supported) {
       // eslint-disable-next-line no-console
       console.warn('[webhook-sig-algorithm] host does not advertise webhook support; skipping');
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!webhooks?.supported` returned early ([webhook-sig-algorithm] host does not advertise webhook support; skipping)');
     }
 
     const algos = webhooks.signatureAlgorithms;
@@ -45,10 +47,10 @@ describe('webhook-sig-algorithm: host advertises supported algorithm set', () =>
       console.warn(
         '[webhook-sig-algorithm] host does not advertise webhooks.signatureAlgorithms (pre-v1.1); skipping shape check',
       );
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!Array.isArray(algos)` returned early ([webhook-sig-algorithm] host does not advertise webhooks.signatureAlgorithms (pre-v1.1); skipping shape check)');
     }
 
-    expect(algos.includes('v1'), driver.describe(
+    expect(algos.includes('v1'), req('openwop.it.webhook-sig-algorithm.discovery-surfaces-a-webhooks-signaturealgorithms-array-including-v1', 
       'webhooks.md §"Signature algorithm versioning"',
       'webhooks.signatureAlgorithms MUST include "v1" when surfaced (canonical baseline)',
     )).toBe(true);