@slopus/beer 0.1.1 → 0.1.2

package/dist/modules/tree/treeStateRead.js

@@ -0,0 +1,39 @@
+import path from "node:path";
+import { treeChildrenRead } from "@/modules/tree/treeChildrenRead.js";
+import { treeNodeRead } from "@/modules/tree/treeNodeRead.js";
+/**
+ * Reads persisted tree state from disk starting at root children.json.
+ * Expects: rootDir is the tree root directory containing root-level children.json.
+ */
+export async function treeStateRead(rootDir) {
+    const rootChildren = await treeChildrenRead(rootDir);
+    if (!rootChildren) {
+        return [];
+    }
+    return Promise.all(rootChildren.map((child) => treeStateReadNode(rootDir, child, 1)));
+}
+async function treeStateReadNode(parentDirPath, child, depth) {
+    const dirPath = path.join(parentDirPath, child.slug);
+    const nodeDisk = await treeNodeRead(dirPath);
+    const childrenDisk = await treeChildrenRead(dirPath);
+    const children = childrenDisk
+        ? await Promise.all(childrenDisk.map((entry) => treeStateReadNode(dirPath, entry, depth + 1)))
+        : [];
+    return {
+        slug: nodeDisk?.slug ?? child.slug,
+        title: nodeDisk?.title ?? child.title,
+        depth,
+        dirPath,
+        parentDirPath,
+        sessionId: nodeDisk?.sessionId,
+        status: treeNodeStatusResolve(nodeDisk?.status),
+        children
+    };
+}
+function treeNodeStatusResolve(status) {
+    if (status === "unexpanded" || status === "in-progress" || status === "expanded" || status === "leaf") {
+        return status;
+    }
+    return "unexpanded";
+}
+//# sourceMappingURL=treeStateRead.js.map

package/dist/modules/tree/treeStateRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRead.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRead.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IAC/C,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,KAAqB,EAAE,KAAa;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,YAAY;QACzB,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9F,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACH,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI;QAClC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,KAAK,CAAC,KAAK;QACrC,KAAK;QACL,OAAO;QACP,aAAa;QACb,SAAS,EAAE,QAAQ,EAAE,SAAS;QAC9B,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC/C,QAAQ;KACX,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,MAA0B;IACrD,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpG,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/modules/tree/treeStateRead.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=treeStateRead.spec.d.ts.map

package/dist/modules/tree/treeStateRead.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRead.spec.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRead.spec.ts"],"names":[],"mappings":""}

package/dist/modules/tree/treeStateRead.spec.js

