@openwop/openwop-conformance 1.128.0 → 1.130.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openwop/openwop-conformance",
-  "version": "1.128.0",
+  "version": "1.130.0",
   "description": "Production-ready black-box conformance suite for OpenWOP v1.0 compliant servers.",
   "repository": {
     "type": "git",

package/schemas/CORPUS-STAMP.json

@@ -1,5 +1,5 @@
 {
   "_comment": "Provenance of this vendored schemas/ copy. See conformance/README.md \u00a7\"Resolving the contract\". Compare against the stamp in your installed @openwop/openwop-conformance to detect a stale hand-copied contract.",
-  "suiteVersion": "1.128.0",
-  "corpusCommit": "04f59e91eb096ce1782b16722599a9d2cfa7aae1"
+  "suiteVersion": "1.130.0",
+  "corpusCommit": "6c603a19a1985f2ae05ef77504e2c189c9ea75bf"
 }

package/schemas/workflow-chain-pack-manifest.schema.json

@@ -490,9 +490,20 @@
               "description": "RFC 0151 §C — an inverse action can itself be harmful (RFC 0147 R9), so it may be gated behind the same approval surface as a forward effect."
             }
           }
+        },
+        "irreversibleEffect": {
+          "type": "boolean",
+          "description": "RFC 0151 §B UQ4 (resolved 2026-08-16), mirrored into chain fragments per RFC 0157 — the fragment author states that this node's committed effect HAS NO INVERSE. Mutually exclusive with `compensation` (host MUST reject both at pack install / chain expansion); expansion copies it onto the expanded `WorkflowNode` unchanged. See `workflow-definition.schema.json` `WorkflowNode.irreversibleEffect`."
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "if": {
+        "properties": { "irreversibleEffect": { "const": true } },
+        "required": ["irreversibleEffect"]
+      },
+      "then": {
+        "not": { "required": ["compensation"] }
+      }
     },
     "FragmentEdge": {
       "type": "object",

package/schemas/workflow-definition.schema.json

@@ -293,9 +293,20 @@
               "description": "RFC 0151 \u00a7C \u2014 an inverse action can itself be harmful (RFC 0147 R9), so it may be gated behind the same approval surface as a forward effect."
             }
           }
