@sourcepress/knowledge 0.1.0

package/dist/__tests__/json-file-store.test.js

@@ -0,0 +1,180 @@
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { JsonFileStore } from "../json-file-store.js";
+function makeKnowledgeFile(overrides = {}) {
+    return {
+        path: "knowledge/clients/acme.md",
+        type: "project-notes",
+        quality: "structured",
+        quality_score: 8,
+        entities: [
+            { type: "client", name: "Acme Corp" },
+            { type: "technology", name: "Next.js" },
+        ],
+        ingested_at: "2026-04-04T10:00:00Z",
+        source: "manual",
+        body: "Meeting with Acme Corp about Next.js migration.",
+        ...overrides,
+    };
+}
+function makeGraph() {
+    return {
+        entities: new Map([
+            [
+                "acme-corp",
+                {
+                    type: "client",
+                    name: "Acme Corp",
+                    aliases: ["Acme"],
+                    confidence: 0.95,
+                    source_file: "knowledge/clients/acme.md",
+                },
+            ],
+        ]),
+        relations: [
+            {
+                from_entity: "acme-corp",
+                to_entity: "nextjs",
+                relation_type: "uses",
+                confidence: 0.9,
+                evidence: "Migration project",
+                source_file: "knowledge/clients/acme.md",
+            },
+        ],
+        clusters: [],
+        built_at: "2026-04-04T12:00:00Z",
+        file_count: 1,
+    };
+}
+let testDir;
+describe("JsonFileStore", () => {
+    beforeEach(() => {
+        testDir = join(tmpdir(), `sourcepress-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true });
+        }
+    });
+    it("creates the directory if it does not exist", () => {
+        new JsonFileStore(testDir);
+        expect(existsSync(testDir)).toBe(true);
+    });
+    describe("store and retrieve", () => {
+        it("stores and retrieves a knowledge file", async () => {
+            const store = new JsonFileStore(testDir);
+            const file = makeKnowledgeFile();
+            await store.store(file);
+            const retrieved = await store.retrieve(file.path);
+            expect(retrieved).toEqual(file);
+        });
+        it("returns null for non-existent file", async () => {
+            const store = new JsonFileStore(testDir);
+            const retrieved = await store.retrieve("nonexistent.md");
+            expect(retrieved).toBeNull();
+        });
+        it("overwrites existing file at same path", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile());
+            await store.store(makeKnowledgeFile({ quality_score: 9 }));
+            const retrieved = await store.retrieve("knowledge/clients/acme.md");
+            expect(retrieved?.quality_score).toBe(9);
+        });
+    });
+    describe("persistence across instances", () => {
+        it("persists knowledge files to disk", async () => {
+            const store1 = new JsonFileStore(testDir);
+            await store1.store(makeKnowledgeFile({ path: "a.md" }));
+            await store1.store(makeKnowledgeFile({ path: "b.md" }));
+            const store2 = new JsonFileStore(testDir);
+            expect(await store2.count()).toBe(2);
+            expect(await store2.retrieve("a.md")).not.toBeNull();
+        });
+        it("persists graph to disk", async () => {
+            const store1 = new JsonFileStore(testDir);
+            const graph = makeGraph();
+            await store1.saveGraph(graph);
+            const store2 = new JsonFileStore(testDir);
+            const loaded = await store2.loadGraph();
+            expect(loaded).not.toBeNull();
+            expect(loaded?.entities.get("acme-corp")?.name).toBe("Acme Corp");
+            expect(loaded?.relations).toHaveLength(1);
+            expect(loaded?.built_at).toBe("2026-04-04T12:00:00Z");
+        });
+    });
+    describe("list", () => {
+        it("lists all stored files", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile({ path: "a.md" }));
+            await store.store(makeKnowledgeFile({ path: "b.md" }));
+            const files = await store.list();
+            expect(files).toHaveLength(2);
+        });
+        it("filters by type", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile({ path: "a.md", type: "project-notes" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", type: "transcript" }));
+            const files = await store.list({ type: "transcript" });
+            expect(files).toHaveLength(1);
+            expect(files[0].type).toBe("transcript");
+        });
+        it("filters by quality", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile({ path: "a.md", quality: "structured" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", quality: "draft" }));
+            const files = await store.list({ quality: "draft" });
+            expect(files).toHaveLength(1);
+        });
+        it("filters by source", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile({ path: "a.md", source: "manual" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", source: "url" }));
+            const files = await store.list({ source: "url" });
+            expect(files).toHaveLength(1);
+        });
+    });
+    describe("delete", () => {
+        it("deletes an existing file and persists", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile());
+            const deleted = await store.delete("knowledge/clients/acme.md");
+            expect(deleted).toBe(true);
+            const store2 = new JsonFileStore(testDir);
+            expect(await store2.retrieve("knowledge/clients/acme.md")).toBeNull();
+        });
+        it("returns false for non-existent file", async () => {
+            const store = new JsonFileStore(testDir);
+            expect(await store.delete("nonexistent.md")).toBe(false);
+        });
+    });
+    describe("count", () => {
+        it("returns 0 for empty store", async () => {
+            const store = new JsonFileStore(testDir);
+            expect(await store.count()).toBe(0);
+        });
+        it("returns correct count", async () => {
+            const store = new JsonFileStore(testDir);
+            await store.store(makeKnowledgeFile({ path: "a.md" }));
+            await store.store(makeKnowledgeFile({ path: "b.md" }));
+            expect(await store.count()).toBe(2);
+        });
+    });
+    describe("graph", () => {
+        it("returns null when no graph saved", async () => {
+            const store = new JsonFileStore(testDir);
+            expect(await store.loadGraph()).toBeNull();
+        });
+        it("preserves Map structure through serialization", async () => {
+            const store = new JsonFileStore(testDir);
+            const graph = makeGraph();
+            await store.saveGraph(graph);
+            const store2 = new JsonFileStore(testDir);
+            const loaded = await store2.loadGraph();
+            expect(loaded?.entities).toBeInstanceOf(Map);
+            expect(loaded?.entities.size).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=json-file-store.test.js.map

package/dist/__tests__/json-file-store.test.js.map

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

package/dist/__tests__/knowledge-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledge-engine.test.d.ts.map

package/dist/__tests__/knowledge-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-engine.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/knowledge-engine.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,152 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { KnowledgeEngine } from "../knowledge-engine.js";
+import { InMemoryKnowledgeStore } from "../knowledge-store.js";
+vi.mock("@sourcepress/ai", async () => {
+    const actual = await vi.importActual("@sourcepress/ai");
+    return { ...actual, classify: vi.fn(), extract: vi.fn() };
+});
+import { classify, extract } from "@sourcepress/ai";
+const mockProvider = {
+    provider: "anthropic",
+    model: "claude-sonnet-4-5-20250514",
+};
+function makeMockBudget() {
+    return {
+        record: vi.fn(),
+        getStatus: vi.fn().mockReturnValue({
+            spent_today_usd: 0,
+            limit_usd: 5,
+            warn_at_usd: 3,
+            remaining_usd: 5,
+            is_over_limit: false,
+            is_warned: false,
+            reset_at: new Date().toISOString(),
+        }),
+        canSpend: vi.fn().mockReturnValue(true),
+        getHistory: vi.fn().mockReturnValue([]),
+        resetDaily: vi.fn(),
+    };
+}
+const mockUsage = {
+    input_tokens: 500,
+    output_tokens: 100,
+    estimated_cost_usd: 0.01,
+    function_name: "test",
+    timestamp: new Date().toISOString(),
+};
+describe("KnowledgeEngine", () => {
+    let engine;
+    let store;
+    let budget;
+    beforeEach(() => {
+        store = new InMemoryKnowledgeStore();
+        budget = makeMockBudget();
+        engine = new KnowledgeEngine(store, mockProvider, budget);
+        vi.clearAllMocks();
+    });
+    describe("ingest", () => {
+        it("classifies, extracts, and stores a knowledge file", async () => {
+            vi.mocked(classify).mockResolvedValueOnce({
+                quality: "structured",
+                quality_score: 8,
+                type: "project-notes",
+                reasoning: "Well structured",
+                usage: mockUsage,
+            });
+            vi.mocked(extract).mockResolvedValueOnce({
+                entities: [{ type: "client", name: "Acme Corp", aliases: ["Acme"], confidence: 0.95 }],
+                relations: [
+                    {
+                        from_entity: "Acme Corp",
+                        to_entity: "Next.js",
+                        relation_type: "uses",
+                        confidence: 0.9,
+                        evidence: "Acme uses Next.js",
+                    },
+                ],
+                usage: mockUsage,
+            });
+            const result = await engine.ingest("knowledge/clients/acme.md", "Meeting with Acme Corp about their Next.js migration.", "manual");
+            expect(result.path).toBe("knowledge/clients/acme.md");
+            expect(result.quality).toBe("structured");
+            expect(result.quality_score).toBe(8);
+            expect(result.entities).toHaveLength(1);
+            const stored = await store.retrieve("knowledge/clients/acme.md");
+            expect(stored).not.toBeNull();
+            // biome-ignore lint/style/noNonNullAssertion: asserted not null on line above
+            expect(stored.quality).toBe("structured");
+        });
+    });
+    describe("buildGraph", () => {
+        it("builds graph from all stored knowledge files", async () => {
+            await store.store({
+                path: "knowledge/a.md",
+                type: "notes",
+                quality: "structured",
+                quality_score: 8,
+                entities: [{ type: "client", name: "Acme Corp" }],
+                ingested_at: new Date().toISOString(),
+                source: "manual",
+                body: "Acme meeting notes",
+            });
+            vi.mocked(extract).mockResolvedValueOnce({
+                entities: [{ type: "client", name: "Acme Corp", aliases: ["Acme"], confidence: 0.95 }],
+                relations: [],
+                usage: mockUsage,
+            });
+            const graph = await engine.buildGraph();
+            expect(graph.entities.size).toBeGreaterThanOrEqual(1);
+            expect(graph.built_at).toBeTruthy();
+        });
+    });
+    describe("query", () => {
+        it("queries the graph for an entity", async () => {
+            await store.store({
+                path: "knowledge/a.md",
+                type: "notes",
+                quality: "structured",
+                quality_score: 8,
+                entities: [{ type: "client", name: "Acme Corp" }],
+                ingested_at: new Date().toISOString(),
+                source: "manual",
+                body: "Acme notes",
+            });
+            vi.mocked(extract).mockResolvedValueOnce({
+                entities: [{ type: "client", name: "Acme Corp", aliases: ["Acme"], confidence: 0.95 }],
+                relations: [],
+                usage: mockUsage,
+            });
+            await engine.buildGraph();
+            const result = engine.query("Acme Corp");
+            expect(result).not.toBeNull();
+            // biome-ignore lint/style/noNonNullAssertion: asserted not null on line above
+            expect(result.entity.name).toBe("Acme Corp");
+        });
+        it("returns null before graph is built", () => {
+            expect(engine.query("Anything")).toBeNull();
+        });
+    });
+    describe("findGaps", () => {
+        it("delegates gap detection to graph ops", async () => {
+            await store.store({
+                path: "knowledge/a.md",
+                type: "notes",
+                quality: "structured",
+                quality_score: 8,
+                entities: [{ type: "client", name: "Acme Corp" }],
+                ingested_at: new Date().toISOString(),
+                source: "manual",
+                body: "Acme notes",
+            });
+            vi.mocked(extract).mockResolvedValueOnce({
+                entities: [{ type: "client", name: "Acme Corp", aliases: [], confidence: 0.95 }],
+                relations: [],
+                usage: mockUsage,
+            });
+            await engine.buildGraph();
+            const gaps = engine.findGaps([]);
+            expect(gaps.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+});
+//# sourceMappingURL=knowledge-engine.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-engine.test.js","sourceRoot":"","sources":["../../src/__tests__/knowledge-engine.test.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;IACrC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACxD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,YAAY,GAAqB;IACtC,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,4BAA4B;CACnC,CAAC;AAEF,SAAS,cAAc;IACtB,OAAO;QACN,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;YAClC,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAClC,CAAC;QACF,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;QACvC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;QACvC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;KACS,CAAC;AAC/B,CAAC;AAED,MAAM,SAAS,GAAG;IACjB,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,MAAM;IACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;CACnC,CAAC;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,IAAI,MAAuB,CAAC;IAC5B,IAAI,KAA6B,CAAC;IAClC,IAAI,MAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACf,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACrC,MAAM,GAAG,cAAc,EAAE,CAAC;QAC1B,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YAClE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC;gBACzC,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,CAAC;gBAChB,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,iBAAiB;gBAC5B,KAAK,EAAE,SAAS;aAChB,CAAC,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC;gBACxC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACtF,SAAS,EAAE;oBACV;wBACC,WAAW,EAAE,WAAW;wBACxB,SAAS,EAAE,SAAS;wBACpB,aAAa,EAAE,MAAM;wBACrB,UAAU,EAAE,GAAG;wBACf,QAAQ,EAAE,mBAAmB;qBAC7B;iBACD;gBACD,KAAK,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CACjC,2BAA2B,EAC3B,uDAAuD,EACvD,QAAQ,CACR,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,8EAA8E;YAC9E,MAAM,CAAC,MAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,KAAK,CAAC,KAAK,CAAC;gBACjB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,CAAC;gBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACjD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,oBAAoB;aAC1B,CAAC,CAAC;YAEH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC;gBACxC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACtF,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,KAAK,CAAC,KAAK,CAAC;gBACjB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,CAAC;gBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACjD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,YAAY;aAClB,CAAC,CAAC;YAEH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC;gBACxC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACtF,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,8EAA8E;YAC9E,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,KAAK,CAAC,KAAK,CAAC;gBACjB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,CAAC;gBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACjD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,YAAY;aAClB,CAAC,CAAC;YAEH,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC;gBACxC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBAChF,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/__tests__/knowledge-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledge-store.test.d.ts.map

package/dist/__tests__/knowledge-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-store.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/knowledge-store.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,97 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { InMemoryKnowledgeStore } from "../knowledge-store.js";
+function makeKnowledgeFile(overrides = {}) {
+    return {
+        path: "knowledge/clients/acme.md",
+        type: "project-notes",
+        quality: "structured",
+        quality_score: 8,
+        entities: [
+            { type: "client", name: "Acme Corp" },
+            { type: "technology", name: "Next.js" },
+        ],
+        ingested_at: "2026-04-04T10:00:00Z",
+        source: "manual",
+        body: "Meeting with Acme Corp about Next.js migration.",
+        ...overrides,
+    };
+}
+describe("InMemoryKnowledgeStore", () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryKnowledgeStore();
+    });
+    describe("store and retrieve", () => {
+        it("stores and retrieves a knowledge file", async () => {
+            const file = makeKnowledgeFile();
+            await store.store(file);
+            const retrieved = await store.retrieve(file.path);
+            expect(retrieved).toEqual(file);
+        });
+        it("returns null for non-existent file", async () => {
+            const retrieved = await store.retrieve("nonexistent.md");
+            expect(retrieved).toBeNull();
+        });
+        it("overwrites existing file at same path", async () => {
+            const file = makeKnowledgeFile();
+            await store.store(file);
+            const updated = makeKnowledgeFile({ quality_score: 9 });
+            await store.store(updated);
+            const retrieved = await store.retrieve(file.path);
+            expect(retrieved?.quality_score).toBe(9);
+        });
+    });
+    describe("list", () => {
+        it("lists all stored files", async () => {
+            await store.store(makeKnowledgeFile({ path: "knowledge/a.md" }));
+            await store.store(makeKnowledgeFile({ path: "knowledge/b.md" }));
+            const files = await store.list();
+            expect(files).toHaveLength(2);
+        });
+        it("filters by type", async () => {
+            await store.store(makeKnowledgeFile({ path: "a.md", type: "project-notes" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", type: "transcript" }));
+            const files = await store.list({ type: "transcript" });
+            expect(files).toHaveLength(1);
+            expect(files[0].type).toBe("transcript");
+        });
+        it("filters by quality", async () => {
+            await store.store(makeKnowledgeFile({ path: "a.md", quality: "structured" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", quality: "draft" }));
+            const files = await store.list({ quality: "draft" });
+            expect(files).toHaveLength(1);
+            expect(files[0].quality).toBe("draft");
+        });
+        it("filters by source", async () => {
+            await store.store(makeKnowledgeFile({ path: "a.md", source: "manual" }));
+            await store.store(makeKnowledgeFile({ path: "b.md", source: "url" }));
+            const files = await store.list({ source: "url" });
+            expect(files).toHaveLength(1);
+            expect(files[0].source).toBe("url");
+        });
+    });
+    describe("delete", () => {
+        it("deletes an existing file", async () => {
+            await store.store(makeKnowledgeFile());
+            const deleted = await store.delete("knowledge/clients/acme.md");
+            expect(deleted).toBe(true);
+            const retrieved = await store.retrieve("knowledge/clients/acme.md");
+            expect(retrieved).toBeNull();
+        });
+        it("returns false for non-existent file", async () => {
+            const deleted = await store.delete("nonexistent.md");
+            expect(deleted).toBe(false);
+        });
+    });
+    describe("count", () => {
+        it("returns 0 for empty store", async () => {
+            expect(await store.count()).toBe(0);
+        });
+        it("returns correct count", async () => {
+            await store.store(makeKnowledgeFile({ path: "a.md" }));
+            await store.store(makeKnowledgeFile({ path: "b.md" }));
+            expect(await store.count()).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=knowledge-store.test.js.map

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

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

package/dist/__tests__/scraper.test.d.ts

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

package/dist/__tests__/scraper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraper.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scraper.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scraper.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it, vi } from "vitest";
+import { Scraper } from "../ingestion/scraper.js";
+const SAMPLE_HTML = `
+<!DOCTYPE html>
+<html>
+<head><title>Test Article</title></head>
+<body>
+  <header><nav>Skip me</nav></header>
+  <article>
+    <h1>Test Article Title</h1>
+    <p>This is the first paragraph with <strong>bold text</strong> and a
+    <a href="https://example.com">link</a>.</p>
+    <h2>Section Two</h2>
+    <p>Another paragraph with <em>italic</em> content. It has enough text to
+    be considered readable content by the Readability algorithm, which typically
+    requires a minimum amount of textual content to determine that an element
+    contains the main article body rather than boilerplate navigation.</p>
+    <ul>
+      <li>Item one</li>
+      <li>Item two</li>
+    </ul>
+    <p>Final paragraph to ensure sufficient content length for the readability
+    parser to properly identify the main content area of this test page.</p>
+  </article>
+  <footer>Footer stuff</footer>
+</body>
+</html>`;
+function mockFetcher(html, status = 200) {
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        statusText: status === 200 ? "OK" : "Not Found",
+        text: () => Promise.resolve(html),
+    });
+}
+describe("Scraper", () => {
+    it("scrapes a URL and returns readable content", async () => {
+        const fetcher = mockFetcher(SAMPLE_HTML);
+        const scraper = new Scraper(fetcher);
+        const result = await scraper.scrape("https://example.com/article");
+        expect(fetcher).toHaveBeenCalledWith("https://example.com/article", undefined);
+        expect(result.url).toBe("https://example.com/article");
+        expect(result.title).toContain("Test Article");
+        expect(result.content).toContain("first paragraph");
+        expect(result.markdown).toContain("**bold text**");
+        expect(result.length).toBeGreaterThan(0);
+        expect(result.scraped_at).toBeTruthy();
+    });
+    it("throws on HTTP error", async () => {
+        const fetcher = mockFetcher("", 404);
+        const scraper = new Scraper(fetcher);
+        await expect(scraper.scrape("https://example.com/missing")).rejects.toThrow("404");
+    });
+    it("throws when no readable content found", async () => {
+        const fetcher = mockFetcher("<html><body><nav>Just navigation</nav></body></html>");
+        const scraper = new Scraper(fetcher);
+        await expect(scraper.scrape("https://example.com/empty")).rejects.toThrow("No readable content");
+    });
+    it("extracts markdown from HTML directly", () => {
+        const scraper = new Scraper(mockFetcher(""));
+        const result = scraper.extractFromHtml("https://example.com", SAMPLE_HTML);
+        expect(result.markdown).toContain("[link](https://example.com)");
+        expect(result.markdown).toContain("- Item one");
+    });
+});
+//# sourceMappingURL=scraper.test.js.map

package/dist/__tests__/scraper.test.js.map

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

package/dist/__tests__/sitemap-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sitemap-parser.test.d.ts.map

package/dist/__tests__/sitemap-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sitemap-parser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sitemap-parser.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it, vi } from "vitest";
+import { SitemapParser } from "../ingestion/sitemap-parser.js";
+const SAMPLE_SITEMAP = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url><loc>https://example.com/</loc></url>
+  <url><loc>https://example.com/blog/post-1</loc></url>
+  <url><loc>https://example.com/blog/post-2</loc></url>
+  <url><loc>https://example.com/services/web</loc></url>
+  <url><loc>https://example.com/services/mobile</loc></url>
+  <url><loc>https://example.com/services/cloud</loc></url>
+  <url><loc>https://example.com/cases/acme</loc></url>
+  <url><loc>https://example.com/about</loc></url>
+</urlset>`;
+function mockFetcher(xml, status = 200) {
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        statusText: "OK",
+        text: () => Promise.resolve(xml),
+    });
+}
+describe("SitemapParser", () => {
+    it("parses a sitemap and groups URLs by section", async () => {
+        const parser = new SitemapParser(mockFetcher(SAMPLE_SITEMAP));
+        const result = await parser.parse("https://example.com/sitemap.xml");
+        expect(result.total_urls).toBe(8);
+        expect(result.sections.length).toBeGreaterThanOrEqual(3);
+        const services = result.sections.find((s) => s.pattern === "/services/*");
+        expect(services).toBeDefined();
+        expect(services?.count).toBe(3);
+        const blog = result.sections.find((s) => s.pattern === "/blog/*");
+        expect(blog).toBeDefined();
+        expect(blog?.count).toBe(2);
+    });
+    it("throws on HTTP error", async () => {
+        const parser = new SitemapParser(mockFetcher("", 404));
+        await expect(parser.parse("https://example.com/sitemap.xml")).rejects.toThrow("404");
+    });
+    it("throws when no URLs found", async () => {
+        const parser = new SitemapParser(mockFetcher("<urlset></urlset>"));
+        await expect(parser.parse("https://example.com/sitemap.xml")).rejects.toThrow("No URLs found");
+    });
+    it("filters URLs by include patterns", async () => {
+        const parser = new SitemapParser(mockFetcher(SAMPLE_SITEMAP));
+        const result = await parser.parse("https://example.com/sitemap.xml");
+        const filtered = parser.filterUrls(result, {
+            sitemap_url: "https://example.com/sitemap.xml",
+            include: ["/services/*"],
+        });
+        expect(filtered).toHaveLength(3);
+        expect(filtered.every((u) => u.includes("/services/"))).toBe(true);
+    });
+    it("filters URLs by exclude patterns", async () => {
+        const parser = new SitemapParser(mockFetcher(SAMPLE_SITEMAP));
+        const result = await parser.parse("https://example.com/sitemap.xml");
+        const filtered = parser.filterUrls(result, {
+            sitemap_url: "https://example.com/sitemap.xml",
+            exclude: ["/blog/*"],
+        });
+        expect(filtered.some((u) => u.includes("/blog/"))).toBe(false);
+        expect(filtered.length).toBe(6); // 8 total - 2 blog
+    });
+    it("combines include and exclude", async () => {
+        const parser = new SitemapParser(mockFetcher(SAMPLE_SITEMAP));
+        const result = await parser.parse("https://example.com/sitemap.xml");
+        const filtered = parser.filterUrls(result, {
+            sitemap_url: "https://example.com/sitemap.xml",
+            include: ["/services/*", "/blog/*"],
+            exclude: ["/blog/*"],
+        });
+        expect(filtered).toHaveLength(3);
+        expect(filtered.every((u) => u.includes("/services/"))).toBe(true);
+    });
+});
+//# sourceMappingURL=sitemap-parser.test.js.map