@ai-devkit/memory 0.1.0

package/README.md

@@ -0,0 +1,149 @@
+# @ai-devkit/memory
+
+A lightweight MCP-based memory service for AI agents. Store and retrieve actionable knowledge using SQLite with FTS5 full-text search.
+
+## Features
+
+- 🔍 **Full-Text Search** - FTS5 with BM25 ranking
+- 🏷️ **Tag-Based Filtering** - Boost results by contextTags
+- 📁 **Scoped Knowledge** - global, project, or repo-specific rules
+- 🔄 **Deduplication** - Prevents duplicate content
+- ⚡ **Fast** - SQLite with WAL mode, <50ms search latency
+- 📦 **Portable** - Single database file, no external dependencies
+
+## Installation
+
+```bash
+npm install @ai-devkit/memory
+```
+
+## Quick Start
+
+### As MCP Server
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "memory": {
+      "command": "npx",
+      "args": ["@ai-devkit/memory"]
+    }
+  }
+}
+```
+
+### Using the Tools
+
+#### Store Knowledge
+
+```json
+{
+  "tool": "memory.storeKnowledge",
+  "arguments": {
+    "title": "Always use Response DTOs for API endpoints",
+    "content": "When building REST APIs, always use Response DTOs instead of returning domain entities directly. This provides better API versioning, security, and decoupling.",
+    "tags": ["api", "backend", "dto"],
+    "scope": "global"
+  }
+}
+```
+
+#### Search Knowledge
+
+```json
+{
+  "tool": "memory.searchKnowledge",
+  "arguments": {
+    "query": "building an API endpoint",
+    "contextTags": ["api"],
+    "limit": 5
+  }
+}
+```
+
+### CLI Commands
+
+You can also use the CLI directly:
+
+```bash
+# Store knowledge
+ai-devkit-memory store \
+  -t "Always use Response DTOs for API endpoints" \
+  -c "When building REST APIs, always use Response DTOs..." \
+  --tags "api,backend,dto" \
+  -s global
+
+# Search knowledge
+ai-devkit-memory search -q "API best practices" --tags "api" -l 5
+
+# Start MCP server (default)
+ai-devkit-memory serve
+# or just:
+ai-devkit-memory
+```
+
+## API Reference
+
+### `memory.storeKnowledge`
+
+Store a new knowledge item.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `title` | string | ✅ | Short description (10-100 chars) |
+| `content` | string | ✅ | Detailed explanation in markdown (50-5000 chars) |
+| `tags` | string[] | ❌ | Domain keywords (max 10) |
+| `scope` | string | ❌ | `global`, `project:<name>`, or `repo:<name>` |
+
+### `memory.searchKnowledge`
+
+Search for relevant knowledge.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | ✅ | Natural language task description (3-500 chars) |
+| `contextTags` | string[] | ❌ | Tags to boost matching results |
+| `scope` | string | ❌ | Scope filter (project results prioritized) |
+| `limit` | number | ❌ | Max results (1-20, default: 5) |
+
+## Ranking Algorithm
+
+Results are ranked using:
+
+```
+final_score = bm25_score × tag_boost + scope_boost
+
+Where:
+  bm25_score  = FTS5 bm25() with column weights (title=10, content=5, tags=1)
+  tag_boost   = 1 + (matching_tags × 0.1)
+  scope_boost = +0.5 if scope matches, +0.2 if global
+```
+
+## Database Location
+
+Default: `~/.ai-devkit/memory.db`
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run with MCP Inspector
+npm run inspect
+
+# Start server
+npm run start
+```
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,20 @@
+import { storeKnowledge } from './handlers/store';
+import { searchKnowledge } from './handlers/search';
+import type { StoreKnowledgeInput, SearchKnowledgeInput, StoreKnowledgeResult, SearchKnowledgeResult } from './types';
+export { storeKnowledge, searchKnowledge };
+export type { StoreKnowledgeInput, SearchKnowledgeInput, StoreKnowledgeResult, SearchKnowledgeResult };
+export interface MemoryStoreOptions {
+    title: string;
+    content: string;
+    tags?: string;
+    scope?: string;
+}
+export interface MemorySearchOptions {
+    query: string;
+    tags?: string;
+    scope?: string;
+    limit?: number;
+}
+export declare function memoryStoreCommand(options: MemoryStoreOptions): StoreKnowledgeResult;
+export declare function memorySearchCommand(options: MemorySearchOptions): SearchKnowledgeResult;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEtH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC;AAGvG,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,CASpF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,qBAAqB,CASvF"}

