@ai-devkit/memory 0.1.0

package/dist/handlers/search.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "searchKnowledge", {
+    enumerable: true,
+    get: function() {
+        return searchKnowledge;
+    }
+});
+const _database = require("../database");
+const _search = require("../services/search");
+const _ranker = require("../services/ranker");
+const _errors = require("../utils/errors");
+const DEFAULT_LIMIT = 5;
+const MAX_LIMIT = 20;
+const MIN_QUERY_LENGTH = 3;
+const MAX_QUERY_LENGTH = 500;
+function searchKnowledge(input) {
+    validateSearchInput(input);
+    const db = (0, _database.getDatabase)();
+    const limit = Math.min(Math.max(input.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+    const ftsQuery = (0, _search.buildFtsQuery)(input.query);
+    let rows;
+    if (ftsQuery === '') {
+        // Empty or invalid query - return recent items
+        const { sql, params } = (0, _search.buildSimpleQuery)(input.scope, limit);
+        rows = db.query(sql, params);
+    } else {
+        // Full-text search with BM25
+        const { sql, params } = (0, _search.buildSearchQuery)(ftsQuery, input.scope, limit * 2);
+        try {
+            rows = db.query(sql, params);
+        } catch (error) {
+            // FTS query syntax error - fallback to simple query
+            const { sql: fallbackSql, params: fallbackParams } = (0, _search.buildSimpleQuery)(input.scope, limit);
+            rows = db.query(fallbackSql, fallbackParams);
+        }
+    }
+    // Apply ranking with tag and scope boosts
+    const ranked = (0, _ranker.rankResults)(rows, {
+        contextTags: input.contextTags,
+        queryScope: input.scope
+    });
+    // Limit to requested count
+    const results = ranked.slice(0, limit);
+    return {
+        results,
+        totalMatches: ranked.length,
+        query: input.query
+    };
+}
+function validateSearchInput(input) {
+    const errors = [];
+    if (!input.query || typeof input.query !== 'string') {
+        errors.push('Query is required');
+    } else {
+        const trimmed = input.query.trim();
+        if (trimmed.length < MIN_QUERY_LENGTH) {
+            errors.push(`Query must be at least ${MIN_QUERY_LENGTH} characters`);
+        }
+        if (trimmed.length > MAX_QUERY_LENGTH) {
+            errors.push(`Query must be at most ${MAX_QUERY_LENGTH} characters`);
+        }
+    }
+    if (input.limit !== undefined) {
+        if (typeof input.limit !== 'number' || input.limit < 1) {
+            errors.push('Limit must be a positive number');
+        }
+    }
+    if (errors.length > 0) {
+        throw new _errors.ValidationError(errors.join('; '), {
+            errors
+        });
+    }
+}
+
+//# sourceMappingURL=search.js.map

package/dist/handlers/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/handlers/search.ts"],"sourcesContent":["import { getDatabase } from '../database';\nimport { buildFtsQuery, buildSearchQuery, buildSimpleQuery } from '../services/search';\nimport { rankResults } from '../services/ranker';\nimport { ValidationError } from '../utils/errors';\nimport type { SearchKnowledgeInput, SearchKnowledgeResult } from '../types';\n\nconst DEFAULT_LIMIT = 5;\nconst MAX_LIMIT = 20;\nconst MIN_QUERY_LENGTH = 3;\nconst MAX_QUERY_LENGTH = 500;\n\ninterface RawSearchRow {\n    id: string;\n    title: string;\n    content: string;\n    tags: string;\n    scope: string;\n    bm25_score: number;\n}\n\nexport function searchKnowledge(input: SearchKnowledgeInput): SearchKnowledgeResult {\n    validateSearchInput(input);\n\n    const db = getDatabase();\n    const limit = Math.min(Math.max(input.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);\n    const ftsQuery = buildFtsQuery(input.query);\n\n    let rows: RawSearchRow[];\n\n    if (ftsQuery === '') {\n        // Empty or invalid query - return recent items\n        const { sql, params } = buildSimpleQuery(input.scope, limit);\n        rows = db.query<RawSearchRow>(sql, params);\n    } else {\n        // Full-text search with BM25\n        const { sql, params } = buildSearchQuery(ftsQuery, input.scope, limit * 2);\n\n        try {\n            rows = db.query<RawSearchRow>(sql, params);\n        } catch (error) {\n            // FTS query syntax error - fallback to simple query\n            const { sql: fallbackSql, params: fallbackParams } = buildSimpleQuery(input.scope, limit);\n            rows = db.query<RawSearchRow>(fallbackSql, fallbackParams);\n        }\n    }\n\n    // Apply ranking with tag and scope boosts\n    const ranked = rankResults(rows, {\n        contextTags: input.contextTags,\n        queryScope: input.scope,\n    });\n\n    // Limit to requested count\n    const results = ranked.slice(0, limit);\n\n    return {\n        results,\n        totalMatches: ranked.length,\n        query: input.query,\n    };\n}\n\nfunction validateSearchInput(input: SearchKnowledgeInput): void {\n    const errors: string[] = [];\n\n    if (!input.query || typeof input.query !== 'string') {\n        errors.push('Query is required');\n    } else {\n        const trimmed = input.query.trim();\n        if (trimmed.length < MIN_QUERY_LENGTH) {\n            errors.push(`Query must be at least ${MIN_QUERY_LENGTH} characters`);\n        }\n        if (trimmed.length > MAX_QUERY_LENGTH) {\n            errors.push(`Query must be at most ${MAX_QUERY_LENGTH} characters`);\n        }\n    }\n\n    if (input.limit !== undefined) {\n        if (typeof input.limit !== 'number' || input.limit < 1) {\n            errors.push('Limit must be a positive number');\n        }\n    }\n\n    if (errors.length > 0) {\n        throw new ValidationError(errors.join('; '), { errors });\n    }\n}\n"],"names":["searchKnowledge","DEFAULT_LIMIT","MAX_LIMIT","MIN_QUERY_LENGTH","MAX_QUERY_LENGTH","input","validateSearchInput","db","getDatabase","limit","Math","min","max","ftsQuery","buildFtsQuery","query","rows","sql","params","buildSimpleQuery","scope","buildSearchQuery","error","fallbackSql","fallbackParams","ranked","rankResults","contextTags","queryScope","results","slice","totalMatches","length","errors","push","trimmed","trim","undefined","ValidationError","join"],"mappings":";;;;+BAoBgBA;;;eAAAA;;;0BApBY;wBACsC;wBACtC;wBACI;AAGhC,MAAMC,gBAAgB;AACtB,MAAMC,YAAY;AAClB,MAAMC,mBAAmB;AACzB,MAAMC,mBAAmB;AAWlB,SAASJ,gBAAgBK,KAA2B;IACvDC,oBAAoBD;IAEpB,MAAME,KAAKC,IAAAA,qBAAW;IACtB,MAAMC,QAAQC,KAAKC,GAAG,CAACD,KAAKE,GAAG,CAACP,MAAMI,KAAK,IAAIR,eAAe,IAAIC;IAClE,MAAMW,WAAWC,IAAAA,qBAAa,EAACT,MAAMU,KAAK;IAE1C,IAAIC;IAEJ,IAAIH,aAAa,IAAI;QACjB,+CAA+C;QAC/C,MAAM,EAAEI,GAAG,EAAEC,MAAM,EAAE,GAAGC,IAAAA,wBAAgB,EAACd,MAAMe,KAAK,EAAEX;QACtDO,OAAOT,GAAGQ,KAAK,CAAeE,KAAKC;IACvC,OAAO;QACH,6BAA6B;QAC7B,MAAM,EAAED,GAAG,EAAEC,MAAM,EAAE,GAAGG,IAAAA,wBAAgB,EAACR,UAAUR,MAAMe,KAAK,EAAEX,QAAQ;QAExE,IAAI;YACAO,OAAOT,GAAGQ,KAAK,CAAeE,KAAKC;QACvC,EAAE,OAAOI,OAAO;YACZ,oDAAoD;YACpD,MAAM,EAAEL,KAAKM,WAAW,EAAEL,QAAQM,cAAc,EAAE,GAAGL,IAAAA,wBAAgB,EAACd,MAAMe,KAAK,EAAEX;YACnFO,OAAOT,GAAGQ,KAAK,CAAeQ,aAAaC;QAC/C;IACJ;IAEA,0CAA0C;IAC1C,MAAMC,SAASC,IAAAA,mBAAW,EAACV,MAAM;QAC7BW,aAAatB,MAAMsB,WAAW;QAC9BC,YAAYvB,MAAMe,KAAK;IAC3B;IAEA,2BAA2B;IAC3B,MAAMS,UAAUJ,OAAOK,KAAK,CAAC,GAAGrB;IAEhC,OAAO;QACHoB;QACAE,cAAcN,OAAOO,MAAM;QAC3BjB,OAAOV,MAAMU,KAAK;IACtB;AACJ;AAEA,SAAST,oBAAoBD,KAA2B;IACpD,MAAM4B,SAAmB,EAAE;IAE3B,IAAI,CAAC5B,MAAMU,KAAK,IAAI,OAAOV,MAAMU,KAAK,KAAK,UAAU;QACjDkB,OAAOC,IAAI,CAAC;IAChB,OAAO;QACH,MAAMC,UAAU9B,MAAMU,KAAK,CAACqB,IAAI;QAChC,IAAID,QAAQH,MAAM,GAAG7B,kBAAkB;YACnC8B,OAAOC,IAAI,CAAC,CAAC,uBAAuB,EAAE/B,iBAAiB,WAAW,CAAC;QACvE;QACA,IAAIgC,QAAQH,MAAM,GAAG5B,kBAAkB;YACnC6B,OAAOC,IAAI,CAAC,CAAC,sBAAsB,EAAE9B,iBAAiB,WAAW,CAAC;QACtE;IACJ;IAEA,IAAIC,MAAMI,KAAK,KAAK4B,WAAW;QAC3B,IAAI,OAAOhC,MAAMI,KAAK,KAAK,YAAYJ,MAAMI,KAAK,GAAG,GAAG;YACpDwB,OAAOC,IAAI,CAAC;QAChB;IACJ;IAEA,IAAID,OAAOD,MAAM,GAAG,GAAG;QACnB,MAAM,IAAIM,uBAAe,CAACL,OAAOM,IAAI,CAAC,OAAO;YAAEN;QAAO;IAC1D;AACJ"}

package/dist/handlers/store.d.ts

@@ -0,0 +1,3 @@
+import type { StoreKnowledgeInput, StoreKnowledgeResult } from '../types';
+export declare function storeKnowledge(input: StoreKnowledgeInput): StoreKnowledgeResult;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/handlers/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAgB,MAAM,UAAU,CAAC;AAExF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAwE/E"}

package/dist/handlers/store.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "storeKnowledge", {
+    enumerable: true,
+    get: function() {
+        return storeKnowledge;
+    }
+});
+const _uuid = require("uuid");
+const _database = require("../database");
+const _validator = require("../services/validator");
+const _normalizer = require("../services/normalizer");
+const _errors = require("../utils/errors");
+function storeKnowledge(input) {
+    (0, _validator.validateStoreInput)(input);
+    const db = (0, _database.getDatabase)();
+    const now = new Date().toISOString();
+    const normalizedTitle = (0, _normalizer.normalizeTitle)(input.title);
+    const scope = (0, _normalizer.normalizeScope)(input.scope);
+    const tags = (0, _normalizer.normalizeTags)(input.tags ?? []);
+    const contentHash = (0, _normalizer.hashContent)(input.content);
+    const id = (0, _uuid.v4)();
+    try {
+        return db.transaction(()=>{
+            const existingByTitle = db.queryOne('SELECT id FROM knowledge WHERE normalized_title = ? AND scope = ?', [
+                normalizedTitle,
+                scope
+            ]);
+            if (existingByTitle) {
+                throw new _errors.DuplicateError('Knowledge with similar title already exists in this scope', existingByTitle.id, 'title');
+            }
+            const existingByHash = db.queryOne('SELECT id FROM knowledge WHERE content_hash = ? AND scope = ?', [
+                contentHash,
+                scope
+            ]);
+            if (existingByHash) {
+                throw new _errors.DuplicateError('Knowledge with identical content already exists in this scope', existingByHash.id, 'content');
+            }
+            db.execute(`INSERT INTO knowledge (
+          id, title, content, tags, scope,
+          normalized_title, content_hash, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                id,
+                input.title.trim(),
+                input.content.trim(),
+                JSON.stringify(tags),
+                scope,
+                normalizedTitle,
+                contentHash,
+                now,
+                now
+            ]);
+            return {
+                success: true,
+                id,
+                message: 'Knowledge stored successfully'
+            };
+        });
+    } catch (error) {
+        if (error instanceof _errors.DuplicateError) {
+            throw error;
+        }
+        throw new _errors.StorageError('Failed to store knowledge', {
+            originalError: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+
+//# sourceMappingURL=store.js.map

package/dist/handlers/store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/handlers/store.ts"],"sourcesContent":["import { v4 as uuidv4 } from 'uuid';\nimport { getDatabase } from '../database';\nimport { validateStoreInput } from '../services/validator';\nimport { normalizeTitle, normalizeScope, normalizeTags, hashContent } from '../services/normalizer';\nimport { DuplicateError, StorageError } from '../utils/errors';\nimport type { StoreKnowledgeInput, StoreKnowledgeResult, KnowledgeRow } from '../types';\n\nexport function storeKnowledge(input: StoreKnowledgeInput): StoreKnowledgeResult {\n    validateStoreInput(input);\n\n    const db = getDatabase();\n    const now = new Date().toISOString();\n    const normalizedTitle = normalizeTitle(input.title);\n    const scope = normalizeScope(input.scope);\n    const tags = normalizeTags(input.tags ?? []);\n    const contentHash = hashContent(input.content);\n    const id = uuidv4();\n\n    try {\n        return db.transaction(() => {\n            const existingByTitle = db.queryOne<KnowledgeRow>(\n                'SELECT id FROM knowledge WHERE normalized_title = ? AND scope = ?',\n                [normalizedTitle, scope]\n            );\n\n            if (existingByTitle) {\n                throw new DuplicateError(\n                    'Knowledge with similar title already exists in this scope',\n                    existingByTitle.id,\n                    'title'\n                );\n            }\n\n            const existingByHash = db.queryOne<KnowledgeRow>(\n                'SELECT id FROM knowledge WHERE content_hash = ? AND scope = ?',\n                [contentHash, scope]\n            );\n\n            if (existingByHash) {\n                throw new DuplicateError(\n                    'Knowledge with identical content already exists in this scope',\n                    existingByHash.id,\n                    'content'\n                );\n            }\n\n            db.execute(\n                `INSERT INTO knowledge (\n          id, title, content, tags, scope,\n          normalized_title, content_hash, created_at, updated_at\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n                [\n                    id,\n                    input.title.trim(),\n                    input.content.trim(),\n                    JSON.stringify(tags),\n                    scope,\n                    normalizedTitle,\n                    contentHash,\n                    now,\n                    now\n                ]\n            );\n\n            return {\n                success: true,\n                id,\n                message: 'Knowledge stored successfully'\n            };\n        });\n    } catch (error) {\n        if (error instanceof DuplicateError) {\n            throw error;\n        }\n        throw new StorageError(\n            'Failed to store knowledge',\n            { originalError: error instanceof Error ? error.message : String(error) }\n        );\n    }\n}"],"names":["storeKnowledge","input","validateStoreInput","db","getDatabase","now","Date","toISOString","normalizedTitle","normalizeTitle","title","scope","normalizeScope","tags","normalizeTags","contentHash","hashContent","content","id","uuidv4","transaction","existingByTitle","queryOne","DuplicateError","existingByHash","execute","trim","JSON","stringify","success","message","error","StorageError","originalError","Error","String"],"mappings":";;;;+BAOgBA;;;eAAAA;;;sBAPa;0BACD;2BACO;4BACwC;wBAC9B;AAGtC,SAASA,eAAeC,KAA0B;IACrDC,IAAAA,6BAAkB,EAACD;IAEnB,MAAME,KAAKC,IAAAA,qBAAW;IACtB,MAAMC,MAAM,IAAIC,OAAOC,WAAW;IAClC,MAAMC,kBAAkBC,IAAAA,0BAAc,EAACR,MAAMS,KAAK;IAClD,MAAMC,QAAQC,IAAAA,0BAAc,EAACX,MAAMU,KAAK;IACxC,MAAME,OAAOC,IAAAA,yBAAa,EAACb,MAAMY,IAAI,IAAI,EAAE;IAC3C,MAAME,cAAcC,IAAAA,uBAAW,EAACf,MAAMgB,OAAO;IAC7C,MAAMC,KAAKC,IAAAA,QAAM;IAEjB,IAAI;QACA,OAAOhB,GAAGiB,WAAW,CAAC;YAClB,MAAMC,kBAAkBlB,GAAGmB,QAAQ,CAC/B,qEACA;gBAACd;gBAAiBG;aAAM;YAG5B,IAAIU,iBAAiB;gBACjB,MAAM,IAAIE,sBAAc,CACpB,6DACAF,gBAAgBH,EAAE,EAClB;YAER;YAEA,MAAMM,iBAAiBrB,GAAGmB,QAAQ,CAC9B,iEACA;gBAACP;gBAAaJ;aAAM;YAGxB,IAAIa,gBAAgB;gBAChB,MAAM,IAAID,sBAAc,CACpB,iEACAC,eAAeN,EAAE,EACjB;YAER;YAEAf,GAAGsB,OAAO,CACN,CAAC;;;4CAG2B,CAAC,EAC7B;gBACIP;gBACAjB,MAAMS,KAAK,CAACgB,IAAI;gBAChBzB,MAAMgB,OAAO,CAACS,IAAI;gBAClBC,KAAKC,SAAS,CAACf;gBACfF;gBACAH;gBACAO;gBACAV;gBACAA;aACH;YAGL,OAAO;gBACHwB,SAAS;gBACTX;gBACAY,SAAS;YACb;QACJ;IACJ,EAAE,OAAOC,OAAO;QACZ,IAAIA,iBAAiBR,sBAAc,EAAE;YACjC,MAAMQ;QACV;QACA,MAAM,IAAIC,oBAAY,CAClB,6BACA;YAAEC,eAAeF,iBAAiBG,QAAQH,MAAMD,OAAO,GAAGK,OAAOJ;QAAO;IAEhF;AACJ"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+const _commander = require("commander");
+const _api = require("./api");
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const program = new _commander.Command();
+program.name('ai-devkit-memory').description('Knowledge memory service for AI agents').version('0.1.0');
+program.command('store').description('Store a new knowledge item').requiredOption('-t, --title <title>', 'Title of the knowledge item (10-100 chars)').requiredOption('-c, --content <content>', 'Content of the knowledge item (50-5000 chars)').option('--tags <tags>', 'Comma-separated tags (e.g., "api,backend")').option('-s, --scope <scope>', 'Scope: global, project:<name>, or repo:<name>', 'global').action((options)=>{
+    try {
+        const result = (0, _api.memoryStoreCommand)(options);
+        console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+        console.error(JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        }, null, 2));
+        process.exit(1);
+    }
+});
+program.command('search').description('Search for knowledge items').requiredOption('-q, --query <query>', 'Search query (3-500 chars)').option('--tags <tags>', 'Comma-separated context tags to boost results').option('-s, --scope <scope>', 'Scope filter').option('-l, --limit <limit>', 'Maximum results (1-20)', '5').action((options)=>{
+    try {
+        const result = (0, _api.memorySearchCommand)({
+            ...options,
+            limit: options.limit ? parseInt(options.limit, 10) : 5
+        });
+        console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+        console.error(JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        }, null, 2));
+        process.exit(1);
+    }
+});
+program.command('serve').description('Start the MCP server (default mode)').action(async ()=>{
+    const { runServer } = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("./server")));
+    await runServer();
+});
+// Default to serve mode if no command specified
+if (process.argv.length === 2) {
+    const { runServer } = require('./server');
+    runServer().catch((error)=>{
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    });
+} else {
+    program.parse();
+}
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport { memoryStoreCommand, memorySearchCommand } from './api';\nimport type { MemoryStoreOptions, MemorySearchOptions } from './api';\n\nconst program = new Command();\n\nprogram\n    .name('ai-devkit-memory')\n    .description('Knowledge memory service for AI agents')\n    .version('0.1.0');\n\nprogram\n    .command('store')\n    .description('Store a new knowledge item')\n    .requiredOption('-t, --title <title>', 'Title of the knowledge item (10-100 chars)')\n    .requiredOption('-c, --content <content>', 'Content of the knowledge item (50-5000 chars)')\n    .option('--tags <tags>', 'Comma-separated tags (e.g., \"api,backend\")')\n    .option('-s, --scope <scope>', 'Scope: global, project:<name>, or repo:<name>', 'global')\n    .action((options: MemoryStoreOptions) => {\n        try {\n            const result = memoryStoreCommand(options);\n            console.log(JSON.stringify(result, null, 2));\n        } catch (error) {\n            console.error(JSON.stringify({\n                success: false,\n                error: error instanceof Error ? error.message : String(error)\n            }, null, 2));\n            process.exit(1);\n        }\n    });\n\nprogram\n    .command('search')\n    .description('Search for knowledge items')\n    .requiredOption('-q, --query <query>', 'Search query (3-500 chars)')\n    .option('--tags <tags>', 'Comma-separated context tags to boost results')\n    .option('-s, --scope <scope>', 'Scope filter')\n    .option('-l, --limit <limit>', 'Maximum results (1-20)', '5')\n    .action((options: MemorySearchOptions & { limit?: string }) => {\n        try {\n            const result = memorySearchCommand({\n                ...options,\n                limit: options.limit ? parseInt(options.limit, 10) : 5,\n            });\n            console.log(JSON.stringify(result, null, 2));\n        } catch (error) {\n            console.error(JSON.stringify({\n                success: false,\n                error: error instanceof Error ? error.message : String(error)\n            }, null, 2));\n            process.exit(1);\n        }\n    });\n\nprogram\n    .command('serve')\n    .description('Start the MCP server (default mode)')\n    .action(async () => {\n        const { runServer } = await import('./server');\n        await runServer();\n    });\n\n// Default to serve mode if no command specified\nif (process.argv.length === 2) {\n    const { runServer } = require('./server');\n    runServer().catch((error: Error) => {\n        console.error('Failed to start server:', error);\n        process.exit(1);\n    });\n} else {\n    program.parse();\n}\n"],"names":["program","Command","name","description","version","command","requiredOption","option","action","options","result","memoryStoreCommand","console","log","JSON","stringify","error","success","Error","message","String","process","exit","memorySearchCommand","limit","parseInt","runServer","argv","length","require","catch","parse"],"mappings":";;;;;2BAEwB;qBACgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGxD,MAAMA,UAAU,IAAIC,kBAAO;AAE3BD,QACKE,IAAI,CAAC,oBACLC,WAAW,CAAC,0CACZC,OAAO,CAAC;AAEbJ,QACKK,OAAO,CAAC,SACRF,WAAW,CAAC,8BACZG,cAAc,CAAC,uBAAuB,8CACtCA,cAAc,CAAC,2BAA2B,iDAC1CC,MAAM,CAAC,iBAAiB,8CACxBA,MAAM,CAAC,uBAAuB,iDAAiD,UAC/EC,MAAM,CAAC,CAACC;IACL,IAAI;QACA,MAAMC,SAASC,IAAAA,uBAAkB,EAACF;QAClCG,QAAQC,GAAG,CAACC,KAAKC,SAAS,CAACL,QAAQ,MAAM;IAC7C,EAAE,OAAOM,OAAO;QACZJ,QAAQI,KAAK,CAACF,KAAKC,SAAS,CAAC;YACzBE,SAAS;YACTD,OAAOA,iBAAiBE,QAAQF,MAAMG,OAAO,GAAGC,OAAOJ;QAC3D,GAAG,MAAM;QACTK,QAAQC,IAAI,CAAC;IACjB;AACJ;AAEJtB,QACKK,OAAO,CAAC,UACRF,WAAW,CAAC,8BACZG,cAAc,CAAC,uBAAuB,8BACtCC,MAAM,CAAC,iBAAiB,iDACxBA,MAAM,CAAC,uBAAuB,gBAC9BA,MAAM,CAAC,uBAAuB,0BAA0B,KACxDC,MAAM,CAAC,CAACC;IACL,IAAI;QACA,MAAMC,SAASa,IAAAA,wBAAmB,EAAC;YAC/B,GAAGd,OAAO;YACVe,OAAOf,QAAQe,KAAK,GAAGC,SAAShB,QAAQe,KAAK,EAAE,MAAM;QACzD;QACAZ,QAAQC,GAAG,CAACC,KAAKC,SAAS,CAACL,QAAQ,MAAM;IAC7C,EAAE,OAAOM,OAAO;QACZJ,QAAQI,KAAK,CAACF,KAAKC,SAAS,CAAC;YACzBE,SAAS;YACTD,OAAOA,iBAAiBE,QAAQF,MAAMG,OAAO,GAAGC,OAAOJ;QAC3D,GAAG,MAAM;QACTK,QAAQC,IAAI,CAAC;IACjB;AACJ;AAEJtB,QACKK,OAAO,CAAC,SACRF,WAAW,CAAC,uCACZK,MAAM,CAAC;IACJ,MAAM,EAAEkB,SAAS,EAAE,GAAG,MAAM,mEAAA,QAAO;IACnC,MAAMA;AACV;AAEJ,gDAAgD;AAChD,IAAIL,QAAQM,IAAI,CAACC,MAAM,KAAK,GAAG;IAC3B,MAAM,EAAEF,SAAS,EAAE,GAAGG,QAAQ;IAC9BH,YAAYI,KAAK,CAAC,CAACd;QACfJ,QAAQI,KAAK,CAAC,2BAA2BA;QACzCK,QAAQC,IAAI,CAAC;IACjB;AACJ,OAAO;IACHtB,QAAQ+B,KAAK;AACjB"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(): Server;
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAsEnE,wBAAgB,YAAY,IAAI,MAAM,CA8ErC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAI/C"}

