@with-logic/elwood 0.2.0 → 0.2.2

package/dist/runtime/update/waiting.js.map

@@ -1 +1 @@
-{"version":3,"file":"waiting.js","sourceRoot":"","sources":["../../../src/runtime/update/waiting.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"waiting.js","sourceRoot":"","sources":["../../../src/runtime/update/waiting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,oBAAoB,GAAG,qBAAqB,CAAC,GAAG,MAAM,CAAC;AASzF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,MAAc,EACd,OAAe,EACf,WAAmB;IAEnB,SAAS,CAAC;QACR,IAAI,WAAW,CAAC,GAAG,EAAE,IAAI,WAAW;YAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QACxE,IAAI,KAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,kFAAkF;QAClF,+CAA+C;QAC/C,MAAM,wBAAwB,GAAG,OAAO,EAAE,oBAAoB,KAAK,SAAS,CAAC;QAC7E,uFAAuF;QACvF,0EAA0E;QAC1E,IAAI,wBAAwB,IAAI,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,OAAO,CAAC;YAC5E,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACvC,qFAAqF;QACrF,oEAAoE;QACpE,IAAI,wBAAwB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;YACtE,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;YACvE,IAAI,SAAS,CAAC,MAAM,KAAK,eAAe;gBAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC1E,CAAC;QACD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS,IAAI,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACjF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,QAAQ,EAAE,KAAK,KAAK,KAAK,EAAE,KAAK,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,CAAC;QACH,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,sFAAsF;QACtF,sFAAsF;QACtF,oFAAoF;QACpF,kDAAkD;QAClD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,QAAQ,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;gBAAE,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1F,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,GAAG,IAAI,WAAW,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/state/canonical-path.d.ts

@@ -1,2 +1,7 @@
 export declare function canonicalStatePath(path: string): string;
+/**
+ * The absolute `path` with its deepest existing ancestor replaced by that ancestor's real path,
+ * as `realpath` gives it, followed by the names that do not exist yet.
+ */
+export declare function withRealAncestor(path: string, realpath: (path: string) => string): string;
 //# sourceMappingURL=canonical-path.d.ts.map

package/dist/state/canonical-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-path.d.ts","sourceRoot":"","sources":["../../src/state/canonical-path.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAavD"}
+{"version":3,"file":"canonical-path.d.ts","sourceRoot":"","sources":["../../src/state/canonical-path.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAUzF"}

package/dist/state/canonical-path.js

@@ -4,18 +4,24 @@ import { basename, dirname, join, resolve } from "node:path";
 import { errnoCode } from "../core/errors.js";
 import { assertStatePath } from "./directories.js";
 export function canonicalStatePath(path) {
-    let current = resolve(path);
-    assertStatePath(current);
+    const absolute = resolve(path);
+    assertStatePath(absolute);
+    return withRealAncestor(absolute, realpathSync);
+}
+/**
+ * The absolute `path` with its deepest existing ancestor replaced by that ancestor's real path,
+ * as `realpath` gives it, followed by the names that do not exist yet.
+ */
+export function withRealAncestor(path, realpath) {
     const missing = [];
-    for (;;) {
+    for (let current = path;; current = dirname(current)) {
         try {
-            return join(realpathSync(current), ...missing.reverse());
+            return join(realpath(current), ...missing.reverse());
         }
         catch (error) {
             if (errnoCode(error) !== "ENOENT")
                 throw error;
             missing.push(basename(current));
-            current = dirname(current);
         }
     }
 }

package/dist/state/canonical-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-path.js","sourceRoot":"","sources":["../../src/state/canonical-path.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,SAAS,CAAC;QACR,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"canonical-path.js","sourceRoot":"","sources":["../../src/state/canonical-path.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1B,OAAO,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAkC;IAC/E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,OAAO,GAAG,IAAI,GAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/state/directories.d.ts

@@ -1,4 +1,34 @@
+import type { StateDirectoryCreationObserver } from "./preparation/created-directories.ts";
 /** Reject planted ancestors too, while allowing root-owned OS aliases such as /tmp. */
 export declare function assertStatePath(path: string): void;
-export declare function makeStateDirectory(path: string, mode: number): void;
+/** A private state directory: only its owner may enter it. */
+export declare const PRIVATE_STATE_MODE = 448;
+/** A shared state directory, such as the default `.elwood/`, readable by local tooling. */
+export declare const SHARED_STATE_MODE = 493;
+/** The modes a state directory may have. */
+export type StateDirectoryMode = typeof PRIVATE_STATE_MODE | typeof SHARED_STATE_MODE;
+/**
+ * Whether a state directory may be made: with its missing parents, only itself inside an
+ * existing parent, or not at all, when it must exist already. Under a state root, a missing
+ * parent means the root, or the project it lives in, was removed, and making it again would
+ * recreate that project (C-STATE-14).
+ */
+export type StateDirectoryPolicy = "with-parents" | "inside-parent" | "must-exist";
+/**
+ * Makes the state directory `path` as `policy` allows, once `assertStatePath` finds no unsafe
+ * symlink leading to it: `path` itself must not be one, and an ancestor may be only when root
+ * owns it, as with `/tmp`. It does not check who owns an existing directory or change its mode;
+ * `prepareStateDirectory` does both.
+ */
+export declare function makeStateDirectory(path: string, mode: StateDirectoryMode, policy: StateDirectoryPolicy, onDirectoryCreated?: StateDirectoryCreationObserver): void;
+/**
+ * Makes `path` inside its existing parent, an ancestry the caller has already checked, so only
+ * `path` itself is checked not to be a symlink.
+ */
+export declare function makeStateDirectoryBelow(path: string, mode: StateDirectoryMode, onDirectoryCreated?: StateDirectoryCreationObserver): void;
+/**
+ * Prepares the state directory `path`: makes it as `policy` allows, then checks that it is a
+ * directory the current user owns and gives it `mode`.
+ */
+export declare function prepareStateDirectory(path: string, mode: StateDirectoryMode, policy: StateDirectoryPolicy, onDirectoryCreated?: StateDirectoryCreationObserver): void;
 //# sourceMappingURL=directories.d.ts.map

package/dist/state/directories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directories.d.ts","sourceRoot":"","sources":["../../src/state/directories.ts"],"names":[],"mappings":"AAaA,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBlD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBnE"}
+{"version":3,"file":"directories.d.ts","sourceRoot":"","sources":["../../src/state/directories.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAE3F,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASlD;AAcD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,MAAQ,CAAC;AACxC,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,MAAQ,CAAC;AACvC,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,GAAG,OAAO,iBAAiB,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,kBAAkB,CAAC,EAAE,8BAA8B,GAClD,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,EACxB,kBAAkB,CAAC,EAAE,8BAA8B,GAClD,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,kBAAkB,CAAC,EAAE,8BAA8B,GAClD,IAAI,CAeN"}

package/dist/state/directories.js

@@ -7,35 +7,97 @@ export function assertStatePath(path) {
     const leaf = resolve(path);
     let current = leaf;
     while (true) {
-        try {
-            const info = lstatSync(current);
-            if (info.isSymbolicLink() && (current === leaf || info.uid !== 0)) {
-                throw elwoodError("state_corrupt", `State path must not follow a symlink: ${current}`);
-            }
-        }
-        catch (error) {
-            if (errnoCode(error) !== "ENOENT")
-                throw error;
-        }
+        assertSafeEntry(current, current === leaf);
         const parent = dirname(current);
         if (parent === current)
             return;
         current = parent;
     }
 }
-export function makeStateDirectory(path, mode) {
+/** A missing entry passes; a symlink fails, unless it is an ancestor that root owns. */
+function assertSafeEntry(path, isLeaf) {
+    try {
+        const info = lstatSync(path);
+        if (info.isSymbolicLink() && (isLeaf || info.uid !== 0)) {
+            throw elwoodError("state_corrupt", `State path must not follow a symlink: ${path}`);
+        }
+    }
+    catch (error) {
+        if (errnoCode(error) !== "ENOENT")
+            throw error;
+    }
+}
+/** A private state directory: only its owner may enter it. */
+export const PRIVATE_STATE_MODE = 0o700;
+/** A shared state directory, such as the default `.elwood/`, readable by local tooling. */
+export const SHARED_STATE_MODE = 0o755;
+/**
+ * Makes the state directory `path` as `policy` allows, once `assertStatePath` finds no unsafe
+ * symlink leading to it: `path` itself must not be one, and an ancestor may be only when root
+ * owns it, as with `/tmp`. It does not check who owns an existing directory or change its mode;
+ * `prepareStateDirectory` does both.
+ */
+export function makeStateDirectory(path, mode, policy, onDirectoryCreated) {
     assertStatePath(path);
-    mkdirSync(path, { recursive: true, mode });
+    makeAs[policy](path, mode, onDirectoryCreated);
+}
+/**
+ * Makes `path` inside its existing parent, an ancestry the caller has already checked, so only
+ * `path` itself is checked not to be a symlink.
+ */
+export function makeStateDirectoryBelow(path, mode, onDirectoryCreated) {
+    assertSafeEntry(path, true);
+    makeInsideParent(path, mode, onDirectoryCreated);
+}
+/**
+ * Prepares the state directory `path`: makes it as `policy` allows, then checks that it is a
+ * directory the current user owns and gives it `mode`.
+ */
+export function prepareStateDirectory(path, mode, policy, onDirectoryCreated) {
+    makeStateDirectory(path, mode, policy, onDirectoryCreated);
     const fd = openSync(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
     try {
         const info = fstatSync(fd);
         if (!info.isDirectory() || info.uid !== process.getuid?.()) {
             throw elwoodError("state_corrupt", `State directory must be owned by the current user: ${path}`);
         }
-        fchmodSync(fd, mode);
+        if ((info.mode & 0o7777) !== mode)
+            fchmodSync(fd, mode);
     }
     finally {
         closeSync(fd);
     }
 }
+/** How each policy makes a directory; the type makes every policy name one. */
+const makeAs = {
+    "with-parents": makeWithParents,
+    "inside-parent": makeInsideParent,
+    "must-exist": () => {
+        // Never made: the open below fails with ENOENT when it is missing.
+    },
+};
+/** Makes `path` inside its existing parent; an existing directory is fine, a missing parent not. */
+function makeInsideParent(path, mode, onDirectoryCreated) {
+    try {
+        mkdirSync(path, { mode });
+    }
+    catch (error) {
+        if (errnoCode(error) !== "EEXIST")
+            throw error;
+        return;
+    }
+    onDirectoryCreated?.(path);
+}
+/** Single-directory steps record partial parent creation without repeating ancestry checks. */
+function makeWithParents(path, mode, onDirectoryCreated) {
+    try {
+        makeInsideParent(path, mode, onDirectoryCreated);
+    }
+    catch (error) {
+        if (errnoCode(error) !== "ENOENT")
+            throw error;
+        makeWithParents(dirname(path), mode, onDirectoryCreated);
+        makeInsideParent(path, mode, onDirectoryCreated);
+    }
+}
 //# sourceMappingURL=directories.js.map

package/dist/state/directories.js.map

@@ -1 +1 @@
-{"version":3,"file":"directories.js","sourceRoot":"","sources":["../../src/state/directories.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClE,MAAM,WAAW,CAAC,eAAe,EAAE,yCAAyC,OAAO,EAAE,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QACjD,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO;QAC/B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAY;IAC3D,eAAe,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7F,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;YAC3D,MAAM,WAAW,CACf,eAAe,EACf,sDAAsD,IAAI,EAAE,CAC7D,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"directories.js","sourceRoot":"","sources":["../../src/state/directories.ts"],"names":[],"mappings":"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"}

package/dist/state/files.d.ts

@@ -2,12 +2,12 @@
  * Secure state path and file helpers for Elwood metadata.
  * Implements PRD §6.2 and §8.2.
  */
+import type { StateDirectoryCreationObserver } from "./preparation/created-directories.ts";
 export declare function newBridgeToken(): string;
 export declare function assertSessionId(id: string): void;
 export declare function safeSessionDir(stateDir: string, id: string): string;
-export declare function secureMkdir(path: string): void;
-export declare function sharedMkdir(path: string): void;
-export declare function writeSharedFile(path: string, content: string): void;
+/** Makes the private directory `path` inside its parent; a missing parent fails with `ENOENT`. */
+export declare function secureMkdir(path: string, onDirectoryCreated?: StateDirectoryCreationObserver): void;
 export declare function writePrivateFile(path: string, content: string): void;
 /**
  * Rename-atomic, fsync-backed private write (§8.2). The temp name carries a random

package/dist/state/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/state/files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGnE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAsB1E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ3C"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/state/files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAE3F,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,8BAA8B,GAClD,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAsB1E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ3C"}

package/dist/state/files.js

@@ -6,7 +6,7 @@ import { randomUUID } from "node:crypto";
 import { closeSync, constants, existsSync, fchmodSync, fstatSync, fsyncSync, ftruncateSync, openSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { elwoodError } from "../core/errors.js";
-import { assertStatePath, makeStateDirectory } from "./directories.js";
+import { assertStatePath, PRIVATE_STATE_MODE, prepareStateDirectory } from "./directories.js";
 export function newBridgeToken() {
     return randomUUID();
 }
@@ -20,15 +20,9 @@ export function safeSessionDir(stateDir, id) {
     const root = resolve(stateDir);
     return join(root, "sessions", id);
 }
-export function secureMkdir(path) {
-    makeStateDirectory(path, 0o700);
-}
-export function sharedMkdir(path) {
-    makeStateDirectory(path, 0o755);
-}
-export function writeSharedFile(path, content) {
-    sharedMkdir(dirname(path));
-    writeStateFile(path, content, 0o644);
+/** Makes the private directory `path` inside its parent; a missing parent fails with `ENOENT`. */
+export function secureMkdir(path, onDirectoryCreated) {
+    prepareStateDirectory(path, PRIVATE_STATE_MODE, "inside-parent", onDirectoryCreated);
 }
 export function writePrivateFile(path, content) {
     secureMkdir(dirname(path));

package/dist/state/files.js.map

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

package/dist/state/launch-ownership.d.ts

@@ -1,10 +1,12 @@
+/** Writes `text` to `path`; `readText` is the file's text when the caller has just read it. */
+export type StateFileWriter = (path: string, text: string, readText?: string) => void;
 export type LaunchOwnership = {
     /** Exclusive authority for startup publication and destructive cleanup. */
     readonly current: () => boolean;
     /** Ordinary loop and record writes may continue on a predecessor while resume is pending. */
     readonly canPersist: () => boolean;
-    readonly persistFile: (path: string, text: string) => void;
-    readonly publishFile: (path: string, text: string) => void;
+    readonly persistFile: StateFileWriter;
+    readonly publishFile: StateFileWriter;
     readonly release: () => void;
     readonly onCommit: (activate: () => void) => void;
     readonly onRevoked: (pause: () => void) => void;

package/dist/state/launch-ownership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-ownership.d.ts","sourceRoot":"","sources":["../../src/state/launch-ownership.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,eAAe,GAAG;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CA8F3E;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"launch-ownership.d.ts","sourceRoot":"","sources":["../../src/state/launch-ownership.ts"],"names":[],"mappings":"AA2BA,+FAA+F;AAC/F,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtF,MAAM,MAAM,eAAe,GAAG;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAqG3E;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/state/launch-ownership.js

@@ -31,35 +31,43 @@ export function reserveLaunchOwnership(inputPath) {
     const current = () => generations.get(path) === token.entry;
     let retryOwner;
     let failedPublications = [];
-    const canPersist = () => {
+    /** The later launches on this path, newest first; `undefined` when this one may not persist. */
+    const successors = () => {
         if (token.phase === "failed")
-            return false;
+            return undefined;
+        const later = [];
         let owner = generations.get(path)?.generation.deref();
         while (owner) {
             if (owner === token)
-                return true;
+                return later;
             if (owner.phase === "active")
-                return false;
+                return undefined;
+            later.push(owner);
             owner = owner.previous;
         }
-        return false;
+        return undefined;
     };
+    const canPersist = () => successors() !== undefined;
     return {
         current,
         canPersist,
-        persistFile: (file, text) => {
-            if (!canPersist())
+        persistFile: (file, text, readText) => {
+            const later = successors();
+            if (later === undefined)
                 throw elwoodError("session_not_running", "Launch was superseded.");
             if (token.phase === "pending")
-                publication.write(file, text);
+                publication.write(file, text, readText);
             else
                 writePrivateFileAtomic(file, text);
+            // A successor's rollback keeps this write, even one whose bytes match its own (§8.1).
+            for (const successor of later)
+                successor.publication.forget(file);
         },
-        publishFile: (file, text) => {
+        publishFile: (file, text, readText) => {
             if (!current())
                 throw elwoodError("session_not_running", "Launch was superseded.");
             if (token.phase === "pending")
-                publication.write(file, text);
+                publication.write(file, text, readText);
             else
                 writePrivateFileAtomic(file, text);
         },

package/dist/state/launch-ownership.js.map

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

package/dist/state/launch-publication.d.ts

@@ -1,6 +1,12 @@
 export declare class LaunchPublication {
     private readonly files;
-    write(path: string, text: string): void;
+    /**
+     * Publish `text` at `path`. A caller that has just read the file passes what it read as
+     * `readText`, so a large file is not read again for the rollback preimage.
+     */
+    write(path: string, text: string, readText?: string): void;
+    /** A predecessor's later write to `path` stands: rollback leaves it, whatever its bytes. */
+    forget(path: string): void;
     clear(): void;
     rollback(): void;
 }

package/dist/state/launch-publication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-publication.d.ts","sourceRoot":"","sources":["../../src/state/launch-publication.ts"],"names":[],"mappings":"AAUA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYvC,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,IAAI;CAoBjB"}
+{"version":3,"file":"launch-publication.d.ts","sourceRoot":"","sources":["../../src/state/launch-publication.ts"],"names":[],"mappings":"AAUA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAa1D,4FAA4F;IAC5F,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,IAAI;CAoBjB"}

package/dist/state/launch-publication.js

@@ -7,8 +7,13 @@ import { fsyncDir, writePrivateFileAtomic } from "./files.js";
 import { currentFileOwner, readPrivateFile } from "./private-read.js";
 export class LaunchPublication {
     files = new Map();
-    write(path, text) {
-        const current = read(path);
+    /**
+     * Publish `text` at `path`. A caller that has just read the file passes what it read as
+     * `readText`, so a large file is not read again for the rollback preimage.
+     */
+    write(path, text, readText) {
+        assertStatePath(path);
+        const current = readText ?? readFile(path);
         const entry = this.files.get(path) ?? { before: current, written: [current] };
         // Preserve a predecessor's intervening record update across our next write.
         if (!entry.written.includes(current))
@@ -19,6 +24,10 @@ export class LaunchPublication {
         writePrivateFileAtomic(path, text);
         entry.written = [text];
     }
+    /** A predecessor's later write to `path` stands: rollback leaves it, whatever its bytes. */
+    forget(path) {
+        this.files.delete(path);
+    }
     clear() {
         this.files.clear();
     }
@@ -48,6 +57,9 @@ export class LaunchPublication {
 }
 function read(path) {
     assertStatePath(path);
+    return readFile(path);
+}
+function readFile(path) {
     return readPrivateFile(path, currentFileOwner(), () => elwoodError("state_corrupt", "Launch state is not a valid private file."));
 }
 //# sourceMappingURL=launch-publication.js.map

package/dist/state/launch-publication.js.map

@@ -1 +1 @@
-{"version":3,"file":"launch-publication.js","sourceRoot":"","sources":["../../src/state/launch-publication.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAItE,MAAM,OAAO,iBAAiB;IACX,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,KAAK,CAAC,IAAY,EAAE,IAAY;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9E,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;QAC7D,4EAA4E;QAC5E,KAAK,CAAC,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;oBACvC,gFAAgF;oBAChF,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;wBAC/B,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC9B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC1B,CAAC;;wBAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpD,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,MAAM;YACR,MAAM,WAAW,CAAC,eAAe,EAAE,uDAAuD,CAAC,CAAC;IAChG,CAAC;CACF;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,eAAe,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CACpD,WAAW,CAAC,eAAe,EAAE,2CAA2C,CAAC,CAC1E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"launch-publication.js","sourceRoot":"","sources":["../../src/state/launch-publication.ts"],"names":[],"mappings":"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"}

package/dist/state/loop-store.d.ts

@@ -4,10 +4,21 @@
  */
 import type { LoopDefinition } from "../core/loops/scheduler-state.ts";
 export type PersistedLoopDefinition = LoopDefinition;
-/** Read and validate a session's sidecar. Absence is the canonical empty state. */
-export declare function readLoopDefinitions(stateDir: string, elwoodSessionId: string): readonly PersistedLoopDefinition[];
-/** Atomically replace the sidecar with fresh, canonical, private definitions. */
-export declare function writeLoopDefinitions(stateDir: string, elwoodSessionId: string, definitions: readonly PersistedLoopDefinition[]): void;
+export type LoopSidecar = {
+    readonly definitions: readonly PersistedLoopDefinition[];
+    /** The text the definitions were read from; `undefined` when there is no sidecar. */
+    readonly text: string | undefined;
+};
+/**
+ * Read and validate a session's sidecar, keeping the text it was read from. Absence is the
+ * canonical empty state.
+ */
+export declare function readLoopSidecar(stateDir: string, elwoodSessionId: string): LoopSidecar;
+/**
+ * Atomically replace the sidecar with fresh, canonical, private definitions, through `write`
+ * when a launch must be able to restore it.
+ */
+export declare function writeLoopDefinitions(stateDir: string, elwoodSessionId: string, definitions: readonly PersistedLoopDefinition[], write?: (path: string, text: string) => void): void;
 /** Remove definitions expired at or before `now`, without mutating the input. */
 export declare function pruneExpiredLoopDefinitions(definitions: readonly PersistedLoopDefinition[], now: number): readonly PersistedLoopDefinition[];
 //# sourceMappingURL=loop-store.d.ts.map

package/dist/state/loop-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-store.d.ts","sourceRoot":"","sources":["../../src/state/loop-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAKvE,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAIrD,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,SAAS,uBAAuB,EAAE,CAgBpC;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,SAAS,uBAAuB,EAAE,GAC9C,IAAI,CAWN;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,uBAAuB,EAAE,EAC/C,GAAG,EAAE,MAAM,GACV,SAAS,uBAAuB,EAAE,CAEpC"}
+{"version":3,"file":"loop-store.d.ts","sourceRoot":"","sources":["../../src/state/loop-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAKvE,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAIrD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,WAAW,CAgBtF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,SAAS,uBAAuB,EAAE,EAC/C,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAA6B,GACnE,IAAI,CAQN;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,uBAAuB,EAAE,EAC/C,GAAG,EAAE,MAAM,GACV,SAAS,uBAAuB,EAAE,CAEpC"}

package/dist/state/loop-store.js

@@ -8,8 +8,11 @@ import { safeSessionDir, writePrivateFileAtomic } from "./files.js";
 import { currentFileOwner, readPrivateFile } from "./private-read.js";
 import { LOOP_SIDECAR_SCHEMA_VERSION, validateLoopSidecar } from "./validate-loops.js";
 const LOOP_SIDECAR_NAME = "loops.json";
-/** Read and validate a session's sidecar. Absence is the canonical empty state. */
-export function readLoopDefinitions(stateDir, elwoodSessionId) {
+/**
+ * Read and validate a session's sidecar, keeping the text it was read from. Absence is the
+ * canonical empty state.
+ */
+export function readLoopSidecar(stateDir, elwoodSessionId) {
     const corrupt = () => corruptState(elwoodSessionId);
     let text;
     try {
@@ -19,19 +22,22 @@ export function readLoopDefinitions(stateDir, elwoodSessionId) {
         throw corrupt(); // an invalid session id or an unsafe/unreadable sidecar
     }
     if (text === undefined)
-        return [];
+        return { definitions: [], text };
     try {
         const definitions = validateLoopSidecar(JSON.parse(text));
         if (definitions === null)
             throw corrupt();
-        return definitions;
+        return { definitions, text };
     }
     catch {
         throw corrupt();
     }
 }
-/** Atomically replace the sidecar with fresh, canonical, private definitions. */
-export function writeLoopDefinitions(stateDir, elwoodSessionId, definitions) {
+/**
+ * Atomically replace the sidecar with fresh, canonical, private definitions, through `write`
+ * when a launch must be able to restore it.
+ */
+export function writeLoopDefinitions(stateDir, elwoodSessionId, definitions, write = writePrivateFileAtomic) {
     const canonical = validateLoopSidecar({
         schemaVersion: LOOP_SIDECAR_SCHEMA_VERSION,
         loops: definitions,
@@ -39,7 +45,7 @@ export function writeLoopDefinitions(stateDir, elwoodSessionId, definitions) {
     if (canonical === null)
         throw new TypeError("Loop definitions are invalid.");
     const sidecar = { schemaVersion: LOOP_SIDECAR_SCHEMA_VERSION, loops: canonical };
-    writePrivateFileAtomic(sidecarPath(stateDir, elwoodSessionId), `${JSON.stringify(sidecar, null, 2)}\n`);
+    write(sidecarPath(stateDir, elwoodSessionId), `${JSON.stringify(sidecar, null, 2)}\n`);
 }
 /** Remove definitions expired at or before `now`, without mutating the input. */
 export function pruneExpiredLoopDefinitions(definitions, now) {

package/dist/state/loop-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-store.js","sourceRoot":"","sources":["../../src/state/loop-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAIvF,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,eAAuB;IAEvB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,EAAE,CAAC,CAAC,wDAAwD;IAC3E,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,IAAI,WAAW,KAAK,IAAI;YAAE,MAAM,OAAO,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,eAAuB,EACvB,WAA+C;IAE/C,MAAM,SAAS,GAAG,mBAAmB,CAAC;QACpC,aAAa,EAAE,2BAA2B;QAC1C,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,2BAA2B,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjF,sBAAsB,CACpB,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,EACtC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACxC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,2BAA2B,CACzC,WAA+C,EAC/C,GAAW;IAEX,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,eAAuB;IAC5D,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,YAAY,CAAC,eAAuB;IAC3C,OAAO,WAAW,CAAC,eAAe,EAAE,6BAA6B,eAAe,EAAE,CAAC,CAAC;AACtF,CAAC"}
+{"version":3,"file":"loop-store.js","sourceRoot":"","sources":["../../src/state/loop-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAIvF,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAQvC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,eAAuB;IACvE,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,EAAE,CAAC,CAAC,wDAAwD;IAC3E,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,IAAI,WAAW,KAAK,IAAI;YAAE,MAAM,OAAO,EAAE,CAAC;QAC1C,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,eAAuB,EACvB,WAA+C,EAC/C,QAA8C,sBAAsB;IAEpE,MAAM,SAAS,GAAG,mBAAmB,CAAC;QACpC,aAAa,EAAE,2BAA2B;QAC1C,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,2BAA2B,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjF,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACzF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,2BAA2B,CACzC,WAA+C,EAC/C,GAAW;IAEX,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,eAAuB;IAC5D,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,YAAY,CAAC,eAAuB;IAC3C,OAAO,WAAW,CAAC,eAAe,EAAE,6BAA6B,eAAe,EAAE,CAAC,CAAC;AACtF,CAAC"}

package/dist/state/preparation/created-directories.d.ts

@@ -0,0 +1,13 @@
+export type StateDirectoryCreationObserver = (path: string) => void;
+export declare class CreatedStateDirectories {
+    private readonly directories;
+    /** Called only after a single mkdir succeeded, never for an existing directory. */
+    readonly record: StateDirectoryCreationObserver;
+    /**
+     * Remove only empty, still-matching owned entries. Retained shared default roots and
+     * sessions may already support another setup. Keep the first cleanup code without replacing
+     * the setup failure that caused rollback.
+     */
+    remove(retainedDirectories?: ReadonlySet<string>): string | undefined;
+}
+//# sourceMappingURL=created-directories.d.ts.map

package/dist/state/preparation/created-directories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"created-directories.d.ts","sourceRoot":"","sources":["../../../src/state/preparation/created-directories.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,8BAA8B,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAGpE,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAM7C;IAEF;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,MAAM,GAAG,SAAS;CAmBjF"}