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

package/src/scenarios/a2ui-surface-shape.test.ts

@@ -31,6 +31,7 @@ import Ajv2020 from 'ajv/dist/2020.js';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { req } from '../lib/requirement-ids.js';
 
 const ajv = new Ajv2020({ strict: false, allErrors: true });
 const schema = JSON.parse(
@@ -70,7 +71,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
   it('ui.a2ui-surface.schema.json compiles under Ajv2020', () => {
     expect(
       validate,
-      'RFC 0102 §A: the core ui.a2ui-surface payload schema MUST compile',
+      req('openwop.it.a2ui-surface-shape.ui-a2ui-surface-schema-json-compiles-under-ajv2020', 'RFC 0102 §A', 'RFC 0102 §A: the core ui.a2ui-surface payload schema MUST compile'),
     ).toBeTypeOf('function');
   });
 
@@ -78,7 +79,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     const ok = validate(positivePayload());
     expect(
       ok,
-      `RFC 0102 §A: positive surface MUST validate; errors: ${JSON.stringify(validate.errors)}`,
+      req('openwop.it.a2ui-surface-shape.accepts-a-positive-surface-payload-closed-catalog-confined-action', 'RFC 0102 §A', `RFC 0102 §A: positive surface MUST validate; errors: ${JSON.stringify(validate.errors)}`),
     ).toBe(true);
   });
 
@@ -87,19 +88,19 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     (p.surface as { components: Array<Record<string, unknown>> }).components = [
       { component: 'action.button', id: 'send', label: 'Send', action: { target: 'exchange' } },
     ];
-    expect(validate(p)).toBe(true);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.accepts-an-exchange-targeted-action-the-other-confined-target', 'RFC 0102 §A', 'accepts an exchange-targeted action (the other confined target)')).toBe(true);
   });
 
   it('rejects a payload missing required `catalogVersion`', () => {
     const p = positivePayload();
     delete p.catalogVersion;
-    expect(validate(p), 'RFC 0102 §A: `catalogVersion` is REQUIRED').toBe(false);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.rejects-a-payload-missing-required-catalogversion', 'RFC 0102 §A', 'RFC 0102 §A: `catalogVersion` is REQUIRED')).toBe(false);
   });
 
   it('rejects a payload missing required `surface`', () => {
     const p = positivePayload();
     delete p.surface;
-    expect(validate(p), 'RFC 0102 §A: `surface` is REQUIRED').toBe(false);
+    expect(validate(p), req('openwop.it.a2ui-surface-shape.rejects-a-payload-missing-required-surface', 'RFC 0102 §A', 'RFC 0102 §A: `surface` is REQUIRED')).toBe(false);
   });
 
   it('rejects a `catalogVersion` the schema does not enumerate (unknown version)', () => {
@@ -107,7 +108,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     p.catalogVersion = '9.9.9';
     expect(
       validate(p),
-      'RFC 0102 §A.3: an unadvertised catalogVersion MUST fail the enumerated set',
+      req('openwop.it.a2ui-surface-shape.rejects-a-catalogversion-the-schema-does-not-enumerate-unknown-version', 'RFC 0102 §A', 'RFC 0102 §A.3: an unadvertised catalogVersion MUST fail the enumerated set'),
     ).toBe(false);
   });
 
@@ -118,7 +119,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.1: an out-of-catalog component MUST fail the closed anyOf',
+      req('openwop.it.a2ui-surface-shape.rejects-an-out-of-catalog-component-object-additionalproperties-false', 'RFC 0102 §A', 'RFC 0102 §A.1: an out-of-catalog component MUST fail the closed anyOf'),
     ).toBe(false);
   });
 
@@ -129,7 +130,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.1: additionalProperties:false MUST reject a smuggled code field',
+      req('openwop.it.a2ui-surface-shape.rejects-a-known-component-carrying-an-extra-script-bearing-property', 'RFC 0102 §A', 'RFC 0102 §A.1: additionalProperties:false MUST reject a smuggled code field'),
     ).toBe(false);
   });
 
