contextmate 0.1.0

package/dist/src/crypto/keys.js

@@ -0,0 +1,43 @@
+import argon2 from 'argon2';
+import { hkdf } from '@noble/hashes/hkdf';
+import { sha256 } from '@noble/hashes/sha256';
+import { randomBytes } from 'node:crypto';
+const KEY_LENGTH = 32;
+export function generateSalt() {
+    return new Uint8Array(randomBytes(KEY_LENGTH));
+}
+export async function deriveMasterKey(passphrase, salt) {
+    const hash = await argon2.hash(passphrase, {
+        type: argon2.argon2id,
+        salt: Buffer.from(salt),
+        timeCost: 3,
+        memoryCost: 65536,
+        parallelism: 4,
+        hashLength: KEY_LENGTH,
+        raw: true,
+    });
+    return new Uint8Array(hash);
+}
+export function deriveVaultKey(masterKey) {
+    return hkdf(sha256, masterKey, undefined, 'contextmate-vault-enc', KEY_LENGTH);
+}
+export function deriveFolderKey(vaultKey, folderId) {
+    return hkdf(sha256, vaultKey, undefined, 'contextmate-folder-' + folderId, KEY_LENGTH);
+}
+export function deriveFileKey(folderKey, fileId) {
+    return hkdf(sha256, folderKey, undefined, 'contextmate-file-' + fileId, KEY_LENGTH);
+}
+export function deriveAuthKey(masterKey) {
+    return hkdf(sha256, masterKey, undefined, 'contextmate-auth', KEY_LENGTH);
+}
+export function deriveSharingKey(masterKey) {
+    return hkdf(sha256, masterKey, undefined, 'contextmate-sharing', KEY_LENGTH);
+}
+export function deriveKeyForPath(vaultKey, filePath) {
+    const segments = filePath.split('/');
+    const folder = segments[0];
+    const rest = segments.slice(1).join('/');
+    const folderKey = deriveFolderKey(vaultKey, folder);
+    return deriveFileKey(folderKey, rest);
+}
+//# sourceMappingURL=keys.js.map

package/dist/src/crypto/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/crypto/keys.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,IAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE;QACzC,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,UAAU;QACtB,GAAG,EAAE,IAAI;KACV,CAAC,CAAC;IACH,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAqB;IAClD,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,uBAAuB,EAAE,UAAU,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAoB,EACpB,QAAgB;IAEhB,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB,GAAG,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAAqB,EACrB,MAAc;IAEd,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAqB;IACjD,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAoB,EACpB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/mcp/embeddings.d.ts

