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

package/src/scenarios/verifier-gating.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/agents/verify-run';
 
@@ -48,26 +50,26 @@ describe('verifier-gating (RFC 0090 §B)', () => {
 
     // FAIL verdict → must NOT complete as success; agent.verified{fail} emitted.
     const failRes = await driver.post(SEAM, { simulateVerdict: 'fail' });
-    if (failRes.status === 404) return; // seam unwired — soft-skip
+    if (failRes.status === 404) return softSkip('blocked', 'precondition not met — `failRes.status === 404` returned early (seam unwired — soft-skip) (seam, prior step, or fixture unavailable)'); // seam unwired — soft-skip
     expect(
       verifiedVerdict(failRes.json) === 'fail',
-      driver.describe('RFC 0090 §A', 'a verify-run forcing a fail MUST emit agent.verified{verdict:"fail"}'),
+      req('openwop.it.verifier-gating.a-fail-verdict-blocks-commit-on-a-gating-host-a-pass-verdict-completes', 'RFC 0090 §A', 'a verify-run forcing a fail MUST emit agent.verified{verdict:"fail"}'),
     ).toBe(true);
     expect(
       !isSuccess(failRes.json),
-      driver.describe('RFC 0090 §B', 'on a gating host a fail verdict MUST block commit/terminate-as-success'),
+      req('openwop.it.verifier-gating.a-fail-verdict-blocks-commit-on-a-gating-host-a-pass-verdict-completes', 'RFC 0090 §B', 'on a gating host a fail verdict MUST block commit/terminate-as-success'),
     ).toBe(true);
 
     // PASS verdict → completes normally.
     const passRes = await driver.post(SEAM, { simulateVerdict: 'pass' });
-    if (passRes.status === 404) return;
+    if (passRes.status === 404) return softSkip('blocked', 'precondition not met — `passRes.status === 404` returned early (seam, prior step, or fixture unavailable)');
     expect(
       verifiedVerdict(passRes.json) === 'pass',
-      driver.describe('RFC 0090 §A', 'a verify-run forcing a pass MUST emit agent.verified{verdict:"pass"}'),
+      req('openwop.it.verifier-gating.a-fail-verdict-blocks-commit-on-a-gating-host-a-pass-verdict-completes', 'RFC 0090 §A', 'a verify-run forcing a pass MUST emit agent.verified{verdict:"pass"}'),
     ).toBe(true);
     expect(
       isSuccess(passRes.json),
-      driver.describe('RFC 0090 §B', 'a pass verdict MUST allow the turn to complete'),
+      req('openwop.it.verifier-gating.a-fail-verdict-blocks-commit-on-a-gating-host-a-pass-verdict-completes', 'RFC 0090 §B', 'a pass verdict MUST allow the turn to complete'),
     ).toBe(true);
   });
 });

package/src/scenarios/version-fold.test.ts