package/dist/api.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get memorySearchCommand () {
+        return memorySearchCommand;
+    },
+    get memoryStoreCommand () {
+        return memoryStoreCommand;
+    },
+    get searchKnowledge () {
+        return _search.searchKnowledge;
+    },
+    get storeKnowledge () {
+        return _store.storeKnowledge;
+    }
+});
+const _store = require("./handlers/store");
+const _search = require("./handlers/search");
+function memoryStoreCommand(options) {
+    const input = {
+        title: options.title,
+        content: options.content,
+        tags: options.tags ? options.tags.split(',').map((t)=>t.trim()) : undefined,
+        scope: options.scope
+    };
+    return (0, _store.storeKnowledge)(input);
+}
+function memorySearchCommand(options) {
+    const input = {
+        query: options.query,
+        contextTags: options.tags ? options.tags.split(',').map((t)=>t.trim()) : undefined,
+        scope: options.scope,
+        limit: options.limit
+    };
+    return (0, _search.searchKnowledge)(input);
+}
+
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.ts"],"sourcesContent":["import { storeKnowledge } from './handlers/store';\nimport { searchKnowledge } from './handlers/search';\nimport type { StoreKnowledgeInput, SearchKnowledgeInput, StoreKnowledgeResult, SearchKnowledgeResult } from './types';\n\nexport { storeKnowledge, searchKnowledge };\nexport type { StoreKnowledgeInput, SearchKnowledgeInput, StoreKnowledgeResult, SearchKnowledgeResult };\n\n// CLI command handlers for integration with main ai-devkit CLI\nexport interface MemoryStoreOptions {\n    title: string;\n    content: string;\n    tags?: string;\n    scope?: string;\n}\n\nexport interface MemorySearchOptions {\n    query: string;\n    tags?: string;\n    scope?: string;\n    limit?: number;\n}\n\nexport function memoryStoreCommand(options: MemoryStoreOptions): StoreKnowledgeResult {\n    const input: StoreKnowledgeInput = {\n        title: options.title,\n        content: options.content,\n        tags: options.tags ? options.tags.split(',').map(t => t.trim()) : undefined,\n        scope: options.scope,\n    };\n\n    return storeKnowledge(input);\n}\n\nexport function memorySearchCommand(options: MemorySearchOptions): SearchKnowledgeResult {\n    const input: SearchKnowledgeInput = {\n        query: options.query,\n        contextTags: options.tags ? options.tags.split(',').map(t => t.trim()) : undefined,\n        scope: options.scope,\n        limit: options.limit,\n    };\n\n    return searchKnowledge(input);\n}\n"],"names":["memorySearchCommand","memoryStoreCommand","searchKnowledge","storeKnowledge","options","input","title","content","tags","split","map","t","trim","undefined","scope","query","contextTags","limit"],"mappings":";;;;;;;;;;;QAiCgBA;eAAAA;;QAXAC;eAAAA;;QAlBSC;eAAAA,uBAAe;;QAA/BC;eAAAA,qBAAc;;;uBAJQ;wBACC;AAqBzB,SAASF,mBAAmBG,OAA2B;IAC1D,MAAMC,QAA6B;QAC/BC,OAAOF,QAAQE,KAAK;QACpBC,SAASH,QAAQG,OAAO;QACxBC,MAAMJ,QAAQI,IAAI,GAAGJ,QAAQI,IAAI,CAACC,KAAK,CAAC,KAAKC,GAAG,CAACC,CAAAA,IAAKA,EAAEC,IAAI,MAAMC;QAClEC,OAAOV,QAAQU,KAAK;IACxB;IAEA,OAAOX,IAAAA,qBAAc,EAACE;AAC1B;AAEO,SAASL,oBAAoBI,OAA4B;IAC5D,MAAMC,QAA8B;QAChCU,OAAOX,QAAQW,KAAK;QACpBC,aAAaZ,QAAQI,IAAI,GAAGJ,QAAQI,IAAI,CAACC,KAAK,CAAC,KAAKC,GAAG,CAACC,CAAAA,IAAKA,EAAEC,IAAI,MAAMC;QACzEC,OAAOV,QAAQU,KAAK;QACpBG,OAAOb,QAAQa,KAAK;IACxB;IAEA,OAAOf,IAAAA,uBAAe,EAACG;AAC3B"}

