@openwop/openwop-conformance 2.45.0 → 2.45.1

package/schemas/CORPUS-STAMP.json

@@ -1,17 +1,17 @@
 {
   "_comment": "Provenance of @openwop/spec-artifacts (RFC 0168 §D.2). files: SHA-256 per file; the conformance suite compares the installed peer against dist/spec-artifacts.lock.json at start.",
   "package": "@openwop/spec-artifacts",
-  "version": "2.45.0",
-  "corpusTag": "v2.45.0",
+  "version": "2.45.1",
+  "corpusTag": "v2.45.1",
   "files": {
     "api/.redocly.lint-ignore.yaml": "bf5a8350b88a72fa43f59605ed8d903ed24b6cfccda5e45509c9f6ed9ee4e712",
     "api/asyncapi.yaml": "d5ecb9ee6114582be3b1f662c84bfac9ae96dae7bacb853e461168f70a8e1c7d",
     "api/grpc/openwop.proto": "c3e72bb17cba514ee98feb6434e6c9b6ea6795bfd086489ec69fd882dd1ad977",
     "api/openapi.yaml": "69464bc0e1e71ef3b543a73d4fa4f67202343d2603c80af8033f6c3619ef1b30",
     "api/redocly.yaml": "b0604c89b2ca6d5076ec25725c539dad44a741a811fe524439ee6daef8baa09f",
-    "api/seams-v2.yaml": "92744ab58f83798c63b96700475bd55c201e7af14c3fd230c31ab0bbd86f6a60",
-    "api/v2/asyncapi.yaml": "4f00d2847c3ffb526af9c294f9e318b762f197e86cfd607934e677f12a1fc8bc",
-    "api/v2/openapi.yaml": "396fe10fc350cbae59190c4bd0e4cd24e18b16b4aac9db2f6c78e54344db4709",
+    "api/seams-v2.yaml": "c2d7c5d68c7358229149d2552da95e32798b9c21b21a56e19d561f29eab3633e",
+    "api/v2/asyncapi.yaml": "e9c0e3cc27f8d72a6f7704de24cb81f39175b8e6bc3ae5e4ad87d46fb0be6b0c",
+    "api/v2/openapi.yaml": "622817c49d5977b51bb83685e6cb0fe27a5e087b63c3a31621959670d6829a2d",
     "api/v2/redocly.yaml": "1e66b60e6118ad11a823bb620678be464d99dfe50a40e3e6f93ec9429b88b34c",
     "schemas/README.md": "0c0b737ffcf8f30e7d2809cec8a498232de710f41443212922ad8337cdde0b51",
     "schemas/a2a-task-state.schema.json": "75d5049dea8bd873ff0e7546f1c60c8d36c219bec7084264360be54a8be30ae1",
@@ -204,7 +204,7 @@
     "schemas/workspace-file.schema.json": "464de85c2a068243084ee9c1d969bc7cd5d8f7948574e58450d6493c38a0e1e4",
     "spec/v1/alias-detectors.json": "0b2f28808ffe0b9d98a187775038c3406bb70919747a788a6e4f866e293ae6d3",
     "spec/v1/capability-declaration-classes.json": "e7729aed5c4b4e1dd02abab0530f14cc95f5d4070fe51fb139e7f5cccefa00c6",
-    "spec/v1/core-standard-manifest.json": "684dff535d3536673129ef594b97717cbc30fd066a6ea4d2c52d9fbbde69836d",
+    "spec/v1/core-standard-manifest.json": "4aa1dbeec20dc51fb727ad85e2012af1235bac608e41836db256e7816916f898",
     "spec/v1/deprecations.json": "a3293072ea951857395d05f0437264e88965f1e9019ff61c55bacfa9c1aaa17c",
     "spec/v1/deprecations.schema.json": "3e393c405d2a41b467d8c5e3c468549078df1ce6a6d2588fc488097b95d9b55b",
     "spec/v1/event-codemap.json": "3da60d884157793a360da532a9fcbbfb5285636db325a74cec94b34622186d97",
@@ -303,9 +303,9 @@
     "spec/v2/path-manifest.json": "27c2307b84376b2f22bea4e2213fc7e33ef3bf8fd1d18039f7955edb00dc9c9a",
     "spec/v2/peer-dependency-aliases.json": "d10299280abee08258502925bc327293ee413e0108cd6e6ec75ff6110653308d",
     "spec/v2/profiles.json": "180beb9ef2d161766fa23b2987e7e829851e3d316273147cf6a4a3f324befd6b",
-    "spec/v2/release.json": "89c093ee04d4aaceef641782e53fbc368e21123e244246f1727fa8ac3b151101",
+    "spec/v2/release.json": "e6a344ecc48e172a585fafeb83631c26629373e847b144a86cc01628693ea3ad",
     "spec/v2/retention-floors.json": "eaf3722d95c79947af1d4269ef85117e126518c588cfcf1a2b21b97269f51624",
-    "spec/v2/surface-baseline.json": "85c44cc57bfc9f8242e77dc27d7b28a1b239c694ef761cce4748ab15d6a3290f"
+    "spec/v2/surface-baseline.json": "b70b9f22313a99ea4853f8ffee1c4f6659b89e8cbba7317c52771fe9dfd40330"
   },
-  "corpusCommit": "1ac68fd60069d0b9729312976de4946171281f87"
+  "corpusCommit": "11a23de713fd4d56d9514a753d25229b029fb461"
 }

