n2-qln 3.4.2 → 4.1.1

package/{lib → dist/lib}/registry.js

@@ -1,23 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Registry = void 0;
 // QLN — L2 tool index (memory cache + SQLite persistence)
 // Tool CRUD, batch registration, embedding precomputation, usage tracking
-const { createToolEntry, buildSearchText } = require('./schema');
-
+const schema_1 = require("./schema");
 /**
  * Tool registry — in-memory cache (Map) + SQLite persistence.
  * Designed for up to 1000 tools.
  */
 class Registry {
-    /**
-     * @param {import('./store').Store} store - SQLite store
-     * @param {import('./embedding').Embedding} [embedding] - Embedding engine (optional)
-     */
+    _store;
+    _embedding;
+    _cache;
     constructor(store, embedding = null) {
         this._store = store;
         this._embedding = embedding;
-        /** @type {Map<string, object>} name → tool entry */
         this._cache = new Map();
     }
-
     /** Load all entries from SQLite into memory cache */
     load() {
         this._cache.clear();
@@ -26,16 +25,12 @@ class Registry {
             this._cache.set(row.name, this._rowToEntry(row));
         }
     }
-
     // ── CRUD ──
-
     /**
      * Register a tool (update if exists, preserve existing stats).
-     * @param {object} raw - Raw tool data
-     * @returns {object} Normalized tool entry
      */
     register(raw) {
-        const entry = createToolEntry(raw);
+        const entry = (0, schema_1.createToolEntry)(raw);
         const existing = this._cache.get(entry.name);
         if (existing) {
             entry.usageCount = existing.usageCount || entry.usageCount;
@@ -44,128 +39,129 @@ class Registry {
                 entry.embedding = existing.embedding;
             }
         }
-        entry.searchText = buildSearchText(entry);
+        entry.searchText = (0, schema_1.buildSearchText)(entry);
         this._cache.set(entry.name, entry);
         this._store.upsert(entry);
         return entry;
     }
-
-    /**
-     * Batch register tools.
-     * @param {object[]} tools
-     * @returns {number} Number of registered tools
-     */
+    /** Batch register tools (single disk write at the end). */
     registerBatch(tools) {
+        this._store.beginBatch();
         let count = 0;
-        for (const raw of tools) {
-            try { this.register(raw); count++; }
-            catch { /* skip invalid */ }
+        try {
+            for (const raw of tools) {
+                try {
+                    this.register(raw);
+                    count++;
+                }
+                catch { /* skip invalid */ }
+            }
+        }
+        finally {
+            this._store.endBatch();
         }
         return count;
     }
-
-    /**
-     * Remove a tool.
-     * @param {string} name
-     * @returns {boolean}
-     */
+    /** Remove a tool. */
     remove(name) {
         const had = this._cache.has(name);
         this._cache.delete(name);
-        if (had) this._store.remove(name);
+        if (had)
+            this._store.remove(name);
         return had;
     }
-
-    /**
-     * Purge all tools by source (for re-sync).
-     * @param {string} source
-     * @returns {number} Number deleted
-     */
+    /** Purge all tools by source (for re-sync). */
     purgeBySource(source) {
-        let deleted = 0;
+        const toDelete = [];
         for (const [name, entry] of this._cache) {
-            if (entry.source === source) {
-                this._cache.delete(name);
-                deleted++;
-            }
+            if (entry.source === source)
+                toDelete.push(name);
         }
+        for (const name of toDelete)
+            this._cache.delete(name);
         this._store.purgeBySource(source);
-        return deleted;
-    }
-
-    /** @param {string} name @returns {object|null} */
-    get(name) { return this._cache.get(name) || null; }
-
-    /** @returns {object[]} */
-    getAll() { return Array.from(this._cache.values()); }
-
-    /** @returns {number} */
-    get size() { return this._cache.size; }
-
-    /**
-     * Remove all tools by provider name.
-     * @param {string} providerName
-     * @returns {number} Number of tools removed
-     */
+        return toDelete.length;
+    }
+    get(name) {
+        return this._cache.get(name) || null;
+    }
+    getAll() {
+        return Array.from(this._cache.values());
+    }
+    get size() {
+        return this._cache.size;
+    }
+    /** Remove all tools by provider name. */
     removeByProvider(providerName) {
         const toRemove = [];
         for (const [name, entry] of this._cache) {
-            if (entry.provider === providerName) toRemove.push(name);
+            if (entry.provider === providerName)
+                toRemove.push(name);
         }
         for (const name of toRemove) {
             this.remove(name);
         }
         return toRemove.length;
     }
-
     // ── Embeddings ──
-
-    /**
-     * Precompute embeddings for tools without one.
-     * @returns {Promise<{embedded: number, skipped: number, failed: number}>}
-     */
+    /** Precompute embeddings for tools without one (single disk write). */
     async precomputeEmbeddings() {
-        if (!this._embedding) return { embedded: 0, skipped: 0, failed: 0 };
+        if (!this._embedding)
+            return { embedded: 0, skipped: 0, failed: 0 };
         const available = await this._embedding.isAvailable();
-        if (!available) return { embedded: 0, skipped: 0, failed: 0 };
-
+        if (!available)
+            return { embedded: 0, skipped: 0, failed: 0 };
+        this._store.beginBatch();
         let embedded = 0, skipped = 0, failed = 0;
-        for (const [, entry] of this._cache) {
-            if (entry.embedding) { skipped++; continue; }
-            try {
-                const text = entry.searchText || buildSearchText(entry);
-                const vec = await this._embedding.embed(text);
-                if (vec.length > 0) {
-                    entry.embedding = vec;
-                    this._store.upsert(entry);
-                    embedded++;
-                } else { failed++; }
-            } catch { failed++; }
+        try {
+            for (const [, entry] of this._cache) {
+                if (entry.embedding) {
+                    skipped++;
+                    continue;
+                }
+                try {
+                    const text = entry.searchText || (0, schema_1.buildSearchText)(entry);
+                    const vec = await this._embedding.embed(text);
+                    if (vec.length > 0) {
+                        entry.embedding = vec;
+                        this._store.upsert(entry);
+                        embedded++;
+                    }
+                    else {
+                        failed++;
+                    }
+                }
+                catch {
+                    failed++;
+                }
+            }
+        }
+        finally {
+            this._store.endBatch();
         }
         return { embedded, skipped, failed };
     }
-
     // ── Usage tracking ──
-
-    /**
-     * Record tool usage.
-     * @param {string} name
-     * @param {boolean} success
-     */
+    /** Record tool usage + circuit breaker state. */
     recordUsage(name, success = true) {
         const entry = this._cache.get(name);
-        if (!entry) return;
+        if (!entry)
+            return;
         entry.usageCount++;
         entry.lastUsedAt = new Date().toISOString();
         const alpha = 0.1;
         entry.successRate = entry.successRate * (1 - alpha) + (success ? 1 : 0) * alpha;
+        // Circuit breaker tracking
+        if (success) {
+            entry.consecutiveFailures = 0;
+        }
+        else {
+            entry.consecutiveFailures = (entry.consecutiveFailures || 0) + 1;
+        }
         entry.updatedAt = new Date().toISOString();
         this._store.upsert(entry);
     }
-
     // ── Stats ──
-
-    /** @returns {object} */
     stats() {
         const bySource = {};
         const byCategory = {};
@@ -173,7 +169,8 @@ class Registry {
         for (const entry of this._cache.values()) {
             bySource[entry.source] = (bySource[entry.source] || 0) + 1;
             byCategory[entry.category] = (byCategory[entry.category] || 0) + 1;
-            if (entry.embedding) withEmbedding++;
+            if (entry.embedding)
+                withEmbedding++;
         }
         return {
             total: this._cache.size,
@@ -184,13 +181,11 @@ class Registry {
                 ? Math.round((withEmbedding / this._cache.size) * 100) + '%' : '0%',
         };
     }
-
     // ── Internal ──
-
     /** Convert SQLite row to tool entry */
     _rowToEntry(row) {
         return {
-            name: row.name,
+            name: row.name || '',
             description: row.description || '',
             source: row.source || 'unknown',
             category: row.category || 'misc',
@@ -201,19 +196,26 @@ class Registry {
             examples: _parseJson(row.examples, []),
             endpoint: row.endpoint || '',
             searchText: row.search_text || '',
+            boostKeywords: row.boost_keywords || '',
             embedding: _parseJson(row.embedding, null),
             usageCount: row.usage_count || 0,
             successRate: row.success_rate ?? 1.0,
+            consecutiveFailures: row.consecutive_failures || 0,
             lastUsedAt: row.last_used_at || null,
-            registeredAt: row.registered_at,
-            updatedAt: row.updated_at,
+            registeredAt: row.registered_at || '',
+            updatedAt: row.updated_at || '',
         };
     }
 }
-
+exports.Registry = Registry;
 function _parseJson(str, fallback) {
-    if (!str || str === '') return fallback;
-    try { return JSON.parse(str); } catch { return fallback; }
+    if (!str || str === '')
+        return fallback;
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return fallback;
+    }
 }
-
-module.exports = { Registry };
+//# sourceMappingURL=registry.js.map

package/dist/lib/registry.js.map

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

package/dist/lib/router.d.ts

@@ -0,0 +1,63 @@
+import type { Registry } from './registry';
+import type { VectorIndex } from './vector-index';
+import type { Embedding } from './embedding';
+import type { SearchResult, SearchTiming, RouterStats } from '../types';
+/**
+ * 3-Stage search engine.
+ *
+ * Score formula:
+ *   final = (trigger×3.0 + bm25_keyword×1.0 + semantic×2.0
+ *         + log2(usageCount+1)×0.5 + successRate×1.0) × sourceWeight
+ */
+export declare class Router {
+    private _registry;
+    private _vectorIndex;
+    private _embedding;
+    private _k1;
+    private _b;
+    private _idfCache;
+    private _avgDocLen;
+    private _idfDirty;
+    private _sourceWeights;
+    constructor(registry: Registry, vectorIndex: VectorIndex, embedding?: Embedding | null, sourceWeights?: Record<string, number>);
+    /**
+     * Route natural language query to tools.
+     */
+    route(query: string, options?: {
+        topK?: number;
+        threshold?: number;
+    }): Promise<{
+        results: SearchResult[];
+        timing: SearchTiming;
+    }>;
+    /** Stage 1: Trigger word exact match. Weight: 3.0 */
+    private _stage1TriggerMatch;
+    /** Stage 2: BM25 keyword search. Weight: 1.0 */
+    private _stage2BM25;
+    /** Calculate BM25 score for a query against a document. */
+    private _bm25Score;
+    /**
+     * Build IDF cache from all registered tools.
+     * IDF(term) = ln((N - n(t) + 0.5) / (n(t) + 0.5) + 1)
+     */
+    private _buildIDF;
+    /** Tokenize query string into search terms. */
+    private _tokenize;
+    /** Stage 3: Semantic vector search. Weight: 2.0 */
+    private _stage3SemanticSearch;
+    /** Merge all stage results + usage/success bonus + recency decay → ranking */
+    private _mergeAndRank;
+    /** 5% Explorer: append least-used tool as bonus slot (never replaces regular results) */
+    private _injectExplorer;
+    /** Build vector index and refresh IDF cache */
+    buildIndex(): {
+        indexed: number;
+        categories: number;
+        dimension: number;
+    };
+    /** Mark IDF cache as dirty (call after tool registration changes) */
+    invalidateIDF(): void;
+    private _getOrCreate;
+    stats(): RouterStats;
+}
+//# sourceMappingURL=router.d.ts.map