package/dist/database/connection.d.ts

@@ -0,0 +1,27 @@
+import Database from 'better-sqlite3';
+/**
+ * Default database path: ~/.ai-devkit/memory.db
+ */
+export declare const DEFAULT_DB_PATH: string;
+export interface DatabaseOptions {
+    dbPath?: string;
+    verbose?: boolean;
+    readonly?: boolean;
+}
+export declare class DatabaseConnection {
+    private db;
+    private readonly dbPath;
+    constructor(options?: DatabaseOptions);
+    private configure;
+    get instance(): Database.Database;
+    get path(): string;
+    get isOpen(): boolean;
+    query<T>(sql: string, params?: unknown[]): T[];
+    queryOne<T>(sql: string, params?: unknown[]): T | undefined;
+    execute(sql: string, params?: unknown[]): Database.RunResult;
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+export declare function getDatabase(options?: DatabaseOptions): DatabaseConnection;
+export declare function closeDatabase(): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/database/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/database/connection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC;;GAEG;AACH,eAAO,MAAM,eAAe,QAA6C,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,eAAoB;IAczC,OAAO,CAAC,SAAS;IAQjB,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAEhC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,CAAC,EAAE;IAIlD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,CAAC,GAAG,SAAS;IAI/D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,QAAQ,CAAC,SAAS;IAGhE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B,KAAK,IAAI,IAAI;CAKhB;AAKD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,kBAAkB,CAczE;AAED,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/database/connection.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DEFAULT_DB_PATH () {
+        return DEFAULT_DB_PATH;
+    },
+    get DatabaseConnection () {
+        return DatabaseConnection;
+    },
+    get closeDatabase () {
+        return closeDatabase;
+    },
+    get getDatabase () {
+        return getDatabase;
+    }
+});
+const _bettersqlite3 = /*#__PURE__*/ _interop_require_default(require("better-sqlite3"));
+const _fs = require("fs");
+const _path = require("path");
+const _os = require("os");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const DEFAULT_DB_PATH = (0, _path.join)((0, _os.homedir)(), '.ai-devkit', 'memory.db');
+let DatabaseConnection = class DatabaseConnection {
+    db;
+    dbPath;
+    constructor(options = {}){
+        this.dbPath = options.dbPath ?? DEFAULT_DB_PATH;
+        const dir = (0, _path.dirname)(this.dbPath);
+        (0, _fs.mkdirSync)(dir, {
+            recursive: true
+        });
+        this.db = new _bettersqlite3.default(this.dbPath, {
+            readonly: options.readonly ?? false,
+            verbose: options.verbose ? console.log : undefined
+        });
+        this.configure();
+    }
+    configure() {
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('busy_timeout = 5000');
+        this.db.pragma('mmap_size = 268435456');
+    }
+    get instance() {
+        return this.db;
+    }
+    get path() {
+        return this.dbPath;
+    }
+    get isOpen() {
+        return this.db.open;
+    }
+    query(sql, params = []) {
+        return this.db.prepare(sql).all(...params);
+    }
+    queryOne(sql, params = []) {
+        return this.db.prepare(sql).get(...params);
+    }
+    execute(sql, params = []) {
+        return this.db.prepare(sql).run(...params);
+    }
+    transaction(fn) {
+        return this.db.transaction(fn)();
+    }
+    close() {
+        if (this.db.open) {
+            this.db.close();
+        }
+    }
+};
+let instance = null;
+let schemaInitialized = false;
+function getDatabase(options) {
+    if (!instance) {
+        instance = new DatabaseConnection(options);
+    }
+    // Auto-run migrations on first access
+    if (!schemaInitialized) {
+        // Lazy import to avoid circular dependency
+        const { initializeSchema } = require('./schema');
+        initializeSchema(instance);
+        schemaInitialized = true;
+    }
+    return instance;
+}
+function closeDatabase() {
+    if (instance) {
+        instance.close();
+        instance = null;
+        schemaInitialized = false;
+    }
+}
+
+//# sourceMappingURL=connection.js.map

