@draht/knowledge 2026.7.13

package/README.md

@@ -0,0 +1,32 @@
+# @draht/knowledge
+
+Client knowledge base with vector search for the Draht coding agent.
+
+## Features
+
+- **Vector Store** — Chunk and embed documents for semantic search
+- **Knowledge Manager** — Manage project-specific knowledge bases
+- **Extension** — Registers as a Draht coding agent extension
+- **Client Config** — Per-project knowledge configuration
+
+## Usage
+
+```typescript
+import { KnowledgeManager, VectorStore, knowledgeExtension } from "@draht/knowledge";
+
+// As a coding agent extension
+export default knowledgeExtension;
+
+// Direct usage
+const store = new VectorStore(dbPath);
+const results = await store.search(query, { limit: 5 });
+```
+
+## Exports
+
+| Export | Description |
+|--------|-------------|
+| `KnowledgeManager` | Manages knowledge base lifecycle |
+| `VectorStore` | Vector storage and semantic search |
+| `knowledgeExtension` | Draht coding agent extension |
+| `loadClientConfig` | Load per-project config |

package/dist/client-config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Client configuration and namespace management.
+ * Each client gets an isolated knowledge directory under ~/.draht/knowledge/{slug}/.
+ */
+export interface ClientConfig {
+    slug: string;
+    name: string;
+    agentsMdPath?: string;
+    watchPaths?: string[];
+}
+/**
+ * Load client config from cwd.
+ * Checks .draht/client.json first, then falls back to AGENTS.md extraction.
+ */
+export declare function loadClientConfig(cwd: string): ClientConfig | null;
+/**
+ * Get the knowledge store directory for a client.
+ */
+export declare function getKnowledgePath(slug: string): string;
+/**
+ * Get the database file path for a client's knowledge store.
+ */
+export declare function getKnowledgeDbPath(slug: string): string;
+//# sourceMappingURL=client-config.d.ts.map

package/dist/client-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.d.ts","sourceRoot":"","sources":["../src/client-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgCjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/client-config.js