package/src/lib/run-list-walk.ts

@@ -0,0 +1,65 @@
+/**
+ * The `GET /runs` walk the RFC 0182 run-list legs use (`v2-run-list.test.ts`).
+ *
+ * The list is newest first (`runs.md` §List), so the runs a leg just created
+ * sit on the first page. The walk therefore stops once every wanted id has
+ * been seen, then follows `nextCursor` for a bounded tail (`tailPages`, or
+ * until the list ends) so a host-minted cursor is still exercised. It never
+ * walks the whole history: on a long-lived host the conformance tenant holds
+ * thousands of runs, and a full walk outran the test timeout (openwop-app,
+ * 2026-09-29), failing a leg on the tenant's age rather than the host's
+ * behaviour.
+ *
+ * Pure: the page fetch is injected, so the walk is self-tested without a host.
+ */
+
+export type RunListPage = { runs?: unknown; nextCursor?: unknown };
+
+export type FetchPage = (cursor: string | undefined) => Promise<{ page: RunListPage } | { reason: string }>;
+
+export interface WalkResult {
+  /** Every runId seen, in list order. */
+  readonly ids: string[];
+  readonly pages: RunListPage[];
+  /** True when every wanted id was seen. */
+  readonly foundAll: boolean;
+  /** Why the walk stopped early (fetch failure or the page cap), if it did. */
+  readonly reason?: string;
+}
+
+export interface WalkOptions {
+  /** Ids the leg created and expects to find. */
+  readonly want: readonly string[];
+  /** Pages still followed after every wanted id is seen (default 2). */
+  readonly tailPages?: number;
+  /** Hard cap on pages fetched while searching (default 50). */
+  readonly maxPages?: number;
+}
+
+export async function walkRunList(fetchPage: FetchPage, opts: WalkOptions): Promise<WalkResult> {
+  const tailPages = opts.tailPages ?? 2;
+  const maxPages = opts.maxPages ?? 50;
+  const wanted = new Set(opts.want);
+  const ids: string[] = [];
+  const pages: RunListPage[] = [];
+  let cursor: string | undefined;
+  let tailLeft: number | undefined; // set once every wanted id is seen
+  for (let i = 0; i < maxPages + tailPages; i++) {
+    if (tailLeft === undefined && i >= maxPages) {
+      return { ids, pages, foundAll: false, reason: `the wanted id(s) did not appear within ${maxPages} page(s)` };
+    }
+    const got = await fetchPage(cursor);
+    if ('reason' in got) return { ids, pages, foundAll: [...wanted].every((w) => ids.includes(w)), reason: got.reason };
+    pages.push(got.page);
+    for (const r of Array.isArray(got.page.runs) ? got.page.runs : []) {
+      const id = (r as { runId?: unknown }).runId;
+      if (typeof id === 'string') ids.push(id);
+    }
+    if (tailLeft === undefined && [...wanted].every((w) => ids.includes(w))) tailLeft = tailPages;
+    else if (tailLeft !== undefined) tailLeft -= 1;
+    if (typeof got.page.nextCursor !== 'string') break;
+    if (tailLeft !== undefined && tailLeft <= 0) break;
+    cursor = got.page.nextCursor;
+  }
+  return { ids, pages, foundAll: [...wanted].every((w) => ids.includes(w)) };
+}

package/src/scenarios/agentConfidenceEscalation.test.ts

