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

package/src/scenarios/multi-agent-confidence-escalation.test.ts

@@ -52,6 +52,7 @@ import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { pollUntil } from '../lib/polling.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const FIXTURE = 'conformance-multi-agent-confidence-escalation';
@@ -92,7 +93,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-confidence-escalation: capability shape
     if (floor === undefined) return softSkip('blocked', 'precondition not met — `floor === undefined` returned early (seam, prior step, or fixture unavailable)');
     expect(
       typeof floor === 'number' && Number.isFinite(floor) && floor >= 0.5 && floor <= 1.0,
-      driver.describe(
+      req('openwop.it.multi-agent-confidence-escalation.confidenceescalationfloor-when-advertised-must-be-in-0-5-1-0', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A',
         'confidenceEscalationFloor MUST be number in [0.5, 1.0]; values below the spec floor are non-conformant',
       ),
@@ -140,7 +141,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
       const expectedStatus = advertisedKind === 'clarification' ? 'waiting-clarification' : 'waiting-approval';
       expect(
         terminal.status,
-        driver.describe(
+        req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
           'RFCS/0044-confidence-escalation-interrupt-kind-advertisement.md §B',
           `host advertising confidenceEscalationInterruptKind: "${advertisedKind}" MUST surface the run as "${expectedStatus}" per spec/v1/interrupt.md §"Interrupt kinds"`,
         ),
@@ -149,7 +150,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
       const status = terminal.status as string;
       expect(
         typeof status === 'string' && status.startsWith('waiting-'),
-        driver.describe(
+        req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
           'RFCS/0044-confidence-escalation-interrupt-kind-advertisement.md §B',
           `host advertising vendor confidenceEscalationInterruptKind ("${advertisedKind}") MUST surface the run as a waiting-* status; the suffix is determined by the host's interrupt.md mapping (see the host's vendor-extensions doc per RFC 0044 §C)`,
         ),
@@ -159,7 +160,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
       const acceptedStatuses = ['waiting-clarification', 'waiting-approval'];
       expect(
         acceptedStatuses.includes(terminal.status as string),
-        driver.describe(
+        req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
           'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A + spec/v1/interrupt.md',
           'a host below the confidence floor MUST surface the run as `waiting-clarification` (clarify-kind escalation) OR `waiting-approval` (escalate-kind escalation) per RFC 0039 §A; the low-confidence decision MUST NOT reach `completed` because no dispatch fired',
         ),
@@ -171,21 +172,21 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
     const events = ((eventsRes.json as { events?: RunEvent[] } | undefined)?.events ?? []);
 
     const escalated = events.filter((e) => e.type === 'core.workflowChain.confidence-escalated');
-    expect(escalated.length, driver.describe(
+    expect(escalated.length, req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
       'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A',
       'low-confidence decision MUST emit exactly one core.workflowChain.confidence-escalated event',
     )).toBe(1);
 
     const ev = escalated[0]!;
     const payload = (ev.payload ?? {}) as { confidence?: number; floor?: number; escalationKind?: string; workerId?: string };
-    expect(payload.confidence, 'payload.confidence echoes the decision').toBe(0.3);
+    expect(payload.confidence, req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A', 'payload.confidence echoes the decision')).toBe(0.3);
     expect(
       typeof payload.floor === 'number' && payload.floor >= 0.5 && payload.floor <= 1.0,
-      'payload.floor is the host-advertised floor (in [0.5, 1.0])',
+      req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A', 'payload.floor is the host-advertised floor (in [0.5, 1.0])'),
     ).toBe(true);
     expect(
       payload.escalationKind === 'clarify' || payload.escalationKind === 'escalate',
-      'payload.escalationKind ∈ {clarify, escalate}',
+      req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A', 'payload.escalationKind ∈ {clarify, escalate}'),
     ).toBe(true);
 
     // Causation (S32, 2026-08-17): this leg used to REQUIRE `causationId` → a
@@ -202,7 +203,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
       const cause = events.find((e) => e.eventId === ev.causationId);
       expect(
         cause !== undefined,
-        driver.describe(
+        req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
           'spec/v1/multi-agent-execution.md §"Confidence escalation"',
           `confidence-escalated causationId (${ev.causationId}) MUST resolve to an event on this run's log when present`,
         ),
@@ -211,14 +212,14 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
     const original = (ev.payload as { originalDecision?: unknown } | undefined)?.originalDecision;
     expect(
       original !== null && typeof original === 'object',
-      driver.describe('run-event-payloads.schema.json §confidence-escalated', 'payload.originalDecision carries the escalated OrchestratorDecision verbatim — the decision is on the log HERE, not on a prior decided event'),
+      req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 'run-event-payloads.schema.json §confidence-escalated', 'payload.originalDecision carries the escalated OrchestratorDecision verbatim — the decision is on the log HERE, not on a prior decided event'),
     ).toBe(true);
 
     // Load-bearing: NO dispatch event fired. RFC 0039 gates BEFORE the loop.
     const chainEvents = events.filter((e) => e.type === 'core.workflowChain.event');
     expect(
       chainEvents.length,
-      driver.describe(
+      req('openwop.it.multi-agent-confidence-escalation.happy-path-low-confidence-decision-confidence-escalated-event-clarification-inte', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §A',
         'low-confidence decision MUST NOT produce any core.workflowChain.event records — the escalation fires before any dispatch.began per the spec ordering',
       ),

package/src/scenarios/multi-agent-handoff-state-machine.test.ts

@@ -37,6 +37,7 @@ import { executionModelVersionMax } from '../lib/execution-model-version.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -69,14 +70,14 @@ describe.skipIf(HTTP_SKIP)('multi-agent-handoff-state-machine: advertisement sha
     if (executionModel === undefined) return softSkip('inapplicable', 'host doesn\'t advertise — soft-skip');
     expect(
       typeof executionModel.supported,
-      driver.describe(
+      req('openwop.it.multi-agent-handoff-state-machine.capabilities-multiagent-executionmodel-when-present-conforms-to-rfc-0037-c', 
         'RFCS/0037-multi-agent-execution-model.md §C',
         'capabilities.multiAgent.executionModel.supported MUST be boolean when present',
       ),
     ).toBe('boolean');
     expect(
       typeof executionModel.version,
-      driver.describe(
+      req('openwop.it.multi-agent-handoff-state-machine.capabilities-multiagent-executionmodel-when-present-conforms-to-rfc-0037-c', 
         'RFCS/0037-multi-agent-execution-model.md §C',
         'capabilities.multiAgent.executionModel.version MUST be integer when present',
       ),
@@ -87,7 +88,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-handoff-state-machine: advertisement sha
     const max = executionModelVersionMax();
     expect(
       Number.isInteger(v) && v >= 1 && v <= max,
-      driver.describe(
+      req('openwop.it.multi-agent-handoff-state-machine.capabilities-multiagent-executionmodel-when-present-conforms-to-rfc-0037-c', 
         'RFCS/0037-multi-agent-execution-model.md §C',
         `version MUST be an integer in [1, ${max}] (1 = Phase 1 only; later phases lift the ceiling additively — 5 = RFC 0061 stateful agent-loop lifecycle, 6 = RFC 0090 verifier; the ceiling is \`capabilities.schema.json\` §multiAgent.executionModel.version maximum)`,
       ),
@@ -118,7 +119,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral
     const runId = (create.json as { runId: string }).runId;
 
     const terminal = await pollUntilTerminal(runId);
-    expect(terminal.status, driver.describe(
+    expect(terminal.status, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
       'spec/v1/multi-agent-execution.md §"Execution loop"',
       'parent run with supervisor → next-worker → terminate MUST reach terminal `completed`',
     )).toBe('completed');
@@ -128,13 +129,13 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral
     const events = ((eventsRes.json as { events?: RunEvent[] } | undefined)?.events ?? []);
     const chainEvents = events.filter((e) => e.type === 'core.workflowChain.event');
 
-    expect(chainEvents.length, driver.describe(
+    expect(chainEvents.length, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
       'RFCS/0037-multi-agent-execution-model.md §"Conformance"',
       'happy-path fixture MUST produce 4 core.workflowChain.event records (dispatch.began, dispatch.succeeded, child.completed, output.harvested)',
     )).toBe(4);
 
     const phases = chainEvents.map((e) => (e.payload as { phase?: string } | undefined)?.phase);
-    expect(phases, driver.describe(
+    expect(phases, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
       'spec/v1/multi-agent-execution.md §"Transition events"',
       'phase order MUST be dispatch.began → dispatch.succeeded → child.completed → output.harvested',
     )).toEqual(['dispatch.began', 'dispatch.succeeded', 'child.completed', 'output.harvested']);
@@ -144,7 +145,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral
     for (let i = 1; i < chainEvents.length; i++) {
       const prior = chainEvents[i - 1];
       const cur = chainEvents[i];
-      expect(cur?.causationId, driver.describe(
+      expect(cur?.causationId, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
         'spec/v1/multi-agent-execution.md §"Transition events"',
         `core.workflowChain.event #${i} (${phases[i]}) MUST have causationId === prior event's eventId`,
       )).toBe(prior?.eventId);
@@ -154,14 +155,14 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral
     const dispatchBegan = chainEvents[0];
     expect(dispatchBegan?.causationId).toBeDefined();
     const decidedEvent = events.find((e) => e.eventId === dispatchBegan?.causationId);
-    expect(decidedEvent?.type, driver.describe(
+    expect(decidedEvent?.type, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
       'spec/v1/multi-agent-execution.md §"Transition events"',
       'dispatch.began causationId MUST point at the runOrchestrator.decided event that named this worker',
     )).toBe('runOrchestrator.decided');
 
     // output.harvested.harvestedKeys MUST list the outputMapping keys harvested.
     const harvested = chainEvents[3]?.payload as { harvestedKeys?: string[] } | undefined;
-    expect(harvested?.harvestedKeys, driver.describe(
+    expect(harvested?.harvestedKeys, req('openwop.it.multi-agent-handoff-state-machine.happy-path-dispatch-began-dispatch-succeeded-child-completed-output-harvested-fi', 
       'spec/v1/multi-agent-execution.md §"Transition events"',
       'output.harvested payload MUST list harvested parent-variable keys (the fixture\'s outputMapping is { parentResult: \'childOutcome\' })',
     )).toEqual(['parentResult']);

package/src/scenarios/multi-agent-memory-lifecycle.test.ts

@@ -50,6 +50,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 HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -82,17 +83,17 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: advertisement shape (R
     if (d === null) {
       softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
     }
     const ccmc = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.crossChildMemoryConcurrency;
     if (ccmc === undefined) {
       softSkip('inapplicable', 'optional advertisement — `multiAgent.executionModel.crossChildMemoryConcurrency` not advertised by this host');
       ctx.skip(); // optional advertisement — host hasn't opted in
-      return;
+      return softSkip('blocked', 'precondition not met — `ccmc === undefined` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(
       ccmc === 'strict' || ccmc === 'advisory',
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.crosschildmemoryconcurrency-when-advertised-must-be-one-of-strict-advisory', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B',
         'crossChildMemoryConcurrency MUST be one of {strict, advisory} when present; values outside the closed enum are non-conformant',
       ),
@@ -138,7 +139,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
     if (d === null) {
       softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
     }
     const v = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.version;
     const memorySupported = capabilityFamily<{ supported?: unknown }>(d, 'memory')?.supported;
@@ -147,7 +148,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
     if (!phase2OrLater || memorySupported !== true || !expiredRunId) {
       softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!phase2OrLater || memorySupported !== true || !expiredRunId` returned early');
       ctx.skip();
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!phase2OrLater || memorySupported !== true || !expiredRunId` returned early');
     }
 
     const fromSeq = 0;
@@ -158,7 +159,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
 
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.mae-3-replay-snapshot-refusal-fork-mode-replay-against-a-past-retention-runid-mu', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B MAE-3',
         'fork mode:replay against a past-retention runId MUST refuse with 422; silent substitution of current memory is non-conformant',
       ),
@@ -171,7 +172,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
 
     expect(
       body?.error,
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.mae-3-replay-snapshot-refusal-fork-mode-replay-against-a-past-retention-runid-mu', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B MAE-3',
         'refusal envelope error code MUST be "replay_memory_snapshot_unavailable" (distinct from the pre-flight invalid_from_seq gate)',
       ),
@@ -179,7 +180,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
 
     expect(
       body?.details?.fromSeq,
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.mae-3-replay-snapshot-refusal-fork-mode-replay-against-a-past-retention-runid-mu', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B MAE-3',
         'refusal envelope details.fromSeq MUST echo the requested fromSeq',
       ),
@@ -187,7 +188,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
 
     expect(
       body?.details?.sourceRunId,
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.mae-3-replay-snapshot-refusal-fork-mode-replay-against-a-past-retention-runid-mu', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B MAE-3',
         'refusal envelope details.sourceRunId MUST echo the runId from the URL',
       ),
@@ -196,7 +197,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
     const reason = body?.details?.reason;
     expect(
       reason === 'retention_expired' || reason === 'event_log_unavailable',
-      driver.describe(
+      req('openwop.it.multi-agent-memory-lifecycle.mae-3-replay-snapshot-refusal-fork-mode-replay-against-a-past-retention-runid-mu', 
         'RFCS/0039-multi-agent-confidence-and-memory-lifecycle.md §B MAE-3',
         'refusal envelope details.reason MUST be one of {"retention_expired", "event_log_unavailable"}',
       ),

package/src/scenarios/multi-node-ordering.test.ts

@@ -14,6 +14,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 WORKFLOW_ID = 'conformance-multi-node';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -33,7 +34,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('multi-node: conformance-multi-node fixture emi
     const runId = (create.json as { runId: string }).runId;
 
     const terminal = await pollUntilTerminal(runId);
-    expect(terminal.status, driver.describe(
+    expect(terminal.status, req('openwop.it.multi-node-ordering.a-b-c-node-completed-events-arrive-in-dag-order-by-sequence', 
       'fixtures.md conformance-multi-node §Terminal status',
       'fixture MUST reach terminal `completed`',
     )).toBe('completed');
@@ -41,7 +42,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('multi-node: conformance-multi-node fixture emi
     const eventsRes = await driver.get(
       `/v1/runs/${encodeURIComponent(runId)}/events/poll?lastSequence=0&timeout=1`,
     );
-    expect(eventsRes.status, driver.describe(
+    expect(eventsRes.status, req('openwop.it.multi-node-ordering.a-b-c-node-completed-events-arrive-in-dag-order-by-sequence', 
       'rest-endpoints.md GET /v1/runs/{runId}/events/poll',
       'event-poll MUST return 200 for known runs',
     )).toBe(200);
@@ -52,7 +53,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('multi-node: conformance-multi-node fixture emi
       .sort((x, y) => x.sequence - y.sequence)
       .map((e) => e.nodeId);
 
-    expect(nodeCompletions, driver.describe(
+    expect(nodeCompletions, req('openwop.it.multi-node-ordering.a-b-c-node-completed-events-arrive-in-dag-order-by-sequence', 
       'fixtures.md conformance-multi-node §Topology',
       'all three node.completed events (a, b, c) MUST be present',
     )).toEqual(['a', 'b', 'c']);

package/src/scenarios/multi-party-conversation-behavioral.test.ts

@@ -39,7 +39,6 @@
 
 import { describe, it, expect } from 'vitest';
 import { seamAbsent } from '../lib/soft-skip.js';
-import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { isMultiPartyConversationSupported } from '../lib/multi-agent-capabilities.js';
 import {
@@ -50,6 +49,7 @@ import {
   type SeamAgentRef,
   type SeamTurn,
 } from '../lib/multiPartyConversation.js';
+import { req } from '../lib/requirement-ids.js';
 
 const PROFILE = 'openwop-multi-party-conversation';
 
@@ -84,7 +84,7 @@ describe('multi-party-conversation-behavioral (RFC 0101 §Conformance)', () => {
     if (opened.unwired) return seamAbsent('host advertises multiPartyConversation but the open-conversation seam is not wired');
     expect(
       opened.status === 200,
-      driver.describe('RFC 0101 §Spec', 'a conforming 3-agent council MUST open (≤ maxParticipants)'),
+      req('openwop.it.multi-party-conversation-behavioral.opens-a-council-accepts-an-attributed-turn-and-rejects-missing-non-participant-o', 'RFC 0101 §Spec', 'a conforming 3-agent council MUST open (≤ maxParticipants)'),
     ).toBe(true);
 
     // ---- MUST 1: POSITIVE — a roster-valid attributed turn is accepted ----
@@ -92,7 +92,7 @@ describe('multi-party-conversation-behavioral (RFC 0101 §Conformance)', () => {
     if (ok.unwired) return seamAbsent('host advertises multiPartyConversation but the conversation seam is not wired');
     expect(
       ok.status === 200,
-      driver.describe('RFC 0101 §Spec', "a role:'agent' turn with an in-roster speakerId MUST be accepted"),
+      req('openwop.it.multi-party-conversation-behavioral.opens-a-council-accepts-an-attributed-turn-and-rejects-missing-non-participant-o', 'RFC 0101 §Spec', "a role:'agent' turn with an in-roster speakerId MUST be accepted"),
     ).toBe(true);
 
     // ---- MUST 2: ATTRIBUTION — agent turn missing speakerId is rejected ---
@@ -102,7 +102,7 @@ describe('multi-party-conversation-behavioral (RFC 0101 §Conformance)', () => {
     if (!missingRes.unwired) {
       expect(
         isValidationErrorRejection(missingRes),
-        driver.describe('RFC 0101 §Spec (attribution MUST)', "a role:'agent' turn missing speakerId MUST be rejected with validation_error"),
+        req('openwop.it.multi-party-conversation-behavioral.opens-a-council-accepts-an-attributed-turn-and-rejects-missing-non-participant-o', 'RFC 0101 §Spec (attribution MUST)', "a role:'agent' turn missing speakerId MUST be rejected with validation_error"),
       ).toBe(true);
     }
 
@@ -112,7 +112,7 @@ describe('multi-party-conversation-behavioral (RFC 0101 §Conformance)', () => {
     if (!intruderRes.unwired) {
       expect(
         isValidationErrorRejection(intruderRes),
-        driver.describe('RFC 0101 §Spec (membership MUST) / RFC 0005 §E', 'a turn whose speakerId is not in the roster MUST be rejected with validation_error'),
+        req('openwop.it.multi-party-conversation-behavioral.opens-a-council-accepts-an-attributed-turn-and-rejects-missing-non-participant-o', 'RFC 0101 §Spec (membership MUST) / RFC 0005 §E', 'a turn whose speakerId is not in the roster MUST be rejected with validation_error'),
       ).toBe(true);
     }
 
@@ -130,7 +130,7 @@ describe('multi-party-conversation-behavioral (RFC 0101 §Conformance)', () => {
       if (!overRes.unwired) {
         expect(
           isValidationErrorRejection(overRes),
-          driver.describe('RFC 0101 §Spec (maxParticipants MUST)', 'an open whose roster exceeds the advertised maxParticipants MUST be rejected with validation_error'),
+          req('openwop.it.multi-party-conversation-behavioral.opens-a-council-accepts-an-attributed-turn-and-rejects-missing-non-participant-o', 'RFC 0101 §Spec (maxParticipants MUST)', 'an open whose roster exceeds the advertised maxParticipants MUST be rejected with validation_error'),
         ).toBe(true);
       }
     }

package/src/scenarios/multi-party-conversation-shape.test.ts

@@ -44,9 +44,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';
-
-/** Server-free assertion-message helper. */
-const why = (specRef: string, requirement: string): string => `${specRef} — ${requirement}`;
+import { req } from '../lib/requirement-ids.js';
 
 function loadSchema(name: string): Record<string, unknown> {
   return JSON.parse(readFileSync(join(SCHEMAS_DIR, name), 'utf8')) as Record<string, unknown>;
@@ -59,7 +57,7 @@ describe('multi-party-conversation-shape: participant roster on conversation.ope
   const opened = ajv.getSchema('conversation-event#/$defs/ConversationOpenedPayload');
 
   it('the ConversationOpenedPayload $def exists and declares participants: AgentRef[]', () => {
-    expect(opened, 'the ConversationOpenedPayload $def MUST exist').toBeTruthy();
+    expect(opened, req('openwop.it.multi-party-conversation-shape.the-conversationopenedpayload-def-exists-and-declares-participants-agentref', 'RFC 0101', 'the ConversationOpenedPayload $def MUST exist')).toBeTruthy();
   });
 
   it('a conforming 3-agent council transcript (participant roster + user opening turn) validates', () => {
@@ -80,7 +78,7 @@ describe('multi-party-conversation-shape: participant roster on conversation.ope
         turnIndex: 0,
       },
     };
-    expect(opened!(good), why('RFC 0101 §Schema', 'a conversation.opened with a participant roster MUST validate')).toBe(true);
+    expect(opened!(good), req('openwop.it.multi-party-conversation-shape.a-conforming-3-agent-council-transcript-participant-roster-user-opening-turn-val', 'RFC 0101 §Schema', 'a conversation.opened with a participant roster MUST validate')).toBe(true);
   });
 
   it('a participant entry that is not a valid AgentRef (no agentId) is rejected', () => {
@@ -96,7 +94,7 @@ describe('multi-party-conversation-shape: participant roster on conversation.ope
         turnIndex: 0,
       },
     };
-    expect(opened!(bad), why('RFC 0101 §Schema', 'a participants[] item without agentId MUST be rejected')).toBe(false);
+    expect(opened!(bad), req('openwop.it.multi-party-conversation-shape.a-participant-entry-that-is-not-a-valid-agentref-no-agentid-is-rejected', 'RFC 0101 §Schema', 'a participants[] item without agentId MUST be rejected')).toBe(false);
   });
 
   it('participants is OPTIONAL — a single-agent conversation.opened (no roster) still validates (back-compat)', () => {
@@ -112,7 +110,7 @@ describe('multi-party-conversation-shape: participant roster on conversation.ope
         turnIndex: 0,
       },
     };
-    expect(opened!(noRoster), why('RFC 0101 §Compatibility', 'participants is additive — a roster-less conversation MUST still validate')).toBe(true);
+    expect(opened!(noRoster), req('openwop.it.multi-party-conversation-shape.participants-is-optional-a-single-agent-conversation-opened-no-roster-still-vali', 'RFC 0101 §Compatibility', 'participants is additive — a roster-less conversation MUST still validate')).toBe(true);
   });
 });
 
@@ -133,25 +131,25 @@ describe('multi-party-conversation-shape: per-turn speaker attribution (RFC 0101
   it('an agent turn WITH a roster-instance speakerId validates', () => {
     expect(
       turn({ ...agentBase, speakerId: 'host:advisor-cfo' }),
-      why('RFC 0101 §Schema', "a role:'agent' turn carrying speakerId MUST validate"),
+      req('openwop.it.multi-party-conversation-shape.an-agent-turn-with-a-roster-instance-speakerid-validates', 'RFC 0101 §Schema', "a role:'agent' turn carrying speakerId MUST validate"),
     ).toBe(true);
   });
 
   it("a role:'agent' turn MISSING speakerId MUST fail schema validation (the attribution MUST)", () => {
     expect(
       turn(agentBase),
-      why('RFC 0101 §Schema', "a role:'agent' turn that omits speakerId MUST be rejected (the conditional required)"),
+      req('openwop.it.multi-party-conversation-shape.a-role-agent-turn-missing-speakerid-must-fail-schema-validation-the-attribution', 'RFC 0101 §Schema', "a role:'agent' turn that omits speakerId MUST be rejected (the conditional required)"),
     ).toBe(false);
   });
 
   it("speakerId is OPTIONAL for role:'user' / role:'system' turns (additive — pre-RFC-0101 producers)", () => {
     expect(
       turn({ messageId: 'council-q1:0:user', from: 'user', content: 'Q3 or Q4?', ts: 1, role: 'user', turnIndex: 0 }),
-      why('RFC 0101 §Compatibility', "a role:'user' turn without speakerId MUST still validate"),
+      req('openwop.it.multi-party-conversation-shape.speakerid-is-optional-for-role-user-role-system-turns-additive-pre-rfc-0101-prod', 'RFC 0101 §Compatibility', "a role:'user' turn without speakerId MUST still validate"),
     ).toBe(true);
     expect(
       turn({ messageId: 'council-q1:9:system', from: 'system', content: 'conversation timed out', ts: 1, role: 'system', turnIndex: 9 }),
-      why('RFC 0101 §Compatibility', "a role:'system' turn without speakerId MUST still validate"),
+      req('openwop.it.multi-party-conversation-shape.speakerid-is-optional-for-role-user-role-system-turns-additive-pre-rfc-0101-prod', 'RFC 0101 §Compatibility', "a role:'system' turn without speakerId MUST still validate"),
     ).toBe(true);
   });
 });
@@ -166,13 +164,13 @@ describe('multi-party-conversation-shape: non-participant turn detection (RFC 01
   const roster = new Set(['host:advisor-cfo', 'host:advisor-cmo', 'host:advisor-cto']);
 
   it('a turn whose speakerId IS a participant is admissible', () => {
-    expect(roster.has('host:advisor-cmo'), why('RFC 0101 §Spec', 'an agent in the roster MAY speak')).toBe(true);
+    expect(roster.has('host:advisor-cmo'), req('openwop.it.multi-party-conversation-shape.a-turn-whose-speakerid-is-a-participant-is-admissible', 'RFC 0101 §Spec', 'an agent in the roster MAY speak')).toBe(true);
   });
 
   it('a turn whose speakerId is NOT a participant MUST be rejected by the host (roster membership)', () => {
     expect(
       roster.has('host:advisor-intruder'),
-      why('RFC 0101 §Spec', 'a turn from a non-participant agent MUST be rejected'),
+      req('openwop.it.multi-party-conversation-shape.a-turn-whose-speakerid-is-not-a-participant-must-be-rejected-by-the-host-roster', 'RFC 0101 §Spec', 'a turn from a non-participant agent MUST be rejected'),
     ).toBe(false);
   });
 });
@@ -184,11 +182,11 @@ describe('multi-party-conversation-shape: capability advertisement (RFC 0101 §S
     const mpc = props.multiPartyConversation as
       | { properties?: Record<string, unknown>; required?: string[]; additionalProperties?: boolean }
       | undefined;
-    expect(mpc, why('RFC 0101 §Schema', 'capabilities.multiPartyConversation MUST be declared')).toBeDefined();
-    expect(mpc?.properties?.supported, why('RFC 0101 §Schema', 'multiPartyConversation.supported MUST be declared')).toBeDefined();
-    expect(mpc?.properties?.maxParticipants, why('RFC 0101 §Schema', 'multiPartyConversation.maxParticipants MUST be declared (optional)')).toBeDefined();
-    expect(mpc?.required, why('RFC 0101 §Schema', 'supported MUST be required on the block')).toContain('supported');
-    expect(mpc?.additionalProperties, why('RFC 0101 §Schema', 'the multiPartyConversation block MUST be closed')).toBe(false);
+    expect(mpc, req('openwop.it.multi-party-conversation-shape.capabilities-schema-json-declares-multipartyconversation-with-supported-optional', 'RFC 0101 §Schema', 'capabilities.multiPartyConversation MUST be declared')).toBeDefined();
+    expect(mpc?.properties?.supported, req('openwop.it.multi-party-conversation-shape.capabilities-schema-json-declares-multipartyconversation-with-supported-optional', 'RFC 0101 §Schema', 'multiPartyConversation.supported MUST be declared')).toBeDefined();
+    expect(mpc?.properties?.maxParticipants, req('openwop.it.multi-party-conversation-shape.capabilities-schema-json-declares-multipartyconversation-with-supported-optional', 'RFC 0101 §Schema', 'multiPartyConversation.maxParticipants MUST be declared (optional)')).toBeDefined();
+    expect(mpc?.required, req('openwop.it.multi-party-conversation-shape.capabilities-schema-json-declares-multipartyconversation-with-supported-optional', 'RFC 0101 §Schema', 'supported MUST be required on the block')).toContain('supported');
+    expect(mpc?.additionalProperties, req('openwop.it.multi-party-conversation-shape.capabilities-schema-json-declares-multipartyconversation-with-supported-optional', 'RFC 0101 §Schema', 'the multiPartyConversation block MUST be closed')).toBe(false);
   });
 
   it('the multiPartyConversation block validates a conforming advertisement and rejects extras', () => {
@@ -197,10 +195,10 @@ describe('multi-party-conversation-shape: capability advertisement (RFC 0101 §S
     const ajv = new Ajv2020({ strict: false, allErrors: true });
     addFormats(ajv);
     const validate = ajv.compile(mpc);
-    expect(validate({ supported: true, maxParticipants: 8 }), why('RFC 0101 §Schema', 'a conforming advertisement MUST validate')).toBe(true);
-    expect(validate({ supported: true }), why('RFC 0101 §Schema', 'maxParticipants is optional')).toBe(true);
-    expect(validate({ maxParticipants: 8 }), why('RFC 0101 §Schema', 'supported is required')).toBe(false);
-    expect(validate({ supported: true, unexpected: 1 }), why('RFC 0101 §Schema', 'an extra key MUST be rejected (closed block)')).toBe(false);
-    expect(validate({ supported: true, maxParticipants: 1 }), why('RFC 0101 §Schema', 'maxParticipants minimum is 2 (a council has ≥2)')).toBe(false);
+    expect(validate({ supported: true, maxParticipants: 8 }), req('openwop.it.multi-party-conversation-shape.the-multipartyconversation-block-validates-a-conforming-advertisement-and-reject', 'RFC 0101 §Schema', 'a conforming advertisement MUST validate')).toBe(true);
+    expect(validate({ supported: true }), req('openwop.it.multi-party-conversation-shape.the-multipartyconversation-block-validates-a-conforming-advertisement-and-reject', 'RFC 0101 §Schema', 'maxParticipants is optional')).toBe(true);
+    expect(validate({ maxParticipants: 8 }), req('openwop.it.multi-party-conversation-shape.the-multipartyconversation-block-validates-a-conforming-advertisement-and-reject', 'RFC 0101 §Schema', 'supported is required')).toBe(false);
+    expect(validate({ supported: true, unexpected: 1 }), req('openwop.it.multi-party-conversation-shape.the-multipartyconversation-block-validates-a-conforming-advertisement-and-reject', 'RFC 0101 §Schema', 'an extra key MUST be rejected (closed block)')).toBe(false);
+    expect(validate({ supported: true, maxParticipants: 1 }), req('openwop.it.multi-party-conversation-shape.the-multipartyconversation-block-validates-a-conforming-advertisement-and-reject', 'RFC 0101 §Schema', 'maxParticipants minimum is 2 (a council has ≥2)')).toBe(false);
   });
 });

package/src/scenarios/multi-region-idempotency-behavior.test.ts

@@ -34,6 +34,7 @@ import { describe, it, expect } from 'vitest';
 import { softSkip, seamAbsent } from '../lib/soft-skip.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
 import { driver } from '../lib/driver.js';
+import { req } from '../lib/requirement-ids.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -81,18 +82,18 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (probe.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip(); // host doesn't expose the simulator seam
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(
       probe.status,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.two-region-conflict-resolves-to-the-lex-min-runid-per-annex-convergence-rule', 
         'idempotency.md §"Multi-region idempotency annex"',
         'simulate-partition seam MUST return 200 when ≥2 conflicting claims are submitted',
       ),
     ).toBe(200);
     expect(
       probe.body.winner?.runId,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.two-region-conflict-resolves-to-the-lex-min-runid-per-annex-convergence-rule', 
         'idempotency.md §"Convergence rule"',
         'winner MUST be the lex-min runId (run-a-west < run-b-east)',
       ),
@@ -108,19 +109,19 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (probe.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(probe.status).toBe(200);
     expect(
       probe.body.winner?.runId,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.three-region-partition-resolves-to-a-single-winner', 
         'idempotency.md §"Convergence rule"',
         'winner MUST be the lex-min runId across all conflicting claims',
       ),
     ).toBe('aaa-1');
     expect(
       probe.body.losers?.length,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.three-region-partition-resolves-to-a-single-winner', 
         'idempotency.md §"Convergence rule"',
         'losers array MUST contain N-1 entries when N claims conflict',
       ),
@@ -135,13 +136,13 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (probe.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(probe.status).toBe(200);
     const redirects = probe.body.cacheRedirects ?? [];
     expect(
       redirects.length,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.every-region-gets-a-cache-redirect-entry-pointing-at-the-winner', 
         'idempotency.md §"Convergence rule"',
         'cacheRedirects MUST contain one entry per claim (including the winner)',
       ),
@@ -149,7 +150,7 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     for (const redirect of redirects) {
       expect(
         redirect.redirectToRunId,
-        driver.describe(
+        req('openwop.it.multi-region-idempotency-behavior.every-region-gets-a-cache-redirect-entry-pointing-at-the-winner', 
           'idempotency.md §"Convergence rule"',
           'every cache redirect MUST point at the winner runId',
         ),
@@ -165,12 +166,12 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (probe.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(probe.status).toBe(200);
     expect(
       probe.body.loserCancelReason,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.loser-cancel-reason-must-be-the-canonical-cross-region-dedup-loss-string', 
         'idempotency.md §"Convergence rule"',
         'loserCancelReason MUST be the canonical `cross_region_dedup_loss` string',
       ),
@@ -187,7 +188,7 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (p1.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `p1.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(p1.status).toBe(200);
     const p2 = await simulatePartition([claims[2]!, claims[0]!, claims[1]!]);
@@ -196,7 +197,7 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     expect(p3.status).toBe(200);
     expect(
       p1.body.winner?.runId,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.resolver-is-order-invariant-shuffled-inputs-produce-the-same-winner', 
         'idempotency.md §"Convergence rule" — determinism',
         'resolver MUST be order-invariant; all permutations MUST produce the same lex-min winner',
       ),
@@ -213,11 +214,11 @@ describe.skipIf(HTTP_SKIP)('multi-region-idempotency-behavior: convergence rule
     if (probe.status === 404) {
       await noteSimulatorAbsent();
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(
       probe.status,
-      driver.describe(
+      req('openwop.it.multi-region-idempotency-behavior.mismatched-tuple-rejects-with-400-validation-error', 
         'idempotency.md §"Convergence rule"',
         'claims with non-matching (tenantId, endpoint, key) MUST be rejected — it would be a programming error in the caller',
       ),