@codyswann/lisa 4.28.5 → 4.29.0

package/dist/configs/vitest/scratch-owner.js

@@ -0,0 +1,297 @@
+/**
+ * Durable owner records for Vitest scratch roots.
+ *
+ * A pid is not an identity: kernels reuse it. The marker therefore binds the
+ * pid to the process birth value reported by the operating system, and every
+ * reclaim decision compares both. A live pid whose birth cannot be read is
+ * preserved; deletion fails closed rather than guessing.
+ * @module configs/vitest/scratch-owner
+ */
+import { randomBytes } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { spawnSync } from "node:child_process";
+/** Owner-marker filename stored directly inside every run root. */
+export const SCRATCH_OWNER_FILE = ".lisa-scratch-owner.json";
+/** Prefix identifying a per-process run root inside the namespace. */
+export const SCRATCH_RUN_ROOT_PREFIX = "run-";
+/** Maximum time allowed for the bounded macOS process-birth probe. */
+const PS_TIMEOUT_MS = 1_000;
+/** Maximum pids admitted to one bounded macOS `ps` invocation. */
+const DARWIN_BIRTH_BATCH_SIZE = 256;
+/** Maximum owner-marker bytes accepted at the destructive authority boundary. */
+const MAX_OWNER_MARKER_BYTES = 16 * 1024;
+/** Maximum bytes accepted for one opaque marker string. */
+const MAX_OWNER_TEXT_BYTES = 256;
+/** Maximum bytes accepted for one canonical filesystem path. */
+const MAX_OWNER_PATH_BYTES = 4_096;
+/** Maximum registered prefixes accepted in one marker. */
+const MAX_OWNER_PREFIXES = 64;
+/**
+ * Read Linux's immutable process start ticks.
+ * @param pid - Process id to inspect
+ * @returns A stable fingerprint, or undefined when unavailable
+ */
+function linuxBirthFingerprint(pid) {
+    try {
+        const stat = fs.readFileSync(`/proc/${String(pid)}/stat`, "utf8");
+        const commEnd = stat.lastIndexOf(")");
+        if (commEnd < 0)
+            return undefined;
+        const fields = stat
+            .slice(commEnd + 2)
+            .trim()
+            .split(/\s+/u);
+        const startTicks = fields[19];
+        return startTicks === undefined ? undefined : `linux:${startTicks}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Read macOS kernel-reported process start times through one bounded `ps` call.
+ * @param pids - Process ids to inspect together
+ * @returns Raw pid/start rows, or undefined when unavailable
+ */
+function runDarwinBirthBatch(pids) {
+    const result = spawnSync("/bin/ps", ["-p", pids.join(","), "-o", "pid=", "-o", "lstart="], {
+        encoding: "utf8",
+        killSignal: "SIGKILL",
+        maxBuffer: Math.max(4_096, pids.length * 128),
+        timeout: PS_TIMEOUT_MS,
+    });
+    if (result.status !== 0 ||
+        result.signal !== null ||
+        result.error !== undefined) {
+        return undefined;
+    }
+    return result.stdout;
+}
+/**
+ * Parse one bulk `pid lstart` row without depending on locale text.
+ * @param row - One bounded `ps` output row
+ * @returns Parsed pid and fingerprint, or undefined for malformed output
+ */
+function parseDarwinBirthRow(row) {
+    const normalized = row.trim();
+    const separator = normalized.search(/\s/u);
+    if (separator < 1)
+        return undefined;
+    const pid = Number(normalized.slice(0, separator));
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    const start = normalized.slice(separator).trim().replace(/\s+/gu, " ");
+    return start === "" ? undefined : [pid, `darwin:${start}`];
+}
+/**
+ * Capture process birth once for a bounded pid set.
+ *
+ * Darwin has no `/proc`, so namespace audits must not launch one `ps` process
+ * per live scratch root. This snapshot deduplicates pids and reads them in
+ * bounded 256-pid batches; callers reuse the returned map throughout one
+ * sweep/inspection transaction.
+ * @param pids - Process ids needed by one audit transaction
+ * @param options - Platform and deterministic batch seam
+ * @returns A complete lookup whose missing observations remain undefined
+ */
+export function processBirthFingerprintSnapshot(pids, options = {}) {
+    const unique = [...new Set(pids)]
+        .filter(pid => Number.isSafeInteger(pid) && pid > 0)
+        .sort((left, right) => left - right);
+    const platform = options.platform ?? process.platform;
+    if (platform === "linux") {
+        return new Map(unique.map(pid => [pid, linuxBirthFingerprint(pid)]));
+    }
+    if (platform !== "darwin") {
+        return new Map(unique.map(pid => [pid, undefined]));
+    }
+    const runBatch = options.runDarwinBatch ?? runDarwinBirthBatch;
+    const batchCount = Math.ceil(unique.length / DARWIN_BIRTH_BATCH_SIZE);
+    const observations = new Map(Array.from({ length: batchCount }, (_, index) => unique.slice(index * DARWIN_BIRTH_BATCH_SIZE, (index + 1) * DARWIN_BIRTH_BATCH_SIZE)).flatMap(batch => (runBatch(batch) ?? "")
+        .split("\n")
+        .map(parseDarwinBirthRow)
+        .filter((entry) => entry !== undefined)));
+    return new Map(unique.map(pid => [pid, observations.get(pid)]));
+}
+/**
+ * Read the OS-authoritative birth fingerprint for a process.
+ * @param pid - Process id to inspect
+ * @returns Fingerprint, or undefined on an unsupported/ambiguous platform
+ */
+export function processBirthFingerprint(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    return processBirthFingerprintSnapshot([pid]).get(pid);
+}
+/** Stable unsupported-platform fallback captured once at module load. */
+const UNSUPPORTED_CURRENT_BIRTH = `unsupported:${String(process.pid)}:${String(Math.round(Date.now() - process.uptime() * 1_000))}`;
+/**
+ * Fingerprint the current process for a newly-created marker.
+ *
+ * Unsupported platforms still need an opaque value to make the marker
+ * complete. Reclaim never treats this fallback as authoritative: a live pid on
+ * such a platform yields an ambiguous observation and is preserved.
+ * @returns Current process birth fingerprint
+ */
+export function currentProcessBirthFingerprint() {
+    return processBirthFingerprint(process.pid) ?? UNSUPPORTED_CURRENT_BIRTH;
+}
+/**
+ * Build a run-root basename.
+ * @param pid - Owning process id
+ * @param startedAt - Creation epoch milliseconds
+ * @param suffix - Opaque random suffix
+ * @returns Direct namespace-child basename
+ */
+export function scratchRunRootName(pid, startedAt, suffix) {
+    return `${SCRATCH_RUN_ROOT_PREFIX}${String(pid)}-${String(startedAt)}-${suffix}`;
+}
+/**
+ * Parse the owner fields encoded in a run-root basename.
+ * @param name - Direct namespace-child basename
+ * @returns Parsed owner, or undefined for an unrelated name
+ */
+export function parseScratchRunRootName(name) {
+    const match = new RegExp(`^${SCRATCH_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;
+}
+/**
+ * Decide whether a valid owner may be reclaimed.
+ * @param record - Persisted owner marker
+ * @param probes - Kernel probes, injectable for deterministic tests
+ * @returns Fail-closed reclaim disposition
+ */
+export function classifyScratchOwner(record, probes) {
+    if (!probes.isProcessAlive(record.pid))
+        return "reclaim";
+    if (record.processBirthFingerprint.startsWith("unsupported:")) {
+        return "preserve";
+    }
+    const observed = probes.processBirthFingerprint(record.pid);
+    if (observed === undefined)
+        return "preserve";
+    return observed === record.processBirthFingerprint ? "preserve" : "reclaim";
+}
+/**
+ * Capture an immutable filesystem identity without following a final symlink.
+ * @param candidate - Existing regular file or directory
+ * @returns Canonical path plus device/inode identity
+ */
+export function scratchPathIdentity(candidate) {
+    const stat = fs.lstatSync(candidate);
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Scratch authority refuses symlink path: ${candidate}`);
+    }
+    return {
+        canonicalPath: fs.realpathSync(candidate),
+        dev: stat.dev,
+        ino: stat.ino,
+    };
+}
+/**
+ * Construct a version-one owner marker from live filesystem state.
+ * @param options - Owner and path facts
+ * @returns Immutable owner record
+ */
+export function createScratchOwnerRecord(options) {
+    const prefixes = [...new Set(options.registeredPrefixes)].sort((left, right) => left.localeCompare(right));
+    return {
+        schema: 1,
+        pid: options.pid ?? process.pid,
+        processBirthFingerprint: options.processBirthFingerprint ?? currentProcessBirthFingerprint(),
+        createdAt: (options.now ?? new Date()).toISOString(),
+        token: options.token ?? randomBytes(16).toString("hex"),
+        suiteLabel: options.suiteLabel,
+        registeredPrefixes: prefixes,
+        namespace: options.authority.namespace,
+        root: scratchPathIdentity(options.root),
+    };
+}
+/**
+ * Validate an inert parsed object as a version-one owner record.
+ * @param candidate - Parsed marker payload
+ * @returns Validated owner record
+ */
+function validateOwnerRecord(candidate) {
+    if (typeof candidate !== "object" || candidate === null) {
+        throw new Error("Scratch owner marker must be an object");
+    }
+    const value = candidate;
+    const namespace = value["namespace"];
+    const root = value["root"];
+    const prefixes = value["registeredPrefixes"];
+    const validText = (text) => typeof text === "string" &&
+        text !== "" &&
+        Buffer.byteLength(text, "utf8") <= MAX_OWNER_TEXT_BYTES;
+    const validPath = (text) => typeof text === "string" &&
+        text !== "" &&
+        Buffer.byteLength(text, "utf8") <= MAX_OWNER_PATH_BYTES;
+    const validIdentity = (identity) => identity !== undefined &&
+        validPath(identity["canonicalPath"]) &&
+        path.isAbsolute(identity["canonicalPath"]) &&
+        Number.isSafeInteger(identity["dev"]) &&
+        Number.isSafeInteger(identity["ino"]);
+    if (value["schema"] !== 1 ||
+        typeof value["pid"] !== "number" ||
+        !Number.isSafeInteger(value["pid"]) ||
+        value["pid"] <= 0 ||
+        !validText(value["processBirthFingerprint"]) ||
+        !validText(value["createdAt"]) ||
+        Number.isNaN(Date.parse(value["createdAt"])) ||
+        !validText(value["token"]) ||
+        !validText(value["suiteLabel"]) ||
+        !Array.isArray(prefixes) ||
+        prefixes.length > MAX_OWNER_PREFIXES ||
+        !prefixes.every(prefix => validText(prefix) &&
+            !prefix.includes("/") &&
+            !prefix.includes("\\") &&
+            prefix !== "." &&
+            prefix !== "..") ||
+        !validIdentity(namespace) ||
+        !validIdentity(root)) {
+        throw new Error("Invalid scratch owner marker schema");
+    }
+    return candidate;
+}
+/**
+ * Write an owner marker without permitting a pre-existing file or symlink.
+ * @param root - Owned run root
+ * @param record - Marker to persist
+ */
+export function writeScratchOwnerRecord(root, record) {
+    const marker = path.join(root, SCRATCH_OWNER_FILE);
+    const descriptor = fs.openSync(marker, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY, 0o600);
+    try {
+        fs.writeFileSync(descriptor, `${JSON.stringify(record)}\n`, "utf8");
+        fs.fsyncSync(descriptor);
+    }
+    finally {
+        fs.closeSync(descriptor);
+    }
+}
+/**
+ * Read and validate an owner marker without following a marker symlink.
+ * @param root - Run root containing the marker
+ * @returns Validated owner marker
+ */
+export function readScratchOwnerRecord(root) {
+    const marker = path.join(root, SCRATCH_OWNER_FILE);
+    const stat = fs.lstatSync(marker);
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Scratch owner marker is a symlink: ${marker}`);
+    }
+    if (!stat.isFile())
+        throw new Error(`Scratch owner marker is not a file: ${marker}`);
+    if (stat.size > MAX_OWNER_MARKER_BYTES) {
+        throw new Error(`Scratch owner marker exceeds ${String(MAX_OWNER_MARKER_BYTES)} bytes`);
+    }
+    return validateOwnerRecord(JSON.parse(fs.readFileSync(marker, "utf8")));
+}
+//# sourceMappingURL=scratch-owner.js.map

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

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