@@ -0,0 +1,16 @@
+export interface VectorSearchResult {
+    path: string;
+    score: number;
+}
+export declare class VectorIndex {
+    private db;
+    constructor(dbPath: string);
+    indexFile(path: string, content: string): void;
+    removeFromIndex(path: string): void;
+    recomputeIdf(): void;
+    search(query: string, limit?: number): VectorSearchResult[];
+    rebuildIndex(vaultPath: string): Promise<void>;
+    close(): void;
+    private collectMdFiles;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/src/mcp/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/mcp/embeddings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAsB1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA6D9C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA8BnC,YAAY,IAAI,IAAI;IAuDpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,kBAAkB,EAAE;IA4EzD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,KAAK,IAAI,IAAI;YAIC,cAAc;CAqB7B"}

package/dist/src/mcp/embeddings.js

@@ -0,0 +1,237 @@
+import Database from 'better-sqlite3';
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+const STOPWORDS = new Set([
+    'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'have', 'has',
+    'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'may',
+    'might', 'shall', 'can', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by',
+    'from', 'or', 'and', 'not', 'but', 'if', 'then', 'as', 'it', 'its', 'this',
+    'that', 'which', 'who', 'what', 'when', 'where', 'how', 'all', 'each',
+    'every', 'both', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'nor',
+    'too', 'very', 'just', 'also', 'than',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9']+/)
+        .filter((w) => w.length >= 2 && !STOPWORDS.has(w));
+}
+export class VectorIndex {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS vocabulary (
+        term TEXT PRIMARY KEY,
+        idf REAL NOT NULL DEFAULT 0,
+        doc_count INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE TABLE IF NOT EXISTS documents (
+        path TEXT PRIMARY KEY,
+        tf_vector TEXT NOT NULL,
+        magnitude REAL NOT NULL DEFAULT 0,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS stats (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    }
+    indexFile(path, content) {
+        const tokens = tokenize(content);
+        if (tokens.length === 0) {
+            this.removeFromIndex(path);
+            return;
+        }
+        const totalWords = tokens.length;
+        const termCounts = new Map();
+        for (const token of tokens) {
+            termCounts.set(token, (termCounts.get(token) ?? 0) + 1);
+        }
+        // Build raw TF vector (count / total_words)
+        const tfVector = {};
+        for (const [term, count] of termCounts) {
+            tfVector[term] = count / totalWords;
+        }
+        const now = Date.now();
+        const txn = this.db.transaction(() => {
+            // Check if document already exists — need to decrement old vocab counts
+            const existing = this.db.prepare('SELECT tf_vector FROM documents WHERE path = ?').get(path);
+            if (existing) {
+                const oldVector = JSON.parse(existing.tf_vector);
+                for (const term of Object.keys(oldVector)) {
+                    this.db.prepare('UPDATE vocabulary SET doc_count = MAX(doc_count - 1, 0) WHERE term = ?').run(term);
+                }
+            }
+            // Update vocabulary with new term counts
+            const upsertVocab = this.db.prepare(`
+        INSERT INTO vocabulary (term, idf, doc_count) VALUES (?, 0, 1)
+        ON CONFLICT(term) DO UPDATE SET doc_count = doc_count + 1
+      `);
+            for (const term of termCounts.keys()) {
+                upsertVocab.run(term);
+            }
+            // Store document (magnitude will be recomputed during recomputeIdf)
+            this.db.prepare('INSERT OR REPLACE INTO documents (path, tf_vector, magnitude, updated_at) VALUES (?, ?, 0, ?)').run(path, JSON.stringify(tfVector), now);
+            // Update total docs count
+            const docCount = this.db.prepare('SELECT COUNT(*) as cnt FROM documents').get();
+            this.db.prepare("INSERT OR REPLACE INTO stats (key, value) VALUES ('total_docs', ?)").run(String(docCount.cnt));
+        });
+        txn();
+    }
+    removeFromIndex(path) {
+        const txn = this.db.transaction(() => {
+            const existing = this.db.prepare('SELECT tf_vector FROM documents WHERE path = ?').get(path);
+            if (existing) {
+                const oldVector = JSON.parse(existing.tf_vector);
+                for (const term of Object.keys(oldVector)) {
+                    this.db.prepare('UPDATE vocabulary SET doc_count = MAX(doc_count - 1, 0) WHERE term = ?').run(term);
+                }
+                this.db.prepare('DELETE FROM documents WHERE path = ?').run(path);
+                // Clean up zero-count vocabulary entries
+                this.db.prepare('DELETE FROM vocabulary WHERE doc_count <= 0').run();
+                // Update total docs count
+                const docCount = this.db.prepare('SELECT COUNT(*) as cnt FROM documents').get();
+                this.db.prepare("INSERT OR REPLACE INTO stats (key, value) VALUES ('total_docs', ?)").run(String(docCount.cnt));
+            }
+        });
+        txn();
+    }
+    recomputeIdf() {
+        const txn = this.db.transaction(() => {
+            const statsRow = this.db.prepare("SELECT value FROM stats WHERE key = 'total_docs'").get();
+            const totalDocs = statsRow ? parseInt(statsRow.value, 10) : 0;
+            if (totalDocs === 0)
+                return;
+            // Update IDF for all terms: log(1 + N / (1 + df))
+            this.db.prepare('UPDATE vocabulary SET idf = ln(1.0 + CAST(? AS REAL) / (1.0 + doc_count))').run(totalDocs);
+            // Load all IDF values into memory for vector recomputation
+            const vocabRows = this.db.prepare('SELECT term, idf FROM vocabulary').all();
+            const idfMap = new Map();
+            for (const row of vocabRows) {
+                idfMap.set(row.term, row.idf);
+            }
+            // Recompute TF-IDF vectors and magnitudes for all documents
+            const docs = this.db.prepare('SELECT path, tf_vector FROM documents').all();
+            const updateDoc = this.db.prepare('UPDATE documents SET tf_vector = ?, magnitude = ? WHERE path = ?');
+            for (const doc of docs) {
+                const rawTf = JSON.parse(doc.tf_vector);
+                const tfidfVector = {};
+                let magnitudeSq = 0;
+                for (const [term, tf] of Object.entries(rawTf)) {
+                    const idf = idfMap.get(term) ?? 0;
+                    const tfidf = tf * idf;
+                    if (tfidf > 0) {
+                        tfidfVector[term] = tfidf;
+                        magnitudeSq += tfidf * tfidf;
+                    }
+                }
+                const magnitude = Math.sqrt(magnitudeSq);
+                updateDoc.run(JSON.stringify(tfidfVector), magnitude, doc.path);
+            }
+        });
+        txn();
+    }
+    search(query, limit = 10) {
+        const tokens = tokenize(query);
+        if (tokens.length === 0)
+            return [];
+        // Build query term frequencies
+        const totalWords = tokens.length;
+        const termCounts = new Map();
+        for (const token of tokens) {
+            termCounts.set(token, (termCounts.get(token) ?? 0) + 1);
+        }
+        // Load IDF values for query terms
+        const placeholders = Array.from(termCounts.keys())
+            .map(() => '?')
+            .join(', ');
+        const vocabRows = this.db
+            .prepare(`SELECT term, idf FROM vocabulary WHERE term IN (${placeholders})`)
+            .all(...termCounts.keys());
+        const idfMap = new Map();
+        for (const row of vocabRows) {
+            idfMap.set(row.term, row.idf);
+        }
+        // Build query TF-IDF vector
+        const queryVector = {};
+        let queryMagSq = 0;
+        for (const [term, count] of termCounts) {
+            const tf = count / totalWords;
+            const idf = idfMap.get(term) ?? 0;
+            const tfidf = tf * idf;
+            if (tfidf > 0) {
+                queryVector[term] = tfidf;
+                queryMagSq += tfidf * tfidf;
+            }
+        }
+        const queryMag = Math.sqrt(queryMagSq);
+        if (queryMag === 0)
+            return [];
+        // Load all documents and compute cosine similarity
+        const docs = this.db
+            .prepare('SELECT path, tf_vector, magnitude FROM documents')
+            .all();
+        const results = [];
+        for (const doc of docs) {
+            if (doc.magnitude === 0)
+                continue;
+            const docVector = JSON.parse(doc.tf_vector);
+            // Compute dot product (only iterate over query terms since they're sparse)
+            let dot = 0;
+            for (const [term, qVal] of Object.entries(queryVector)) {
+                const dVal = docVector[term];
+                if (dVal !== undefined) {
+                    dot += qVal * dVal;
+                }
+            }
+            if (dot > 0) {
+                const similarity = dot / (queryMag * doc.magnitude);
+                results.push({ path: doc.path, score: similarity });
+            }
+        }
+        // Sort by score descending, take top-k
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    async rebuildIndex(vaultPath) {
+        this.db.exec('DELETE FROM documents');
+        this.db.exec('DELETE FROM vocabulary');
+        this.db.exec('DELETE FROM stats');
+        const mdFiles = await this.collectMdFiles(vaultPath, vaultPath);
+        for (const filePath of mdFiles) {
+            const content = await readFile(join(vaultPath, filePath), 'utf-8');
+            this.indexFile(filePath, content);
+        }
+        this.recomputeIdf();
+    }
+    close() {
+        this.db.close();
+    }
+    async collectMdFiles(dir, basePath) {
+        const results = [];
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return results;
+        }
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                const sub = await this.collectMdFiles(fullPath, basePath);
+                results.push(...sub);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                results.push(relative(basePath, fullPath));
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/src/mcp/embeddings.js.map

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

package/dist/src/mcp/index.d.ts

@@ -0,0 +1,10 @@
+export { SearchIndex } from './search.js';
+export type { SearchResult } from './search.js';
+export { VectorIndex } from './embeddings.js';
+export type { VectorSearchResult } from './embeddings.js';
+export { hybridSearch } from './rerank.js';
+export type { MergedResult } from './rerank.js';
+export { createMcpServer, startMcpServer } from './server.js';
+export type { McpServerOptions } from './server.js';
+export { matchesScope, hasPermission, requiredPermission, extractFilePath } from './scope.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/mcp/index.js

@@ -0,0 +1,6 @@
+export { SearchIndex } from './search.js';
+export { VectorIndex } from './embeddings.js';
+export { hybridSearch } from './rerank.js';
+export { createMcpServer, startMcpServer } from './server.js';
+export { matchesScope, hasPermission, requiredPermission, extractFilePath } from './scope.js';
+//# sourceMappingURL=index.js.map

package/dist/src/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/mcp/rerank.d.ts

@@ -0,0 +1,14 @@
+import type { SearchResult } from './search.js';
+import type { VectorSearchResult } from './embeddings.js';
+export interface MergedResult {
+    path: string;
+    score: number;
+    snippet?: string;
+    sources: ('bm25' | 'vector')[];
+}
+export declare function hybridSearch(bm25Results: SearchResult[], vectorResults: VectorSearchResult[], opts?: {
+    bm25Weight?: number;
+    vectorWeight?: number;
+    k?: number;
+}): MergedResult[];
+//# sourceMappingURL=rerank.d.ts.map

package/dist/src/mcp/rerank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.d.ts","sourceRoot":"","sources":["../../../src/mcp/rerank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;CAChC;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,YAAY,EAAE,EAC3B,aAAa,EAAE,kBAAkB,EAAE,EACnC,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,YAAY,EAAE,CA+ChB"}

package/dist/src/mcp/rerank.js

@@ -0,0 +1,47 @@
+export function hybridSearch(bm25Results, vectorResults, opts) {
+    const bm25Weight = opts?.bm25Weight ?? 1.0;
+    const vectorWeight = opts?.vectorWeight ?? 1.0;
+    const k = opts?.k ?? 60;
+    const merged = new Map();
+    // Process BM25 results
+    for (let rank = 0; rank < bm25Results.length; rank++) {
+        const r = bm25Results[rank];
+        const rrfScore = bm25Weight * (1 / (k + rank + 1));
+        const existing = merged.get(r.path);
+        if (existing) {
+            existing.score += rrfScore;
+            existing.snippet = existing.snippet ?? r.snippet;
+            existing.sources.push('bm25');
+        }
+        else {
+            merged.set(r.path, {
+                path: r.path,
+                score: rrfScore,
+                snippet: r.snippet,
+                sources: ['bm25'],
+            });
+        }
+    }
+    // Process vector results
+    for (let rank = 0; rank < vectorResults.length; rank++) {
+        const r = vectorResults[rank];
+        const rrfScore = vectorWeight * (1 / (k + rank + 1));
+        const existing = merged.get(r.path);
+        if (existing) {
+            existing.score += rrfScore;
+            existing.sources.push('vector');
+        }
+        else {
+            merged.set(r.path, {
+                path: r.path,
+                score: rrfScore,
+                sources: ['vector'],
+            });
+        }
+    }
+    // Sort by combined score descending
+    const results = Array.from(merged.values());
+    results.sort((a, b) => b.score - a.score);
+    return results;
+}
+//# sourceMappingURL=rerank.js.map

package/dist/src/mcp/rerank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../../../src/mcp/rerank.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAC1B,WAA2B,EAC3B,aAAmC,EACnC,IAAiE;IAEjE,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,GAAG,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,GAAG,CAAC;IAC/C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE/C,uBAAuB;IACvB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC;YAC3B,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC;YACjD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;gBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,MAAM,CAAC;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC;YAC3B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;gBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,CAAC,QAAQ,CAAC;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/mcp/scope.d.ts

@@ -0,0 +1,26 @@
+import type { ApiPermission } from '../types.js';
+/**
+ * Check if a file path matches a scope pattern.
+ * Scopes use glob-like patterns:
+ * - "*" matches everything
+ * - "skills/*" matches paths starting with "skills/" or containing "/skills/"
+ * - "memories/*" matches paths containing "memory/" or ending with "MEMORY.md"
+ * - Multiple scopes comma-separated: "skills/*,memories/*"
+ */
+export declare function matchesScope(filePath: string, scope: string): boolean;
+/**
+ * Check if a permission level satisfies a required permission.
+ * "read-write" satisfies both "read" and "read-write" requirements.
+ * "read" only satisfies "read" requirements.
+ */
+export declare function hasPermission(granted: ApiPermission, required: ApiPermission): boolean;
+/**
+ * Determine the required permission for a tool name.
+ */
+export declare function requiredPermission(toolName: string): ApiPermission;
+/**
+ * Extract the file path that a tool invocation accesses.
+ * Returns null if the tool doesn't access a specific file (e.g., list-skills, search-memory).
+ */
+export declare function extractFilePath(toolName: string, args: Record<string, unknown>): string | null;
+//# sourceMappingURL=scope.d.ts.map

package/dist/src/mcp/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/mcp/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAkCrE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAGlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAWf"}

package/dist/src/mcp/scope.js

@@ -0,0 +1,71 @@
+/**
+ * Check if a file path matches a scope pattern.
+ * Scopes use glob-like patterns:
+ * - "*" matches everything
+ * - "skills/*" matches paths starting with "skills/" or containing "/skills/"
+ * - "memories/*" matches paths containing "memory/" or ending with "MEMORY.md"
+ * - Multiple scopes comma-separated: "skills/*,memories/*"
+ */
+export function matchesScope(filePath, scope) {
+    if (!scope || scope.trim() === '')
+        return false;
+    const patterns = scope.split(',').map((s) => s.trim()).filter(Boolean);
+    for (const pattern of patterns) {
+        if (pattern === '*')
+            return true;
+        // Strip trailing "/*" or "/" to get the prefix
+        const prefix = pattern.replace(/\/\*$/, '').replace(/\/$/, '');
+        if (prefix === 'memories') {
+            // Special case: "memories/*" matches memory-related paths
+            if (filePath.includes('memory/') ||
+                filePath.includes('memory\\') ||
+                filePath.endsWith('MEMORY.md')) {
+                return true;
+            }
+        }
+        // Direct prefix match: "skills/*" matches "skills/my-skill/SKILL.md"
+        if (filePath.startsWith(prefix + '/') || filePath === prefix) {
+            return true;
+        }
+        // Also match nested paths: "openclaw/skills/..." matches "skills/*"
+        if (filePath.includes('/' + prefix + '/')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a permission level satisfies a required permission.
+ * "read-write" satisfies both "read" and "read-write" requirements.
+ * "read" only satisfies "read" requirements.
+ */
+export function hasPermission(granted, required) {
+    if (required === 'read')
+        return true; // both 'read' and 'read-write' satisfy 'read'
+    return granted === 'read-write';
+}
+/**
+ * Determine the required permission for a tool name.
+ */
+export function requiredPermission(toolName) {
+    if (toolName === 'write-memory')
+        return 'read-write';
+    return 'read';
+}
+/**
+ * Extract the file path that a tool invocation accesses.
+ * Returns null if the tool doesn't access a specific file (e.g., list-skills, search-memory).
+ */
+export function extractFilePath(toolName, args) {
+    switch (toolName) {
+        case 'read-memory':
+            return args.file ?? null;
+        case 'write-memory':
+            return args.file ?? null;
+        case 'read-skill':
+            return args.skill ? `skills/${args.skill}/SKILL.md` : null;
+        default:
+            return null; // list/search tools don't target specific files
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/src/mcp/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/mcp/scope.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAa;IAC1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAEjC,+CAA+C;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE/D,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,0DAA0D;YAC1D,IACE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC5B,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC7B,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC9B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oEAAoE;QACpE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAsB,EACtB,QAAuB;IAEvB,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,8CAA8C;IACpF,OAAO,OAAO,KAAK,YAAY,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,QAAQ,KAAK,cAAc;QAAE,OAAO,YAAY,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAA6B;IAE7B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa;YAChB,OAAQ,IAAI,CAAC,IAAe,IAAI,IAAI,CAAC;QACvC,KAAK,cAAc;YACjB,OAAQ,IAAI,CAAC,IAAe,IAAI,IAAI,CAAC;QACvC,KAAK,YAAY;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D;YACE,OAAO,IAAI,CAAC,CAAC,gDAAgD;IACjE,CAAC;AACH,CAAC"}

package/dist/src/mcp/search.d.ts

@@ -0,0 +1,18 @@
+export interface SearchResult {
+    path: string;
+    snippet: string;
+    score: number;
+}
+export declare class SearchIndex {
+    private db;
+    constructor(dbPath: string);
+    indexFile(path: string, content: string): void;
+    removeFromIndex(path: string): void;
+    search(query: string, limit?: number): SearchResult[];
+    rebuildIndex(vaultPath: string): Promise<void>;
+    getIndexedFiles(): string[];
+    close(): void;
+    private sanitizeQuery;
+    private collectMdFiles;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/src/mcp/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAiB1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY9C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,YAAY,EAAE;IA4BnD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD,eAAe,IAAI,MAAM,EAAE;IAO3B,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,aAAa;YAUP,cAAc;CAqB7B"}