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

package/src/scenarios/prompt-composed-secret-redaction.test.ts

@@ -34,6 +34,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?: {
@@ -97,8 +99,8 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-secret-redaction: composed body reda
       },
       observability: 'full',
     });
-    if (res.status === 404) return; // host doesn't expose the seam
-    expect(res.status, 'compose 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-composed-secret-redaction.emits-prompt-composed-with-redacted-id-in-place-of-secret-sourced-variable-value', 'spec/v1/prompts.md §Composition + observability', 'compose seam MUST return 200')).toBe(200);
 
     const payload = res.json as PromptComposedPayload;
 
@@ -108,14 +110,14 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-secret-redaction: composed body reda
     const userBody = payload.userPrompt ?? '';
     expect(
       systemBody.includes(CANARY_FRAGMENT),
-      driver.describe(
+      req('openwop.it.prompt-composed-secret-redaction.emits-prompt-composed-with-redacted-id-in-place-of-secret-sourced-variable-value', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.systemPrompt MUST NOT contain plaintext secret value',
       ),
     ).toBe(false);
     expect(
       userBody.includes(CANARY_FRAGMENT),
-      driver.describe(
+      req('openwop.it.prompt-composed-secret-redaction.emits-prompt-composed-with-redacted-id-in-place-of-secret-sourced-variable-value', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.userPrompt MUST NOT contain plaintext secret value',
       ),
@@ -127,7 +129,7 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-secret-redaction: composed body reda
     const combined = systemBody + userBody;
     expect(
       /\[REDACTED:[a-zA-Z0-9._-]+\]/.test(combined),
-      driver.describe(
+      req('openwop.it.prompt-composed-secret-redaction.emits-prompt-composed-with-redacted-id-in-place-of-secret-sourced-variable-value', 
         'spec/v1/prompts.md §Composition + observability',
         'composed body MUST carry [REDACTED:<secretId>] marker where secret-sourced variables appear',
       ),
@@ -140,7 +142,7 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-secret-redaction: composed body reda
         if (typeof value === 'string') {
           expect(
             value.includes(CANARY_FRAGMENT),
-            driver.describe(
+            req('openwop.it.prompt-composed-secret-redaction.emits-prompt-composed-with-redacted-id-in-place-of-secret-sourced-variable-value', 
               'spec/v1/prompts.md §Composition + observability',
               `variableBindings[${name}] MUST NOT contain plaintext secret value`,
             ),
@@ -158,19 +160,19 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-secret-redaction: composed body reda
       bindings: { apiKey: 'openwop-conformance-canary-secret' },
       observability: 'full',
     });
-    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 PromptComposedPayload;
     expect(
       payload.hash && /^sha256:[0-9a-f]{64}$/.test(payload.hash),
-      driver.describe(
+      req('openwop.it.prompt-composed-secret-redaction.emits-variablehashes-for-the-secret-sourced-binding-regardless-of-observability', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.hash MUST be present and match sha256:<hex64>',
       ),
     ).toBe(true);
     expect(
       payload.variableHashes !== undefined,
-      driver.describe(
+      req('openwop.it.prompt-composed-secret-redaction.emits-variablehashes-for-the-secret-sourced-binding-regardless-of-observability', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.variableHashes MUST be present under all non-off observability modes',
       ),

package/src/scenarios/prompt-composed-trust-marker.test.ts

@@ -33,6 +33,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?: {
@@ -81,13 +83,13 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-trust-marker: untrusted input wrappe
       bindingTrust: { userPayload: 'untrusted' },
       observability: 'full',
     });
-    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 PromptComposedPayload;
     expect(
       payload.contentTrust,
-      driver.describe(
+      req('openwop.it.prompt-composed-trust-marker.sets-contenttrust-untrusted-when-any-contributing-input-is-untrusted', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.contentTrust MUST be "untrusted" when ANY contributing input is untrusted',
       ),
@@ -104,7 +106,7 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-trust-marker: untrusted input wrappe
       bindingTrust: { userPayload: 'untrusted' },
       observability: 'full',
     });
-    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 PromptComposedPayload;
@@ -112,7 +114,7 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-trust-marker: untrusted input wrappe
 
     expect(
       combined.includes('<UNTRUSTED>') && combined.includes('</UNTRUSTED>'),
-      driver.describe(
+      req('openwop.it.prompt-composed-trust-marker.wraps-untrusted-segments-in-untrusted-untrusted-markers-within-composed-bodies', 
         'spec/v1/prompts.md §Composition + observability',
         'composed body MUST wrap untrusted segments with <UNTRUSTED>...</UNTRUSTED> markers',
       ),
@@ -127,14 +129,14 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-trust-marker: untrusted input wrappe
     const outsideMarkers = markerRegions.filter((_, i) => i % 2 === 0).join(' ');
     expect(
       insideMarkers.includes(UNTRUSTED_PAYLOAD),
-      driver.describe(
+      req('openwop.it.prompt-composed-trust-marker.wraps-untrusted-segments-in-untrusted-untrusted-markers-within-composed-bodies', 
         'spec/v1/prompts.md §Composition + observability',
         'untrusted payload content MUST appear inside <UNTRUSTED>...</UNTRUSTED> markers',
       ),
     ).toBe(true);
     expect(
       outsideMarkers.includes(UNTRUSTED_PAYLOAD),
-      driver.describe(
+      req('openwop.it.prompt-composed-trust-marker.wraps-untrusted-segments-in-untrusted-untrusted-markers-within-composed-bodies', 
         'spec/v1/prompts.md §Composition + observability',
         'untrusted payload content MUST NOT appear outside the markers',
       ),
@@ -151,13 +153,13 @@ describe.skipIf(HTTP_SKIP)('prompt-composed-trust-marker: untrusted input wrappe
       bindingTrust: { userPayload: 'trusted' },
       observability: 'full',
     });
-    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 PromptComposedPayload;
     expect(
       payload.contentTrust,
-      driver.describe(
+      req('openwop.it.prompt-composed-trust-marker.keeps-contenttrust-trusted-when-all-contributing-inputs-are-trusted', 
         'spec/v1/prompts.md §Composition + observability',
         'prompt.composed.contentTrust MUST be "trusted" when no contributing input is untrusted',
       ),

package/src/scenarios/prompt-end-to-end-events.test.ts

@@ -35,6 +35,8 @@ import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.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';
 
 const WORKFLOW_ID = 'conformance-prompt-end-to-end';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -88,7 +90,7 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
     expect(
       create.status,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 
         'spec/v1/rest-endpoints.md',
         'POST /v1/runs MUST return 201 on accepted creation',
       ),
@@ -98,7 +100,7 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     const terminal = await pollUntilTerminal(runId);
     expect(
       terminal.status,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 
         'fixtures.md conformance-prompt-end-to-end §Terminal status',
         'fixture MUST reach terminal `completed`',
       ),
@@ -108,7 +110,7 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     const resolved = events.find((e) => e.type === 'agent.promptResolved');
     expect(
       resolved,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 
         'spec/v1/prompts.md §"Resolution chain (normative)"',
         'host MUST emit `agent.promptResolved` when a node carries a `*PromptRef` and prompts.supported is advertised',
       ),
@@ -120,12 +122,12 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
       chain?: Array<{ layer?: string; applied?: boolean; source?: string }>;
       resolved?: string | null;
     };
-    expect(payload.nodeId, 'agent.promptResolved.nodeId MUST be set').toBe('writer');
-    expect(payload.kind, 'agent.promptResolved.kind MUST match the resolved kind').toBe('system');
+    expect(payload.nodeId, req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 'spec/v1/prompts.md §"Resolution chain (normative)"', 'agent.promptResolved.nodeId MUST be set')).toBe('writer');
+    expect(payload.kind, req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 'spec/v1/prompts.md §"Resolution chain (normative)"', 'agent.promptResolved.kind MUST match the resolved kind')).toBe('system');
     const applied = (payload.chain ?? []).find((c) => c.applied === true);
     expect(
       applied?.layer,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-with-chain-applied-true-for-layer-node-when-systempro', 
         'spec/v1/prompts.md §"Resolution chain (normative)" — Layer 1',
         'node-config ref MUST win when no higher-precedence run-configurable layer is configured',
       ),
@@ -138,7 +140,7 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     if (!behaviorGate('prompts-supported', promptsSupported(d))) return;
 
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
-    if (create.status !== 201) return;
+    if (create.status !== 201) return softSkip('blocked', 'precondition not met — `create.status !== 201` returned early (seam, prior step, or fixture unavailable)');
     const { runId } = create.json as { runId: string };
     await pollUntilTerminal(runId);
     const events = await readAllEvents(runId);
@@ -146,7 +148,7 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     const composed = events.find((e) => e.type === 'prompt.composed');
     expect(
       composed,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-prompt-composed-with-sha256-hex64-hash-non-empty-composed-body-for-system', 
         'spec/v1/prompts.md §"Composition + observability"',
         'host MUST emit `prompt.composed` after `agent.promptResolved` when a ref resolves and observability !== off',
       ),
@@ -162,15 +164,15 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     };
     expect(
       payload.hash && /^sha256:[0-9a-f]{64}$/.test(payload.hash),
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-prompt-composed-with-sha256-hex64-hash-non-empty-composed-body-for-system', 
         'schemas/run-event-payloads.schema.json §promptComposed.hash',
         'hash MUST match `^sha256:[0-9a-f]{64}$`',
       ),
     ).toBe(true);
-    expect(payload.kind, 'system-only kind composition').toBe('system-only');
+    expect(payload.kind, req('openwop.it.prompt-end-to-end-events.emits-prompt-composed-with-sha256-hex64-hash-non-empty-composed-body-for-system', 'schemas/run-event-payloads.schema.json §promptComposed.hash', 'system-only kind composition')).toBe('system-only');
     expect(
       typeof payload.composed === 'string' && payload.composed.length > 0,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-prompt-composed-with-sha256-hex64-hash-non-empty-composed-body-for-system', 
         'spec/v1/prompts.md §"Composition + observability"',
         'composed body MUST be non-empty for system-kind under observability: full',
       ),
@@ -183,18 +185,18 @@ describe.skipIf(SKIP_NO_FIXTURE || HTTP_SKIP)('prompt-end-to-end-events: real di
     const d = await readDiscovery();
     if (!behaviorGate('prompts-supported', promptsSupported(d))) return;
     const create = await driver.post('/v1/runs', { workflowId: WORKFLOW_ID });
-    if (create.status !== 201) return;
+    if (create.status !== 201) return softSkip('blocked', 'precondition not met — `create.status !== 201` returned early (seam, prior step, or fixture unavailable)');
     const { runId } = create.json as { runId: string };
     await pollUntilTerminal(runId);
     const events = await readAllEvents(runId);
 
     const resolvedIdx = events.findIndex((e) => e.type === 'agent.promptResolved');
     const composedIdx = events.findIndex((e) => e.type === 'prompt.composed');
-    expect(resolvedIdx, 'agent.promptResolved MUST appear in the event log').toBeGreaterThanOrEqual(0);
-    expect(composedIdx, 'prompt.composed MUST appear in the event log').toBeGreaterThanOrEqual(0);
+    expect(resolvedIdx, req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-before-prompt-composed-causal-ordering', 'spec/v1/prompts.md §"Resolution chain (normative)"', 'agent.promptResolved MUST appear in the event log')).toBeGreaterThanOrEqual(0);
+    expect(composedIdx, req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-before-prompt-composed-causal-ordering', 'spec/v1/prompts.md §"Resolution chain (normative)"', 'prompt.composed MUST appear in the event log')).toBeGreaterThanOrEqual(0);
     expect(
       resolvedIdx,
-      driver.describe(
+      req('openwop.it.prompt-end-to-end-events.emits-agent-promptresolved-before-prompt-composed-causal-ordering', 
         'spec/v1/prompts.md §"Resolution chain (normative)"',
         'agent.promptResolved MUST emit BEFORE the corresponding prompt.composed (resolution precedes composition)',
       ),

package/src/scenarios/prompt-list-and-fetch.test.ts

@@ -35,6 +35,8 @@ import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.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?: {
@@ -86,17 +88,17 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const res = await driver.get('/v1/prompts');
-    expect(res.status, driver.describe('spec/v1/prompts.md §Discovery & distribution', 'GET /v1/prompts MUST return 200 when endpointsSupported: true')).toBe(200);
+    expect(res.status, req('openwop.it.prompt-list-and-fetch.get-v1-prompts-returns-items-prompttemplate-nextcursor-when-endpointssupported-i', 'spec/v1/prompts.md §Discovery & distribution', 'GET /v1/prompts MUST return 200 when endpointsSupported: true')).toBe(200);
     const body = res.json as ListResponse;
     expect(
       Array.isArray(body.items),
-      driver.describe('spec/v1/prompts.md §Discovery & distribution', 'response MUST contain an `items` array'),
+      req('openwop.it.prompt-list-and-fetch.get-v1-prompts-returns-items-prompttemplate-nextcursor-when-endpointssupported-i', 'spec/v1/prompts.md §Discovery & distribution', 'response MUST contain an `items` array'),
     ).toBe(true);
     for (const item of body.items) {
       const ok = validate(item);
       expect(
         ok,
-        driver.describe(
+        req('openwop.it.prompt-list-and-fetch.get-v1-prompts-returns-items-prompttemplate-nextcursor-when-endpointssupported-i', 
           'spec/v1/prompts.md §PromptTemplate',
           `every list item MUST validate against prompt-template.schema.json; errors: ${JSON.stringify(validate.errors)}`,
         ),
@@ -113,7 +115,7 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     for (const item of body.items) {
       expect(
         item.meta?.source,
-        driver.describe(
+        req('openwop.it.prompt-list-and-fetch.get-v1-prompts-source-host-narrows-to-host-built-in-templates', 
           'spec/v1/prompts.md §Discovery & distribution',
           'source filter MUST narrow to templates whose meta.source matches',
         ),
@@ -125,7 +127,7 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     const d = await readDiscovery();
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
     const res = await driver.get('/v1/prompts?kind=system');
-    expect(res.status).toBe(200);
+    expect(res.status, req('openwop.it.prompt-list-and-fetch.get-v1-prompts-kind-system-narrows-to-system-kind-templates', 'RFC 0028 §A', 'GET /v1/prompts?kind=system narrows to system-kind templates')).toBe(200);
     const body = res.json as ListResponse;
     for (const item of body.items) {
       expect(item.kind).toBe('system');
@@ -138,9 +140,9 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
 
     // List first to discover a known templateId we can fetch.
     const list = await driver.get('/v1/prompts?source=host&limit=1');
-    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;
-    if (body.items.length === 0) return; // host advertises endpoints but ships no fixtures — tolerable
+    if (body.items.length === 0) return softSkip('inapplicable', 'capability or profile not advertised by this host — gate `body.items.length === 0` returned early (host advertises endpoints but ships no fixtures — tolerable)'); // host advertises endpoints but ships no fixtures — tolerable
     const known = body.items[0]!;
 
     const fetched = await driver.get(`/v1/prompts/${encodeURIComponent(known.templateId)}`);
@@ -153,7 +155,7 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     const etag = fetched.headers?.get('etag');
     expect(
       typeof etag === 'string' && etag.length > 0,
-      driver.describe(
+      req('openwop.it.prompt-list-and-fetch.get-v1-prompts-templateid-returns-the-template-etag-header-for-a-known-fixture', 
         'spec/v1/prompts.md §Discovery & distribution',
         'GET /v1/prompts/{templateId} SHOULD set an ETag header (RFC 0028 §A cache semantics)',
       ),
@@ -164,22 +166,22 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     const d = await readDiscovery();
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
     const list = await driver.get('/v1/prompts?source=host&limit=1');
-    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;
-    if (body.items.length === 0) return;
+    if (body.items.length === 0) return softSkip('blocked', 'precondition not met — `body.items.length === 0` returned early (seam, prior step, or fixture unavailable)');
     const known = body.items[0]!;
 
     const first = await driver.get(`/v1/prompts/${encodeURIComponent(known.templateId)}`);
-    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 etag = first.headers?.get('etag') ?? undefined;
-    if (!etag) return; // ETag is SHOULD, not MUST — soft-skip when absent
+    if (!etag) return softSkip('blocked', 'precondition not met — `!etag` returned early (ETag is SHOULD, not MUST — soft-skip when absent) (seam, prior step, or fixture unavailable)'); // ETag is SHOULD, not MUST — soft-skip when absent
 
     const second = await driver.get(`/v1/prompts/${encodeURIComponent(known.templateId)}`, {
       headers: { 'If-None-Match': etag },
     });
     expect(
       second.status,
-      driver.describe(
+      req('openwop.it.prompt-list-and-fetch.get-v1-prompts-templateid-with-if-none-match-returns-304-when-etag-matches', 
         'spec/v1/prompts.md §Discovery & distribution',
         'conditional revalidation MUST return 304 when ETag matches',
       ),
@@ -198,7 +200,7 @@ describe.skipIf(HTTP_SKIP)('prompt-list-and-fetch: REST surface shape (RFC 0028
     const body = res.json as { error?: unknown; message?: unknown };
     expect(
       typeof body.error,
-      driver.describe(
+      req('openwop.it.prompt-list-and-fetch.get-v1-prompts-unknown-template-returns-404-with-errorenvelope', 
         'schemas/error-envelope.schema.json',
         '404 response MUST carry canonical ErrorEnvelope: `error` is a machine-readable code STRING (flat shape per the schema, not nested)',
       ),

package/src/scenarios/prompt-mutable-lifecycle.test.ts

@@ -36,6 +36,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?: {
@@ -83,7 +85,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const res = await driver.post('/v1/prompts', body);
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.post-v1-prompts-creates-a-user-source-template-201-location', 
         'spec/v1/prompts.md §Discovery & distribution',
         'POST /v1/prompts MUST return 201 on successful user-source create',
       ),
@@ -91,7 +93,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const location = res.headers?.get?.('location');
     expect(
       typeof location === 'string' && location.includes(TEMPLATE_ID),
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.post-v1-prompts-creates-a-user-source-template-201-location', 
         'spec/v1/prompts.md §Discovery & distribution',
         '201 response MUST set a Location header referencing the new templateId',
       ),
@@ -107,7 +109,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     expect(tpl.templateId).toBe(TEMPLATE_ID);
     expect(
       tpl.meta?.source,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.get-v1-prompts-templateid-returns-the-new-template-with-meta-source-user', 
         'spec/v1/prompts.md §PromptTemplate',
         'host MUST stamp meta.source: "user" on POST-created templates',
       ),
@@ -126,7 +128,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const res = await driver.post('/v1/prompts', body);
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.post-v1-prompts-with-same-templateid-version-returns-409', 
         'spec/v1/prompts.md §Discovery & distribution',
         'POST /v1/prompts MUST return 409 on (templateId, version) duplicate',
       ),
@@ -145,7 +147,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const res = await driver.put(`/v1/prompts/${encodeURIComponent(TEMPLATE_ID)}`, body);
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.put-v1-prompts-templateid-with-strictly-greater-semver-replaces-the-template', 
         'spec/v1/prompts.md §Discovery & distribution',
         'PUT /v1/prompts/{templateId} MUST return 200 on monotonic-SemVer update',
       ),
@@ -167,7 +169,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const res = await driver.put(`/v1/prompts/${encodeURIComponent(TEMPLATE_ID)}`, body);
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.put-v1-prompts-templateid-with-non-monotonic-semver-returns-409', 
         'spec/v1/prompts.md §Discovery & distribution',
         'PUT MUST return 409 when submitted version does not exceed stored',
       ),
@@ -180,7 +182,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const del = await driver.delete(`/v1/prompts/${encodeURIComponent(TEMPLATE_ID)}`);
     expect(
       del.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.delete-v1-prompts-templateid-returns-204-and-subsequent-get-returns-404', 
         'spec/v1/prompts.md §Discovery & distribution',
         'DELETE /v1/prompts/{templateId} MUST return 204 on successful delete',
       ),
@@ -188,7 +190,7 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     const after = await driver.get(`/v1/prompts/${encodeURIComponent(TEMPLATE_ID)}`);
     expect(
       after.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.delete-v1-prompts-templateid-returns-204-and-subsequent-get-returns-404', 
         'spec/v1/prompts.md §Discovery & distribution',
         'GET after DELETE MUST return 404',
       ),
@@ -201,14 +203,14 @@ describe.skipIf(HTTP_SKIP)('prompt-mutable-lifecycle: user-source create/update/
     // Find a host-built-in to probe; the conformance-fixture set
     // is the standard source for this test.
     const list = await driver.get('/v1/prompts?source=host&limit=1');
-    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 { items: PromptTemplate[] };
-    if (body.items.length === 0) return;
+    if (body.items.length === 0) return softSkip('blocked', 'precondition not met — `body.items.length === 0` returned early (seam, prior step, or fixture unavailable)');
     const hostTemplate = body.items[0]!;
     const res = await driver.delete(`/v1/prompts/${encodeURIComponent(hostTemplate.templateId)}`);
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-mutable-lifecycle.delete-on-a-host-built-in-template-returns-403', 
         'spec/v1/prompts.md §Discovery & distribution',
         'DELETE on a host-built-in template MUST return 403 (read-only)',
       ),

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

@@ -42,6 +42,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;
 
@@ -70,12 +72,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 mutableLibrary = capabilityFamily(d, 'prompts')?.mutableLibrary;
       if (mutableLibrary !== true) {
         ctx.skip();
-        return;
+        return softSkip('blocked', 'precondition not met — `mutableLibrary !== true` returned early (seam, prior step, or fixture unavailable)');
       }
 
       const nonMemberWorkspaceId =
@@ -96,7 +98,7 @@ describe.skipIf(HTTP_SKIP)(
       // 0028 Tier-2 self-disclosed vulnerability demonstrated.
       expect(
         res.status,
-        driver.describe(
+        req('openwop.it.prompt-mutation-workspace-membership-enforced.post-v1-prompts-with-a-workspaceid-the-principal-is-not-a-member-of-must-not-suc', 
           'spec/v1/prompts.md §Workspace membership on workspace-scoped reads and writes',
           `mutating /v1/prompts MUST refuse a write to a non-member workspace; ` +
             `got ${res.status} ${res.text.slice(0, 200)}`,
@@ -116,7 +118,7 @@ describe.skipIf(HTTP_SKIP)(
         const body = res.json as { error?: unknown } | null;
         expect(
           body?.error,
-          driver.describe(
+          req('openwop.it.prompt-mutation-workspace-membership-enforced.post-v1-prompts-with-a-workspaceid-the-principal-is-not-a-member-of-must-not-suc', 
             'spec/v1/rest-endpoints.md §Common error codes — workspace_membership_required',
             `403 refusal of a workspace-scoped mutation MUST carry error: "workspace_membership_required"; got error: ${JSON.stringify(body?.error)}`,
           ),

package/src/scenarios/prompt-pack-install.test.ts

@@ -47,6 +47,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?: {
@@ -94,7 +96,7 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
     const res = await driver.get('/v1/prompts?source=pack');
     expect(
       res.status,
-      driver.describe(
+      req('openwop.it.prompt-pack-install.get-v1-prompts-source-pack-returns-200-an-array-of-prompttemplate-objects-when-e', 
         'spec/v1/prompts.md §"Discovery & distribution"',
         'GET /v1/prompts MUST return 200 when prompts.endpointsSupported is advertised',
       ),
@@ -103,7 +105,7 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
     const body = res.json as ListResponse;
     expect(
       Array.isArray(body.items),
-      driver.describe(
+      req('openwop.it.prompt-pack-install.get-v1-prompts-source-pack-returns-200-an-array-of-prompttemplate-objects-when-e', 
         'RFCS/0028-prompt-library-endpoints.md §A',
         '`items` MUST be an array of PromptTemplate objects',
       ),
@@ -117,7 +119,7 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
       const packItems = body.items.filter((t) => t.meta?.source === 'pack');
       expect(
         packItems.length,
-        driver.describe(
+        req('openwop.it.prompt-pack-install.get-v1-prompts-source-pack-returns-200-an-array-of-prompttemplate-objects-when-e', 
           'RFCS/0028-prompt-library-endpoints.md §B',
           'OPENWOP_TEST_PROMPT_PACK_INSTALLED=true asserts the boot-time loader installed at least one pack',
         ),
@@ -130,29 +132,29 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const res = await driver.get('/v1/prompts?source=pack');
-    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 body = res.json as ListResponse;
     const packItems = body.items.filter((t) => t.meta?.source === 'pack');
-    if (packItems.length === 0) return; // gated above
+    if (packItems.length === 0) return softSkip('blocked', 'precondition not met — `packItems.length === 0` returned early (gated above) (seam, prior step, or fixture unavailable)'); // gated above
 
     for (const t of packItems) {
       expect(
         t.meta?.source,
-        driver.describe(
+        req('openwop.it.prompt-pack-install.each-pack-source-template-carries-meta-source-packname-packversion-stamps-per-rf', 
           'schemas/prompt-template.schema.json §meta.source',
           'pack-installed templates MUST stamp `meta.source: "pack"`',
         ),
       ).toBe('pack');
       expect(
         typeof t.meta?.packName === 'string' && (t.meta?.packName?.length ?? 0) > 0,
-        driver.describe(
+        req('openwop.it.prompt-pack-install.each-pack-source-template-carries-meta-source-packname-packversion-stamps-per-rf', 
           'RFCS/0028-prompt-library-endpoints.md §B',
           'pack-installed templates MUST stamp `meta.packName`',
         ),
       ).toBe(true);
       expect(
         typeof t.meta?.packVersion === 'string' && /^\d+\.\d+\.\d+/.test(t.meta?.packVersion ?? ''),
-        driver.describe(
+        req('openwop.it.prompt-pack-install.each-pack-source-template-carries-meta-source-packname-packversion-stamps-per-rf', 
           'RFCS/0028-prompt-library-endpoints.md §B',
           'pack-installed templates MUST stamp a semver `meta.packVersion`',
         ),
@@ -165,15 +167,15 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
     if (!behaviorGate('prompts-endpoints', endpointsSupported(d))) return;
 
     const list = await driver.get('/v1/prompts?source=pack');
-    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 writer = body.items.find((t) => t.templateId === 'writer-system' && t.meta?.source === 'pack');
-    if (!writer) return; // host may have installed a different reference pack; skip silently
+    if (!writer) return softSkip('blocked', 'precondition not met — `!writer` returned early (host may have installed a different reference pack; skip silently) (seam, prior step, or fixture unavailable)'); // host may have installed a different reference pack; skip silently
 
     const fetched = await driver.get(`/v1/prompts/${encodeURIComponent('writer-system')}`);
     expect(
       fetched.status,
-      driver.describe(
+      req('openwop.it.prompt-pack-install.get-v1-prompts-templateid-returns-a-pack-source-template-by-id-reference-pack-wr', 
         'RFCS/0028-prompt-library-endpoints.md §A',
         'GET /v1/prompts/{templateId} MUST return 200 for a known pack-source template id',
       ),
@@ -182,7 +184,7 @@ describe.skipIf(HTTP_SKIP)('prompt-pack-install: boot-time loader surfaces pack
     expect(t.templateId).toBe('writer-system');
     expect(
       t.meta?.source,
-      'fetched template MUST preserve `meta.source: "pack"` provenance',
+      req('openwop.it.prompt-pack-install.get-v1-prompts-templateid-returns-a-pack-source-template-by-id-reference-pack-wr', 'RFCS/0028-prompt-library-endpoints.md §A', 'fetched template MUST preserve `meta.source: "pack"` provenance'),
     ).toBe('pack');
   });
 });