@gate-forge/core 0.1.0

package/dist/supervision/index.js

@@ -0,0 +1,354 @@
+/**
+ * Trusted runner supervision — expected-set enforcement (plan
+ * 2026-09-13 Phase 4 work item 4, ADR 0005 D2). The supervisor fixes the
+ * expected test set BEFORE the run (from resolved mappings/catalog
+ * selection) and compares planned versus executed instances after it.
+ * Suite reporter data is INPUT here, never signature authority: a suite
+ * that writes its own report cannot shrink its expected set, hide a
+ * skip, or turn an incomplete shard into success.
+ *
+ * Every problem becomes a typed finding with a plan §5.4 run cause —
+ * `TEST_NOT_EXECUTED` / `TEST_FAILED` / `RUN_INCOMPLETE` — and any
+ * finding fails the whole run (§3.3 rule 5): there is no selective
+ * pass out of a failed required suite.
+ *
+ * Execution authority (enforcement-review fix 2): the runner-reported
+ * outcomes document is suite-writable and is therefore DEMOTED to detail
+ * input. When the supervisor supplies a witness-side `sessionTrace` (the
+ * signing authority's own record of which expected tests opened exactly
+ * one or more sealed sessions, and with which outcomes), supervision
+ * grades completeness from it: every expected test must have at least one
+ * SEALED session whose outcome is 'passed' (parameterized instances of one
+ * expected test produce one session per executed instance; every one of
+ * them must seal passed), no session may remain unsealed, and every traced
+ * test must belong to the expected set. A trace that could not be fetched
+ * (`sessionTrace: null`) blocks the run outright — a missing authority is
+ * never graded as success.
+ *
+ * Pure and deterministic: identical inputs produce identical findings in
+ * identical order.
+ */
+import { compareStrings } from '../graph/util.js';
+import { sha256Canonical } from '../canonical-json.js';
+/** Identity key for planned/executed matching: project + file + titlePath. */
+function instanceKey(project, file, titlePath) {
+    return `${project ?? '-'}\u0000${file}\u0000${titlePath.join('>')}`;
+}
+/**
+ * Enforces the expected test set (ADR 0005 D2). Findings cover, in
+ * deterministic order: zero selected tests, `.only`/`.skip`/`.fixme` in
+ * the required selection, cases the runner never enumerated, retry-
+ * assisted execution, planned instances that never executed, unexpected
+ * executed instances outside the expected set, failed instances,
+ * expected failures, skipped/fixme outcomes, teardown/fixture failures,
+ * shard incompleteness, adapter-judged incompleteness, and a nonzero
+ * runner exit. All are blocking; `complete` is true only when none fired.
+ *
+ * Args:
+ *   planned: the expected set fixed BEFORE the run.
+ *   envelope: the structured execution envelope (input only).
+ *
+ * Returns:
+ *   SupervisionResult: complete flag plus typed findings.
+ */
+export function superviseExecution(planned, envelope) {
+    const findings = [];
+    // Zero selected tests is never a clean run (plan Phase 4 acceptance:
+    // "no-tests case"). Nothing executed means nothing is proven.
+    if (planned.length === 0) {
+        findings.push({
+            cause: 'TEST_NOT_EXECUTED',
+            detail: 'the required selection contains zero tests — an empty run never proves coverage (run or repair the selected suite)',
+            logicalKey: null,
+        });
+    }
+    // Pre-run annotations: `.only`/`.skip`/`.fixme` inside the required
+    // selection block outright — required retries are zero and required
+    // skips do not exist (plan §3.3 rule 5, E08).
+    for (const instance of planned) {
+        for (const annotation of instance.blockingAnnotations) {
+            findings.push({
+                cause: 'TEST_NOT_EXECUTED',
+                detail: `required selection carries a '${annotation}' annotation on '${instance.logicalKey}' ` +
+                    '(`.${annotation}` in a required run is blocking — remove it or drop the case from the required suite)',
+                logicalKey: instance.logicalKey,
+            });
+        }
+        if (instance.unenumeratedReason !== undefined) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `the runner did not enumerate required case '${instance.logicalKey}' ` +
+                    `(${instance.unenumeratedReason}) — the expected set cannot be sealed over an unenumerable case`,
+                logicalKey: instance.logicalKey,
+            });
+        }
+    }
+    // Retry-assisted execution: required retries are zero. Any attempt
+    // above the first invalidates the run regardless of outcome (E08).
+    if (envelope.retriesDetected) {
+        findings.push({
+            cause: 'RUN_INCOMPLETE',
+            detail: `retry-assisted execution detected${envelope.retriesDetail !== undefined ? ` (${envelope.retriesDetail})` : ''} — ` +
+                'required retries are zero; only first-attempt outcomes prove behavior (plan §3.3 rule 3)',
+            logicalKey: null,
+        });
+    }
+    // Planned versus executed: multiset comparison by instance identity
+    // (project + file + titlePath). Reporter rows cannot shrink the set:
+    // every planned instance must appear, and nothing outside it may run.
+    const plannedByKey = new Map();
+    for (const instance of planned) {
+        const key = instanceKey(instance.project, instance.file, instance.titlePath);
+        plannedByKey.set(key, instance);
+    }
+    const executedByLogicalKey = new Map();
+    for (const outcome of envelope.outcomes) {
+        const list = executedByLogicalKey.get(outcome.logicalKey) ?? [];
+        list.push(outcome);
+        executedByLogicalKey.set(outcome.logicalKey, list);
+    }
+    const executedKeys = new Set();
+    for (const outcome of envelope.outcomes) {
+        executedKeys.add(instanceKey(outcome.project, outcome.file, outcome.titlePath));
+    }
+    for (const instance of planned) {
+        const key = instanceKey(instance.project, instance.file, instance.titlePath);
+        if (!executedKeys.has(key)) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `planned instance '${instance.logicalKey}' never executed — a missing selected case blocks the run (plan §3.3 rule 5)`,
+                logicalKey: instance.logicalKey,
+            });
+        }
+    }
+    for (const outcome of envelope.outcomes) {
+        const key = instanceKey(outcome.project, outcome.file, outcome.titlePath);
+        if (!plannedByKey.has(key)) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `executed instance '${outcome.logicalKey}' is outside the planned expected set — ` +
+                    'selective narrowing of the required suite is prohibited (no selective pass out of a failed suite)',
+                logicalKey: outcome.logicalKey,
+            });
+        }
+    }
+    // Per-instance outcomes: every non-pass, every expected failure, and
+    // every skip is a typed block (E07/E08). Attempts are supervision
+    // property too — any attempt above the first is retry-assisted even if
+    // the adapter failed to raise its own flag (fail closed, D2).
+    for (const outcome of envelope.outcomes) {
+        if (outcome.attempt > 1) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `instance '${outcome.logicalKey}' executed on attempt ${String(outcome.attempt)} — ` +
+                    'retry-assisted execution is prohibited (required retries are zero; plan §3.3 rule 3)',
+                logicalKey: outcome.logicalKey,
+            });
+        }
+        if (outcome.status === 'failed' && !outcome.expectedFailure) {
+            findings.push({
+                cause: 'TEST_FAILED',
+                detail: `instance '${outcome.logicalKey}' failed on attempt ${String(outcome.attempt)} — the whole run fails (plan §3.3 rule 5)`,
+                logicalKey: outcome.logicalKey,
+            });
+            continue;
+        }
+        if (outcome.expectedFailure) {
+            findings.push({
+                cause: 'TEST_NOT_EXECUTED',
+                detail: `instance '${outcome.logicalKey}' is an expected failure — an expected-failure exemption never proves behavior (plan §3.3 rule 3)`,
+                logicalKey: outcome.logicalKey,
+            });
+            continue;
+        }
+        if (outcome.status === 'skipped' || outcome.status === 'fixme' || outcome.status === 'not-run') {
+            findings.push({
+                cause: 'TEST_NOT_EXECUTED',
+                detail: `instance '${outcome.logicalKey}' did not execute (status '${outcome.status}') — a skip is never coverage`,
+                logicalKey: outcome.logicalKey,
+            });
+        }
+    }
+    // Setup/teardown/runner-body failures (E07 teardown leg).
+    if (envelope.fixtureOutcome !== 'passed') {
+        findings.push({
+            cause: 'RUN_INCOMPLETE',
+            detail: envelope.fixtureOutcome === 'failed'
+                ? 'the run did not end successfully: a setup, teardown, or runner-level error was observed — fixtures and teardown must pass too (plan §3.3 rule 5)'
+                : 'the run did not report a final fixture/teardown outcome (crash or lost reporter contact) — fail closed',
+            logicalKey: null,
+        });
+    }
+    // Shard completeness (E12 incomplete-shard leg).
+    if (envelope.shards !== null && !envelope.shards.complete) {
+        findings.push({
+            cause: 'RUN_INCOMPLETE',
+            detail: `incomplete shards: ${envelope.shards.detail} — a partial shard run cannot certify the expected set`,
+            logicalKey: null,
+        });
+    }
+    // The adapter's own completeness judgment (timeouts, crashes, lost
+    // reporter data).
+    if (!envelope.complete) {
+        findings.push({
+            cause: 'RUN_INCOMPLETE',
+            detail: envelope.incompleteDetail !== undefined && envelope.incompleteDetail.length > 0
+                ? envelope.incompleteDetail
+                : 'the supervised run did not complete (no detail reported) — fail closed',
+            logicalKey: null,
+        });
+    }
+    // Runner process exit: supplementary, but nonzero is never clean.
+    if (envelope.processExit !== null && envelope.processExit !== 0) {
+        findings.push({
+            cause: 'RUN_INCOMPLETE',
+            detail: `runner process exited with status ${String(envelope.processExit)} — a failed runner never reports a green gate`,
+            logicalKey: null,
+        });
+    }
+    // Execution authority (enforcement-review fix 2b): when a witness-side
+    // session trace was supplied, the runner-reported outcomes are detail
+    // input only — completeness is graded from the trace. A fabricated or
+    // absent outcomes document cannot manufacture execution that the
+    // witness never recorded, and a trace the supervisor could not fetch
+    // blocks outright (fail closed).
+    if (envelope.sessionTrace !== undefined) {
+        findings.push(...gradeSessionTrace(planned, envelope.sessionTrace));
+    }
+    findings.sort((a, b) => compareStrings(a.cause, b.cause) ||
+        compareStrings(a.logicalKey ?? '', b.logicalKey ?? '') ||
+        compareStrings(a.detail, b.detail));
+    return { complete: findings.length === 0, findings };
+}
+/** Identity key shared by planned instances and traced tests. */
+function traceKey(project, file, titlePath) {
+    return `${project ?? '-'}\u0000${file}\u0000${titlePath.join('>')}`;
+}
+/**
+ * Grades the witness-side session trace against the expected set (the
+ * typed core of enforcement-review fix 2). Deterministic findings, in a
+ * stable order:
+ * - a `null` trace (witness wired, trace unfetchable) blocks the run;
+ * - every expected test must have at least one SEALED session whose
+ *   outcome is 'passed' — zero sessions yields the review's exact
+ *   'has no sealed session' cause, an unsealed session or a non-passed
+ *   outcome blocks with its own precise detail;
+ * - every traced test must belong to the expected set (a session for an
+ *   unregistered test cannot hide outside supervision).
+ *
+ * Args:
+ *   planned: the expected set fixed BEFORE the run.
+ *   trace: the witness-side trace (array), or null when unavailable.
+ *
+ * Returns:
+ *   SupervisionFinding[]: the trace-derived findings (possibly empty).
+ */
+function gradeSessionTrace(planned, trace) {
+    if (trace === null) {
+        return [
+            {
+                cause: 'RUN_INCOMPLETE',
+                detail: 'the witness-side execution trace is unavailable — the session record is the execution ' +
+                    'authority and a run without it is never graded complete (fail closed)',
+                logicalKey: null,
+            },
+        ];
+    }
+    const findings = [];
+    const tracedByKey = new Map();
+    for (const traced of trace) {
+        tracedByKey.set(traceKey(traced.project, traced.file, traced.titlePath), traced);
+    }
+    const plannedKeys = new Set();
+    for (const instance of planned) {
+        const key = traceKey(instance.project, instance.file, instance.titlePath);
+        plannedKeys.add(key);
+        const traced = tracedByKey.get(key);
+        if (traced === undefined) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `expected test '${instance.logicalKey}' has no sealed session in the witness trace — ` +
+                    'the witness-side session record is the execution authority; a passing runner-reported ' +
+                    'outcome without a supervisor-sealed session never proves execution',
+                logicalKey: instance.logicalKey,
+            });
+            continue;
+        }
+        if (traced.sessions.length === 0) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `expected test '${instance.logicalKey}' has no sealed session — the witness recorded ` +
+                    'no supervisor-opened session for it, so no execution of it is proven',
+                logicalKey: instance.logicalKey,
+            });
+            continue;
+        }
+        for (const session of traced.sessions) {
+            if (session.sealedTick === null) {
+                findings.push({
+                    cause: 'RUN_INCOMPLETE',
+                    detail: `expected test '${instance.logicalKey}' has an unsealed session (${session.sessionId}) — ` +
+                        'a session the supervisor never closed proves no completed execution',
+                    logicalKey: instance.logicalKey,
+                });
+                continue;
+            }
+            if (session.outcome !== 'passed') {
+                findings.push({
+                    cause: 'RUN_INCOMPLETE',
+                    detail: `expected test '${instance.logicalKey}' sealed session (${session.sessionId}) with ` +
+                        `outcome '${String(session.outcome ?? 'unknown')}' — only sealed passed sessions prove execution`,
+                    logicalKey: instance.logicalKey,
+                });
+                continue;
+            }
+            // No activity requirement here (execution-authority fix): a
+            // genuine passing test that never touches the witness still
+            // executed — the supervisor observed its begin/end through the
+            // trusted reporter channel. Session fabrication is defeated at
+            // the channel (trusted-config synthesis + unknown run-state
+            // paths + lifecycle-conflict detection), not by counting.
+        }
+    }
+    for (const [key, traced] of tracedByKey) {
+        if (!plannedKeys.has(key)) {
+            findings.push({
+                cause: 'RUN_INCOMPLETE',
+                detail: `the witness recorded session(s) for a test outside the expected set ` +
+                    `(${traced.file}#${traced.titlePath.join('>')}) — sessions are minted only for the ` +
+                    'registered expected tests; an unregistered trace entry blocks the run',
+                logicalKey: null,
+            });
+        }
+    }
+    findings.sort((a, b) => compareStrings(a.logicalKey ?? '', b.logicalKey ?? '') ||
+        compareStrings(a.detail, b.detail));
+    return findings;
+}
+/** Domain tag separating expected-set (enumeration) digests from every other hash. */
+export const ENUMERATION_DOMAIN = 'gateforge.enumeration.v1';
+/**
+ * Computes the domain-separated enumeration digest over the expected set
+ * registered with the witness BEFORE the run (enforcement-review fix 2d):
+ * the execution result binds this digest so a receipt names the exact
+ * expected set the witness enforced.
+ *
+ * Args:
+ *   tests: the expected tests (sorted/deduplicated by this function).
+ *
+ * Returns:
+ *   string: 64-char lowercase hex digest.
+ */
+export function enumerationDigestOf(tests) {
+    const normalized = [...tests]
+        .map((test) => ({
+        project: test.project,
+        file: test.file,
+        titlePath: [...test.titlePath],
+    }))
+        .sort((a, b) => compareStrings(a.project ?? '', b.project ?? '') ||
+        compareStrings(a.file, b.file) ||
+        compareStrings(a.titlePath.join('>'), b.titlePath.join('>')));
+    return sha256Canonical({ domain: ENUMERATION_DOMAIN, tests: normalized });
+}
+//# sourceMappingURL=index.js.map

