nodebench-mcp 2.14.2 → 2.15.0

package/dist/tools/embeddingProvider.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Embedding Provider — True semantic search via neural embeddings.
+ *
+ * Provider fallback order:
+ * 1. Local: @huggingface/transformers + Xenova/all-MiniLM-L6-v2 (384-dim, 23MB INT8, zero API keys)
+ * 2. Google: text-embedding-004 (768-dim, free API, needs GEMINI_API_KEY)
+ * 3. OpenAI: text-embedding-3-small (1536-dim, $0.02/1M tokens, needs OPENAI_API_KEY)
+ *
+ * Graceful degradation: if no provider is available, all exports return null/false
+ * and search works exactly as before.
+ */
+export interface EmbeddingProvider {
+    name: string;
+    dimensions: number;
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+/** Node type in the bipartite graph: tool nodes vs domain (agent) nodes */
+export type GraphNodeType = "tool" | "domain";
+interface EmbeddingIndexEntry {
+    name: string;
+    vector: Float32Array;
+    /** Node type for Agent-as-a-Graph bipartite scoring */
+    nodeType: GraphNodeType;
+}
+/**
+ * Returns the best available embedding provider, or null if none is available.
+ * Tries: local HuggingFace → Google → OpenAI (in that order).
+ */
+export declare function getEmbeddingProvider(): Promise<EmbeddingProvider | null>;
+/**
+ * Pre-embed all tools at startup. Reads from cache if valid, otherwise embeds fresh.
+ * Call this once after tool assembly with a corpus of { name, text, nodeType? } entries.
+ * nodeType defaults to "tool" for backwards compatibility.
+ */
+export declare function initEmbeddingIndex(corpus: Array<{
+    name: string;
+    text: string;
+    nodeType?: GraphNodeType;
+}>): Promise<void>;
+/**
+ * Embed a single query string. Returns null if no provider is available.
+ */
+export declare function embedQuery(text: string): Promise<Float32Array | null>;
+/**
+ * Brute-force cosine KNN over the pre-computed embedding index.
+ * Returns ranked results with similarity scores and node types.
+ */
+export declare function embeddingSearch(queryVec: Float32Array, limit?: number): Array<{
+    name: string;
+    similarity: number;
+    nodeType: GraphNodeType;
+}>;
+/**
+ * Returns true when the embedding index is loaded and ready for search.
+ */
+export declare function isEmbeddingReady(): boolean;
+/**
+ * Returns the name of the active embedding provider, or null.
+ */
+export declare function getProviderName(): string | null;
+/** Reset all state — for testing only. */
+export declare function _resetForTesting(): void;
+/** Inject a mock provider — for testing only. */
+export declare function _setProviderForTesting(provider: EmbeddingProvider | null): void;
+/** Inject a pre-built index — for testing only. */
+export declare function _setIndexForTesting(index: EmbeddingIndexEntry[]): void;
+export {};

package/dist/tools/embeddingProvider.js

@@ -0,0 +1,299 @@
+/**
+ * Embedding Provider — True semantic search via neural embeddings.
+ *
+ * Provider fallback order:
+ * 1. Local: @huggingface/transformers + Xenova/all-MiniLM-L6-v2 (384-dim, 23MB INT8, zero API keys)
+ * 2. Google: text-embedding-004 (768-dim, free API, needs GEMINI_API_KEY)
+ * 3. OpenAI: text-embedding-3-small (1536-dim, $0.02/1M tokens, needs OPENAI_API_KEY)
+ *
+ * Graceful degradation: if no provider is available, all exports return null/false
+ * and search works exactly as before.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+// ── State ────────────────────────────────────────────────────────────────────
+let _provider = null;
+let _providerChecked = false;
+let _embeddingIndex = null;
+let _initPromise = null;
+const CACHE_VERSION = 1;
+const CACHE_DIR = join(homedir(), ".nodebench");
+const CACHE_FILE = join(CACHE_DIR, "embedding_cache.json");
+// ── Provider creation ────────────────────────────────────────────────────────
+async function createLocalProvider() {
+    try {
+        // Non-literal import to avoid TypeScript bundling issues with optional deps
+        const pkg = "@huggingface/transformers";
+        const mod = await import(/* @vite-ignore */ pkg);
+        const { pipeline, env } = mod;
+        // Disable remote model loading attempts in restricted environments
+        env.allowRemoteModels = true;
+        env.useBrowserCache = false;
+        const extractor = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2", {
+            quantized: true, // INT8 — 23MB vs 90MB FP32
+        });
+        return {
+            name: "local-minilm",
+            dimensions: 384,
+            embed: async (texts) => {
+                const results = [];
+                // Batch in chunks of 32 to avoid OOM on large corpora
+                for (let i = 0; i < texts.length; i += 32) {
+                    const batch = texts.slice(i, i + 32);
+                    const output = await extractor(batch, { pooling: "mean", normalize: true });
+                    for (let j = 0; j < batch.length; j++) {
+                        results.push(new Float32Array(output[j].data));
+                    }
+                }
+                return results;
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function createGoogleProvider() {
+    const apiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+    if (!apiKey)
+        return null;
+    try {
+        const { GoogleGenAI } = await import("@google/genai");
+        const ai = new GoogleGenAI({ apiKey });
+        return {
+            name: "google",
+            dimensions: 768,
+            embed: async (texts) => {
+                const results = [];
+                // Google API supports batching up to 100 texts
+                for (let i = 0; i < texts.length; i += 100) {
+                    const batch = texts.slice(i, i + 100);
+                    const response = await ai.models.embedContent({
+                        model: "text-embedding-004",
+                        contents: batch.map((t) => ({ parts: [{ text: t }] })),
+                    });
+                    const embeddings = response.embeddings ?? [];
+                    for (const emb of embeddings) {
+                        results.push(new Float32Array(emb.values));
+                    }
+                }
+                return results;
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function createOpenAIProvider() {
+    if (!process.env.OPENAI_API_KEY)
+        return null;
+    try {
+        const OpenAI = (await import("openai")).default;
+        const client = new OpenAI();
+        return {
+            name: "openai",
+            dimensions: 1536,
+            embed: async (texts) => {
+                const results = [];
+                // OpenAI supports up to 2048 inputs per request
+                for (let i = 0; i < texts.length; i += 2048) {
+                    const batch = texts.slice(i, i + 2048);
+                    const response = await client.embeddings.create({
+                        model: "text-embedding-3-small",
+                        input: batch,
+                    });
+                    for (const item of response.data) {
+                        results.push(new Float32Array(item.embedding));
+                    }
+                }
+                return results;
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Returns the best available embedding provider, or null if none is available.
+ * Tries: local HuggingFace → Google → OpenAI (in that order).
+ */
+export async function getEmbeddingProvider() {
+    if (_providerChecked)
+        return _provider;
+    _providerChecked = true;
+    _provider = await createLocalProvider();
+    if (_provider)
+        return _provider;
+    _provider = await createGoogleProvider();
+    if (_provider)
+        return _provider;
+    _provider = await createOpenAIProvider();
+    return _provider;
+}
+/**
+ * Pre-embed all tools at startup. Reads from cache if valid, otherwise embeds fresh.
+ * Call this once after tool assembly with a corpus of { name, text, nodeType? } entries.
+ * nodeType defaults to "tool" for backwards compatibility.
+ */
+export async function initEmbeddingIndex(corpus) {
+    // Prevent duplicate init
+    if (_initPromise)
+        return _initPromise;
+    _initPromise = _doInit(corpus);
+    return _initPromise;
+}
+async function _doInit(corpus) {
+    const provider = await getEmbeddingProvider();
+    if (!provider)
+        return; // No provider — semantic search stays disabled
+    const hash = fnv1aHash(corpus.map((c) => c.text).join("\n"));
+    // Try loading from cache
+    const cached = loadCache();
+    if (cached &&
+        cached.providerName === provider.name &&
+        cached.dimensions === provider.dimensions &&
+        cached.version === CACHE_VERSION &&
+        cached.toolCount === corpus.length &&
+        cached.corpusHash === hash &&
+        corpus.every((c) => c.name in cached.entries)) {
+        _embeddingIndex = corpus.map((c) => ({
+            name: c.name,
+            vector: new Float32Array(cached.entries[c.name]),
+            nodeType: c.nodeType ?? "tool",
+        }));
+        return;
+    }
+    // Embed all tools
+    try {
+        const texts = corpus.map((c) => c.text);
+        const vectors = await provider.embed(texts);
+        _embeddingIndex = corpus.map((c, i) => ({
+            name: c.name,
+            vector: vectors[i],
+            nodeType: c.nodeType ?? "tool",
+        }));
+        // Save to cache
+        const cacheData = {
+            providerName: provider.name,
+            dimensions: provider.dimensions,
+            version: CACHE_VERSION,
+            toolCount: corpus.length,
+            corpusHash: hash,
+            entries: {},
+        };
+        for (let i = 0; i < corpus.length; i++) {
+            cacheData.entries[corpus[i].name] = Array.from(vectors[i]);
+        }
+        saveCache(cacheData);
+    }
+    catch {
+        // Embedding failed — graceful degradation, search works without embeddings
+        _embeddingIndex = null;
+    }
+}
+/**
+ * Embed a single query string. Returns null if no provider is available.
+ */
+export async function embedQuery(text) {
+    const provider = await getEmbeddingProvider();
+    if (!provider)
+        return null;
+    try {
+        const [vec] = await provider.embed([text]);
+        return vec;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Brute-force cosine KNN over the pre-computed embedding index.
+ * Returns ranked results with similarity scores and node types.
+ */
+export function embeddingSearch(queryVec, limit = 30) {
+    if (!_embeddingIndex)
+        return [];
+    const scored = _embeddingIndex.map((entry) => ({
+        name: entry.name,
+        similarity: cosineSim(queryVec, entry.vector),
+        nodeType: entry.nodeType,
+    }));
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, limit);
+}
+/**
+ * Returns true when the embedding index is loaded and ready for search.
+ */
+export function isEmbeddingReady() {
+    return _embeddingIndex !== null && _embeddingIndex.length > 0;
+}
+/**
+ * Returns the name of the active embedding provider, or null.
+ */
+export function getProviderName() {
+    return _provider?.name ?? null;
+}
+// ── Internals ────────────────────────────────────────────────────────────────
+/** FNV-1a hash — fast, deterministic, good distribution for cache invalidation */
+function fnv1aHash(str) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = (hash * 0x01000193) >>> 0;
+    }
+    return hash.toString(36);
+}
+function cosineSim(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function loadCache() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return null;
+        const raw = readFileSync(CACHE_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function saveCache(data) {
+    try {
+        mkdirSync(CACHE_DIR, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(data));
+    }
+    catch {
+        // Non-critical — next startup will just re-embed
+    }
+}
+// ── Testing helpers ──────────────────────────────────────────────────────────
+/** Reset all state — for testing only. */
+export function _resetForTesting() {
+    _provider = null;
+    _providerChecked = false;
+    _embeddingIndex = null;
+    _initPromise = null;
+}
+/** Inject a mock provider — for testing only. */
+export function _setProviderForTesting(provider) {
+    _provider = provider;
+    _providerChecked = true;
+}
+/** Inject a pre-built index — for testing only. */
+export function _setIndexForTesting(index) {
+    _embeddingIndex = index;
+}
+//# sourceMappingURL=embeddingProvider.js.map

package/dist/tools/embeddingProvider.js.map

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

package/dist/tools/progressiveDiscoveryTools.js

@@ -8,12 +8,13 @@
  * - get_workflow_chain: Get a recommended tool sequence for a common workflow
  */
 import { hybridSearch, TOOL_REGISTRY, ALL_REGISTRY_ENTRIES, WORKFLOW_CHAINS, SEARCH_MODES, } from "./toolRegistry.js";
+import { embedQuery, isEmbeddingReady } from "./embeddingProvider.js";
 export function createProgressiveDiscoveryTools(allRegisteredTools) {
     return [
         // ── discover_tools ─────────────────────────────────────────────────
         {
             name: "discover_tools",
-            description: "Multi-modal tool search engine with 9 scoring strategies: keyword, fuzzy (typo-tolerant), n-gram (partial words), prefix, semantic (synonym expansion), TF-IDF (rare tags score higher), regex, bigram (phrase matching), and domain-aware boosting. Returns ranked results with quick refs. Use mode='hybrid' (default) for best results, or 'regex'/'fuzzy'/'prefix'/'semantic'/'exact' for targeted search.",
+            description: "Multi-modal tool search engine with 14 scoring strategies: keyword, fuzzy (typo-tolerant), n-gram (partial words), prefix, semantic (synonym expansion), TF-IDF (rare tags score higher), regex, bigram (phrase matching), domain cluster boosting, dense (TF-IDF cosine), neural embedding tool RRF, domain RRF (Agent-as-a-Graph bipartite graph), upward traversal (tool→domain→siblings), and execution trace edges (co-occurrence mining). Returns ranked results with quick refs. Use mode='hybrid' (default) for best results, or 'regex'/'fuzzy'/'prefix'/'semantic'/'exact'/'dense'/'embedding' for targeted search.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -29,7 +30,9 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
                             "github", "documentation", "bootstrap", "self_eval",
                             "parallel_agents", "llm", "security", "platform",
                             "research_writing", "flicker_detection", "figma_flow",
-                            "boilerplate", "benchmark", "progressive_discovery", "meta",
+                            "boilerplate", "benchmark", "session_memory", "gaia_solvers",
+                            "toon", "pattern", "git_workflow", "seo", "voice_bridge",
+                            "critter", "progressive_discovery", "meta",
                         ],
                         description: "Filter by tool category (optional)",
                     },
@@ -48,8 +51,8 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
                     },
                     mode: {
                         type: "string",
-                        enum: ["hybrid", "fuzzy", "regex", "prefix", "semantic", "exact", "dense"],
-                        description: "Search mode. 'hybrid' (default) runs all strategies. 'fuzzy' tolerates typos. 'regex' accepts patterns. 'prefix' matches tool name starts. 'semantic' expands synonyms. 'exact' requires exact match. 'dense' uses TF-IDF cosine similarity for vector-like search.",
+                        enum: ["hybrid", "fuzzy", "regex", "prefix", "semantic", "exact", "dense", "embedding"],
+                        description: "Search mode. 'hybrid' (default) runs all strategies including neural embeddings when available. 'fuzzy' tolerates typos. 'regex' accepts patterns. 'prefix' matches tool name starts. 'semantic' expands synonyms. 'exact' requires exact match. 'dense' uses TF-IDF cosine similarity. 'embedding' uses neural embedding similarity only.",
                     },
                     explain: {
                         type: "boolean",
@@ -64,6 +67,13 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
                 const includeChains = args.includeChains !== false;
                 const mode = args.mode ?? "hybrid";
                 const explain = args.explain === true;
+                // Pre-compute query embedding (async) before passing to sync hybridSearch
+                let embeddingQueryVec;
+                if ((mode === "hybrid" || mode === "embedding") && isEmbeddingReady()) {
+                    const vec = await embedQuery(query);
+                    if (vec)
+                        embeddingQueryVec = vec;
+                }
                 // Multi-modal search with scoring
                 const results = hybridSearch(query, allRegisteredTools, {
                     category: args.category,
@@ -71,6 +81,7 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
                     limit,
                     mode,
                     explain,
+                    embeddingQueryVec,
                 });
                 // Find matching workflow chains
                 let matchingChains = [];
@@ -177,7 +188,7 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
         // ── get_workflow_chain ──────────────────────────────────────────────
         {
             name: "get_workflow_chain",
-            description: 'Get a recommended tool sequence for a common workflow. Returns step-by-step tool chain with actions for each step. Available chains: new_feature, fix_bug, ui_change, parallel_project, research_phase, academic_paper, c_compiler_benchmark. Call with chain="list" to see all available chains.',
+            description: 'Get a recommended tool sequence for a common workflow. Returns step-by-step tool chain with actions for each step. 25 chains available covering feature dev, debugging, security, deployment, research, academic writing, CI/CD, multi-agent coordination, and more. Call with chain="list" to see all.',
             inputSchema: {
                 type: "object",
                 properties: {
@@ -185,9 +196,15 @@ export function createProgressiveDiscoveryTools(allRegisteredTools) {
                         type: "string",
                         enum: [
                             "new_feature", "fix_bug", "ui_change", "parallel_project",
-                            "research_phase", "academic_paper", "c_compiler_benchmark", "list",
+                            "research_phase", "academic_paper", "c_compiler_benchmark",
+                            "security_audit", "code_review", "deployment", "migration",
+                            "coordinator_spawn", "self_setup", "flicker_detection",
+                            "figma_flow_analysis", "agent_eval", "contract_compliance",
+                            "ablation_eval", "session_recovery", "attention_refresh",
+                            "task_bank_setup", "pr_review", "seo_audit", "voice_pipeline",
+                            "intentionality_check", "list",
                         ],
-                        description: 'Which workflow chain to retrieve. Use "list" to see all available chains.',
+                        description: 'Which workflow chain to retrieve. Use "list" to see all available chains with descriptions.',
                     },
                 },
                 required: ["chain"],

package/dist/tools/progressiveDiscoveryTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"progressiveDiscoveryTools.js","sourceRoot":"","sources":["../../src/tools/progressiveDiscoveryTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAG3B,MAAM,UAAU,+BAA+B,CAC7C,kBAAgE;IAEhE,OAAO;QACL,sEAAsE;QACtE;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,gZAAgZ;YAClZ,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,oJAAoJ;qBACvJ;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE;4BACJ,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU;4BAC9D,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK;4BAC7D,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW;4BACnD,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU;4BAChD,kBAAkB,EAAE,mBAAmB,EAAE,YAAY;4BACrD,aAAa,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM;yBAC5D;wBACD,WAAW,EAAE,oCAAoC;qBAClD;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;wBAC5E,WAAW,EAAE,qCAAqC;qBACnD;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qCAAqC;qBACnD;oBACD,aAAa,EAAE;wBACb,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,sDAAsD;qBACpE;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;wBAC1E,WAAW,EAAE,qQAAqQ;qBACnR;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,gHAAgH;qBAC9H;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC;gBACnD,MAAM,IAAI,GAAe,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;gBAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;gBAEtC,kCAAkC;gBAClC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,kBAAkB,EAAE;oBACtD,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK;oBACL,IAAI;oBACJ,OAAO;iBACR,CAAC,CAAC;gBAEH,gCAAgC;gBAChC,IAAI,cAAc,GAAsF,EAAE,CAAC;gBAC3G,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;oBACvC,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;yBAC7C,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;wBACvB,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;wBACvE,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBACvE,CAAC,CAAC;yBACD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,QAAQ,EAAE,GAAG;wBACb,WAAW,EAAE,KAAK,CAAC,WAAW;wBAC9B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;qBAC9B,CAAC,CAAC;yBACF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjB,CAAC;gBAED,wDAAwD;gBACxD,MAAM,cAAc,GAA2B,EAAE,CAAC;gBAClD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACrE,CAAC;gBAED,OAAO;oBACL,KAAK;oBACL,UAAU,EAAE,IAAI;oBAChB,WAAW,EAAE,OAAO,CAAC,MAAM;oBAC3B,kBAAkB,EAAE,kBAAkB,CAAC,MAAM;oBAC7C,cAAc,EAAE,YAAY;oBAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,cAAc,EAAE,CAAC,CAAC,KAAK;wBACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpD,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBACrB,CAAC,CAAC;oBACH,eAAe,EAAE,cAAc;oBAC/B,iBAAiB,EAAE,cAAc;oBACjC,gBAAgB,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;wBAClC,CAAC,CAAC,cAAc,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE;wBACpE,CAAC,CAAC,4GAA4G;iBACjH,CAAC;YACJ,CAAC;SACF;QAED,sEAAsE;QACtE;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,6LAA6L;YAC/L,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2CAA2C;qBACzD;oBACD,qBAAqB,EAAE;wBACrB,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,wEAAwE;qBACtF;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;aACvB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,kBAAkB;oBAClB,MAAM,UAAU,GAAG,oBAAoB;yBACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;yBAC/E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBAEtB,OAAO;wBACL,KAAK,EAAE,IAAI;wBACX,OAAO,EAAE,SAAS,IAAI,CAAC,QAAQ,0BAA0B;wBACzD,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;wBAClC,GAAG,EAAE,wDAAwD;qBAC9D,CAAC;gBACJ,CAAC;gBAED,MAAM,MAAM,GAA4B;oBACtC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC;gBAEF,+CAA+C;gBAC/C,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAC/B,MAAM,WAAW,GAA4B,EAAE,CAAC;oBAChD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;wBAChD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;wBAC9C,IAAI,SAAS,EAAE,CAAC;4BACd,WAAW,CAAC,QAAQ,CAAC,GAAG;gCACtB,QAAQ,EAAE,SAAS,CAAC,QAAQ;gCAC5B,KAAK,EAAE,SAAS,CAAC,KAAK;gCACtB,QAAQ,EAAE,SAAS,CAAC,QAAQ;6BAC7B,CAAC;wBACJ,CAAC;oBACH,CAAC;oBACD,MAAM,CAAC,kBAAkB,GAAG,WAAW,CAAC;gBAC1C,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;SACF;QAED,uEAAuE;QACvE;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,mSAAmS;YACrS,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE;4BACJ,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB;4BACzD,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM;yBACnE;wBACD,WAAW,EAAE,2EAA2E;qBACzF;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;oBAC1B,OAAO;wBACL,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;4BACtE,GAAG;4BACH,IAAI,EAAE,KAAK,CAAC,IAAI;4BAChB,WAAW,EAAE,KAAK,CAAC,WAAW;4BAC9B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;yBAC9B,CAAC,CAAC;wBACH,GAAG,EAAE,0FAA0F;qBAChG,CAAC;gBACJ,CAAC;gBAED,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO;wBACL,KAAK,EAAE,IAAI;wBACX,OAAO,EAAE,kBAAkB,IAAI,CAAC,KAAK,EAAE;wBACvC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;qBACxC,CAAC;gBACJ,CAAC;gBAED,+BAA+B;gBAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;oBAChD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC3C,OAAO;wBACL,UAAU,EAAE,CAAC,GAAG,CAAC;wBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,SAAS;wBACtC,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,SAAS;wBAChC,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,IAAI;qBAClC,CAAC;gBACJ,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,UAAU,EAAE,aAAa,CAAC,MAAM;oBAChC,KAAK,EAAE,aAAa;oBACpB,KAAK,EAAE,2BAA2B,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,oDAAoD;iBAC1G,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"progressiveDiscoveryTools.js","sourceRoot":"","sources":["../../src/tools/progressiveDiscoveryTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/reconTools.js

@@ -465,45 +465,95 @@ export const reconTools = [
             if (categories && categories.length > 0) {
                 learnings = learnings.filter((l) => categories.includes(l.category));
             }
-            // 2. Search recon findings across ALL sessions
+            // 2. Search recon findings across ALL sessions via FTS5+BM25 (LIKE fallback)
             let reconFindings;
-            if (categories && categories.length > 0) {
-                const placeholders = categories.map(() => "?").join(", ");
-                reconFindings = db
-                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
-                    f.relevance, f.action_items, f.created_at,
-                    s.target as session_target
-             FROM recon_findings f
-             JOIN recon_sessions s ON s.id = f.session_id
-             WHERE (f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?)
-               AND f.category IN (${placeholders})
-             ORDER BY f.created_at DESC
+            try {
+                if (categories && categories.length > 0) {
+                    const placeholders = categories.map(() => "?").join(", ");
+                    reconFindings = db
+                        .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                      f.relevance, f.action_items, f.created_at,
+                      s.target as session_target
+               FROM recon_findings_fts fts
+               JOIN recon_findings f ON f.rowid = fts.rowid
+               JOIN recon_sessions s ON s.id = f.session_id
+               WHERE recon_findings_fts MATCH ?
+                 AND f.category IN (${placeholders})
+               ORDER BY rank
+               LIMIT ?`)
+                        .all(query, ...categories, limit);
+                }
+                else {
+                    reconFindings = db
+                        .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                      f.relevance, f.action_items, f.created_at,
+                      s.target as session_target
+               FROM recon_findings_fts fts
+               JOIN recon_findings f ON f.rowid = fts.rowid
+               JOIN recon_sessions s ON s.id = f.session_id
+               WHERE recon_findings_fts MATCH ?
+               ORDER BY rank
+               LIMIT ?`)
+                        .all(query, limit);
+                }
+            }
+            catch {
+                // FTS5 syntax error — fall back to LIKE
+                if (categories && categories.length > 0) {
+                    const placeholders = categories.map(() => "?").join(", ");
+                    reconFindings = db
+                        .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                      f.relevance, f.action_items, f.created_at,
+                      s.target as session_target
+               FROM recon_findings f
+               JOIN recon_sessions s ON s.id = f.session_id
+               WHERE (f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?)
+                 AND f.category IN (${placeholders})
+               ORDER BY f.created_at DESC
+               LIMIT ?`)
+                        .all(`%${query}%`, `%${query}%`, `%${query}%`, ...categories, limit);
+                }
+                else {
+                    reconFindings = db
+                        .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                      f.relevance, f.action_items, f.created_at,
+                      s.target as session_target
+               FROM recon_findings f
+               JOIN recon_sessions s ON s.id = f.session_id
+               WHERE f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?
+               ORDER BY f.created_at DESC
+               LIMIT ?`)
+                        .all(`%${query}%`, `%${query}%`, `%${query}%`, limit);
+                }
+            }
+            // 3. Search ALL gaps from past verification cycles via FTS5+BM25 (LIKE fallback)
+            let matchedGaps;
+            try {
+                matchedGaps = db
+                    .prepare(`SELECT g.id, g.cycle_id, g.title, g.description, g.severity,
+                    g.status, g.fix_strategy as resolution, g.resolved_at,
+                    c.title as cycle_target
+             FROM gaps_fts fts
+             JOIN gaps g ON g.rowid = fts.rowid
+             JOIN verification_cycles c ON c.id = g.cycle_id
+             WHERE gaps_fts MATCH ?
+             ORDER BY rank
              LIMIT ?`)
-                    .all(`%${query}%`, `%${query}%`, `%${query}%`, ...categories, limit);
+                    .all(query, limit);
             }
-            else {
-                reconFindings = db
-                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
-                    f.relevance, f.action_items, f.created_at,
-                    s.target as session_target
-             FROM recon_findings f
-             JOIN recon_sessions s ON s.id = f.session_id
-             WHERE f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?
-             ORDER BY f.created_at DESC
+            catch {
+                // FTS5 syntax error — fall back to LIKE
+                matchedGaps = db
+                    .prepare(`SELECT g.id, g.cycle_id, g.title, g.description, g.severity,
+                    g.status, g.fix_strategy as resolution, g.resolved_at,
+                    c.title as cycle_target
+             FROM gaps g
+             JOIN verification_cycles c ON c.id = g.cycle_id
+             WHERE (g.description LIKE ? OR g.fix_strategy LIKE ? OR g.title LIKE ?)
+             ORDER BY g.created_at DESC
              LIMIT ?`)
                     .all(`%${query}%`, `%${query}%`, `%${query}%`, limit);
             }
-            // 3. Search ALL gaps from past verification cycles (resolved + open)
-            const matchedGaps = db
-                .prepare(`SELECT g.id, g.cycle_id, g.title, g.description, g.severity,
-                  g.status, g.fix_strategy as resolution, g.resolved_at,
-                  c.title as cycle_target
-           FROM gaps g
-           JOIN verification_cycles c ON c.id = g.cycle_id
-           WHERE (g.description LIKE ? OR g.fix_strategy LIKE ? OR g.title LIKE ?)
-           ORDER BY g.created_at DESC
-           LIMIT ?`)
-                .all(`%${query}%`, `%${query}%`, `%${query}%`, limit);
             const totalResults = learnings.length + reconFindings.length + matchedGaps.length;
             return {
                 query,