@vinaes/succ 1.4.0 → 1.5.42

package/dist/lib/graph/bridge-edges.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Bridge Edges — connects code entities with knowledge graph memories.
+ *
+ * Enables queries like "which decisions affect this function?" by creating
+ * typed edges between memories and the code they reference.
+ *
+ * Bridge edge types:
+ * - `documents` — decision/learning explains a code file/function
+ * - `bug_in` — error memory references a code location
+ * - `test_covers` — test file/symbol covers a function
+ * - `motivates` — pattern/decision motivates a code module
+ */
+/** Bridge relation types (subset of LinkRelation for code ↔ knowledge) */
+export declare const BRIDGE_RELATIONS: readonly ["documents", "bug_in", "test_covers", "motivates"];
+export type BridgeRelation = (typeof BRIDGE_RELATIONS)[number];
+export interface BridgeEdgeResult {
+    created: number;
+    skipped: number;
+    errors: number;
+}
+export interface CodeReference {
+    path: string;
+    symbol?: string;
+    lineRange?: [number, number];
+}
+/**
+ * Represents the set of code paths referenced by a specific memory,
+ * used when bulk-building bridge edges outside of individual memory creation.
+ */
+export interface MemoryCodeLinks {
+    memoryId: number;
+    codePaths: CodeReference[];
+}
+/**
+ * Scan memory content for code file path references.
+ */
+export declare function extractCodePaths(content: string): CodeReference[];
+/**
+ * Infer the best bridge relation type based on memory content and tags.
+ */
+export declare function inferBridgeRelation(content: string, tags: string[]): BridgeRelation;
+/**
+ * Scan a memory for code path references and create bridge edges to
+ * other memories that also reference the same code paths.
+ *
+ * @param memoryId - The memory to scan
+ * @param content - Memory content text
+ * @param tags - Memory tags
+ */
+export declare function createBridgeEdgesForMemory(memoryId: number, content: string, tags: string[], preExtractedPaths?: CodeReference[]): Promise<BridgeEdgeResult>;
+/**
+ * Create a manual bridge edge between a memory and a code path.
+ * Creates the link with explicit metadata about the code reference.
+ */
+export declare function createManualBridgeEdge(sourceMemoryId: number, targetMemoryId: number, codePath: string, relation?: BridgeRelation, options?: {
+    symbolName?: string;
+    lineRange?: [number, number];
+    weight?: number;
+}): Promise<{
+    id: number;
+    created: boolean;
+}>;
+/**
+ * Find all memories connected to a given code path via bridge edges.
+ * Searches both memory content and link metadata.
+ *
+ * Two sources are combined:
+ * 1. Semantic search — memories whose content mentions the code path.
+ * 2. Link metadata — memories connected via bridge edges that record
+ *    the code path in their metadata (covers manual edges and edges where
+ *    the memory text doesn't repeat the full path).
+ *
+ * When options.relation is provided, only memories matched via a bridge
+ * edge of that relation type (or, for content-only matches, memories whose
+ * inferred relation matches) are returned.
+ */
+export declare function findMemoriesForCode(codePath: string, options?: {
+    relation?: BridgeRelation;
+    limit?: number;
+}): Promise<Array<{
+    memoryId: number;
+    content: string;
+    relation: string;
+    score: number;
+}>>;
+/**
+ * Scan all recent memories and create bridge edges for any that
+ * reference code files. Used during batch processing / maintenance.
+ *
+ * @param limit - Max memories to scan (default: 100)
+ */
+export declare function autoBridgeRecentMemories(limit?: number): Promise<BridgeEdgeResult>;
+//# sourceMappingURL=bridge-edges.d.ts.map

package/dist/lib/graph/bridge-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-edges.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/bridge-edges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,8DAA+D,CAAC;AAC7F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAuBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA0BjE;AAuBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAanF;AAMD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,iBAAiB,CAAC,EAAE,aAAa,EAAE,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAsE3B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,cAA4B,EACtC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAW3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CACR,KAAK,CAAC;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CACH,CAiEA;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB7F"}

package/dist/lib/graph/bridge-edges.js

