@slopus/beer 0.1.1 → 0.1.2

package/dist/modules/tree/treeNodeExpand.js

@@ -0,0 +1,128 @@
+import { mkdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { textFormatKey } from "@text";
+import matter from "gray-matter";
+import { generateSessionCreate } from "@/modules/ai/generateSessionCreate.js";
+import { treeChildrenParse } from "@/modules/tree/treeChildrenParse.js";
+import { treeChildrenRead } from "@/modules/tree/treeChildrenRead.js";
+import { treeChildrenWrite } from "@/modules/tree/treeChildrenWrite.js";
+import { treeInferenceProgressRun } from "@/modules/tree/treeInferenceProgressRun.js";
+import { treeNodeRead } from "@/modules/tree/treeNodeRead.js";
+import { treeNodeWrite } from "@/modules/tree/treeNodeWrite.js";
+/**
+ * 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 async function treeNodeExpand(ctx, node, config) {
+    await mkdir(node.dirPath, { recursive: true });
+    const existingNode = await treeNodeRead(node.dirPath);
+    const existingChildren = await treeChildrenRead(node.dirPath);
+    const nodeStatus = treeNodeExpandStatusResolve(existingNode?.status ?? node.status);
+    const documentPath = path.join(node.dirPath, "document.md");
+    if ((nodeStatus === "expanded" || nodeStatus === "leaf") &&
+        existingChildren !== null &&
+        (await treeNodeExpandFileExists(documentPath))) {
+        return {
+            children: existingChildren,
+            status: existingChildren.length > 0 ? "expanded" : "leaf",
+            skipped: true
+        };
+    }
+    const parentSessionId = await treeNodeExpandParentSessionResolve(node.parentDirPath, config.rootDir);
+    const session = generateSessionCreate(ctx, {
+        sessionId: parentSessionId
+    });
+    const documentPrompt = config.documentPrompt(node);
+    await treeInferenceProgressRun(ctx, textFormatKey("tree_search_document_generating", { title: node.title }), async (onEvent) => session.generate(documentPrompt, {
+        modelSelectionMode: config.modelSelectionMode,
+        onEvent,
+        expectedOutput: config.frontmatterSchema
+            ? {
+                type: "file",
+                filePath: documentPath,
+                verify: ({ filePath, fileContent }) => {
+                    treeNodeExpandFrontmatterVerify(documentPath, filePath, fileContent, config.frontmatterSchema);
+                }
+            }
+            : {
+                type: "file",
+                filePath: documentPath
+            },
+        writePolicy: {
+            mode: "write-whitelist",
+            writablePaths: [documentPath]
+        }
+    }));
+    const childrenResult = await treeInferenceProgressRun(ctx, textFormatKey("tree_search_children_generating", { title: node.title }), async (onEvent) => session.generate(config.childrenPrompt(node), {
+        modelSelectionMode: config.modelSelectionMode,
+        onEvent,
+        expectedOutput: {
+            type: "text",
+            verify: ({ text: outputText }) => {
+                treeChildrenParse(outputText);
+            }
+        }
+    }));
+    const children = treeChildrenParse(childrenResult.text);
+    await treeChildrenWrite(node.dirPath, children);
+    const status = children.length > 0 ? "expanded" : "leaf";
+    await treeNodeWrite(node.dirPath, {
+        title: node.title,
+        slug: node.slug,
+        sessionId: session.sessionId,
+        status
+    });
+    for (const child of children) {
+        const childDirPath = path.join(node.dirPath, child.slug);
+        const childNode = await treeNodeRead(childDirPath);
+        if (childNode) {
+            continue;
+        }
+        await treeNodeWrite(childDirPath, {
+            title: child.title,
+            slug: child.slug,
+            status: "unexpanded"
+        });
+    }
+    return {
+        children,
+        status,
+        skipped: false
+    };
+}
+function treeNodeExpandStatusResolve(status) {
+    if (status === "unexpanded" || status === "in-progress" || status === "expanded" || status === "leaf") {
+        return status;
+    }
+    return "unexpanded";
+}
+async function treeNodeExpandParentSessionResolve(parentDirPath, rootDir) {
+    if (path.resolve(parentDirPath) === path.resolve(rootDir)) {
+        return undefined;
+    }
+    const parentNode = await treeNodeRead(parentDirPath);
+    return parentNode?.sessionId;
+}
+async function treeNodeExpandFileExists(filePath) {
+    try {
+        const fileStat = await stat(filePath);
+        return fileStat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function treeNodeExpandFrontmatterVerify(expectedFilePath, filePath, fileContent, schema) {
+    if (path.resolve(filePath) !== path.resolve(expectedFilePath)) {
+        throw new Error(`File must be generated at path: ${expectedFilePath}`);
+    }
+    if (!matter.test(fileContent)) {
+        throw new Error(`Generated file must include frontmatter: ${expectedFilePath}`);
+    }
+    const parsed = matter(fileContent);
+    const parsedFrontmatter = schema.safeParse(parsed.data);
+    if (!parsedFrontmatter.success) {
+        throw new Error(`Generated frontmatter does not match schema: ${parsedFrontmatter.error.message}`);
+    }
+}
+//# sourceMappingURL=treeNodeExpand.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,146 @@
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const generateSessionCreateMock = vi.hoisted(() => vi.fn());
+vi.mock("@/modules/ai/generateSessionCreate.js", () => ({
+    generateSessionCreate: generateSessionCreateMock
+}));
+import { treeNodeExpand } from "@/modules/tree/treeNodeExpand.js";
+import { treeNodeRead } from "@/modules/tree/treeNodeRead.js";
+import { treeNodeWrite } from "@/modules/tree/treeNodeWrite.js";
+describe("treeNodeExpand", () => {
+    beforeEach(() => {
+        generateSessionCreateMock.mockReset();
+    });
+    it("runs document + children generation in one forked session and persists files", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-expand-"));
+        try {
+            const rootDir = path.join(tempDir, "tree");
+            const parentDir = path.join(rootDir, "auth");
+            const nodeDir = path.join(parentDir, "oauth2");
+            await treeNodeWrite(parentDir, {
+                title: "Authentication",
+                slug: "auth",
+                sessionId: "sess-parent",
+                status: "expanded"
+            });
+            await treeNodeWrite(nodeDir, {
+                title: "OAuth2 Flow",
+                slug: "oauth2",
+                status: "unexpanded"
+            });
+            const generateMock = vi
+                .fn()
+                .mockImplementationOnce(async (_prompt, permissions) => {
+                const expectedOutput = permissions.expectedOutput;
+                await writeFile(expectedOutput.filePath, "---\ntitle: OAuth2\n---\n\nBody\n", "utf-8");
+                expectedOutput.verify?.({
+                    text: "ok",
+                    filePath: expectedOutput.filePath,
+                    fileContent: "---\ntitle: OAuth2\n---\n\nBody\n"
+                });
+                return { provider: "pi", sessionId: "sess-child", text: "wrote doc" };
+            })
+                .mockImplementationOnce(async () => {
+                return {
+                    provider: "pi",
+                    sessionId: "sess-child",
+                    text: JSON.stringify([{ title: "Token Refresh", slug: "token-refresh" }])
+                };
+            });
+            generateSessionCreateMock.mockReturnValue({
+                sessionId: "sess-child",
+                generate: generateMock
+            });
+            const context = treeNodeExpandContext(tempDir);
+            const node = {
+                title: "OAuth2 Flow",
+                slug: "oauth2",
+                depth: 2,
+                dirPath: nodeDir,
+                parentDirPath: parentDir,
+                status: "unexpanded",
+                children: []
+            };
+            const result = await treeNodeExpand(context, node, {
+                rootDir,
+                rootPrompt: "unused",
+                documentPrompt: (entry) => `Document ${entry.title}`,
+                childrenPrompt: (entry) => `Children ${entry.title}`,
+                modelSelectionMode: "codex-high"
+            });
+            expect(generateSessionCreateMock).toHaveBeenCalledWith(context, { sessionId: "sess-parent" });
+            expect(generateMock).toHaveBeenCalledTimes(2);
+            expect(result).toEqual({
+                children: [{ title: "Token Refresh", slug: "token-refresh" }],
+                status: "expanded",
+                skipped: false
+            });
+            const childrenRaw = await readFile(path.join(nodeDir, "children.json"), "utf-8");
+            expect(JSON.parse(childrenRaw)).toEqual([{ title: "Token Refresh", slug: "token-refresh" }]);
+            await expect(treeNodeRead(nodeDir)).resolves.toEqual({
+                title: "OAuth2 Flow",
+                slug: "oauth2",
+                sessionId: "sess-child",
+                status: "expanded"
+            });
+            await expect(treeNodeRead(path.join(nodeDir, "token-refresh"))).resolves.toEqual({
+                title: "Token Refresh",
+                slug: "token-refresh",
+                status: "unexpanded"
+            });
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("skips inference when node is already expanded with persisted document and children", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-expand-"));
+        try {
+            const rootDir = path.join(tempDir, "tree");
+            const nodeDir = path.join(rootDir, "auth");
+            await treeNodeWrite(nodeDir, {
+                title: "Authentication",
+                slug: "auth",
+                sessionId: "sess-auth",
+                status: "expanded"
+            });
+            await writeFile(path.join(nodeDir, "document.md"), "---\ntitle: Auth\n---\n", "utf-8");
+            await writeFile(path.join(nodeDir, "children.json"), "[]\n", "utf-8");
+            const context = treeNodeExpandContext(tempDir);
+            const node = {
+                title: "Authentication",
+                slug: "auth",
+                depth: 1,
+                dirPath: nodeDir,
+                parentDirPath: rootDir,
+                status: "expanded",
+                children: []
+            };
+            const result = await treeNodeExpand(context, node, {
+                rootDir,
+                rootPrompt: "unused",
+                documentPrompt: () => "doc",
+                childrenPrompt: () => "children"
+            });
+            expect(result).toEqual({
+                children: [],
+                status: "leaf",
+                skipped: true
+            });
+            expect(generateSessionCreateMock).not.toHaveBeenCalled();
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+function treeNodeExpandContext(projectPath) {
+    return {
+        projectPath,
+        providers: [],
+        progress: async (_initialMessage, operation) => operation(() => { })
+    };
+}
+//# sourceMappingURL=treeNodeExpand.spec.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { TreeNode } from "@/types";
+/**
+ * Resolves a node path relative to the tree root using slash-separated slugs.
+ * Expects: node.dirPath is located under rootDir.
+ */
+export declare function treeNodePathResolve(rootDir: string, node: TreeNode): string;
+//# sourceMappingURL=treeNodePathResolve.d.ts.map

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

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

package/dist/modules/tree/treeNodePathResolve.js

@@ -0,0 +1,9 @@
+import path from "node:path";
+/**
+ * Resolves a node path relative to the tree root using slash-separated slugs.
+ * Expects: node.dirPath is located under rootDir.
+ */
+export function treeNodePathResolve(rootDir, node) {
+    return path.relative(rootDir, node.dirPath).split(path.sep).join("/");
+}
+//# sourceMappingURL=treeNodePathResolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodePathResolve.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodePathResolve.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,IAAc;IAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC"}

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

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

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

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

package/dist/modules/tree/treeNodeRead.js

@@ -0,0 +1,46 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+const treeNodeDiskSchema = z.object({
+    title: z.string().min(1),
+    slug: z.string().min(1),
+    sessionId: z.string().min(1).optional(),
+    status: z.string().min(1)
+});
+/**
+ * Reads node metadata from `<dir>/node.json`.
+ * Expects: dirPath points to a node directory; returns null when file does not exist.
+ */
+export async function treeNodeRead(dirPath) {
+    const filePath = path.join(dirPath, "node.json");
+    const raw = await treeFileReadOrNull(filePath);
+    if (raw === null) {
+        return null;
+    }
+    const parsed = treeJsonParse(filePath, raw);
+    return treeNodeDiskSchema.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=treeNodeRead.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeRead.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeRead.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,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,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/treeNodeRead.spec.d.ts

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

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

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

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

@@ -0,0 +1,42 @@
+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 { treeNodeRead } from "@/modules/tree/treeNodeRead.js";
+describe("treeNodeRead", () => {
+    it("returns null when node.json is missing", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-node-read-"));
+        try {
+            await expect(treeNodeRead(tempDir)).resolves.toBeNull();
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("reads parsed node metadata", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-node-read-"));
+        try {
+            await writeFile(path.join(tempDir, "node.json"), JSON.stringify({ title: "Auth", slug: "auth", sessionId: "sess-1", status: "expanded" }, null, 2), "utf-8");
+            await expect(treeNodeRead(tempDir)).resolves.toEqual({
+                title: "Auth",
+                slug: "auth",
+                sessionId: "sess-1",
+                status: "expanded"
+            });
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("throws on malformed JSON", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-node-read-"));
+        try {
+            await writeFile(path.join(tempDir, "node.json"), "{bad", "utf-8");
+            await expect(treeNodeRead(tempDir)).rejects.toThrow("Invalid JSON");
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=treeNodeRead.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeRead.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeRead.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,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC5D,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,4BAA4B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC;YACD,MAAM,SAAS,CACX,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EACjG,OAAO,CACV,CAAC;YAEF,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACjD,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,UAAU;aACrB,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,4BAA4B,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACxE,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/treeNodeSlug.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a title to a filesystem-safe slug.
+ * Expects: title is user-provided free text and output is limited to lowercase ASCII + hyphens.
+ */
+export declare function treeNodeSlug(title: string): string;
+//# sourceMappingURL=treeNodeSlug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeSlug.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeSlug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBlD"}

package/dist/modules/tree/treeNodeSlug.js

@@ -0,0 +1,20 @@
+/**
+ * Converts a title to a filesystem-safe slug.
+ * Expects: title is user-provided free text and output is limited to lowercase ASCII + hyphens.
+ */
+export function treeNodeSlug(title) {
+    const normalized = title
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!normalized) {
+        return "node";
+    }
+    const limited = normalized.slice(0, 60).replace(/-+$/g, "");
+    return limited || "node";
+}
+//# sourceMappingURL=treeNodeSlug.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeSlug.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeSlug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,MAAM,UAAU,GAAG,KAAK;SACnB,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE7B,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,OAAO,IAAI,MAAM,CAAC;AAC7B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { treeNodeSlug } from "@/modules/tree/treeNodeSlug.js";
+describe("treeNodeSlug", () => {
+    it("converts spaces to hyphen separators", () => {
+        expect(treeNodeSlug("Authentication System")).toBe("authentication-system");
+    });
+    it("removes special characters and deduplicates separators", () => {
+        expect(treeNodeSlug("Auth!!! ## OAuth@@@ Flow")).toBe("auth-oauth-flow");
+    });
+    it("normalizes unicode accents", () => {
+        expect(treeNodeSlug("Crème Brûlée Topics")).toBe("creme-brulee-topics");
+    });
+    it("returns fallback for empty values", () => {
+        expect(treeNodeSlug("   ")).toBe("node");
+        expect(treeNodeSlug("***")).toBe("node");
+    });
+    it("limits output length and removes trailing hyphens after truncation", () => {
+        expect(treeNodeSlug(`${"very-long-topic-".repeat(8)}end`)).toHaveLength(60);
+        expect(treeNodeSlug(`${"a".repeat(59)} !`)).not.toMatch(/-$/);
+    });
+    it("trims trailing hyphens", () => {
+        expect(treeNodeSlug("Auth Topic ---")).toBe("auth-topic");
+    });
+});
+//# sourceMappingURL=treeNodeSlug.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeSlug.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeSlug.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { TreeNodeDisk } from "@/types";
+/**
+ * Persists node metadata into `<dir>/node.json` using atomic rename.
+ * Expects: nodeData contains title/slug/status and optional session id.
+ */
+export declare function treeNodeWrite(dirPath: string, nodeData: TreeNodeDisk): Promise<void>;
+//# sourceMappingURL=treeNodeWrite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeWrite.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeWrite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1F"}

package/dist/modules/tree/treeNodeWrite.js

@@ -0,0 +1,15 @@
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Persists node metadata into `<dir>/node.json` using atomic rename.
+ * Expects: nodeData contains title/slug/status and optional session id.
+ */
+export async function treeNodeWrite(dirPath, nodeData) {
+    const filePath = path.join(dirPath, "node.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(nodeData, null, 2)}\n`;
+    await writeFile(tempPath, payload, "utf-8");
+    await rename(tempPath, filePath);
+}
+//# sourceMappingURL=treeNodeWrite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeWrite.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeWrite.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,aAAa,CAAC,OAAe,EAAE,QAAsB;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,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,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACzD,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/treeNodeWrite.spec.d.ts

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

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

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

package/dist/modules/tree/treeNodeWrite.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 { treeNodeWrite } from "@/modules/tree/treeNodeWrite.js";
+describe("treeNodeWrite", () => {
+    it("creates parent dirs and writes node.json", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-node-write-"));
+        try {
+            const nodeDir = path.join(tempDir, "a", "b");
+            await treeNodeWrite(nodeDir, { title: "Auth", slug: "auth", status: "unexpanded" });
+            const raw = await readFile(path.join(nodeDir, "node.json"), "utf-8");
+            expect(JSON.parse(raw)).toEqual({ title: "Auth", slug: "auth", status: "unexpanded" });
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    it("overwrites existing file content", async () => {
+        const tempDir = await mkdtemp(path.join(os.tmpdir(), "holdmybeer-tree-node-write-"));
+        try {
+            const nodeDir = path.join(tempDir, "node");
+            await treeNodeWrite(nodeDir, { title: "Old", slug: "old", status: "unexpanded" });
+            await writeFile(path.join(nodeDir, "node.json"), "{}\n", "utf-8");
+            await treeNodeWrite(nodeDir, { title: "New", slug: "new", sessionId: "sess-2", status: "expanded" });
+            const raw = await readFile(path.join(nodeDir, "node.json"), "utf-8");
+            expect(JSON.parse(raw)).toEqual({ title: "New", slug: "new", sessionId: "sess-2", status: "expanded" });
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=treeNodeWrite.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeNodeWrite.spec.js","sourceRoot":"","sources":["../../../sources/modules/tree/treeNodeWrite.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,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAEpF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3F,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,6BAA6B,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAClF,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAElE,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACrG,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5G,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/treeSearchRun.d.ts

@@ -0,0 +1,7 @@
+import type { Context, TreeSearchConfig, TreeSearchResult } from "@/types";
+/**
+ * Runs persisted two-phase tree search: root walk, then LLM-guided leaf expansion.
+ * Expects: config.documentPrompt/childrenPrompt are deterministic and rootDir is writable.
+ */
+export declare function treeSearchRun(ctx: Context, config: TreeSearchConfig): Promise<TreeSearchResult>;
+//# sourceMappingURL=treeSearchRun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeSearchRun.d.ts","sourceRoot":"","sources":["../../../sources/modules/tree/treeSearchRun.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAY,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErF;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgDrG"}