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

package/src/scenarios/subrun-approval-gate.test.ts

@@ -11,8 +11,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { softSkip } from '../lib/soft-skip.js';
-import { driver } from '../lib/driver.js';
 import { readSubRunAttestationCap, invokeSubRunAttest } from '../lib/subRunAttestation.js';
+import { req } from '../lib/requirement-ids.js';
 
 describe('subrun-approval-gate (RFC 0063 §C)', () => {
   it('accept merges the child outputs; reject does not', async () => {
@@ -23,14 +23,14 @@ describe('subrun-approval-gate (RFC 0063 §C)', () => {
     if (accepted === null) return softSkip('blocked', 'seam absent — soft-skip');
     expect(
       accepted.merged,
-      driver.describe('RFC 0063 §C', 'an `accept` approval MUST merge the child outputs'),
+      req('openwop.it.subrun-approval-gate.accept-merges-the-child-outputs-reject-does-not', 'RFC 0063 §C', 'an `accept` approval MUST merge the child outputs'),
     ).toBe(true);
 
     const rejected = await invokeSubRunAttest({ ...base, approvalAction: 'reject' });
     if (rejected === null) return softSkip('blocked', 'precondition not met — `rejected === null` returned early (seam, prior step, or fixture unavailable)');
     expect(
       rejected.merged,
-      driver.describe('RFC 0063 §C', 'a `reject` approval MUST NOT merge the child outputs'),
+      req('openwop.it.subrun-approval-gate.accept-merges-the-child-outputs-reject-does-not', 'RFC 0063 §C', 'a `reject` approval MUST NOT merge the child outputs'),
     ).toBe(false);
   });
 });

package/src/scenarios/subrun-attestation-shape.test.ts

@@ -12,8 +12,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { softSkip } from '../lib/soft-skip.js';
-import { driver } from '../lib/driver.js';
 import { readSubRunAttestationCap } from '../lib/subRunAttestation.js';
+import { req } from '../lib/requirement-ids.js';
 
 describe('subrun-attestation-shape: advertisement (RFC 0063 §A)', () => {
   it('capabilities.agents.subRunAttestation is absent or a boolean', async () => {
@@ -22,7 +22,7 @@ describe('subrun-attestation-shape: advertisement (RFC 0063 §A)', () => {
     if (cap === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap === null` returned early');
     expect(
       typeof cap,
-      driver.describe(
+      req('openwop.it.subrun-attestation-shape.capabilities-agents-subrunattestation-is-absent-or-a-boolean', 
         'capabilities.schema.json §agents.subRunAttestation',
         'agents.subRunAttestation MUST be a boolean when present',
       ),

package/src/scenarios/subrun-checksum-stable.test.ts

@@ -12,8 +12,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { softSkip } from '../lib/soft-skip.js';
-import { driver } from '../lib/driver.js';
 import { readSubRunAttestationCap, invokeSubRunAttest } from '../lib/subRunAttestation.js';
+import { req } from '../lib/requirement-ids.js';
 
 describe('subrun-checksum-stable (RFC 0063 §B)', () => {
   it('identical child outputs produce an identical sha256 attestation checksum', async () => {
@@ -30,15 +30,15 @@ describe('subrun-checksum-stable (RFC 0063 §B)', () => {
     const att = a.attestation ?? {};
     expect(
       typeof att.checksum === 'string' && (att.checksum as string).length > 0,
-      driver.describe('RFC 0063 §B', 'output.harvested MUST carry a non-empty attestation.checksum when checksum:true'),
+      req('openwop.it.subrun-checksum-stable.identical-child-outputs-produce-an-identical-sha256-attestation-checksum', 'RFC 0063 §B', 'output.harvested MUST carry a non-empty attestation.checksum when checksum:true'),
     ).toBe(true);
     expect(
       att.algorithm,
-      driver.describe('RFC 0063 §B', 'attestation.algorithm MUST be "sha256" (the v1 recipe)'),
+      req('openwop.it.subrun-checksum-stable.identical-child-outputs-produce-an-identical-sha256-attestation-checksum', 'RFC 0063 §B', 'attestation.algorithm MUST be "sha256" (the v1 recipe)'),
     ).toBe('sha256');
     expect(
       (b.attestation ?? {}).checksum,
-      driver.describe('RFC 0063 §B', 'JCS canonicalization MUST make the checksum invariant to key order — same content, same hash'),
+      req('openwop.it.subrun-checksum-stable.identical-child-outputs-produce-an-identical-sha256-attestation-checksum', 'RFC 0063 §B', 'JCS canonicalization MUST make the checksum invariant to key order — same content, same hash'),
     ).toBe(att.checksum);
   });
 });

package/src/scenarios/subworkflow-input-mapping.test.ts

@@ -23,6 +23,8 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal, pollUntilStatus } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { setHostCapability, resetHostCapabilities, isToggleAvailable } from '../lib/host-toggle.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const PARENT = 'conformance-subworkflow-input-mapping';
 const CHILD = 'conformance-subworkflow-input-mapping-child';
@@ -51,7 +53,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     const parentRunId = (create.json as { runId: string }).runId;
 
     const parentTerminal = (await pollUntilTerminal(parentRunId)) as RunSnapshot;
-    expect(parentTerminal.status, driver.describe(
+    expect(parentTerminal.status, req('openwop.it.subworkflow-input-mapping.hvmap-2-inputmapping-seeds-child-variables-overrides-defaultvalue-child-reads-pa', 
       'RFCS/0022-dispatch-input-output-mapping.md §B',
       'parent run MUST reach terminal `completed` once the child finishes',
     )).toBe('completed');
@@ -63,7 +65,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     const subwfCompleted = events.find(
       (e) => e.type === 'node.completed' && e.nodeId === 'subwf-call',
     );
-    expect(subwfCompleted, driver.describe(
+    expect(subwfCompleted, req('openwop.it.subworkflow-input-mapping.hvmap-2-inputmapping-seeds-child-variables-overrides-defaultvalue-child-reads-pa', 
       'spec/v1/node-packs.md §"`core.subWorkflow` contract"',
       'parent event log MUST contain `node.completed` for the subwf-call node',
     )).toBeDefined();
@@ -76,12 +78,12 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     const childSnapshotRes = await driver.get(`/v1/runs/${encodeURIComponent(childRunId!)}`);
     expect(childSnapshotRes.status).toBe(200);
     const childSnapshot = childSnapshotRes.json as RunSnapshot;
-    expect(childSnapshot.status, driver.describe(
+    expect(childSnapshot.status, req('openwop.it.subworkflow-input-mapping.hvmap-2-inputmapping-seeds-child-variables-overrides-defaultvalue-child-reads-pa', 
       'spec/v1/node-packs.md §"`core.subWorkflow` contract"',
       'child run MUST reach terminal `completed`',
     )).toBe('completed');
     const childVars = childSnapshot.variables ?? {};
-    expect(childVars.receivedPrdId, driver.describe(
+    expect(childVars.receivedPrdId, req('openwop.it.subworkflow-input-mapping.hvmap-2-inputmapping-seeds-child-variables-overrides-defaultvalue-child-reads-pa', 
       'RFCS/0022-dispatch-input-output-mapping.md §B',
       'child `receivedPrdId` MUST be parent\'s `currentPrdId` projection ("prd-1"), overriding the child\'s defaultValue "baked-in"',
     )).toBe('prd-1');
@@ -89,7 +91,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
 
   it('HVMAP-2-unset: parent.currentPrdId unset → child receivedPrdId MUST surface as `undefined`', async () => {
     const PARENT_NO_DEFAULT = 'conformance-subworkflow-input-mapping-no-default';
-    if (!isFixtureAdvertised(PARENT_NO_DEFAULT) || !isFixtureAdvertised(CHILD)) return; // soft-skip
+    if (!isFixtureAdvertised(PARENT_NO_DEFAULT) || !isFixtureAdvertised(CHILD)) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!isFixtureAdvertised(PARENT_NO_DEFAULT) || !isFixtureAdvertised(CHILD)` returned early (soft-skip)'); // soft-skip
     const create = await driver.post('/v1/runs', { workflowId: PARENT_NO_DEFAULT });
     expect(create.status).toBe(201);
     const parentRunId = (create.json as { runId: string }).runId;
@@ -100,7 +102,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     const subwfCompleted = events.find(
       (e) => e.type === 'node.completed' && e.nodeId === 'subwf-call',
     );
-    if (!subwfCompleted) return;
+    if (!subwfCompleted) return softSkip('blocked', 'precondition not met — `!subwfCompleted` returned early (seam, prior step, or fixture unavailable)');
     const childRunId = subwfCompleted.payload?.outputs?.childRunId;
 
     const childRes = await driver.get(`/v1/runs/${encodeURIComponent(childRunId!)}`);
@@ -114,7 +116,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     // undefined the child's defaultValue should remain.
     expect(
       v === 'baked-in' || v === undefined || !('receivedPrdId' in vars),
-      driver.describe(
+      req('openwop.it.subworkflow-input-mapping.hvmap-2-unset-parent-currentprdid-unset-child-receivedprdid-must-surface-as-unde', 
         'RFCS/0022-dispatch-input-output-mapping.md §B',
         'unset parent variable MUST surface as undefined-or-defaultValue-fallback (NOT null)',
       ),
@@ -137,8 +139,8 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
   const CHILD_GATE_NODE = 'child-gate';
 
   it('HVMAP-2-no-midrun-propagation: parent mid-run mutation MUST NOT propagate into the seeded child', async () => {
-    if (!isFixtureAdvertised(MID_RUN_PARENT) || !isFixtureAdvertised(MID_RUN_CHILD)) return; // fixture not seeded — soft-skip
-    if (!(await isToggleAvailable())) return; // sample test seam not exposed — soft-skip
+    if (!isFixtureAdvertised(MID_RUN_PARENT) || !isFixtureAdvertised(MID_RUN_CHILD)) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!isFixtureAdvertised(MID_RUN_PARENT) || !isFixtureAdvertised(MID_RUN_CHILD)` returned early (fixture not seeded — soft-skip)'); // fixture not seeded — soft-skip
+    if (!(await isToggleAvailable())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isToggleAvailable())` returned early (sample test seam not exposed — soft-skip)'); // sample test seam not exposed — soft-skip
 
     const create = await driver.post('/v1/runs', { workflowId: MID_RUN_PARENT });
     expect(create.status).toBe(201);
@@ -156,7 +158,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     const parentSnap = await driver.get(`/v1/runs/${encodeURIComponent(parentRunId)}`);
     const parentJson = parentSnap.json as { childRuns?: Array<{ runId: string; status: string }> };
     const childRunId = parentJson.childRuns?.[0]?.runId;
-    expect(childRunId, driver.describe(
+    expect(childRunId, req('openwop.it.subworkflow-input-mapping.hvmap-2-no-midrun-propagation-parent-mid-run-mutation-must-not-propagate-into-th', 
       'fixtures.md conformance-subworkflow-mid-run-mutation',
       'parent snapshot MUST surface the spawned child runId via childRuns[]',
     )).toBeDefined();
@@ -185,7 +187,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
     // (`seeded-id`), NOT the post-mutation parent value (`mutated-id`).
     expect(
       childTerminal.variables?.receivedPrdId,
-      driver.describe(
+      req('openwop.it.subworkflow-input-mapping.hvmap-2-no-midrun-propagation-parent-mid-run-mutation-must-not-propagate-into-th', 
         'RFCS/0022-dispatch-input-output-mapping.md §B',
         'mid-run parent mutation MUST NOT propagate; child receivedPrdId stays at dispatch-time fold',
       ),
@@ -196,7 +198,7 @@ describe.skipIf(SKIP)('subworkflow-input-mapping: parent → child variable seed
 
 describe('subworkflow-input-mapping: registration refusal (RFC 0022 §C HVMAP-2-refusal)', () => {
   it('host with subWorkflow.inputMapping toggled OFF MUST refuse non-empty inputMapping at registration', async () => {
-    if (!(await isToggleAvailable())) return; // seam not exposed — soft-skip
+    if (!(await isToggleAvailable())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await isToggleAvailable())` returned early (seam not exposed — soft-skip)'); // seam not exposed — soft-skip
     await setHostCapability('subWorkflow.inputMapping', false);
     try {
       const workflow = {
@@ -215,7 +217,7 @@ describe('subworkflow-input-mapping: registration refusal (RFC 0022 §C HVMAP-2-
       const res = await driver.post('/v1/host/sample/workflows', workflow);
       expect(
         res.status,
-        driver.describe(
+        req('openwop.it.subworkflow-input-mapping.host-with-subworkflow-inputmapping-toggled-off-must-refuse-non-empty-inputmappin', 
           'RFCS/0022-dispatch-input-output-mapping.md §C',
           'workflow with non-empty subWorkflow.inputMapping MUST be refused when capability is not advertised',
         ),
@@ -224,7 +226,7 @@ describe('subworkflow-input-mapping: registration refusal (RFC 0022 §C HVMAP-2-
       expect(body.error).toBe('validation_error');
       expect(
         body.details?.requiredCapability,
-        driver.describe(
+        req('openwop.it.subworkflow-input-mapping.host-with-subworkflow-inputmapping-toggled-off-must-refuse-non-empty-inputmappin', 
           'RFCS/0022-dispatch-input-output-mapping.md §C',
           'refusal MUST surface requiredCapability: "subWorkflow.inputMapping"',
         ),

package/src/scenarios/subworkflow.test.ts

@@ -20,6 +20,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 PARENT_WORKFLOW_ID = 'conformance-subworkflow-parent';
 const CHILD_WORKFLOW_ID = 'conformance-subworkflow-child';
@@ -50,7 +51,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('subworkflow: conformance-subworkflow-parent di
     const parentRunId = (create.json as { runId: string }).runId;
 
     const parentTerminal = await pollUntilTerminal(parentRunId);
-    expect(parentTerminal.status, driver.describe(
+    expect(parentTerminal.status, req('openwop.it.subworkflow.parent-run-reaches-terminal-completed-and-child-variable-is-propagated-via-outpu', 
       'fixtures.md conformance-subworkflow-parent §Terminal status',
       'parent fixture MUST reach terminal `completed` after child finishes',
     )).toBe('completed');
@@ -59,7 +60,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('subworkflow: conformance-subworkflow-parent di
     // parent's `childOutcome`. The variable should appear on the parent's
     // final variables.
     const parentVars = (parentTerminal as RunSnapshot).variables ?? {};
-    expect(parentVars.childOutcome, driver.describe(
+    expect(parentVars.childOutcome, req('openwop.it.subworkflow.parent-run-reaches-terminal-completed-and-child-variable-is-propagated-via-outpu', 
       'node-packs.md §core.subWorkflow outputMapping',
       'parent variables MUST include `childOutcome` mapped from child `childResult`',
     )).toBeDefined();
@@ -84,7 +85,7 @@ describe.skipIf(SKIP_NO_FIXTURE)('subworkflow: conformance-subworkflow-parent di
     const subwfCompleted = events.find(
       (e) => e.type === 'node.completed' && e.nodeId === 'subwf-call',
     );
-    expect(subwfCompleted, driver.describe(
+    expect(subwfCompleted, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'node-packs.md §core.subWorkflow',
       'parent event log MUST contain node.completed for the subwf-call node',
     )).toBeDefined();
@@ -93,32 +94,32 @@ describe.skipIf(SKIP_NO_FIXTURE)('subworkflow: conformance-subworkflow-parent di
       | { outputs?: { childRunId?: string; childStatus?: string; skipped?: boolean } }
       | undefined;
     const childRunId = subwfPayload?.outputs?.childRunId;
-    expect(typeof childRunId, driver.describe(
+    expect(typeof childRunId, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'node-packs.md §core.subWorkflow outputSchema',
       'core.subWorkflow output MUST include childRunId as a string',
     )).toBe('string');
 
-    expect(subwfPayload?.outputs?.childStatus, driver.describe(
+    expect(subwfPayload?.outputs?.childStatus, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'node-packs.md §core.subWorkflow outputSchema',
       'core.subWorkflow output MUST include childStatus="completed" on success',
     )).toBe('completed');
 
     // Fetch the child run snapshot and verify parent linkage.
     const childRes = await driver.get(`/v1/runs/${encodeURIComponent(childRunId!)}`);
-    expect(childRes.status, 'child run snapshot MUST be retrievable').toBe(200);
+    expect(childRes.status, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 'node-packs.md §core.subWorkflow outputSchema', 'child run snapshot MUST be retrievable')).toBe(200);
     const child = childRes.json as RunSnapshot;
 
-    expect(child.status, driver.describe(
+    expect(child.status, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'fixtures.md conformance-subworkflow-child §Terminal status',
       'child MUST reach terminal `completed`',
     )).toBe('completed');
 
-    expect(child.parentRunId, driver.describe(
+    expect(child.parentRunId, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'spec gap G3 parent linkage',
       'child run MUST carry parentRunId pointing back to dispatcher',
     )).toBe(parentRunId);
 
-    expect(child.parentNodeId, driver.describe(
+    expect(child.parentNodeId, req('openwop.it.subworkflow.child-run-is-created-with-parent-linkage-fields-and-reaches-terminal-completed', 
       'spec gap G3 parent linkage',
       'child run MUST carry parentNodeId pointing back to the subwf-call node',
     )).toBe('subwf-call');

package/src/scenarios/table-cross-tenant-isolation.test.ts

@@ -11,6 +11,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 DiscoveryDoc {
   capabilities?: Record<string, unknown>;
@@ -31,10 +33,10 @@ async function call(tenantId: string, op: string, args: Record<string, unknown>)
 describe('table-cross-tenant-isolation: advertisement shape (RFC 0016)', () => {
   it('capabilities.tableStorage is either absent or a well-formed object', async () => {
     const cap = await readCap();
-    if (cap === null) return;
+    if (cap === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap === null` returned early');
     expect(
       typeof cap.supported,
-      driver.describe(
+      req('openwop.it.table-cross-tenant-isolation.capabilities-tablestorage-is-either-absent-or-a-well-formed-object', 
         'capabilities.schema.json §tableStorage',
         'capabilities.tableStorage.supported MUST be a boolean when present',
       ),
@@ -45,22 +47,22 @@ describe('table-cross-tenant-isolation: advertisement shape (RFC 0016)', () => {
 describe('table-cross-tenant-isolation: behavioral (RFC 0016 §B point 1)', () => {
   it('insert under tenant A → query under tenant B returns 0 rows', async () => {
     const cap = await readCap();
-    if (!cap || cap.supported !== true) return;
+    if (!cap || cap.supported !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!cap || cap.supported !== true` returned early');
     const table = `xtenant_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
 
     const insertRes = await call('tenant-a', 'insert', {
       table,
       row: { id: 'r1', body: 'from-A' },
     });
-    if (insertRes.status === 404) return; // seam not exposed
-    expect(insertRes.status, 'insert MUST succeed').toBe(200);
+    if (insertRes.status === 404) return softSkip('blocked', 'precondition not met — `insertRes.status === 404` returned early (seam not exposed) (seam, prior step, or fixture unavailable)'); // seam not exposed
+    expect(insertRes.status, req('openwop.it.table-cross-tenant-isolation.insert-under-tenant-a-query-under-tenant-b-returns-0-rows', 'RFC 0016 §B point 1', 'insert MUST succeed')).toBe(200);
 
     const queryRes = await call('tenant-b', 'query', { table, filter: {} });
     expect(queryRes.status).toBe(200);
     const body = queryRes.json as { rows?: unknown[] };
     expect(
       Array.isArray(body.rows) ? body.rows.length : -1,
-      driver.describe('RFC 0016 §B point 1', 'tenant B MUST see 0 rows in tenant A table'),
+      req('openwop.it.table-cross-tenant-isolation.insert-under-tenant-a-query-under-tenant-b-returns-0-rows', 'RFC 0016 §B point 1', 'tenant B MUST see 0 rows in tenant A table'),
     ).toBe(0);
   });
 });

package/src/scenarios/table-cursor-pagination.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 DiscoveryDoc {
   capabilities?: Record<string, unknown>;
@@ -32,10 +34,10 @@ async function readCap(): Promise<Record<string, unknown> | null> {
 describe('table-cursor-pagination: advertisement shape (RFC 0016)', () => {
   it('capabilities.tableStorage is either absent or a well-formed object', async () => {
     const cap = await readCap();
-    if (cap === null) return; // host doesn't advertise — skip
+    if (cap === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap === null` returned early (host doesn\'t advertise — skip)'); // host doesn't advertise — skip
     expect(
       typeof cap.supported,
-      driver.describe(
+      req('openwop.it.table-cursor-pagination.capabilities-tablestorage-is-either-absent-or-a-well-formed-object', 
         'capabilities.schema.json §tableStorage',
         'capabilities.tableStorage.supported MUST be a boolean when present',
       ),
@@ -50,7 +52,7 @@ async function call(op: string, args: Record<string, unknown>) {
 describe('table-cursor-pagination: behavioral (RFC 0016 §B point 3)', () => {
   it('first page returns N rows + nextCursor; second page resumes; final page returns nextCursor:null', async () => {
     const probe = await call('query', { table: '__probe__', limit: 1 });
-    if (probe.status === 404) return; // seam not exposed
+    if (probe.status === 404) return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam not exposed) (seam, prior step, or fixture unavailable)'); // seam not exposed
     const table = `pag-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     // Seed 5 rows with deterministic ids so cursor ordering is testable.
     for (let i = 1; i <= 5; i++) {
@@ -62,7 +64,7 @@ describe('table-cursor-pagination: behavioral (RFC 0016 §B point 3)', () => {
     expect(Array.isArray(b1.rows) && b1.rows.length === 2).toBe(true);
     expect(
       typeof b1.nextCursor === 'string' && b1.nextCursor.length > 0,
-      driver.describe('RFC 0016 §B point 3', 'first page MUST surface nextCursor when more results remain'),
+      req('openwop.it.table-cursor-pagination.first-page-returns-n-rows-nextcursor-second-page-resumes-final-page-returns-next', 'RFC 0016 §B point 3', 'first page MUST surface nextCursor when more results remain'),
     ).toBe(true);
 
     // Page 2: cursor from page 1, limit=2
@@ -71,7 +73,7 @@ describe('table-cursor-pagination: behavioral (RFC 0016 §B point 3)', () => {
     expect(b2.rows?.length).toBe(2);
     expect(
       b2.rows![0]!.id > b1.rows![1]!.id,
-      driver.describe('RFC 0016 §B point 3', 'second page MUST resume AFTER the last id of the previous page'),
+      req('openwop.it.table-cursor-pagination.first-page-returns-n-rows-nextcursor-second-page-resumes-final-page-returns-next', 'RFC 0016 §B point 3', 'second page MUST resume AFTER the last id of the previous page'),
     ).toBe(true);
 
     // Page 3: final page — only 1 row left, nextCursor MUST be null
@@ -80,7 +82,7 @@ describe('table-cursor-pagination: behavioral (RFC 0016 §B point 3)', () => {
     expect(b3.rows?.length).toBe(1);
     expect(
       b3.nextCursor,
-      driver.describe('RFC 0016 §B point 3', 'final page (no more results) MUST surface nextCursor: null'),
+      req('openwop.it.table-cursor-pagination.first-page-returns-n-rows-nextcursor-second-page-resumes-final-page-returns-next', 'RFC 0016 §B point 3', 'final page (no more results) MUST surface nextCursor: null'),
     ).toBe(null);
   });
 });

package/src/scenarios/table-schema-enforcement.test.ts

@@ -17,6 +17,8 @@ import { describe, it, expect } from 'vitest';
 import { readErrorCode } from '../lib/error-envelope.js';
 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 DiscoveryDoc {
   capabilities?: Record<string, unknown>;
@@ -33,10 +35,10 @@ async function readCap(): Promise<Record<string, unknown> | null> {
 describe('table-schema-enforcement: advertisement shape (RFC 0016)', () => {
   it('capabilities.tableStorage is either absent or a well-formed object', async () => {
     const cap = await readCap();
-    if (cap === null) return; // host doesn't advertise — skip
+    if (cap === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap === null` returned early (host doesn\'t advertise — skip)'); // host doesn't advertise — skip
     expect(
       typeof cap.supported,
-      driver.describe(
+      req('openwop.it.table-schema-enforcement.capabilities-tablestorage-is-either-absent-or-a-well-formed-object', 
         'capabilities.schema.json §tableStorage',
         'capabilities.tableStorage.supported MUST be a boolean when present',
       ),
@@ -51,7 +53,7 @@ async function call(op: string, args: Record<string, unknown>) {
 describe('table-schema-enforcement: behavioral (RFC 0016 §B point 2)', () => {
   it('first insert declares schema; subsequent insert with wrong column type is rejected', async () => {
     const probe = await call('insert', { table: '__probe__', row: { id: 'probe-0' } });
-    if (probe.status === 404) return; // seam not exposed
+    if (probe.status === 404) return softSkip('blocked', 'precondition not met — `probe.status === 404` returned early (seam not exposed) (seam, prior step, or fixture unavailable)'); // seam not exposed
     const table = `sch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     // First insert — declares the schema from this row's columns.
     const first = await call('insert', {
@@ -74,12 +76,12 @@ describe('table-schema-enforcement: behavioral (RFC 0016 §B point 2)', () => {
     });
     expect(
       bad.status >= 400 && bad.status < 500,
-      driver.describe('RFC 0016 §B point 2', 'type-divergent insert MUST be rejected with 4xx'),
+      req('openwop.it.table-schema-enforcement.first-insert-declares-schema-subsequent-insert-with-wrong-column-type-is-rejecte', 'RFC 0016 §B point 2', 'type-divergent insert MUST be rejected with 4xx'),
     ).toBe(true);
     const code = readErrorCode(bad.json);
     expect(
       code,
-      driver.describe('RFC 0016 §B point 2', 'rejection MUST carry the table_schema_violation error code'),
+      req('openwop.it.table-schema-enforcement.first-insert-declares-schema-subsequent-insert-with-wrong-column-type-is-rejecte', 'RFC 0016 §B point 2', 'rejection MUST carry the table_schema_violation error code'),
     ).toBe('table_schema_violation');
   });
 });

package/src/scenarios/test-seam-unauthenticated.test.ts

@@ -49,8 +49,8 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { driver } from '../lib/driver.js';
 import { loadEnv } from '../lib/env.js';
+import { req } from '../lib/requirement-ids.js';
 
 /**
  * Canonical seam paths from `host-sample-test-seams.md`. A host that exposes
@@ -160,7 +160,7 @@ describe('test-seam-unauthenticated: an enabled seam still authenticates', () =>
 
     expect(
       answered,
-      driver.describe('host-sample-test-seams.md §"Production safety (normative)"', `${diagnosis}\n  ${answered.join('\n  ')}`),
+      req('openwop.it.test-seam-unauthenticated.no-v1-host-sample-seam-answers-an-unauthenticated-request-with-200', 'host-sample-test-seams.md §"Production safety (normative)"', `${diagnosis}\n  ${answered.join('\n  ')}`),
     ).toEqual([]);
   });
 });

package/src/scenarios/tool-catalog-compact-projection.test.ts

@@ -46,6 +46,8 @@ import {
   findBannedInputSchemaKeyword,
   type CompactToolDescriptor,
 } from '../lib/toolCatalog.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 function loadSchema(name: string): Record<string, unknown> {
   return JSON.parse(readFileSync(join(SCHEMAS_DIR, name), 'utf8')) as Record<string, unknown>;
@@ -80,18 +82,18 @@ describe('tool-catalog-compact-projection (RFC 0112 §compact)', () => {
 
     // ---- Leg 1: the compact envelope (§compact) -------------------------
     const compact = await listToolsCompact();
-    if (compact === null) return; // advertises the cap but doesn't serve the read — soft-skip the rest
+    if (compact === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `compact === null` returned early (advertises the cap but doesn\'t serve the read — soft-skip the rest)'); // advertises the cap but doesn't serve the read — soft-skip the rest
 
     for (const t of compact) {
       // ---- Leg 2: schema validity + heavy fields dropped ----------------
       expect(
         validate(t),
-        driver.describe('compact-tool-descriptor.schema.json', `each CompactToolDescriptor MUST validate (${ajv.errorsText(validate.errors)})`),
+        req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'compact-tool-descriptor.schema.json', `each CompactToolDescriptor MUST validate (${ajv.errorsText(validate.errors)})`),
       ).toBe(true);
       for (const f of COMPACT_DROPPED_FIELDS) {
         expect(
           !(f in t),
-          driver.describe('tool-catalog.md §compact', `CompactToolDescriptor MUST drop the heavy field "${f}"`),
+          req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'tool-catalog.md §compact', `CompactToolDescriptor MUST drop the heavy field "${f}"`),
         ).toBe(true);
       }
 
@@ -100,14 +102,14 @@ describe('tool-catalog-compact-projection (RFC 0112 §compact)', () => {
       if (input !== undefined) {
         expect(
           input.type === 'object' && typeof input.properties === 'object' && input.properties !== null,
-          driver.describe('tool-catalog.md §compact', 'compact inputSchema MUST be top-level type:"object" with a properties map'),
+          req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'tool-catalog.md §compact', 'compact inputSchema MUST be top-level type:"object" with a properties map'),
         ).toBe(true);
         // Total (any-depth), schema-aware: a nested oneOf/$ref under a property
         // schema is exactly the verbosity the compact view exists to drop.
         const banned = findBannedInputSchemaKeyword(input);
         expect(
           banned,
-          driver.describe('tool-catalog.md §compact', `compact inputSchema MUST NOT use $ref/oneOf/allOf/anyOf/not/patternProperties/dependentSchemas at any nesting depth (found "${banned ?? 'none'}")`),
+          req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'tool-catalog.md §compact', `compact inputSchema MUST NOT use $ref/oneOf/allOf/anyOf/not/patternProperties/dependentSchemas at any nesting depth (found "${banned ?? 'none'}")`),
         ).toBe(null);
       }
     }
@@ -123,7 +125,7 @@ describe('tool-catalog-compact-projection (RFC 0112 §compact)', () => {
       standardIds.size === compactIds.size && [...standardIds].every((id) => compactIds.has(id));
     expect(
       sameSet,
-      driver.describe(
+      req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 
         'tool-catalog.md §compact',
         `compact tools[] MUST carry the same toolId set as the standard view (standard=${[...standardIds].sort().join(',')} compact=${[...compactIds].sort().join(',')})`,
       ),
@@ -136,12 +138,12 @@ describe('tool-catalog-compact-projection (RFC 0112 §compact)', () => {
       if (one.status === 200) {
         expect(
           validate(one.json),
-          driver.describe('compact-tool-descriptor.schema.json', `GET /v1/tools/{toolId}?view=compact MUST return a valid CompactToolDescriptor (${ajv.errorsText(validate.errors)})`),
+          req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'compact-tool-descriptor.schema.json', `GET /v1/tools/{toolId}?view=compact MUST return a valid CompactToolDescriptor (${ajv.errorsText(validate.errors)})`),
         ).toBe(true);
         const got = one.json;
         expect(
           got && typeof got === 'object' && (got as { toolId?: unknown }).toolId === id,
-          driver.describe('tool-catalog.md §compact', 'GET /v1/tools/{toolId}?view=compact MUST return the requested descriptor'),
+          req('openwop.it.tool-catalog-compact-projection.serves-the-tools-compacttooldescriptor-projection-closed-shape-bounded-inputsche', 'tool-catalog.md §compact', 'GET /v1/tools/{toolId}?view=compact MUST return the requested descriptor'),
         ).toBe(true);
       }
     }

package/src/scenarios/tool-catalog-projection.test.ts

@@ -40,6 +40,8 @@ import {
   SAFETY_TIERS,
   TOOL_CONTENT_FORBIDDEN,
 } from '../lib/toolCatalog.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 function loadSchema(name: string): Record<string, unknown> {
   return JSON.parse(readFileSync(join(SCHEMAS_DIR, name), 'utf8')) as Record<string, unknown>;
@@ -49,7 +51,7 @@ function expectContentFree(d: Record<string, unknown>, where: string): void {
   for (const f of TOOL_CONTENT_FORBIDDEN) {
     expect(
       !(f in d),
-      driver.describe('RFC 0078 §F (SR-1)', `${where} MUST be content-free (no ${f})`),
+      req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'RFC 0078 §F (SR-1)', `${where} MUST be content-free (no ${f})`),
     ).toBe(true);
   }
 }
@@ -67,25 +69,25 @@ describe('tool-catalog-projection (RFC 0078 §B/§F)', () => {
     const unauth = await driver.get('/v1/tools', { authenticated: false });
     expect(
       unauth.status === 401,
-      driver.describe('tool-catalog.md §B', 'GET /v1/tools MUST require authentication (401 unauthenticated)'),
+      req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §B', 'GET /v1/tools MUST require authentication (401 unauthenticated)'),
     ).toBe(true);
 
     // ---- Leg 1: the list (§B) -------------------------------------------
     const tools = await listTools();
-    if (tools === null) return; // host advertises the cap but doesn't serve the read — soft-skip the rest
+    if (tools === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `tools === null` returned early (host advertises the cap but doesn\'t serve the read — soft-skip the rest)'); // host advertises the cap but doesn't serve the read — soft-skip the rest
 
     for (const t of tools) {
       expect(
         validate(t),
-        driver.describe('tool-descriptor.schema.json', `each ToolDescriptor MUST validate (${ajv.errorsText(validate.errors)})`),
+        req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-descriptor.schema.json', `each ToolDescriptor MUST validate (${ajv.errorsText(validate.errors)})`),
       ).toBe(true);
       expect(
         typeof t.source === 'string' && TOOL_SOURCES.includes(t.source as string),
-        driver.describe('tool-catalog.md §C', 'ToolDescriptor.source MUST be in the closed vocabulary'),
+        req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §C', 'ToolDescriptor.source MUST be in the closed vocabulary'),
       ).toBe(true);
       expect(
         typeof t.safetyTier === 'string' && SAFETY_TIERS.includes(t.safetyTier as string),
-        driver.describe('tool-catalog.md §C', 'ToolDescriptor.safetyTier MUST be pure|read|write|exec'),
+        req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §C', 'ToolDescriptor.safetyTier MUST be pure|read|write|exec'),
       ).toBe(true);
       expectContentFree(t, 'ToolDescriptor');
     }
@@ -97,14 +99,14 @@ describe('tool-catalog-projection (RFC 0078 §B/§F)', () => {
       if (one.status === 200) {
         expect(
           one.descriptor?.toolId === id,
-          driver.describe('tool-catalog.md §B', 'GET /v1/tools/{toolId} MUST return the requested descriptor'),
+          req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §B', 'GET /v1/tools/{toolId} MUST return the requested descriptor'),
         ).toBe(true);
       }
     }
     const unknown = await getTool('__conformance_nonexistent_tool__');
     expect(
       unknown.status === 404,
-      driver.describe('tool-catalog.md §B', 'GET /v1/tools/{unknown} MUST 404'),
+      req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §B', 'GET /v1/tools/{unknown} MUST 404'),
     ).toBe(true);
 
     // ---- Leg 4: §F-2 cross-principal non-disclosure (env-gated) ---------
@@ -113,7 +115,7 @@ describe('tool-catalog-projection (RFC 0078 §B/§F)', () => {
       const cross = await getTool(crossId);
       expect(
         cross.status === 404,
-        driver.describe('tool-catalog.md §F-2', 'a tool owned by a different principal MUST 404 (non-disclosure)'),
+        req('openwop.it.tool-catalog-projection.lists-schema-valid-tooldescriptors-serves-by-id-404s-is-auth-gated-and-never-dis', 'tool-catalog.md §F-2', 'a tool owned by a different principal MUST 404 (non-disclosure)'),
       ).toBe(true);
     }
   });