@openwop/openwop-conformance 2.45.0 → 2.45.2

package/src/scenarios/interrupt-approval.test.ts

@@ -12,6 +12,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const WORKFLOW_ID = 'conformance-approval';
 const NODE_ID = 'gate';
@@ -23,8 +24,21 @@ const SKIP_NO_REFINE = !isFixtureAdvertised(REFINE_WORKFLOW_ID);
 const EDIT_ACCEPT_WORKFLOW_ID = 'conformance-approval-edit-accept';
 const SKIP_NO_EDIT_ACCEPT = !isFixtureAdvertised(EDIT_ACCEPT_WORKFLOW_ID);
 
-describe.skipIf(SKIP_NO_FIXTURE)('interrupt: approval accept resumes to `completed`', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY_2: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(REFINE_WORKFLOW_ID)) ? ['blocked', `the \`${REFINE_WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY_3: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(EDIT_ACCEPT_WORKFLOW_ID)) ? ['blocked', `the \`${EDIT_ACCEPT_WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt: approval accept resumes to `completed`', () => {
   it('run suspends at gate, accept resolution drives terminal completed', async () => {
+    if (SKIP_NO_FIXTURE) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -52,8 +66,9 @@ describe.skipIf(SKIP_NO_FIXTURE)('interrupt: approval accept resumes to `complet
   });
 });
 