package/dist/configs/vitest/scratch-route-profile.d.ts

@@ -0,0 +1,36 @@
+/** JSON-array environment contract for operator-added direct-child prefixes. */
+export declare const SCRATCH_PREFIXES_ENV = "LISA_TEST_SCRATCH_PREFIXES";
+/** Environment assertion for the immutable route suite label. */
+export declare const SCRATCH_SUITE_ENV = "LISA_TEST_SCRATCH_SUITE";
+/** Every generated route profile understood by the public wrapper. */
+export type ScratchRouteProfileName = "lisa" | "typescript" | "npm-package" | "node" | "expo" | "nestjs" | "cdk" | "harper-fabric" | "phaser";
+/** Frozen suite attribution decided before any scratch root exists. */
+export interface ScratchRouteProfile {
+    readonly name: ScratchRouteProfileName;
+    readonly suiteLabel: string;
+    readonly registeredPrefixes: readonly string[];
+}
+/**
+ * Read the validated bounded prefix registry inherited by scratch owners.
+ * @returns Sorted unique direct-child prefixes
+ */
+export declare function registeredScratchPrefixes(): readonly string[];
+/**
+ * Read the opaque bounded suite label used for owner attribution.
+ * @returns Valid suite label
+ */
+export declare function scratchSuiteLabel(): string;
+/**
+ * Resolve a generated route plus bounded operator additions before allocation.
+ * @param name - Exact managed route name
+ * @param environment - Inherited operator configuration
+ * @returns Deeply frozen immutable registry
+ */
+export declare function resolveScratchRouteProfile(name: string, environment?: NodeJS.ProcessEnv): ScratchRouteProfile;
+/**
+ * Assert dynamic Vitest env agrees with the frozen wrapper lease exactly.
+ * @param profile - Frozen wrapper-authoritative profile
+ * @param environment - Dynamic Vitest environment to compare
+ */
+export declare function assertScratchRouteProfile(profile: Pick<ScratchRouteProfile, "suiteLabel" | "registeredPrefixes">, environment?: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=scratch-route-profile.d.ts.map

package/dist/configs/vitest/scratch-route-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch-route-profile.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/scratch-route-profile.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AAEjE,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAQ3D,sEAAsE;AACtE,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,YAAY,GACZ,aAAa,GACb,MAAM,GACN,MAAM,GACN,QAAQ,GACR,KAAK,GACL,eAAe,GACf,QAAQ,CAAC;AAEb,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAgFD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,MAAM,EAAE,CA0B7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAsDD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAM,CAAC,UAAgB,GACnC,mBAAmB,CA8BrB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,oBAAoB,CAAC,EACvE,WAAW,GAAE,MAAM,CAAC,UAAgB,GACnC,IAAI,CAsBN"}

package/dist/configs/vitest/scratch-route-profile.js

@@ -0,0 +1,217 @@
+/** Immutable wrapper-authoritative scratch registries for every managed route. */
+import { env } from "node:process";
+/** JSON-array environment contract for operator-added direct-child prefixes. */
+export const SCRATCH_PREFIXES_ENV = "LISA_TEST_SCRATCH_PREFIXES";
+/** Environment assertion for the immutable route suite label. */
+export const SCRATCH_SUITE_ENV = "LISA_TEST_SCRATCH_SUITE";
+/** Maximum number of registered prefixes accepted from configuration. */
+const MAX_REGISTERED_PREFIXES = 64;
+/** Maximum bytes in one registered prefix or suite label. */
+const MAX_LABEL_BYTES = 128;
+/** Wrapper-owned base registry; operator additions may only widen prefixes. */
+const ROUTE_PROFILES = Object.freeze({
+    lisa: Object.freeze({
+        suiteLabel: "lisa",
+        registeredPrefixes: Object.freeze([
+            "changelog-",
+            "derived-",
+            "e2e-",
+            "failure-signatures-",
+            "invoked-",
+            "lisa-",
+            "maestro-",
+            "node-",
+            "review-",
+            "skipreq-",
+            "state-",
+            "vacuity-",
+            "wiki-",
+        ]),
+    }),
+    typescript: Object.freeze({
+        suiteLabel: "typescript",
+        registeredPrefixes: [],
+    }),
+    "npm-package": Object.freeze({
+        suiteLabel: "npm-package",
+        registeredPrefixes: [],
+    }),
+    node: Object.freeze({
+        suiteLabel: "node",
+        registeredPrefixes: Object.freeze(["node-"]),
+    }),
+    expo: Object.freeze({
+        suiteLabel: "expo",
+        registeredPrefixes: [],
+    }),
+    nestjs: Object.freeze({ suiteLabel: "nestjs", registeredPrefixes: [] }),
+    cdk: Object.freeze({
+        suiteLabel: "cdk",
+        registeredPrefixes: Object.freeze(["cdk.out"]),
+    }),
+    "harper-fabric": Object.freeze({
+        suiteLabel: "harper-fabric",
+        registeredPrefixes: [],
+    }),
+    phaser: Object.freeze({
+        suiteLabel: "phaser",
+        registeredPrefixes: [],
+    }),
+});
+/**
+ * Whether a label contains a control code unsafe for markers/diagnostics.
+ * @param label - Candidate label
+ * @returns True when a control code is present
+ */
+function containsControlCode(label) {
+    return [...label].some(character => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        return codePoint <= 0x1f || codePoint === 0x7f;
+    });
+}
+/**
+ * Parse one inherited registry while preserving its public diagnostic.
+ * @param raw - Serialized prefix registry
+ * @returns Decoded unvalidated value
+ */
+function parsePrefixRegistry(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${SCRATCH_PREFIXES_ENV} must be a JSON array of prefixes`);
+    }
+}
+/**
+ * Read the validated bounded prefix registry inherited by scratch owners.
+ * @returns Sorted unique direct-child prefixes
+ */
+export function registeredScratchPrefixes() {
+    const raw = env[SCRATCH_PREFIXES_ENV];
+    if (raw === undefined || raw === "")
+        return [];
+    const parsed = parsePrefixRegistry(raw);
+    if (!Array.isArray(parsed) || parsed.length > MAX_REGISTERED_PREFIXES) {
+        throw new Error(`${SCRATCH_PREFIXES_ENV} must contain at most ${String(MAX_REGISTERED_PREFIXES)} prefixes`);
+    }
+    const prefixes = parsed.map(value => {
+        if (typeof value !== "string" ||
+            value === "" ||
+            Buffer.byteLength(value, "utf8") > MAX_LABEL_BYTES ||
+            value.includes("/") ||
+            value.includes("\\") ||
+            value === "." ||
+            value === "..") {
+            throw new Error(`${SCRATCH_PREFIXES_ENV} contains an invalid prefix`);
+        }
+        return value;
+    });
+    return [...new Set(prefixes)].sort((left, right) => left.localeCompare(right));
+}
+/**
+ * Read the opaque bounded suite label used for owner attribution.
+ * @returns Valid suite label
+ */
+export function scratchSuiteLabel() {
+    const label = env[SCRATCH_SUITE_ENV] ?? "vitest";
+    if (label === "" ||
+        Buffer.byteLength(label, "utf8") > MAX_LABEL_BYTES ||
+        containsControlCode(label)) {
+        throw new Error(`${SCRATCH_SUITE_ENV} contains an invalid suite label`);
+    }
+    return label;
+}
+/**
+ * Demand one bounded direct basename.
+ * @param value - Candidate value
+ * @param context - Public diagnostic context
+ * @returns Validated direct label
+ */
+function validateLabel(value, context) {
+    if (typeof value !== "string" ||
+        value === "" ||
+        Buffer.byteLength(value, "utf8") > MAX_LABEL_BYTES ||
+        containsControlCode(value) ||
+        value.includes("/") ||
+        value.includes("\\") ||
+        value === "." ||
+        value === "..") {
+        throw new Error(`${context} contains an invalid direct label`);
+    }
+    return value;
+}
+/**
+ * Decode one operator prefix registry.
+ * @param raw - Serialized registry
+ * @returns Unvalidated decoded value
+ */
+function parseOperatorPrefixes(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${SCRATCH_PREFIXES_ENV} must be a JSON array of prefixes`);
+    }
+}
+/**
+ * Parse and canonicalize operator prefix additions exactly once.
+ * @param environment - Inherited operator configuration
+ * @returns Validated operator-added prefixes
+ */
+function operatorPrefixes(environment) {
+    const raw = environment[SCRATCH_PREFIXES_ENV];
+    if (raw === undefined || raw === "")
+        return [];
+    const parsed = parseOperatorPrefixes(raw);
+    if (!Array.isArray(parsed) || parsed.length > MAX_REGISTERED_PREFIXES) {
+        throw new Error(`${SCRATCH_PREFIXES_ENV} must contain at most ${String(MAX_REGISTERED_PREFIXES)} prefixes`);
+    }
+    return parsed.map(value => validateLabel(value, SCRATCH_PREFIXES_ENV));
+}
+/**
+ * Resolve a generated route plus bounded operator additions before allocation.
+ * @param name - Exact managed route name
+ * @param environment - Inherited operator configuration
+ * @returns Deeply frozen immutable registry
+ */
+export function resolveScratchRouteProfile(name, environment = env) {
+    if (!Object.hasOwn(ROUTE_PROFILES, name)) {
+        throw new Error(`Unknown lisa-test-run scratch profile: ${name || "<missing>"}`);
+    }
+    const routeName = name;
+    const base = ROUTE_PROFILES[routeName];
+    const assertedSuite = environment[SCRATCH_SUITE_ENV];
+    if (assertedSuite !== undefined &&
+        validateLabel(assertedSuite, SCRATCH_SUITE_ENV) !== base.suiteLabel) {
+        throw new Error(`${SCRATCH_SUITE_ENV} conflicts with wrapper profile ${routeName}`);
+    }
+    const prefixes = [
+        ...new Set([...base.registeredPrefixes, ...operatorPrefixes(environment)]),
+    ].sort((left, right) => (left === right ? 0 : left < right ? -1 : 1));
+    if (prefixes.length > MAX_REGISTERED_PREFIXES) {
+        throw new Error(`${SCRATCH_PREFIXES_ENV} exceeds the ${String(MAX_REGISTERED_PREFIXES)} prefix limit after composition`);
+    }
+    return Object.freeze({
+        name: routeName,
+        suiteLabel: base.suiteLabel,
+        registeredPrefixes: Object.freeze(prefixes),
+    });
+}
+/**
+ * Assert dynamic Vitest env agrees with the frozen wrapper lease exactly.
+ * @param profile - Frozen wrapper-authoritative profile
+ * @param environment - Dynamic Vitest environment to compare
+ */
+export function assertScratchRouteProfile(profile, environment = env) {
+    const observedSuite = validateLabel(environment[SCRATCH_SUITE_ENV], SCRATCH_SUITE_ENV);
+    const observedPrefixes = operatorPrefixes(environment);
+    const canonical = [...new Set(observedPrefixes)].sort((left, right) => left === right ? 0 : left < right ? -1 : 1);
+    if (observedSuite !== profile.suiteLabel ||
+        canonical.length !== profile.registeredPrefixes.length ||
+        canonical.some((prefix, index) => prefix !== profile.registeredPrefixes[index])) {
+        throw new Error(`Vitest scratch configuration conflicts with the immutable wrapper profile: ` +
+            `expected ${profile.suiteLabel}/${JSON.stringify(profile.registeredPrefixes)}, ` +
+            `received ${observedSuite}/${JSON.stringify(canonical)}`);
+    }
+}
+//# sourceMappingURL=scratch-route-profile.js.map