@@ -140,7 +141,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.4 / SECURITY a2ui-action-confinement: an action target outside resume/exchange MUST be rejected',
+      req('openwop.it.a2ui-surface-shape.rejects-an-action-whose-target-is-outside-enum-resume-exchange-action-confinemen', 'RFC 0102 §A', 'RFC 0102 §A.4 / SECURITY a2ui-action-confinement: an action target outside resume/exchange MUST be rejected'),
     ).toBe(false);
   });
 
@@ -156,7 +157,7 @@ describe('a2ui-surface-shape: schema compile + round-trip (RFC 0102 §A)', () =>
     ];
     expect(
       validate(p),
-      'RFC 0102 §A.4: action additionalProperties:false MUST reject an arbitrary URL target',
+      req('openwop.it.a2ui-surface-shape.rejects-an-action-carrying-an-arbitrary-url-field-no-unconfined-egress-target', 'RFC 0102 §A', 'RFC 0102 §A.4: action additionalProperties:false MUST reject an arbitrary URL target'),
     ).toBe(false);
   });
 });

package/src/scenarios/a2ui-surface-version-refusal.test.ts

@@ -20,6 +20,8 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const schema = JSON.parse(
@@ -42,14 +44,14 @@ describe('a2ui-surface-version-refusal: enumerated catalogVersion (RFC 0102 §A.
     const ok = validate({ catalogVersion: '9.9.9', surface: { components: [] } });
     expect(
       ok,
-      'RFC 0102 §A.3: a catalogVersion outside the host-enumerated set MUST fail (→ unknown_schema_version at runtime)',
+      req('openwop.it.a2ui-surface-version-refusal.catalogversion-is-a-closed-enum-an-unadvertised-version-fails-validation', 'RFC 0102 §A.3', 'RFC 0102 §A.3: a catalogVersion outside the host-enumerated set MUST fail (→ unknown_schema_version at runtime)'),
     ).toBe(false);
   });
 
   it('surface payload is self-contained — no external $ref (replay determinism)', () => {
     expect(
       hasAbsoluteRef(schema),
-      'RFC 0102 §A.3: the surface MUST be self-contained, never a live external-catalog reference',
+      req('openwop.it.a2ui-surface-version-refusal.surface-payload-is-self-contained-no-external-ref-replay-determinism', 'RFC 0102 §A.3', 'RFC 0102 §A.3: the surface MUST be self-contained, never a live external-catalog reference'),
     ).toBe(false);
   });
 });
@@ -67,11 +69,11 @@ describe.skipIf(HTTP_SKIP)('a2ui-surface-version-refusal: live host refuses unad
       },
       hostSupportedEnvelopes: ['ui.a2ui-surface'],
     });
-    if (res.status === 404) return; // seam absent — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
     const body = res.json as { status?: string; reason?: string };
     expect(
       body.status === 'invalid' || body.status === 'refused',
-      driver.describe('RFC 0102 §A.3', 'an unadvertised catalogVersion MUST be refused'),
+      req('openwop.it.a2ui-surface-version-refusal.ui-a2ui-surface-with-an-unadvertised-catalogversion-refused', 'RFC 0102 §A.3', 'an unadvertised catalogVersion MUST be refused'),
     ).toBe(true);
   });
 });

package/src/scenarios/a2ui-untrusted-blocks-approval.test.ts

@@ -21,6 +21,8 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const UNIVERSAL_KINDS = ['clarification.request', 'schema.request', 'schema.response', 'error'];
@@ -29,7 +31,7 @@ describe('a2ui-untrusted-blocks-approval: trust machinery applies (RFC 0102 §A.
   it('ui.a2ui-surface is an advertised kind subject to meta.contentTrust gating (not universal/always-allowed)', () => {
     expect(
       UNIVERSAL_KINDS.includes('ui.a2ui-surface'),
-      'ai-envelope.md §"A2UI surfaces" / §"Trust boundary": a ui.a2ui-surface is trust-gated like any advertised envelope, so an untrusted surface is subject to untrusted_content_blocks_approval',
+      req('openwop.it.a2ui-untrusted-blocks-approval.ui-a2ui-surface-is-an-advertised-kind-subject-to-meta-contenttrust-gating-not-un', 'RFC 0102 §A.5', 'ai-envelope.md §"A2UI surfaces" / §"Trust boundary": a ui.a2ui-surface is trust-gated like any advertised envelope, so an untrusted surface is subject to untrusted_content_blocks_approval'),
     ).toBe(false);
   });
 });