@@ -0,0 +1,73 @@
+/**
+ * Client configuration and namespace management.
+ * Each client gets an isolated knowledge directory under ~/.draht/knowledge/{slug}/.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+/**
+ * Load client config from cwd.
+ * Checks .draht/client.json first, then falls back to AGENTS.md extraction.
+ */
+export function loadClientConfig(cwd) {
+    // Try .draht/client.json
+    const configPath = path.join(cwd, ".draht", "client.json");
+    if (fs.existsSync(configPath)) {
+        try {
+            const raw = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(raw);
+            if (config.slug && config.name) {
+                return {
+                    slug: config.slug,
+                    name: config.name,
+                    agentsMdPath: config.agentsMdPath ?? findAgentsMd(cwd),
+                    watchPaths: config.watchPaths,
+                };
+            }
+        }
+        catch {
+            // Invalid JSON, fall through
+        }
+    }
+    // Try AGENTS.md extraction
+    const agentsMdPath = findAgentsMd(cwd);
+    if (agentsMdPath) {
+        const slug = slugifyPath(cwd);
+        return {
+            slug,
+            name: path.basename(cwd),
+            agentsMdPath,
+        };
+    }
+    return null;
+}
+/**
+ * Get the knowledge store directory for a client.
+ */
+export function getKnowledgePath(slug) {
+    return path.join(os.homedir(), ".draht", "knowledge", slug);
+}
+/**
+ * Get the database file path for a client's knowledge store.
+ */
+export function getKnowledgeDbPath(slug) {
+    return path.join(getKnowledgePath(slug), "vectors.db");
+}
+function findAgentsMd(cwd) {
+    const candidates = ["AGENTS.md", ".agents/AGENTS.md", "docs/AGENTS.md"];
+    for (const candidate of candidates) {
+        const full = path.join(cwd, candidate);
+        if (fs.existsSync(full))
+            return full;
+    }
+    return undefined;
+}
+function slugifyPath(cwd) {
+    return path
+        .basename(cwd)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+//# sourceMappingURL=client-config.js.map

package/dist/client-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.js","sourceRoot":"","sources":["../src/client-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC3C,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;YACxD,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChC,OAAO;oBACN,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,YAAY,CAAC,GAAG,CAAC;oBACtD,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC7B,CAAC;YACH,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,6BAA6B;QAC9B,CAAC;IACF,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO;YACN,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,YAAY;SACZ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAChC,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;IACxE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC/B,OAAO,IAAI;SACT,QAAQ,CAAC,GAAG,CAAC;SACb,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC","sourcesContent":["/**\n * Client configuration and namespace management.\n * Each client gets an isolated knowledge directory under ~/.draht/knowledge/{slug}/.\n */\n\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\n\nexport interface ClientConfig {\n\tslug: string;\n\tname: string;\n\tagentsMdPath?: string;\n\twatchPaths?: string[];\n}\n\n/**\n * Load client config from cwd.\n * Checks .draht/client.json first, then falls back to AGENTS.md extraction.\n */\nexport function loadClientConfig(cwd: string): ClientConfig | null {\n\t// Try .draht/client.json\n\tconst configPath = path.join(cwd, \".draht\", \"client.json\");\n\tif (fs.existsSync(configPath)) {\n\t\ttry {\n\t\t\tconst raw = fs.readFileSync(configPath, \"utf-8\");\n\t\t\tconst config = JSON.parse(raw) as Partial<ClientConfig>;\n\t\t\tif (config.slug && config.name) {\n\t\t\t\treturn {\n\t\t\t\t\tslug: config.slug,\n\t\t\t\t\tname: config.name,\n\t\t\t\t\tagentsMdPath: config.agentsMdPath ?? findAgentsMd(cwd),\n\t\t\t\t\twatchPaths: config.watchPaths,\n\t\t\t\t};\n\t\t\t}\n\t\t} catch {\n\t\t\t// Invalid JSON, fall through\n\t\t}\n\t}\n\n\t// Try AGENTS.md extraction\n\tconst agentsMdPath = findAgentsMd(cwd);\n\tif (agentsMdPath) {\n\t\tconst slug = slugifyPath(cwd);\n\t\treturn {\n\t\t\tslug,\n\t\t\tname: path.basename(cwd),\n\t\t\tagentsMdPath,\n\t\t};\n\t}\n\n\treturn null;\n}\n\n/**\n * Get the knowledge store directory for a client.\n */\nexport function getKnowledgePath(slug: string): string {\n\treturn path.join(os.homedir(), \".draht\", \"knowledge\", slug);\n}\n\n/**\n * Get the database file path for a client's knowledge store.\n */\nexport function getKnowledgeDbPath(slug: string): string {\n\treturn path.join(getKnowledgePath(slug), \"vectors.db\");\n}\n\nfunction findAgentsMd(cwd: string): string | undefined {\n\tconst candidates = [\"AGENTS.md\", \".agents/AGENTS.md\", \"docs/AGENTS.md\"];\n\tfor (const candidate of candidates) {\n\t\tconst full = path.join(cwd, candidate);\n\t\tif (fs.existsSync(full)) return full;\n\t}\n\treturn undefined;\n}\n\nfunction slugifyPath(cwd: string): string {\n\treturn path\n\t\t.basename(cwd)\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]/g, \"-\")\n\t\t.replace(/-+/g, \"-\")\n\t\t.replace(/^-|-$/g, \"\");\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type ClientConfig, getKnowledgeDbPath, getKnowledgePath, loadClientConfig } from "./client-config.js";
+export { KnowledgeManager, type SearchMode } from "./knowledge-manager.js";
+export { type Chunk, type ChunkMetadata, type ChunkType, type SearchResult, VectorStore } from "./vector-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { getKnowledgeDbPath, getKnowledgePath, loadClientConfig } from "./client-config.js";
+export { KnowledgeManager } from "./knowledge-manager.js";
+export { VectorStore } from "./vector-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAmB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAqE,WAAW,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { type ClientConfig, getKnowledgeDbPath, getKnowledgePath, loadClientConfig } from \"./client-config.js\";\nexport { KnowledgeManager, type SearchMode } from \"./knowledge-manager.js\";\nexport { type Chunk, type ChunkMetadata, type ChunkType, type SearchResult, VectorStore } from \"./vector-store.js\";\n"]}

package/dist/knowledge-manager.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Knowledge manager — high-level API for client knowledge operations.
+ * Wraps VectorStore with chunking, file indexing, and search modes.
+ */
+import { type SearchResult } from "./vector-store.js";
+export type SearchMode = "decide" | "connect" | "fuzzy" | "general";
+export declare class KnowledgeManager {
+    private store;
+    private clientSlug;
+    constructor(clientSlug: string, openaiApiKey?: string);
+    /**
+     * Index a file into the knowledge base.
+     * Chunks by headings/paragraphs, deduplicates via content hash.
+     */
+    indexFile(filePath: string): Promise<number>;
+    /**
+     * Index a directory recursively (markdown files only).
+     */
+    indexDirectory(dirPath: string): Promise<number>;
+    /**
+     * Search knowledge with optional mode for query refinement.
+     */
+    searchKnowledge(query: string, mode?: SearchMode, limit?: number): Promise<SearchResult[]>;
+    /**
+     * Remove all knowledge from a specific source file.
+     */
+    forget(sourceFile: string): Promise<number>;
+    /**
+     * Get knowledge base statistics.
+     */
+    getStats(): {
+        totalChunks: number;
+        sources: string[];
+        clientSlug: string;
+    };
+    close(): void;
+}
+//# sourceMappingURL=knowledge-manager.d.ts.map