@@ -22,12 +22,19 @@ import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } 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-agent-low-confidence';
 const SKIP = !isAgentSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentConfidenceEscalation: confidence < threshold → 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentConfidenceEscalation: confidence < threshold → low-confidence suspend', () => {
   it('low-confidence agent.decided suspends with reason=low-confidence and run reaches waiting-approval', 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/agentMemoryCrossTenantIsolation.test.ts

@@ -21,12 +21,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { hasLongTermMemory } 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-agent-memory-cross-tenant';
 const SKIP = !hasLongTermMemory() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMemoryCrossTenantIsolation: CTI-1 invariant', () => {
+/** 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] =
+  (!hasLongTermMemory()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (hasLongTermMemory() 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('agentMemoryCrossTenantIsolation: CTI-1 invariant', () => {
   it('cross-tenant memoryRef returns empty / null — no leak across tenant boundary', 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/agentMemoryRedactionContract.test.ts

@@ -21,12 +21,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { hasLongTermMemory } 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-agent-memory-redaction';
 const SKIP = !hasLongTermMemory() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMemoryRedactionContract: SR-1 invariant', () => {
+/** 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] =
+  (!hasLongTermMemory()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (hasLongTermMemory() 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('agentMemoryRedactionContract: SR-1 invariant', () => {
   it('BYOK plaintext is redacted to [REDACTED:<secretId>] at the read surface', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
     expect(create.status, req('openwop.it.agentMemoryRedactionContract.byok-plaintext-is-redacted-to-redacted-secretid-at-the-read-surface', 'RFCS/0004-memory-layer.md', 'BYOK plaintext is redacted to [REDACTED:<secretId>] at the read surface')).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/agentMemoryRoundTrip.test.ts

@@ -20,12 +20,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { hasLongTermMemory } 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-agent-memory-roundtrip';
 const SKIP = !hasLongTermMemory() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMemoryRoundTrip: write → read via MemoryAdapter', () => {
+/** 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] =
+  (!hasLongTermMemory()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (hasLongTermMemory() 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('agentMemoryRoundTrip: write → read via MemoryAdapter', () => {
   it('memory entries written during a run are readable via the resolved memoryRef', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE });
     expect(create.status, req('openwop.it.agentMemoryRoundTrip.memory-entries-written-during-a-run-are-readable-via-the-resolved-memoryref', 'RFCS/0004-memory-layer.md', 'memory entries written during a run are readable via the resolved memoryRef')).toBe(201);
     const runId = (create.json as { runId: string }).runId;

package/src/scenarios/agentMemoryTtlExpiry.test.ts

@@ -19,12 +19,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { hasLongTermMemory } 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-agent-memory-ttl';
 const SKIP = !hasLongTermMemory() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMemoryTtlExpiry: expired entries are excluded from list/get', () => {
+/** 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] =
+  (!hasLongTermMemory()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (hasLongTermMemory() 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('agentMemoryTtlExpiry: expired entries are excluded from list/get', () => {
   it('list() excludes entries whose expiresAt is in the past', 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/agentMessageReducer.test.ts

@@ -24,12 +24,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } 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-message-reducer';
 const SKIP = !isAgentSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMessageReducer: message reducer idempotency + append-only invariant', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentMessageReducer: message reducer idempotency + append-only invariant', () => {
   it('duplicate messageId emissions fold to a single channel entry', 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/agentMetadata.test.ts

@@ -24,12 +24,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } 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-agent-identity';
 const SKIP = !isAgentSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentMetadata: RunSnapshot.agent + runOrchestrator wire-shape', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentMetadata: RunSnapshot.agent + runOrchestrator wire-shape', () => {
   it('host populates AgentRef-shaped agent identity on RunSnapshot', 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/agentPackCatalog.test.ts

@@ -32,7 +32,7 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { isAgentSupported } from '../lib/multi-agent-capabilities.js';
 import { req } from '../lib/requirement-ids.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 interface PackList {
   packs?: Array<{
@@ -132,8 +132,13 @@ function assertAgentManifestShape(requirementId: string,
 
 const SKIP = !isAgentSupported();
 
-describe.skipIf(SKIP)('core.openwop.agents.deep-research — pack catalog evidence', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() is false)`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('core.openwop.agents.deep-research — pack catalog evidence', () => {
   it('host pack-list includes deep-research with a well-formed AgentManifest', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const pack = await findPack('core.openwop.agents.deep-research');
     if (pack === null) return softSkip('blocked', 'precondition not met — `pack === null` returned early (host doesn\'t expose /v1/packs or doesn\'t have this pack) (seam, prior step, or fixture unavailable)'); // host doesn't expose /v1/packs or doesn't have this pack
     expect(pack.version, req('openwop.it.agentPackCatalog.host-pack-list-includes-deep-research-with-a-well-formed-agentmanifest', 'RFCS/0003-agent-packs.md', 'pack version MUST be present')).toBeDefined();
@@ -156,8 +161,9 @@ describe.skipIf(SKIP)('core.openwop.agents.deep-research — pack catalog eviden
   });
 });
 
-describe.skipIf(SKIP)('core.openwop.agents.react — pack catalog evidence', () => {
+describe('core.openwop.agents.react — pack catalog evidence', () => {
   it('host pack-list includes react with a well-formed AgentManifest', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const pack = await findPack('core.openwop.agents.react');
     if (pack === null) return softSkip('blocked', 'precondition not met — `pack === null` returned early (seam, prior step, or fixture unavailable)');
     expect(pack.version).toBeDefined();
@@ -173,8 +179,9 @@ describe.skipIf(SKIP)('core.openwop.agents.react — pack catalog evidence', ()
   });
 });
 
-describe.skipIf(SKIP)('core.openwop.agents.supervisor — pack catalog evidence', () => {
+describe('core.openwop.agents.supervisor — pack catalog evidence', () => {
   it('host pack-list includes supervisor with a well-formed AgentManifest', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const pack = await findPack('core.openwop.agents.supervisor');
     if (pack === null) return softSkip('blocked', 'precondition not met — `pack === null` returned early (seam, prior step, or fixture unavailable)');
     expect(pack.version).toBeDefined();
@@ -194,8 +201,9 @@ describe.skipIf(SKIP)('core.openwop.agents.supervisor — pack catalog evidence'
   });
 });
 
-describe.skipIf(SKIP)('agent-pack catalog summary', () => {
+describe('agent-pack catalog summary', () => {
   it('all three 2026-05-17 reference agent packs are catalog-reachable', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const names = [
       'core.openwop.agents.deep-research',
       'core.openwop.agents.react',

package/src/scenarios/agentPackExport.test.ts

@@ -23,7 +23,7 @@ import { SCHEMAS_DIR } from '../lib/paths.js';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } from '../lib/multi-agent-capabilities.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-agent-pack-export';
@@ -49,8 +49,14 @@ function agentManifestValidator(): (doc: unknown) => { ok: boolean; errors: stri
   return (doc: unknown) => ({ ok: validate(doc) as boolean, errors: ajv.errorsText(validate.errors, { separator: '; ' }) });
 }
 
-describe.skipIf(SKIP)('agentPackExport: workspace agents project to AgentManifest', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentPackExport: workspace agents project to AgentManifest', () => {
   it('exported manifests contain required AgentManifest fields', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const res = await driver.get('/v1/packs/export');
     if (res.status === 404 || res.status === 501) {
       // Host doesn't expose pack-export over REST; treated as skip.

package/src/scenarios/agentPackHandoffSchemaValidation.test.ts

@@ -52,6 +52,7 @@ import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported, hasHandoffValidation } 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-agent-pack-handoff-schema-validation';
 const SKIP = !isAgentSupported() || !isFixtureAdvertised(FIXTURE);
@@ -67,8 +68,18 @@ async function settle(runId: string, terminal = ['completed', 'failed', 'waiting
   return undefined;
 }
 
-describe.skipIf(SKIP)('agentPackHandoffSchemaValidation: handoff schema enforcement at dispatch', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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;
+
+/** 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] =
+  (!hasHandoffValidation()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (hasHandoffValidation() is false)`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('agentPackHandoffSchemaValidation: handoff schema enforcement at dispatch', () => {
   it('HV-1a: valid task payload that matches taskSchemaRef is dispatched and completes', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // Valid inputs for `structured-fixture` task schema (required: text,
     // extractionFields). No `scenario` key → the gate takes the task probe,
     // `validateTask(inputs)` passes, the gate is ok, the no-op node runs.
@@ -88,8 +99,10 @@ describe.skipIf(SKIP)('agentPackHandoffSchemaValidation: handoff schema enforcem
 
   // HV-1b / HV-1c assert a REJECTION, which only a host performing handoff
   // validation can produce — gate on the capability that declares that behavior.
-  describe.skipIf(!hasHandoffValidation())('rejection legs (agents.manifestRuntime.handoffValidation)', () => {
+  describe('rejection legs (agents.manifestRuntime.handoffValidation)', () => {
     it('HV-1b: invalid task payload (missing required field) fails before dispatch with a structured violation', async () => {
+    if (!hasHandoffValidation()) return softSkip(...GATE_WHY_2);
+    if (SKIP) return softSkip(...GATE_WHY);
       // HV-1a's inputs minus the required `extractionFields` — the paired
       // sabotage. `validateTask` fails `required` → the run MUST fail.
       const create = await driver.post('/v1/runs', {
@@ -121,6 +134,8 @@ describe.skipIf(SKIP)('agentPackHandoffSchemaValidation: handoff schema enforcem
     });
 
     it('HV-1c: agent return payload that fails returnSchemaRef surfaces a structured violation before persistence', async () => {
+    if (!hasHandoffValidation()) return softSkip(...GATE_WHY_2);
+    if (SKIP) return softSkip(...GATE_WHY);
       // `scenario: 'mock-return-violation'` routes to the return probe, which
       // validates `{}` against the return schema's success-XOR-error `oneOf`
       // (satisfies neither branch) → a return-schema violation.

package/src/scenarios/agentPackInstall.test.ts

@@ -24,7 +24,7 @@ import { SCHEMAS_DIR } from '../lib/paths.js';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } from '../lib/multi-agent-capabilities.js';
-import { softSkip } from '../lib/soft-skip.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 import { req } from '../lib/requirement-ids.js';
 
 const FIXTURE = 'conformance-agent-pack-install';
@@ -50,8 +50,14 @@ function agentManifestValidator(): (doc: unknown) => { ok: boolean; errors: stri
   return (doc: unknown) => ({ ok: validate(doc) as boolean, errors: ajv.errorsText(validate.errors, { separator: '; ' }) });
 }
 
-describe.skipIf(SKIP)('agentPackInstall: pack agents[] entries surface as AgentManifest', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentPackInstall: pack agents[] entries surface as AgentManifest', () => {
   it('host exposes installed agent manifests with required AgentManifest fields', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // Host-specific pack-listing endpoint. The conformance suite probes
     // common paths; hosts that don't expose pack listings via REST mark
     // this scenario as skip via their own capability advertisement.

package/src/scenarios/agentPackProvenance.test.ts

@@ -21,12 +21,19 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { isAgentSupported } 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-agent-pack-provenance';
 const SKIP = !isAgentSupported() || !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentPackProvenance: sourceManifestId survives install + run', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() 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('agentPackProvenance: sourceManifestId survives install + run', () => {
   it('run-level AgentRef carries sourceManifestId pointing back to the install source', 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/agentReasoningEvents.test.ts

@@ -23,6 +23,7 @@ import {
   getReasoningVerbosity,
 } 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-agent-reasoning';
 const SKIP =
@@ -38,8 +39,15 @@ const REASONING_EVENT_TYPES = new Set([
   'agent.decided',
 ]);
 
-describe.skipIf(SKIP)('agentReasoningEvents: agent.* event family emission', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() is false)`] as const : 
+  (getReasoningVerbosity() === 'off') ? ['inapplicable', `the host advertises reasoning verbosity \`off\`, so agent reasoning events do not apply`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('agentReasoningEvents: agent.* event family emission', () => {
   it('host emits at least one canonical agent.* event during a reasoning-fixture run', 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/agentReasoningStreaming.test.ts

@@ -30,6 +30,7 @@ import {
   getReasoningVerbosity,
 } 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-agent-reasoning-streaming';
 /** Expected concatenation of the fixture's `streamChunks` — kept in sync
@@ -48,8 +49,16 @@ const SKIP =
   getReasoningVerbosity() === 'off' ||
   !isFixtureAdvertised(FIXTURE);
 
-describe.skipIf(SKIP)('agentReasoningStreaming: RFC 0024 incremental + closing event contract', () => {
+/** 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] =
+  (!isAgentSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isAgentSupported() is false)`] as const : 
+  (!isReasoningStreamingSupported()) ? ['inapplicable', `the host does not advertise the capability this scenario covers (isReasoningStreamingSupported() is false)`] as const : 
+  (getReasoningVerbosity() === 'off') ? ['inapplicable', `the host advertises reasoning verbosity \`off\`, so agent reasoning events do not apply`] as const : 
+  (!isFixtureAdvertised(FIXTURE)) ? ['blocked', `the \`${FIXTURE}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('agentReasoningStreaming: RFC 0024 incremental + closing event contract', () => {
   it('emits N agent.reasoning.delta events followed by exactly one closing agent.reasoned', 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;
@@ -80,6 +89,7 @@ describe.skipIf(SKIP)('agentReasoningStreaming: RFC 0024 incremental + closing e
   });
 
   it('agent.reasoning.delta `sequence` starts at 0 and increments by 1 within the block', 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;
@@ -104,6 +114,7 @@ describe.skipIf(SKIP)('agentReasoningStreaming: RFC 0024 incremental + closing e
   });
 
   it('closing agent.reasoned.reasoning is the concatenation of the deltas (authoritative)', 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;
@@ -130,6 +141,7 @@ describe.skipIf(SKIP)('agentReasoningStreaming: RFC 0024 incremental + closing e
   });
 
   it('agentId is consistent across all streaming + closing events in a block', 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;
@@ -158,6 +170,7 @@ describe.skipIf(SKIP)('agentReasoningStreaming: RFC 0024 incremental + closing e
   });
 
   it('all agent.reasoning.delta events arrive BEFORE the closing agent.reasoned', 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/append-ordering.test.ts

@@ -19,7 +19,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, blockedDespiteAssertions } from '../lib/soft-skip.js';
+import { softSkip, blockedDespiteAssertions, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const CANDIDATES = ['conformance-append-ordering', 'conformance-multi-node'] as const;
 const FIXTURE = CANDIDATES.find((id) => isFixtureAdvertised(id)) ?? null;
@@ -46,8 +46,13 @@ interface RunEvent {
   payload?: ChannelWrittenPayload;
 }
 
-describe.skipIf(SKIP)('append-ordering: folded channel reflects event sequence', () => {
+/** 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] =
+  (!FIXTURE) ? ['blocked', `none of the candidate fixtures (${CANDIDATES.join(', ')}) is advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('append-ordering: folded channel reflects event sequence', () => {
   it('append-reducer channels project entries in event-sequence order', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', { workflowId: FIXTURE! });
     const runId = (create.json as { runId?: string } | undefined)?.runId;
 

package/src/scenarios/bulk-cancel.test.ts

@@ -21,6 +21,7 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { req } from '../lib/requirement-ids.js';
+import { softSkip, type SoftSkipKind } from '../lib/soft-skip.js';
 
 const CANCELLABLE = 'conformance-cancellable';
 const NOOP = 'conformance-noop';
@@ -34,8 +35,14 @@ interface BulkResult {
   error?: { code?: string; message?: string };
 }
 
-describe.skipIf(SKIP)('bulk-cancel: POST /v1/runs:bulk-cancel', () => {
+/** 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(CANCELLABLE)) ? ['blocked', `the \`${CANCELLABLE}\` fixture is not advertised`] as const : 
+  (!isFixtureAdvertised(NOOP)) ? ['blocked', `the \`${NOOP}\` fixture is not advertised`] as const : ['blocked', 'the gate held for no named reason'] as const;
+
+describe('bulk-cancel: POST /v1/runs:bulk-cancel', () => {
   it('mixed-outcome request returns per-id results in order', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // Spin up a long-running cancellable run + observe a known-bad id
     // alongside it. The host MUST handle each independently.
     const create = await driver.post('/v1/runs', {
@@ -71,6 +78,7 @@ describe.skipIf(SKIP)('bulk-cancel: POST /v1/runs:bulk-cancel', () => {
   });
 
   it('empty runIds array returns 400 validation_error', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const res = await driver.post('/v1/runs:bulk-cancel', { runIds: [] });
     expect(res.status, req('openwop.it.bulk-cancel.empty-runids-array-returns-400-validation-error', 'rest-endpoints.md §Open', 'empty runIds array returns 400 validation_error')).toBe(400);
     const body = res.json as { error?: string };
@@ -78,6 +86,7 @@ describe.skipIf(SKIP)('bulk-cancel: POST /v1/runs:bulk-cancel', () => {
   });
 
   it('oversized runIds array returns 400 with details.maxRunIds', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     // 101 entries — exceeds the recommended 100-entry cap.
     const ids = Array.from({ length: 101 }, (_, i) => `run-overflow-${i}`);
     const res = await driver.post('/v1/runs:bulk-cancel', { runIds: ids });
@@ -92,6 +101,7 @@ describe.skipIf(SKIP)('bulk-cancel: POST /v1/runs:bulk-cancel', () => {
   });
 
   it('re-bulk-cancel after first cancel is idempotent', async () => {
+    if (SKIP) return softSkip(...GATE_WHY);
     const create = await driver.post('/v1/runs', {
       workflowId: CANCELLABLE,
       inputs: { delaySeconds: 30 },