@codyswann/lisa 4.28.4 → 4.29.0

package/dist/configs/vitest/scratch.js

@@ -1,301 +1,34 @@
 /**
- * Vitest Configuration - Bounded, self-reclaiming test scratch space
+ * Bounded, self-reclaiming Vitest scratch lifecycle.
  *
- * Test fixtures create temporary directories by calling `mkdtemp` against
- * `os.tmpdir()`. Left alone, every one of those lands directly in the platform
- * temp root — on macOS the shared per-user directory under `/var`, which is
- * never emptied while the machine is up.
- *
- * That is a ratchet rather than a slowdown. Cleanup in a suite is written as
- * `afterEach`, `afterAll` or `try`/`finally`, and all three are IN-PROCESS
- * callbacks: when the runner is killed — SIGKILL, `exit 137`, which is how this
- * failed in practice — none of them run and every directory the run had open is
- * abandoned. A run that dies enlarges the directory the next run depends on, so
- * the next run is slower and likelier to die.
- *
- * Measured on one saturated workstation, against a directory this module
- * governs on the same machine at the same moment:
- *
- * ```
- *                                 shared platform root      inside a run root
- * inode size (stat -f %z)              24,902,496 bytes             64 bytes
- * one stat()                                189.9 ms                 0.2 ms
- * five mkdtemp() calls                   35,619.7 ms                 0.8 ms
- * ```
- *
- * Seven seconds for a single `mkdtemp`. A fixture creating two directories
- * exhausted a 60-second budget having done no work, which is why every symptom
- * of this was a timeout and never an assertion failure.
- *
- * Three properties, each chosen against a specific way the previous state
- * failed:
- *
- * 1. **One entry, ever.** Everything lives under a single `lisa-scratch`
- *    directory in the platform temp root, so a project contributes ONE name to
- *    the shared directory regardless of how many fixtures it creates. The
- *    expensive lookup is paid once per process instead of once per fixture.
- * 2. **Wholesale teardown.** A run's directories nest under one per-process
- *    root, so ending a run is a single recursive removal rather than hundreds
- *    of cooperating call sites.
- * 3. **Reclaim on start, not on exit.** A process that is SIGKILLed cannot run
- *    cleanup — no design can make it. So the residue of a killed run is
- *    reclaimed by the NEXT run instead: roots are named with the pid that owns
- *    them, and a sweep removes any whose owner is gone. This is the only
- *    mechanism that survives an abnormal exit, and it is why the loop above
- *    cannot restart.
- *
- * Deliberately NOT repo-local. A scratch root inside the project would give
- * every fixture two ancestors it must not have: the repository's `.git` (so a
- * fixture asserting "not a git repository" would find the project's) and the
- * repository's `node_modules` (so a fixture asserting a dependency is absent
- * would resolve the project's copy). Both change what fixtures mean, which is a
- * worse defect than the one being fixed.
+ * Every fixture directory lives under one platform-temp namespace and one
+ * per-process owned root. The public facade stays deliberately small: naming,
+ * authority, startup sweeping, transactional allocation, and token-bound
+ * teardown live in focused sibling modules.
  * @module configs/vitest/scratch
  */
-import { randomBytes } from "node:crypto";
 import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { env } from "node:process";
