@slopus/beer 0.1.1 → 0.1.2

package/dist/modules/sandbox/sandboxPassthrough.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a sandbox implementation that does not alter commands.
+ * Expects: caller uses this only when provider execution must remain tool-free.
+ */
+export function sandboxPassthrough() {
+    return {
+        async wrapCommand(command) {
+            return command;
+        }
+    };
+}
+//# sourceMappingURL=sandboxPassthrough.js.map

package/dist/modules/sandbox/sandboxPassthrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandboxPassthrough.js","sourceRoot":"","sources":["../../../sources/modules/sandbox/sandboxPassthrough.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO;QACH,KAAK,CAAC,WAAW,CAAC,OAAe;YAC7B,OAAO,OAAO,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/modules/sandbox/sandboxPassthrough.spec.d.ts

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

package/dist/modules/sandbox/sandboxPassthrough.spec.d.ts.map

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

package/dist/modules/sandbox/sandboxPassthrough.spec.js

@@ -0,0 +1,9 @@
+import { describe, expect, it } from "vitest";
+import { sandboxPassthrough } from "@/modules/sandbox/sandboxPassthrough.js";
+describe("sandboxPassthrough", () => {
+    it("returns command unchanged", async () => {
+        const sandbox = sandboxPassthrough();
+        await expect(sandbox.wrapCommand("pi --mode json --print prompt")).resolves.toBe("pi --mode json --print prompt");
+    });
+});
+//# sourceMappingURL=sandboxPassthrough.spec.js.map