package/dist/supervision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/supervision/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/clock.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Injected clock for fixture runs (fixture harness, G7).
+ *
+ * Gateforge never reads the wall clock at test time: run manifests are
+ * stamped from the injected clock (pin #4) and verdict evaluation
+ * receives `now` (pin #9). `makeClock` produces deterministic `now`
+ * values from a fixed instant, an explicit sequence (e.g. waiver expiry
+ * crossings, GF-16), or a stepping start instant.
+ */
+/**
+ * Minimal clock surface consumed by the gate runner and evaluators.
+ * `now()` always returns canonical ISO-8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`).
+ */
+export interface TestClock {
+    now(): string;
+}
+/** Clock specification: exactly one shape. */
+export type ClockSpec = {
+    fixedAt: string | Date;
+} | {
+    sequence: Array<string | Date>;
+} | {
+    startAt: string | Date;
+    stepMs?: number;
+};
+/**
+ * Normalizes an instant to canonical ISO-8601.
+ *
+ * Args:
+ *   value: ISO-8601 string or Date.
+ *
+ * Returns:
+ *   string: canonical `toISOString()` form.
+ * @throws TypeError on unparseable input (fail loud, never NaN dates).
+ */
+export declare function toIso(value: string | Date): string;
+/**
+ * Builds a deterministic {@link TestClock} from a spec.
+ *
+ * Args:
+ *   spec: `{fixedAt}` (constant), `{sequence}` (ordered instants,
+ *   exhausted = thrown RangeError, never silent repetition), or
+ *   `{startAt, stepMs}` (monotonic stepping).
+ *
+ * Returns:
+ *   TestClock: `now()` yields canonical ISO-8601 instants.
+ * @throws TypeError on an empty sequence or unparseable instants.
+ */
+export declare function makeClock(spec: ClockSpec): TestClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/testing/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GACjB;IACE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1B;IACE,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAAE,GAClC;IACE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExB;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAqCpD"}

package/dist/testing/clock.js

@@ -0,0 +1,75 @@
+/**
+ * Injected clock for fixture runs (fixture harness, G7).
+ *
+ * Gateforge never reads the wall clock at test time: run manifests are
+ * stamped from the injected clock (pin #4) and verdict evaluation
+ * receives `now` (pin #9). `makeClock` produces deterministic `now`
+ * values from a fixed instant, an explicit sequence (e.g. waiver expiry
+ * crossings, GF-16), or a stepping start instant.
+ */
+/**
+ * Normalizes an instant to canonical ISO-8601.
+ *
+ * Args:
+ *   value: ISO-8601 string or Date.
+ *
+ * Returns:
+ *   string: canonical `toISOString()` form.
+ * @throws TypeError on unparseable input (fail loud, never NaN dates).
+ */
+export function toIso(value) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new TypeError(`not a valid instant: ${String(value)}`);
+    }
+    return date.toISOString();
+}
+/**
+ * Builds a deterministic {@link TestClock} from a spec.
+ *
+ * Args:
+ *   spec: `{fixedAt}` (constant), `{sequence}` (ordered instants,
+ *   exhausted = thrown RangeError, never silent repetition), or
+ *   `{startAt, stepMs}` (monotonic stepping).
+ *
+ * Returns:
+ *   TestClock: `now()` yields canonical ISO-8601 instants.
+ * @throws TypeError on an empty sequence or unparseable instants.
+ */
+export function makeClock(spec) {
+    if ('fixedAt' in spec) {
+        const fixed = toIso(spec.fixedAt);
+        return { now: () => fixed };
+    }
+    if ('sequence' in spec) {
+        if (spec.sequence.length === 0) {
+            throw new TypeError('sequence clock requires at least one instant');
+        }
+        const instants = spec.sequence.map(toIso);
+        let index = 0;
+        return {
+            now: () => {
+                if (index >= instants.length) {
+                    throw new RangeError('clock sequence exhausted (fail loud: give the fixture enough instants, never silently repeat)');
+                }
+                const next = instants[index];
+                if (next === undefined) {
+                    throw new RangeError(`clock sequence index ${index} out of range (internal corruption)`);
+                }
+                index += 1;
+                return next;
+            },
+        };
+    }
+    const startMs = Date.parse(toIso(spec.startAt));
+    const stepMs = spec.stepMs ?? 1000;
+    let ticks = 0;
+    return {
+        now: () => {
+            const value = new Date(startMs + stepMs * ticks).toISOString();
+            ticks += 1;
+            return value;
+        },
+    };
+}
+//# sourceMappingURL=clock.js.map

