@ekkos/mcp-server 2.0.3 → 2.0.4

package/dist/local-cache.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Local Pattern Cache for ekkOS MCP Server
+ *
+ * Provides <2ms local-first search via SQLite FTS5 (with BM25 relevance ranking)
+ * with automatic fallback to the original JSON + in-memory Map approach when
+ * better-sqlite3 is unavailable (e.g. missing native build tools).
+ *
+ * SQLite backend (preferred):
+ *   - DB at ~/.ekkos/cache/patterns.db
+ *   - patterns table  + patterns_fts virtual table (FTS5, BM25 ranking)
+ *   - directives table
+ *
+ * JSON fallback (when SQLite unavailable):
+ *   - Disk file at ~/.ekkos/cache/patterns.json
+ *   - In-memory Map + array for sub-millisecond reads
+ *
+ * Public API is identical between both backends — callers in index.ts need
+ * no changes.
+ */
+export interface CachedPattern {
+    id: string;
+    title: string;
+    similarity?: number;
+    success_rate: number | null;
+    applied_count: number;
+    tags?: string[];
+    content?: string;
+    updated_at?: string;
+}
+export interface CachedDirective {
+    id: string;
+    type: string;
+    rule: string;
+    context?: string;
+}
+/**
+ * Initialise cache from persistent storage on startup.
+ * SQLite: the DB file is already open — just read counts and restore warmed_at.
+ * JSON fallback: deserialise patterns.json into the in-memory Map.
+ */
+export declare function loadCacheFromDisk(): {
+    patterns: number;
+    directives: number;
+};
+/**
+ * Warm cache from the /api/v1/warmup bundle endpoint (non-blocking).
+ *
+ * A single HTTP GET replaces the previous multi-step ekkOS_Search approach,
+ * returning top patterns + directives + project patterns in one response.
+ *
+ * With SQLite backend, data is written into patterns / directives tables and
+ * FTS index is updated automatically via triggers.
+ *
+ * With JSON fallback, data is written to the in-memory Map and then flushed
+ * to disk as patterns.json.
+ */
+export declare function warmCache(_callGateway: (endpoint: string, method: string, params?: any) => Promise<any>, userId: string, options?: {
+    apiKey?: string;
+    baseUrl?: string;
+    projectId?: string;
+}): Promise<void>;
+/**
+ * Search local cache by query string.
+ *
+ * SQLite backend: FTS5 MATCH with bm25() ranking — proper relevance scoring,
+ * sub-2ms on typical pattern sets.
+ *
+ * JSON fallback: simple term-frequency scoring on title + tags + content.
+ */
+export declare function searchLocal(query: string, limit?: number): CachedPattern[];
+/**
+ * Return all cached active directives.
+ */
+export declare function getDirectives(): CachedDirective[];
+export declare function isCacheStale(): boolean;
+export declare function hasCacheData(): boolean;
+/**
+ * Mark cache as stale — next search will trigger a background re-warm.
+ * Does NOT delete SQLite data (that would remove offline fallback data).
+ */
+export declare function invalidateCache(): void;
+export declare function startPeriodicRefresh(callGateway: (endpoint: string, method: string, params?: any) => Promise<any>, userId: string): void;
+export declare function getCacheStats(): {
+    patterns: number;
+    directives: number;
+    age_ms: number;
+    stale: boolean;
+    backend: 'sqlite' | 'json';
+};
+//# sourceMappingURL=local-cache.d.ts.map

package/dist/local-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-cache.d.ts","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiBH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8LD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA2C5E;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAC9E,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,IAAI,CAAC,CAsKf;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,aAAa,EAAE,CAgE7E;AAID;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,EAAE,CAWjD;AAID,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAID,wBAAgB,YAAY,IAAI,OAAO,CAUtC;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAID,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAC7E,MAAM,EAAE,MAAM,GACb,IAAI,CAMN;AAID,wBAAgB,aAAa,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,CAuBpI"}

package/dist/local-cache.js

