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

package/src/scenarios/prompt-prefix-cache.test.ts

@@ -32,6 +32,8 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { readCapabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface PromptPrefixCacheCap {
   supported?: unknown;
@@ -76,10 +78,10 @@ async function generate(args: {
 describe('prompt-prefix-cache: advertisement shape (RFC 0116)', () => {
   it('aiProviders.promptPrefixCache is either absent or a well-formed object', async () => {
     const cap = await readCap();
-    if (cap === null) return; // not advertised — skip
+    if (cap === null) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `cap === null` returned early (not advertised — skip)'); // not advertised — skip
     expect(
       typeof cap.supported,
-      driver.describe(
+      req('openwop.it.prompt-prefix-cache.aiproviders-promptprefixcache-is-either-absent-or-a-well-formed-object', 
         'capabilities.schema.json §aiProviders.promptPrefixCache',
         'promptPrefixCache.supported MUST be a boolean when the block is present',
       ),
@@ -87,7 +89,7 @@ describe('prompt-prefix-cache: advertisement shape (RFC 0116)', () => {
     if (cap.providers !== undefined) {
       expect(
         Array.isArray(cap.providers),
-        driver.describe(
+        req('openwop.it.prompt-prefix-cache.aiproviders-promptprefixcache-is-either-absent-or-a-well-formed-object', 
           'capabilities.schema.json §aiProviders.promptPrefixCache',
           'promptPrefixCache.providers MUST be an array of provider ids when present (provider-scoped)',
         ),
@@ -99,19 +101,19 @@ describe('prompt-prefix-cache: advertisement shape (RFC 0116)', () => {
 describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")', () => {
   it('(a) outcome-invariance — cachePrefixId vs control → same envelope + identical input/output tokens', async () => {
     const cap = await readCap();
-    if (!cap || cap.supported !== true) return; // not advertised — skip
+    if (!cap || cap.supported !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!cap || cap.supported !== true` returned early (not advertised — skip)'); // not advertised — skip
     const prefixId = `inv-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 
     const control = await generate({ tenantId: 'tenant-a' });
-    if (control.status === 404 || control.status === 405) return; // seam not wired
-    expect(control.status, driver.describe('host-sample-test-seams.md §16', 'generate seam MUST return 200')).toBe(200);
+    if (control.status === 404 || control.status === 405) return softSkip('blocked', 'precondition not met — `control.status === 404 || control.status === 405` returned early (seam not wired) (seam, prior step, or fixture unavailable)'); // seam not wired
+    expect(control.status, req('openwop.it.prompt-prefix-cache.a-outcome-invariance-cacheprefixid-vs-control-same-envelope-identical-input-outp', 'host-sample-test-seams.md §16', 'generate seam MUST return 200')).toBe(200);
 
     const withPrefix = await generate({ tenantId: 'tenant-a', cachePrefixId: prefixId });
     expect(withPrefix.status).toBe(200);
 
     expect(
       withPrefix.body.envelope?.envelopeType,
-      driver.describe(
+      req('openwop.it.prompt-prefix-cache.a-outcome-invariance-cacheprefixid-vs-control-same-envelope-identical-input-outp', 
         'ai-envelope.md §"Prompt-prefix cache (RFC 0116)" rule 3',
         'cachePrefixId is a cost hint, never semantic: the accepted envelope MUST be identical hit-vs-miss',
       ),
@@ -119,7 +121,7 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
     expect(withPrefix.body.usage?.inputTokens).toBe(control.body.usage?.inputTokens);
     expect(
       withPrefix.body.usage?.outputTokens,
-      driver.describe(
+      req('openwop.it.prompt-prefix-cache.a-outcome-invariance-cacheprefixid-vs-control-same-envelope-identical-input-outp', 
         'ai-envelope.md §"Prompt-prefix cache (RFC 0116)" rule 3',
         'provider.usage.inputTokens/outputTokens MUST be identical hit-vs-miss (replay-invariant)',
       ),
@@ -128,18 +130,18 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
 
   it('(b) cache hit observable — a repeat generate shows cacheReadTokens > 0 while tokens stay invariant', async () => {
     const cap = await readCap();
-    if (!cap || cap.supported !== true) return; // not advertised — skip
+    if (!cap || cap.supported !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!cap || cap.supported !== true` returned early (not advertised — skip)'); // not advertised — skip
     const prefixId = `hit-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 
     const prime = await generate({ tenantId: 'tenant-a', cachePrefixId: prefixId });
-    if (prime.status === 404 || prime.status === 405) return; // seam not wired
+    if (prime.status === 404 || prime.status === 405) return softSkip('blocked', 'precondition not met — `prime.status === 404 || prime.status === 405` returned early (seam not wired) (seam, prior step, or fixture unavailable)'); // seam not wired
     expect(prime.status).toBe(200);
 
     const repeat = await generate({ tenantId: 'tenant-a', cachePrefixId: prefixId });
     expect(repeat.status).toBe(200);
     expect(
       repeat.body.usage?.cacheReadTokens ?? 0,
-      driver.describe(
+      req('openwop.it.prompt-prefix-cache.b-cache-hit-observable-a-repeat-generate-shows-cachereadtokens-0-while-tokens-st', 
         'ai-envelope.md §"Prompt-prefix cache (RFC 0116)" rule 4',
         'a repeat generate with the same cachePrefixId for the SAME tenant MUST be an observable cache hit (cacheReadTokens > 0)',
       ),
@@ -151,12 +153,12 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
 
   it('(c) cross-tenant isolation — tenant B first use of tenant A\'s cachePrefixId → cacheReadTokens == 0', async () => {
     const cap = await readCap();
-    if (!cap || cap.supported !== true) return; // not advertised — skip
+    if (!cap || cap.supported !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!cap || cap.supported !== true` returned early (not advertised — skip)'); // not advertised — skip
     const prefixId = `xtenant-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 
     // Tenant A primes the cache under a shared, predictable cachePrefixId.
     const aPrime = await generate({ tenantId: 'tenant-a', cachePrefixId: prefixId });
-    if (aPrime.status === 404 || aPrime.status === 405) return; // seam not wired
+    if (aPrime.status === 404 || aPrime.status === 405) return softSkip('blocked', 'precondition not met — `aPrime.status === 404 || aPrime.status === 405` returned early (seam not wired) (seam, prior step, or fixture unavailable)'); // seam not wired
     expect(aPrime.status).toBe(200);
 
     // Tenant B's FIRST use of the SAME cachePrefixId MUST be a miss — the host
@@ -165,7 +167,7 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
     expect(bFirst.status).toBe(200);
     expect(
       bFirst.body.usage?.cacheReadTokens ?? 0,
-      driver.describe(
+      req('openwop.it.prompt-prefix-cache.c-cross-tenant-isolation-tenant-b-first-use-of-tenant-a-s-cacheprefixid-cacherea', 
         'SECURITY/invariants.yaml prompt-prefix-cache-cross-tenant-isolation',
         'tenant B\'s first use of tenant A\'s cachePrefixId MUST be a cache MISS (cacheReadTokens == 0) — the cache MUST be keyed by (tenant, cachePrefixId), never global; cross-tenant sharing is context leakage',
       ),
@@ -174,11 +176,11 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
 
   it('(d) secret-free — the response never echoes cachePrefixId in a SR-1-sensitive position', async () => {
     const cap = await readCap();
-    if (!cap || cap.supported !== true) return; // not advertised — skip
+    if (!cap || cap.supported !== true) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!cap || cap.supported !== true` returned early (not advertised — skip)'); // not advertised — skip
     const prefixId = `secretfree-${Date.now()}`;
 
     const res = await generate({ tenantId: 'tenant-a', cachePrefixId: prefixId });
-    if (res.status === 404 || res.status === 405) return; // seam not wired
+    if (res.status === 404 || res.status === 405) return softSkip('blocked', 'precondition not met — `res.status === 404 || res.status === 405` returned early (seam not wired) (seam, prior step, or fixture unavailable)'); // seam not wired
     expect(res.status).toBe(200);
     // The usage block is cost-only; it MUST NOT carry prompt/response substrings
     // (SR-1). cachePrefixId is a public cache key, but the cost witness fields
@@ -189,7 +191,7 @@ describe('prompt-prefix-cache: behavioral (RFC 0116 §"Normative requirements")'
       if (v !== undefined) {
         expect(
           typeof v,
-          driver.describe(
+          req('openwop.it.prompt-prefix-cache.d-secret-free-the-response-never-echoes-cacheprefixid-in-a-sr-1-sensitive-positi', 
             'run-event-payloads.schema.json §providerUsage',
             `provider.usage.${k} MUST be a cost-only integer (no prompt substrings per SR-1)`,
           ),

package/src/scenarios/prompt-read-workspace-membership-enforced.test.ts

@@ -68,6 +68,8 @@ import { describe, it, expect } from 'vitest';
 import { randomUUID } from 'node:crypto';
 import { driver } from '../lib/driver.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -100,12 +102,12 @@ describe.skipIf(HTTP_SKIP)(
       const d = await readDiscovery();
       if (d === null) {
         ctx.skip();
-        return;
+        return softSkip('blocked', 'precondition not met — `d === null` returned early (seam, prior step, or fixture unavailable)');
       }
       const promptsSupported = capabilityFamily(d, 'prompts')?.supported;
       if (promptsSupported !== true) {
         ctx.skip();
-        return;
+        return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `promptsSupported !== true` returned early');
       }
 
       const nonMemberWorkspaceId =
@@ -125,18 +127,18 @@ describe.skipIf(HTTP_SKIP)(
           const body = res.json as { error?: unknown } | null;
           expect(
             body?.error,
-            driver.describe(
+            req('openwop.it.prompt-read-workspace-membership-enforced.get-v1-prompts-workspaceid-non-member-must-refuse-or-return-empty-templates-neve', 
               'spec/v1/rest-endpoints.md §Common error codes — workspace_membership_required',
               `403 refusal of a workspace-scoped read MUST carry error: "workspace_membership_required"; got error: ${JSON.stringify(body?.error)}`,
             ),
           ).toBe('workspace_membership_required');
         }
-        return;
+        return softSkip('blocked', 'precondition not met — `res.status >= 400 && res.status < 500` returned early (4xx — refused. Acceptable shape for the membership-required failure (and any other refusal mode the host chooses: 401, 404 for existence-d…');
       }
 
       // 5xx — refused (infrastructure failure is acceptable; envelope shape
       // unconstrained).
-      if (res.status >= 500) return;
+      if (res.status >= 500) return softSkip('blocked', 'precondition not met — `res.status >= 500` returned early (5xx — refused (infrastructure failure is acceptable; envelope shape unconstrained).) (seam, prior step, or fixture unavailable)');
 
       // 2xx — must inspect the response body. The failure mode this
       // invariant guards against is a 200 response that LEAKS templates
@@ -154,13 +156,13 @@ describe.skipIf(HTTP_SKIP)(
           // workspace-scoped reads, and a host without that surface is
           // simply out of scope.
           ctx.skip();
-          return;
+          return softSkip('blocked', 'precondition not met — `body === null || typeof body !== \'object\' || !(\'templates\' in body)` returned early (seam, prior step, or fixture unavailable)');
         }
         const templates = body.templates;
         if (!Array.isArray(templates)) {
           // Same: unrecognized shape, skip.
           ctx.skip();
-          return;
+          return softSkip('blocked', 'precondition not met — `!Array.isArray(templates)` returned early (seam, prior step, or fixture unavailable)');
         }
 
         // A random non-member workspaceId can never legitimately contain
@@ -168,12 +170,12 @@ describe.skipIf(HTTP_SKIP)(
         // is a cross-tenant data leak.
         expect(
           templates.length,
-          driver.describe(
+          req('openwop.it.prompt-read-workspace-membership-enforced.get-v1-prompts-workspaceid-non-member-must-refuse-or-return-empty-templates-neve', 
             'spec/v1/prompts.md §Workspace membership on workspace-scoped reads and writes',
             `GET /v1/prompts?workspaceId=<random-non-member> MUST NOT return any templates; got ${templates.length} templates which is a cross-tenant data leak (the random workspaceId is freshly generated per probe and cannot legitimately contain authorized content)`,
           ),
         ).toBe(0);
-        return;
+        return softSkip('blocked', 'precondition not met — `res.status >= 200 && res.status < 300` returned early (2xx — must inspect the response body. The failure mode this invariant guards against is a 200 response that LEAKS templates from a workspa…');
       }
 
       // Other status codes (1xx, 3xx) — soft-skip with note. Not a clear

package/src/scenarios/prompt-render-deterministic.test.ts

@@ -24,6 +24,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -91,7 +93,7 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const template = await pickTemplateWithInputVar();
-    if (!template) return;
+    if (!template) return softSkip('blocked', 'precondition not met — `!template` returned early (seam, prior step, or fixture unavailable)');
 
     const variableNames = (template.variables ?? [])
       .filter((v) => v.source !== 'secret')
@@ -103,7 +105,7 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
 
     const ref = `prompt:${template.templateId}@${template.version}`;
     const first = await driver.post('/v1/prompts:render', { ref, variables });
-    if (first.status !== 200) return;
+    if (first.status !== 200) return softSkip('blocked', 'precondition not met — `first.status !== 200` returned early (seam, prior step, or fixture unavailable)');
     const second = await driver.post('/v1/prompts:render', { ref, variables });
     expect(second.status).toBe(200);
 
@@ -112,14 +114,14 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
 
     expect(
       a.hash,
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.identical-ref-variables-inputs-produce-identical-hash-variablehashes', 
         'spec/v1/prompts.md §Discovery & distribution',
         'render hash MUST be stable across identical (ref, variables) inputs',
       ),
     ).toBe(b.hash);
     expect(
       Object.keys(a.variableHashes).sort(),
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.identical-ref-variables-inputs-produce-identical-hash-variablehashes', 
         'spec/v1/prompts.md §Discovery & distribution',
         'variableHashes key set MUST be stable',
       ),
@@ -134,11 +136,11 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const template = await pickTemplateWithInputVar();
-    if (!template) return;
+    if (!template) return softSkip('blocked', 'precondition not met — `!template` returned early (seam, prior step, or fixture unavailable)');
     const requiredVars = (template.variables ?? []).filter(
       (v) => v.source !== 'secret' && v.required === true,
     );
-    if (requiredVars.length === 0) return; // no required var to toggle
+    if (requiredVars.length === 0) return softSkip('blocked', 'precondition not met — `requiredVars.length === 0` returned early (no required var to toggle) (seam, prior step, or fixture unavailable)'); // no required var to toggle
 
     const variables: Record<string, unknown> = {};
     for (const v of template.variables ?? []) {
@@ -148,7 +150,7 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
 
     const ref = `prompt:${template.templateId}@${template.version}`;
     const baseline = await driver.post('/v1/prompts:render', { ref, variables });
-    if (baseline.status !== 200) return;
+    if (baseline.status !== 200) return softSkip('blocked', 'precondition not met — `baseline.status !== 200` returned early (seam, prior step, or fixture unavailable)');
 
     // Toggle one required variable.
     const toggled = { ...variables, [requiredVars[0]!.name]: 'conformance-toggled-value' };
@@ -160,14 +162,14 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
 
     expect(
       a.hash,
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.different-variable-values-produce-different-hash-at-least-one-different-variable', 
         'spec/v1/prompts.md §Discovery & distribution',
         'render hash MUST differ when any variable binding differs',
       ),
     ).not.toBe(b.hash);
     expect(
       a.variableHashes[requiredVars[0]!.name],
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.different-variable-values-produce-different-hash-at-least-one-different-variable', 
         'spec/v1/prompts.md §Discovery & distribution',
         'variableHashes[name] MUST differ when name binding differs',
       ),
@@ -179,7 +181,7 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const template = await pickTemplateWithInputVar();
-    if (!template) return;
+    if (!template) return softSkip('blocked', 'precondition not met — `!template` returned early (seam, prior step, or fixture unavailable)');
     const variables: Record<string, unknown> = {};
     for (const v of template.variables ?? []) {
       if (v.source === 'secret') continue;
@@ -187,12 +189,12 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     }
     const ref = `prompt:${template.templateId}@${template.version}`;
     const res = await driver.post('/v1/prompts:render', { ref, variables });
-    if (res.status !== 200) return;
+    if (res.status !== 200) return softSkip('blocked', 'precondition not met — `res.status !== 200` returned early (seam, prior step, or fixture unavailable)');
     const r = res.json as RenderResponse;
 
     expect(
       /^sha256:[0-9a-f]{64}$/.test(r.hash),
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.hash-variablehashes-must-match-sha256-hex64-pattern', 
         'schemas/run-event-payloads.schema.json §promptComposed.hash',
         'hash MUST match `^sha256:[0-9a-f]{64}$`',
       ),
@@ -200,7 +202,7 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     for (const [name, h] of Object.entries(r.variableHashes)) {
       expect(
         /^sha256:[0-9a-f]{64}$/.test(h),
-        `variableHashes[${name}] MUST match sha256:<hex64>; got ${h}`,
+        req('openwop.it.prompt-render-deterministic.hash-variablehashes-must-match-sha256-hex64-pattern', 'schemas/run-event-payloads.schema.json §promptComposed.hash', `variableHashes[${name}] MUST match sha256:<hex64>; got ${h}`),
       ).toBe(true);
     }
   });
@@ -214,12 +216,12 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     const d = await readDiscovery();
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
     const list = await driver.get('/v1/prompts?source=host&limit=200');
-    if (list.status !== 200) return;
+    if (list.status !== 200) return softSkip('blocked', 'precondition not met — `list.status !== 200` returned early (seam, prior step, or fixture unavailable)');
     const body = list.json as ListResponse;
     const nonSystemUser = body.items.find(
       (t) => t.kind === 'few-shot' || t.kind === 'schema-hint',
     );
-    if (!nonSystemUser) return; // host doesn't ship one — soft-skip
+    if (!nonSystemUser) return softSkip('blocked', 'precondition not met — `!nonSystemUser` returned early (host doesn\'t ship one — soft-skip) (seam, prior step, or fixture unavailable)'); // host doesn't ship one — soft-skip
 
     const variables: Record<string, unknown> = {};
     for (const v of nonSystemUser.variables ?? []) {
@@ -228,11 +230,11 @@ describe.skipIf(HTTP_SKIP)('prompt-render-deterministic: hash stable across iden
     }
     const ref = `prompt:${nonSystemUser.templateId}@${nonSystemUser.version}`;
     const res = await driver.post('/v1/prompts:render', { ref, variables });
-    if (res.status !== 200) return;
+    if (res.status !== 200) return softSkip('blocked', 'precondition not met — `res.status !== 200` returned early (seam, prior step, or fixture unavailable)');
     const r = res.json as RenderResponse;
     expect(
       typeof r.composed === 'string' && r.composed.length > 0,
-      driver.describe(
+      req('openwop.it.prompt-render-deterministic.renders-few-shot-schema-hint-kinds-with-non-empty-composed-body', 
         'spec/v1/prompts.md §Discovery & distribution',
         '`composed` body MUST populate for every PromptKind under observability: full',
       ),

package/src/scenarios/prompt-resolution-chain-agent-intrinsic.test.ts

@@ -31,6 +31,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -101,7 +103,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-agent-intrinsic: layer-2 age
         system: 'prompt:host-default@1.0.0',
       },
     });
-    if (res.status === 404) return;
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam, prior step, or fixture unavailable)');
     expect(res.status).toBe(200);
 
     const payload = res.json as AgentPromptResolvedPayload;
@@ -109,14 +111,14 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-agent-intrinsic: layer-2 age
     const appliedEntries = payload.chain.filter((c) => c.applied);
     expect(
       appliedEntries.length,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-agent-intrinsic.agent-intrinsic-systempromptref-wins-over-workflow-defaults-host-defaults-when-n', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'exactly one chain entry MUST carry applied: true',
       ),
     ).toBe(1);
     expect(
       appliedEntries[0]?.layer,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-agent-intrinsic.agent-intrinsic-systempromptref-wins-over-workflow-defaults-host-defaults-when-n', 
         'spec/v1/prompts.md §Resolution chain (normative) — Layer 2',
         'system-kind resolution MUST prefer agent intrinsic (systemPromptRef) over agent-overrides when both are set',
       ),
@@ -124,7 +126,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-agent-intrinsic: layer-2 age
 
     expect(
       payload.resolved,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-agent-intrinsic.agent-intrinsic-systempromptref-wins-over-workflow-defaults-host-defaults-when-n', 
         'spec/v1/prompts.md §Resolution chain (normative) — Layer 2',
         'resolved MUST mirror the winning chain entry source',
       ),
@@ -132,7 +134,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-agent-intrinsic: layer-2 age
 
     expect(
       payload.agentId,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-agent-intrinsic.agent-intrinsic-systempromptref-wins-over-workflow-defaults-host-defaults-when-n', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'agent.promptResolved.agentId MUST be set when config.agentId resolves to a known agent',
       ),

package/src/scenarios/prompt-resolution-chain-event.test.ts

@@ -30,6 +30,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
 import { pollUntilTerminal } from '../lib/polling.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 const PROMPT_FIXTURE_ID = 'conformance-prompt-end-to-end';
 const VALID_LAYERS = new Set([
@@ -48,17 +50,17 @@ async function promptsSupported(): Promise<boolean> {
 
 describe('prompt-resolution-chain-event (black-box): agent.promptResolved carries the precedence record (RFC 0029)', () => {
   it('the production agent.promptResolved event records the full four-layer resolution chain', async () => {
-    if (!(await promptsSupported())) return; // capability not advertised — skip
+    if (!(await promptsSupported())) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `!(await promptsSupported())` returned early (capability not advertised — skip)'); // capability not advertised — skip
 
     const create = await driver.post('/v1/runs', { workflowId: PROMPT_FIXTURE_ID });
     if (create.status !== 201) {
       // Fixture not seeded / run not accepted — not a prompt-chain failure.
       // eslint-disable-next-line no-console
       console.warn(`[prompt-resolution-chain-event] POST /v1/runs for ${PROMPT_FIXTURE_ID} returned ${create.status}; skipping the production-path assertion`);
-      return;
+      return softSkip('blocked', 'precondition not met — `create.status !== 201` returned early ([prompt-resolution-chain-event] POST /v1/runs for … returned …; skipping the production-path assertion) (seam, prior step, or fixture unavailable)');
     }
     const runId = (create.json as { runId?: string }).runId;
-    if (!runId) return;
+    if (!runId) return softSkip('blocked', 'precondition not met — `!runId` returned early (seam, prior step, or fixture unavailable)');
     await pollUntilTerminal(runId);
 
     const poll = await driver.get(`/v1/runs/${encodeURIComponent(runId)}/events/poll`);
@@ -69,14 +71,14 @@ describe('prompt-resolution-chain-event (black-box): agent.promptResolved carrie
       // (RFC 0029 emission is staged) — soft-skip the behavioral assertion.
       // eslint-disable-next-line no-console
       console.warn('[prompt-resolution-chain-event] host emitted no agent.promptResolved event; skipping (RFC 0029 emission staged)');
-      return;
+      return softSkip('blocked', 'precondition not met — `resolved.length === 0` returned early ([prompt-resolution-chain-event] host emitted no agent.promptResolved event; skipping (RFC 0029 emission staged)) (seam, prior step, or fixture unavailable)');
     }
 
     for (const ev of resolved) {
       const chain = ev.payload?.chain;
       expect(
         Array.isArray(chain) && chain.length > 0,
-        driver.describe('prompts.md §Resolution chain', 'agent.promptResolved MUST carry a non-empty chain[] of attempted layers'),
+        req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'prompts.md §Resolution chain', 'agent.promptResolved MUST carry a non-empty chain[] of attempted layers'),
       ).toBe(true);
       const entries = chain as ChainEntry[];
 
@@ -84,28 +86,28 @@ describe('prompt-resolution-chain-event (black-box): agent.promptResolved carrie
       for (const e of entries) {
         expect(
           typeof e.layer === 'string' && VALID_LAYERS.has(e.layer),
-          driver.describe('prompts.md §Resolution chain', `each chain entry MUST name a valid layer, got ${String(e.layer)}`),
+          req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'prompts.md §Resolution chain', `each chain entry MUST name a valid layer, got ${String(e.layer)}`),
         ).toBe(true);
-        expect(typeof e.applied, driver.describe('prompts.md §Resolution chain', 'each chain entry MUST carry a boolean `applied`')).toBe('boolean');
+        expect(typeof e.applied, req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'prompts.md §Resolution chain', 'each chain entry MUST carry a boolean `applied`')).toBe('boolean');
       }
 
       // Exactly one layer wins (or none, when resolved is null).
       const applied = entries.filter((e) => e.applied === true);
       expect(
         applied.length <= 1,
-        driver.describe('prompts.md §Resolution chain', 'AT MOST one chain entry MAY be applied: true (the winning layer)'),
+        req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'prompts.md §Resolution chain', 'AT MOST one chain entry MAY be applied: true (the winning layer)'),
       ).toBe(true);
 
       // resolved mirrors the applied entry's source (RFC 0029 §B).
       if (applied.length === 1) {
         expect(
           ev.payload?.resolved,
-          driver.describe('run-event-payloads.schema.json agentPromptResolved', '`resolved` MUST mirror the applied chain entry\'s `source`'),
+          req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'run-event-payloads.schema.json agentPromptResolved', '`resolved` MUST mirror the applied chain entry\'s `source`'),
         ).toBe(applied[0]?.source);
       } else {
         expect(
           ev.payload?.resolved === null || ev.payload?.resolved === undefined,
-          driver.describe('run-event-payloads.schema.json agentPromptResolved', 'with no applied layer, `resolved` MUST be null'),
+          req('openwop.it.prompt-resolution-chain-event.the-production-agent-promptresolved-event-records-the-full-four-layer-resolution', 'run-event-payloads.schema.json agentPromptResolved', 'with no applied layer, `resolved` MUST be null'),
         ).toBe(true);
       }
     }

package/src/scenarios/prompt-resolution-chain-fallback-cascade.test.ts

@@ -32,6 +32,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -88,7 +90,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
         system: 'prompt:host-default@1.0.0',
       },
     });
-    if (res.status === 404) return;
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam, prior step, or fixture unavailable)');
     expect(res.status).toBe(200);
 
     const payload = res.json as AgentPromptResolvedPayload;
@@ -96,7 +98,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
     expect(applied?.layer).toBe('workflow-defaults');
     expect(
       payload.resolved,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-fallback-cascade.workflow-defaults-win-over-host-defaults-when-both-are-set', 
         'spec/v1/prompts.md §Resolution chain (normative) — Layer 3',
         'workflow-defaults MUST win over host-defaults when both are set',
       ),
@@ -115,14 +117,14 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
         system: 'prompt:host-default@1.0.0',
       },
     });
-    if (res.status === 404) return;
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam, prior step, or fixture unavailable)');
     expect(res.status).toBe(200);
 
     const payload = res.json as AgentPromptResolvedPayload;
     const applied = payload.chain.find((c) => c.applied);
     expect(
       applied?.layer,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-fallback-cascade.host-defaults-win-when-workflow-defaults-are-also-absent', 
         'spec/v1/prompts.md §Resolution chain (normative) — Layer 4',
         'host-defaults MUST apply when layers 1-3 yield null',
       ),
@@ -139,13 +141,13 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
       node: { nodeId: 'writer', config: {} },
       // workflowDefaults + hostDefaults intentionally omitted.
     });
-    if (res.status === 404) return;
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (seam, prior step, or fixture unavailable)');
     expect(res.status).toBe(200);
 
     const payload = res.json as AgentPromptResolvedPayload;
     expect(
       payload.resolved,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-fallback-cascade.resolved-is-null-and-chain-still-lists-every-attempted-layer-when-all-four-yield', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'resolved MUST be null when all four layers yield null',
       ),
@@ -154,7 +156,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
     const appliedEntries = payload.chain.filter((c) => c.applied);
     expect(
       appliedEntries.length,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-fallback-cascade.resolved-is-null-and-chain-still-lists-every-attempted-layer-when-all-four-yield', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'zero applied entries when no layer yielded a candidate',
       ),
@@ -164,7 +166,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-fallback-cascade: layers 3 +
     // see why the resolution returned null.
     expect(
       payload.chain.length,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-fallback-cascade.resolved-is-null-and-chain-still-lists-every-attempted-layer-when-all-four-yield', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'chain[] MUST list every layer attempted, even when none applied',
       ),

package/src/scenarios/prompt-resolution-chain-node-wins.test.ts

@@ -30,6 +30,8 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { capabilityFamily } from '../lib/discovery-capabilities.js';
+import { req } from '../lib/requirement-ids.js';
+import { softSkip } from '../lib/soft-skip.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -104,14 +106,14 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-node-wins: layer-1 node-conf
         system: 'prompt:host-default@1.0.0',
       },
     });
-    if (res.status === 404) return; // host doesn't expose the seam
-    expect(res.status, 'resolve seam MUST return 200').toBe(200);
+    if (res.status === 404) return softSkip('blocked', 'precondition not met — `res.status === 404` returned early (host doesn\'t expose the seam) (seam, prior step, or fixture unavailable)'); // host doesn't expose the seam
+    expect(res.status, req('openwop.it.prompt-resolution-chain-node-wins.node-level-systempromptref-wins-over-agent-intrinsic-workflow-defaults-host-defa', 'spec/v1/prompts.md §Resolution chain (normative)', 'resolve seam MUST return 200')).toBe(200);
 
     const payload = res.json as AgentPromptResolvedPayload;
 
     expect(
       payload.kind,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-node-wins.node-level-systempromptref-wins-over-agent-intrinsic-workflow-defaults-host-defa', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'agent.promptResolved.kind MUST match the requested kind',
       ),
@@ -119,7 +121,7 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-node-wins: layer-1 node-conf
 
     expect(
       payload.resolved,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-node-wins.node-level-systempromptref-wins-over-agent-intrinsic-workflow-defaults-host-defa', 
         'spec/v1/prompts.md §Resolution chain (normative) — Layer 1',
         'node-level systemPromptRef MUST win over agent intrinsic + overrides + workflow defaults + host defaults',
       ),
@@ -128,13 +130,13 @@ describe.skipIf(HTTP_SKIP)('prompt-resolution-chain-node-wins: layer-1 node-conf
     // chain[] MUST list the layers attempted in precedence order. The
     // node layer (first entry of the resolution chain) MUST carry
     // applied: true; every other layer applied: false.
-    expect(Array.isArray(payload.chain), 'agent.promptResolved.chain MUST be an array').toBe(true);
+    expect(Array.isArray(payload.chain), req('openwop.it.prompt-resolution-chain-node-wins.node-level-systempromptref-wins-over-agent-intrinsic-workflow-defaults-host-defa', 'spec/v1/prompts.md §Resolution chain (normative) — Layer 1', 'agent.promptResolved.chain MUST be an array')).toBe(true);
     expect(payload.chain.length).toBeGreaterThan(0);
 
     const appliedEntries = payload.chain.filter((c) => c.applied);
     expect(
       appliedEntries.length,
-      driver.describe(
+      req('openwop.it.prompt-resolution-chain-node-wins.node-level-systempromptref-wins-over-agent-intrinsic-workflow-defaults-host-defa', 
         'spec/v1/prompts.md §Resolution chain (normative)',
         'exactly one chain entry MUST carry applied: true',
       ),