package/dist/configs/vitest/scratch-route-profile.js.map

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

package/dist/configs/vitest/scratch-run-root-compatibility.d.ts

@@ -0,0 +1,33 @@
+import { writeScratchOwnerRecord } from "./scratch-owner.js";
+import type { OwnedScratchRunRoot } from "./scratch-run-root-intent.js";
+/** Optional seams for creating one transactional run root. */
+interface CreateRunRootOptions {
+    readonly now?: number;
+    readonly writeOwnerRecord?: typeof writeScratchOwnerRecord;
+}
+/**
+ * Create a legacy-compatible owned root with transactional marker rollback.
+ * @param options - Clock and marker-writer seams
+ * @param options.now - Epoch milliseconds recorded in the basename
+ * @param options.writeOwnerRecord - Injectable transactional marker writer
+ * @returns Absolute run-root path
+ */
+export declare const createRunRoot: ({ now, writeOwnerRecord, }?: CreateRunRootOptions) => string;
+/**
+ * Reclaim residue, then allocate a durable owned-root handle.
+ * @returns Owned current-process root
+ */
+export declare function reclaimAndCreateOwnedRunRoot(): OwnedScratchRunRoot;
+/**
+ * Upgrade a source/dist-compatible path memo created by an older setup copy.
+ * @param root - Existing memoized run-root path
+ * @returns Durable handle for the existing root
+ */
+export declare function adoptOwnedScratchRunRoot(root: string): OwnedScratchRunRoot;
+/**
+ * Reclaim residue, then return one current-process root path.
+ * @returns Newly allocated root path
+ */
+export declare const reclaimAndCreateRunRoot: () => string;
+export {};
+//# sourceMappingURL=scratch-run-root-compatibility.d.ts.map

package/dist/configs/vitest/scratch-run-root-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch-run-root-compatibility.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/scratch-run-root-compatibility.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,uBAAuB,EAExB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAQxE,8DAA8D;AAC9D,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC5D;AAyBD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,6BAG3B,oBAAyB,KAAG,MAsC9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,mBAAmB,CAYlE;AA8BD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAoB1E;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,MACN,CAAC"}