@codyswann/lisa 4.28.5 → 4.29.1

package/dist/configs/vitest/scratch-supervision-intent.js

@@ -0,0 +1,125 @@
+/** Exact IPC validation for immutable scratch run-root intents. */
+import * as path from "node:path";
+/**
+ * Whether an object has exactly the declared own string keys.
+ * @param value - Candidate object
+ * @param keys - Required exact keys
+ * @returns Whether the keys match exactly
+ */
+function hasExactKeys(value, keys) {
+    const actual = Object.keys(value).sort((left, right) => left.localeCompare(right));
+    const expected = [...keys].sort((left, right) => left.localeCompare(right));
+    return (actual.length === expected.length &&
+        actual.every((key, index) => key === expected[index]));
+}
+/**
+ * Whether a value contains an ASCII control code.
+ * @param value - Candidate string
+ * @returns Whether a control code is present
+ */
+function hasControlCode(value) {
+    return [...value].some(character => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        return codePoint <= 31 || codePoint === 127;
+    });
+}
+/**
+ * Whether one value is a bounded, control-free direct basename.
+ * @param value - Candidate basename
+ * @returns Whether the basename is inert and bounded
+ */
+function validBasename(value) {
+    return (typeof value === "string" &&
+        value !== "" &&
+        value !== "." &&
+        value !== ".." &&
+        path.basename(value) === value &&
+        !value.includes("/") &&
+        !value.includes("\\") &&
+        Buffer.byteLength(value, "utf8") <= 1_024 &&
+        !hasControlCode(value));
+}
+/**
+ * Whether one namespace identity has exact bounded fields.
+ * @param value - Candidate identity
+ * @returns Whether the identity is exact and typed
+ */
+function validNamespaceIdentity(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    const keys = Object.hasOwn(candidate, "uid")
+        ? ["canonicalPath", "dev", "ino", "uid"]
+        : ["canonicalPath", "dev", "ino"];
+    return (hasExactKeys(candidate, keys) &&
+        typeof candidate["canonicalPath"] === "string" &&
+        path.isAbsolute(candidate["canonicalPath"]) &&
+        Number.isSafeInteger(candidate["dev"]) &&
+        Number.isSafeInteger(candidate["ino"]) &&
+        (!Object.hasOwn(candidate, "uid") || Number.isSafeInteger(candidate["uid"])));
+}
+/**
+ * Whether the scalar and collection fields of one root intent are valid.
+ * @param intent - Candidate intent object
+ * @param prefixes - Candidate prefix registry
+ * @returns Whether every field is bounded and typed
+ */
+function validIntentFields(intent, prefixes) {
+    return (Number.isSafeInteger(intent["pid"]) &&
+        intent["pid"] > 0 &&
+        typeof intent["processBirthFingerprint"] === "string" &&
+        intent["processBirthFingerprint"] !== "" &&
+        Buffer.byteLength(intent["processBirthFingerprint"], "utf8") <= 256 &&
+        typeof intent["createdAt"] === "string" &&
+        !Number.isNaN(Date.parse(intent["createdAt"])) &&
+        typeof intent["token"] === "string" &&
+        /^[a-f0-9]{32}$/u.test(intent["token"]) &&
+        typeof intent["suiteLabel"] === "string" &&
+        intent["suiteLabel"] !== "" &&
+        Buffer.byteLength(intent["suiteLabel"], "utf8") <= 256 &&
+        Array.isArray(prefixes) &&
+        prefixes.length <= 64 &&
+        prefixes.every(validBasename));
+}
+/**
+ * Validate an inert scratch-root intent received over IPC.
+ * @param value - Candidate intent
+ * @returns Schema-validated intent
+ */
+export function validateScratchRunRootIntent(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error("Scratch root intent must be an object");
+    }
+    const intent = value;
+    const authority = intent["authority"];
+    const namespace = authority?.["namespace"];
+    const validAuthority = authority !== undefined &&
+        authority !== null &&
+        hasExactKeys(authority, ["baseCanonicalPath", "namespace"]) &&
+        typeof authority["baseCanonicalPath"] === "string" &&
+        validNamespaceIdentity(namespace);
+    const validPath = validAuthority &&
+        validBasename(intent["basename"]) &&
+        typeof intent["rootPath"] === "string" &&
+        intent["rootPath"] ===
+            path.join(namespace.canonicalPath, intent["basename"]);
+    if (intent["schema"] !== 1 ||
+        !hasExactKeys(intent, [
+            "schema",
+            "authority",
+            "basename",
+            "rootPath",
+            "pid",
+            "processBirthFingerprint",
+            "createdAt",
+            "token",
+            "suiteLabel",
+            "registeredPrefixes",
+        ]) ||
+        !validPath ||
+        !validIntentFields(intent, intent["registeredPrefixes"])) {
+        throw new Error("Invalid scratch root intent schema");
+    }
+    return value;
+}
+//# sourceMappingURL=scratch-supervision-intent.js.map