+        },
+        "irreversibleEffect": {
+          "type": "boolean",
+          "description": "RFC 0151 \u00a7B (UQ4, resolved 2026-08-16) \u2014 the author states that this node's committed effect HAS NO INVERSE. OPTIONAL; absent or false means nothing (an undeclared compensator is still not implied). Mutually exclusive with `compensation`: a node declaring both is contradictory and a host MUST reject it at registration (`validation_error`). When true and the node's effect committed before an unwind starts, the plan records the node as `irreversible` (never completed) so the \u00a7D rollup caps at `partial` \u2014 a reader can no longer infer a full undo from a `completed` that quietly skipped it."
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "if": {
+        "properties": { "irreversibleEffect": { "const": true } },
+        "required": ["irreversibleEffect"]
+      },
+      "then": {
+        "not": { "required": ["compensation"] }
+      }
     },
     "WorkflowEdge": {
       "type": "object",

package/src/lib/workflow-chain-expansion.ts

@@ -353,10 +353,31 @@ export interface ChainCompensationPolicy {
 /** A chain as RFC 0157 sees it: the RFC 0013 shape plus the two optional
  *  compensation surfaces. */
 export type WorkflowChainWithCompensation = Omit<WorkflowChain, 'dag'> & {
-  dag: { nodes: ReadonlyArray<FragmentNode & { compensation?: FragmentNodeCompensation }>; edges?: ReadonlyArray<FragmentEdge> };
+  dag: {
+    nodes: ReadonlyArray<FragmentNode & { compensation?: FragmentNodeCompensation; irreversibleEffect?: boolean }>;
+    edges?: ReadonlyArray<FragmentEdge>;
+  };
   compensation?: ChainCompensationPolicy;
 };
 
+/** Thrown when a fragment node declares BOTH `irreversibleEffect: true` and a
+ *  `compensation` (RFC 0151 UQ4 / `compensation.md` §B): a contradiction the
+ *  schema also rejects; expansion refuses it fail-closed rather than pick one.
+ *  Wire code `chain_irreversible_with_compensation`. */
+export class ChainIrreversibleWithCompensationError extends Error {
+  readonly code = 'chain_irreversible_with_compensation' as const;
+  constructor(
+    public readonly nodeId: string,
+    public readonly chainId: string,
+  ) {
+    super(
+      `chain_irreversible_with_compensation: fragment node "${nodeId}" in chain "${chainId}" declares both ` +
+        'irreversibleEffect: true and a compensation — an effect cannot both have and lack an inverse',
+    );
+    this.name = 'ChainIrreversibleWithCompensationError';
+  }
+}
+
 /** Thrown when the parent already carries a `settings.compensation` policy that
  *  is not deep-equal to the chain's. Wire code
  *  `chain_compensation_policy_conflict` (`workflow-chain-packs.md` §"Error
@@ -412,8 +433,9 @@ function canonicalJson(v: unknown): string {
 
 export interface CarriedCompensation {
   /** The expanded fragment with `compensation` carried onto each node that
-   *  declared one (typeIds validated, params substituted, id refs rewritten). */
-  nodes: ReadonlyArray<ExpandedFragment['nodes'][number] & { compensation?: FragmentNodeCompensation }>;
+   *  declared one (typeIds validated, params substituted, id refs rewritten)
+   *  and `irreversibleEffect` copied verbatim where declared. */
+  nodes: ReadonlyArray<ExpandedFragment['nodes'][number] & { compensation?: FragmentNodeCompensation; irreversibleEffect?: boolean }>;
   /** The `settings.compensation` the registered definition MUST carry after
    *  this expansion: the parent's when the chain declares none; the chain's
    *  when the parent had none; the (equal) shared policy when both agree.
@@ -433,11 +455,15 @@ export interface CarriedCompensation {
  *       literals; the recorded-facts rule is unaffected);
  *   6b. fragment node-id references inside `inputMapping` are rewritten with
  *       the expansion prefix, exactly as edge refs are;
+ *   6c. `irreversibleEffect: true` (RFC 0151 UQ4) is copied onto the expanded
+ *       node unchanged; a fragment node declaring both it and a `compensation`
+ *       is refused (`chain_irreversible_with_compensation`) — the schema rejects
+ *       the shape too, and expansion does not pick a side;
  *   9b. the chain-level policy becomes the definition's `settings.compensation`
  *       — copied when the parent has none, accepted when equal, otherwise
  *       `chain_compensation_policy_conflict`.
  *
- * @throws ChainUnresolvableTypeIdError, ChainCompensationPolicyConflictError
+ * @throws ChainUnresolvableTypeIdError, ChainCompensationPolicyConflictError, ChainIrreversibleWithCompensationError
  */
 export function carryCompensation(
   chain: WorkflowChainWithCompensation,
@@ -450,17 +476,21 @@ export function carryCompensation(
   const fragmentNodeIds = new Set(srcNodes.map((n) => n.id));
   const byOriginalId = new Map(srcNodes.map((n) => [n.id, n] as const));
 
-  // 3b
+  // 3b (+ 6c's contradiction check, before any node is emitted)
   for (const n of srcNodes) {
+    if (n.irreversibleEffect === true && n.compensation !== undefined) {
+      throw new ChainIrreversibleWithCompensationError(n.id, chain.chainId);
+    }
     if (n.compensation !== undefined && !ctx.isTypeIdResolvable(n.compensation.nodeTypeId)) {
       throw new ChainUnresolvableTypeIdError(n.compensation.nodeTypeId, chain.chainId);
     }
   }
 
-  // 5b + 6b
+  // 5b + 6b + 6c
   const nodes = expanded.nodes.map((en) => {
     const originalId = en.id.startsWith(prefix) ? en.id.slice(prefix.length) : en.id;
     const src = byOriginalId.get(originalId);
+    if (src?.irreversibleEffect === true) return { ...en, irreversibleEffect: true };
     if (src?.compensation === undefined) return en;
     const c: FragmentNodeCompensation = { nodeTypeId: src.compensation.nodeTypeId };
     if (src.compensation.inputMapping !== undefined) {

package/src/scenarios/chain-compensation-expansion.test.ts

@@ -49,6 +49,7 @@ import {
   expandChainWithCompensation,
   ChainUnresolvableTypeIdError,
   ChainCompensationPolicyConflictError,
+  ChainIrreversibleWithCompensationError,
   type WorkflowChainWithCompensation,
   type ChainCompensationPolicy,
   type FragmentNodeCompensation,
@@ -162,6 +163,33 @@ describe('RFC 0157 — schema: the chain manifest mirrors the compensation shape
     noTriggers.compensation = {};
     expect(validate(manifestWith(noTriggers)), 'a policy without triggers is not a policy').toBe(false);
   });
+
+  it('FragmentNode.irreversibleEffect (RFC 0151 UQ4) is a sibling boolean, mutually exclusive with compensation — in the manifest and in expansion', () => {
+    const validate = manifestValidator();
+    // The `notify` node declares no compensation; stating its effect is irreversible is valid.
+    const irreversible = structuredClone(CHAIN) as unknown as { dag: { nodes: Array<Record<string, unknown>> } };
+    const notifyIdx = irreversible.dag.nodes.findIndex((n) => n['id'] === 'notify');
+    expect(notifyIdx).toBeGreaterThanOrEqual(0);
+    irreversible.dag.nodes[notifyIdx]!['irreversibleEffect'] = true;
+    expect(validate(manifestWith(irreversible)), JSON.stringify(validate.errors)).toBe(true);
+    // Expansion copies it verbatim onto the expanded node (6c) and touches nothing else.
+    const out = expandChainWithCompensation(irreversible as unknown as typeof CHAIN, CTX);
+    const notify = out.nodes.find((n) => n.id.endsWith('_notify')) as { irreversibleEffect?: boolean; compensation?: unknown } | undefined;
+    expect(notify?.irreversibleEffect).toBe(true);
+    expect(notify?.compensation).toBeUndefined();
+    // Both on one node: the schema rejects it AND expansion refuses fail-closed before emitting.
+    const both = structuredClone(CHAIN) as unknown as { dag: { nodes: Array<Record<string, unknown>> } };
+    both.dag.nodes[0]!['irreversibleEffect'] = true; // node 0 (`reserve`) declares a compensation
+    expect(validate(manifestWith(both)), 'compensation.md §B: irreversibleEffect: true + compensation is contradictory').toBe(false);
+    let thrown: unknown;
+    try {
+      expandChainWithCompensation(both as unknown as typeof CHAIN, CTX);
+    } catch (e) {
+      thrown = e;
+    }
+    expect(thrown).toBeInstanceOf(ChainIrreversibleWithCompensationError);
+    expect((thrown as ChainIrreversibleWithCompensationError).code).toBe('chain_irreversible_with_compensation');
+  });
 });
 
 describe('RFC 0157 — expansion carries the declaration and the policy', () => {

package/src/scenarios/compensation-profile.test.ts

@@ -130,6 +130,20 @@ describe('RFC 0151 §B — node compensation declaration', () => {
     expect(validate({ ...base }), JSON.stringify(validate.errors)).toBe(true);
   });
 
+  it('irreversibleEffect (RFC 0151 UQ4) is a sibling boolean, mutually exclusive with a compensation declaration', () => {
+    // A statement that the effect HAS NO INVERSE. Sibling of `compensation`, so
+    // `nodeTypeId` stays required and COMPATIBILITY §2.2 is not engaged.
+    expect(validate({ ...base, irreversibleEffect: true }), JSON.stringify(validate.errors)).toBe(true);
+    expect(validate({ ...base, irreversibleEffect: false, compensation: { nodeTypeId: 'vendor.shop.release' } }), JSON.stringify(validate.errors)).toBe(true);
+    // Both = an effect that both has and lacks an inverse. The schema rejects it
+    // (`if irreversibleEffect === true then not required compensation`).
+    expect(
+      validate({ ...base, irreversibleEffect: true, compensation: { nodeTypeId: 'vendor.shop.release' } }),
+      'compensation.md §B: a node declaring both irreversibleEffect: true and compensation is contradictory and MUST be rejected',
+    ).toBe(false);
+    expect(validate({ ...base, irreversibleEffect: 'yes' }), 'irreversibleEffect is a boolean').toBe(false);
+  });
+
   it('the declaration is closed — an unknown key is rejected', () => {
     expect(
       validate({ ...base, compensation: { nodeTypeId: 'x', onFailure: 'ignore' } }),

package/src/scenarios/compensation-recovery.test.ts

@@ -0,0 +1,195 @@
+/**
+ * RFC 0151 §C / §E / §B+§F — the compensation RECOVERY witness: retry-stable
+ * identity, tenant-bound operator authority, recorded-facts-only inputs.
+ *
+ * `compensation-behavior.test.ts` proves the happy unwind: plan before effect,
+ * reverse order, replay does not re-fire, content-free events, rollup ⇄ events.
+ * RFC 0151 §G names three further invariants that file cannot see, and
+ * `SECURITY/threat-model-compensation.md` §7 said so and named the seam each
+ * one needs. This file is that seam's consumer (`host-sample-test-seams.md` §21
+ * "Recovery extension"):
+ *
+ *   - **`compensation-effect-id-retry-stable`** (§C). `unwind` with
+ *     `failFirstInverseAttempts: 2`: the first inverse action fails twice then
+ *     succeeds. The response's `inverseActions[]` MUST show one entry for that
+ *     ordinal with `attempts: 3` and a SINGLE distinct `downstreamKeys` value —
+ *     one obligation, three attempts, the same idempotency key at the
+ *     downstream every time. Two keys is two refunds.
+ *   - **`compensation-tenant-authority-bound`** (§E). `unwind` with `hold: true`
+ *     leaves a held plan (`compensationStatus: manual`); the `operator` seam is
+ *     then driven three times — a cross-tenant actor (404: RFC 0132 §A.2,
+ *     neutralize, do not reveal), a same-tenant non-operator (403, audited),
+ *     the operator (200, `audited: true`). A seam that answers 200 to all
+ *     three consults nothing.
+ *   - **`compensation-input-recorded-facts-only`** (§B/§F). `replay` reports the
+ *     inverse actions of the source run and of the replay with the input each
+ *     executed with; they MUST deep-equal while `refiredEffects` stays 0. An
+ *     inverse built from a re-derived value is not the inverse of what was
+ *     done, and replay is where re-derivation would happen.
+ *
+ * Every leg is capability-gated on `compensation.supported` via `behaviorGate`
+ * (soft-skips without the advert, HARD-FAILS under `OPENWOP_REQUIRE_BEHAVIOR=true`)
+ * and records its RFC 0148 §A disposition. The three sub-features are
+ * INDEPENDENTLY optional: a host that wires the base seams but not this
+ * extension is `blocked` here (named as such via `seamAbsent`) and keeps its
+ * `compensation-behavior` witness — the base and the extension are different
+ * claims and are recorded separately.
+ */
+
+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 { seamAbsent } from '../lib/soft-skip.js';
+import { readErrorCode, readRetriable } from '../lib/error-envelope.js';
+
+const PROFILE = 'openwop-compensation';
+const UNWIND = '/v1/host/sample/test/compensation/unwind';
+const REPLAY = '/v1/host/sample/test/compensation/replay';
+const OPERATOR = '/v1/host/sample/test/compensation/operator';
+
+interface InverseAction {
+  readonly ordinal?: number;
+  readonly effectId?: string;
+  readonly attempts?: number;
+  readonly outcome?: string;
+  readonly downstreamKeys?: readonly string[];
+  readonly input?: unknown;
+}
+
+interface UnwindResponse {
+  readonly runId?: string;
+  readonly events?: ReadonlyArray<{ type?: string; payload?: Record<string, unknown> }>;
+  readonly compensatedOrder?: readonly number[];
+  readonly inverseActions?: readonly InverseAction[];
+}
+
+interface ReplayResponse {
+  readonly runId?: string;
+  readonly refiredEffects?: number;
+  readonly source?: readonly InverseAction[];
+  readonly replayed?: readonly InverseAction[];
+}
+
+async function advertised(): Promise<boolean> {
+  const disco = await driver.get('/.well-known/openwop');
+  return capabilityFamily<{ supported?: boolean }>(disco.json, 'compensation')?.supported === true;
+}
+
+async function post(path: string, body: Record<string, unknown>): Promise<{ status: number; json: unknown } | null> {
+  const r = await driver.post(path, body);
+  if (r.status === 404 && path !== OPERATOR) {
+    seamAbsent(`host advertises \`compensation.supported: true\` but ${path} answered 404 — the RFC 0151 recovery requirements are unobservable (host-sample-test-seams.md §21)`);
+    return null;
+  }
+  return { status: r.status, json: r.json };
+}
+
+/** The recovery extension is optional; a base seam that ignores the new fields is `blocked` here, not failed. */
+function extensionAbsent(what: string): undefined {
+  return seamAbsent(`the §21 recovery extension is not wired: ${what} (host-sample-test-seams.md §21 "Recovery extension") — retry-stability / operator authority / recorded-facts are unobservable`);
+}
+
+describe('RFC 0151 §C — inverse-action identity is retry-stable (capability-gated behavior)', () => {
+  it('a transient inverse failure retries under the SAME identity and the same downstream key', async () => {
+    if (!behaviorGate(PROFILE, await advertised())) return;
+    const r = await post(UNWIND, { nodes: 2, failFirstInverseAttempts: 2 });
+    if (r === null) return;
+    expect(r.status, driver.describe('spec/v1/host-sample-test-seams.md §21', 'unwind seam answers 200')).toBe(200);
+    const body = r.json as UnwindResponse;
+    if (!Array.isArray(body.inverseActions)) return extensionAbsent('`unwind` did not return `inverseActions[]`');
+    // Under reverse-completion the first inverse to run is the highest forward ordinal (2).
+    const first = body.inverseActions.find((a) => a.ordinal === 2) ?? body.inverseActions[0];
+    expect(first, driver.describe('spec/v1/host-sample-test-seams.md §21', 'one entry per plan entry')).toBeDefined();
+    const a = first as InverseAction;
+    expect(a.attempts, driver.describe('RFCS/0151 §C', 'two transient failures then success is THREE attempts of one obligation')).toBe(3);
+    expect(a.outcome, driver.describe('RFCS/0151 §C', 'a transient failure MUST be retryable — the action completes')).toBe('completed');
+    expect(Array.isArray(a.downstreamKeys) ? a.downstreamKeys.length : -1, driver.describe('spec/v1/host-sample-test-seams.md §21', '`downstreamKeys` has one entry per attempt')).toBe(3);
+    const distinct = new Set(a.downstreamKeys ?? []);
+    expect(
+      distinct.size,
+      driver.describe(
+        'RFCS/0151 §C + RFC 0150 §B',
+        'a retry re-presents the SAME inverse-action identity as its idempotency key — a second key at the downstream is a second obligation (two refunds). `attempt` is outside the identity for exactly this reason.',
+      ),
+    ).toBe(1);
+    // One obligation per ordinal: no duplicate plan entries.
+    const ordinals = body.inverseActions.map((x) => x.ordinal);
+    expect(new Set(ordinals).size, driver.describe('RFCS/0151 §C', 'exactly one plan entry per forward ordinal')).toBe(ordinals.length);
+    expect(typeof a.effectId === 'string' && a.effectId.length > 0, driver.describe('RFCS/0151 §D', 'the identity is carried as an opaque `effectId`')).toBe(true);
+  });
+});
+
+describe('RFC 0151 §E — operator authority is bound to the plan\'s tenant (capability-gated behavior)', () => {
+  it('cross-tenant is neutralized (404), same-tenant non-operator is refused and audited (403), the operator acts (200)', async () => {
+    if (!behaviorGate(PROFILE, await advertised())) return;
+    const held = await post(UNWIND, { nodes: 2, hold: true });
+    if (held === null) return;
+    const body = held.json as UnwindResponse;
+    const runId = body.runId;
+    if (typeof runId !== 'string') return extensionAbsent('`unwind` did not return a `runId`');
+    const heldEntry = (body.inverseActions ?? []).find((x) => x.outcome === 'held');
+    const manual = (body.events ?? []).some((e) => e.type === 'compensation.manual_intervention_required');
+    if (heldEntry === undefined && !manual) return extensionAbsent('`unwind` with `hold: true` produced neither a held plan entry nor `compensation.manual_intervention_required`');
+    // Snapshot must read `manual` while held (§D fold).
+    const snap = await driver.get(`/v1/runs/${encodeURIComponent(runId)}`);
+    expect(snap.status, driver.describe('rest-endpoints.md', 'GET /v1/runs/{runId} for the held run')).toBe(200);
+    expect((snap.json as { compensationStatus?: string }).compensationStatus, driver.describe('spec/v1/compensation.md §D', 'a held plan reads `manual`')).toBe('manual');
+
+    const op = async (actor: Record<string, unknown>) =>
+      driver.post(OPERATOR, { runId, action: 'retry', actor });
+    // 1. Cross-tenant actor: neutralize to the actor's tenant, do not reveal.
+    const cross = await op({ tenantId: 'conformance-other-tenant', principalId: 'conformance-operator', operator: true });
+    if (cross.status === 404 && readErrorCode(cross.json) === undefined && (cross.json === null || cross.json === undefined || Object.keys(cross.json as object).length === 0)) {
+      return extensionAbsent(`${OPERATOR} answered a bodiless 404 — the operator seam is absent (an absent seam and a neutralized cross-tenant plan must be told apart by the envelope: RFC 0132 §A.2 answers \`not_found\` in the canonical envelope)`);
+    }
+    expect(cross.status, driver.describe('RFCS/0151 §E + RFC 0132 §A.2', 'an actor from another tenant MUST NOT learn the plan exists — 404, not 403')).toBe(404);
+    expect(readErrorCode(cross.json), driver.describe('rest-endpoints.md §Error codes', '`not_found` — do not leak existence')).toBe('not_found');
+    // 2. Same tenant, no operator authority: refused AND audited.
+    const plain = await op({ tenantId: 'default', principalId: 'conformance-bystander', operator: false });
+    expect(plain.status, driver.describe('RFCS/0151 §E', 'a principal without operator authority in the plan\'s tenant is refused')).toBe(403);
+    expect(readErrorCode(plain.json), driver.describe('rest-endpoints.md §Error codes', '`forbidden`')).toBe('forbidden');
+    expect(readRetriable(plain.json), driver.describe('spec/v1/host-sample-test-seams.md §21', 'a refused override is not retriable')).toBe(false);
+    // 3. The operator: acts, audited, rollup moves off `manual`.
+    const ok = await op({ tenantId: 'default', principalId: 'conformance-operator', operator: true });
+    expect(ok.status, driver.describe('RFCS/0151 §E', 'an authorized operator MAY retry a held inverse action')).toBe(200);
+    const res = ok.json as { compensationStatus?: string; audited?: boolean; planVersion?: unknown };
+    expect(res.audited, driver.describe('RFCS/0151 §E', 'every override MUST be audited (`authorization.decided`)')).toBe(true);
+    expect(
+      ['completed', 'partial', 'failed', 'running'],
+      driver.describe('spec/v1/compensation.md §D', 'after the operator retries, the rollup is whatever the recorded outcomes yield — never still `manual` for a resolved hold'),
+    ).toContain(res.compensationStatus);
+    // The refusal in step 2 was audited too: the plan's events carry a reason.
+    const after = await driver.get(`/v1/runs/${encodeURIComponent(runId)}/events`);
+    if (after.status === 200) {
+      const evs = (after.json as { events?: Array<{ type?: string; payload?: Record<string, unknown> }> }).events ?? [];
+      const decided = evs.filter((e) => e.type === 'authorization.decided');
+      expect(decided.length, driver.describe('RFCS/0151 §E + RFC 0049', 'both the refusal and the override are `authorization.decided` records')).toBeGreaterThanOrEqual(2);
+    }
+  });
+});
+
+describe('RFC 0151 §B/§F — inverse inputs are recorded facts, not re-derived (capability-gated behavior)', () => {
+  it('a replay executes the same inverse actions with the same inputs, and re-fires nothing', async () => {
+    if (!behaviorGate(PROFILE, await advertised())) return;
+    const r = await post(REPLAY, {});
+    if (r === null) return;
+    expect(r.status, driver.describe('spec/v1/host-sample-test-seams.md §21', 'replay seam answers 200')).toBe(200);
+    const body = r.json as ReplayResponse;
+    if (!Array.isArray(body.source) || !Array.isArray(body.replayed)) return extensionAbsent('`replay` did not return `source[]` / `replayed[]`');
+    expect(body.refiredEffects, driver.describe('RFCS/0151 §F', 'replay MUST NOT re-fire inverse effects')).toBe(0);
+    expect(body.source.length, driver.describe('spec/v1/host-sample-test-seams.md §21', 'the source run had inverse actions to compare')).toBeGreaterThan(0);
+    const norm = (xs: readonly InverseAction[]) =>
+      [...xs].sort((a, b) => (a.ordinal ?? 0) - (b.ordinal ?? 0)).map((x) => ({ ordinal: x.ordinal, effectId: x.effectId, input: x.input }));
+    expect(
+      norm(body.replayed),
+      driver.describe(
+        'RFCS/0151 §B + §F',
+        'a replay uses the RECORDED inverse inputs and identities — an inverse built from a re-derived (prompt / model / live) value is not the inverse of what was actually done',
+      ),
+    ).toEqual(norm(body.source));
+    for (const x of body.source) {
+      expect(x.input, driver.describe('RFCS/0151 §B', 'each inverse action executed with a recorded input')).toBeDefined();
+    }
+  });
+});