package/dist/knowledge-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../src/knowledge-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAkD,KAAK,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAEnH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAS;IAE3B,YAAY,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAOpD;IAED;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAejD;IAED;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBrD;IAED;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,UAAsB,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGrG;IAED;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhD;IAED;;OAEG;IACH,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAGzE;IAED,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/knowledge-manager.js

@@ -0,0 +1,140 @@
+/**
+ * Knowledge manager — high-level API for client knowledge operations.
+ * Wraps VectorStore with chunking, file indexing, and search modes.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getKnowledgeDbPath } from "./client-config.js";
+import { VectorStore } from "./vector-store.js";
+export class KnowledgeManager {
+    constructor(clientSlug, openaiApiKey) {
+        const apiKey = openaiApiKey ?? process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error("OPENAI_API_KEY required for knowledge base embeddings");
+        }
+        this.clientSlug = clientSlug;
+        this.store = new VectorStore(getKnowledgeDbPath(clientSlug), apiKey);
+    }
+    /**
+     * Index a file into the knowledge base.
+     * Chunks by headings/paragraphs, deduplicates via content hash.
+     */
+    async indexFile(filePath) {
+        const absPath = path.resolve(filePath);
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`File not found: ${absPath}`);
+        }
+        const content = fs.readFileSync(absPath, "utf-8");
+        const chunks = chunkContent(content, {
+            source: absPath,
+            client: this.clientSlug,
+            timestamp: Date.now(),
+            type: inferChunkType(absPath),
+        });
+        return this.store.index(chunks);
+    }
+    /**
+     * Index a directory recursively (markdown files only).
+     */
+    async indexDirectory(dirPath) {
+        const absDir = path.resolve(dirPath);
+        if (!fs.existsSync(absDir)) {
+            throw new Error(`Directory not found: ${absDir}`);
+        }
+        let total = 0;
+        const entries = fs.readdirSync(absDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(absDir, entry.name);
+            if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+                total += await this.indexDirectory(full);
+            }
+            else if (entry.isFile() && /\.(md|txt)$/i.test(entry.name)) {
+                total += await this.indexFile(full);
+            }
+        }
+        return total;
+    }
+    /**
+     * Search knowledge with optional mode for query refinement.
+     */
+    async searchKnowledge(query, mode = "general", limit = 5) {
+        const refinedQuery = refineQueryByMode(query, mode);
+        return this.store.search(refinedQuery, limit);
+    }
+    /**
+     * Remove all knowledge from a specific source file.
+     */
+    async forget(sourceFile) {
+        return this.store.delete(path.resolve(sourceFile));
+    }
+    /**
+     * Get knowledge base statistics.
+     */
+    getStats() {
+        const stats = this.store.getStats();
+        return { ...stats, clientSlug: this.clientSlug };
+    }
+    close() {
+        this.store.close();
+    }
+}
+// ============================================================================
+// Chunking
+// ============================================================================
+const MAX_CHUNK_CHARS = 2000; // ~500 tokens
+function chunkContent(content, baseMetadata) {
+    const chunks = [];
+    // Split by markdown headings
+    const sections = content.split(/^(?=#{1,3}\s)/m);
+    for (const section of sections) {
+        const trimmed = section.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.length <= MAX_CHUNK_CHARS) {
+            chunks.push({ content: trimmed, metadata: { ...baseMetadata } });
+        }
+        else {
+            // Split long sections by paragraphs
+            const paragraphs = trimmed.split(/\n\n+/);
+            let current = "";
+            for (const para of paragraphs) {
+                if (current.length + para.length + 2 > MAX_CHUNK_CHARS) {
+                    if (current.trim()) {
+                        chunks.push({ content: current.trim(), metadata: { ...baseMetadata } });
+                    }
+                    current = para;
+                }
+                else {
+                    current = current ? `${current}\n\n${para}` : para;
+                }
+            }
+            if (current.trim()) {
+                chunks.push({ content: current.trim(), metadata: { ...baseMetadata } });
+            }
+        }
+    }
+    return chunks;
+}
+function inferChunkType(filePath) {
+    const basename = path.basename(filePath).toLowerCase();
+    if (basename.includes("agents") || basename.includes("convention"))
+        return "convention";
+    if (basename.includes("decision") || basename.includes("adr"))
+        return "decision";
+    if (basename.includes("pattern"))
+        return "pattern";
+    return "general";
+}
+function refineQueryByMode(query, mode) {
+    switch (mode) {
+        case "decide":
+            return `decisions and choices about: ${query}`;
+        case "connect":
+            return `relationships and connections related to: ${query}`;
+        case "fuzzy":
+            return query; // Use as-is for fuzzy/vague queries
+        default:
+            return query;
+    }
+}
+//# sourceMappingURL=knowledge-manager.js.map

package/dist/knowledge-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.js","sourceRoot":"","sources":["../src/knowledge-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Knowledge manager — high-level API for client knowledge operations.\n * Wraps VectorStore with chunking, file indexing, and search modes.\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getKnowledgeDbPath } from \"./client-config.js\";\nimport { type Chunk, type ChunkMetadata, type ChunkType, type SearchResult, VectorStore } from \"./vector-store.js\";\n\nexport type SearchMode = \"decide\" | \"connect\" | \"fuzzy\" | \"general\";\n\nexport class KnowledgeManager {\n\tprivate store: VectorStore;\n\tprivate clientSlug: string;\n\n\tconstructor(clientSlug: string, openaiApiKey?: string) {\n\t\tconst apiKey = openaiApiKey ?? process.env.OPENAI_API_KEY;\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"OPENAI_API_KEY required for knowledge base embeddings\");\n\t\t}\n\t\tthis.clientSlug = clientSlug;\n\t\tthis.store = new VectorStore(getKnowledgeDbPath(clientSlug), apiKey);\n\t}\n\n\t/**\n\t * Index a file into the knowledge base.\n\t * Chunks by headings/paragraphs, deduplicates via content hash.\n\t */\n\tasync indexFile(filePath: string): Promise<number> {\n\t\tconst absPath = path.resolve(filePath);\n\t\tif (!fs.existsSync(absPath)) {\n\t\t\tthrow new Error(`File not found: ${absPath}`);\n\t\t}\n\n\t\tconst content = fs.readFileSync(absPath, \"utf-8\");\n\t\tconst chunks = chunkContent(content, {\n\t\t\tsource: absPath,\n\t\t\tclient: this.clientSlug,\n\t\t\ttimestamp: Date.now(),\n\t\t\ttype: inferChunkType(absPath),\n\t\t});\n\n\t\treturn this.store.index(chunks);\n\t}\n\n\t/**\n\t * Index a directory recursively (markdown files only).\n\t */\n\tasync indexDirectory(dirPath: string): Promise<number> {\n\t\tconst absDir = path.resolve(dirPath);\n\t\tif (!fs.existsSync(absDir)) {\n\t\t\tthrow new Error(`Directory not found: ${absDir}`);\n\t\t}\n\n\t\tlet total = 0;\n\t\tconst entries = fs.readdirSync(absDir, { withFileTypes: true });\n\t\tfor (const entry of entries) {\n\t\t\tconst full = path.join(absDir, entry.name);\n\t\t\tif (entry.isDirectory() && !entry.name.startsWith(\".\") && entry.name !== \"node_modules\") {\n\t\t\t\ttotal += await this.indexDirectory(full);\n\t\t\t} else if (entry.isFile() && /\\.(md|txt)$/i.test(entry.name)) {\n\t\t\t\ttotal += await this.indexFile(full);\n\t\t\t}\n\t\t}\n\t\treturn total;\n\t}\n\n\t/**\n\t * Search knowledge with optional mode for query refinement.\n\t */\n\tasync searchKnowledge(query: string, mode: SearchMode = \"general\", limit = 5): Promise<SearchResult[]> {\n\t\tconst refinedQuery = refineQueryByMode(query, mode);\n\t\treturn this.store.search(refinedQuery, limit);\n\t}\n\n\t/**\n\t * Remove all knowledge from a specific source file.\n\t */\n\tasync forget(sourceFile: string): Promise<number> {\n\t\treturn this.store.delete(path.resolve(sourceFile));\n\t}\n\n\t/**\n\t * Get knowledge base statistics.\n\t */\n\tgetStats(): { totalChunks: number; sources: string[]; clientSlug: string } {\n\t\tconst stats = this.store.getStats();\n\t\treturn { ...stats, clientSlug: this.clientSlug };\n\t}\n\n\tclose(): void {\n\t\tthis.store.close();\n\t}\n}\n\n// ============================================================================\n// Chunking\n// ============================================================================\n\nconst MAX_CHUNK_CHARS = 2000; // ~500 tokens\n\nfunction chunkContent(content: string, baseMetadata: ChunkMetadata): Chunk[] {\n\tconst chunks: Chunk[] = [];\n\n\t// Split by markdown headings\n\tconst sections = content.split(/^(?=#{1,3}\\s)/m);\n\n\tfor (const section of sections) {\n\t\tconst trimmed = section.trim();\n\t\tif (!trimmed) continue;\n\n\t\tif (trimmed.length <= MAX_CHUNK_CHARS) {\n\t\t\tchunks.push({ content: trimmed, metadata: { ...baseMetadata } });\n\t\t} else {\n\t\t\t// Split long sections by paragraphs\n\t\t\tconst paragraphs = trimmed.split(/\\n\\n+/);\n\t\t\tlet current = \"\";\n\t\t\tfor (const para of paragraphs) {\n\t\t\t\tif (current.length + para.length + 2 > MAX_CHUNK_CHARS) {\n\t\t\t\t\tif (current.trim()) {\n\t\t\t\t\t\tchunks.push({ content: current.trim(), metadata: { ...baseMetadata } });\n\t\t\t\t\t}\n\t\t\t\t\tcurrent = para;\n\t\t\t\t} else {\n\t\t\t\t\tcurrent = current ? `${current}\\n\\n${para}` : para;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (current.trim()) {\n\t\t\t\tchunks.push({ content: current.trim(), metadata: { ...baseMetadata } });\n\t\t\t}\n\t\t}\n\t}\n\n\treturn chunks;\n}\n\nfunction inferChunkType(filePath: string): ChunkType {\n\tconst basename = path.basename(filePath).toLowerCase();\n\tif (basename.includes(\"agents\") || basename.includes(\"convention\")) return \"convention\";\n\tif (basename.includes(\"decision\") || basename.includes(\"adr\")) return \"decision\";\n\tif (basename.includes(\"pattern\")) return \"pattern\";\n\treturn \"general\";\n}\n\nfunction refineQueryByMode(query: string, mode: SearchMode): string {\n\tswitch (mode) {\n\t\tcase \"decide\":\n\t\t\treturn `decisions and choices about: ${query}`;\n\t\tcase \"connect\":\n\t\t\treturn `relationships and connections related to: ${query}`;\n\t\tcase \"fuzzy\":\n\t\t\treturn query; // Use as-is for fuzzy/vague queries\n\t\tdefault:\n\t\t\treturn query;\n\t}\n}\n"]}