-/**
- * Single directory name every Lisa scratch root nests under.
- *
- * The name is the contract: it is what makes "one entry in the shared temp
- * root, ever" checkable, and what the sweep enumerates instead of the
- * (unenumerable) platform root.
- */
-export const SCRATCH_NAMESPACE = "lisa-scratch";
-/** Prefix identifying a per-process run root inside the namespace. */
-export const RUN_ROOT_PREFIX = "run-";
-/**
- * Backstop age after which a run root is reclaimed even though its recorded pid
- * still resolves to a live process.
- *
- * Pids are recycled, so liveness alone can pin an abandoned root forever if an
- * unrelated process happens to inherit its number. Six hours is longer than any
- * legitimate suite and short enough that a recycled pid cannot hold a root
- * across a working day.
- */
-export const DEFAULT_RECLAIM_AGE_MS = 6 * 60 * 60 * 1000;
-/** Environment variable that relocates the namespace away from the platform temp root. */
-export const SCRATCH_ROOT_ENV = "LISA_TEST_SCRATCH_ROOT";
-/**
- * Resolves the directory the namespace lives in.
- *
- * Honours `LISA_TEST_SCRATCH_ROOT` first so an operator or CI job can point
- * scratch space at a specific volume, then `os.tmpdir()` — which itself re-reads
- * `TMPDIR` on every call, so the pre-existing `export TMPDIR=...` mitigation
- * composes with this rather than being defeated by it.
- * @returns Absolute path to the directory containing the scratch namespace.
- */
-export const scratchBaseDir = () => {
-    const override = env[SCRATCH_ROOT_ENV];
-    return override !== undefined && override.trim() !== ""
-        ? override
-        : os.tmpdir();
-};
-/**
- * Absolute path of the shared namespace directory.
- * @returns Path to `<base>/lisa-scratch`.
- */
-export const scratchNamespaceDir = () => path.join(scratchBaseDir(), SCRATCH_NAMESPACE);
-/**
- * Builds the name of a per-process run root.
- *
- * The pid is encoded in the name because it is the only durable record of who
- * owns the directory: a killed process leaves no other trace, and the sweep has
- * to tell an abandoned root from one a sibling run is using right now.
- * @param pid - Owning process id
- * @param startedAt - Epoch milliseconds the root was created
- * @param suffix - Random suffix disambiguating two roots created in the same millisecond
- * @returns The directory name, without any leading path.
- */
-export const runRootName = (pid, startedAt, suffix) => `${RUN_ROOT_PREFIX}${pid}-${startedAt}-${suffix}`;
-/**
- * Recovers the pid and creation time encoded in a run root's name.
- * @param name - A directory name from inside the namespace
- * @returns The owner, or `undefined` when the name was not produced by {@link runRootName}.
- */
-export const parseRunRootName = (name) => {
-    // Derived from RUN_ROOT_PREFIX rather than spelled out again. A literal here
-    // would let the writer and the reader drift apart, and the failure mode of
-    // that drift is the worst one available: creation keeps working, the sweep
-    // silently matches nothing, and the namespace fills while every run passes.
-    const match = new RegExp(`^${RUN_ROOT_PREFIX}(\\d+)-(\\d+)-[^-]+$`).exec(name);
-    if (match === null) {
-        return undefined;
-    }
-    const pid = Number(match[1]);
-    const startedAt = Number(match[2]);
-    return Number.isSafeInteger(pid) && Number.isSafeInteger(startedAt)
-        ? { pid, startedAt }
-        : undefined;
-};
-/**
- * Decides whether a namespace entry is abandoned residue.
- *
- * A name this module did not produce is not judged here — see
- * {@link isStaleForeignEntry}, which reclaims it on age alone. Deleting another
- * tool's fresh data is not this sweep's business; leaving it forever would let
- * one stray directory wedge every future run.
- * @param input - The entry and the facts needed to judge it
- * @param input.name - Directory name inside the namespace
- * @param input.now - Current epoch milliseconds
- * @param input.isProcessAlive - Liveness probe for the recorded pid
- * @param input.maxAgeMs - Age after which a live-pid root is reclaimed anyway
- * @param input.selfName - Caller's own root name, never reclaimed
- * @returns True when the entry may be removed.
- */
-export const isReclaimable = ({ name, now, isProcessAlive, maxAgeMs = DEFAULT_RECLAIM_AGE_MS, selfName, }) => {
-    if (selfName !== undefined && name === selfName) {
-        return false;
-    }
-    const owner = parseRunRootName(name);
-    if (owner === undefined) {
-        return false;
-    }
-    if (now - owner.startedAt > maxAgeMs) {
-        return true;
-    }
-    return !isProcessAlive(owner.pid);
-};
 /**
- * Reports whether a pid resolves to a running process.
+ * Remove a non-authoritative fixture directory on a best-effort basis.
  *
- * `kill(pid, 0)` sends no signal; it only asks the kernel whether the target
- * exists. `EPERM` means it exists and belongs to someone else, which still
- * counts as alive.
- * @param pid - Process id to probe
- * @returns True when a process with that id exists.
- */
-export const isProcessAlive = (pid) => {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return error.code === "EPERM";
-    }
-};
-/**
- * Decides whether an entry this module did not create may be removed.
- *
- * Age is the only signal available: a foreign name carries no owner, so there is
- * nothing to ask the kernel about. Reclaiming on the same backstop the pid arm
- * uses means the namespace self-heals from anything parked in it — an older
- * release's naming scheme, a stray `mktemp` — without this sweep ever deleting
- * something a live tool is still writing to.
- *
- * The alternative was to treat a foreign name as a hard failure. That was tried
- * and rejected: it wedges permanently on one stray directory, and the message a
- * downstream user gets — "run roots must be named by runRootName()" — names
- * something they cannot act on.
- * @param entryPath - Absolute path of the entry
- * @param now - Current epoch milliseconds
- * @param maxAgeMs - Age past which a foreign entry is reclaimed
- * @returns True when the entry is old enough to remove.
- */
-export const isStaleForeignEntry = (entryPath, now, maxAgeMs) => {
-    try {
-        return now - fs.statSync(entryPath).mtimeMs > maxAgeMs;
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Lists the namespace's direct children, treating an absent namespace as empty.
- *
- * A directory that cannot be read is not a directory that is empty — but for the
- * one case that occurs here, the namespace not existing yet, the two are the
- * same answer and every caller wants to continue rather than fail.
- * @param dir - Namespace directory to list
- * @returns The entry names, or an empty list.
- */
-export const readNamespaceEntries = (dir) => {
-    try {
-        return fs.readdirSync(dir);
-    }
-    catch {
-        return [];
-    }
-};
-/**
- * Removes abandoned run roots from the namespace.
- *
- * This is the arm of the design that survives a kill. It runs at the START of a
- * run precisely because the run that leaked cannot be the one to clean up.
- * @param options - Sweep inputs
- * @param options.dir - Namespace directory to sweep
- * @param options.now - Current epoch milliseconds
- * @param options.isProcessAlive - Liveness probe for recorded pids
- * @param options.maxAgeMs - Age after which a live-pid root is reclaimed anyway
- * @param options.selfName - Caller's own root name, never reclaimed
- * @returns Which entries were removed and which were kept.
- */
-export const sweepScratchNamespace = ({ dir = scratchNamespaceDir(), now = Date.now(), isProcessAlive: alive = isProcessAlive, maxAgeMs = DEFAULT_RECLAIM_AGE_MS, selfName, } = {}) => readNamespaceEntries(dir).reduce((acc, name) => {
-    const entryPath = path.join(dir, name);
-    const decision = {
-        name,
-        now,
-        isProcessAlive: alive,
-        maxAgeMs,
-        ...(selfName === undefined ? {} : { selfName }),
-    };
-    const reclaimable = parseRunRootName(name) === undefined
-        ? name !== selfName && isStaleForeignEntry(entryPath, now, maxAgeMs)
-        : isReclaimable(decision);
-    if (!reclaimable) {
-        return { removed: acc.removed, kept: [...acc.kept, name] };
-    }
-    try {
-        fs.rmSync(entryPath, { recursive: true, force: true });
-    }
-    catch {
-        // A root another process is removing right now races us here. Losing
-        // that race is the correct outcome and is not worth failing a run over.
-        return { removed: acc.removed, kept: [...acc.kept, name] };
-    }
-    return { removed: [...acc.removed, name], kept: acc.kept };
-}, { removed: [], kept: [] });
-/**
- * Creates a run root owned by the current process and returns its path.
- * @param options - Overrides for the namespace directory and clock
- * @param options.dir - Namespace directory to create the root inside
- * @param options.now - Epoch milliseconds recorded in the root's name
- * @returns Absolute path of this process's run root.
- */
-export const createRunRoot = ({ dir = scratchNamespaceDir(), now = Date.now(), } = {}) => {
-    const suffix = randomBytes(4).toString("hex");
-    const root = path.join(dir, runRootName(process.pid, now, suffix));
-    fs.mkdirSync(root, { recursive: true });
-    return root;
-};
-/**
- * Reclaims abandoned roots, then allocates one for this process.
- *
- * The order is the point, and it is why this is one function rather than two
- * calls at the call site: reclaiming AFTER allocating leaves a window in which
- * the namespace holds both, and reclaiming somewhere else entirely is how a
- * caller ends up allocating without ever reclaiming at all.
- * @param dir - Namespace directory
- * @returns Absolute path of the newly created run root.
- */
-export const reclaimAndCreateRunRoot = (dir) => {
-    sweepScratchNamespace({ dir });
-    return createRunRoot({ dir });
-};
-/**
- * Removes a directory tree, ignoring an already-absent path.
- * @param dir - Directory to remove
+ * Owned run-root teardown must use `removeOwnedScratchRunRoot`; this helper is
+ * retained only for nested fixture compatibility, where the next bounded sweep
+ * can recover residue.
+ * @param dir - Nested fixture directory to remove
  */
 export const removeScratchDir = (dir) => {
     try {
         fs.rmSync(dir, { recursive: true, force: true });
     }
     catch {
-        // Best effort: residue that resists removal is reclaimed by the next run's
-        // sweep rather than failing the current one.
+        // The next owned-root teardown or startup sweep recovers nested residue.
     }
 };
+export { DEFAULT_RECLAIM_AGE_MS, RUN_ROOT_PREFIX, SCRATCH_NAMESPACE, parseRunRootName, runRootName, scratchBaseDir, scratchNamespaceDir, } from "./scratch-authority.js";
+export { SCRATCH_PREFIXES_ENV, SCRATCH_SUITE_ENV, } from "./scratch-route-profile.js";
+export { registeredScratchPrefixes, scratchSuiteLabel, } from "./scratch-route-profile.js";
+export { isProcessAlive, isReclaimable, isStaleForeignEntry, liveOwnerBirthProbe, readNamespaceEntries, sweepScratchNamespace, } from "./scratch-sweep.js";
+export { materializeOwnedScratchRunRoot, openOwnedScratchRunRoot, prepareOwnedScratchRunRoot, } from "./scratch-run-root-intent.js";
+export { adoptOwnedScratchRunRoot, createRunRoot, reclaimAndCreateOwnedRunRoot, reclaimAndCreateRunRoot, } from "./scratch-run-root-compatibility.js";
+export { removeOwnedScratchRunRoot } from "./scratch-run-root-intent.js";
 //# sourceMappingURL=scratch.js.map

package/dist/configs/vitest/scratch.js.map

@@ -1 +1 @@
-{"version":3,"file":"scratch.js","sourceRoot":"","sources":["../../../src/configs/vitest/scratch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scratch.js","sourceRoot":"","sources":["../../../src/configs/vitest/scratch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAQ,EAAE;IACpD,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC,CAAC;AAEF,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AAOtC,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/configs/vitest/typescript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/typescript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,8DAA8D;AAC9D,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,UAAU,uBAAuB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,kBAEvC,uBAA4B,KAAG,UAgBhC,CAAC"}
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/typescript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,8DAA8D;AAC9D,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,UAAU,uBAAuB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,kBAEvC,uBAA4B,KAAG,UAiBhC,CAAC"}

package/dist/configs/vitest/typescript.js

@@ -15,6 +15,7 @@ export const getTypescriptVitestConfig = ({ thresholds = defaultThresholds, } =
     test: {
         setupFiles: [...scratchSetupFiles()],
         globalSetup: [...scratchGlobalSetup()],
+        sequence: { setupFiles: "list", hooks: "stack" },
         globals: true,
         environment: "node",
         include: ["tests/**/*.test.ts", "src/**/*.test.ts"],

package/dist/configs/vitest/typescript.js.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/configs/vitest/typescript.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAInB,6DAA6D;AAC7D,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,CAAC;AAYF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EACxC,UAAU,GAAG,iBAAiB,MACH,EAAE,EAAc,EAAE,CAAC,CAAC;IAC/C,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACpC,WAAW,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QACnD,OAAO,EAAE,CAAC,GAAG,qBAAqB,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAC5D,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,CAAC,aAAa,CAAC;YACxB,OAAO,EAAE,CAAC,GAAG,yBAAyB,EAAE,GAAG,kBAAkB,EAAE,CAAC;YAChE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC;SACtC;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/configs/vitest/typescript.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAInB,6DAA6D;AAC7D,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,CAAC;AAYF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EACxC,UAAU,GAAG,iBAAiB,MACH,EAAE,EAAc,EAAE,CAAC,CAAC;IAC/C,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACpC,WAAW,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;QACtC,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;QAChD,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QACnD,OAAO,EAAE,CAAC,GAAG,qBAAqB,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAC5D,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,CAAC,aAAa,CAAC;YACxB,OAAO,EAAE,CAAC,GAAG,yBAAyB,EAAE,GAAG,kBAAkB,EAAE,CAAC;YAChE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC;SACtC;KACF;CACF,CAAC,CAAC"}

package/dist/core/apply-mode.d.ts

@@ -20,42 +20,78 @@
  * fleet. A silent gap is bad; a silent gap with an instrument attesting to it
  * is worse.
  *
- * ## What did NOT change, deliberately
- *
- * `--skip-git-check` still selects `postinstall-safe` by default. That is the
- * conflation CodySwannGT/lisa#3066 reports, and it is preserved here rather
- * than separated, because separating it safely needs a reliable "this is a
- * postinstall" signal and there is not one:
- *
- * - npm sets `npm_lifecycle_event=postinstall` during a postinstall.
- * - **bun sets neither `npm_lifecycle_event` nor `npm_command`**, while still
- *   running the script. Measured, not assumed.
- *
- * So keying the mode off the lifecycle environment would classify every
- * bun-based project's postinstall as a full apply, and a full apply under
- * `bun install` regenerates agent trees — precisely what the reduced mode
- * exists to prevent. The alternative, marking the hook command itself, means
- * changing text that `ensure-lisa-postinstall` recognises by exact match and
- * that already lives in every consumer's `package.json`; that carries the
- * two-channel hazard of CodySwannGT/lisa#3050, where a recogniser miss appends
- * a second invocation rather than failing.
- *
- * What this module adds instead is an explicit opt-out for the caller who
- * genuinely wants both — a dirty tree AND the full apply — which is the case
- * the fleet-update flow needs and the only case the conflation actually
- * blocked.
+ * ## The conflation, and how it is separated
+ *
+ * `--skip-git-check` used to carry two unrelated propositions, and selecting
+ * the reduced subset was the one nothing in its name suggested
+ * (CodySwannGT/lisa#3066). They are separated here because they are scoped to
+ * different things:
+ *
+ * | proposition | scoped to | expressed by |
+ * |---|---|---|
+ * | "do not require a clean working tree" | the INVOCATION — the caller knows its own tree | `--skip-git-check` |
+ * | "run the reduced subset" | the CONTEXT — is this a package manager's install lifecycle | `--postinstall-safe` / `LISA_POSTINSTALL=1` |
+ *
+ * `skipGitCheck` is accepted by {@link ApplyModeInputs} and deliberately read
+ * by nothing in this module. Keeping the field makes the separation directly
+ * assertable and makes any future re-reading of it a visible diff rather than
+ * a silent regression.
+ *
+ * ## Why the context is DECLARED and not detected
+ *
+ * Lisa already has an ambient detector — `isRunningAsLifecycleScript()`, which
+ * reads `npm_package_json`. It cannot decide this, and the reason is measured
+ * rather than assumed:
+ *
+ * - `npm install` postinstall sets `npm_lifecycle_event=postinstall`.
+ * - **`bun install` postinstall sets neither `npm_lifecycle_event` nor
+ *   `npm_command`** while still running the script; it does set
+ *   `npm_config_user_agent` and `npm_package_json`.
+ * - Every one of those leaks into the descendants of ANY `bun run` / `npm run`
+ *   — including the shell an operator, a CI job, or an agent runs an apply
+ *   from.
+ *
+ * A detector keyed on the first would classify every bun-based project's
+ * postinstall as a full apply, and a full apply under `bun install`
+ * regenerates agent trees — exactly what the reduced mode exists to prevent. A
+ * detector keyed on the second over-fires instead, handing the reduced subset
+ * back to the very callers this fixes, silently. A declaration can do neither:
+ * only Lisa's own postinstall invocations carry it.
+ *
+ * The declaration is also concrete at the moment the decision is taken — a
+ * plain string already present in the process, never a deferred or
+ * lazily-resolved value that could still be token-shaped when read.
  * @module core/apply-mode
  */
 import type { ApplyMode } from "./apply-receipt.js";
+/** Environment variable a postinstall invocation sets to declare itself. */
+export declare const LISA_POSTINSTALL_ENV = "LISA_POSTINSTALL";
+/** The value {@link LISA_POSTINSTALL_ENV} must hold to count as declared. */
+export declare const LISA_POSTINSTALL_ENV_VALUE = "1";
 /** The subset of config this decision reads. */
 export interface ApplyModeInputs {
-    /** Whether the dirty-tree check was waived. */
+    /**
+     * Whether the dirty-tree check was waived.
+     *
+     * Accepted and DELIBERATELY UNREAD. This field used to decide the mode, and
+     * that conflation is the defect this module resolves; it stays in the shape
+     * so the separation can be asserted directly and so re-reading it would show
+     * up as a diff here rather than as behaviour nobody notices.
+     */
     readonly skipGitCheck: boolean;
     /**
-     * Explicit request for the full apply even with the git check waived.
+     * Whether this apply declared itself a package-manager install lifecycle.
+     *
+     * Set by `--postinstall-safe` or `LISA_POSTINSTALL=1`, which every
+     * Lisa-written postinstall invocation carries. This is the only input that
+     * selects the reduced subset.
+     */
+    readonly postinstall?: boolean;
+    /**
+     * Explicit request for the full apply even inside a declared postinstall.
      *
-     * The escape hatch from the conflation. Absent or false preserves today's
-     * behaviour exactly, so no existing caller changes.
+     * The override of last resort, for an operator who means to force the
+     * complete apply from inside a lifecycle script.
      */
     readonly fullApply?: boolean;
 }
@@ -63,7 +99,7 @@ export interface ApplyModeInputs {
  * Resolves the mode this apply runs in.
  *
  * Every consumer — agent emits, `package.json` protection, and the receipt —
- * MUST read this rather than re-deriving from `skipGitCheck`, so the recorded
+ * MUST read this rather than re-deriving from any single flag, so the recorded
  * mode can never describe work the run did not do.
  * @param config - The apply's resolved configuration.
  * @returns `"postinstall-safe"` for the reduced subset, otherwise `"full"`.
@@ -79,4 +115,19 @@ export declare function resolveApplyMode(config: ApplyModeInputs): ApplyMode;
  * @returns True when the reduced `postinstall-safe` subset applies.
  */
 export declare function isPostinstallSafeApply(config: ApplyModeInputs): boolean;
+/**
+ * Resolve the postinstall declaration from the CLI flag and the environment.
+ *
+ * Two spellings, one meaning. The flag is what Lisa's own spawned invocations
+ * pass, because a spawned child's environment is sanitised of package-manager
+ * variables and a flag survives that; the environment variable is what the
+ * hook text in a consumer's `package.json` carries, because prefixing an
+ * assignment leaves the command tail untouched and therefore leaves the
+ * recogniser in `ensure-lisa-postinstall` matching both shapes with a single
+ * added alternative.
+ * @param flag - Value of `--postinstall-safe`, if passed.
+ * @param env - Environment to read {@link LISA_POSTINSTALL_ENV} from.
+ * @returns True when this apply declared itself a postinstall.
+ */
+export declare function resolvePostinstallDeclaration(flag: boolean | undefined, env: Readonly<Record<string, string | undefined>>): boolean;
 //# sourceMappingURL=apply-mode.d.ts.map

package/dist/core/apply-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-mode.d.ts","sourceRoot":"","sources":["../../src/core/apply-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEvE"}
+{"version":3,"file":"apply-mode.d.ts","sourceRoot":"","sources":["../../src/core/apply-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,OAAO,CAIT"}

package/dist/core/apply-mode.js

@@ -1,8 +1,12 @@
+/** Environment variable a postinstall invocation sets to declare itself. */
+export const LISA_POSTINSTALL_ENV = "LISA_POSTINSTALL";
+/** The value {@link LISA_POSTINSTALL_ENV} must hold to count as declared. */
+export const LISA_POSTINSTALL_ENV_VALUE = "1";
 /**
  * Resolves the mode this apply runs in.
  *
  * Every consumer — agent emits, `package.json` protection, and the receipt —
- * MUST read this rather than re-deriving from `skipGitCheck`, so the recorded
+ * MUST read this rather than re-deriving from any single flag, so the recorded
  * mode can never describe work the run did not do.
  * @param config - The apply's resolved configuration.
  * @returns `"postinstall-safe"` for the reduced subset, otherwise `"full"`.
@@ -11,7 +15,7 @@ export function resolveApplyMode(config) {
     if (config.fullApply === true) {
         return "full";
     }
-    return config.skipGitCheck ? "postinstall-safe" : "full";
+    return config.postinstall === true ? "postinstall-safe" : "full";
 }
 /**
  * Whether this apply runs the reduced subset.
@@ -25,4 +29,21 @@ export function resolveApplyMode(config) {
 export function isPostinstallSafeApply(config) {
     return resolveApplyMode(config) === "postinstall-safe";
 }
+/**
+ * Resolve the postinstall declaration from the CLI flag and the environment.
+ *
+ * Two spellings, one meaning. The flag is what Lisa's own spawned invocations
+ * pass, because a spawned child's environment is sanitised of package-manager
+ * variables and a flag survives that; the environment variable is what the
+ * hook text in a consumer's `package.json` carries, because prefixing an
+ * assignment leaves the command tail untouched and therefore leaves the
+ * recogniser in `ensure-lisa-postinstall` matching both shapes with a single
+ * added alternative.
+ * @param flag - Value of `--postinstall-safe`, if passed.
+ * @param env - Environment to read {@link LISA_POSTINSTALL_ENV} from.
+ * @returns True when this apply declared itself a postinstall.
+ */
+export function resolvePostinstallDeclaration(flag, env) {
+    return (flag === true || env[LISA_POSTINSTALL_ENV] === LISA_POSTINSTALL_ENV_VALUE);
+}
 //# sourceMappingURL=apply-mode.js.map

package/dist/core/apply-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply-mode.js","sourceRoot":"","sources":["../../src/core/apply-mode.ts"],"names":[],"mappings":"AA+DA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,kBAAkB,CAAC;AACzD,CAAC"}
+{"version":3,"file":"apply-mode.js","sourceRoot":"","sources":["../../src/core/apply-mode.ts"],"names":[],"mappings":"AAmEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AA8B9C;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,kBAAkB,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAyB,EACzB,GAAiD;IAEjD,OAAO,CACL,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,oBAAoB,CAAC,KAAK,0BAA0B,CAC1E,CAAC;AACJ,CAAC"}

package/dist/core/apply-receipt.d.ts

@@ -8,7 +8,11 @@ export declare const APPLY_RECEIPT_SCHEMA_VERSION = 1;
 /**
  * How complete the recorded apply was.
  *
- * `postinstall-safe` is the `--skip-git-check` path a package manager runs. It
+ * `postinstall-safe` is the path a package manager's install runs, selected by
+ * the `--postinstall-safe` / `LISA_POSTINSTALL=1` declaration every
+ * Lisa-written postinstall invocation carries. (It used to be selected by
+ * `--skip-git-check`, which also meant something else entirely — see
+ * `core/apply-mode` and CodySwannGT/lisa#3066.) It
  * deliberately skips every agent emit (Codex, Claude, agy, Copilot, OpenCode)
  * and the Sonar integration, because those rewrite host-owned files that must
  * not change under an install. That is the right behaviour and the wrong

package/dist/core/apply-receipt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-receipt.d.ts","sourceRoot":"","sources":["../../src/core/apply-receipt.ts"],"names":[],"mappings":"AA2BA,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEhE,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AA8BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmB9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,EACD,GAAG,GAAE,MAAM,IAAuB,GACjC,OAAO,CAAC,OAAO,CAAC,CAmBlB"}
+{"version":3,"file":"apply-receipt.d.ts","sourceRoot":"","sources":["../../src/core/apply-receipt.ts"],"names":[],"mappings":"AA2BA,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEhE,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AA8BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmB9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,EACD,GAAG,GAAE,MAAM,IAAuB,GACjC,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/core/apply-receipt.js.map

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