package/dist/database/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/database/connection.ts"],"sourcesContent":["import Database from 'better-sqlite3';\nimport { mkdirSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { homedir } from 'os';\n\n/**\n * Default database path: ~/.ai-devkit/memory.db\n */\nexport const DEFAULT_DB_PATH = join(homedir(), '.ai-devkit', 'memory.db');\n\nexport interface DatabaseOptions {\n    dbPath?: string;\n    verbose?: boolean;\n    readonly?: boolean;\n}\n\nexport class DatabaseConnection {\n    private db: Database.Database;\n    private readonly dbPath: string;\n\n    constructor(options: DatabaseOptions = {}) {\n        this.dbPath = options.dbPath ?? DEFAULT_DB_PATH;\n\n        const dir = dirname(this.dbPath);\n        mkdirSync(dir, { recursive: true });\n\n        this.db = new Database(this.dbPath, {\n            readonly: options.readonly ?? false,\n            verbose: options.verbose ? console.log : undefined,\n        });\n\n        this.configure();\n    }\n\n    private configure(): void {\n        this.db.pragma('journal_mode = WAL');\n        this.db.pragma('foreign_keys = ON');\n        this.db.pragma('synchronous = NORMAL');\n        this.db.pragma('busy_timeout = 5000');\n        this.db.pragma('mmap_size = 268435456');\n    }\n\n    get instance(): Database.Database {\n        return this.db;\n    }\n\n    get path(): string {\n        return this.dbPath;\n    }\n\n    get isOpen(): boolean {\n        return this.db.open;\n    }\n\n    query<T>(sql: string, params: unknown[] = []): T[] {\n        return this.db.prepare(sql).all(...params) as T[];\n    }\n\n    queryOne<T>(sql: string, params: unknown[] = []): T | undefined {\n        return this.db.prepare(sql).get(...params) as T | undefined;\n    }\n\n    execute(sql: string, params: unknown[] = []): Database.RunResult {\n        return this.db.prepare(sql).run(...params);\n    }\n    transaction<T>(fn: () => T): T {\n        return this.db.transaction(fn)();\n    }\n\n    close(): void {\n        if (this.db.open) {\n            this.db.close();\n        }\n    }\n}\n\nlet instance: DatabaseConnection | null = null;\nlet schemaInitialized = false;\n\nexport function getDatabase(options?: DatabaseOptions): DatabaseConnection {\n    if (!instance) {\n        instance = new DatabaseConnection(options);\n    }\n\n    // Auto-run migrations on first access\n    if (!schemaInitialized) {\n        // Lazy import to avoid circular dependency\n        const { initializeSchema } = require('./schema');\n        initializeSchema(instance);\n        schemaInitialized = true;\n    }\n\n    return instance;\n}\n\nexport function closeDatabase(): void {\n    if (instance) {\n        instance.close();\n        instance = null;\n        schemaInitialized = false;\n    }\n}"],"names":["DEFAULT_DB_PATH","DatabaseConnection","closeDatabase","getDatabase","join","homedir","db","dbPath","options","dir","dirname","mkdirSync","recursive","Database","readonly","verbose","console","log","undefined","configure","pragma","instance","path","isOpen","open","query","sql","params","prepare","all","queryOne","get","execute","run","transaction","fn","close","schemaInitialized","initializeSchema","require"],"mappings":";;;;;;;;;;;QAQaA;eAAAA;;QAQAC;eAAAA;;QA+EGC;eAAAA;;QAhBAC;eAAAA;;;sEA/EK;oBACK;sBACI;oBACN;;;;;;AAKjB,MAAMH,kBAAkBI,IAAAA,UAAI,EAACC,IAAAA,WAAO,KAAI,cAAc;AAQtD,IAAA,AAAMJ,qBAAN,MAAMA;IACDK,GAAsB;IACbC,OAAe;IAEhC,YAAYC,UAA2B,CAAC,CAAC,CAAE;QACvC,IAAI,CAACD,MAAM,GAAGC,QAAQD,MAAM,IAAIP;QAEhC,MAAMS,MAAMC,IAAAA,aAAO,EAAC,IAAI,CAACH,MAAM;QAC/BI,IAAAA,aAAS,EAACF,KAAK;YAAEG,WAAW;QAAK;QAEjC,IAAI,CAACN,EAAE,GAAG,IAAIO,sBAAQ,CAAC,IAAI,CAACN,MAAM,EAAE;YAChCO,UAAUN,QAAQM,QAAQ,IAAI;YAC9BC,SAASP,QAAQO,OAAO,GAAGC,QAAQC,GAAG,GAAGC;QAC7C;QAEA,IAAI,CAACC,SAAS;IAClB;IAEQA,YAAkB;QACtB,IAAI,CAACb,EAAE,CAACc,MAAM,CAAC;QACf,IAAI,CAACd,EAAE,CAACc,MAAM,CAAC;QACf,IAAI,CAACd,EAAE,CAACc,MAAM,CAAC;QACf,IAAI,CAACd,EAAE,CAACc,MAAM,CAAC;QACf,IAAI,CAACd,EAAE,CAACc,MAAM,CAAC;IACnB;IAEA,IAAIC,WAA8B;QAC9B,OAAO,IAAI,CAACf,EAAE;IAClB;IAEA,IAAIgB,OAAe;QACf,OAAO,IAAI,CAACf,MAAM;IACtB;IAEA,IAAIgB,SAAkB;QAClB,OAAO,IAAI,CAACjB,EAAE,CAACkB,IAAI;IACvB;IAEAC,MAASC,GAAW,EAAEC,SAAoB,EAAE,EAAO;QAC/C,OAAO,IAAI,CAACrB,EAAE,CAACsB,OAAO,CAACF,KAAKG,GAAG,IAAIF;IACvC;IAEAG,SAAYJ,GAAW,EAAEC,SAAoB,EAAE,EAAiB;QAC5D,OAAO,IAAI,CAACrB,EAAE,CAACsB,OAAO,CAACF,KAAKK,GAAG,IAAIJ;IACvC;IAEAK,QAAQN,GAAW,EAAEC,SAAoB,EAAE,EAAsB;QAC7D,OAAO,IAAI,CAACrB,EAAE,CAACsB,OAAO,CAACF,KAAKO,GAAG,IAAIN;IACvC;IACAO,YAAeC,EAAW,EAAK;QAC3B,OAAO,IAAI,CAAC7B,EAAE,CAAC4B,WAAW,CAACC;IAC/B;IAEAC,QAAc;QACV,IAAI,IAAI,CAAC9B,EAAE,CAACkB,IAAI,EAAE;YACd,IAAI,CAAClB,EAAE,CAAC8B,KAAK;QACjB;IACJ;AACJ;AAEA,IAAIf,WAAsC;AAC1C,IAAIgB,oBAAoB;AAEjB,SAASlC,YAAYK,OAAyB;IACjD,IAAI,CAACa,UAAU;QACXA,WAAW,IAAIpB,mBAAmBO;IACtC;IAEA,sCAAsC;IACtC,IAAI,CAAC6B,mBAAmB;QACpB,2CAA2C;QAC3C,MAAM,EAAEC,gBAAgB,EAAE,GAAGC,QAAQ;QACrCD,iBAAiBjB;QACjBgB,oBAAoB;IACxB;IAEA,OAAOhB;AACX;AAEO,SAASnB;IACZ,IAAImB,UAAU;QACVA,SAASe,KAAK;QACdf,WAAW;QACXgB,oBAAoB;IACxB;AACJ"}

package/dist/database/index.d.ts

@@ -0,0 +1,4 @@
+export { DatabaseConnection, getDatabase, closeDatabase, DEFAULT_DB_PATH } from './connection';
+export type { DatabaseOptions } from './connection';
+export { initializeSchema, getSchemaVersion, resetSchema } from './schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/F,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DEFAULT_DB_PATH () {
+        return _connection.DEFAULT_DB_PATH;
+    },
+    get DatabaseConnection () {
+        return _connection.DatabaseConnection;
+    },
+    get closeDatabase () {
+        return _connection.closeDatabase;
+    },
+    get getDatabase () {
+        return _connection.getDatabase;
+    },
+    get getSchemaVersion () {
+        return _schema.getSchemaVersion;
+    },
+    get initializeSchema () {
+        return _schema.initializeSchema;
+    },
+    get resetSchema () {
+        return _schema.resetSchema;
+    }
+});
+const _connection = require("./connection");
+const _schema = require("./schema");
+
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/database/index.ts"],"sourcesContent":["export { DatabaseConnection, getDatabase, closeDatabase, DEFAULT_DB_PATH } from './connection';\nexport type { DatabaseOptions } from './connection';\nexport { initializeSchema, getSchemaVersion, resetSchema } from './schema';\n"],"names":["DEFAULT_DB_PATH","DatabaseConnection","closeDatabase","getDatabase","getSchemaVersion","initializeSchema","resetSchema"],"mappings":";;;;;;;;;;;QAAyDA;eAAAA,2BAAe;;QAA/DC;eAAAA,8BAAkB;;QAAeC;eAAAA,yBAAa;;QAA1BC;eAAAA,uBAAW;;QAEbC;eAAAA,wBAAgB;;QAAlCC;eAAAA,wBAAgB;;QAAoBC;eAAAA,mBAAW;;;4BAFwB;wBAEhB"}