@@ -0,0 +1,276 @@
+/**
+ * Bridge Edges — connects code entities with knowledge graph memories.
+ *
+ * Enables queries like "which decisions affect this function?" by creating
+ * typed edges between memories and the code they reference.
+ *
+ * Bridge edge types:
+ * - `documents` — decision/learning explains a code file/function
+ * - `bug_in` — error memory references a code location
+ * - `test_covers` — test file/symbol covers a function
+ * - `motivates` — pattern/decision motivates a code module
+ */
+import { createMemoryLink, hybridSearchMemories, getRecentMemories, getMemoryLinks, } from '../storage/index.js';
+import { getEmbedding } from '../embeddings.js';
+import { logInfo, logWarn } from '../fault-logger.js';
+// ============================================================================
+// Types
+// ============================================================================
+/** Bridge relation types (subset of LinkRelation for code ↔ knowledge) */
+export const BRIDGE_RELATIONS = ['documents', 'bug_in', 'test_covers', 'motivates'];
+// ============================================================================
+// File Path Detection
+// ============================================================================
+/**
+ * Common source code file extensions for path detection.
+ */
+const CODE_EXTENSIONS = /\.(ts|tsx|js|jsx|py|go|rs|rb|java|kt|cs|cpp|c|h|hpp|vue|svelte|php|swift|scala|sh|bash|zsh|yaml|yml|json|toml|sql|graphql|proto|md)$/;
+/**
+ * Regex to detect file paths in memory content.
+ * Matches patterns like:
+ * - src/lib/auth.ts
+ * - ./components/Button.tsx
+ * - lib/storage/index.ts:42
+ * - `path/to/file.py`
+ */
+const FILE_PATH_PATTERN = /(?:^|[\s`"'(,])((\.{0,2}\/)?(?:[a-zA-Z0-9_.-]+\/)*[a-zA-Z0-9_.-]+\.[a-zA-Z0-9]+)(?::(\d+))?/gm;
+/**
+ * Scan memory content for code file path references.
+ */
+export function extractCodePaths(content) {
+    const refs = [];
+    const seen = new Set();
+    // Reset regex state
+    FILE_PATH_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = FILE_PATH_PATTERN.exec(content)) !== null) {
+        // Normalize: strip leading ./ and convert backslashes to forward slashes
+        const rawPath = match[1];
+        const path = rawPath.replace(/^\.\//, '').replace(/\\/g, '/');
+        // Must look like a code file
+        if (!CODE_EXTENSIONS.test(path))
+            continue;
+        // Skip duplicates
+        if (seen.has(path))
+            continue;
+        seen.add(path);
+        const line = match[3] ? parseInt(match[3], 10) : undefined;
+        refs.push({
+            path,
+            lineRange: line ? [line, line] : undefined,
+        });
+    }
+    return refs;
+}
+/**
+ * Detect if memory content is about a bug/error (for `bug_in` edges).
+ */
+function isBugRelated(content, tags) {
+    const bugKeywords = /\b(bug|error|fix|crash|exception|traceback|stack\s*trace|regression|broken|failed|failure)\b/i;
+    return (bugKeywords.test(content) ||
+        tags.some((t) => ['error', 'bug', 'fix', 'debug', 'dead_end'].includes(t)));
+}
+/**
+ * Detect if memory content is about testing (for `test_covers` edges).
+ */
+function isTestRelated(content, tags) {
+    const testKeywords = /\b(tests?|specs?|coverage|assertions?|mocks?|stubs?|fixtures?|jest|vitest|pytest|mocha)\b/i;
+    return testKeywords.test(content) || tags.some((t) => ['test', 'testing', 'spec'].includes(t));
+}
+/**
+ * Infer the best bridge relation type based on memory content and tags.
+ */
+export function inferBridgeRelation(content, tags) {
+    if (isBugRelated(content, tags))
+        return 'bug_in';
+    if (isTestRelated(content, tags))
+        return 'test_covers';
+    // Check for motivational patterns (architecture decisions, design patterns)
+    const motivatesKeywords = /\b(pattern|architecture|design|approach|strategy|convention|principle)\b/i;
+    if (motivatesKeywords.test(content) ||
+        tags.some((t) => ['pattern', 'architecture', 'decision'].includes(t))) {
+        return 'motivates';
+    }
+    return 'documents';
+}
+// ============================================================================
+// Bridge Edge Creation
+// ============================================================================
+/**
+ * Scan a memory for code path references and create bridge edges to
+ * other memories that also reference the same code paths.
+ *
+ * @param memoryId - The memory to scan
+ * @param content - Memory content text
+ * @param tags - Memory tags
+ */
+export async function createBridgeEdgesForMemory(memoryId, content, tags, preExtractedPaths) {
+    const codePaths = preExtractedPaths ?? extractCodePaths(content);
+    if (codePaths.length === 0) {
+        return { created: 0, skipped: 0, errors: 0 };
+    }
+    const relation = inferBridgeRelation(content, tags);
+    let created = 0;
+    let skipped = 0;
+    let errors = 0;
+    // For each code path found, search for other memories that reference it
+    for (const ref of codePaths) {
+        let related;
+        try {
+            // Search for memories mentioning this file path
+            const queryEmbed = await getEmbedding(ref.path);
+            related = await hybridSearchMemories(ref.path, queryEmbed, 10);
+        }
+        catch (error) {
+            logWarn('bridge-edges', `Failed to search for related memories for ${ref.path}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            errors++;
+            continue;
+        }
+        for (const target of related) {
+            if (target.id === memoryId)
+                continue;
+            // Check if target also mentions this code path
+            if (!target.content.includes(ref.path))
+                continue;
+            try {
+                const metadata = {
+                    code_path: ref.path,
+                    symbol_name: ref.symbol,
+                    line_range: ref.lineRange,
+                    detection: 'auto',
+                };
+                const result = await createMemoryLink(memoryId, target.id, relation, 0.7, {
+                    metadata: metadata,
+                });
+                if (result.created) {
+                    created++;
+                }
+                else {
+                    skipped++;
+                }
+            }
+            catch (error) {
+                logWarn('bridge-edges', `Failed to create bridge edge for ${ref.path} → memory #${target.id}`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                errors++;
+            }
+        }
+    }
+    if (created > 0) {
+        logInfo('bridge-edges', `Created ${created} bridge edges for memory #${memoryId} (${relation}, ${codePaths.length} code paths)`);
+    }
+    return { created, skipped, errors };
+}
+/**
+ * Create a manual bridge edge between a memory and a code path.
+ * Creates the link with explicit metadata about the code reference.
+ */
+export async function createManualBridgeEdge(sourceMemoryId, targetMemoryId, codePath, relation = 'documents', options) {
+    const metadata = {
+        code_path: codePath,
+        symbol_name: options?.symbolName,
+        line_range: options?.lineRange,
+        detection: 'manual',
+    };
+    return createMemoryLink(sourceMemoryId, targetMemoryId, relation, options?.weight ?? 0.8, {
+        metadata: metadata,
+    });
+}
+/**
+ * Find all memories connected to a given code path via bridge edges.
+ * Searches both memory content and link metadata.
+ *
+ * Two sources are combined:
+ * 1. Semantic search — memories whose content mentions the code path.
+ * 2. Link metadata — memories connected via bridge edges that record
+ *    the code path in their metadata (covers manual edges and edges where
+ *    the memory text doesn't repeat the full path).
+ *
+ * When options.relation is provided, only memories matched via a bridge
+ * edge of that relation type (or, for content-only matches, memories whose
+ * inferred relation matches) are returned.
+ */
+export async function findMemoriesForCode(codePath, options) {
+    const limit = options?.limit ?? 20;
+    const wantRelation = options?.relation;
+    const seen = new Set();
+    const results = [];
+    // ── Source 1: semantic / hybrid search ────────────────────────────────────
+    // Fetch more than `limit` so we have candidates after filtering.
+    const queryEmbed = await getEmbedding(codePath);
+    const memories = await hybridSearchMemories(codePath, queryEmbed, limit * 2);
+    for (const mem of memories) {
+        // Inspect bridge links regardless of whether the content mentions the path.
+        // Bridge link metadata is the authoritative source for code-path associations.
+        const links = await getMemoryLinks(mem.id);
+        const allLinks = [...links.outgoing, ...links.incoming];
+        // Find bridge links that reference this code path
+        const matchingBridgeLinks = allLinks.filter((l) => {
+            if (!BRIDGE_RELATIONS.includes(l.relation))
+                return false;
+            if (wantRelation && l.relation !== wantRelation)
+                return false;
+            // Check link metadata for the code path
+            const meta = l.metadata;
+            const matchesPath = (stored) => stored === codePath ||
+                (codePath.endsWith(stored) && codePath[codePath.length - stored.length - 1] === '/');
+            // Check single code_path (latest value, kept for backward compat)
+            if (meta?.code_path && matchesPath(meta.code_path))
+                return true;
+            // Check accumulated code_paths array (populated by PG on-conflict merge)
+            // Only metadata matches belong here — content fallback is handled below to
+            // avoid borrowing a relation from an unrelated bridge edge on the same memory
+            return Array.isArray(meta?.code_paths) && meta.code_paths.some(matchesPath);
+        });
+        // Determine relation for this memory
+        let relation;
+        if (matchingBridgeLinks.length > 0) {
+            relation = matchingBridgeLinks[0].relation;
+        }
+        else {
+            // No matching bridge link found.
+            // Accept content-only matches only when the memory text contains the path.
+            if (!mem.content.includes(codePath))
+                continue;
+            relation = inferBridgeRelation(mem.content, mem.tags);
+            // Apply relation filter for content-inferred matches
+            if (wantRelation && relation !== wantRelation)
+                continue;
+        }
+        if (!seen.has(mem.id)) {
+            seen.add(mem.id);
+            results.push({
+                memoryId: mem.id,
+                content: mem.content,
+                relation,
+                score: mem.similarity ?? 0,
+            });
+        }
+    }
+    return results.slice(0, limit);
+}
+/**
+ * Scan all recent memories and create bridge edges for any that
+ * reference code files. Used during batch processing / maintenance.
+ *
+ * @param limit - Max memories to scan (default: 100)
+ */
+export async function autoBridgeRecentMemories(limit = 100) {
+    const memories = await getRecentMemories(limit);
+    const totals = { created: 0, skipped: 0, errors: 0 };
+    for (const mem of memories) {
+        const codePaths = extractCodePaths(mem.content);
+        if (codePaths.length === 0)
+            continue;
+        const result = await createBridgeEdgesForMemory(mem.id, mem.content, mem.tags, codePaths);
+        totals.created += result.created;
+        totals.skipped += result.skipped;
+        totals.errors += result.errors;
+    }
+    logInfo('bridge-edges', `Auto-bridge scan: ${totals.created} created, ${totals.skipped} skipped`);
+    return totals;
+}
+//# sourceMappingURL=bridge-edges.js.map

