@vinaes/succ 1.4.0 → 1.5.42

package/dist/lib/public-api.js

@@ -21,6 +21,8 @@ export { createMemoryLink, deleteMemoryLink, getMemoryLinks, getMemoryWithLinks,
 export { upsertDocument, upsertDocumentsBatch, upsertDocumentsBatchWithHashes, deleteDocumentsByPath, getStats, getFileHash, setFileHash, deleteFileHash, getAllFileHashes, getStaleFiles, } from './storage/index.js';
 // --- Embeddings ---
 export { getEmbedding, getEmbeddings, cosineSimilarity, cleanupEmbeddings, getEmbeddingInfo, } from './embeddings.js';
+// --- Reranker ---
+export { rerank, isRerankerEnabled, cleanupReranker } from './reranker.js';
 // --- Config ---
 export { getConfig, getProjectRoot, getSuccDir, isProjectInitialized, isGlobalOnlyMode, invalidateConfigCache, setConfigOverride, } from './config.js';
 // --- BM25 index management ---
@@ -42,6 +44,9 @@ export { createProximityLinks } from './graph/contextual-proximity.js';
 export { detectCommunities } from './graph/community-detection.js';
 export { updateCentralityCache } from './graph/centrality.js';
 export { exportGraphSilent } from './graph-export.js';
+// --- Graph: graphology algorithms ---
+export { getGraph, invalidateGraphCache, personalizedPageRank, detectLouvainCommunities, shortestPath, getArticulationPoints, computePageRank, computeBetweennessCentrality, whyRelated, } from './graph/graphology-bridge.js';
+export { generateCommunitySummaries } from './graph/community-summaries.js';
 // --- PRD pipeline ---
 export { generatePrd } from './prd/generate.js';
 export { loadPrd, loadTasks, listPrds, findLatestPrd } from './prd/state.js';
@@ -60,6 +65,10 @@ export { reindexFiles } from '../commands/reindex.js';
 export { extractSymbolsFromFile } from './tree-sitter/public.js';
 // --- Web fetch (md.succ.ai) ---
 export { fetchAsMarkdown } from './md-fetch.js';
+// --- Review context pack ---
+export { generateReviewContext } from './review/context-pack.js';
+// --- Diff parsing ---
+export { parseDiffText, extractChangedSymbols, summarizeDiff, getFileChanges, } from './diff-parser.js';
 // --- Errors ---
 export { SuccError, ConfigError, StorageError, ValidationError, NetworkError, NotFoundError, DependencyError, isSuccError, } from './errors.js';
 // --- Temporal utilities ---
@@ -74,4 +83,33 @@ export { getMemoriesByTag } from './storage/index.js';
 export { extractFactsWithLLM } from './session-summary.js';
 // --- Graph cleanup pipeline ---
 export { graphCleanup } from './graph/cleanup.js';
+// --- Git co-change analysis ---
+export { analyzeCoChanges, getCoChangesForFile } from './git/co-change.js';
+// --- Bridge edges (code ↔ knowledge) ---
+export { extractCodePaths, inferBridgeRelation, createBridgeEdgesForMemory, createManualBridgeEdge, findMemoriesForCode, autoBridgeRecentMemories, BRIDGE_RELATIONS, } from './graph/bridge-edges.js';
+// --- Retrieval feedback loops ---
+export { recordRecallEvent, recordRecallBatch, getRecallStats, getRecallSummary, getBoostFactor, getBoostFactors, getNeverUsedMemories, cleanupRecallEvents, } from './retrieval-feedback.js';
+// --- Auto memory consolidation ---
+export { consolidateAutoMemories, getAutoMemoryStats } from './auto-memory/consolidation.js';
+// --- LSP code intelligence ---
+export { findDefinition, findReferences, getHover, shutdownAll as shutdownLsp, getStatus as getLspStatus, getClient as getLspClient, } from '../lsp/manager.js';
+export { LSP_SERVERS, detectProjectLanguages } from '../lsp/servers.js';
+// --- Search: PPR-enhanced retrieval ---
+export { pprEnhancedRerank } from './search/ppr-retrieval.js';
+// --- Search: HyDE (Hypothetical Document Embeddings) ---
+export { generateHyDE } from './search/hyde.js';
+// --- Search: BM25 query expansion ---
+export { expandQuery, expandQueryFull, looksLikeCode } from './query-expansion.js';
+// --- Search: Repo map ---
+export { generateRepoMap } from './search/repo-map.js';
+// --- Cross-repo search ---
+export { discoverProjects, listProjects } from './cross-repo.js';
+// --- Observability ---
+export { recordLatency, withLatency, getLatencyStats, getDashboard, formatDashboard, } from './observability.js';
+// --- Diff-aware brain vault analysis ---
+export { detectChangedFiles } from './diff-brain.js';
+// --- Brain vault export ---
+export { readBrainVault, exportBrainAsJson, exportBrainAsMarkdown, exportBrainSnapshot, } from './brain-export.js';
+// --- API versioning ---
+export { API_VERSION, addVersionedRoutes, getApiVersionInfo } from '../daemon/routes/versioning.js';
 //# sourceMappingURL=public-api.js.map

package/dist/lib/public-api.js.map

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

package/dist/lib/quality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/lib/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAqB3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,YAAY,CAqB9F;AA+JD;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAkDD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,YAAY,CAAC,CA8EvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAwCvB;AA0ED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAIvF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAM9D"}
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/lib/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAqB3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,YAAY,CAqB9F;AA+JD;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BrF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAkDD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,YAAY,CAAC,CAiFvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAwCvB;AA6ED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAIvF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAM9D"}

package/dist/lib/quality.js

@@ -8,7 +8,7 @@
  */
 import { getConfig, getLLMTaskConfig } from './config.js';
 import { QUALITY_SCORER_SYSTEM } from '../prompts/index.js';
-import { logWarn } from './fault-logger.js';
+import { logInfo, logWarn } from './fault-logger.js';
 import { NetworkError, ValidationError } from './errors.js';
 // Lazy-loaded zero-shot classification pipeline for local scoring
 let classifierPipeline = null;
@@ -184,7 +184,10 @@ export async function estimateSpecificityByEmbedding(content) {
             return 0.5;
         return clampedHigh / total;
     }
-    catch {
+    catch (error) {
+        logWarn('quality', 'Embedding generation failed for specificity estimation', {
+            error: error instanceof Error ? error.message : String(error),
+        });
         return 0.5; // neutral fallback
     }
 }
@@ -233,11 +236,11 @@ function calculateClarity(content) {
 async function getClassifierPipeline() {
     if (!classifierPipeline) {
         const { pipeline } = await import('@huggingface/transformers');
-        console.log(`Loading quality scoring model: ${CLASSIFIER_MODEL}...`);
+        logInfo('quality', `Loading quality scoring model: ${CLASSIFIER_MODEL}`);
         classifierPipeline = await pipeline('zero-shot-classification', CLASSIFIER_MODEL, {
             device: 'cpu',
         });
-        console.log('Quality scoring model loaded.');
+        logInfo('quality', 'Quality scoring model loaded');
     }
     return classifierPipeline;
 }
@@ -279,7 +282,10 @@ export async function scoreWithLocal(content, existingSimilarity) {
                             heuristicResult.factors.uniqueness * 0.2;
                 }
             }
-            catch {
+            catch (error) {
+                logWarn('quality', 'Embedding-based specificity estimation failed, using heuristic', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 // Non-fatal — continue with heuristic score
             }
         }
@@ -421,7 +427,10 @@ function parseScoreResponse(response) {
             },
         };
     }