-describe.skipIf(SKIP_NO_FIXTURE)('interrupt: invalid resolve payload rejected per resumeSchema', () => {
+describe('interrupt: invalid resolve payload rejected per resumeSchema', () => {
   it('400 (or 422) when action is not in {accept, reject}', async () => {
+    if (SKIP_NO_FIXTURE) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -80,8 +95,9 @@ describe.skipIf(SKIP_NO_FIXTURE)('interrupt: invalid resolve payload rejected pe
   });
 });
 
-describe.skipIf(SKIP_NO_FIXTURE)('interrupt: resolving an unknown interrupt returns 404', () => {
+describe('interrupt: resolving an unknown interrupt returns 404', () => {
   it('400/404 when nodeId does not match an active interrupt', async () => {
+    if (SKIP_NO_FIXTURE) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -116,8 +132,9 @@ describe.skipIf(SKIP_NO_FIXTURE)('interrupt: resolving an unknown interrupt retu
  * adding `refine` to that fixture's `actions` would change a registered workflow
  * definition every host already serves.
  */
-describe.skipIf(SKIP_NO_REFINE)('interrupt: refine resolution carries action + refineFeedback (RFC 0183)', () => {
+describe('interrupt: refine resolution carries action + refineFeedback (RFC 0183)', () => {
   it('a refine resolve round-trips `action` and the structured feedback it requires', async () => {
+    if (SKIP_NO_REFINE) return softSkip(...GATE_WHY_2);
     const create = await driver.post('/v1/runs', { workflowId: REFINE_WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -168,6 +185,7 @@ describe.skipIf(SKIP_NO_REFINE)('interrupt: refine resolution carries action + r
   });
 
   it('refuses a refine resolution that supplies no refineFeedback', async () => {
+    if (SKIP_NO_REFINE) return softSkip(...GATE_WHY_2);
     const create = await driver.post('/v1/runs', { workflowId: REFINE_WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -193,8 +211,9 @@ describe.skipIf(SKIP_NO_REFINE)('interrupt: refine resolution carries action + r
  * witnesses one of §A.2's two conditional MUSTs; until this block the other was
  * stated in `spec/v2/core/interrupt.md` §Approval and witnessed nowhere.
  */
-describe.skipIf(SKIP_NO_EDIT_ACCEPT)('interrupt: edit-accept resolution carries action + editedArtifactData (RFC 0183)', () => {
+describe('interrupt: edit-accept resolution carries action + editedArtifactData (RFC 0183)', () => {
   it('an edit-accept resolve round-trips `action` and the edited artifact it requires', async () => {
+    if (SKIP_NO_EDIT_ACCEPT) return softSkip(...GATE_WHY_3);
     const create = await driver.post('/v1/runs', { workflowId: EDIT_ACCEPT_WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -245,6 +264,7 @@ describe.skipIf(SKIP_NO_EDIT_ACCEPT)('interrupt: edit-accept resolution carries
   });
 
   it('refuses an edit-accept resolution that supplies no editedArtifactData', async () => {
+    if (SKIP_NO_EDIT_ACCEPT) return softSkip(...GATE_WHY_3);
     const create = await driver.post('/v1/runs', { workflowId: EDIT_ACCEPT_WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/interrupt-auth-required-resume.test.ts

@@ -24,14 +24,19 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const WORKFLOW_ID = 'conformance-interrupt-auth-required';
 const NODE_ID = 'gate';
 const SKIP = !isFixtureAdvertised(WORKFLOW_ID);
 
-describe.skipIf(SKIP)('interrupt: auth-required — bearer resume succeeds', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt: auth-required — bearer resume succeeds', () => {
   it('valid bearer with approvals:respond drives terminal completed', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -53,8 +58,9 @@ describe.skipIf(SKIP)('interrupt: auth-required — bearer resume succeeds', ()
   });
 });
 
-describe.skipIf(SKIP)('interrupt: auth-required — insufficient scope returns 403', () => {
+describe('interrupt: auth-required — insufficient scope returns 403', () => {
   it('bearer without approvals:respond scope is rejected', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // This scenario requires a separate test-only credential that lacks
     // `approvals:respond`. Drivers wire it via the OPENWOP_TEST_LOW_SCOPE_KEY
     // env var; when absent the test skips (rather than passing trivially).

package/src/scenarios/interrupt-external-event-correlation.test.ts

@@ -23,6 +23,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const WORKFLOW_ID = 'conformance-interrupt-external-event';
 const SKIP = !isFixtureAdvertised(WORKFLOW_ID);
@@ -43,8 +44,13 @@ async function fetchInterruptToken(runId: string): Promise<string | null> {
   return null;
 }
 
-describe.skipIf(SKIP)('interrupt: external-event — matching correlation resumes', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt: external-event — matching correlation resumes', () => {
   it('signed-token POST with matching correlation drives terminal completed', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -78,8 +84,9 @@ describe.skipIf(SKIP)('interrupt: external-event — matching correlation resume
   });
 });
 
-describe.skipIf(SKIP)('interrupt: external-event — mismatched correlation rejected', () => {
+describe('interrupt: external-event — mismatched correlation rejected', () => {
   it('correlation mismatch returns 422 and leaves run suspended', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/interrupt-parent-child-cascade.test.ts

@@ -22,6 +22,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const PARENT_WORKFLOW = 'conformance-interrupt-parent-child-cancel';
 const CHILD_WORKFLOW = 'conformance-interrupt-parent-child-cancel-child';
@@ -41,8 +42,14 @@ async function findChildRunId(parentRunId: string): Promise<string | null> {
   return child?.runId ?? null;
 }
 
-describe.skipIf(SKIP)('interrupt: parent/child — parent cancel cascades to child', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(PARENT_WORKFLOW)) ? ['blocked', `the \`${PARENT_WORKFLOW}\` fixture is not advertised`] as const : 
+  (!isFixtureAdvertised(CHILD_WORKFLOW)) ? ['blocked', `the \`${CHILD_WORKFLOW}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt: parent/child — parent cancel cascades to child', () => {
   it('child transitions to cancelled when parent is cancelled mid-suspend', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: PARENT_WORKFLOW });
     expect(create.status).toBe(201);
     const parentRunId = (create.json as { runId: string }).runId;
@@ -73,8 +80,9 @@ describe.skipIf(SKIP)('interrupt: parent/child — parent cancel cascades to chi
   });
 });
 
-describe.skipIf(SKIP)('interrupt: parent/child — post-cascade resolve of child returns 410/409', () => {
+describe('interrupt: parent/child — post-cascade resolve of child returns 410/409', () => {
   it('attempting to resolve the cascaded child interrupt is rejected', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: PARENT_WORKFLOW });
     expect(create.status).toBe(201);
     const parentRunId = (create.json as { runId: string }).runId;

package/src/scenarios/interrupt-quorum-resolution.test.ts

@@ -22,6 +22,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 // Profile gating: a host claims `openwop-interrupt-quorum` support by
 // advertising the fixture. Hosts that don't support quorum semantics
@@ -30,8 +31,13 @@ const WORKFLOW_ID = 'conformance-interrupt-quorum';
 const NODE_ID = 'gate';
 const SKIP = !isFixtureAdvertised(WORKFLOW_ID);
 
-describe.skipIf(SKIP)('interrupt: quorum — three accepts resume to completed', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt: quorum — three accepts resume to completed', () => {
   it('first two accepts persist without resuming; third accept drives terminal completed', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;
@@ -72,8 +78,9 @@ describe.skipIf(SKIP)('interrupt: quorum — three accepts resume to completed',
   });
 });
 
-describe.skipIf(SKIP)('interrupt: quorum — majority reject fails the gate', () => {
+describe('interrupt: quorum — majority reject fails the gate', () => {
   it('two rejects out of three votes trigger the majority-reject termination', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/interrupt-token-matrix.test.ts

@@ -31,7 +31,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilStatus } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
-import { blockedDespiteAssertions } from '../lib/soft-skip.js';
+import { blockedDespiteAssertions, softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const FIXTURE = 'conformance-interrupt-external-event';
 const SKIP = !isFixtureAdvertised(FIXTURE);
@@ -42,8 +42,13 @@ function randomBytesB64(length: number): string {
   ).toString('base64url');
 }
 
-describe.skipIf(SKIP)('interrupt-token-matrix: GET /v1/interrupts/{token} negative paths', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt-token-matrix: GET /v1/interrupts/{token} negative paths', () => {
   it('malformed token returns 400 or 404 (NEVER 200)', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const malformed = '!!!not-a-valid-token!!!';
     const res = await driver.get(`/v1/interrupts/${encodeURIComponent(malformed)}`);
     expect([400, 404]).toContain(res.status);
@@ -54,6 +59,7 @@ describe.skipIf(SKIP)('interrupt-token-matrix: GET /v1/interrupts/{token} negati
   });
 
   it('well-formed but unknown token returns 404', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // Plausibly-shaped opaque token that the host has no record of.
     const unknown = `tok_${randomBytesB64(32)}`;
     const res = await driver.get(`/v1/interrupts/${encodeURIComponent(unknown)}`);
@@ -64,8 +70,9 @@ describe.skipIf(SKIP)('interrupt-token-matrix: GET /v1/interrupts/{token} negati
   });
 });
 
-describe.skipIf(SKIP)('interrupt-token-matrix: POST /v1/interrupts/{token} negative paths', () => {
+describe('interrupt-token-matrix: POST /v1/interrupts/{token} negative paths', () => {
   it('replay after successful resolve returns 409 or 404', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // Drive a run to suspension; capture the real token; resolve once;
     // replay the same POST and assert it doesn't succeed twice.
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
@@ -129,6 +136,7 @@ describe.skipIf(SKIP)('interrupt-token-matrix: POST /v1/interrupts/{token} negat
   });
 
   it('unknown token returns 404 on POST', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const unknown = `tok_${randomBytesB64(32)}`;
     const res = await driver.post(`/v1/interrupts/${encodeURIComponent(unknown)}`, {
       correlation: { orderId: 'noop', status: 'whatever' },

package/src/scenarios/interruptRace.test.ts

@@ -24,7 +24,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntil } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const APPROVAL_WORKFLOW_ID = 'conformance-approval';
 const NOOP_WORKFLOW_ID = 'conformance-noop';
@@ -43,10 +43,19 @@ async function hostClaimsInterrupts(): Promise<boolean> {
   return (body.supportedEnvelopes as string[]).includes('clarification.request');
 }
 
-describe.skipIf(SKIP_NO_APPROVAL)('interrupt-race: concurrent cancel + resolve dispatch deterministically', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(APPROVAL_WORKFLOW_ID)) ? ['blocked', `the \`${APPROVAL_WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY_2: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(NOOP_WORKFLOW_ID)) ? ['blocked', `the \`${NOOP_WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('interrupt-race: concurrent cancel + resolve dispatch deterministically', () => {
   it(
     'concurrent cancel + interrupt-resolve resolves to one of: cancelled or completed',
     async () => {
+    if (SKIP_NO_APPROVAL) return softSkip(...GATE_WHY);
       if (!(await hostClaimsInterrupts())) return softSkip('blocked', 'precondition not met — `!(await hostClaimsInterrupts())` returned early (skip-equivalent) (seam, prior step, or fixture unavailable)'); // skip-equivalent
 
       // Phase 1: start a workflow that suspends at an approval gate.
@@ -155,8 +164,9 @@ describe.skipIf(SKIP_NO_APPROVAL)('interrupt-race: concurrent cancel + resolve d
   );
 });
 
-describe.skipIf(SKIP_NO_NOOP)('interrupt-race: cancel against a non-suspended run is well-formed', () => {
+describe('interrupt-race: cancel against a non-suspended run is well-formed', () => {
   it('cancel of a completed run returns 200 with the existing terminal status (idempotent)', async () => {
+    if (SKIP_NO_NOOP) return softSkip(...GATE_WHY_2);
     // Self-test that doesn't require a race. Runs against any host
     // that supports cancel (every conforming host does).
     const create = await driver.post('/v1/runs', { workflowId: 'conformance-noop' });

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

@@ -47,7 +47,7 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { pollUntil } from '../lib/polling.js';
@@ -83,8 +83,13 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
   }
 }
 
-describe.skipIf(HTTP_SKIP)('multi-agent-confidence-escalation: capability shape (RFC 0039 §A)', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!process.env.OPENWOP_BASE_URL) ? ['inapplicable', `no target: OPENWOP_BASE_URL is unset`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('multi-agent-confidence-escalation: capability shape (RFC 0039 §A)', () => {
   it('confidenceEscalationFloor (when advertised) MUST be in [0.5, 1.0]', async () => {
+    if (HTTP_SKIP) return softSkip(...GATE_WHY);
     const d = await readDiscovery();
     if (d === null) return softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
     const em = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel;
@@ -101,8 +106,14 @@ describe.skipIf(HTTP_SKIP)('multi-agent-confidence-escalation: capability shape
   });
 });
 
-describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral (RFC 0039 §A)', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY_2: readonly [SoftSkipKind, string] =
+  (!process.env.OPENWOP_BASE_URL) ? ['inapplicable', `no target: OPENWOP_BASE_URL is unset`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('multi-agent-confidence-escalation: behavioral (RFC 0039 §A)', () => {
   it('happy-path: low-confidence decision → confidence-escalated event + clarification interrupt + zero dispatch events', async () => {
+    if (BEHAVIORAL_SKIP) return softSkip(...GATE_WHY_2);
     const d = await readDiscovery();
     const supported = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.supported === true;
     const versionRaw = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.version;

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

@@ -31,7 +31,7 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 import { driver } from '../lib/driver.js';
 import { executionModelVersionMax } from '../lib/execution-model-version.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
@@ -62,8 +62,13 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
   }
 }
 
-describe.skipIf(HTTP_SKIP)('multi-agent-handoff-state-machine: advertisement shape (RFC 0037 §C)', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!process.env.OPENWOP_BASE_URL) ? ['inapplicable', `no target: OPENWOP_BASE_URL is unset`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('multi-agent-handoff-state-machine: advertisement shape (RFC 0037 §C)', () => {
   it('capabilities.multiAgent.executionModel (when present) conforms to RFC 0037 §C', async () => {
+    if (HTTP_SKIP) return softSkip(...GATE_WHY);
     const d = await readDiscovery();
     if (d === null) return softSkip('blocked', 'discovery unavailable — skip (d === null)');
     const executionModel = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel;
@@ -108,8 +113,15 @@ const PARENT_FIXTURE = 'conformance-multi-agent-handoff';
 const CHILD_FIXTURE = 'conformance-multi-agent-handoff-child';
 const BEHAVIORAL_SKIP = HTTP_SKIP || !isFixtureAdvertised(PARENT_FIXTURE) || !isFixtureAdvertised(CHILD_FIXTURE);
 
-describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral 4-event causation chain (RFC 0037 §"Handoff state machine")', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY_2: readonly [SoftSkipKind, string] =
+  (!process.env.OPENWOP_BASE_URL) ? ['inapplicable', `no target: OPENWOP_BASE_URL is unset`] as const : 
+  (!isFixtureAdvertised(PARENT_FIXTURE)) ? ['blocked', `the \`${PARENT_FIXTURE}\` fixture is not advertised`] as const : 
+  (!isFixtureAdvertised(CHILD_FIXTURE)) ? ['blocked', `the \`${CHILD_FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('multi-agent-handoff-state-machine: behavioral 4-event causation chain (RFC 0037 §"Handoff state machine")', () => {
   it('happy-path: dispatch.began → dispatch.succeeded → child.completed → output.harvested fire in causation order', async () => {
+    if (BEHAVIORAL_SKIP) return softSkip(...GATE_WHY_2);
     const d = await readDiscovery();
     const advertised = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.supported === true;
     if (!advertised) return softSkip('inapplicable', 'soft-skip — host honest about not implementing');

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

@@ -15,6 +15,7 @@ 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';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const WORKFLOW_ID = 'conformance-multi-node';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -27,8 +28,13 @@ interface RunEvent {
   readonly sequence: number;
 }
 
-describe.skipIf(SKIP_NO_FIXTURE)('multi-node: conformance-multi-node fixture emits node.completed in topological order', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('multi-node: conformance-multi-node fixture emits node.completed in topological order', () => {
   it('a, b, c node.completed events arrive in DAG order by sequence', async () => {
+    if (SKIP_NO_FIXTURE) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/node-failed-payload-shape.test.ts

@@ -26,6 +26,7 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const WORKFLOW_ID = 'conformance-failure';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -41,8 +42,13 @@ function nodeFailedValidator() {
   return ajv.compile(schema);
 }
 
-describe.skipIf(SKIP_NO_FIXTURE)('run-event-payloads.schema.json §nodeFailed — node.failed carries a structured error object', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(WORKFLOW_ID)) ? ['blocked', `the \`${WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('run-event-payloads.schema.json §nodeFailed — node.failed carries a structured error object', () => {
   it('every node.failed on the conformance-failure run validates against §nodeFailed (error: { code, message } is an object, not a string)', async () => {
+    if (SKIP_NO_FIXTURE) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(create.status, req('openwop.it.node-failed-payload-shape.every-node-failed-on-the-conformance-failure-run-validates-against-nodefailed-er', 'rest-endpoints.md', 'POST /v1/runs MUST return 201 for the failing fixture')).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/orchestratorConservativePath.test.ts

@@ -23,12 +23,19 @@ import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isOrchestratorSupported } from '../lib/multi-agent-capabilities.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const FIXTURE = 'conformance-orchestrator-low-confidence';
 const SKIP = !isOrchestratorSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('orchestratorConservativePath: CP-1 low-confidence suspend', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isOrchestratorSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isOrchestratorSupported() is false)`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('orchestratorConservativePath: CP-1 low-confidence suspend', () => {
   it('supervisor below threshold suspends with reason=low-confidence; ratified decision follows after resume', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/orchestratorDispatch.test.ts

@@ -28,6 +28,7 @@ import {
   isDispatchSupported,
 } from '../lib/multi-agent-capabilities.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const FIXTURE = 'conformance-orchestrator-dispatch';
 const SKIP =
@@ -35,8 +36,15 @@ const SKIP =
   !isDispatchSupported() ||
   !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('orchestratorDispatch: supervisor → dispatch → next-worker', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isOrchestratorSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isOrchestratorSupported() is false)`] as const : 
+  (!isDispatchSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isDispatchSupported() is false)`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('orchestratorDispatch: supervisor → dispatch → next-worker', () => {
   it('emits runOrchestrator.decided{next-worker} between supervisor + dispatch', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
     expect(create.status).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/orchestratorTermination.test.ts

@@ -21,12 +21,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isOrchestratorSupported } from '../lib/multi-agent-capabilities.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const FIXTURE = 'conformance-orchestrator-terminate';
 const SKIP = !isOrchestratorSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('orchestratorTermination: terminate decision → run.completed (CO-3)', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isOrchestratorSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isOrchestratorSupported() is false)`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('orchestratorTermination: terminate decision → run.completed (CO-3)', () => {
   it('terminate is the final orchestrator decision; run completes cleanly', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
     expect(create.status, req('openwop.it.orchestratorTermination.terminate-is-the-final-orchestrator-decision-run-completes-cleanly', 'RFCS/0006-orchestrator.md', 'terminate is the final orchestrator decision; run completes cleanly')).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/owner-subject-echo.test.ts

@@ -17,7 +17,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 import { pollUntil } from '../lib/polling.js';
 import { req } from '../lib/requirement-ids.js';
 
@@ -81,8 +81,13 @@ function actorDepth(s: Subject | undefined): number {
   return d;
 }
 
-describe.skipIf(SKIP_NO_NOOP)('owner-subject-echo: consistency, echo, fork (RFC 0165 §B — gated on a host that emits owner.subject)', () => {
+/** Why the gate below holds, as RFC 0148 §A names it (openwop#1686: a describe-level skip recorded no disposition). */
+const GATE_WHY: readonly [SoftSkipKind, string] =
+  (!isFixtureAdvertised(NOOP_WORKFLOW_ID)) ? ['blocked', `the \`${NOOP_WORKFLOW_ID}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('owner-subject-echo: consistency, echo, fork (RFC 0165 §B — gated on a host that emits owner.subject)', () => {
   it('subject is consistent with the owner triple (§B.2) and the actor chain is bounded (§B.5)', async () => {
+    if (SKIP_NO_NOOP) return softSkip(...GATE_WHY);
     const runId = await createRun();
     const snap = await snapshot(runId);
     const subject = snap.owner?.subject;
@@ -105,6 +110,7 @@ describe.skipIf(SKIP_NO_NOOP)('owner-subject-echo: consistency, echo, fork (RFC
   });
 
   it('run.started echoes the snapshot subject verbatim (§B.2, RFC 0048 §C)', async () => {
+    if (SKIP_NO_NOOP) return softSkip(...GATE_WHY);
     const runId = await createRun();
     const snap = await snapshot(runId);
     if (snap.owner?.subject === undefined) {
@@ -122,6 +128,7 @@ describe.skipIf(SKIP_NO_NOOP)('owner-subject-echo: consistency, echo, fork (RFC
   });
 
   it('a fork copies owner.tenant and owner.subject verbatim onto the child (§B.4)', async () => {
+    if (SKIP_NO_NOOP) return softSkip(...GATE_WHY);
     const sourceRunId = await createRun();
     const source = await snapshot(sourceRunId);
     if (source.owner?.subject === undefined) {