@tokenfactory/acc-runner 0.42.0 → 0.44.0

package/dist/node-version.d.ts

@@ -0,0 +1,132 @@
+/** Worktree-relative path of the file `nvm use` reads. */
+export declare const NVMRC_REL = ".nvmrc";
+/**
+ * Explicit escape hatch: a bin dir containing the node the gates must run under.
+ * Set it on a host whose node lives outside every layout below. Trusted as
+ * declared — the version behind it is not re-verified (that would cost a spawn).
+ */
+export declare const NODE_BIN_DIR_ENV = "ACC_RUNNER_NODE_BIN_DIR";
+/** Where a pin was declared. */
+export type NodePinSource = ".nvmrc" | "package.json engines.node";
+export interface NodePin {
+    /** The pin normalised without a leading `v` (`22`, `22.20.0`). */
+    spec: string;
+    /** Major version — the part that actually has to match. */
+    major: number;
+    /** Full `x.y.z` when the pin names one; null for a major-only pin. */
+    exact: string | null;
+    source: NodePinSource;
+}
+/** Version-manager on-disk layouts this module knows how to walk. */
+export type NodeInstallLayout = "nvm" | "fnm" | "volta" | "asdf" | "n";
+/** How `binDir` was arrived at. */
+export type NodeResolutionSource = "current" | "explicit" | NodeInstallLayout | "unresolved" | "unpinned";
+export interface PinnedNodeResolution {
+    /** The repo's pin, or null when it declares none. */
+    pin: NodePin | null;
+    /**
+     * The node version the gates will run under, when knowable: the picked
+     * install's version, or the current process's. Null only for `explicit`
+     * (declared by the operator, deliberately not re-verified).
+     */
+    effective: string | null;
+    /**
+     * True when the node the gates will run under satisfies the pin — and also
+     * true when there is no pin to violate. False means "we ran under the wrong
+     * node and could not fix it", which is exactly the signal that turns a jsdom
+     * failure into an ENVIRONMENT fault rather than a code defect.
+     */
+    satisfied: boolean;
+    /**
+     * Dir to prepend to PATH so `node` (and therefore `pnpm`, whose shim shebangs
+     * `#!/usr/bin/env node`) resolves to the pinned install. Null when the current
+     * node is already right, or when nothing matching was found.
+     */
+    binDir: string | null;
+    source: NodeResolutionSource;
+    /** One-line, log-safe explanation for the runner log. Never contains secrets. */
+    note: string;
+}
+export interface NodeVersionDeps {
+    /** Env source. Default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Home dir the version-manager layouts hang off. Default `os.homedir()`. */
+    homedir?: string;
+    /** The running node's version (`v22.20.0` or `22.20.0`). Default `process.version`. */
+    currentVersion?: string;
+    /** Read a text file. Default `fs.readFile(abs, "utf8")`; rejects when absent. */
+    readTextFile?: (abs: string) => Promise<string>;
+    /** List a directory's entry names. Default `fs.readdir`; rejects when absent. */
+    listDir?: (abs: string) => Promise<string[]>;
+    /** True when `abs` exists and is executable. Default `fs.access(X_OK)`. */
+    isExecutable?: (abs: string) => Promise<boolean>;
+}
+/**
+ * The version a `.nvmrc` names, normalised without the leading `v`. Comments and
+ * blank lines are skipped (nvm allows both). Returns null for an ALIAS
+ * (`lts/*`, `node`, `stable`, `iron`) — resolving one needs nvm's alias table,
+ * and guessing is worse than reporting "unpinned" and falling back to `engines`.
+ */
+export declare function parseNvmrc(text: string): string | null;
+/**
+ * The major version an `engines.node` RANGE requires, as a major-only pin
+ * (`">=22 <23"` → `22`, `"22.x"` → `22`, `"^22.20.0"` → `22`). A range is a
+ * range: even when it names a patch we only ever pin the major, so `>=22.20.0
+ * <23` is satisfied by 22.21.0. Returns null when no number can be read.
+ */
+export declare function parseEnginesRange(range: string): string | null;
+/** Build a `NodePin` from a normalised spec, or null when it is unusable. */
+export declare function nodePinFrom(spec: string, source: NodePinSource): NodePin | null;
+/** `[major, minor, patch]` of a version string, or null when unparseable. */
+export declare function parseNodeVersion(v: string): [number, number, number] | null;
+/** Ascending comparison; unparseable versions sort first. */
+export declare function compareNodeVersions(a: string, b: string): number;
+/**
+ * True when `version` satisfies `pin`: the major must match, and when the pin
+ * names an exact `x.y.z` that must match too. An unparseable version satisfies
+ * nothing (fail closed — an unknown node is not assumed correct).
+ */
+export declare function satisfiesPin(version: string, pin: NodePin): boolean;
+/**
+ * The HIGHEST version in `versions` that satisfies `pin`, or null when none
+ * does. Highest, not first: on a host with 22.11.0 and 22.20.0 installed the
+ * newer patch is the one CI's `node-version: 22` would resolve to.
+ */
+export declare function pickPinnedInstall(versions: string[], pin: NodePin): string | null;
+export interface NodeInstallRoot {
+    layout: NodeInstallLayout;
+    /** Directory whose entries are version names (`v22.20.0` or `22.20.0`). */
+    dir: string;
+    /** The `bin` dir for one entry of `dir`. */
+    binDirFor: (entry: string) => string;
+}
+/**
+ * Version-manager roots to search, in preference order. Honours each manager's
+ * own env override so a non-default install location still resolves. Directories
+ * that do not exist are simply skipped by the caller — listing them is the probe.
+ */
+export declare function nodeInstallRoots(env: NodeJS.ProcessEnv, homedir: string): NodeInstallRoot[];
+/**
+ * Prepend `binDir` to a launchd-safe PATH (see bin-resolve.ts) so the pinned
+ * node wins every lookup — including `pnpm`'s own shebang, which is what makes
+ * the whole `pnpm run test` subtree inherit it. Idempotent: an already-leading
+ * `binDir` is not duplicated.
+ */
+export declare function withPinnedNodePath(env: NodeJS.ProcessEnv, binDir: string | null): NodeJS.ProcessEnv;
+/**
+ * The repo's declared node pin: `.nvmrc` first (it is what a human's `nvm use`
+ * obeys, so runner and human never disagree), then `package.json`
+ * `engines.node`. Null when neither declares a readable version.
+ */
+export declare function readRepoNodePin(workdir: string, deps?: NodeVersionDeps): Promise<NodePin | null>;
+/**
+ * Resolve which node the repo's gates must run under, and where it is.
+ *
+ * Order: no pin → nothing to enforce; current node satisfies → run as-is (the
+ * common case, and it costs one file read); `ACC_RUNNER_NODE_BIN_DIR` →
+ * trusted as declared; then each version-manager layout, highest matching patch
+ * wins; finally `unresolved`, which the caller surfaces rather than papering
+ * over.
+ */
+export declare function resolvePinnedNode(workdir: string, deps?: NodeVersionDeps): Promise<PinnedNodeResolution>;
+//# sourceMappingURL=node-version.d.ts.map

