@indigoai-us/cq 0.0.1

package/dist/knowledge-tree/__tests__/knowledge-tree.test.js

@@ -0,0 +1,317 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, readFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { initKnowledgeTree, writeEntry, readEntry, listEntries, listCategories, removeEntry, createCategory, generateIndex, generateIndexRecursive, slugify, } from "../index.js";
+let dataDir;
+beforeEach(async () => {
+    dataDir = await mkdtemp(join(tmpdir(), "cq-kt-"));
+});
+afterEach(async () => {
+    await rm(dataDir, { recursive: true, force: true });
+});
+// ---------------------------------------------------------------------------
+// slugify
+// ---------------------------------------------------------------------------
+describe("slugify", () => {
+    it("lowercases and replaces spaces with hyphens", () => {
+        expect(slugify("Hello World")).toBe("hello-world");
+    });
+    it("strips leading/trailing hyphens", () => {
+        expect(slugify("--foo--")).toBe("foo");
+    });
+    it("collapses non-alphanumeric runs", () => {
+        expect(slugify("What is AI?!")).toBe("what-is-ai");
+    });
+});
+// ---------------------------------------------------------------------------
+// initKnowledgeTree
+// ---------------------------------------------------------------------------
+describe("initKnowledgeTree", () => {
+    it("creates the root directory", async () => {
+        const root = join(dataDir, "knowledge");
+        await initKnowledgeTree(root);
+        // Should not throw when reading the directory
+        const { readdir } = await import("node:fs/promises");
+        const entries = await readdir(root);
+        expect(entries).toEqual([]);
+    });
+    it("is idempotent", async () => {
+        const root = join(dataDir, "knowledge");
+        await initKnowledgeTree(root);
+        await initKnowledgeTree(root);
+        // No error
+    });
+});
+// ---------------------------------------------------------------------------
+// writeEntry / readEntry
+// ---------------------------------------------------------------------------
+describe("writeEntry + readEntry", () => {
+    it("creates a .md file with YAML frontmatter", async () => {
+        const slug = await writeEntry(dataDir, {
+            category: "science",
+            title: "Quantum Computing Basics",
+            content: "Qubits are the fundamental unit.",
+            tags: ["quantum", "computing"],
+            source: "https://example.com",
+        });
+        expect(slug).toBe("quantum-computing-basics");
+        const raw = await readFile(join(dataDir, "science", "quantum-computing-basics.md"), "utf-8");
+        expect(raw).toContain("---");
+        expect(raw).toContain("title: Quantum Computing Basics");
+        expect(raw).toContain("Qubits are the fundamental unit.");
+    });
+    it("reads back a written entry correctly", async () => {
+        await writeEntry(dataDir, {
+            category: "tech",
+            slug: "rust-lang",
+            title: "Rust Programming",
+            content: "Memory safety without GC.",
+            tags: ["rust", "systems"],
+        });
+        const entry = await readEntry(dataDir, "tech", "rust-lang");
+        expect(entry.title).toBe("Rust Programming");
+        expect(entry.content).toBe("Memory safety without GC.\n");
+        expect(entry.tags).toEqual(["rust", "systems"]);
+        expect(entry.category).toBe("tech");
+        expect(entry.slug).toBe("rust-lang");
+        expect(entry.source).toBeUndefined();
+    });
+    it("preserves created date on update", async () => {
+        await writeEntry(dataDir, {
+            category: "tech",
+            slug: "node",
+            title: "Node.js",
+            content: "Version 1",
+        });
+        const first = await readEntry(dataDir, "tech", "node");
+        // Small delay to ensure timestamp changes
+        await new Promise((r) => setTimeout(r, 10));
+        await writeEntry(dataDir, {
+            category: "tech",
+            slug: "node",
+            title: "Node.js Updated",
+            content: "Version 2",
+        });
+        const second = await readEntry(dataDir, "tech", "node");
+        expect(second.created).toBe(first.created);
+        expect(second.title).toBe("Node.js Updated");
+    });
+    it("uses explicit slug when provided", async () => {
+        const slug = await writeEntry(dataDir, {
+            category: "misc",
+            slug: "my-custom-slug",
+            title: "Custom Slug Entry",
+            content: "Body.",
+        });
+        expect(slug).toBe("my-custom-slug");
+    });
+    it("includes source in frontmatter when provided", async () => {
+        await writeEntry(dataDir, {
+            category: "links",
+            slug: "example",
+            title: "Example",
+            content: "Content.",
+            source: "https://example.com",
+        });
+        const entry = await readEntry(dataDir, "links", "example");
+        expect(entry.source).toBe("https://example.com");
+    });
+});
+// ---------------------------------------------------------------------------
+// removeEntry
+// ---------------------------------------------------------------------------
+describe("removeEntry", () => {
+    it("deletes the entry file", async () => {
+        await writeEntry(dataDir, {
+            category: "temp",
+            slug: "delete-me",
+            title: "Delete Me",
+            content: "Gone soon.",
+        });
+        await removeEntry(dataDir, "temp", "delete-me");
+        await expect(readEntry(dataDir, "temp", "delete-me")).rejects.toThrow();
+    });
+});
+// ---------------------------------------------------------------------------
+// listEntries
+// ---------------------------------------------------------------------------
+describe("listEntries", () => {
+    it("returns entries sorted by title", async () => {
+        await writeEntry(dataDir, {
+            category: "animals",
+            slug: "zebra",
+            title: "Zebra",
+            content: "Striped.",
+        });
+        await writeEntry(dataDir, {
+            category: "animals",
+            slug: "aardvark",
+            title: "Aardvark",
+            content: "Anteater.",
+        });
+        await writeEntry(dataDir, {
+            category: "animals",
+            slug: "meerkat",
+            title: "Meerkat",
+            content: "Social.",
+        });
+        const entries = await listEntries(dataDir, "animals");
+        expect(entries.map((e) => e.title)).toEqual([
+            "Aardvark",
+            "Meerkat",
+            "Zebra",
+        ]);
+    });
+    it("excludes INDEX.md from results", async () => {
+        await writeEntry(dataDir, {
+            category: "test-cat",
+            slug: "entry",
+            title: "Entry",
+            content: "Content.",
+        });
+        await generateIndex(dataDir, "test-cat");
+        const entries = await listEntries(dataDir, "test-cat");
+        expect(entries).toHaveLength(1);
+        expect(entries[0].slug).toBe("entry");
+    });
+});
+// ---------------------------------------------------------------------------
+// listCategories
+// ---------------------------------------------------------------------------
+describe("listCategories", () => {
+    it("returns categories with entry counts", async () => {
+        await writeEntry(dataDir, {
+            category: "alpha",
+            slug: "a1",
+            title: "A1",
+            content: ".",
+        });
+        await writeEntry(dataDir, {
+            category: "alpha",
+            slug: "a2",
+            title: "A2",
+            content: ".",
+        });
+        await writeEntry(dataDir, {
+            category: "beta",
+            slug: "b1",
+            title: "B1",
+            content: ".",
+        });
+        const categories = await listCategories(dataDir);
+        expect(categories).toEqual([
+            { name: "alpha", entryCount: 2 },
+            { name: "beta", entryCount: 1 },
+        ]);
+    });
+    it("includes nested categories", async () => {
+        await writeEntry(dataDir, {
+            category: "social-media/instagram",
+            slug: "reels",
+            title: "Reels",
+            content: "Short video.",
+        });
+        const categories = await listCategories(dataDir);
+        expect(categories).toEqual([
+            { name: "social-media/instagram", entryCount: 1 },
+        ]);
+    });
+});
+// ---------------------------------------------------------------------------
+// createCategory
+// ---------------------------------------------------------------------------
+describe("createCategory", () => {
+    it("creates the directory", async () => {
+        await createCategory(dataDir, "new-category");
+        const { readdir } = await import("node:fs/promises");
+        const entries = await readdir(join(dataDir, "new-category"));
+        expect(entries).toEqual([]);
+    });
+    it("supports nested paths", async () => {
+        await createCategory(dataDir, "parent/child/grandchild");
+        const { stat } = await import("node:fs/promises");
+        const info = await stat(join(dataDir, "parent/child/grandchild"));
+        expect(info.isDirectory()).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// generateIndex
+// ---------------------------------------------------------------------------
+describe("generateIndex", () => {
+    it("generates an INDEX.md with entry titles and dates", async () => {
+        await writeEntry(dataDir, {
+            category: "cooking",
+            slug: "pasta",
+            title: "Pasta Recipe",
+            content: "Boil water.",
+        });
+        await writeEntry(dataDir, {
+            category: "cooking",
+            slug: "salad",
+            title: "Salad Recipe",
+            content: "Chop greens.",
+        });
+        const content = await generateIndex(dataDir, "cooking");
+        expect(content).toContain("# cooking");
+        expect(content).toContain("## Entries");
+        expect(content).toContain("| [Pasta Recipe](pasta.md)");
+        expect(content).toContain("| [Salad Recipe](salad.md)");
+        expect(content).toContain("Title");
+        expect(content).toContain("Updated");
+        // Verify it was written to disk
+        const onDisk = await readFile(join(dataDir, "cooking", "INDEX.md"), "utf-8");
+        expect(onDisk).toBe(content);
+    });
+    it("lists subcategories when present", async () => {
+        await writeEntry(dataDir, {
+            category: "social-media",
+            slug: "overview",
+            title: "Overview",
+            content: "Platforms.",
+        });
+        await createCategory(dataDir, "social-media/instagram");
+        await createCategory(dataDir, "social-media/twitter");
+        const content = await generateIndex(dataDir, "social-media");
+        expect(content).toContain("## Subcategories");
+        expect(content).toContain("[instagram/](instagram/INDEX.md)");
+        expect(content).toContain("[twitter/](twitter/INDEX.md)");
+    });
+});
+// ---------------------------------------------------------------------------
+// generateIndexRecursive
+// ---------------------------------------------------------------------------
+describe("generateIndexRecursive", () => {
+    it("generates INDEX.md files for nested categories", async () => {
+        await writeEntry(dataDir, {
+            category: "social-media",
+            slug: "overview",
+            title: "Social Media Overview",
+            content: "Many platforms.",
+        });
+        await writeEntry(dataDir, {
+            category: "social-media/instagram",
+            slug: "reels",
+            title: "Instagram Reels",
+            content: "Short video format.",
+        });
+        await writeEntry(dataDir, {
+            category: "social-media/instagram",
+            slug: "stories",
+            title: "Instagram Stories",
+            content: "24-hour content.",
+        });
+        await generateIndexRecursive(dataDir, "social-media");
+        // Parent index
+        const parentIndex = await readFile(join(dataDir, "social-media", "INDEX.md"), "utf-8");
+        expect(parentIndex).toContain("# social-media");
+        expect(parentIndex).toContain("[instagram/](instagram/INDEX.md)");
+        expect(parentIndex).toContain("[Social Media Overview](overview.md)");
+        // Child index
+        const childIndex = await readFile(join(dataDir, "social-media", "instagram", "INDEX.md"), "utf-8");
+        expect(childIndex).toContain("# social-media/instagram");
+        expect(childIndex).toContain("[Instagram Reels](reels.md)");
+        expect(childIndex).toContain("[Instagram Stories](stories.md)");
+    });
+});
+//# sourceMappingURL=knowledge-tree.test.js.map

package/dist/knowledge-tree/__tests__/knowledge-tree.test.js.map

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

package/dist/knowledge-tree/format.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Markdown + YAML frontmatter serialization / deserialization.
+ */
+import type { KnowledgeFrontmatter } from "./types.js";
+/** Serialize frontmatter + content into a markdown string. */
+export declare function serialize(frontmatter: KnowledgeFrontmatter, content: string): string;
+/** Parse a markdown string into frontmatter + content. */
+export declare function deserialize(raw: string): {
+    frontmatter: KnowledgeFrontmatter;
+    content: string;
+};
+/**
+ * Convert an arbitrary string into a filesystem-safe slug.
+ * Lowercases, replaces non-alphanumeric runs with hyphens, trims hyphens.
+ */
+export declare function slugify(input: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/knowledge-tree/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/knowledge-tree/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,8DAA8D;AAC9D,wBAAgB,SAAS,CACvB,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CA8BA;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C"}

package/dist/knowledge-tree/format.js

@@ -0,0 +1,48 @@
+/**
+ * Markdown + YAML frontmatter serialization / deserialization.
+ */
+import { stringify as yamlStringify, parse as yamlParse } from "yaml";
+const FRONTMATTER_FENCE = "---";
+/** Serialize frontmatter + content into a markdown string. */
+export function serialize(frontmatter, content) {
+    const yaml = yamlStringify(frontmatter).trimEnd();
+    const body = content.endsWith("\n") ? content : content + "\n";
+    return `${FRONTMATTER_FENCE}\n${yaml}\n${FRONTMATTER_FENCE}\n\n${body}`;
+}
+/** Parse a markdown string into frontmatter + content. */
+export function deserialize(raw) {
+    const lines = raw.split("\n");
+    if (lines[0]?.trim() !== FRONTMATTER_FENCE) {
+        throw new Error("Missing opening frontmatter fence (---)");
+    }
+    let closingIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === FRONTMATTER_FENCE) {
+            closingIndex = i;
+            break;
+        }
+    }
+    if (closingIndex === -1) {
+        throw new Error("Missing closing frontmatter fence (---)");
+    }
+    const yamlBlock = lines.slice(1, closingIndex).join("\n");
+    const frontmatter = yamlParse(yamlBlock);
+    // Content starts after the closing fence + one blank line
+    let contentStart = closingIndex + 1;
+    if (lines[contentStart]?.trim() === "") {
+        contentStart++;
+    }
+    const content = lines.slice(contentStart).join("\n");
+    return { frontmatter, content };
+}
+/**
+ * Convert an arbitrary string into a filesystem-safe slug.
+ * Lowercases, replaces non-alphanumeric runs with hyphens, trims hyphens.
+ */
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=format.js.map

package/dist/knowledge-tree/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/knowledge-tree/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAGtE,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CACvB,WAAiC,EACjC,OAAe;IAEf,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;IAC/D,OAAO,GAAG,iBAAiB,KAAK,IAAI,KAAK,iBAAiB,OAAO,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,GAAW;IAIrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;YAC3C,YAAY,GAAG,CAAC,CAAC;YACjB,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAyB,CAAC;IAEjE,0DAA0D;IAC1D,IAAI,YAAY,GAAG,YAAY,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,YAAY,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/knowledge-tree/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Knowledge Tree — hierarchical filesystem for YAML-frontmatter markdown entries.
+ *
+ * Stores knowledge as:
+ *   {dataDir}/{category}/{slug}.md
+ *
+ * Each category can optionally contain an auto-generated INDEX.md.
+ * Nested categories (e.g., "social-media/instagram") are supported.
+ */
+import type { KnowledgeEntry, WriteEntryInput, CategoryInfo } from "./types.js";
+export { slugify } from "./format.js";
+export type { KnowledgeEntry, WriteEntryInput, CategoryInfo, KnowledgeFrontmatter, } from "./types.js";
+/** Create the root knowledge directory if it doesn't exist. */
+export declare function initKnowledgeTree(dataDir: string): Promise<void>;
+/** Write (create or update) a knowledge entry. Returns the resolved slug. */
+export declare function writeEntry(dataDir: string, input: WriteEntryInput): Promise<string>;
+/** Read and parse a single knowledge entry. */
+export declare function readEntry(dataDir: string, category: string, slug: string): Promise<KnowledgeEntry>;
+/** Delete a knowledge entry. */
+export declare function removeEntry(dataDir: string, category: string, slug: string): Promise<void>;
+/** List all entries in a category, sorted by title. */
+export declare function listEntries(dataDir: string, category: string): Promise<KnowledgeEntry[]>;
+/** List all category directories (recursively) with entry counts. */
+export declare function listCategories(dataDir: string): Promise<CategoryInfo[]>;
+/** Create a new category directory. */
+export declare function createCategory(dataDir: string, name: string): Promise<void>;
+/** Generate an INDEX.md for a category listing its entries. */
+export declare function generateIndex(dataDir: string, category: string): Promise<string>;
+/**
+ * Recursively generate INDEX.md files for a category and all its subcategories.
+ */
+export declare function generateIndexRecursive(dataDir: string, category: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge-tree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge-tree/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAMpB,+DAA+D;AAC/D,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAMD,6EAA6E;AAC7E,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED,+CAA+C;AAC/C,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,gCAAgC;AAChC,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAGf;AAMD,uDAAuD;AACvD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B;AAED,qEAAqE;AACrE,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAkCD,uCAAuC;AACvC,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAEf;AAMD,+DAA+D;AAC/D,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/knowledge-tree/index.js

@@ -0,0 +1,182 @@
+/**
+ * Knowledge Tree — hierarchical filesystem for YAML-frontmatter markdown entries.
+ *
+ * Stores knowledge as:
+ *   {dataDir}/{category}/{slug}.md
+ *
+ * Each category can optionally contain an auto-generated INDEX.md.
+ * Nested categories (e.g., "social-media/instagram") are supported.
+ */
+import { mkdir, readdir, readFile, writeFile, rm } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { serialize, deserialize, slugify } from "./format.js";
+export { slugify } from "./format.js";
+// ---------------------------------------------------------------------------
+// Init
+// ---------------------------------------------------------------------------
+/** Create the root knowledge directory if it doesn't exist. */
+export async function initKnowledgeTree(dataDir) {
+    await mkdir(dataDir, { recursive: true });
+}
+// ---------------------------------------------------------------------------
+// Write / Read / Remove
+// ---------------------------------------------------------------------------
+/** Write (create or update) a knowledge entry. Returns the resolved slug. */
+export async function writeEntry(dataDir, input) {
+    const entrySlug = input.slug ?? slugify(input.title);
+    const categoryDir = join(dataDir, input.category);
+    await mkdir(categoryDir, { recursive: true });
+    const now = new Date().toISOString();
+    const filePath = join(categoryDir, `${entrySlug}.md`);
+    // Preserve original created date if file already exists
+    let created = now;
+    try {
+        const existing = await readFile(filePath, "utf-8");
+        const parsed = deserialize(existing);
+        created = parsed.frontmatter.created;
+    }
+    catch {
+        // New file — use now
+    }
+    const frontmatter = {
+        title: input.title,
+        tags: input.tags ?? [],
+        ...(input.source != null ? { source: input.source } : {}),
+        created,
+        updated: now,
+    };
+    const markdown = serialize(frontmatter, input.content);
+    await writeFile(filePath, markdown, "utf-8");
+    return entrySlug;
+}
+/** Read and parse a single knowledge entry. */
+export async function readEntry(dataDir, category, slug) {
+    const filePath = join(dataDir, category, `${slug}.md`);
+    const raw = await readFile(filePath, "utf-8");
+    const { frontmatter, content } = deserialize(raw);
+    return {
+        category,
+        slug,
+        title: frontmatter.title,
+        tags: frontmatter.tags ?? [],
+        source: frontmatter.source,
+        created: frontmatter.created,
+        updated: frontmatter.updated,
+        content,
+    };
+}
+/** Delete a knowledge entry. */
+export async function removeEntry(dataDir, category, slug) {
+    const filePath = join(dataDir, category, `${slug}.md`);
+    await rm(filePath);
+}
+// ---------------------------------------------------------------------------
+// List
+// ---------------------------------------------------------------------------
+/** List all entries in a category, sorted by title. */
+export async function listEntries(dataDir, category) {
+    const categoryDir = join(dataDir, category);
+    const files = await readdir(categoryDir);
+    const mdFiles = files.filter((f) => f.endsWith(".md") && f !== "INDEX.md");
+    const entries = [];
+    for (const file of mdFiles) {
+        const slug = file.replace(/\.md$/, "");
+        const entry = await readEntry(dataDir, category, slug);
+        entries.push(entry);
+    }
+    return entries.sort((a, b) => a.title.localeCompare(b.title));
+}
+/** List all category directories (recursively) with entry counts. */
+export async function listCategories(dataDir) {
+    const results = [];
+    await walkCategories(dataDir, dataDir, results);
+    return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function walkCategories(rootDir, currentDir, results) {
+    let entries;
+    try {
+        entries = await readdir(currentDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const mdFiles = entries.filter((e) => e.isFile() && e.name.endsWith(".md") && e.name !== "INDEX.md");
+    const subdirs = entries.filter((e) => e.isDirectory());
+    // Only include this directory as a category if it has .md files
+    if (mdFiles.length > 0) {
+        const categoryName = relative(rootDir, currentDir).split(sep).join("/");
+        results.push({ name: categoryName, entryCount: mdFiles.length });
+    }
+    for (const dir of subdirs) {
+        await walkCategories(rootDir, join(currentDir, dir.name), results);
+    }
+}
+// ---------------------------------------------------------------------------
+// Category management
+// ---------------------------------------------------------------------------
+/** Create a new category directory. */
+export async function createCategory(dataDir, name) {
+    await mkdir(join(dataDir, name), { recursive: true });
+}
+// ---------------------------------------------------------------------------
+// Index generation
+// ---------------------------------------------------------------------------
+/** Generate an INDEX.md for a category listing its entries. */
+export async function generateIndex(dataDir, category) {
+    const categoryDir = join(dataDir, category);
+    const entries = await listEntries(dataDir, category);
+    // Check for subcategories
+    const dirEntries = await readdir(categoryDir, { withFileTypes: true });
+    const subdirs = dirEntries.filter((e) => e.isDirectory());
+    const lines = [];
+    lines.push(`# ${category}`);
+    lines.push("");
+    if (subdirs.length > 0) {
+        lines.push("## Subcategories");
+        lines.push("");
+        for (const dir of subdirs.sort((a, b) => a.name.localeCompare(b.name))) {
+            lines.push(`- [${dir.name}/](${dir.name}/INDEX.md)`);
+        }
+        lines.push("");
+    }
+    if (entries.length > 0) {
+        lines.push("## Entries");
+        lines.push("");
+        lines.push("| Title | Updated |");
+        lines.push("|-------|---------|");
+        for (const entry of entries) {
+            const dateStr = entry.updated.slice(0, 10);
+            lines.push(`| [${entry.title}](${entry.slug}.md) | ${dateStr} |`);
+        }
+        lines.push("");
+    }
+    const content = lines.join("\n");
+    await writeFile(join(categoryDir, "INDEX.md"), content, "utf-8");
+    return content;
+}
+/**
+ * Recursively generate INDEX.md files for a category and all its subcategories.
+ */
+export async function generateIndexRecursive(dataDir, category) {
+    const categoryDir = join(dataDir, category);
+    let dirEntries;
+    try {
+        dirEntries = await readdir(categoryDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    // Check if this directory has any .md files or subdirectories worth indexing
+    const hasMdFiles = dirEntries.some((e) => e.isFile() && e.name.endsWith(".md") && e.name !== "INDEX.md");
+    const subdirs = dirEntries.filter((e) => e.isDirectory());
+    // Recurse into subdirectories first
+    for (const dir of subdirs) {
+        const subCategory = category ? `${category}/${dir.name}` : dir.name;
+        await generateIndexRecursive(dataDir, subCategory);
+    }
+    // Generate index if there are entries or subcategories
+    if (hasMdFiles || subdirs.length > 0) {
+        await generateIndex(dataDir, category);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/knowledge-tree/index.js.map

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