package/dist/testing/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,KAAoB;IACxC,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO;YACL,GAAG,EAAE,GAAG,EAAE;gBACR,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAC7B,MAAM,IAAI,UAAU,CAClB,+FAA+F,CAChG,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,UAAU,CAAC,wBAAwB,KAAK,qCAAqC,CAAC,CAAC;gBAC3F,CAAC;gBACD,KAAK,IAAI,CAAC,CAAC;gBACX,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO;QACL,GAAG,EAAE,GAAG,EAAE;YACR,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC/D,KAAK,IAAI,CAAC,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/env.d.ts

@@ -0,0 +1,66 @@
+import type { ChangedProvider } from '../schemas/run-manifest.js';
+import type { TempRepo } from './temp-repo.js';
+/**
+ * Runs `body` with a patched `process.env`, restoring the previous
+ * environment on every path (sync throw, async rejection, success).
+ * A `undefined` value deletes the variable for the body's duration.
+ *
+ * Args:
+ *   vars: variable name to value (or undefined to unset).
+ *   body: closure to run under the patched environment; may be async.
+ *
+ * Returns:
+ *   The body's return value (awaited when async).
+ */
+export declare function withEnv<V>(vars: Record<string, string | undefined>, body: () => V): V;
+/**
+ * Minimal changed-file provider surface (pin #5 of architecture
+ * contracts). The real providers live with the CLI; fixtures consume
+ * this shape so parity tests run against both halves.
+ */
+export interface ChangedFileProvider {
+    /** Provider identity stamped into the run manifest (pin #4). */
+    provider: ChangedProvider;
+    /**
+     * Repo-root-relative posix paths, deduplicated and codepoint-sorted.
+     */
+    changedFiles(): string[];
+}
+/**
+ * Normalizes a changed-file list: posix separators, deduplicated,
+ * codepoint-sorted. Provider outputs are compared as sets by GF-09.
+ *
+ * Args:
+ *   files: raw provider output.
+ *
+ * Returns:
+ *   string[]: canonical form.
+ */
+export declare function normalizeChangedFiles(files: string[]): string[];
+/**
+ * Builds a fake changed-file provider from an explicit list — the CI
+ * stand-in (`github-pr` / `gitlab-mr` merge-base diff) and the
+ * `all-files` full-scan provider for fixtures. The list is snapshotted
+ * (defensive copy + normalization) at construction.
+ *
+ * Args:
+ *   provider: provider identity this fake impersonates.
+ *   files: raw changed-file list.
+ *
+ * Returns:
+ *   ChangedFileProvider: deterministic, offline, network-free.
+ */
+export declare function fakeProvider(provider: ChangedProvider, files: string[]): ChangedFileProvider;
+/**
+ * Real `local-staged` provider over a {@link TempRepo}: reads the
+ * repository's actual index (`git diff --cached --name-only`) at call
+ * time, so fixtures exercise the genuine local half of GF-09 parity.
+ *
+ * Args:
+ *   repo: the fixture repository.
+ *
+ * Returns:
+ *   ChangedFileProvider: staged files, freshly read on every call.
+ */
+export declare function localStagedProvider(repo: TempRepo): ChangedFileProvider;
+//# sourceMappingURL=env.d.ts.map

package/dist/testing/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/testing/env.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CA+BrF;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,EAAE,eAAe,CAAC;IAC1B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAG5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,mBAAmB,CAEvE"}