package/dist/database/migrations/001_initial.sql

@@ -0,0 +1,50 @@
+-- Migration 001: Initial schema
+-- Creates the core knowledge table and FTS5 index
+
+-- Main knowledge table (simplified: 9 fields)
+CREATE TABLE IF NOT EXISTS knowledge (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL CHECK (length(title) <= 100),
+  content TEXT NOT NULL CHECK (length(content) <= 5000),
+  tags TEXT NOT NULL DEFAULT '[]',
+  scope TEXT NOT NULL DEFAULT 'global',
+  normalized_title TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  
+  UNIQUE (normalized_title, scope),
+  UNIQUE (content_hash, scope)
+);
+
+-- FTS5 virtual table for full-text search
+-- Column weights for bm25(): title=10, content=5, tags=1
+CREATE VIRTUAL TABLE IF NOT EXISTS knowledge_fts USING fts5(
+  title,
+  content,
+  tags,
+  content='knowledge',
+  content_rowid='rowid',
+  tokenize='porter unicode61'
+);
+
+-- Triggers to keep FTS in sync
+CREATE TRIGGER IF NOT EXISTS knowledge_ai AFTER INSERT ON knowledge BEGIN
+  INSERT INTO knowledge_fts(rowid, title, content, tags)
+  VALUES (NEW.rowid, NEW.title, NEW.content, NEW.tags);
+END;
+
+CREATE TRIGGER IF NOT EXISTS knowledge_ad AFTER DELETE ON knowledge BEGIN
+  INSERT INTO knowledge_fts(knowledge_fts, rowid, title, content, tags)
+  VALUES ('delete', OLD.rowid, OLD.title, OLD.content, OLD.tags);
+END;
+
+CREATE TRIGGER IF NOT EXISTS knowledge_au AFTER UPDATE ON knowledge BEGIN
+  INSERT INTO knowledge_fts(knowledge_fts, rowid, title, content, tags)
+  VALUES ('delete', OLD.rowid, OLD.title, OLD.content, OLD.tags);
+  INSERT INTO knowledge_fts(rowid, title, content, tags)
+  VALUES (NEW.rowid, NEW.title, NEW.content, NEW.tags);
+END;
+
+-- Index for fast scope filtering
+CREATE INDEX IF NOT EXISTS idx_knowledge_scope ON knowledge(scope);