-    catch {
+    catch (error) {
+        logWarn('quality', 'Failed to parse LLM quality score JSON response', {
+            error: error instanceof Error ? error.message : String(error),
+        });
         // Return default scores on parse error
         return {
             score: 0.5,

package/dist/lib/quality.js.map

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

package/dist/lib/query-expansion.d.ts

@@ -5,6 +5,21 @@
  * to improve retrieval coverage. Disabled by default.
  */
 import type { LLMBackend } from './llm.js';
+export interface ExpandedQuery {
+    /** Original query */
+    original: string;
+    /** Expanded alternative queries (not including original) */
+    expanded: string[];
+    /** Combined string: original + all expanded terms joined by space */
+    combined: string;
+    /** Whether expansion was applied */
+    wasExpanded: boolean;
+}
+/**
+ * Returns true if the query looks like a code snippet rather than natural language.
+ * Code-like queries are skipped for expansion.
+ */
+export declare function looksLikeCode(query: string): boolean;
 /**
  * Expand a query into multiple search terms using LLM.
  *
@@ -13,4 +28,21 @@ import type { LLMBackend } from './llm.js';
  * @returns Array of expanded queries (NOT including the original)
  */
 export declare function expandQuery(query: string, mode?: LLMBackend): Promise<string[]>;
+export interface ExpandQueryFullOptions {
+    /** Force expansion even for long or code-like queries */
+    forceExpand?: boolean;
+    /** LLM backend override */
+    mode?: LLMBackend;
+}
+/**
+ * Expand a query and return a structured result with combined string.
+ *
+ * Skips expansion for code-like queries or queries with 8+ words unless
+ * `forceExpand` is set. Delegates to `expandQuery()` for LLM expansion.
+ *
+ * @param query - Search query to expand
+ * @param options - Optional flags (forceExpand, mode)
+ * @returns ExpandedQuery with original, expanded[], combined, wasExpanded
+ */
+export declare function expandQueryFull(query: string, options?: ExpandQueryFullOptions): Promise<ExpandedQuery>;
 //# sourceMappingURL=query-expansion.d.ts.map

package/dist/lib/query-expansion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-expansion.d.ts","sourceRoot":"","sources":["../../src/lib/query-expansion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCrF"}
+{"version":3,"file":"query-expansion.d.ts","sourceRoot":"","sources":["../../src/lib/query-expansion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAS3C,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAMD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCrF;AAMD,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CAsCxB"}

package/dist/lib/query-expansion.js

@@ -6,6 +6,20 @@
  */
 import { callLLM, getLLMConfig } from './llm.js';
 import { EXPANSION_SYSTEM, EXPANSION_PROMPT } from '../prompts/index.js';
+import { logWarn } from './fault-logger.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Returns true if the query looks like a code snippet rather than natural language.
+ * Code-like queries are skipped for expansion.
+ */
+export function looksLikeCode(query) {
+    return /[{}();=]|=>|\.\w+\(/.test(query);
+}
+// ============================================================================
+// Core expand (returns string[] — used by recall.ts)
+// ============================================================================
 /**
  * Expand a query into multiple search terms using LLM.
  *
@@ -35,9 +49,56 @@ export async function expandQuery(query, mode) {
             .slice(0, 5);
         return expanded;
     }
-    catch {
+    catch (error) {
+        logWarn('query-expansion', 'LLM call failed for query expansion', {
+            error: error instanceof Error ? error.message : String(error),
+        });
         // LLM failure should never break search — silently fall back to no expansion
         return [];
     }
 }
+/**
+ * Expand a query and return a structured result with combined string.
+ *
+ * Skips expansion for code-like queries or queries with 8+ words unless
+ * `forceExpand` is set. Delegates to `expandQuery()` for LLM expansion.
+ *
+ * @param query - Search query to expand
+ * @param options - Optional flags (forceExpand, mode)
+ * @returns ExpandedQuery with original, expanded[], combined, wasExpanded
+ */
+export async function expandQueryFull(query, options = {}) {
+    const { forceExpand = false, mode } = options;
+    // '   '.trim().split(/\s+/) returns [''] (length 1), so the wordCount >= 8
+    // check below does NOT guard against whitespace-only queries. Bail early.
+    if (!query.trim()) {
+        return { original: query, expanded: [], combined: query, wasExpanded: false };
+    }
+    if (!forceExpand) {
+        const wordCount = query.trim().split(/\s+/).length;
+        if (wordCount >= 8 || looksLikeCode(query)) {
+            return {
+                original: query,
+                expanded: [],
+                combined: query,
+                wasExpanded: false,
+            };
+        }
+    }
+    const expanded = await expandQuery(query, mode);
+    if (expanded.length === 0) {
+        return {
+            original: query,
+            expanded: [],
+            combined: query,
+            wasExpanded: false,
+        };
+    }
+    return {
+        original: query,
+        expanded,
+        combined: [query, ...expanded].join(' '),
+        wasExpanded: true,
+    };
+}
 //# sourceMappingURL=query-expansion.js.map

package/dist/lib/query-expansion.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-expansion.js","sourceRoot":"","sources":["../../src/lib/query-expansion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAa,EAAE,IAAiB;IAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,MAAM,EACN;YACE,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,gBAAgB;SAC/B,EACD,cAAc,CACf,CAAC;QAEF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzD,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,QAAQ;aACtB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,kBAAkB;aAC3E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;aACxD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAClE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEf,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"query-expansion.js","sourceRoot":"","sources":["../../src/lib/query-expansion.ts"],"names":[],"mappings":"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"}

package/dist/lib/reference-embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/reference-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAS9E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"reference-embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/reference-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAS9E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/lib/reference-embeddings.js

@@ -6,6 +6,7 @@
  * Used by detectInvariantWithEmbedding() and estimateSpecificityByEmbedding().
  */
 import { getEmbeddings, cosineSimilarity } from './embeddings.js';
+import { logWarn } from './fault-logger.js';
 const referenceSets = new Map();
 /**
  * Register a named set of reference phrases.
@@ -42,13 +43,19 @@ export async function maxSimilarityToReference(embedding, setName) {
                 if (sim > maxSim)
                     maxSim = sim;
             }
-            catch {
+            catch (error) {
+                logWarn('reference-embeddings', 'Cosine similarity failed for max similarity reference comparison', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 // Dimension mismatch — skip this reference
             }
         }
         return maxSim > 0 ? maxSim : 0;
     }
-    catch {
+    catch (error) {
+        logWarn('reference-embeddings', 'Failed to retrieve reference embeddings for max similarity computation', {
+            error: error instanceof Error ? error.message : String(error),
+        });
         return 0;
     }
 }
@@ -67,13 +74,19 @@ export async function avgSimilarityToReference(embedding, setName) {
                 sum += cosineSimilarity(embedding, ref);
                 count++;
             }
-            catch {
+            catch (error) {
+                logWarn('reference-embeddings', 'Cosine similarity failed for average similarity reference comparison', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 // Dimension mismatch — skip
             }
         }
         return count > 0 ? sum / count : 0;
     }
-    catch {
+    catch (error) {
+        logWarn('reference-embeddings', 'Failed to retrieve reference embeddings for average similarity computation', {
+            error: error instanceof Error ? error.message : String(error),
+        });
         return 0;
     }
 }

package/dist/lib/reference-embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-embeddings.js","sourceRoot":"","sources":["../../src/lib/reference-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOlE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAiB;IAClE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,CAAC;IAEpE,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,GAAG,CAAC,UAAU,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAmB,EACnB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEzC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC7C,IAAI,GAAG,GAAG,MAAM;oBAAE,MAAM,GAAG,GAAG,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAmB,EACnB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEzC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,GAAG,IAAI,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBACxC,KAAK,EAAE,CAAC;YACV,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}
+{"version":3,"file":"reference-embeddings.js","sourceRoot":"","sources":["../../src/lib/reference-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM5C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAiB;IAClE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,CAAC;IAEpE,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,GAAG,CAAC,UAAU,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAmB,EACnB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEzC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC7C,IAAI,GAAG,GAAG,MAAM;oBAAE,MAAM,GAAG,GAAG,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CACL,sBAAsB,EACtB,kEAAkE,EAClE;oBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CACF,CAAC;gBACF,2CAA2C;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CACL,sBAAsB,EACtB,wEAAwE,EACxE;YACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CACF,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAmB,EACnB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEzC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,GAAG,IAAI,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBACxC,KAAK,EAAE,CAAC;YACV,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CACL,sBAAsB,EACtB,sEAAsE,EACtE;oBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CACF,CAAC;gBACF,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CACL,sBAAsB,EACtB,4EAA4E,EAC5E;YACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CACF,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/lib/reflection-synthesizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reflection-synthesizer.d.ts","sourceRoot":"","sources":["../../src/lib/reflection-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAUtE,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC9D,OAAO,CAAC,eAAe,CAAC,CAoI1B"}
+{"version":3,"file":"reflection-synthesizer.d.ts","sourceRoot":"","sources":["../../src/lib/reflection-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAWtE,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC9D,OAAO,CAAC,eAAe,CAAC,CA2I1B"}

package/dist/lib/reflection-synthesizer.js

@@ -7,10 +7,13 @@
  * Plugs into daemon's handleReflection() between community detection
  * and centrality cache update.
  */
+// NOTE: See also graph/community-summaries.ts which generates GraphRAG-style retrieval summaries.
+// This module extracts actionable patterns/learnings; that one creates abstract theme descriptions.
 import { callLLM } from './llm.js';
 import { getEmbedding } from './embeddings.js';
 import { saveMemory, getMemoryById, updateMemoryTags, findSimilarMemory, incrementCorrectionCount, } from './storage/index.js';
 import { SYNTHESIS_SYSTEM, SYNTHESIS_PROMPT } from '../prompts/index.js';
+import { logWarn } from './fault-logger.js';
 const MIN_CLUSTER_SIZE = 5;
 const MAX_OBSERVATIONS_PER_SYNTHESIS = 15;
 /** Semantic dedup threshold for synthesized reflections.
@@ -120,7 +123,10 @@ export async function synthesizeFromCommunities(communityResult, options = {}) {
                         await updateMemoryTags(mem.id, newTags);
                         result.observationsMarked++;
                     }
-                    catch {
+                    catch (error) {
+                        logWarn('reflection-synthesizer', 'Failed to update memory tags to mark observation as reflected', {
+                            error: error instanceof Error ? error.message : String(error),
+                        });
                         // Non-critical — worst case we re-process next cycle
                     }
                 }

package/dist/lib/reflection-synthesizer.js.map

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

package/dist/lib/reranker.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Cross-encoder reranker for search result post-processing.
+ *
+ * Uses an ONNX cross-encoder model (ms-marco-MiniLM-L6-v2) to score
+ * (query, document) pairs for relevance. Applied after hybrid search
+ * (BM25 + vector + RRF) to improve precision.
+ *
+ * Architecture: singleton session, lazy-loaded on first use, auto-disposed on cleanup.
+ */
+/** Minimal interface for results that can be reranked */
+export interface Rerankable {
+    content: string;
+    similarity: number;
+    symbol_name?: string | null;
+    signature?: string | null;
+}
+/**
+ * Rerank hybrid search results using cross-encoder scoring.
+ *
+ * Takes existing search results (from BM25 + vector + RRF) and re-scores
+ * them using a cross-encoder model that sees both query and document together.
+ *
+ * @param query - Original search query
+ * @param results - Hybrid search results to rerank
+ * @param topK - Number of top results to return (default: results.length)
+ * @returns Reranked results with updated similarity scores
+ */
+export declare function rerank<T extends Rerankable>(query: string, results: T[], topK?: number): Promise<T[]>;
+/**
+ * Check if the reranker is available and enabled.
+ */
+export declare function isRerankerEnabled(): boolean;
+/**
+ * Cleanup reranker session to free memory.
+ *
+ * Sets a shutdown guard first, then awaits any in-flight initialization before
+ * releasing ONNX resources. This prevents a race where cleanup returns while
+ * initReranker() is still allocating the session (which would then leak).
+ */
+export declare function cleanupReranker(): Promise<void>;
+//# sourceMappingURL=reranker.d.ts.map

package/dist/lib/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../src/lib/reranker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAwLD;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,CAAC,SAAS,UAAU,EAC/C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,EAAE,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,EAAE,CAAC,CAqEd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBrD"}