@@ -55,11 +57,11 @@ describe.skipIf(HTTP_SKIP)('a2ui-untrusted-blocks-approval: untrusted surface ca
       hostSupportedEnvelopes: ['ui.a2ui-surface'],
       boundInterruptKind: 'approval',
     });
-    if (res.status === 404) return; // seam absent — soft-skip
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // seam absent — soft-skip
     const body = res.json as { status?: string; reason?: string };
     expect(
       body.status === 'blocked' || (body.reason ?? '').includes('untrusted'),
-      driver.describe(
+      req('openwop.it.a2ui-untrusted-blocks-approval.an-untrusted-marked-ui-a2ui-surface-bound-to-an-approval-interrupt-is-refused', 
         'RFC 0102 §A.5',
         'an untrusted ui.a2ui-surface MUST NOT advance an approval interrupt (untrusted_content_blocks_approval)',
       ),

package/src/scenarios/agent-capability-degraded-projection.test.ts

@@ -26,9 +26,10 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { readManifestRuntimeCap, listManifestAgents } from '../lib/agentRuntime.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface InventoryEntry {
   agentId?: string;
@@ -43,13 +44,13 @@ describe('agent-capability-degraded-projection (RFC 0092 §B)', () => {
     if (!behaviorGate('openwop-agent-capability-degraded', mr?.supported === true)) return;
 
     const inv = await listManifestAgents();
-    if (inv === null) return; // cap advertised but /v1/agents unserved — soft-skip
+    if (inv === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `inv === null` returned early (cap advertised but /v1/agents unserved — soft-skip)'); // cap advertised but /v1/agents unserved — soft-skip
     const agents = (inv.agents ?? []) as InventoryEntry[];
 
     // Non-vacuity: an advertising + serving host MUST expose its inventory.
     expect(
       agents.length >= 1,
-      driver.describe('RFC 0072 §A', 'GET /v1/agents MUST return the installed manifest agents'),
+      req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0072 §A', 'GET /v1/agents MUST return the installed manifest agents'),
     ).toBe(true);
 
     // §B well-formedness on EVERY entry: degraded[], when present, is a unique
@@ -59,18 +60,18 @@ describe('agent-capability-degraded-projection (RFC 0092 §B)', () => {
       if (d !== undefined) {
         expect(
           Array.isArray(d),
-          driver.describe('agent-inventory-response.schema.json', `degraded MUST be an array when present (agent ${a.agentId})`),
+          req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'agent-inventory-response.schema.json', `degraded MUST be an array when present (agent ${a.agentId})`),
         ).toBe(true);
         if (Array.isArray(d)) {
           for (const k of d) {
             expect(
               typeof k === 'string' && k.length > 0,
-              driver.describe('RFC 0072 §C', `degraded[] members MUST be non-empty strings (agent ${a.agentId}, got ${String(k)})`),
+              req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0072 §C', `degraded[] members MUST be non-empty strings (agent ${a.agentId}, got ${String(k)})`),
             ).toBe(true);
           }
           expect(
             new Set(d as string[]).size === d.length,
-            driver.describe('RFC 0092 §B', `degraded[] MUST be unique (agent ${a.agentId})`),
+            req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0092 §B', `degraded[] MUST be unique (agent ${a.agentId})`),
           ).toBe(true);
         }
       }
@@ -82,23 +83,23 @@ describe('agent-capability-degraded-projection (RFC 0092 §B)', () => {
       const target = agents.find((a) => a.agentId === degradedId);
       expect(
         target !== undefined,
-        driver.describe('RFC 0092 §B', `OPENWOP_DEGRADED_CAPABILITY_AGENT_ID=${degradedId} MUST appear in the inventory`),
+        req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0092 §B', `OPENWOP_DEGRADED_CAPABILITY_AGENT_ID=${degradedId} MUST appear in the inventory`),
       ).toBe(true);
       if (target) {
         const d = target.degraded;
         expect(
           Array.isArray(d) && d.length >= 1,
-          driver.describe('RFC 0092 §B', 'the named capability-degraded agent MUST carry a non-empty degraded[]'),
+          req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0092 §B', 'the named capability-degraded agent MUST carry a non-empty degraded[]'),
         ).toBe(true);
         // When the entry also exposes requiresCapabilities, every degraded key
         // MUST be one the agent actually requires (the projection is a subset of
         // requirements, never invented).
         if (Array.isArray(d) && Array.isArray(target.requiresCapabilities)) {
-          const req = new Set(target.requiresCapabilities as unknown[]);
+          const required = new Set(target.requiresCapabilities as unknown[]);
           for (const k of d) {
             expect(
-              req.has(k),
-              driver.describe('RFC 0092 §B', `a degraded[] key MUST be one the agent requires (got ${String(k)})`),
+              required.has(k),
+              req('openwop.it.agent-capability-degraded-projection.surfaces-unmet-requirescapabilities-in-degraded-and-nothing-on-the-rest', 'RFC 0092 §B', `a degraded[] key MUST be one the agent requires (got ${String(k)})`),
             ).toBe(true);
           }
         }

package/src/scenarios/agent-channel-dispatch.test.ts

@@ -43,6 +43,8 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { readDeploymentCap, driveDeploymentTransition } from '../lib/agentDeployment.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const FIXTURE_ID = 'conformance-agent-channel-dispatch';
 const BOUND_CHANNEL = 'stable';
@@ -93,7 +95,7 @@ async function startChannelRun(): Promise<string> {
   const create = await driver.post('/v1/runs', { workflowId: FIXTURE_ID });
   expect(
     create.status,
-    driver.describe(
+    req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
       'agent-deployment.md §B',
       `a host advertising agents.deployment + the ${FIXTURE_ID} fixture MUST accept a channel-bound run (201)`,
     ),
@@ -111,12 +113,12 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
       // Host advertises agents.deployment but hasn't seeded the channel-bound
       // fixture — a host-config precondition, not a conformance failure.
       ctx.skip();
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!isFixtureAdvertised(FIXTURE_ID)` returned early');
     }
     const modes = await fetchReplayModes();
     if (!modes.includes('replay')) {
       ctx.skip();
-      return;
+      return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!modes.includes(\'replay\')` returned early');
     }
 
     // ---- Leg 1: production-path channel resolution + recorded pin (§B) ----
@@ -124,14 +126,14 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
     const started = await firstInvocationStarted(sourceRunId);
     expect(
       started !== null,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         'a @channel-bound run MUST emit agent.invocation.started',
       ),
     ).toBe(true);
     expect(
       started!.payload.resolvedChannel,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         `agent.invocation.started MUST carry the bound channel as resolvedChannel ("${BOUND_CHANNEL}")`,
       ),
@@ -139,7 +141,7 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
     const pinnedVersion = started!.payload.resolvedAgentVersion;
     expect(
       typeof pinnedVersion === 'string' && (pinnedVersion as string).length > 0,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         'a @channel-bound run MUST record a concrete resolvedAgentVersion (the recorded fact a replay re-reads, RFC 0077)',
       ),
@@ -152,22 +154,22 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
     );
     if (forkDeclined(fork1.status, 'channel-dispatch replay fork 1')) {
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `forkDeclined(fork1.status, \'channel-dispatch replay fork 1\')` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(
       fork1.status,
-      driver.describe('rest-endpoints.md POST /v1/runs/{runId}:fork', 'replay fork MUST return 201'),
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 'rest-endpoints.md POST /v1/runs/{runId}:fork', 'replay fork MUST return 201'),
     ).toBe(201);
     const fork1RunId = (fork1.json as { runId: string }).runId;
     await pollUntilTerminal(fork1RunId, { timeoutMs: 15_000 });
     const fork1Started = await firstInvocationStarted(fork1RunId);
     expect(
       fork1Started !== null,
-      driver.describe('agent-deployment.md §B', 'a replay fork MUST re-emit agent.invocation.started'),
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 'agent-deployment.md §B', 'a replay fork MUST re-emit agent.invocation.started'),
     ).toBe(true);
     expect(
       fork1Started!.payload.resolvedAgentVersion,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         'a replay MUST re-read the recorded resolvedAgentVersion (NOT re-resolve the channel)',
       ),
@@ -196,7 +198,7 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
       // evidence; the cross-move proof needs the seam. Honest skip of Leg 3.
       // eslint-disable-next-line no-console
       console.warn('[agent-channel-dispatch] deployment seam absent — skipping the channel-move non-re-resolution leg (Leg 3)');
-      return;
+      return softSkip('blocked', 'precondition not met — `moved === null` returned early ([agent-channel-dispatch] deployment seam absent — skipping the channel-move non-re-resolution leg (Leg 3)) (seam, prior step, or fixture unavailable)');
     }
     // Confirm the move is OBSERVABLE: a fresh channel-bound run must now resolve
     // to a DIFFERENT version. If it doesn't (canary split, no-op promote), we
@@ -207,7 +209,7 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
     if (typeof movedVersion !== 'string' || movedVersion === pinnedVersion) {
       // eslint-disable-next-line no-console
       console.warn('[agent-channel-dispatch] channel did not observably move — skipping Leg 3 strict assertion');
-      return;
+      return softSkip('blocked', 'precondition not met — `typeof movedVersion !== \'string\' || movedVersion === pinnedVersion` returned early ([agent-channel-dispatch] channel did not observably move — skipping Leg 3 strict assertion) (seam, prior step…');
     }
     const fork2 = await driver.post(
       `/v1/runs/${encodeURIComponent(sourceRunId)}:fork`,
@@ -215,25 +217,25 @@ describe.skipIf(HTTP_SKIP)('agent-channel-dispatch (RFC 0082 §B): production ru
     );
     if (forkDeclined(fork2.status, 'channel-dispatch replay fork 2')) {
       ctx.skip();
-      return;
+      return softSkip('blocked', 'precondition not met — `forkDeclined(fork2.status, \'channel-dispatch replay fork 2\')` returned early (seam, prior step, or fixture unavailable)');
     }
     expect(
       fork2.status,
-      driver.describe('rest-endpoints.md POST /v1/runs/{runId}:fork', 'replay fork MUST return 201'),
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 'rest-endpoints.md POST /v1/runs/{runId}:fork', 'replay fork MUST return 201'),
     ).toBe(201);
     const fork2RunId = (fork2.json as { runId: string }).runId;
     await pollUntilTerminal(fork2RunId, { timeoutMs: 15_000 });
     const fork2Started = await firstInvocationStarted(fork2RunId);
     expect(
       fork2Started?.payload.resolvedAgentVersion,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         'after the channel moves, a replay of the original run MUST still carry the ORIGINAL pin — never re-resolving the moved channel',
       ),
     ).toBe(pinnedVersion);
     expect(
       fork2Started?.payload.resolvedAgentVersion,
-      driver.describe(
+      req('openwop.it.agent-channel-dispatch.resolves-records-the-channel-pin-on-a-real-run-and-re-reads-it-on-replay-never-r', 
         'agent-deployment.md §B',
         'a replay MUST NOT resolve to the post-move version (proves the recorded fact is re-read, not re-resolved)',
       ),

package/src/scenarios/agent-deployment-lifecycle.test.ts

@@ -33,7 +33,6 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
-import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import {
@@ -43,6 +42,8 @@ import {
   DEPLOYMENT_CONTENT_FORBIDDEN,
 } from '../lib/agentDeployment.js';
 import { queryTestEvents, requireEvents, isEventLogSeamAvailable, resetTestSeam } from '../lib/event-log-query.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>;
@@ -52,7 +53,7 @@ function expectContentFree(payload: Record<string, unknown>, where: string): voi
   for (const f of DEPLOYMENT_CONTENT_FORBIDDEN) {
     expect(
       !(f in payload),
-      driver.describe('RFC 0082 §D (deployment-event-no-content-leak)', `${where} MUST be content-free (no ${f})`),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'RFC 0082 §D (deployment-event-no-content-leak)', `${where} MUST be content-free (no ${f})`),
     ).toBe(true);
   }
 }
@@ -61,7 +62,7 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
   it('promotes via the eval+RBAC+approval gate, fails closed without scope/eval, and pins the channel version', async () => {
     const cap = await readDeploymentCap();
     if (!behaviorGate('openwop-deployment-lifecycle', cap?.supported === true)) return;
-    if (!(await isEventLogSeamAvailable())) return; // event-log seam absent — soft-skip
+    if (!(await isEventLogSeamAvailable())) return softSkip('blocked', 'precondition not met — `!(await isEventLogSeamAvailable())` returned early (event-log seam absent — soft-skip) (seam, prior step, or fixture unavailable)'); // event-log seam absent — soft-skip
 
     const ajv = new Ajv2020({ strict: false, allErrors: true });
     addFormats(ajv);
@@ -69,22 +70,22 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
 
     // ---- Leg 1: eval+RBAC+approval-gated promotion (§E) ------------------
     const promote = await driveDeploymentTransition({ scenario: 'promote' });
-    if (promote === null) return; // deployment seam unwired — soft-skip the whole behavioral suite
+    if (promote === null) return softSkip('blocked', 'precondition not met — `promote === null` returned early (deployment seam unwired — soft-skip the whole behavioral suite) (seam, prior step, or fixture unavailable)'); // deployment seam unwired — soft-skip the whole behavioral suite
 
     // The host has ADVERTISED agents.deployment AND wired the seam — missing
     // evidence is a FAILURE, not a soft-skip. A successful promote MUST return
     // a runId + a schema-valid record + emit ≥1 content-free deployment.promoted.
     expect(
       typeof promote.runId === 'string' && (promote.runId as string).length > 0,
-      driver.describe('agent-deployment.md §E', 'a wired promote MUST return the runId'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E', 'a wired promote MUST return the runId'),
     ).toBe(true);
     expect(
       promote.record !== undefined && promote.record !== null,
-      driver.describe('agent-deployment.md §E', 'a successful promote MUST return the deployment record'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E', 'a successful promote MUST return the deployment record'),
     ).toBe(true);
     expect(
       validateRecord(promote.record),
-      driver.describe('agent-deployment.schema.json', `a promoted deployment record MUST validate (${ajv.errorsText(validateRecord.errors)})`),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.schema.json', `a promoted deployment record MUST validate (${ajv.errorsText(validateRecord.errors)})`),
     ).toBe(true);
 
     const promotedEvents = requireEvents(
@@ -93,17 +94,17 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
     );
     expect(
       promotedEvents.length >= 1,
-      driver.describe('agent-deployment.md §E', 'a successful promote MUST emit at least one deployment.promoted'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E', 'a successful promote MUST emit at least one deployment.promoted'),
     ).toBe(true);
     for (const e of promotedEvents) {
       expectContentFree(e.payload, 'deployment.promoted');
       expect(
         typeof e.payload.toState === 'string' && DEPLOYMENT_STATES.includes(e.payload.toState as string),
-        driver.describe('run-event-payloads.schema.json#/$defs/deploymentPromoted', 'toState MUST be in the seven-state vocabulary'),
+        req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'run-event-payloads.schema.json#/$defs/deploymentPromoted', 'toState MUST be in the seven-state vocabulary'),
       ).toBe(true);
       expect(
         typeof e.payload.toVersion === 'string' && (e.payload.toVersion as string).length > 0,
-        driver.describe('agent-deployment.md §D', 'deployment.promoted MUST carry the promoted toVersion'),
+        req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §D', 'deployment.promoted MUST carry the promoted toVersion'),
       ).toBe(true);
     }
 
@@ -111,11 +112,11 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
     const unauth = await driveDeploymentTransition({ scenario: 'unauthorized' });
     expect(
       unauth !== null && typeof unauth.runId === 'string' && (unauth.runId as string).length > 0,
-      driver.describe('agent-deployment.md §E-1', 'the unauthorized scenario MUST return a runId to evidence the fail-closed denial'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E-1', 'the unauthorized scenario MUST return a runId to evidence the fail-closed denial'),
     ).toBe(true);
     expect(
       unauth!.allowed !== true,
-      driver.describe('agent-deployment.md §E-1', 'a principal without deploy:promote MUST be denied (fail-closed)'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E-1', 'a principal without deploy:promote MUST be denied (fail-closed)'),
     ).toBe(true);
     const unauthPromoted = requireEvents(
       await queryTestEvents(unauth!.runId as string, { type: 'deployment.promoted' }),
@@ -123,18 +124,18 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
     );
     expect(
       unauthPromoted.length === 0,
-      driver.describe('SECURITY invariant deployment-promotion-fail-closed', 'a denied transition MUST emit NO deployment.promoted'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'SECURITY invariant deployment-promotion-fail-closed', 'a denied transition MUST emit NO deployment.promoted'),
     ).toBe(true);
 
     // ---- Leg 3: eval-gate-unmet denial (§E-3) ----------------------------
     const evalUnmet = await driveDeploymentTransition({ scenario: 'eval-gate-unmet' });
     expect(
       evalUnmet !== null && typeof evalUnmet.runId === 'string' && (evalUnmet.runId as string).length > 0,
-      driver.describe('agent-deployment.md §E-3', 'the eval-gate-unmet scenario MUST return a runId to evidence the denial'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E-3', 'the eval-gate-unmet scenario MUST return a runId to evidence the denial'),
     ).toBe(true);
     expect(
       evalUnmet!.error === 'eval_gate_unmet' || evalUnmet!.allowed !== true,
-      driver.describe('agent-deployment.md §E-3', 'a promote whose eval evidence has passed:false MUST be denied (eval_gate_unmet)'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E-3', 'a promote whose eval evidence has passed:false MUST be denied (eval_gate_unmet)'),
     ).toBe(true);
     const evalUnmetPromoted = requireEvents(
       await queryTestEvents(evalUnmet!.runId as string, { type: 'deployment.promoted' }),
@@ -142,14 +143,14 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
     );
     expect(
       evalUnmetPromoted.length === 0,
-      driver.describe('agent-deployment.md §E-3', 'an unmet eval gate MUST emit NO deployment.promoted'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §E-3', 'an unmet eval gate MUST emit NO deployment.promoted'),
     ).toBe(true);
 
     // ---- Leg 4: channel-resolution pin (§B) ------------------------------
     const pin = await driveDeploymentTransition({ scenario: 'channel-pin', channel: 'stable' });
     expect(
       pin !== null && typeof pin.runId === 'string' && (pin.runId as string).length > 0,
-      driver.describe('agent-deployment.md §B', 'the channel-pin scenario MUST return a runId'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §B', 'the channel-pin scenario MUST return a runId'),
     ).toBe(true);
     const invEvents = requireEvents(
       await queryTestEvents(pin!.runId as string, { type: 'agent.invocation.started' }),
@@ -157,12 +158,12 @@ describe('agent-deployment-lifecycle (RFC 0082 §B/§E)', () => {
     );
     expect(
       invEvents.length >= 1,
-      driver.describe('agent-deployment.md §B', 'a @channel-bound run MUST emit agent.invocation.started'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §B', 'a @channel-bound run MUST emit agent.invocation.started'),
     ).toBe(true);
     const startedInv = invEvents.sort((a, b) => a.sequence - b.sequence)[0]!;
     expect(
       typeof startedInv.payload.resolvedAgentVersion === 'string' && (startedInv.payload.resolvedAgentVersion as string).length > 0,
-      driver.describe('agent-deployment.md §B', 'a @channel-bound run MUST record resolvedAgentVersion on agent.invocation.started (the recorded fact a replay re-reads)'),
+      req('openwop.it.agent-deployment-lifecycle.promotes-via-the-eval-rbac-approval-gate-fails-closed-without-scope-eval-and-pin', 'agent-deployment.md §B', 'a @channel-bound run MUST record resolvedAgentVersion on agent.invocation.started (the recorded fact a replay re-reads)'),
     ).toBe(true);
 
     await resetTestSeam();