package/dist/database/schema.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseConnection } from './connection';
+export declare function getSchemaVersion(db: DatabaseConnection): number;
+export declare function initializeSchema(db: DatabaseConnection): void;
+export declare function resetSchema(db: DatabaseConnection): void;
+export declare function getPendingMigrations(db: DatabaseConnection): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/database/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,GAAG,MAAM,CAG/D;AAsCD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAkB7D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAQxD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAMrE"}

package/dist/database/schema.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get getPendingMigrations () {
+        return getPendingMigrations;
+    },
+    get getSchemaVersion () {
+        return getSchemaVersion;
+    },
+    get initializeSchema () {
+        return initializeSchema;
+    },
+    get resetSchema () {
+        return resetSchema;
+    }
+});
+const _fs = require("fs");
+const _path = require("path");
+function getSchemaVersion(db) {
+    const result = db.instance.pragma('user_version');
+    return result[0]?.user_version ?? 0;
+}
+function setSchemaVersion(db, version) {
+    db.instance.pragma(`user_version = ${version}`);
+}
+function getMigrationsDir() {
+    // In production, migrations are in dist/database/migrations
+    // In development/testing, they are in src/database/migrations
+    const distPath = (0, _path.join)(__dirname, 'migrations');
+    return distPath;
+}
+function getMigrationFiles() {
+    const migrationsDir = getMigrationsDir();
+    let files;
+    try {
+        files = (0, _fs.readdirSync)(migrationsDir).filter((f)=>f.endsWith('.sql')).sort();
+    } catch  {
+        return [];
+    }
+    return files.map((file)=>{
+        const match = file.match(/^(\d+)_(.+)\.sql$/);
+        if (!match || !match[1] || !match[2]) {
+            throw new Error(`Invalid migration filename: ${file}. Expected format: 001_name.sql`);
+        }
+        return {
+            version: parseInt(match[1], 10),
+            name: match[2],
+            path: (0, _path.join)(migrationsDir, file)
+        };
+    });
+}
+function initializeSchema(db) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = getMigrationFiles();
+    const pendingMigrations = migrations.filter((m)=>m.version > currentVersion);
+    if (pendingMigrations.length === 0) {
+        return;
+    }
+    for (const migration of pendingMigrations){
+        const sql = (0, _fs.readFileSync)(migration.path, 'utf-8');
+        db.transaction(()=>{
+            db.instance.exec(sql);
+            setSchemaVersion(db, migration.version);
+        });
+    }
+}
+function resetSchema(db) {
+    db.transaction(()=>{
+        db.execute('DROP TABLE IF EXISTS knowledge_fts');
+        db.execute('DROP TABLE IF EXISTS knowledge');
+        setSchemaVersion(db, 0);
+    });
+    initializeSchema(db);
+}
+function getPendingMigrations(db) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = getMigrationFiles();
+    return migrations.filter((m)=>m.version > currentVersion).map((m)=>`${m.version}_${m.name}`);
+}
+
+//# sourceMappingURL=schema.js.map