package/dist/server.js

@@ -0,0 +1,172 @@
+"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 createServer () {
+        return createServer;
+    },
+    get runServer () {
+        return runServer;
+    }
+});
+const _index = require("@modelcontextprotocol/sdk/server/index.js");
+const _stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+const _types = require("@modelcontextprotocol/sdk/types.js");
+const _store = require("./handlers/store");
+const _search = require("./handlers/search");
+const _errors = require("./utils/errors");
+const SERVER_NAME = 'ai-devkit-memory';
+const SERVER_VERSION = '0.1.0';
+const STORE_TOOL = {
+    name: 'memory.storeKnowledge',
+    description: 'Store a new knowledge item. Use this to save actionable guidelines, rules, or patterns for future reference.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: 'Short, explicit description of the rule (5-12 words, 10-100 chars)'
+            },
+            content: {
+                type: 'string',
+                description: 'Detailed explanation in markdown format. Supports code blocks and examples. (50-5000 chars)'
+            },
+            tags: {
+                type: 'array',
+                items: {
+                    type: 'string'
+                },
+                description: 'Optional domain keywords (e.g., ["api", "backend"]). Max 10 tags.'
+            },
+            scope: {
+                type: 'string',
+                description: 'Optional scope: "global", "project:<name>", or "repo:<name>". Default: "global"'
+            }
+        },
+        required: [
+            'title',
+            'content'
+        ]
+    }
+};
+const SEARCH_TOOL = {
+    name: 'memory.searchKnowledge',
+    description: 'Search for relevant knowledge based on a task description. Returns ranked results.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Natural language task description to search for relevant knowledge (3-500 chars)'
+            },
+            contextTags: {
+                type: 'array',
+                items: {
+                    type: 'string'
+                },
+                description: 'Optional tags to boost matching results (e.g., ["api", "backend"])'
+            },
+            scope: {
+                type: 'string',
+                description: 'Optional project/repo scope filter. Results from this scope are prioritized.'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (1-20, default: 5)'
+            }
+        },
+        required: [
+            'query'
+        ]
+    }
+};
+function createServer() {
+    const server = new _index.Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION
+    }, {
+        capabilities: {
+            tools: {}
+        }
+    });
+    // List available tools
+    server.setRequestHandler(_types.ListToolsRequestSchema, async ()=>{
+        return {
+            tools: [
+                STORE_TOOL,
+                SEARCH_TOOL
+            ]
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler(_types.CallToolRequestSchema, async (request)=>{
+        const { name, arguments: args } = request.params;
+        try {
+            if (name === 'memory.storeKnowledge') {
+                const input = args;
+                const result = (0, _store.storeKnowledge)(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2)
+                        }
+                    ]
+                };
+            }
+            if (name === 'memory.searchKnowledge') {
+                const input = args;
+                const result = (0, _search.searchKnowledge)(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2)
+                        }
+                    ]
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'UNKNOWN_TOOL',
+                            message: `Unknown tool: ${name}`
+                        })
+                    }
+                ],
+                isError: true
+            };
+        } catch (error) {
+            const errorResponse = error instanceof _errors.KnowledgeMemoryError ? error.toJSON() : {
+                error: 'INTERNAL_ERROR',
+                message: error instanceof Error ? error.message : String(error)
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(errorResponse, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    return server;
+}
+async function runServer() {
+    const server = createServer();
+    const transport = new _stdio.StdioServerTransport();
+    await server.connect(transport);
+}
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n    CallToolRequestSchema,\n    ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { storeKnowledge } from './handlers/store';\nimport { searchKnowledge } from './handlers/search';\nimport { KnowledgeMemoryError } from './utils/errors';\nimport type { StoreKnowledgeInput, SearchKnowledgeInput } from './types';\n\nconst SERVER_NAME = 'ai-devkit-memory';\nconst SERVER_VERSION = '0.1.0';\n\nconst STORE_TOOL = {\n    name: 'memory.storeKnowledge',\n    description: 'Store a new knowledge item. Use this to save actionable guidelines, rules, or patterns for future reference.',\n    inputSchema: {\n        type: 'object' as const,\n        properties: {\n            title: {\n                type: 'string',\n                description: 'Short, explicit description of the rule (5-12 words, 10-100 chars)',\n            },\n            content: {\n                type: 'string',\n                description: 'Detailed explanation in markdown format. Supports code blocks and examples. (50-5000 chars)',\n            },\n            tags: {\n                type: 'array',\n                items: { type: 'string' },\n                description: 'Optional domain keywords (e.g., [\"api\", \"backend\"]). Max 10 tags.',\n            },\n            scope: {\n                type: 'string',\n                description: 'Optional scope: \"global\", \"project:<name>\", or \"repo:<name>\". Default: \"global\"',\n            },\n        },\n        required: ['title', 'content'],\n    },\n};\n\nconst SEARCH_TOOL = {\n    name: 'memory.searchKnowledge',\n    description: 'Search for relevant knowledge based on a task description. Returns ranked results.',\n    inputSchema: {\n        type: 'object' as const,\n        properties: {\n            query: {\n                type: 'string',\n                description: 'Natural language task description to search for relevant knowledge (3-500 chars)',\n            },\n            contextTags: {\n                type: 'array',\n                items: { type: 'string' },\n                description: 'Optional tags to boost matching results (e.g., [\"api\", \"backend\"])',\n            },\n            scope: {\n                type: 'string',\n                description: 'Optional project/repo scope filter. Results from this scope are prioritized.',\n            },\n            limit: {\n                type: 'number',\n                description: 'Maximum number of results to return (1-20, default: 5)',\n            },\n        },\n        required: ['query'],\n    },\n};\n\nexport function createServer(): Server {\n    const server = new Server(\n        {\n            name: SERVER_NAME,\n            version: SERVER_VERSION,\n        },\n        {\n            capabilities: {\n                tools: {},\n            },\n        }\n    );\n\n    // List available tools\n    server.setRequestHandler(ListToolsRequestSchema, async () => {\n        return {\n            tools: [STORE_TOOL, SEARCH_TOOL],\n        };\n    });\n\n    // Handle tool calls\n    server.setRequestHandler(CallToolRequestSchema, async (request) => {\n        const { name, arguments: args } = request.params;\n\n        try {\n            if (name === 'memory.storeKnowledge') {\n                const input = args as unknown as StoreKnowledgeInput;\n                const result = storeKnowledge(input);\n                return {\n                    content: [\n                        {\n                            type: 'text' as const,\n                            text: JSON.stringify(result, null, 2),\n                        },\n                    ],\n                };\n            }\n\n            if (name === 'memory.searchKnowledge') {\n                const input = args as unknown as SearchKnowledgeInput;\n                const result = searchKnowledge(input);\n                return {\n                    content: [\n                        {\n                            type: 'text' as const,\n                            text: JSON.stringify(result, null, 2),\n                        },\n                    ],\n                };\n            }\n\n            return {\n                content: [\n                    {\n                        type: 'text' as const,\n                        text: JSON.stringify({ error: 'UNKNOWN_TOOL', message: `Unknown tool: ${name}` }),\n                    },\n                ],\n                isError: true,\n            };\n        } catch (error) {\n            const errorResponse = error instanceof KnowledgeMemoryError\n                ? error.toJSON()\n                : { error: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : String(error) };\n\n            return {\n                content: [\n                    {\n                        type: 'text' as const,\n                        text: JSON.stringify(errorResponse, null, 2),\n                    },\n                ],\n                isError: true,\n            };\n        }\n    });\n\n    return server;\n}\n\nexport async function runServer(): Promise<void> {\n    const server = createServer();\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n}\n"],"names":["createServer","runServer","SERVER_NAME","SERVER_VERSION","STORE_TOOL","name","description","inputSchema","type","properties","title","content","tags","items","scope","required","SEARCH_TOOL","query","contextTags","limit","server","Server","version","capabilities","tools","setRequestHandler","ListToolsRequestSchema","CallToolRequestSchema","request","arguments","args","params","input","result","storeKnowledge","text","JSON","stringify","searchKnowledge","error","message","isError","errorResponse","KnowledgeMemoryError","toJSON","Error","String","transport","StdioServerTransport","connect"],"mappings":";;;;;;;;;;;QAsEgBA;eAAAA;;QAgFMC;eAAAA;;;uBAtJC;uBACc;uBAI9B;uBACwB;wBACC;wBACK;AAGrC,MAAMC,cAAc;AACpB,MAAMC,iBAAiB;AAEvB,MAAMC,aAAa;IACfC,MAAM;IACNC,aAAa;IACbC,aAAa;QACTC,MAAM;QACNC,YAAY;YACRC,OAAO;gBACHF,MAAM;gBACNF,aAAa;YACjB;YACAK,SAAS;gBACLH,MAAM;gBACNF,aAAa;YACjB;YACAM,MAAM;gBACFJ,MAAM;gBACNK,OAAO;oBAAEL,MAAM;gBAAS;gBACxBF,aAAa;YACjB;YACAQ,OAAO;gBACHN,MAAM;gBACNF,aAAa;YACjB;QACJ;QACAS,UAAU;YAAC;YAAS;SAAU;IAClC;AACJ;AAEA,MAAMC,cAAc;IAChBX,MAAM;IACNC,aAAa;IACbC,aAAa;QACTC,MAAM;QACNC,YAAY;YACRQ,OAAO;gBACHT,MAAM;gBACNF,aAAa;YACjB;YACAY,aAAa;gBACTV,MAAM;gBACNK,OAAO;oBAAEL,MAAM;gBAAS;gBACxBF,aAAa;YACjB;YACAQ,OAAO;gBACHN,MAAM;gBACNF,aAAa;YACjB;YACAa,OAAO;gBACHX,MAAM;gBACNF,aAAa;YACjB;QACJ;QACAS,UAAU;YAAC;SAAQ;IACvB;AACJ;AAEO,SAASf;IACZ,MAAMoB,SAAS,IAAIC,aAAM,CACrB;QACIhB,MAAMH;QACNoB,SAASnB;IACb,GACA;QACIoB,cAAc;YACVC,OAAO,CAAC;QACZ;IACJ;IAGJ,uBAAuB;IACvBJ,OAAOK,iBAAiB,CAACC,6BAAsB,EAAE;QAC7C,OAAO;YACHF,OAAO;gBAACpB;gBAAYY;aAAY;QACpC;IACJ;IAEA,oBAAoB;IACpBI,OAAOK,iBAAiB,CAACE,4BAAqB,EAAE,OAAOC;QACnD,MAAM,EAAEvB,IAAI,EAAEwB,WAAWC,IAAI,EAAE,GAAGF,QAAQG,MAAM;QAEhD,IAAI;YACA,IAAI1B,SAAS,yBAAyB;gBAClC,MAAM2B,QAAQF;gBACd,MAAMG,SAASC,IAAAA,qBAAc,EAACF;gBAC9B,OAAO;oBACHrB,SAAS;wBACL;4BACIH,MAAM;4BACN2B,MAAMC,KAAKC,SAAS,CAACJ,QAAQ,MAAM;wBACvC;qBACH;gBACL;YACJ;YAEA,IAAI5B,SAAS,0BAA0B;gBACnC,MAAM2B,QAAQF;gBACd,MAAMG,SAASK,IAAAA,uBAAe,EAACN;gBAC/B,OAAO;oBACHrB,SAAS;wBACL;4BACIH,MAAM;4BACN2B,MAAMC,KAAKC,SAAS,CAACJ,QAAQ,MAAM;wBACvC;qBACH;gBACL;YACJ;YAEA,OAAO;gBACHtB,SAAS;oBACL;wBACIH,MAAM;wBACN2B,MAAMC,KAAKC,SAAS,CAAC;4BAAEE,OAAO;4BAAgBC,SAAS,CAAC,cAAc,EAAEnC,MAAM;wBAAC;oBACnF;iBACH;gBACDoC,SAAS;YACb;QACJ,EAAE,OAAOF,OAAO;YACZ,MAAMG,gBAAgBH,iBAAiBI,4BAAoB,GACrDJ,MAAMK,MAAM,KACZ;gBAAEL,OAAO;gBAAkBC,SAASD,iBAAiBM,QAAQN,MAAMC,OAAO,GAAGM,OAAOP;YAAO;YAEjG,OAAO;gBACH5B,SAAS;oBACL;wBACIH,MAAM;wBACN2B,MAAMC,KAAKC,SAAS,CAACK,eAAe,MAAM;oBAC9C;iBACH;gBACDD,SAAS;YACb;QACJ;IACJ;IAEA,OAAOrB;AACX;AAEO,eAAenB;IAClB,MAAMmB,SAASpB;IACf,MAAM+C,YAAY,IAAIC,2BAAoB;IAC1C,MAAM5B,OAAO6B,OAAO,CAACF;AACzB"}

package/dist/services/normalizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Normalize title for deduplication
+ */
+export declare function normalizeTitle(title: string): string;
+/**
+ * Normalize content for hashing
+ */
+export declare function normalizeContent(content: string): string;
+/**
+ * Generate SHA-256 hash of normalized content for deduplication
+ */
+export declare function hashContent(content: string): string;
+/**
+ * Normalize tags
+ */
+export declare function normalizeTags(tags: string[]): string[];
+/**
+ * Validate and normalize scope
+ */
+export declare function normalizeScope(scope?: string): string;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/services/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/services/normalizer.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/services/normalizer.js

@@ -0,0 +1,52 @@
+"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 hashContent () {
+        return hashContent;
+    },
+    get normalizeContent () {
+        return normalizeContent;
+    },
+    get normalizeScope () {
+        return normalizeScope;
+    },
+    get normalizeTags () {
+        return normalizeTags;
+    },
+    get normalizeTitle () {
+        return normalizeTitle;
+    }
+});
+const _crypto = require("crypto");
+function normalizeTitle(title) {
+    return title.toLowerCase().trim().replace(/\s+/g, ' ');
+}
+function normalizeContent(content) {
+    return content.trim().replace(/\r\n/g, '\n').replace(/\r/g, '\n').replace(/\n{3,}/g, '\n\n');
+}
+function hashContent(content) {
+    const normalized = normalizeContent(content);
+    return (0, _crypto.createHash)('sha256').update(normalized, 'utf8').digest('hex');
+}
+function normalizeTags(tags) {
+    const normalized = tags.map((tag)=>tag.toLowerCase().trim()).filter((tag)=>tag.length > 0);
+    return [
+        ...new Set(normalized)
+    ];
+}
+function normalizeScope(scope) {
+    if (!scope || scope.trim() === '') {
+        return 'global';
+    }
+    return scope.trim().toLowerCase();
+}
+
+//# sourceMappingURL=normalizer.js.map