package/dist/configs/vitest/scratch-supervision-intent.js.map

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

package/dist/configs/vitest/scratch-supervision-protocol.d.ts

@@ -0,0 +1,12 @@
+/** Versioned IPC envelope after bounded structural validation. */
+export interface ScratchProtocolMessageV1 extends Record<string, unknown> {
+    readonly schema: 1;
+    readonly type: string;
+}
+/**
+ * Validate a bounded version-one IPC message against the closed vocabulary.
+ * @param value - Candidate message
+ * @returns Validated message envelope
+ */
+export declare function parseScratchProtocolMessage(value: unknown): ScratchProtocolMessageV1;
+//# sourceMappingURL=scratch-supervision-protocol.d.ts.map

package/dist/configs/vitest/scratch-supervision-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch-supervision-protocol.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/scratch-supervision-protocol.ts"],"names":[],"mappings":"AA8CA,kEAAkE;AAClE,MAAM,WAAW,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAoND;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,wBAAwB,CA8B1B"}

package/dist/configs/vitest/scratch-supervision-protocol.js

@@ -0,0 +1,230 @@
+/** Bounded, exact IPC envelopes shared by the test-run protocol processes. */
+import * as path from "node:path";
+import { validateScratchRunRootIntent } from "./scratch-supervision-intent.js";
+/** Maximum serialized IPC envelope accepted by a protocol process. */
+const MAX_PROTOCOL_BYTES = 128 * 1_024;
+/** Empty message types whose exact schema has no payload fields. */
+const EMPTY_TYPES = new Set([
+    "REAPER_READY",
+    "COMMAND_READY",
+    "GO",
+    "STOP",
+    "CLEANED",
+    "DISARMED",
+]);
+/** Correlated acknowledgement types carrying only the intent token. */
+const CORRELATED_TYPES = new Set([
+    "ROOT_INTENT_ARMED",
+    "TARGET_ARMED",
+    "MATERIALIZE_ROOT",
+]);
+/** Closed protocol message vocabulary. */
+const PROTOCOL_TYPES = new Set([
+    ...EMPTY_TYPES,
+    ...CORRELATED_TYPES,
+    "ROOT_INTENT",
+    "ROOT_ARMED",
+    "BOOTSTRAP_READY",
+    "COMMAND",
+    "TARGET_INTENT",
+    "SIGNAL",
+    "PAYLOAD_EXIT",
+    "PAYLOAD_ERROR",
+]);
+/** Catchable signals accepted by the forwarding protocol. */
+const PROTOCOL_SIGNALS = new Set([
+    "SIGINT",
+    "SIGTERM",
+    "SIGHUP",
+]);
+/**
+ * Whether an object has exactly the declared own string keys.
+ * @param value - Candidate object
+ * @param keys - Required exact keys
+ * @returns Whether the keys match exactly
+ */
+function hasExactKeys(value, keys) {
+    const actual = Object.keys(value).sort((left, right) => left.localeCompare(right));
+    const expected = [...keys].sort((left, right) => left.localeCompare(right));
+    return (actual.length === expected.length &&
+        actual.every((key, index) => key === expected[index]));
+}
+/**
+ * Whether a correlation is one exact root-intent token.
+ * @param value - Candidate correlation
+ * @returns Whether it is one exact token
+ */
+function validCorrelation(value) {
+    return typeof value === "string" && /^[a-f0-9]{32}$/u.test(value);
+}
+/**
+ * Whether a bootstrap command is exact, bounded, and inert.
+ * @param value - Candidate command
+ * @returns Whether the command contract is valid
+ */
+function validBootstrapCommand(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const command = value;
+    const argv = command["argv"];
+    const commandEnv = command["env"];
+    return (hasExactKeys(command, ["schema", "argv", "env"]) &&
+        command["schema"] === 1 &&
+        Array.isArray(argv) &&
+        argv.length > 0 &&
+        argv.length <= 4_096 &&
+        argv.every(argument => typeof argument === "string" &&
+            Buffer.byteLength(argument, "utf8") <= 16 * 1_024) &&
+        typeof commandEnv === "object" &&
+        commandEnv !== null &&
+        Object.keys(commandEnv).length <= 4_096 &&
+        Object.entries(commandEnv).every(([key, entry]) => key !== "" &&
+            Buffer.byteLength(key, "utf8") <= 1_024 &&
+            typeof entry === "string" &&
+            Buffer.byteLength(entry, "utf8") <= 64 * 1_024));
+}
+/**
+ * Whether a target is one exact, birth-bound process-group leader.
+ * @param value - Candidate target
+ * @returns Whether the target contract is valid
+ */
+function validTargetIntent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const target = value;
+    return (hasExactKeys(target, ["pid", "pgid", "processBirthFingerprint"]) &&
+        Number.isSafeInteger(target["pid"]) &&
+        target["pid"] > 0 &&
+        target["pgid"] === target["pid"] &&
+        typeof target["processBirthFingerprint"] === "string" &&
+        target["processBirthFingerprint"] !== "" &&
+        Buffer.byteLength(target["processBirthFingerprint"], "utf8") <= 256);
+}
+/**
+ * Whether a root identity carries only exact canonical inode authority.
+ * @param value - Candidate root identity
+ * @returns Whether the value is exact and bounded
+ */
+function validRootIdentity(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const root = value;
+    return (hasExactKeys(root, ["canonicalPath", "dev", "ino"]) &&
+        typeof root["canonicalPath"] === "string" &&
+        path.isAbsolute(root["canonicalPath"]) &&
+        Buffer.byteLength(root["canonicalPath"], "utf8") <= 4_096 &&
+        Number.isSafeInteger(root["dev"]) &&
+        Number.isSafeInteger(root["ino"]));
+}
+/**
+ * Exact-key helper specialized to one protocol message.
+ * @param message - Candidate message
+ * @param keys - Message-specific keys
+ * @returns Whether the complete key set matches
+ */
+function exactMessageKeys(message, keys) {
+    return hasExactKeys(message, ["schema", "type", ...keys]);
+}
+/**
+ * Validate one correlated ROOT_INTENT message.
+ * @param message - Candidate message
+ * @returns Whether the root intent is exact
+ */
+function validRootIntentMessage(message) {
+    return (exactMessageKeys(message, ["correlation", "intent"]) &&
+        validCorrelation(message["correlation"]) &&
+        validateScratchRunRootIntent(message["intent"]).token ===
+            message["correlation"]);
+}
+/**
+ * Validate one birth-bound TARGET_INTENT message.
+ * @param message - Candidate message
+ * @returns Whether the target intent is exact
+ */
+function validTargetIntentMessage(message) {
+    return (exactMessageKeys(message, ["correlation", "target"]) &&
+        validCorrelation(message["correlation"]) &&
+        validTargetIntent(message["target"]));
+}
+/**
+ * Validate one terminal payload result.
+ * @param message - Candidate message
+ * @returns Whether the result is exact
+ */
+function validPayloadExitMessage(message) {
+    return (exactMessageKeys(message, ["code", "signal"]) &&
+        (message["code"] === null || Number.isInteger(message["code"])) &&
+        (message["signal"] === null ||
+            (typeof message["signal"] === "string" &&
+                /^SIG[A-Z0-9]+$/u.test(message["signal"]))));
+}
+/** Message-specific validators outside the empty/correlation families. */
+const BODY_VALIDATORS = {
+    BOOTSTRAP_READY: message => exactMessageKeys(message, ["pid"]) &&
+        Number.isSafeInteger(message["pid"]) &&
+        message["pid"] > 0,
+    ROOT_INTENT: validRootIntentMessage,
+    TARGET_INTENT: validTargetIntentMessage,
+    ROOT_ARMED: message => exactMessageKeys(message, ["correlation", "root"]) &&
+        validCorrelation(message["correlation"]) &&
+        validRootIdentity(message["root"]),
+    COMMAND: message => exactMessageKeys(message, ["command"]) &&
+        validBootstrapCommand(message["command"]),
+    SIGNAL: message => exactMessageKeys(message, ["signal"]) &&
+        typeof message["signal"] === "string" &&
+        PROTOCOL_SIGNALS.has(message["signal"]),
+    PAYLOAD_ERROR: message => exactMessageKeys(message, ["message"]) &&
+        typeof message["message"] === "string" &&
+        message["message"] !== "" &&
+        Buffer.byteLength(message["message"], "utf8") <= 4_096,
+    PAYLOAD_EXIT: validPayloadExitMessage,
+};
+/**
+ * Whether one exact message-specific body matches its declared type.
+ * @param message - Candidate message
+ * @param type - Declared protocol type
+ * @returns Whether the message-specific shape is exact
+ */
+function validMessageBody(message, type) {
+    if (EMPTY_TYPES.has(type))
+        return exactMessageKeys(message, []);
+    if (CORRELATED_TYPES.has(type)) {
+        return (exactMessageKeys(message, ["correlation"]) &&
+            validCorrelation(message["correlation"]));
+    }
+    return BODY_VALIDATORS[type]?.(message) ?? false;
+}
+/**
+ * Validate a bounded version-one IPC message against the closed vocabulary.
+ * @param value - Candidate message
+ * @returns Validated message envelope
+ */
+export function parseScratchProtocolMessage(value) {
+    const serialized = (() => {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            throw new Error("Scratch protocol message must be serializable");
+        }
+    })();
+    if (serialized === undefined ||
+        Buffer.byteLength(serialized, "utf8") > MAX_PROTOCOL_BYTES) {
+        throw new Error("Scratch protocol message exceeds its byte bound");
+    }
+    if (typeof value !== "object" || value === null) {
+        throw new Error("Scratch protocol message must be an object");
+    }
+    const message = value;
+    const type = message["type"];
+    if (message["schema"] !== 1 ||
+        typeof type !== "string" ||
+        !PROTOCOL_TYPES.has(type)) {
+        throw new Error("Invalid scratch protocol message schema");
+    }
+    if (!validMessageBody(message, type)) {
+        throw new Error(`Invalid ${type} scratch protocol message`);
+    }
+    return value;
+}
+//# sourceMappingURL=scratch-supervision-protocol.js.map