package/dist/database/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/database/schema.ts"],"sourcesContent":["import { readFileSync, readdirSync } from 'fs';\nimport { join } from 'path';\nimport type { DatabaseConnection } from './connection';\n\nexport function getSchemaVersion(db: DatabaseConnection): number {\n    const result = db.instance.pragma('user_version') as { user_version: number }[];\n    return result[0]?.user_version ?? 0;\n}\n\nfunction setSchemaVersion(db: DatabaseConnection, version: number): void {\n    db.instance.pragma(`user_version = ${version}`);\n}\n\nfunction getMigrationsDir(): string {\n    // In production, migrations are in dist/database/migrations\n    // In development/testing, they are in src/database/migrations\n    const distPath = join(__dirname, 'migrations');\n    return distPath;\n}\n\nfunction getMigrationFiles(): { version: number; path: string; name: string }[] {\n    const migrationsDir = getMigrationsDir();\n\n    let files: string[];\n    try {\n        files = readdirSync(migrationsDir)\n            .filter(f => f.endsWith('.sql'))\n            .sort();\n    } catch {\n        return [];\n    }\n\n    return files.map(file => {\n        const match = file.match(/^(\\d+)_(.+)\\.sql$/);\n        if (!match || !match[1] || !match[2]) {\n            throw new Error(`Invalid migration filename: ${file}. Expected format: 001_name.sql`);\n        }\n        return {\n            version: parseInt(match[1], 10),\n            name: match[2],\n            path: join(migrationsDir, file),\n        };\n    });\n}\n\nexport function initializeSchema(db: DatabaseConnection): void {\n    const currentVersion = getSchemaVersion(db);\n    const migrations = getMigrationFiles();\n\n    const pendingMigrations = migrations.filter(m => m.version > currentVersion);\n\n    if (pendingMigrations.length === 0) {\n        return;\n    }\n\n    for (const migration of pendingMigrations) {\n        const sql = readFileSync(migration.path, 'utf-8');\n\n        db.transaction(() => {\n            db.instance.exec(sql);\n            setSchemaVersion(db, migration.version);\n        });\n    }\n}\n\nexport function resetSchema(db: DatabaseConnection): void {\n    db.transaction(() => {\n        db.execute('DROP TABLE IF EXISTS knowledge_fts');\n        db.execute('DROP TABLE IF EXISTS knowledge');\n        setSchemaVersion(db, 0);\n    });\n\n    initializeSchema(db);\n}\n\nexport function getPendingMigrations(db: DatabaseConnection): string[] {\n    const currentVersion = getSchemaVersion(db);\n    const migrations = getMigrationFiles();\n    return migrations\n        .filter(m => m.version > currentVersion)\n        .map(m => `${m.version}_${m.name}`);\n}\n"],"names":["getPendingMigrations","getSchemaVersion","initializeSchema","resetSchema","db","result","instance","pragma","user_version","setSchemaVersion","version","getMigrationsDir","distPath","join","__dirname","getMigrationFiles","migrationsDir","files","readdirSync","filter","f","endsWith","sort","map","file","match","Error","parseInt","name","path","currentVersion","migrations","pendingMigrations","m","length","migration","sql","readFileSync","transaction","exec","execute"],"mappings":";;;;;;;;;;;QA2EgBA;eAAAA;;QAvEAC;eAAAA;;QAyCAC;eAAAA;;QAoBAC;eAAAA;;;oBAjE0B;sBACrB;AAGd,SAASF,iBAAiBG,EAAsB;IACnD,MAAMC,SAASD,GAAGE,QAAQ,CAACC,MAAM,CAAC;IAClC,OAAOF,MAAM,CAAC,EAAE,EAAEG,gBAAgB;AACtC;AAEA,SAASC,iBAAiBL,EAAsB,EAAEM,OAAe;IAC7DN,GAAGE,QAAQ,CAACC,MAAM,CAAC,CAAC,eAAe,EAAEG,SAAS;AAClD;AAEA,SAASC;IACL,4DAA4D;IAC5D,8DAA8D;IAC9D,MAAMC,WAAWC,IAAAA,UAAI,EAACC,WAAW;IACjC,OAAOF;AACX;AAEA,SAASG;IACL,MAAMC,gBAAgBL;IAEtB,IAAIM;IACJ,IAAI;QACAA,QAAQC,IAAAA,eAAW,EAACF,eACfG,MAAM,CAACC,CAAAA,IAAKA,EAAEC,QAAQ,CAAC,SACvBC,IAAI;IACb,EAAE,OAAM;QACJ,OAAO,EAAE;IACb;IAEA,OAAOL,MAAMM,GAAG,CAACC,CAAAA;QACb,MAAMC,QAAQD,KAAKC,KAAK,CAAC;QACzB,IAAI,CAACA,SAAS,CAACA,KAAK,CAAC,EAAE,IAAI,CAACA,KAAK,CAAC,EAAE,EAAE;YAClC,MAAM,IAAIC,MAAM,CAAC,4BAA4B,EAAEF,KAAK,+BAA+B,CAAC;QACxF;QACA,OAAO;YACHd,SAASiB,SAASF,KAAK,CAAC,EAAE,EAAE;YAC5BG,MAAMH,KAAK,CAAC,EAAE;YACdI,MAAMhB,IAAAA,UAAI,EAACG,eAAeQ;QAC9B;IACJ;AACJ;AAEO,SAAStB,iBAAiBE,EAAsB;IACnD,MAAM0B,iBAAiB7B,iBAAiBG;IACxC,MAAM2B,aAAahB;IAEnB,MAAMiB,oBAAoBD,WAAWZ,MAAM,CAACc,CAAAA,IAAKA,EAAEvB,OAAO,GAAGoB;IAE7D,IAAIE,kBAAkBE,MAAM,KAAK,GAAG;QAChC;IACJ;IAEA,KAAK,MAAMC,aAAaH,kBAAmB;QACvC,MAAMI,MAAMC,IAAAA,gBAAY,EAACF,UAAUN,IAAI,EAAE;QAEzCzB,GAAGkC,WAAW,CAAC;YACXlC,GAAGE,QAAQ,CAACiC,IAAI,CAACH;YACjB3B,iBAAiBL,IAAI+B,UAAUzB,OAAO;QAC1C;IACJ;AACJ;AAEO,SAASP,YAAYC,EAAsB;IAC9CA,GAAGkC,WAAW,CAAC;QACXlC,GAAGoC,OAAO,CAAC;QACXpC,GAAGoC,OAAO,CAAC;QACX/B,iBAAiBL,IAAI;IACzB;IAEAF,iBAAiBE;AACrB;AAEO,SAASJ,qBAAqBI,EAAsB;IACvD,MAAM0B,iBAAiB7B,iBAAiBG;IACxC,MAAM2B,aAAahB;IACnB,OAAOgB,WACFZ,MAAM,CAACc,CAAAA,IAAKA,EAAEvB,OAAO,GAAGoB,gBACxBP,GAAG,CAACU,CAAAA,IAAK,GAAGA,EAAEvB,OAAO,CAAC,CAAC,EAAEuB,EAAEL,IAAI,EAAE;AAC1C"}

package/dist/handlers/search.d.ts

@@ -0,0 +1,3 @@
+import type { SearchKnowledgeInput, SearchKnowledgeResult } from '../types';
+export declare function searchKnowledge(input: SearchKnowledgeInput): SearchKnowledgeResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/handlers/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/handlers/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAgB5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAwClF"}