package/dist/lib/graph/bridge-edges.js.map

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

package/dist/lib/graph/centrality.d.ts

@@ -23,6 +23,17 @@ export declare function normalizeCentrality(raw: Map<number, number>): Map<numbe
 export declare function updateCentralityCache(): Promise<{
     updated: number;
 }>;
+/**
+ * Compute and cache centrality scores, using PageRank when graphology is
+ * available and falling back to degree centrality otherwise.
+ *
+ * PageRank captures global graph importance better than local degree count:
+ * a node connected to well-connected nodes scores higher than one with many
+ * weak connections.
+ */
+export declare function updateCentralityScores(): Promise<{
+    updated: number;
+}>;
 /**
  * Apply centrality boost to recall results.
  * Adds boostWeight * normalized_degree to similarity score.

package/dist/lib/graph/centrality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"centrality.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/centrality.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAW1D;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAejF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAa1E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACtF,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAed"}
+{"version":3,"file":"centrality.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/centrality.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAY1D;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAejF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB1E;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC3E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACtF,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAed"}

package/dist/lib/graph/centrality.js

@@ -5,6 +5,7 @@
  * More-connected memories get boosted in recall results.
  */
 import { getAllMemoryLinksForExport, upsertCentralityScore, getCentralityScores, } from '../storage/index.js';