package/dist/modules/sandbox/sandboxPassthrough.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandboxPassthrough.spec.js","sourceRoot":"","sources":["../../../sources/modules/sandbox/sandboxPassthrough.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAC5E,+BAA+B,CAClC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/modules/sandbox/sandboxTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxTypes.d.ts","sourceRoot":"","sources":["../../../sources/modules/sandbox/sandboxTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1E"}
+{"version":3,"file":"sandboxTypes.d.ts","sourceRoot":"","sources":["../../../sources/modules/sandbox/sandboxTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E"}

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

@@ -0,0 +1,7 @@
+import type { TreeChildEntry } from "@/types";
+/**
+ * Parses JSON text into normalized tree child entries.
+ * Expects: text is a JSON array of `{ title, slug }` objects.
+ */
+export declare function treeChildrenParse(text: string): TreeChildEntry[];
+//# sourceMappingURL=treeChildrenParse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenParse.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenParse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAGhE"}

package/dist/modules/tree/treeChildrenParse.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+const treeChildrenSchema = z.array(z.object({
+    title: z.string().min(1),
+    slug: z.string().min(1)
+}));
+/**
+ * Parses JSON text into normalized tree child entries.
+ * Expects: text is a JSON array of `{ title, slug }` objects.
+ */
+export function treeChildrenParse(text) {
+    const parsed = treeChildrenJsonParse(text);
+    return treeChildrenSchema.parse(parsed);
+}
+function treeChildrenJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Children output must be valid JSON: ${detail}`);
+    }
+}
+//# sourceMappingURL=treeChildrenParse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenParse.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenParse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAC9B,CAAC,CAAC,MAAM,CAAC;IACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CACL,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACvC,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { TreeChildEntry } from "@/types";
+/**
+ * Reads node children from `<dir>/children.json`.
+ * Expects: dirPath points to a node directory; returns null when file does not exist.
+ */
+export declare function treeChildrenRead(dirPath: string): Promise<TreeChildEntry[] | null>;
+//# sourceMappingURL=treeChildrenRead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenRead.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenRead.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CASxF"}

package/dist/modules/tree/treeChildrenRead.js

@@ -0,0 +1,44 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+const treeChildrenSchema = z.array(z.object({
+    title: z.string().min(1),
+    slug: z.string().min(1)
+}));
+/**
+ * Reads node children from `<dir>/children.json`.
+ * Expects: dirPath points to a node directory; returns null when file does not exist.
+ */
+export async function treeChildrenRead(dirPath) {
+    const filePath = path.join(dirPath, "children.json");
+    const raw = await treeFileReadOrNull(filePath);
+    if (raw === null) {
+        return null;
+    }
+    const parsed = treeJsonParse(filePath, raw);
+    return treeChildrenSchema.parse(parsed);
+}
+async function treeFileReadOrNull(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch (error) {
+        if (treeErrorIsNotFound(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function treeJsonParse(filePath, raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid JSON at ${filePath}: ${detail}`);
+    }
+}
+function treeErrorIsNotFound(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=treeChildrenRead.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenRead.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenRead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAC9B,CAAC,CAAC,MAAM,CAAC;IACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CACL,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,GAAW;IAChD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACrG,CAAC"}

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

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

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

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

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

@@ -0,0 +1,43 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { treeChildrenRead } from "@/modules/tree/treeChildrenRead.js";
+describe("treeChildrenRead", () => {
+    it("returns null when children.json is missing", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-children-read-"));
+        try {
+            await expect(treeChildrenRead(tempDir)).resolves.toBeNull();
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("reads parsed children entries", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-children-read-"));
+        try {
+            await writeFile(path.join(tempDir, "children.json"), JSON.stringify([
+                { title: "OAuth2", slug: "oauth2" },
+                { title: "Sessions", slug: "sessions" }
+            ], null, 2), "utf-8");
+            await expect(treeChildrenRead(tempDir)).resolves.toEqual([
+                { title: "OAuth2", slug: "oauth2" },
+                { title: "Sessions", slug: "sessions" }
+            ]);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("throws on malformed JSON", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-children-read-"));
+        try {
+            await writeFile(path.join(tempDir, "children.json"), "{bad", "utf-8");
+            await expect(treeChildrenRead(tempDir)).rejects.toThrow("Invalid JSON");
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=treeChildrenRead.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenRead.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenRead.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAChE,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC;YACD,MAAM,SAAS,CACX,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EACnC,IAAI,CAAC,SAAS,CACV;gBACI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACnC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;aAC1C,EACD,IAAI,EACJ,CAAC,CACJ,EACD,OAAO,CACV,CAAC;YAEF,MAAM,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrD,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACnC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;aAC1C,CAAC,CAAC;QACP,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACtE,MAAM,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5E,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { TreeChildEntry } from "@/types";
+/**
+ * Persists node children into `<dir>/children.json` using atomic rename.
+ * Expects: entries are pre-validated child title/slug pairs.
+ */
+export declare function treeChildrenWrite(dirPath: string, entries: readonly TreeChildEntry[]): Promise<void>;
+//# sourceMappingURL=treeChildrenWrite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenWrite.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenWrite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1G"}

package/dist/modules/tree/treeChildrenWrite.js

@@ -0,0 +1,15 @@
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Persists node children into `<dir>/children.json` using atomic rename.
+ * Expects: entries are pre-validated child title/slug pairs.
+ */
+export async function treeChildrenWrite(dirPath, entries) {
+    const filePath = path.join(dirPath, "children.json");
+    await mkdir(path.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    const payload = `${JSON.stringify(entries, null, 2)}\n`;
+    await writeFile(tempPath, payload, "utf-8");
+    await rename(tempPath, filePath);
+}
+//# sourceMappingURL=treeChildrenWrite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenWrite.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,OAAkC;IACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACrD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,34 @@
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { treeChildrenWrite } from "@/modules/tree/treeChildrenWrite.js";
+describe("treeChildrenWrite", () => {
+    it("creates parent dirs and writes children.json", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-children-write-"));
+        try {
+            const nodeDir = path.join(tempDir, "a", "b");
+            await treeChildrenWrite(nodeDir, [{ title: "Auth", slug: "auth" }]);
+            const raw = await readFile(path.join(nodeDir, "children.json"), "utf-8");
+            expect(JSON.parse(raw)).toEqual([{ title: "Auth", slug: "auth" }]);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("overwrites existing file content", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-children-write-"));
+        try {
+            const nodeDir = path.join(tempDir, "node");
+            await treeChildrenWrite(nodeDir, [{ title: "Old", slug: "old" }]);
+            await writeFile(path.join(nodeDir, "children.json"), "[]\n", "utf-8");
+            await treeChildrenWrite(nodeDir, [{ title: "New", slug: "new" }]);
+            const raw = await readFile(path.join(nodeDir, "children.json"), "utf-8");
+            expect(JSON.parse(raw)).toEqual([{ title: "New", slug: "new" }]);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=treeChildrenWrite.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeChildrenWrite.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeChildrenWrite.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iCAAiC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAEpE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iCAAiC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAClE,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAEtE,MAAM,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAClE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { Context, GenerateEvent } from "@/types";
+/**
+ * Runs one inference call under a dedicated progress line with event-based status updates.
+ * Expects: message is a user-facing base progress label and run forwards onEvent into inference.
+ */
+export declare function treeInferenceProgressRun<T>(ctx: Context, message: string, run: (onEvent: (event: GenerateEvent) => void) => Promise<T>): Promise<T>;
+//# sourceMappingURL=treeInferenceProgressRun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeInferenceProgressRun.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeInferenceProgressRun.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC5C,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/modules/tree/treeInferenceProgressRun.js

@@ -0,0 +1,16 @@
+import { generateProgressMessageResolve } from "@/_workflows/steps/generateProgressMessageResolve.js";
+/**
+ * Runs one inference call under a dedicated progress line with event-based status updates.
+ * Expects: message is a user-facing base progress label and run forwards onEvent into inference.
+ */
+export async function treeInferenceProgressRun(ctx, message, run) {
+    let progressTokenCount = 0;
+    return ctx.progress(`${message} (starting, tokens 0)`, async (report) => {
+        return run((event) => {
+            const updated = generateProgressMessageResolve(message, event, progressTokenCount);
+            progressTokenCount = updated.tokenCount;
+            report(updated.message);
+        });
+    });
+}
+//# sourceMappingURL=treeInferenceProgressRun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeInferenceProgressRun.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeInferenceProgressRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,sDAAsD,CAAC;AAGtG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,GAAY,EACZ,OAAe,EACf,GAA4D;IAE5D,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,uBAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACpE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,MAAM,OAAO,GAAG,8BAA8B,CAAC,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;YACnF,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;YACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

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

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

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

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

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

@@ -0,0 +1,35 @@
+import { describe, expect, it, vi } from "vitest";
+import { treeInferenceProgressRun } from "@/modules/tree/treeInferenceProgressRun.js";
+describe("treeInferenceProgressRun", () => {
+    it("maps inference events to progress updates", async () => {
+        const updates = [];
+        const ctx = {
+            progress: async (_initialMessage, operation) => operation((message) => updates.push(message))
+        };
+        const runMock = vi.fn(async (onEvent) => {
+            onEvent({
+                providerId: "pi",
+                type: "thinking",
+                status: "started",
+                text: "thinking"
+            });
+            onEvent({
+                providerId: "pi",
+                type: "usage",
+                tokens: {
+                    input: 10,
+                    output: 5,
+                    cacheRead: 0,
+                    cacheWrite: 0,
+                    total: 15
+                }
+            });
+            return "ok";
+        });
+        const result = await treeInferenceProgressRun(ctx, "Generating root children...", runMock);
+        expect(result).toBe("ok");
+        expect(updates.some((entry) => entry.includes("thinking"))).toBe(true);
+        expect(updates.some((entry) => entry.includes("tokens 15"))).toBe(true);
+    });
+});
+//# sourceMappingURL=treeInferenceProgressRun.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeInferenceProgressRun.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeInferenceProgressRun.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG;YACR,QAAQ,EAAE,KAAK,EACX,eAAuB,EACvB,SAA4D,EAClD,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SAC3C,CAAC;QAExB,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAuC,EAAE,EAAE;YACpE,OAAO,CAAC;gBACJ,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,UAAU;aACnB,CAAC,CAAC;YACH,OAAO,CAAC;gBACJ,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE;oBACJ,KAAK,EAAE,EAAE;oBACT,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,CAAC;oBACZ,UAAU,EAAE,CAAC;oBACb,KAAK,EAAE,EAAE;iBACZ;aACJ,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,6BAA6B,EAAE,OAAO,CAAC,CAAC;QAE3F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { Context, TreeNode, TreeSearchConfig } from "@/types";
+/**
+ * Picks the next unexpanded leaf using an inference call over the rendered tree state.
+ * Expects: config.rootDir contains persisted tree node metadata.
+ */
+export declare function treeLeafPick(ctx: Context, config: TreeSearchConfig): Promise<TreeNode | null>;
+//# sourceMappingURL=treeLeafPick.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeLeafPick.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeLeafPick.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsCnG"}

package/dist/modules/tree/treeLeafPick.js

@@ -0,0 +1,67 @@
+import { text } from "@text";
+import { generateText } from "@/modules/ai/generateText.js";
+import { treeInferenceProgressRun } from "@/modules/tree/treeInferenceProgressRun.js";
+import { treeNodePathResolve } from "@/modules/tree/treeNodePathResolve.js";
+import { treeNodeRead } from "@/modules/tree/treeNodeRead.js";
+import { treeStateLeaves } from "@/modules/tree/treeStateLeaves.js";
+import { treeStateRead } from "@/modules/tree/treeStateRead.js";
+import { treeStateRender } from "@/modules/tree/treeStateRender.js";
+/**
+ * Picks the next unexpanded leaf using an inference call over the rendered tree state.
+ * Expects: config.rootDir contains persisted tree node metadata.
+ */
+export async function treeLeafPick(ctx, config) {
+    const maxAttempts = 5;
+    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        const state = await treeStateRead(config.rootDir);
+        const leaves = treeStateLeaves(state);
+        if (leaves.length === 0) {
+            return null;
+        }
+        const treeOutline = treeStateRender(state);
+        const prompt = config.pickerPrompt?.(treeOutline, leaves) ??
+            treeLeafPickPromptDefault(config.rootDir, treeOutline, leaves);
+        const result = await treeInferenceProgressRun(ctx, text.tree_search_picking_leaf, async (onEvent) => {
+            return generateText(ctx, prompt, {
+                modelSelectionMode: config.modelSelectionMode,
+                onEvent
+            });
+        });
+        const selectedPath = treeLeafPathNormalize(result.text);
+        const selected = leaves.find((leaf) => treeNodePathResolve(config.rootDir, leaf) === selectedPath);
+        if (!selected) {
+            continue;
+        }
+        const latestNode = await treeNodeRead(selected.dirPath);
+        if (latestNode?.status === "in-progress") {
+            continue;
+        }
+        if (latestNode && latestNode.status !== "unexpanded") {
+            continue;
+        }
+        return selected;
+    }
+    return null;
+}
+function treeLeafPickPromptDefault(rootDir, treeOutline, leaves) {
+    const candidates = leaves.map((leaf) => `- ${treeNodePathResolve(rootDir, leaf)}`).join("\n");
+    return [
+        "You are a research planner analyzing a tree of topics being explored.",
+        "",
+        "Here is the current state of the research tree:",
+        treeOutline,
+        "",
+        "Candidate unexpanded leaves:",
+        candidates,
+        "",
+        "Select the ONE most important unexpanded leaf to research next.",
+        "Consider: coverage gaps, dependencies between topics, foundational vs advanced.",
+        "",
+        "Return ONLY the slug path inside <output> tags.",
+        "Example: <output>authentication-system/oauth2-flow</output>"
+    ].join("\n");
+}
+function treeLeafPathNormalize(raw) {
+    return raw.trim().replace(/^\/+|\/+$/g, "");
+}
+//# sourceMappingURL=treeLeafPick.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,119 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const generateTextMock = vi.hoisted(() => vi.fn());
+const treeStateReadMock = vi.hoisted(() => vi.fn());
+const treeStateRenderMock = vi.hoisted(() => vi.fn());
+const treeStateLeavesMock = vi.hoisted(() => vi.fn());
+const treeNodeReadMock = vi.hoisted(() => vi.fn());
+vi.mock("@/modules/ai/generateText.js", () => ({
+    generateText: generateTextMock
+}));
+vi.mock("@/modules/tree/treeStateRead.js", () => ({
+    treeStateRead: treeStateReadMock
+}));
+vi.mock("@/modules/tree/treeStateRender.js", () => ({
+    treeStateRender: treeStateRenderMock
+}));
+vi.mock("@/modules/tree/treeStateLeaves.js", () => ({
+    treeStateLeaves: treeStateLeavesMock
+}));
+vi.mock("@/modules/tree/treeNodeRead.js", () => ({
+    treeNodeRead: treeNodeReadMock
+}));
+import { treeLeafPick } from "@/modules/tree/treeLeafPick.js";
+describe("treeLeafPick", () => {
+    beforeEach(() => {
+        generateTextMock.mockReset();
+        treeStateReadMock.mockReset();
+        treeStateRenderMock.mockReset();
+        treeStateLeavesMock.mockReset();
+        treeNodeReadMock.mockReset();
+    });
+    it("returns null when no unexpanded leaves remain", async () => {
+        treeStateReadMock.mockResolvedValue([]);
+        treeStateLeavesMock.mockReturnValue([]);
+        const context = treeLeafPickContext();
+        const result = await treeLeafPick(context, {
+            rootDir: "/tmp/tree",
+            rootPrompt: "root",
+            documentPrompt: () => "doc",
+            childrenPrompt: () => "children"
+        });
+        expect(result).toBeNull();
+        expect(generateTextMock).not.toHaveBeenCalled();
+    });
+    it("uses tree outline prompt and returns selected leaf", async () => {
+        const leafA = treeLeafPickNode("/tmp/tree/auth/oauth2", "/tmp/tree/auth", "oauth2", "OAuth2");
+        const leafB = treeLeafPickNode("/tmp/tree/db/migrations", "/tmp/tree/db", "migrations", "Migrations");
+        treeStateReadMock.mockResolvedValue([leafA, leafB]);
+        treeStateRenderMock.mockReturnValue("- Auth [expanded]");
+        treeStateLeavesMock.mockReturnValue([leafA, leafB]);
+        generateTextMock.mockResolvedValue({ provider: "pi", text: "auth/oauth2" });
+        treeNodeReadMock.mockResolvedValue({ title: "OAuth2", slug: "oauth2", status: "unexpanded" });
+        const context = treeLeafPickContext();
+        const result = await treeLeafPick(context, {
+            rootDir: "/tmp/tree",
+            rootPrompt: "root",
+            documentPrompt: () => "doc",
+            childrenPrompt: () => "children",
+            modelSelectionMode: "codex-xhigh"
+        });
+        expect(result).toBe(leafA);
+        expect(generateTextMock).toHaveBeenCalledWith(context, expect.stringContaining("- Auth [expanded]"), expect.objectContaining({ modelSelectionMode: "codex-xhigh" }));
+    });
+    it("retries when picker returns a node already marked in-progress", async () => {
+        const leaf = treeLeafPickNode("/tmp/tree/auth/oauth2", "/tmp/tree/auth", "oauth2", "OAuth2");
+        treeStateReadMock.mockResolvedValue([leaf]);
+        treeStateRenderMock.mockReturnValue("- Auth [expanded]");
+        treeStateLeavesMock.mockReturnValue([leaf]);
+        generateTextMock
+            .mockResolvedValueOnce({ provider: "pi", text: "auth/oauth2" })
+            .mockResolvedValueOnce({ provider: "pi", text: "auth/oauth2" });
+        treeNodeReadMock
+            .mockResolvedValueOnce({ title: "OAuth2", slug: "oauth2", status: "in-progress" })
+            .mockResolvedValueOnce({ title: "OAuth2", slug: "oauth2", status: "unexpanded" });
+        const context = treeLeafPickContext();
+        const result = await treeLeafPick(context, {
+            rootDir: "/tmp/tree",
+            rootPrompt: "root",
+            documentPrompt: () => "doc",
+            childrenPrompt: () => "children"
+        });
+        expect(result).toBe(leaf);
+        expect(generateTextMock).toHaveBeenCalledTimes(2);
+    });
+    it("returns null when picker keeps returning invalid paths", async () => {
+        const leaf = treeLeafPickNode("/tmp/tree/auth/oauth2", "/tmp/tree/auth", "oauth2", "OAuth2");
+        treeStateReadMock.mockResolvedValue([leaf]);
+        treeStateRenderMock.mockReturnValue("- Auth [expanded]");
+        treeStateLeavesMock.mockReturnValue([leaf]);
+        generateTextMock.mockResolvedValue({ provider: "pi", text: "not-a-real-path" });
+        const context = treeLeafPickContext();
+        const result = await treeLeafPick(context, {
+            rootDir: "/tmp/tree",
+            rootPrompt: "root",
+            documentPrompt: () => "doc",
+            childrenPrompt: () => "children"
+        });
+        expect(result).toBeNull();
+        expect(generateTextMock).toHaveBeenCalledTimes(5);
+    });
+});
+function treeLeafPickNode(dirPath, parentDirPath, slug, title) {
+    return {
+        slug,
+        title,
+        depth: 2,
+        dirPath,
+        parentDirPath,
+        status: "unexpanded",
+        children: []
+    };
+}
+function treeLeafPickContext() {
+    return {
+        projectPath: "/tmp/project",
+        providers: [],
+        progress: async (_initialMessage, operation) => operation(() => { })
+    };
+}
+//# sourceMappingURL=treeLeafPick.spec.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { Context, TreeChildEntry, TreeNode, TreeSearchConfig } from "@/types";
+export interface TreeNodeExpandResult {
+    children: TreeChildEntry[];
+    status: "expanded" | "leaf";
+    skipped: boolean;
+}
+/**
+ * Expands a single node by generating its document and children list in one session.
+ * Expects: node points to an on-disk tree directory with writable permissions.
+ */
+export declare function treeNodeExpand(ctx: Context, node: TreeNode, config: TreeSearchConfig): Promise<TreeNodeExpandResult>;
+//# sourceMappingURL=treeNodeExpand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeExpand.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeExpand.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAChC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsG/B"}