package/dist/node-version.d.ts.map

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

package/dist/node-version.js

@@ -0,0 +1,318 @@
+/**
+ * TESTENV-NODE-PIN: resolve the node version the REPO pins, not the one the
+ * runner happens to be launched with.
+ *
+ * WHY THIS EXISTS
+ * ----------------------------------------------------------------------------
+ * The pre-PR gate (prepr-gate.ts) runs the repo's own `pnpm test` inside the task
+ * worktree. It inherited the runner process's node — on the fleet's macOS host a
+ * Homebrew node 26 — while CI, which is authoritative and green, runs node 22
+ * (`actions/setup-node` `node-version: 22` in every workflow). jsdom 25's DOM is
+ * incomplete under node 23+: `window.localStorage` is absent, so zustand's
+ * persist middleware gets an undefined storage and EVERY store-backed UI suite
+ * dies with `Cannot read properties of undefined (reading 'setItem')`. The gate
+ * read that as "this task broke the UI suites", refused to open the PR, and the
+ * task dead-lettered — a pure false-fail (it near-rejected #1836 as INFRA).
+ *
+ * So the gate must stop trusting whatever `node` is first on PATH. This module
+ * answers one question — "which node does THIS repo want, and where is it on
+ * this host?" — and hands back a bin dir to prepend to PATH. The runner's global
+ * node then no longer matters.
+ *
+ * Read order for the pin: `.nvmrc` (what `nvm use` reads, so humans and the
+ * runner agree), then `package.json` `engines.node`. A `.nvmrc` alias this module
+ * cannot resolve without nvm's alias table (`lts/*`, `node`, `stable`) is treated
+ * as NO pin rather than guessed at.
+ *
+ * Discovery covers the version managers actually found on runner hosts (nvm, fnm,
+ * volta, asdf, n) plus an explicit `ACC_RUNNER_NODE_BIN_DIR` escape hatch for a
+ * host that installs node anywhere else. Nothing is ever installed or downloaded:
+ * when no matching node exists the resolution says so (`satisfied: false`) and
+ * the caller degrades — it is diagnosis, never a silent second failure mode.
+ *
+ * Every I/O boundary is an injectable dep, so the unit suite drives the whole
+ * resolver over a fake host filesystem and never reads the real one.
+ */
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs/promises";
+import { augmentedPathFrom } from "./bin-resolve.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+/** Worktree-relative path of the file `nvm use` reads. */
+export const NVMRC_REL = ".nvmrc";
+/**
+ * Explicit escape hatch: a bin dir containing the node the gates must run under.
+ * Set it on a host whose node lives outside every layout below. Trusted as
+ * declared — the version behind it is not re-verified (that would cost a spawn).
+ */
+export const NODE_BIN_DIR_ENV = "ACC_RUNNER_NODE_BIN_DIR";
+// ─────────────────────────────────────────────────────────────────────────────
+// Pure parsing / comparison helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * The version a `.nvmrc` names, normalised without the leading `v`. Comments and
+ * blank lines are skipped (nvm allows both). Returns null for an ALIAS
+ * (`lts/*`, `node`, `stable`, `iron`) — resolving one needs nvm's alias table,
+ * and guessing is worse than reporting "unpinned" and falling back to `engines`.
+ */
+export function parseNvmrc(text) {
+    for (const raw of text.split("\n")) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const m = /^v?(\d+(?:\.\d+){0,2})$/.exec(line);
+        return m ? m[1] : null;
+    }
+    return null;
+}
+/**
+ * The major version an `engines.node` RANGE requires, as a major-only pin
+ * (`">=22 <23"` → `22`, `"22.x"` → `22`, `"^22.20.0"` → `22`). A range is a
+ * range: even when it names a patch we only ever pin the major, so `>=22.20.0
+ * <23` is satisfied by 22.21.0. Returns null when no number can be read.
+ */
+export function parseEnginesRange(range) {
+    const m = /(\d+)/.exec(range);
+    return m ? m[1] : null;
+}
+/** Build a `NodePin` from a normalised spec, or null when it is unusable. */
+export function nodePinFrom(spec, source) {
+    const parts = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?$/.exec(spec.trim());
+    if (!parts)
+        return null;
+    const major = Number(parts[1]);
+    const exact = parts[2] !== undefined && parts[3] !== undefined
+        ? `${parts[1]}.${parts[2]}.${parts[3]}`
+        : null;
+    return { spec: spec.trim(), major, exact, source };
+}
+/** `[major, minor, patch]` of a version string, or null when unparseable. */
+export function parseNodeVersion(v) {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(v.trim());
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+/** Ascending comparison; unparseable versions sort first. */
+export function compareNodeVersions(a, b) {
+    const pa = parseNodeVersion(a);
+    const pb = parseNodeVersion(b);
+    if (!pa)
+        return pb ? -1 : 0;
+    if (!pb)
+        return 1;
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] !== pb[i])
+            return pa[i] - pb[i];
+    }
+    return 0;
+}
+/**
+ * True when `version` satisfies `pin`: the major must match, and when the pin
+ * names an exact `x.y.z` that must match too. An unparseable version satisfies
+ * nothing (fail closed — an unknown node is not assumed correct).
+ */
+export function satisfiesPin(version, pin) {
+    const parsed = parseNodeVersion(version);
+    if (!parsed)
+        return false;
+    if (parsed[0] !== pin.major)
+        return false;
+    if (pin.exact)
+        return `${parsed[0]}.${parsed[1]}.${parsed[2]}` === pin.exact;
+    return true;
+}
+/**
+ * The HIGHEST version in `versions` that satisfies `pin`, or null when none
+ * does. Highest, not first: on a host with 22.11.0 and 22.20.0 installed the
+ * newer patch is the one CI's `node-version: 22` would resolve to.
+ */
+export function pickPinnedInstall(versions, pin) {
+    const matching = versions.filter((v) => satisfiesPin(v, pin));
+    if (matching.length === 0)
+        return null;
+    return matching.sort(compareNodeVersions)[matching.length - 1];
+}
+/**
+ * Version-manager roots to search, in preference order. Honours each manager's
+ * own env override so a non-default install location still resolves. Directories
+ * that do not exist are simply skipped by the caller — listing them is the probe.
+ */
+export function nodeInstallRoots(env, homedir) {
+    const nvm = env.NVM_DIR?.trim() || path.join(homedir, ".nvm");
+    const fnm = env.FNM_DIR?.trim() || path.join(homedir, ".fnm");
+    const asdf = env.ASDF_DATA_DIR?.trim() || path.join(homedir, ".asdf");
+    const nPrefix = env.N_PREFIX?.trim() || "/usr/local";
+    const volta = path.join(homedir, ".volta", "tools", "image", "node");
+    const nvmVersions = path.join(nvm, "versions", "node");
+    const fnmVersions = path.join(fnm, "node-versions");
+    const asdfVersions = path.join(asdf, "installs", "nodejs");
+    const nVersions = path.join(nPrefix, "n", "versions", "node");
+    return [
+        { layout: "nvm", dir: nvmVersions, binDirFor: (e) => path.join(nvmVersions, e, "bin") },
+        {
+            layout: "fnm",
+            dir: fnmVersions,
+            // fnm nests the install under `installation/`.
+            binDirFor: (e) => path.join(fnmVersions, e, "installation", "bin"),
+        },
+        { layout: "volta", dir: volta, binDirFor: (e) => path.join(volta, e, "bin") },
+        { layout: "asdf", dir: asdfVersions, binDirFor: (e) => path.join(asdfVersions, e, "bin") },
+        { layout: "n", dir: nVersions, binDirFor: (e) => path.join(nVersions, e, "bin") },
+    ];
+}
+/**
+ * Prepend `binDir` to a launchd-safe PATH (see bin-resolve.ts) so the pinned
+ * node wins every lookup — including `pnpm`'s own shebang, which is what makes
+ * the whole `pnpm run test` subtree inherit it. Idempotent: an already-leading
+ * `binDir` is not duplicated.
+ */
+export function withPinnedNodePath(env, binDir) {
+    const augmented = augmentedPathFrom(env.PATH);
+    if (!binDir)
+        return { ...env, PATH: augmented };
+    const parts = augmented.split(":").filter((p) => p !== binDir);
+    return { ...env, PATH: [binDir, ...parts].join(":") };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Default I/O
+// ─────────────────────────────────────────────────────────────────────────────
+async function defaultReadTextFile(abs) {
+    return fs.readFile(abs, "utf8");
+}
+async function defaultListDir(abs) {
+    return fs.readdir(abs);
+}
+async function defaultIsExecutable(abs) {
+    try {
+        await fs.access(abs, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// The resolver
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * The repo's declared node pin: `.nvmrc` first (it is what a human's `nvm use`
+ * obeys, so runner and human never disagree), then `package.json`
+ * `engines.node`. Null when neither declares a readable version.
+ */
+export async function readRepoNodePin(workdir, deps = {}) {
+    const readTextFile = deps.readTextFile ?? defaultReadTextFile;
+    try {
+        const spec = parseNvmrc(await readTextFile(path.join(workdir, NVMRC_REL)));
+        if (spec) {
+            const pin = nodePinFrom(spec, ".nvmrc");
+            if (pin)
+                return pin;
+        }
+    }
+    catch {
+        // No .nvmrc (or unreadable) — fall through to engines.
+    }
+    try {
+        const raw = JSON.parse(await readTextFile(path.join(workdir, "package.json")));
+        const range = raw?.engines?.node;
+        if (typeof range === "string") {
+            const spec = parseEnginesRange(range);
+            if (spec)
+                return nodePinFrom(spec, "package.json engines.node");
+        }
+    }
+    catch {
+        // Missing/unparseable package.json — no pin.
+    }
+    return null;
+}
+/**
+ * Resolve which node the repo's gates must run under, and where it is.
+ *
+ * Order: no pin → nothing to enforce; current node satisfies → run as-is (the
+ * common case, and it costs one file read); `ACC_RUNNER_NODE_BIN_DIR` →
+ * trusted as declared; then each version-manager layout, highest matching patch
+ * wins; finally `unresolved`, which the caller surfaces rather than papering
+ * over.
+ */
+export async function resolvePinnedNode(workdir, deps = {}) {
+    const env = deps.env ?? process.env;
+    const homedir = deps.homedir ?? os.homedir();
+    const current = (deps.currentVersion ?? process.version).replace(/^v/, "");
+    const isExecutable = deps.isExecutable ?? defaultIsExecutable;
+    const listDir = deps.listDir ?? defaultListDir;
+    const pin = await readRepoNodePin(workdir, deps);
+    if (!pin) {
+        return {
+            pin: null,
+            effective: current,
+            satisfied: true,
+            binDir: null,
+            source: "unpinned",
+            note: `repo declares no node version (no ${NVMRC_REL}, no engines.node) — running gates under node ${current}`,
+        };
+    }
+    if (satisfiesPin(current, pin)) {
+        return {
+            pin,
+            effective: current,
+            satisfied: true,
+            binDir: null,
+            source: "current",
+            note: `node ${current} satisfies the repo pin ${pin.spec} (${pin.source})`,
+        };
+    }
+    const explicit = env[NODE_BIN_DIR_ENV]?.trim();
+    if (explicit) {
+        if (await isExecutable(path.join(explicit, "node"))) {
+            return {
+                pin,
+                effective: null,
+                satisfied: true,
+                binDir: explicit,
+                source: "explicit",
+                note: `node ${current} does not satisfy the repo pin ${pin.spec} (${pin.source}); ` +
+                    `using ${NODE_BIN_DIR_ENV}=${explicit} as declared (version not re-verified)`,
+            };
+        }
+        // A set-but-broken override is a configuration bug worth naming; keep
+        // searching the layouts rather than failing outright.
+    }
+    for (const root of nodeInstallRoots(env, homedir)) {
+        let entries;
+        try {
+            entries = await listDir(root.dir);
+        }
+        catch {
+            continue; // manager not installed here
+        }
+        const picked = pickPinnedInstall(entries, pin);
+        if (!picked)
+            continue;
+        const binDir = root.binDirFor(picked);
+        if (!(await isExecutable(path.join(binDir, "node"))))
+            continue;
+        return {
+            pin,
+            effective: picked.replace(/^v/, ""),
+            satisfied: true,
+            binDir,
+            source: root.layout,
+            note: `node ${current} does not satisfy the repo pin ${pin.spec} (${pin.source}) — ` +
+                `running gates under ${root.layout} node ${picked.replace(/^v/, "")} (${binDir})`,
+        };
+    }
+    return {
+        pin,
+        effective: current,
+        satisfied: false,
+        binDir: null,
+        source: "unresolved",
+        note: `node ${current} does not satisfy the repo pin ${pin.spec} (${pin.source}) and no ` +
+            `matching install was found (searched nvm/fnm/volta/asdf/n) — gates will run under ` +
+            `node ${current}; install it (e.g. \`nvm install ${pin.major}\`) or set ` +
+            `${NODE_BIN_DIR_ENV} to its bin dir`,
+    };
+}
+//# sourceMappingURL=node-version.js.map

package/dist/node-version.js.map

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

package/dist/prepr-gate.d.ts

@@ -1,3 +1,4 @@
+import { type PinnedNodeResolution } from "./node-version.js";
 export type PreprGateName = "nul-check" | "scope" | "typecheck" | "lint" | "build" | "test" | "migration-lint";
 /**
  * Run order. typecheck → lint → build → test mirrors the CLAUDE.md quality-gate
@@ -62,6 +63,21 @@ export interface PreprGateResult {
         /** Tail of the failing suite's output — kept for the operator. */
         outputTail: string;
     };
+    /**
+     * TESTENV-NODE-PIN: set when the `test` gate FAILED for ENVIRONMENT reasons
+     * (`needs-env`) rather than because of anything this task changed. `ok` stays
+     * `true` and no `failure` is set — a broken test environment is an INFRA fault,
+     * never a code-defect gate failure. The caller logs `reviewerNotice` verbatim so
+     * the reviewer classifies it as INFRA instead of rejecting the PR.
+     */
+    testEnvironmentFailure?: TestEnvironmentFailure;
+    /**
+     * TESTENV-NODE-PIN: which node the gates actually ran under, and how it was
+     * resolved against the repo's `.nvmrc` / `engines.node`. Present whenever the
+     * gate resolved a pin (i.e. for the default gate runner); `satisfied: false`
+     * means the host had no matching node and the gates ran off-pin. Log-safe.
+     */
+    node?: PinnedNodeResolution;
     /**
      * MIGFIX-01: set when the pre-PR auto-renumber (opt-in) renamed a NEW migration
      * to the next contiguous seq before the seq-lint ran. `output` is the
@@ -212,6 +228,21 @@ export interface PreprGateDeps {
      * task-runner.ts, outside this track's scope.
      */
     loadKnownTestFailures?: (workdir: string) => Promise<PreprKnownFailures | null>;
+    /**
+     * TESTENV-NODE-PIN: resolve the node the gates must run under (the repo's
+     * `.nvmrc` / `engines.node`) and where it lives on this host. Default:
+     * `resolvePinnedNode` — but only when `runGate` is NOT injected, because an
+     * injected gate runner owns its own environment and the unit suite must not
+     * touch the host's node installs. Inject explicitly to drive the pin logic
+     * (including the off-pin case) in tests.
+     */
+    resolveNode?: (workdir: string) => Promise<PinnedNodeResolution>;
+    /**
+     * TESTENV-NODE-PIN: classify a failed `test` gate's output as an environment
+     * fault or not. Default: `classifyTestEnvironmentFailure`. Injectable so a repo
+     * with a different test stack can supply its own signatures.
+     */
+    classifyTestEnvironment?: (output: string, ctx: TestEnvironmentContext) => TestEnvironmentVerdict;
     /**
      * RF-14: recover the failing test ids from the failed `test` gate's own output.
      * Default: `extractVitestFailures` (parses vitest's `FAIL <file> > <name>`
@@ -247,6 +278,88 @@ export interface PreprTestFailureScan {
      */
     complete: boolean;
 }
+/** The single classification this module assigns to an environment fault. */
+export declare const NEEDS_ENV_CLASSIFICATION: "needs-env";
+/**
+ * Prefix the reviewer already recognises for a harness fault it must not blame the
+ * PR for (`api/_lib/reviewer-agent.ts` emits the same shape for a truncated diff).
+ * Reusing the exact wording is deliberate: it is how "not a defect" travels.
+ */
+export declare const INFRA_NOTICE_PREFIX = "INFRA NOTICE \u2014";
+export interface TestEnvironmentSignature {
+    /** Stable id, used in logs and asserted by the unit suite. */
+    id: string;
+    re: RegExp;
+    /**
+     * HARD signatures are environment faults on any host: the test environment
+     * itself could not be loaded, so no assertion in the suite ever ran and the
+     * result says nothing about the task's code.
+     *
+     * SOFT signatures are DOM-shaped symptoms that a code defect could also
+     * produce (`document is not defined` in a suite that forgot its environment).
+     * They only count as environment when the suite provably ran under a node the
+     * repo does not pin — otherwise they block exactly as before.
+     */
+    hard: boolean;
+    /** Operator-facing explanation of what the signature means. */
+    hint: string;
+}
+/**
+ * Signatures of "the test ENVIRONMENT is broken", not "the code is broken".
+ * Ordered most-specific first; the first match wins.
+ */
+export declare const TEST_ENVIRONMENT_SIGNATURES: TestEnvironmentSignature[];
+/** What the classifier knows about the node the suite ran under. */
+export interface TestEnvironmentContext {
+    /**
+     * True when the suite provably ran under a node that does NOT satisfy the
+     * repo's pin. This is what promotes a SOFT signature to an environment fault.
+     */
+    nodeMismatch?: boolean;
+    /** The repo's pin (`22`), for the notice. */
+    pin?: string | null;
+    /** The node the suite actually ran under, when known. */
+    effective?: string | null;
+}
+export interface TestEnvironmentVerdict {
+    /** True → `needs-env`: report as INFRA, never block the PR. */
+    environment: boolean;
+    /** Id of the matched signature, or null when nothing matched. */
+    signature: string | null;
+    /** Log-safe reason, whichever way it went. */
+    reason: string;
+}
+/** The reported shape of an environment-classified `test` gate failure. */
+export interface TestEnvironmentFailure {
+    classification: typeof NEEDS_ENV_CLASSIFICATION;
+    /** Which signature matched (see `TEST_ENVIRONMENT_SIGNATURES`). */
+    signature: string;
+    reason: string;
+    /** The gate command's exit code (null on signal). */
+    exitCode: number | null;
+    /** The reviewer-facing INFRA notice — log/PR-safe, quote verbatim. */
+    reviewerNotice: string;
+    /** Tail of the failing suite's own output, kept for the operator. */
+    outputTail: string;
+}
+/**
+ * Decide whether a red `test` gate is an ENVIRONMENT fault (`needs-env`) rather
+ * than a defect in the task's code.
+ *
+ * Fails CLOSED in both directions that matter: an output matching nothing is not
+ * an environment fault, and a DOM-shaped (SOFT) match on a host whose node DOES
+ * satisfy the repo pin is not one either — there the symptom really is the suite's
+ * own problem, and blocking is correct. Only a HARD signature (the environment
+ * never loaded, so nothing was actually tested) is trusted unconditionally.
+ */
+export declare function classifyTestEnvironmentFailure(output: string, ctx?: TestEnvironmentContext): TestEnvironmentVerdict;
+/**
+ * The reviewer-facing body of an environment-classified `test` failure. Opens with
+ * the prefix the reviewer already treats as "harness fault, not a defect", names
+ * the signature and the node facts, and states the required handling explicitly so
+ * neither the reviewer nor the rework loop charges it to the PR.
+ */
+export declare function formatTestEnvironmentNotice(verdict: TestEnvironmentVerdict, ctx: TestEnvironmentContext, outputTail: string): string;
 /**
  * Text-source extensions the NUL/binary check scans. An allowlist (never a
  * binary denylist) so genuine binary assets — images, fonts, the design export —
@@ -445,6 +558,13 @@ export declare function formatNewTestFailures(newFailures: string[], preExisting
  * Returns `{ ok: true, skipped: true }` when the escape hatch is set, and
  * `{ ok: true, ran: [] }` (a clean pass) when the worktree declares none of
  * the four gate scripts.
+ *
+ * TESTENV-NODE-PIN: the gates run under the node the WORKTREE pins (`.nvmrc`, else
+ * `engines.node`) whenever this call owns the gate environment — `result.node`
+ * records which node that was and how it was found. A `test` gate that fails with a
+ * test-ENVIRONMENT signature does not set `failure` at all: it comes back
+ * `ok: true` with `testEnvironmentFailure` (`needs-env`), whose `reviewerNotice`
+ * the caller should log verbatim so the reviewer reads it as INFRA.
  */
 export declare function runPreprGate(workdir: string, deps?: PreprGateDeps): Promise<PreprGateResult>;
 //# sourceMappingURL=prepr-gate.d.ts.map

package/dist/prepr-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepr-gate.d.ts","sourceRoot":"","sources":["../src/prepr-gate.ts"],"names":[],"mappings":"AA6CA,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,OAAO,GACP,WAAW,GACX,MAAM,GACN,OAAO,GACP,MAAM,GACN,gBAAgB,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,EAA2C,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,GAAG,EAAE,aAAa,EAAE,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE;QACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,uDAAuD;QACvD,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QACZ,yEAAyE;QACzE,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE;QACpB,2EAA2E;QAC3E,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,yDAAyD;QACzD,MAAM,EAAE,MAAM,CAAC;QACf,kEAAkE;QAClE,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE;;;;OAIG;IACH,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,KAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CAAC,EAAE,CACtB,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACxC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,oBAAoB,CAAC;CAChE;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,aAS1B,CAAC;AAEH,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAUpF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBjD;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAW1E;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAKT;AAQD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAGlE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAKT;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAKT;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,oDAAoD,CAAC;AAEzF,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EAAE,GACd;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAQlD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAgBrE;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAa1E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAQtD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CASxD;AAqKD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAyCD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAeR;AAeD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,eAAe,CAAC,CA+N1B"}
+{"version":3,"file":"prepr-gate.d.ts","sourceRoot":"","sources":["../src/prepr-gate.ts"],"names":[],"mappings":"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"}