+import { logWarn } from '../fault-logger.js';
 // ============================================================================
 // Degree Centrality
 // ============================================================================
@@ -46,10 +47,57 @@ export async function updateCentralityCache() {
     const links = await getAllMemoryLinksForExport();
     const raw = calculateDegreeCentrality(links);
     const normalized = normalizeCentrality(raw);
+    const entries = Array.from(raw.entries()).map(([memId, deg]) => ({
+        memId,
+        degree: deg,
+        normalized: normalized.get(memId) ?? 0,
+    }));
+    // Chunk writes to avoid unbounded fan-out on large graphs
+    const CHUNK_SIZE = 50;
+    for (let i = 0; i < entries.length; i += CHUNK_SIZE) {
+        const chunk = entries.slice(i, i + CHUNK_SIZE);
+        await Promise.all(chunk.map((e) => upsertCentralityScore(e.memId, e.degree, e.normalized)));
+    }
+    return { updated: entries.length };
+}
+/**
+ * Compute and cache centrality scores, using PageRank when graphology is
+ * available and falling back to degree centrality otherwise.
+ *
+ * PageRank captures global graph importance better than local degree count:
+ * a node connected to well-connected nodes scores higher than one with many
+ * weak connections.
+ */
+export async function updateCentralityScores() {
+    let pageRankScores;
+    try {
+        const { computePageRank } = await import('./graphology-bridge.js');
+        pageRankScores = await computePageRank();
+    }
+    catch (err) {
+        logWarn('centrality', 'PageRank unavailable, falling back to degree centrality', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return updateCentralityCache();
+    }
+    if (pageRankScores.size === 0) {
+        return updateCentralityCache();
+    }
+    // Normalize PageRank scores to 0-1 range for upsert
+    let maxScore = 0;
+    for (const score of pageRankScores.values()) {
+        if (score > maxScore)
+            maxScore = score;
+    }
     let count = 0;
-    for (const [memId, deg] of raw) {
-        const norm = normalized.get(memId) ?? 0;
-        await upsertCentralityScore(memId, deg, norm);
+    for (const [memId, score] of pageRankScores) {
+        const normalized = maxScore > 0 ? score / maxScore : 0;
+        // Note: the DB column is named `degree` (from original degree centrality)
+        // but we repurpose it to store the raw PageRank score. Only
+        // `normalized_degree` (0-1 range) is read by consumers
+        // (getCentralityScores), so the raw column's semantics don't affect
+        // downstream behavior.
+        await upsertCentralityScore(memId, score, normalized);
         count++;
     }
     return { updated: count };

package/dist/lib/graph/centrality.js.map

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

package/dist/lib/graph/cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoHvF"}
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAInF,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoHvF"}

package/dist/lib/graph/cleanup.js

@@ -8,8 +8,9 @@ import { getAllMemoryLinksForExport, deleteMemoryLinksByIds, findIsolatedMemoryI
 import { enrichExistingLinks } from './llm-relations.js';
 import { detectCommunities } from './community-detection.js';
 import { updateCentralityCache } from './centrality.js';
+import { getIdleReflectionConfig } from '../config.js';
 export async function graphCleanup(options = {}) {
-    const { pruneThreshold = 0.75, orphanThreshold = 0.6, orphanMaxLinks = 3, skipEnrich = false, skipOrphans = false, skipFinalize = false, dryRun = false, onProgress, } = options;
+    const { pruneThreshold = getIdleReflectionConfig().thresholds.auto_link_threshold ?? 0.75, orphanThreshold = 0.6, orphanMaxLinks = 3, skipEnrich = false, skipOrphans = false, skipFinalize = false, dryRun = false, onProgress, } = options;
     const result = {
         pruned: 0,
         enriched: 0,

package/dist/lib/graph/cleanup.js.map

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

package/dist/lib/graph/community-detection.d.ts

@@ -26,12 +26,15 @@ export declare function buildAdjacencyList(links: Array<{
  * 2. Iteratively: each node adopts the most frequent weighted label of its neighbors
  * 3. Converges when no labels change
  *
- * @returns Map of nodeId → communityId
+ * @returns Object with labels (nodeId → communityId) and actual iteration count
  */
 export declare function labelPropagation(adjacency: Map<number, Array<{
     neighbor: number;
     weight: number;
-}>>, maxIterations?: number, seed?: number): Map<number, number>;
+}>>, maxIterations?: number, seed?: number): {
+    labels: Map<number, number>;
+    iterations: number;
+};
 /**
  * Renumber communities from 0..N for clean output.
  */
@@ -45,8 +48,20 @@ export interface CommunityResult {
     isolated: number;
     iterations: number;
 }
+/**
+ * Detect communities using Label Propagation Algorithm.
+ * Updates memory tags with community:N assignments.
+ * Exported for testing; prefer `detectCommunities()` which tries Louvain first.
+ */
+export declare function detectCommunitiesLP(options?: {
+    maxIterations?: number;
+    minCommunitySize?: number;
+    tagPrefix?: string;
+}): Promise<CommunityResult>;
 /**
  * Detect communities in the memory graph.
+ * Tries Louvain modularity optimization first (higher quality); falls back to
+ * Label Propagation if graphology is unavailable.
  * Updates memory tags with community:N assignments.
  */
 export declare function detectCommunities(options?: {

package/dist/lib/graph/community-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"community-detection.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/community-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAe1D;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EACnE,aAAa,GAAE,MAAY,EAC3B,IAAI,GAAE,MAAW,GAChB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgDrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAapF;AAMD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,OAAO,CAAC,eAAe,CAAC,CA6E1B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAoB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB"}
+{"version":3,"file":"community-detection.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/community-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsCH;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAe1D;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EACnE,aAAa,GAAE,MAAY,EAC3B,IAAI,GAAE,MAAW,GAChB;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAkDrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAapF;AAMD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,OAAO,CAAC,eAAe,CAAC,CAwF1B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,OAAO,CAAC,eAAe,CAAC,CA4B1B;AA2DD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAoB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}