@@ -0,0 +1,525 @@
+/**
+ * Local Pattern Cache for ekkOS MCP Server
+ *
+ * Provides <2ms local-first search via SQLite FTS5 (with BM25 relevance ranking)
+ * with automatic fallback to the original JSON + in-memory Map approach when
+ * better-sqlite3 is unavailable (e.g. missing native build tools).
+ *
+ * SQLite backend (preferred):
+ *   - DB at ~/.ekkos/cache/patterns.db
+ *   - patterns table  + patterns_fts virtual table (FTS5, BM25 ranking)
+ *   - directives table
+ *
+ * JSON fallback (when SQLite unavailable):
+ *   - Disk file at ~/.ekkos/cache/patterns.json
+ *   - In-memory Map + array for sub-millisecond reads
+ *
+ * Public API is identical between both backends — callers in index.ts need
+ * no changes.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createRequire } from 'module';
+// ─── Paths ────────────────────────────────────────────────────────────────────
+const CACHE_DIR = join(homedir(), '.ekkos', 'cache');
+const CACHE_FILE = join(CACHE_DIR, 'patterns.json'); // JSON fallback
+const SQLITE_DB_FILE = join(CACHE_DIR, 'patterns.db'); // SQLite primary
+const CACHE_MAX_AGE_MS = 5 * 60 * 1000; // 5 minutes
+const REFRESH_INTERVAL_MS = 5 * 60 * 1000;
+let db = null;
+try {
+    const _require = createRequire(import.meta.url);
+    const BetterSqlite3 = _require('better-sqlite3');
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    db = new BetterSqlite3(SQLITE_DB_FILE);
+    // WAL mode: concurrent reads, fast writes
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    // Canonical storage table
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS patterns (
+      rowid       INTEGER PRIMARY KEY AUTOINCREMENT,
+      pattern_id  TEXT UNIQUE NOT NULL,
+      title       TEXT NOT NULL DEFAULT '',
+      problem     TEXT NOT NULL DEFAULT '',
+      solution    TEXT NOT NULL DEFAULT '',
+      tags        TEXT NOT NULL DEFAULT '',
+      success_rate REAL,
+      layer       TEXT NOT NULL DEFAULT '',
+      updated_at  TEXT,
+      full_json   TEXT NOT NULL
+    );
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS patterns_fts USING fts5(
+      pattern_id UNINDEXED,
+      title,
+      problem,
+      solution,
+      tags,
+      content='patterns',
+      content_rowid='rowid'
+    );
+
+    -- Keep FTS in sync via triggers
+    CREATE TRIGGER IF NOT EXISTS patterns_ai
+      AFTER INSERT ON patterns BEGIN
+        INSERT INTO patterns_fts(rowid, pattern_id, title, problem, solution, tags)
+        VALUES (new.rowid, new.pattern_id, new.title, new.problem, new.solution, new.tags);
+      END;
+
+    CREATE TRIGGER IF NOT EXISTS patterns_ad
+      AFTER DELETE ON patterns BEGIN
+        INSERT INTO patterns_fts(patterns_fts, rowid, pattern_id, title, problem, solution, tags)
+        VALUES ('delete', old.rowid, old.pattern_id, old.title, old.problem, old.solution, old.tags);
+      END;
+
+    CREATE TRIGGER IF NOT EXISTS patterns_au
+      AFTER UPDATE ON patterns BEGIN
+        INSERT INTO patterns_fts(patterns_fts, rowid, pattern_id, title, problem, solution, tags)
+        VALUES ('delete', old.rowid, old.pattern_id, old.title, old.problem, old.solution, old.tags);
+        INSERT INTO patterns_fts(rowid, pattern_id, title, problem, solution, tags)
+        VALUES (new.rowid, new.pattern_id, new.title, new.problem, new.solution, new.tags);
+      END;
+
+    CREATE TABLE IF NOT EXISTS directives (
+      id       TEXT PRIMARY KEY,
+      type     TEXT NOT NULL DEFAULT 'PREFER',
+      rule     TEXT NOT NULL DEFAULT '',
+      scope    TEXT,
+      is_active INTEGER NOT NULL DEFAULT 1,
+      full_json TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS cache_meta (
+      key   TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+  `);
+    console.error('[ekkOS:cache] SQLite FTS5 backend initialised at', SQLITE_DB_FILE);
+}
+catch (err) {
+    db = null;
+    console.error('[ekkOS:cache] SQLite unavailable — using JSON fallback:', err.message);
+}
+// ─── FTS5 query sanitiser ─────────────────────────────────────────────────────
+// FTS5 treats special characters (", *, :, ^, etc.) as operators.  We quote
+// each whitespace-separated token individually so arbitrary user queries don't
+// cause a parse error.
+function sanitizeFTS5Query(query) {
+    return query
+        .trim()
+        .split(/\s+/)
+        .filter(t => t.length > 0)
+        .map(t => `"${t.replace(/"/g, '""')}"`) // escape internal quotes
+        .join(' '); // implicit AND between tokens
+}
+// ─── SQLite helper: upsert a single pattern ───────────────────────────────────
+function sqliteUpsertPattern(p) {
+    if (!db)
+        return;
+    const tagsStr = (p.tags || []).join(' ');
+    // split content into problem/solution heuristically:
+    // store the full content in both fields so FTS matches either way
+    const content = p.content || '';
+    const stmt = db.prepare(`
+    INSERT INTO patterns (pattern_id, title, problem, solution, tags, success_rate, updated_at, full_json)
+    VALUES (@pattern_id, @title, @problem, @solution, @tags, @success_rate, @updated_at, @full_json)
+    ON CONFLICT(pattern_id) DO UPDATE SET
+      title        = excluded.title,
+      problem      = excluded.problem,
+      solution     = excluded.solution,
+      tags         = excluded.tags,
+      success_rate = excluded.success_rate,
+      updated_at   = excluded.updated_at,
+      full_json    = excluded.full_json
+  `);
+    stmt.run({
+        pattern_id: p.id,
+        title: p.title || '',
+        problem: content,
+        solution: content,
+        tags: tagsStr,
+        success_rate: p.success_rate ?? null,
+        updated_at: p.updated_at || null,
+        full_json: JSON.stringify(p),
+    });
+}
+// ─── SQLite helper: set cache_meta ────────────────────────────────────────────
+function sqliteSetMeta(key, value) {
+    if (!db)
+        return;
+    db.prepare(`
+    INSERT INTO cache_meta (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = excluded.value
+  `).run(key, value);
+}
+function sqliteGetMeta(key) {
+    if (!db)
+        return null;
+    const row = db.prepare('SELECT value FROM cache_meta WHERE key = ?').get(key);
+    return row ? row.value : null;
+}
+// ─── JSON fallback state ──────────────────────────────────────────────────────
+const patternMap = new Map();
+const directiveList = [];
+let cacheWarmedAt = 0;
+let isWarming = false;
+// ─── loadCacheFromDisk ────────────────────────────────────────────────────────
+/**
+ * Initialise cache from persistent storage on startup.
+ * SQLite: the DB file is already open — just read counts and restore warmed_at.
+ * JSON fallback: deserialise patterns.json into the in-memory Map.
+ */
+export function loadCacheFromDisk() {
+    if (db) {
+        // SQLite path
+        try {
+            const patCount = db.prepare('SELECT COUNT(*) as n FROM patterns').get().n;
+            const dirCount = db.prepare('SELECT COUNT(*) as n FROM directives WHERE is_active = 1').get().n;
+            const warmedAtStr = sqliteGetMeta('warmed_at');
+            if (warmedAtStr) {
+                cacheWarmedAt = new Date(warmedAtStr).getTime();
+            }
+            return { patterns: patCount, directives: dirCount };
+        }
+        catch (err) {
+            console.error('[ekkOS:cache] SQLite loadCacheFromDisk error:', err);
+            return { patterns: 0, directives: 0 };
+        }
+    }
+    // JSON fallback
+    try {
+        if (!existsSync(CACHE_FILE)) {
+            return { patterns: 0, directives: 0 };
+        }
+        const raw = readFileSync(CACHE_FILE, 'utf-8');
+        const data = JSON.parse(raw);
+        patternMap.clear();
+        directiveList.length = 0;
+        for (const p of data.patterns) {
+            patternMap.set(p.id, p);
+        }
+        for (const d of data.directives) {
+            directiveList.push(d);
+        }
+        cacheWarmedAt = new Date(data.warmed_at).getTime();
+        return { patterns: patternMap.size, directives: directiveList.length };
+    }
+    catch {
+        return { patterns: 0, directives: 0 };
+    }
+}
+// ─── saveCacheToDisk (JSON fallback only) ─────────────────────────────────────
+function saveCacheToDisk(userId) {
+    try {
+        if (!existsSync(CACHE_DIR)) {
+            mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        const data = {
+            patterns: Array.from(patternMap.values()),
+            directives: [...directiveList],
+            warmed_at: new Date().toISOString(),
+            user_id: userId,
+        };
+        writeFileSync(CACHE_FILE, JSON.stringify(data));
+    }
+    catch (err) {
+        console.error('[ekkOS:cache] Failed to save cache to disk:', err);
+    }
+}
+// ─── warmCache ────────────────────────────────────────────────────────────────
+/**
+ * Warm cache from the /api/v1/warmup bundle endpoint (non-blocking).
+ *
+ * A single HTTP GET replaces the previous multi-step ekkOS_Search approach,
+ * returning top patterns + directives + project patterns in one response.
+ *
+ * With SQLite backend, data is written into patterns / directives tables and
+ * FTS index is updated automatically via triggers.
+ *
+ * With JSON fallback, data is written to the in-memory Map and then flushed
+ * to disk as patterns.json.
+ */
+export async function warmCache(_callGateway, userId, options) {
+    if (isWarming)
+        return;
+    isWarming = true;
+    try {
+        const apiKey = options?.apiKey || process.env.EKKOS_API_KEY || '';
+        const baseUrl = (options?.baseUrl || process.env.EKKOS_MCP_URL || 'https://mcp.ekkos.dev/api/v1/mcp')
+            .replace(/\/api\/v1\/mcp.*$/, '');
+        const params = new URLSearchParams({ user_id: userId });
+        if (options?.projectId) {
+            params.set('project_id', options.projectId);
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/api/v1/warmup?${params.toString()}`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        if (!response.ok) {
+            throw new Error(`Warmup HTTP ${response.status}: ${response.statusText}`);
+        }
+        const bundle = await response.json();
+        const allPatterns = [
+            ...(Array.isArray(bundle.patterns) ? bundle.patterns : []),
+            ...(Array.isArray(bundle.project_patterns) ? bundle.project_patterns : []),
+        ];
+        if (db) {
+            // ── SQLite path ──────────────────────────────────────────────────────
+            // Upsert all patterns
+            for (const p of allPatterns) {
+                const cached = {
+                    id: p.pattern_id,
+                    title: p.title || '',
+                    success_rate: p.success_rate ?? null,
+                    applied_count: p.applied_count || 0,
+                    tags: p.tags,
+                    content: p.solution || p.content || '',
+                    updated_at: p.updated_at,
+                };
+                sqliteUpsertPattern(cached);
+            }
+            // Replace directives (delete active, re-insert)
+            if (Array.isArray(bundle.directives)) {
+                db.exec('DELETE FROM directives');
+                const insertDir = db.prepare(`
+          INSERT INTO directives (id, type, rule, scope, is_active, full_json)
+          VALUES (@id, @type, @rule, @scope, 1, @full_json)
+          ON CONFLICT(id) DO UPDATE SET
+            type      = excluded.type,
+            rule      = excluded.rule,
+            scope     = excluded.scope,
+            is_active = 1,
+            full_json = excluded.full_json
+        `);
+                for (const d of bundle.directives) {
+                    insertDir.run({
+                        id: d.id,
+                        type: d.type || 'PREFER',
+                        rule: d.rule || '',
+                        scope: d.context || null,
+                        full_json: JSON.stringify(d),
+                    });
+                }
+            }
+            sqliteSetMeta('warmed_at', new Date().toISOString());
+            cacheWarmedAt = Date.now();
+            const patCount = db.prepare('SELECT COUNT(*) as n FROM patterns').get().n;
+            const dirCount = db.prepare('SELECT COUNT(*) as n FROM directives WHERE is_active = 1').get().n;
+            console.error(`[ekkOS:cache] SQLite warmed via /api/v1/warmup: ${patCount} patterns, ${dirCount} directives` +
+                (bundle.meta?.project_pattern_count ? `, ${bundle.meta.project_pattern_count} project patterns` : ''));
+        }
+        else {
+            // ── JSON fallback path ───────────────────────────────────────────────
+            for (const p of allPatterns) {
+                patternMap.set(p.pattern_id, {
+                    id: p.pattern_id,
+                    title: p.title || '',
+                    success_rate: p.success_rate ?? null,
+                    applied_count: p.applied_count || 0,
+                    tags: p.tags,
+                    content: p.solution || p.content || '',
+                    updated_at: p.updated_at,
+                });
+            }
+            if (Array.isArray(bundle.directives)) {
+                directiveList.length = 0;
+                for (const d of bundle.directives) {
+                    directiveList.push({
+                        id: d.id,
+                        type: d.type || 'PREFER',
+                        rule: d.rule || '',
+                        context: d.context,
+                    });
+                }
+            }
+            cacheWarmedAt = Date.now();
+            saveCacheToDisk(userId);
+            console.error(`[ekkOS:cache] JSON warmed via /api/v1/warmup: ${patternMap.size} patterns, ${directiveList.length} directives` +
+                (bundle.meta?.project_pattern_count ? `, ${bundle.meta.project_pattern_count} project patterns` : ''));
+        }
+    }
+    catch (err) {
+        console.error('[ekkOS:cache] Warm failed (will use stale cache):', err);
+    }
+    finally {
+        isWarming = false;
+    }
+}
+// ─── searchLocal ──────────────────────────────────────────────────────────────
+/**
+ * Search local cache by query string.
+ *
+ * SQLite backend: FTS5 MATCH with bm25() ranking — proper relevance scoring,
+ * sub-2ms on typical pattern sets.
+ *
+ * JSON fallback: simple term-frequency scoring on title + tags + content.
+ */
+export function searchLocal(query, limit = 5) {
+    if (db) {
+        // ── SQLite / FTS5 path ───────────────────────────────────────────────
+        try {
+            const ftsQuery = sanitizeFTS5Query(query);
+            if (!ftsQuery)
+                return [];
+            const rows = db.prepare(`
+        SELECT p.full_json, bm25(patterns_fts) AS rank
+        FROM patterns_fts f
+        JOIN patterns p ON f.rowid = p.rowid
+        WHERE patterns_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `).all(ftsQuery, limit);
+            return rows.map(r => JSON.parse(r.full_json));
+        }
+        catch (err) {
+            // FTS parse error or other SQLite issue — fall through to JSON fallback
+            console.error('[ekkOS:cache] FTS5 search error, falling back to Map search:', err);
+            // Load patterns from SQLite into patternMap for fallback
+            if (patternMap.size === 0) {
+                try {
+                    const all = db.prepare('SELECT full_json FROM patterns').all();
+                    for (const row of all) {
+                        const p = JSON.parse(row.full_json);
+                        patternMap.set(p.id, p);
+                    }
+                }
+                catch {
+                    return [];
+                }
+            }
+        }
+    }
+    // ── JSON / Map fallback path ─────────────────────────────────────────────
+    if (patternMap.size === 0)
+        return [];
+    const queryLower = query.toLowerCase();
+    const queryTerms = queryLower.split(/\s+/).filter(t => t.length > 2);
+    const scored = [];
+    for (const pattern of patternMap.values()) {
+        let score = 0;
+        const titleLower = (pattern.title || '').toLowerCase();
+        const contentLower = (pattern.content || '').toLowerCase();
+        const tagsLower = (pattern.tags || []).join(' ').toLowerCase();
+        if (titleLower.includes(queryLower))
+            score += 10;
+        for (const term of queryTerms) {
+            if (titleLower.includes(term))
+                score += 3;
+            if (contentLower.includes(term))
+                score += 1;
+            if (tagsLower.includes(term))
+                score += 2;
+        }
+        if (pattern.success_rate !== null && pattern.success_rate > 0.7)
+            score += 1;
+        if (pattern.applied_count > 5)
+            score += 0.5;
+        if (score > 0)
+            scored.push({ pattern, score });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit).map(s => s.pattern);
+}
+// ─── getDirectives ────────────────────────────────────────────────────────────
+/**
+ * Return all cached active directives.
+ */
+export function getDirectives() {
+    if (db) {
+        try {
+            const rows = db.prepare('SELECT full_json FROM directives WHERE is_active = 1').all();
+            return rows.map(r => JSON.parse(r.full_json));
+        }
+        catch (err) {
+            console.error('[ekkOS:cache] getDirectives SQLite error:', err);
+            return [];
+        }
+    }
+    return [...directiveList];
+}
+// ─── isCacheStale ─────────────────────────────────────────────────────────────
+export function isCacheStale() {
+    if (cacheWarmedAt === 0)
+        return true;
+    return (Date.now() - cacheWarmedAt) > CACHE_MAX_AGE_MS;
+}
+// ─── hasCacheData ─────────────────────────────────────────────────────────────
+export function hasCacheData() {
+    if (db) {
+        try {
+            const patCount = db.prepare('SELECT COUNT(*) as n FROM patterns').get().n;
+            return patCount > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    return patternMap.size > 0 || directiveList.length > 0;
+}
+// ─── invalidateCache ─────────────────────────────────────────────────────────
+/**
+ * Mark cache as stale — next search will trigger a background re-warm.
+ * Does NOT delete SQLite data (that would remove offline fallback data).
+ */
+export function invalidateCache() {
+    cacheWarmedAt = 0;
+    if (db) {
+        try {
+            sqliteSetMeta('warmed_at', '1970-01-01T00:00:00.000Z');
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+// ─── startPeriodicRefresh ─────────────────────────────────────────────────────
+export function startPeriodicRefresh(callGateway, userId) {
+    setInterval(() => {
+        if (isCacheStale()) {
+            warmCache(callGateway, userId).catch(() => { });
+        }
+    }, REFRESH_INTERVAL_MS);
+}
+// ─── getCacheStats ────────────────────────────────────────────────────────────
+export function getCacheStats() {
+    if (db) {
+        try {
+            const patCount = db.prepare('SELECT COUNT(*) as n FROM patterns').get().n;
+            const dirCount = db.prepare('SELECT COUNT(*) as n FROM directives WHERE is_active = 1').get().n;
+            return {
+                patterns: patCount,
+                directives: dirCount,
+                age_ms: cacheWarmedAt > 0 ? Date.now() - cacheWarmedAt : -1,
+                stale: isCacheStale(),
+                backend: 'sqlite',
+            };
+        }
+        catch {
+            // fall through
+        }
+    }
+    return {
+        patterns: patternMap.size,
+        directives: directiveList.length,
+        age_ms: cacheWarmedAt > 0 ? Date.now() - cacheWarmedAt : -1,
+        stale: isCacheStale(),
+        backend: 'json',
+    };
+}
+//# sourceMappingURL=local-cache.js.map

package/dist/local-cache.js.map

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

package/dist/offline-queue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Offline Write Queue for ekkOS MCP Server
+ *
+ * When the cloud gateway is unreachable, queues write operations
+ * (Forge, Track, Outcome, Directive) to a local JSONL file.
+ * Flushes the queue when connectivity is restored.
+ */
+/**
+ * Check if a tool is a write operation that can be queued
+ */
+export declare function isWriteTool(toolName: string): boolean;
+/**
+ * Queue a write operation for later execution
+ */
+export declare function queueWrite(toolName: string, args: Record<string, unknown>): void;
+/**
+ * Flush all pending writes to the cloud gateway
+ * Returns the number of successfully flushed writes
+ */
+export declare function flushQueue(callGateway: (endpoint: string, method: string, params?: any) => Promise<any>): Promise<number>;
+/**
+ * Get count of pending writes
+ */
+export declare function getPendingCount(): number;
+//# sourceMappingURL=offline-queue.d.ts.map

package/dist/offline-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-queue.d.ts","sourceRoot":"","sources":["../src/offline-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6BH;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiBhF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAC5E,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CASxC"}