package/dist/services/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/normalizer.ts"],"sourcesContent":["import { createHash } from 'crypto';\n\n/**\n * Normalize title for deduplication\n */\nexport function normalizeTitle(title: string): string {\n    return title\n        .toLowerCase()\n        .trim()\n        .replace(/\\s+/g, ' ');\n}\n\n/**\n * Normalize content for hashing\n */\nexport function normalizeContent(content: string): string {\n    return content\n        .trim()\n        .replace(/\\r\\n/g, '\\n')\n        .replace(/\\r/g, '\\n')\n        .replace(/\\n{3,}/g, '\\n\\n');\n}\n\n/**\n * Generate SHA-256 hash of normalized content for deduplication\n */\nexport function hashContent(content: string): string {\n    const normalized = normalizeContent(content);\n    return createHash('sha256').update(normalized, 'utf8').digest('hex');\n}\n\n/**\n * Normalize tags\n */\nexport function normalizeTags(tags: string[]): string[] {\n    const normalized = tags\n        .map(tag => tag.toLowerCase().trim())\n        .filter(tag => tag.length > 0);\n\n    return [...new Set(normalized)];\n}\n\n/**\n * Validate and normalize scope\n */\nexport function normalizeScope(scope?: string): string {\n    if (!scope || scope.trim() === '') {\n        return 'global';\n    }\n    return scope.trim().toLowerCase();\n}"],"names":["hashContent","normalizeContent","normalizeScope","normalizeTags","normalizeTitle","title","toLowerCase","trim","replace","content","normalized","createHash","update","digest","tags","map","tag","filter","length","Set","scope"],"mappings":";;;;;;;;;;;QA0BgBA;eAAAA;;QAXAC;eAAAA;;QA8BAC;eAAAA;;QAXAC;eAAAA;;QA7BAC;eAAAA;;;wBALW;AAKpB,SAASA,eAAeC,KAAa;IACxC,OAAOA,MACFC,WAAW,GACXC,IAAI,GACJC,OAAO,CAAC,QAAQ;AACzB;AAKO,SAASP,iBAAiBQ,OAAe;IAC5C,OAAOA,QACFF,IAAI,GACJC,OAAO,CAAC,SAAS,MACjBA,OAAO,CAAC,OAAO,MACfA,OAAO,CAAC,WAAW;AAC5B;AAKO,SAASR,YAAYS,OAAe;IACvC,MAAMC,aAAaT,iBAAiBQ;IACpC,OAAOE,IAAAA,kBAAU,EAAC,UAAUC,MAAM,CAACF,YAAY,QAAQG,MAAM,CAAC;AAClE;AAKO,SAASV,cAAcW,IAAc;IACxC,MAAMJ,aAAaI,KACdC,GAAG,CAACC,CAAAA,MAAOA,IAAIV,WAAW,GAAGC,IAAI,IACjCU,MAAM,CAACD,CAAAA,MAAOA,IAAIE,MAAM,GAAG;IAEhC,OAAO;WAAI,IAAIC,IAAIT;KAAY;AACnC;AAKO,SAASR,eAAekB,KAAc;IACzC,IAAI,CAACA,SAASA,MAAMb,IAAI,OAAO,IAAI;QAC/B,OAAO;IACX;IACA,OAAOa,MAAMb,IAAI,GAAGD,WAAW;AACnC"}

package/dist/services/ranker.d.ts

@@ -0,0 +1,21 @@
+import type { SearchResultItem } from '../types';
+interface RawSearchResult {
+    id: string;
+    title: string;
+    content: string;
+    tags: string;
+    scope: string;
+    bm25_score: number;
+}
+interface RankingContext {
+    contextTags?: string[];
+    queryScope?: string | null;
+}
+/**
+ * Apply ranking formula to search results
+ *
+ * Formula: final_score = bm25_score × tag_boost + scope_boost
+ */
+export declare function rankResults(results: RawSearchResult[], context: RankingContext): SearchResultItem[];
+export {};
+//# sourceMappingURL=ranker.d.ts.map

package/dist/services/ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["../../src/services/ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,UAAU,eAAe;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAwCD;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,EAAE,cAAc,GACxB,gBAAgB,EAAE,CAgCpB"}