package/dist/vector-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Vector store backed by SQLite with OpenAI embeddings.
+ * Provides local-first semantic search per client namespace.
+ */
+export type ChunkType = "decision" | "convention" | "pattern" | "general";
+export interface ChunkMetadata {
+    source: string;
+    client: string;
+    timestamp: number;
+    type: ChunkType;
+}
+export interface Chunk {
+    content: string;
+    metadata: ChunkMetadata;
+}
+export interface SearchResult {
+    content: string;
+    metadata: ChunkMetadata;
+    score: number;
+}
+export declare class VectorStore {
+    private db;
+    private apiKey;
+    constructor(dbPath: string, openaiApiKey: string);
+    private initSchema;
+    index(chunks: Chunk[]): Promise<number>;
+    search(query: string, limit?: number): Promise<SearchResult[]>;
+    delete(sourceFile: string): Promise<number>;
+    getStats(): {
+        totalChunks: number;
+        sources: string[];
+    };
+    close(): void;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../src/vector-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACd;AAwFD,qBAAa,WAAW;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAY/C;IAED,OAAO,CAAC,UAAU;IAkBZ,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoD5C;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0B9D;IAEK,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhD;IAED,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CASrD;IAED,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/vector-store.js

@@ -0,0 +1,184 @@
+/**
+ * Vector store backed by SQLite with OpenAI embeddings.
+ * Provides local-first semantic search per client namespace.
+ */
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import Database from "better-sqlite3";
+// ============================================================================
+// Embedding
+// ============================================================================
+async function getEmbedding(text, apiKey) {
+    const response = await fetch("https://api.openai.com/v1/embeddings", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model: "text-embedding-3-small",
+            input: text,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Embedding API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.data[0].embedding;
+}
+async function getEmbeddingsBatch(texts, apiKey) {
+    if (texts.length === 0)
+        return [];
+    if (texts.length === 1)
+        return [await getEmbedding(texts[0], apiKey)];
+    const response = await fetch("https://api.openai.com/v1/embeddings", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model: "text-embedding-3-small",
+            input: texts,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Embedding API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    // Sort by index to maintain order
+    return data.data.sort((a, b) => a.index - b.index).map((d) => d.embedding);
+}
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+function contentHash(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function embeddingToBuffer(embedding) {
+    const buf = Buffer.alloc(embedding.length * 4);
+    for (let i = 0; i < embedding.length; i++) {
+        buf.writeFloatLE(embedding[i], i * 4);
+    }
+    return buf;
+}
+function bufferToEmbedding(buf) {
+    const result = [];
+    for (let i = 0; i < buf.length; i += 4) {
+        result.push(buf.readFloatLE(i));
+    }
+    return result;
+}
+// ============================================================================
+// VectorStore
+// ============================================================================
+export class VectorStore {
+    constructor(dbPath, openaiApiKey) {
+        this.apiKey = openaiApiKey;
+        // Ensure directory exists
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+			CREATE TABLE IF NOT EXISTS chunks (
+				id INTEGER PRIMARY KEY AUTOINCREMENT,
+				content TEXT NOT NULL,
+				embedding BLOB NOT NULL,
+				source TEXT NOT NULL,
+				client TEXT NOT NULL,
+				timestamp INTEGER NOT NULL,
+				type TEXT NOT NULL DEFAULT 'general',
+				content_hash TEXT NOT NULL UNIQUE
+			);
+			CREATE INDEX IF NOT EXISTS idx_chunks_source ON chunks(source);
+			CREATE INDEX IF NOT EXISTS idx_chunks_client ON chunks(client);
+			CREATE INDEX IF NOT EXISTS idx_chunks_hash ON chunks(content_hash);
+		`);
+    }
+    async index(chunks) {
+        if (chunks.length === 0)
+            return 0;
+        // Filter out duplicates by content hash
+        const existingHashes = new Set();
+        const checkStmt = this.db.prepare("SELECT 1 FROM chunks WHERE content_hash = ?");
+        const newChunks = [];
+        for (const chunk of chunks) {
+            const hash = contentHash(chunk.content);
+            if (existingHashes.has(hash))
+                continue;
+            const exists = checkStmt.get(hash);
+            if (exists) {
+                existingHashes.add(hash);
+                continue;
+            }
+            newChunks.push({ ...chunk, hash });
+            existingHashes.add(hash);
+        }
+        if (newChunks.length === 0)
+            return 0;
+        // Batch embed
+        const embeddings = await getEmbeddingsBatch(newChunks.map((c) => c.content), this.apiKey);
+        // Insert
+        const insertStmt = this.db.prepare("INSERT OR IGNORE INTO chunks (content, embedding, source, client, timestamp, type, content_hash) VALUES (?, ?, ?, ?, ?, ?, ?)");
+        const insertMany = this.db.transaction(() => {
+            let inserted = 0;
+            for (let i = 0; i < newChunks.length; i++) {
+                const chunk = newChunks[i];
+                const result = insertStmt.run(chunk.content, embeddingToBuffer(embeddings[i]), chunk.metadata.source, chunk.metadata.client, chunk.metadata.timestamp, chunk.metadata.type, chunk.hash);
+                if (result.changes > 0)
+                    inserted++;
+            }
+            return inserted;
+        });
+        return insertMany();
+    }
+    async search(query, limit = 5) {
+        const queryEmbedding = await getEmbedding(query, this.apiKey);
+        const rows = this.db
+            .prepare("SELECT content, embedding, source, client, timestamp, type FROM chunks")
+            .all();
+        const scored = rows.map((row) => ({
+            content: row.content,
+            metadata: {
+                source: row.source,
+                client: row.client,
+                timestamp: row.timestamp,
+                type: row.type,
+            },
+            score: cosineSimilarity(queryEmbedding, bufferToEmbedding(row.embedding)),
+        }));
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+    async delete(sourceFile) {
+        const result = this.db.prepare("DELETE FROM chunks WHERE source = ?").run(sourceFile);
+        return result.changes;
+    }
+    getStats() {
+        const count = this.db.prepare("SELECT COUNT(*) as count FROM chunks").get();
+        const sources = this.db.prepare("SELECT DISTINCT source FROM chunks ORDER BY source").all();
+        return {
+            totalChunks: count.count,
+            sources: sources.map((s) => s.source),
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../src/vector-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vector store backed by SQLite with OpenAI embeddings.\n * Provides local-first semantic search per client namespace.\n */\n\nimport { createHash } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport Database from \"better-sqlite3\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type ChunkType = \"decision\" | \"convention\" | \"pattern\" | \"general\";\n\nexport interface ChunkMetadata {\n\tsource: string;\n\tclient: string;\n\ttimestamp: number;\n\ttype: ChunkType;\n}\n\nexport interface Chunk {\n\tcontent: string;\n\tmetadata: ChunkMetadata;\n}\n\nexport interface SearchResult {\n\tcontent: string;\n\tmetadata: ChunkMetadata;\n\tscore: number;\n}\n\n// ============================================================================\n// Embedding\n// ============================================================================\n\nasync function getEmbedding(text: string, apiKey: string): Promise<number[]> {\n\tconst response = await fetch(\"https://api.openai.com/v1/embeddings\", {\n\t\tmethod: \"POST\",\n\t\theaders: {\n\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tmodel: \"text-embedding-3-small\",\n\t\t\tinput: text,\n\t\t}),\n\t});\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Embedding API error: ${response.status} ${response.statusText}`);\n\t}\n\n\tconst data = (await response.json()) as { data: Array<{ embedding: number[] }> };\n\treturn data.data[0].embedding;\n}\n\nasync function getEmbeddingsBatch(texts: string[], apiKey: string): Promise<number[][]> {\n\tif (texts.length === 0) return [];\n\tif (texts.length === 1) return [await getEmbedding(texts[0], apiKey)];\n\n\tconst response = await fetch(\"https://api.openai.com/v1/embeddings\", {\n\t\tmethod: \"POST\",\n\t\theaders: {\n\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tmodel: \"text-embedding-3-small\",\n\t\t\tinput: texts,\n\t\t}),\n\t});\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Embedding API error: ${response.status} ${response.statusText}`);\n\t}\n\n\tconst data = (await response.json()) as { data: Array<{ embedding: number[]; index: number }> };\n\t// Sort by index to maintain order\n\treturn data.data.sort((a, b) => a.index - b.index).map((d) => d.embedding);\n}\n\nfunction cosineSimilarity(a: number[], b: number[]): number {\n\tlet dot = 0;\n\tlet normA = 0;\n\tlet normB = 0;\n\tfor (let i = 0; i < a.length; i++) {\n\t\tdot += a[i] * b[i];\n\t\tnormA += a[i] * a[i];\n\t\tnormB += b[i] * b[i];\n\t}\n\treturn dot / (Math.sqrt(normA) * Math.sqrt(normB));\n}\n\nfunction contentHash(content: string): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\");\n}\n\nfunction embeddingToBuffer(embedding: number[]): Buffer {\n\tconst buf = Buffer.alloc(embedding.length * 4);\n\tfor (let i = 0; i < embedding.length; i++) {\n\t\tbuf.writeFloatLE(embedding[i], i * 4);\n\t}\n\treturn buf;\n}\n\nfunction bufferToEmbedding(buf: Buffer): number[] {\n\tconst result: number[] = [];\n\tfor (let i = 0; i < buf.length; i += 4) {\n\t\tresult.push(buf.readFloatLE(i));\n\t}\n\treturn result;\n}\n\n// ============================================================================\n// VectorStore\n// ============================================================================\n\nexport class VectorStore {\n\tprivate db: Database.Database;\n\tprivate apiKey: string;\n\n\tconstructor(dbPath: string, openaiApiKey: string) {\n\t\tthis.apiKey = openaiApiKey;\n\n\t\t// Ensure directory exists\n\t\tconst dir = path.dirname(dbPath);\n\t\tif (!fs.existsSync(dir)) {\n\t\t\tfs.mkdirSync(dir, { recursive: true });\n\t\t}\n\n\t\tthis.db = new Database(dbPath);\n\t\tthis.db.pragma(\"journal_mode = WAL\");\n\t\tthis.initSchema();\n\t}\n\n\tprivate initSchema(): void {\n\t\tthis.db.exec(`\n\t\t\tCREATE TABLE IF NOT EXISTS chunks (\n\t\t\t\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\t\t\t\tcontent TEXT NOT NULL,\n\t\t\t\tembedding BLOB NOT NULL,\n\t\t\t\tsource TEXT NOT NULL,\n\t\t\t\tclient TEXT NOT NULL,\n\t\t\t\ttimestamp INTEGER NOT NULL,\n\t\t\t\ttype TEXT NOT NULL DEFAULT 'general',\n\t\t\t\tcontent_hash TEXT NOT NULL UNIQUE\n\t\t\t);\n\t\t\tCREATE INDEX IF NOT EXISTS idx_chunks_source ON chunks(source);\n\t\t\tCREATE INDEX IF NOT EXISTS idx_chunks_client ON chunks(client);\n\t\t\tCREATE INDEX IF NOT EXISTS idx_chunks_hash ON chunks(content_hash);\n\t\t`);\n\t}\n\n\tasync index(chunks: Chunk[]): Promise<number> {\n\t\tif (chunks.length === 0) return 0;\n\n\t\t// Filter out duplicates by content hash\n\t\tconst existingHashes = new Set<string>();\n\t\tconst checkStmt = this.db.prepare(\"SELECT 1 FROM chunks WHERE content_hash = ?\");\n\t\tconst newChunks: Array<Chunk & { hash: string }> = [];\n\n\t\tfor (const chunk of chunks) {\n\t\t\tconst hash = contentHash(chunk.content);\n\t\t\tif (existingHashes.has(hash)) continue;\n\t\t\tconst exists = checkStmt.get(hash);\n\t\t\tif (exists) {\n\t\t\t\texistingHashes.add(hash);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tnewChunks.push({ ...chunk, hash });\n\t\t\texistingHashes.add(hash);\n\t\t}\n\n\t\tif (newChunks.length === 0) return 0;\n\n\t\t// Batch embed\n\t\tconst embeddings = await getEmbeddingsBatch(\n\t\t\tnewChunks.map((c) => c.content),\n\t\t\tthis.apiKey,\n\t\t);\n\n\t\t// Insert\n\t\tconst insertStmt = this.db.prepare(\n\t\t\t\"INSERT OR IGNORE INTO chunks (content, embedding, source, client, timestamp, type, content_hash) VALUES (?, ?, ?, ?, ?, ?, ?)\",\n\t\t);\n\n\t\tconst insertMany = this.db.transaction(() => {\n\t\t\tlet inserted = 0;\n\t\t\tfor (let i = 0; i < newChunks.length; i++) {\n\t\t\t\tconst chunk = newChunks[i];\n\t\t\t\tconst result = insertStmt.run(\n\t\t\t\t\tchunk.content,\n\t\t\t\t\tembeddingToBuffer(embeddings[i]),\n\t\t\t\t\tchunk.metadata.source,\n\t\t\t\t\tchunk.metadata.client,\n\t\t\t\t\tchunk.metadata.timestamp,\n\t\t\t\t\tchunk.metadata.type,\n\t\t\t\t\tchunk.hash,\n\t\t\t\t);\n\t\t\t\tif (result.changes > 0) inserted++;\n\t\t\t}\n\t\t\treturn inserted;\n\t\t});\n\n\t\treturn insertMany();\n\t}\n\n\tasync search(query: string, limit = 5): Promise<SearchResult[]> {\n\t\tconst queryEmbedding = await getEmbedding(query, this.apiKey);\n\t\tconst rows = this.db\n\t\t\t.prepare(\"SELECT content, embedding, source, client, timestamp, type FROM chunks\")\n\t\t\t.all() as Array<{\n\t\t\tcontent: string;\n\t\t\tembedding: Buffer;\n\t\t\tsource: string;\n\t\t\tclient: string;\n\t\t\ttimestamp: number;\n\t\t\ttype: ChunkType;\n\t\t}>;\n\n\t\tconst scored = rows.map((row) => ({\n\t\t\tcontent: row.content,\n\t\t\tmetadata: {\n\t\t\t\tsource: row.source,\n\t\t\t\tclient: row.client,\n\t\t\t\ttimestamp: row.timestamp,\n\t\t\t\ttype: row.type,\n\t\t\t},\n\t\t\tscore: cosineSimilarity(queryEmbedding, bufferToEmbedding(row.embedding)),\n\t\t}));\n\n\t\tscored.sort((a, b) => b.score - a.score);\n\t\treturn scored.slice(0, limit);\n\t}\n\n\tasync delete(sourceFile: string): Promise<number> {\n\t\tconst result = this.db.prepare(\"DELETE FROM chunks WHERE source = ?\").run(sourceFile);\n\t\treturn result.changes;\n\t}\n\n\tgetStats(): { totalChunks: number; sources: string[] } {\n\t\tconst count = this.db.prepare(\"SELECT COUNT(*) as count FROM chunks\").get() as { count: number };\n\t\tconst sources = this.db.prepare(\"SELECT DISTINCT source FROM chunks ORDER BY source\").all() as Array<{\n\t\t\tsource: string;\n\t\t}>;\n\t\treturn {\n\t\t\ttotalChunks: count.count,\n\t\t\tsources: sources.map((s) => s.source),\n\t\t};\n\t}\n\n\tclose(): void {\n\t\tthis.db.close();\n\t}\n}\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "@draht/knowledge",
+	"version": "2026.7.13",
+	"description": "Client knowledge base — per-client vector DB for knowledge persistence across projects",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./extension": {
+			"types": "./src/extension.ts",
+			"import": "./src/extension.ts"
+		}
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"test": "vitest run",
+		"clean": "rm -rf dist"
+	},
+	"dependencies": {
+		"better-sqlite3": "^11.7.0"
+	},
+	"devDependencies": {
+		"vitest": "^3.2.4",
+		"@draht/coding-agent": "2026.7.13",
+		"@types/better-sqlite3": "^7.6.12",
+		"@types/node": "^22.10.5",
+		"typescript": "7.0.2"
+	}
+}