@@ -0,0 +1,64 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { treeStateRead } from "@/modules/tree/treeStateRead.js";
+describe("treeStateRead", () => {
+    it("returns empty state when root children.json is missing", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-state-read-"));
+        try {
+            await expect(treeStateRead(tempDir)).resolves.toEqual([]);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("reads nested tree state recursively", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-state-read-"));
+        try {
+            await writeFile(path.join(tempDir, "children.json"), JSON.stringify([{ title: "Auth", slug: "auth" }], null, 2), "utf-8");
+            await mkdir(path.join(tempDir, "auth"), { recursive: true });
+            await writeFile(path.join(tempDir, "auth", "node.json"), JSON.stringify({ title: "Auth", slug: "auth", sessionId: "sess-auth", status: "expanded" }, null, 2), "utf-8");
+            await writeFile(path.join(tempDir, "auth", "children.json"), JSON.stringify([{ title: "OAuth2", slug: "oauth2" }], null, 2), "utf-8");
+            await mkdir(path.join(tempDir, "auth", "oauth2"), { recursive: true });
+            await writeFile(path.join(tempDir, "auth", "oauth2", "node.json"), JSON.stringify({ title: "OAuth2", slug: "oauth2", status: "unexpanded" }, null, 2), "utf-8");
+            const state = await treeStateRead(tempDir);
+            expect(state).toHaveLength(1);
+            expect(state[0]).toMatchObject({
+                title: "Auth",
+                slug: "auth",
+                depth: 1,
+                status: "expanded",
+                sessionId: "sess-auth"
+            });
+            expect(state[0]?.children[0]).toMatchObject({
+                title: "OAuth2",
+                slug: "oauth2",
+                depth: 2,
+                status: "unexpanded"
+            });
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("handles missing node files by falling back to root children entry", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-state-read-"));
+        try {
+            await writeFile(path.join(tempDir, "children.json"), JSON.stringify([{ title: "Auth", slug: "auth" }], null, 2), "utf-8");
+            const state = await treeStateRead(tempDir);
+            expect(state).toEqual([
+                expect.objectContaining({
+                    title: "Auth",
+                    slug: "auth",
+                    status: "unexpanded",
+                    children: []
+                })
+            ]);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=treeStateRead.spec.js.map

package/dist/modules/tree/treeStateRead.spec.js.map

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

package/dist/modules/tree/treeStateRender.d.ts

@@ -0,0 +1,7 @@
+import type { TreeNode } from "@/types";
+/**
+ * Renders tree state into an indented outline consumable by picker prompts.
+ * Expects: nodes are root-level entries (root itself is not rendered).
+ */
+export declare function treeStateRender(nodes: readonly TreeNode[]): string;
+//# sourceMappingURL=treeStateRender.d.ts.map

package/dist/modules/tree/treeStateRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRender.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAMlE"}

package/dist/modules/tree/treeStateRender.js

@@ -0,0 +1,19 @@
+/**
+ * Renders tree state into an indented outline consumable by picker prompts.
+ * Expects: nodes are root-level entries (root itself is not rendered).
+ */
+export function treeStateRender(nodes) {
+    const lines = [];
+    for (const node of nodes) {
+        treeStateRenderNode(lines, node, 0);
+    }
+    return lines.join("\n");
+}
+function treeStateRenderNode(lines, node, level) {
+    const indent = "  ".repeat(level);
+    lines.push(`${indent}- ${node.title} [${node.status}]`);
+    for (const child of node.children) {
+        treeStateRenderNode(lines, child, level + 1);
+    }
+}
+//# sourceMappingURL=treeStateRender.js.map

package/dist/modules/tree/treeStateRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRender.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRender.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAA0B;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAe,EAAE,IAAc,EAAE,KAAa;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;AACL,CAAC"}

package/dist/modules/tree/treeStateRender.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=treeStateRender.spec.d.ts.map

package/dist/modules/tree/treeStateRender.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRender.spec.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRender.spec.ts"],"names":[],"mappings":""}

package/dist/modules/tree/treeStateRender.spec.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { treeStateRender } from "@/modules/tree/treeStateRender.js";
+describe("treeStateRender", () => {
+    it("renders indentation and status labels", () => {
+        const tree = [
+            {
+                slug: "auth",
+                title: "Authentication System",
+                depth: 1,
+                dirPath: "/tmp/auth",
+                parentDirPath: "/tmp",
+                status: "expanded",
+                children: [
+                    {
+                        slug: "oauth2",
+                        title: "OAuth2 Flow",
+                        depth: 2,
+                        dirPath: "/tmp/auth/oauth2",
+                        parentDirPath: "/tmp/auth",
+                        status: "unexpanded",
+                        children: []
+                    },
+                    {
+                        slug: "sessions",
+                        title: "Session Management",
+                        depth: 2,
+                        dirPath: "/tmp/auth/sessions",
+                        parentDirPath: "/tmp/auth",
+                        status: "in-progress",
+                        children: []
+                    }
+                ]
+            }
+        ];
+        expect(treeStateRender(tree)).toBe([
+            "- Authentication System [expanded]",
+            "  - OAuth2 Flow [unexpanded]",
+            "  - Session Management [in-progress]"
+        ].join("\n"));
+    });
+});
+//# sourceMappingURL=treeStateRender.spec.js.map

package/dist/modules/tree/treeStateRender.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeStateRender.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeStateRender.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGpE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAe;YACrB;gBACI,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,uBAAuB;gBAC9B,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,WAAW;gBACpB,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE;oBACN;wBACI,IAAI,EAAE,QAAQ;wBACd,KAAK,EAAE,aAAa;wBACpB,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,kBAAkB;wBAC3B,aAAa,EAAE,WAAW;wBAC1B,MAAM,EAAE,YAAY;wBACpB,QAAQ,EAAE,EAAE;qBACf;oBACD;wBACI,IAAI,EAAE,UAAU;wBAChB,KAAK,EAAE,oBAAoB;wBAC3B,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,oBAAoB;wBAC7B,aAAa,EAAE,WAAW;wBAC1B,MAAM,EAAE,aAAa;wBACrB,QAAQ,EAAE,EAAE;qBACf;iBACJ;aACJ;SACJ,CAAC;QAEF,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC9B;YACI,oCAAoC;YACpC,8BAA8B;YAC9B,sCAAsC;SACzC,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/modules/util/asyncLock.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runs async callbacks sequentially under a single mutex.
+ * Expects: callback handles its own failures; lock release happens in finally.
+ */
+export declare class AsyncLock {
+    private pending;
+    inLock<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=asyncLock.d.ts.map

package/dist/modules/util/asyncLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncLock.d.ts","sourceRoot":"","sources":["../../../sources/modules/util/asyncLock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,OAAO,CAAoC;IAE7C,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAcpD"}

package/dist/modules/util/asyncLock.js

@@ -0,0 +1,22 @@
+/**
+ * Runs async callbacks sequentially under a single mutex.
+ * Expects: callback handles its own failures; lock release happens in finally.
+ */
+export class AsyncLock {
+    pending = Promise.resolve();
+    async inLock(fn) {
+        const waitForTurn = this.pending;
+        let releaseTurn = () => { };
+        this.pending = new Promise((resolve) => {
+            releaseTurn = resolve;
+        });
+        await waitForTurn;
+        try {
+            return await fn();
+        }
+        finally {
+            releaseTurn();
+        }
+    }
+}
+//# sourceMappingURL=asyncLock.js.map

package/dist/modules/util/asyncLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncLock.js","sourceRoot":"","sources":["../../../sources/modules/util/asyncLock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAS;IACV,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAI,EAAoB;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,WAAW,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACzC,WAAW,GAAG,OAAO,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,CAAC;QAClB,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,WAAW,EAAE,CAAC;QAClB,CAAC;IACL,CAAC;CACJ"}

package/dist/modules/util/asyncLock.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asyncLock.spec.d.ts.map

package/dist/modules/util/asyncLock.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncLock.spec.d.ts","sourceRoot":"","sources":["../../../sources/modules/util/asyncLock.spec.ts"],"names":[],"mappings":""}

package/dist/modules/util/asyncLock.spec.js

@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import { AsyncLock } from "@/modules/util/asyncLock.js";
+function asyncLockSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+describe("AsyncLock", () => {
+    it("executes concurrent operations sequentially", async () => {
+        const lock = new AsyncLock();
+        const order = [];
+        await Promise.all([
+            lock.inLock(async () => {
+                order.push("first:start");
+                await asyncLockSleep(10);
+                order.push("first:end");
+            }),
+            lock.inLock(async () => {
+                order.push("second:start");
+                order.push("second:end");
+            })
+        ]);
+        expect(order).toEqual(["first:start", "first:end", "second:start", "second:end"]);
+    });
+    it("queues many callers with single concurrency", async () => {
+        const lock = new AsyncLock();
+        let current = 0;
+        let max = 0;
+        const values = await Promise.all(Array.from({ length: 5 }, (_, index) => lock.inLock(async () => {
+            current += 1;
+            max = Math.max(max, current);
+            await asyncLockSleep(1);
+            current -= 1;
+            return index;
+        })));
+        expect(max).toBe(1);
+        expect(values).toEqual([0, 1, 2, 3, 4]);
+    });
+    it("propagates errors and still releases for later callers", async () => {
+        const lock = new AsyncLock();
+        const first = lock.inLock(async () => {
+            throw new Error("boom");
+        });
+        const second = lock.inLock(async () => "ok");
+        await expect(first).rejects.toThrow("boom");
+        await expect(second).resolves.toBe("ok");
+    });
+    it("returns the callback value", async () => {
+        const lock = new AsyncLock();
+        const value = await lock.inLock(async () => ({ id: "value" }));
+        expect(value).toEqual({ id: "value" });
+    });
+});
+//# sourceMappingURL=asyncLock.spec.js.map

package/dist/modules/util/asyncLock.spec.js.map

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

package/dist/modules/util/commandRun.d.ts

@@ -1,7 +1,7 @@
 import type { CommandSandbox } from "@/modules/sandbox/sandboxTypes.js";
 export interface CommandRunOptions {
     cwd?: string;
-    timeoutMs?: number;
+    timeoutMs?: number | null;
     input?: string;
     allowFailure?: boolean;
     onStdoutText?: (text: string) => void;

package/dist/modules/util/commandRun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commandRun.d.ts","sourceRoot":"","sources":["../../../sources/modules/util/commandRun.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAuF3B"}
+{"version":3,"file":"commandRun.d.ts","sourceRoot":"","sources":["../../../sources/modules/util/commandRun.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE,MAAM,WAAW,iBAAiB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAwF3B"}

package/dist/modules/util/commandRun.js

@@ -1,12 +1,12 @@
 import { spawn } from "node:child_process";
-import { text as catalog, textFormat } from "@text";
+import { textFormatKey } from "@text";
 import { pathResolveFromInitCwd } from "@/modules/util/pathResolveFromInitCwd.js";
 /**
  * Runs a command and captures stdout/stderr.
  * Throws on non-zero exit unless allowFailure is true.
  */
 export async function commandRun(command, args, options = {}) {
-    const timeoutMs = options.timeoutMs ?? 60_000;
+    const timeoutMs = options.timeoutMs === undefined ? 60_000 : options.timeoutMs;
     const cwdResolved = options.cwd ?? pathResolveFromInitCwd(".");
     const displayCommand = `${command} ${args.join(" ")}`;
     const abortController = new AbortController();
@@ -16,18 +16,21 @@ export async function commandRun(command, args, options = {}) {
         let stdout = "";
         let stderr = "";
         let settled = false;
-        const timeout = setTimeout(() => {
-            if (settled) {
-                return;
-            }
-            settled = true;
-            abortController.abort();
-            child.kill("SIGTERM");
-            reject(new Error(textFormat(catalog["error_command_timeout"], {
-                ms: timeoutMs,
-                command: displayCommand
-            })));
-        }, timeoutMs);
+        let timeout;
+        if (timeoutMs !== null) {
+            timeout = setTimeout(() => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                abortController.abort();
+                child.kill("SIGTERM");
+                reject(new Error(textFormatKey("error_command_timeout", {
+                    ms: timeoutMs,
+                    command: displayCommand
+                })));
+            }, timeoutMs);
+        }
         child.stdout.on("data", (chunk) => {
             const text = chunk.toString("utf-8");
             stdout += text;
@@ -43,7 +46,9 @@ export async function commandRun(command, args, options = {}) {
                 return;
             }
             settled = true;
-            clearTimeout(timeout);
+            if (timeout) {
+                clearTimeout(timeout);
+            }
             reject(error);
         });
         child.on("close", (code) => {
@@ -51,7 +56,9 @@ export async function commandRun(command, args, options = {}) {
                 return;
             }
             settled = true;
-            clearTimeout(timeout);
+            if (timeout) {
+                clearTimeout(timeout);
+            }
             resolve({
                 exitCode: code ?? 1,
                 stdout,
@@ -64,17 +71,15 @@ export async function commandRun(command, args, options = {}) {
         child.stdin.end();
     });
     if (!options.allowFailure && result.exitCode !== 0) {
-        throw new Error(textFormat(catalog["error_command_failed"], {
+        throw new Error(`${textFormatKey("error_command_failed", {
             code: result.exitCode,
             command: displayCommand
-        }) + `\n${result.stderr || result.stdout}`);
+        })}\n${result.stderr || result.stdout}`);
     }
     return result;
 }
 async function commandInvocationResolve(command, args, cwd, options, abortSignal) {
-    const env = options.env
-        ? { ...process.env, ...options.env }
-        : process.env;
+    const env = options.env ? { ...process.env, ...options.env } : process.env;
     if (!options.sandbox) {
         return {
             command,

package/dist/modules/util/commandRun.js.map

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

package/dist/modules/util/commandRun.spec.js

@@ -36,6 +36,16 @@ describe("commandRun", () => {
         expect(spawnMock).toHaveBeenCalledTimes(1);
         expect(spawnMock.mock.calls[0]?.[2]?.cwd).toBe("/tmp/explicit-cwd");
     });
+    it("skips timeout timer when timeoutMs is null", async () => {
+        const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout");
+        try {
+            await commandRun("echo", ["ok"], { timeoutMs: null });
+            expect(setTimeoutSpy).not.toHaveBeenCalled();
+        }
+        finally {
+            setTimeoutSpy.mockRestore();
+        }
+    });
     afterAll(() => {
         process.env.INIT_CWD = initCwd;
     });

package/dist/modules/util/commandRun.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"commandRun.spec.js","sourceRoot":"","sources":["../../../sources/modules/util/commandRun.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAExE,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAE5C,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,SAAS,iBAAiB;IAMxB,MAAM,KAAK,GAAG,IAAI,YAAY,EAK7B,CAAC;IAEF,KAAK,CAAC,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,KAAK,CAAC,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,KAAK,CAAC,KAAK,GAAG;QACZ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;QACtB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;KACrB,CAAC;IACF,KAAK,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;IAE7B,cAAc,CAAC,GAAG,EAAE;QAClB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAErC,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,4BAA4B,CAAC;QACpD,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjC,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,EAAE;QACZ,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"commandRun.spec.js","sourceRoot":"","sources":["../../../sources/modules/util/commandRun.spec.ts"],"names":[],"mappings":"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"}

package/dist/modules/util/pathLock.d.ts

@@ -0,0 +1,21 @@
+export interface PathLockResult {
+    locked: boolean;
+    conflicts: string[];
+    release: (() => Promise<void>) | null;
+}
+/**
+ * Coordinates path locks in-memory or through a disk-backed JSON file.
+ * Expects: all paths are in the same root namespace (usually repository-relative).
+ */
+export declare class PathLock {
+    static create(): PathLock;
+    static open(filePath: string): Promise<PathLock>;
+    private readonly stateLock;
+    private readonly filePath;
+    private lockedPaths;
+    private constructor();
+    lock(paths: string[]): Promise<PathLockResult>;
+    private sync;
+    private refresh;
+}
+//# sourceMappingURL=pathLock.d.ts.map

package/dist/modules/util/pathLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathLock.d.ts","sourceRoot":"","sources":["../../../sources/modules/util/pathLock.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACjB,MAAM,CAAC,MAAM,IAAI,QAAQ;WAIZ,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO;IAKD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;YAuCtC,IAAI;YAOJ,OAAO;CAMxB"}