@@ -39,6 +39,7 @@ import { driver, type OpenWOPResponse } 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_ID = 'conformance-version-fold';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(FIXTURE_ID);
@@ -94,7 +95,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
     );
     expect(
       versions.length,
-      driver.describe(
+      req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
         'version-negotiation.md §Conformance via X-Force-Engine-Version',
         'forceEngineVersionRange MUST describe a non-empty integer range (min <= max)',
       ),
@@ -109,7 +110,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
       }
       expect(
         create.status,
-        driver.describe(
+        req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
           'version-negotiation.md §Conformance via X-Force-Engine-Version',
           `POST /v1/runs with X-Force-Engine-Version: ${v} (within the advertised range) MUST be accepted on a test key`,
         ),
@@ -120,7 +121,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
       const terminal = await pollUntilTerminal(runId);
       expect(
         terminal.status,
-        driver.describe(
+        req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
           'version-negotiation.md §Cross-version interop matrix',
           `the conformance-version-fold noop run MUST complete under forced engine version ${v} (fold-best-effort)`,
         ),
@@ -130,7 +131,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
       const snap = await driver.get(`/v1/runs/${encodeURIComponent(runId)}`);
       expect(
         snap.status,
-        driver.describe(
+        req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
           'version-negotiation.md §Cross-version interop matrix',
           `GET /v1/runs/{runId} MUST return a readable RunSnapshot under forced engine version ${v}`,
         ),
@@ -145,7 +146,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
       );
       expect(
         events.status,
-        driver.describe(
+        req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
           'version-negotiation.md §Conformance via X-Force-Engine-Version',
           `the event log MUST be readable via events/poll under forced engine version ${v}`,
         ),
@@ -153,7 +154,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
       const eventList = (events.json as { events?: unknown[] } | undefined)?.events ?? [];
       expect(
         eventList.length,
-        driver.describe(
+        req('openwop.it.version-fold.each-version-in-min-current-max-completes-snapshot-and-event-log-stay-readable', 
           'version-negotiation.md §Conformance via X-Force-Engine-Version',
           `events/poll MUST return a non-empty events[] for the forced-version run (v=${v})`,
         ),
@@ -178,14 +179,14 @@ describe.skipIf(SKIP_NO_FIXTURE)('version-fold: forced engine versions fold-best
     }
     expect(
       create.status,
-      driver.describe(
+      req('openwop.it.version-fold.a-forced-version-outside-the-advertised-range-is-rejected-with-400-unsupported-f', 
         'version-negotiation.md §Conformance via X-Force-Engine-Version',
         `X-Force-Engine-Version: ${outOfRange} (outside the advertised range) MUST return 400`,
       ),
     ).toBe(400);
     expect(
       errCode(create.json),
-      driver.describe(
+      req('openwop.it.version-fold.a-forced-version-outside-the-advertised-range-is-rejected-with-400-unsupported-f', 
         'version-negotiation.md §Conformance via X-Force-Engine-Version',
         'the out-of-range refusal MUST carry the canonical unsupported_force_engine_version code',
       ),

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

@@ -26,6 +26,7 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
+import { req } from '../lib/requirement-ids.js';
 
 const NOOP_WORKFLOW_ID = 'conformance-noop';
 const SKIP_NO_NOOP = !isFixtureAdvertised(NOOP_WORKFLOW_ID);
@@ -47,7 +48,7 @@ describe('version-negotiation: Capabilities advertises a protocolVersion', () =>
     expect(res.status).toBe(200);
 
     const caps = res.json as { protocolVersion?: unknown };
-    expect(typeof caps.protocolVersion, driver.describe(
+    expect(typeof caps.protocolVersion, req('openwop.it.version-negotiation.get-well-known-openwop-returns-capabilities-with-protocolversion-string', 
       'capabilities.md §3 + version-negotiation.md',
       'Capabilities.protocolVersion MUST be a non-empty string',
     )).toBe('string');
@@ -69,34 +70,34 @@ describe.skipIf(SKIP_NO_NOOP)('version-negotiation: persisted events carry the c
     expect(eventsRes.status).toBe(200);
 
     const events = (eventsRes.json as { events?: RunEvent[] } | undefined)?.events ?? [];
-    expect(events.length, 'noop run MUST emit at least one event').toBeGreaterThan(0);
+    expect(events.length, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 'run-event.schema.json §required', 'noop run MUST emit at least one event')).toBeGreaterThan(0);
 
     for (const e of events) {
-      expect(typeof e.eventId, driver.describe(
+      expect(typeof e.eventId, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'eventId MUST be a string',
       )).toBe('string');
-      expect(typeof e.runId, driver.describe(
+      expect(typeof e.runId, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'runId MUST be a string',
       )).toBe('string');
-      expect(typeof e.type, driver.describe(
+      expect(typeof e.type, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'type MUST be a string (RunEventType discriminator)',
       )).toBe('string');
-      expect(e.payload, driver.describe(
+      expect(e.payload, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'payload MUST be present (any JSON value, including null)',
       )).not.toBe(undefined);
-      expect(typeof e.timestamp, driver.describe(
+      expect(typeof e.timestamp, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'timestamp MUST be an ISO 8601 string',
       )).toBe('string');
-      expect(Number.isInteger(e.sequence), driver.describe(
+      expect(Number.isInteger(e.sequence), req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 
         'run-event.schema.json §required',
         'sequence MUST be a non-negative integer',
       )).toBe(true);
-      expect(e.sequence, 'sequence MUST be >= 0').toBeGreaterThanOrEqual(0);
+      expect(e.sequence, req('openwop.it.version-negotiation.every-event-has-the-6-required-runeventdoc-fields-per-run-event-schema-json', 'run-event.schema.json §required', 'sequence MUST be >= 0')).toBeGreaterThanOrEqual(0);
     }
   });
 
@@ -118,7 +119,7 @@ describe.skipIf(SKIP_NO_NOOP)('version-negotiation: persisted events carry the c
       const curr = sequences[i] ?? -1;
       expect(
         curr,
-        driver.describe(
+        req('openwop.it.version-negotiation.event-sequences-within-a-run-are-strictly-monotonic', 
           'run-event.schema.json §sequence + idempotency.md',
           `event[${i}].sequence (${curr}) MUST be > event[${i - 1}].sequence (${prev}) — strictly monotonic per run`,
         ),
@@ -144,7 +145,7 @@ describe.skipIf(SKIP_NO_NOOP)('version-negotiation: events/poll forward-compat t
 
     expect(
       eventsRes.status,
-      driver.describe(
+      req('openwop.it.version-negotiation.events-poll-with-lastsequence-past-current-end-returns-empty-events-iscomplete', 
         'rest-endpoints.md GET /v1/runs/{runId}/events/poll',
         'lastSequence beyond the current end MUST return 200 with empty events, not 4xx',
       ),

package/src/scenarios/voice-bargein-no-partial-leak.test.ts

@@ -21,6 +21,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/voice/barge-in';
 
@@ -40,22 +42,22 @@ describe('voice-bargein-no-partial-leak (RFC 0106 §F INV-3)', () => {
     if (!behaviorGate('openwop-voice-bargein', advertised)) return;
 
     const res = await driver.post(SEAM, {});
-    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 §F', 'the barge-in seam MUST return 200')).toBe(true);
+    expect(res.status === 200, req('openwop.it.voice-bargein-no-partial-leak.barge-in-cancels-with-no-synthesis-chunk-emitted-after-voice-cancelled', 'RFC 0106 §F', 'the barge-in seam MUST return 200')).toBe(true);
 
     const types = eventsOf(res.json).map((e) => e.type);
     const bargeIdx = types.indexOf('voice.barge_in');
     const cancelIdx = types.indexOf('voice.cancelled');
-    expect(bargeIdx >= 0, driver.describe('RFC 0106 §D', 'a barge-in MUST emit voice.barge_in')).toBe(true);
-    expect(cancelIdx >= 0, driver.describe('RFC 0106 §D', 'a barge-in that cancels work MUST emit voice.cancelled')).toBe(true);
-    expect(cancelIdx > bargeIdx, driver.describe('RFC 0106 §D', 'voice.cancelled MUST follow voice.barge_in')).toBe(true);
+    expect(bargeIdx >= 0, req('openwop.it.voice-bargein-no-partial-leak.barge-in-cancels-with-no-synthesis-chunk-emitted-after-voice-cancelled', 'RFC 0106 §D', 'a barge-in MUST emit voice.barge_in')).toBe(true);
+    expect(cancelIdx >= 0, req('openwop.it.voice-bargein-no-partial-leak.barge-in-cancels-with-no-synthesis-chunk-emitted-after-voice-cancelled', 'RFC 0106 §D', 'a barge-in that cancels work MUST emit voice.cancelled')).toBe(true);
+    expect(cancelIdx > bargeIdx, req('openwop.it.voice-bargein-no-partial-leak.barge-in-cancels-with-no-synthesis-chunk-emitted-after-voice-cancelled', 'RFC 0106 §D', 'voice.cancelled MUST follow voice.barge_in')).toBe(true);
 
     // The load-bearing INV-3 assertion: nothing partial after the cancel.
     const afterCancel = types.slice(cancelIdx + 1);
     expect(
       !afterCancel.includes('voice.synthesis_chunk'),
-      driver.describe('RFC 0106 §F INV-3', 'NO voice.synthesis_chunk (partial output) may be emitted AFTER voice.cancelled'),
+      req('openwop.it.voice-bargein-no-partial-leak.barge-in-cancels-with-no-synthesis-chunk-emitted-after-voice-cancelled', 'RFC 0106 §F INV-3', 'NO voice.synthesis_chunk (partial output) may be emitted AFTER voice.cancelled'),
     ).toBe(true);
   });
 });

package/src/scenarios/voice-event-payloads-shape.test.ts

@@ -32,8 +32,7 @@ import { join } from 'node:path';
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
 import { SCHEMAS_DIR } from '../lib/paths.js';
-
-const why = (specRef: string, requirement: string): string => `${specRef} — ${requirement}`;
+import { req } from '../lib/requirement-ids.js';
 
 function loadSchema(name: string): Record<string, any> {
   return JSON.parse(readFileSync(join(SCHEMAS_DIR, name), 'utf8')) as Record<string, any>;
@@ -63,7 +62,7 @@ describe('voice-event-payloads-shape: the voice.* run-event taxonomy (RFC 0106
   it('all seven voice.* types are in the RunEventType enum', () => {
     const enumVals: string[] = loadSchema('run-event.schema.json').$defs.RunEventType.enum;
     for (const t of VOICE_TYPES) {
-      expect(enumVals.includes(t), why('run-event.schema.json §RunEventType', `${t} MUST be a RunEventType`)).toBe(true);
+      expect(enumVals.includes(t), req('openwop.it.voice-event-payloads-shape.all-seven-voice-types-are-in-the-runeventtype-enum', 'run-event.schema.json §RunEventType', `${t} MUST be a RunEventType`)).toBe(true);
     }
   });
 
@@ -71,8 +70,8 @@ describe('voice-event-payloads-shape: the voice.* run-event taxonomy (RFC 0106
     const payloads = loadSchema('run-event-payloads.schema.json');
     const typeIndex = payloads.$defs._typeIndex.properties as Record<string, { $ref: string }>;
     for (const t of VOICE_TYPES) {
-      expect(typeIndex[t], why('run-event-payloads.schema.json §typeIndex', `${t} MUST map to a $def`)).toBeDefined();
-      expect(payloads.$defs[DEF_KEY[t]], why('run-event-payloads.schema.json', `$defs.${DEF_KEY[t]} MUST exist`)).toBeDefined();
+      expect(typeIndex[t], req('openwop.it.voice-event-payloads-shape.each-voice-type-has-a-payload-def-reachable-via-typeindex', 'run-event-payloads.schema.json §typeIndex', `${t} MUST map to a $def`)).toBeDefined();
+      expect(payloads.$defs[DEF_KEY[t]], req('openwop.it.voice-event-payloads-shape.each-voice-type-has-a-payload-def-reachable-via-typeindex', 'run-event-payloads.schema.json', `$defs.${DEF_KEY[t]} MUST exist`)).toBeDefined();
     }
   });
 
@@ -84,15 +83,15 @@ describe('voice-event-payloads-shape: the voice.* run-event taxonomy (RFC 0106
 
     expect(
       validate({ text: 'book a table', isFinal: true, atMs: 1200, contentTrust: 'untrusted' }),
-      why('RFC 0106 §F INV-2', 'a transcript marked untrusted MUST validate'),
+      req('openwop.it.voice-event-payloads-shape.voice-transcript-requires-contenttrust-untrusted-security-voice-transcript-untru', 'RFC 0106 §F INV-2', 'a transcript marked untrusted MUST validate'),
     ).toBe(true);
     expect(
       validate({ text: 'book a table', isFinal: true, atMs: 1200 }),
-      why('RFC 0106 §F INV-2 (voice-transcript-untrusted)', 'a transcript WITHOUT contentTrust MUST be rejected'),
+      req('openwop.it.voice-event-payloads-shape.voice-transcript-requires-contenttrust-untrusted-security-voice-transcript-untru', 'RFC 0106 §F INV-2 (voice-transcript-untrusted)', 'a transcript WITHOUT contentTrust MUST be rejected'),
     ).toBe(false);
     expect(
       validate({ text: 'book a table', isFinal: true, atMs: 1200, contentTrust: 'trusted' }),
-      why('RFC 0106 §F INV-2 (voice-transcript-untrusted)', 'contentTrust MUST be the const "untrusted" — never promoted'),
+      req('openwop.it.voice-event-payloads-shape.voice-transcript-requires-contenttrust-untrusted-security-voice-transcript-untru', 'RFC 0106 §F INV-2 (voice-transcript-untrusted)', 'contentTrust MUST be the const "untrusted" — never promoted'),
     ).toBe(false);
   });
 
@@ -104,11 +103,11 @@ describe('voice-event-payloads-shape: the voice.* run-event taxonomy (RFC 0106
 
     expect(
       validate({ seq: 0, mimeType: 'audio/mpeg', durationMs: 240, url: 'https://host/seg/0', final: false }),
-      why('RFC 0106 §C', 'a metadata chunk referencing bytes by url MUST validate'),
+      req('openwop.it.voice-event-payloads-shape.voice-synthesis-chunk-is-metadata-shaped-seq-mimetype-required-bytes-by-referenc', 'RFC 0106 §C', 'a metadata chunk referencing bytes by url MUST validate'),
     ).toBe(true);
     expect(
       validate({ mimeType: 'audio/mpeg' }),
-      why('RFC 0106 §C', 'a chunk without seq MUST be rejected'),
+      req('openwop.it.voice-event-payloads-shape.voice-synthesis-chunk-is-metadata-shaped-seq-mimetype-required-bytes-by-referenc', 'RFC 0106 §C', 'a chunk without seq MUST be rejected'),
     ).toBe(false);
   });
 
@@ -120,7 +119,7 @@ describe('voice-event-payloads-shape: the voice.* run-event taxonomy (RFC 0106
       const validate = ajv.compile(payloads.$defs[key]);
       expect(
         validate({ atMs: 100, transcriptBody: 'should not be here' }),
-        why('RFC 0106 §D', `${key} MUST reject an unknown (content-bearing) property`),
+        req('openwop.it.voice-event-payloads-shape.content-free-voice-events-reject-unknown-properties-additionalproperties-false', 'RFC 0106 §D', `${key} MUST reject an unknown (content-bearing) property`),
       ).toBe(false);
     }
   });

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