package/dist/configs/vitest/scratch-supervision-protocol.js.map

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

package/dist/configs/vitest/scratch-supervision.d.ts

@@ -0,0 +1,64 @@
+import { removeAuthorizedScratchChild } from "./scratch-authority.js";
+import { writeScratchOwnerRecord, type ScratchOwnerRecordV1, type ScratchPathIdentity } from "./scratch-owner.js";
+import { type ScratchRunRootIntentV1 } from "./scratch.js";
+/** Private environment variable inherited only by a supervised test payload. */
+export declare const SCRATCH_SUPERVISION_LEASE_ENV = "LISA_TEST_RUN_LEASE";
+/** Version-one lease: basenames and identities, never a free-form root path. */
+export interface ScratchSupervisionLeaseV1 {
+    readonly schema: 1;
+    readonly token: string;
+    readonly suiteRootBasename: string;
+    readonly baseCanonicalPath: string;
+    readonly namespace: ScratchPathIdentity;
+    readonly suiteRoot: ScratchPathIdentity;
+    readonly suiteLabel: string;
+    readonly registeredPrefixes: readonly string[];
+}
+/** Durable handle for one worker scope nested inside the supervised suite root. */
+export interface SupervisedWorkerScope {
+    readonly path: string;
+    readonly basename: string;
+    readonly parent: ScratchPathIdentity;
+    readonly suiteToken: string;
+    readonly owner: ScratchOwnerRecordV1;
+}
+/** Deterministic seams for worker-scope allocation failure controls. */
+export interface SupervisedWorkerScopeOptions {
+    readonly removeAuthorizedChild?: typeof removeAuthorizedScratchChild;
+    readonly writeOwnerRecord?: typeof writeScratchOwnerRecord;
+}
+/**
+ * Construct a bounded lease only after the suite root has been independently opened.
+ * @param intent - Armed suite-root intent
+ * @param configuration - Suite attribution captured before collection
+ * @param configuration.suiteLabel - Opaque suite label
+ * @param configuration.registeredPrefixes - Pre-collection prefix registry
+ * @returns Immutable lease
+ */
+export declare function createScratchSupervisionLease(intent: ScratchRunRootIntentV1, configuration: {
+    readonly suiteLabel: string;
+    readonly registeredPrefixes: readonly string[];
+}): ScratchSupervisionLeaseV1;
+/**
+ * Parse and validate the private bounded lease contract.
+ * @param raw - Serialized lease
+ * @returns Validated version-one lease
+ */
+export declare function parseScratchSupervisionLease(raw: string): ScratchSupervisionLeaseV1;
+/**
+ * Allocate one random worker scope under a token-validated suite root.
+ * @param lease - Validated suite lease
+ * @param options - Optional deterministic persistence seam
+ * @returns Durable worker-scope handle
+ */
+export declare function createSupervisedWorkerScope(lease: ScratchSupervisionLeaseV1, options?: SupervisedWorkerScopeOptions): SupervisedWorkerScope;
+/**
+ * Remove one worker scope while revalidating its parent lease around deletion.
+ * @param scope - Durable worker handle
+ * @param lease - Optional parent lease for pre/post validation
+ */
+export declare function removeSupervisedWorkerScope(scope: SupervisedWorkerScope, lease?: ScratchSupervisionLeaseV1): void;
+export { parseScratchProtocolMessage } from "./scratch-supervision-protocol.js";
+export { validateScratchRunRootIntent } from "./scratch-supervision-intent.js";
+export type { ScratchProtocolMessageV1 } from "./scratch-supervision-protocol.js";
+//# sourceMappingURL=scratch-supervision.d.ts.map

package/dist/configs/vitest/scratch-supervision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch-supervision.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/scratch-supervision.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAIL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAEtB,gFAAgF;AAChF,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAKnE,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,4BAA4B,CAAC;IACrE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC5D;AAiDD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,sBAAsB,EAC9B,aAAa,EAAE;IACb,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,GACA,yBAAyB,CAa3B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,GACV,yBAAyB,CAkC3B;AAkCD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,yBAAyB,EAChC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAmCvB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,EAC5B,KAAK,CAAC,EAAE,yBAAyB,GAChC,IAAI,CAmBN;AAED,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC"}