@phren/cli 0.0.27 → 0.0.32

package/mcp/dist/{shared-index.js → shared/index.js}

@@ -3,21 +3,22 @@ import * as path from "path";
 import * as os from "os";
 import * as crypto from "crypto";
 import { globSync } from "glob";
-import { debugLog, appendIndexEvent, getProjectDirs, collectNativeMemoryFiles, runtimeFile, homeDir, readRootManifest, } from "./shared.js";
-import { getIndexPolicy, withFileLock } from "./shared-governance.js";
-import { stripTaskDoneSection } from "./shared-content.js";
-import { isInactiveFindingLine } from "./finding-lifecycle.js";
-import { invalidateDfCache } from "./shared-search-fallback.js";
-import { errorMessage } from "./utils.js";
-import { beginUserFragmentBuildCache, endUserFragmentBuildCache, extractAndLinkFragments, ensureGlobalEntitiesTable, } from "./shared-fragment-graph.js";
-import { bootstrapSqlJs } from "./shared-sqljs.js";
-import { getProjectOwnershipMode, getProjectSourcePath, readProjectConfig } from "./project-config.js";
-import { buildSourceDocKey, queryDocBySourceKey, queryDocRows, } from "./index-query.js";
-import { classifyTopicForText, readProjectTopics, } from "./project-topics.js";
-export { porterStem } from "./shared-stemmer.js";
-export { cosineFallback } from "./shared-search-fallback.js";
-export { queryFragmentLinks, queryFragmentLinks as queryEntityLinks, getFragmentBoostDocs, getFragmentBoostDocs as getEntityBoostDocs, ensureGlobalEntitiesTable, queryCrossProjectFragments, logFragmentMiss, logFragmentMiss as logEntityMiss, extractFragmentNames, extractFragmentNames as extractEntityNames, } from "./shared-fragment-graph.js";
-export { buildSourceDocKey, decodeFiniteNumber, decodeStringRow, extractSnippet, getDocSourceKey, normalizeMemoryId, queryDocBySourceKey, queryDocRows, queryRows, rowToDoc, rowToDocWithRowid, } from "./index-query.js";
+import { debugLog, appendIndexEvent, getProjectDirs, collectNativeMemoryFiles, runtimeFile, homeDir, readRootManifest, } from "../shared.js";
+import { getIndexPolicy, withFileLock } from "./governance.js";
+import { stripTaskDoneSection } from "./content.js";
+import { isInactiveFindingLine } from "../finding/lifecycle.js";
+import { invalidateDfCache } from "./search-fallback.js";
+import { errorMessage } from "../utils.js";
+import { logger } from "../logger.js";
+import { beginUserFragmentBuildCache, endUserFragmentBuildCache, extractAndLinkFragments, ensureGlobalEntitiesTable, } from "./fragment-graph.js";
+import { bootstrapSqlJs } from "./sqljs.js";
+import { getProjectOwnershipMode, getProjectSourcePath, readProjectConfig } from "../project-config.js";
+import { buildSourceDocKey, queryDocBySourceKey, queryDocRows, } from "../index-query.js";
+import { classifyTopicForText, readProjectTopics, } from "../project-topics.js";
+export { porterStem } from "./stemmer.js";
+export { cosineFallback } from "./search-fallback.js";
+export { queryFragmentLinks, queryFragmentLinks as queryEntityLinks, getFragmentBoostDocs, getFragmentBoostDocs as getEntityBoostDocs, ensureGlobalEntitiesTable, queryCrossProjectFragments, logFragmentMiss, logFragmentMiss as logEntityMiss, extractFragmentNames, extractFragmentNames as extractEntityNames, } from "./fragment-graph.js";
+export { buildSourceDocKey, decodeFiniteNumber, decodeStringRow, extractSnippet, getDocSourceKey, normalizeMemoryId, queryDocBySourceKey, queryDocRows, queryRows, rowToDoc, rowToDocWithRowid, } from "../index-query.js";
 // ── Async embedding queue ───────────────────────────────────────────────────
 const _embQueue = new Map();
 let _embTimer = null;
@@ -32,8 +33,8 @@ function scheduleEmbedding(phrenPath, docPath, content) {
 async function _drainEmbQueue() {
     if (_embQueue.size === 0)
         return;
-    const { embedText, getEmbeddingModel } = await import("./shared-ollama.js");
-    const { getEmbeddingCache } = await import("./shared-embedding-cache.js");
+    const { embedText, getEmbeddingModel } = await import("./ollama.js");
+    const { getEmbeddingCache } = await import("./embedding-cache.js");
     const entries = [..._embQueue.entries()];
     _embQueue.clear();
     // Group by phrenPath so we flush each cache once after all its entries are set.
@@ -49,8 +50,7 @@ async function _drainEmbQueue() {
             await cache.load();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] embeddingQueue cacheLoad: ${errorMessage(err)}\n`);
+            logger.debug("embeddingQueue cacheLoad", errorMessage(err));
         }
         const model = getEmbeddingModel();
         for (const { docPath, content } of docs) {
@@ -62,16 +62,14 @@ async function _drainEmbQueue() {
                     cache.set(docPath, getEmbeddingModel(), vec);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] embeddingQueue embedText: ${errorMessage(err)}\n`);
+                logger.debug("embeddingQueue embedText", errorMessage(err));
             }
         }
         try {
             await cache.flush();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] embeddingQueue cacheFlush: ${errorMessage(err)}\n`);
+            logger.debug("embeddingQueue cacheFlush", errorMessage(err));
         }
     }
 }
@@ -133,8 +131,7 @@ function _resolveImportsRecursive(content, phrenPath, seen, depth) {
             normalized = fs.realpathSync.native(resolved);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] resolveImports realpath: ${errorMessage(err)}\n`);
+            logger.debug("resolveImports realpath", errorMessage(err));
             return `<!-- @import not found: ${trimmed} -->`;
         }
         let normalizedGlobalRoot = globalRoot;
@@ -158,8 +155,7 @@ function _resolveImportsRecursive(content, phrenPath, seen, depth) {
             return _resolveImportsRecursive(imported, phrenPath, childSeen, depth + 1);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] resolveImports fileRead: ${errorMessage(err)}\n`);
+            logger.debug("resolveImports fileRead", errorMessage(err));
             return `<!-- @import error: ${trimmed} -->`;
         }
     });
@@ -180,8 +176,7 @@ function touchSentinel(phrenPath) {
         fs.writeFileSync(sentinelPath, Date.now().toString());
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] touchSentinel: ${errorMessage(err)}\n`);
+        logger.debug("touchSentinel", errorMessage(err));
     }
 }
 function computePhrenHash(phrenPath, profile, preGlobbed) {
@@ -197,8 +192,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash skip", errorMessage(err));
             }
         }
         for (const configPath of topicConfigEntries) {
@@ -207,8 +201,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`topic-config:${configPath}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash topicConfig", errorMessage(err));
             }
         }
     }
@@ -239,8 +232,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 }
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash globDir: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash globDir", errorMessage(err));
             }
         }
         files.sort();
@@ -250,8 +242,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash skip", errorMessage(err));
             }
         }
         for (const configPath of topicConfigEntries) {
@@ -260,8 +251,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`topic-config:${configPath}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash topicConfig", errorMessage(err));
             }
         }
     }
@@ -271,8 +261,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`native:${mem.fullPath}:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+            logger.debug("computePhrenHash skip", errorMessage(err));
         }
     }
     // Include global/ files (pulled via @import) so changes invalidate the cache
@@ -286,8 +275,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`global:${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash skip", errorMessage(err));
             }
         }
     }
@@ -299,8 +287,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`manual-links:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+            logger.debug("computePhrenHash skip", errorMessage(err));
         }
     }
     const indexPolicyPath = path.join(phrenPath, ".config", "index-policy.json");
@@ -310,8 +297,7 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`index-policy-file:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+            logger.debug("computePhrenHash skip", errorMessage(err));
         }
     }
     if (profile)
@@ -334,8 +320,7 @@ function loadHashMap(phrenPath) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] loadHashMap: ${errorMessage(err)}\n`);
+        logger.debug("loadHashMap", errorMessage(err));
     }
     return { hashes: {} };
 }
@@ -355,8 +340,7 @@ function saveHashMap(phrenPath, hashes) {
                     existing = data.hashes;
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] saveHashMap readExisting: ${errorMessage(err)}\n`);
+                logger.debug("saveHashMap readExisting", errorMessage(err));
             }
             const merged = { ...existing, ...hashes };
             // Remove entries for paths that no longer exist on disk
@@ -494,8 +478,7 @@ function insertFileIntoIndex(db, entry, phrenPath, opts) {
         return true;
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] insertFileIntoIndex: ${errorMessage(err)}\n`);
+        logger.debug("insertFileIntoIndex", errorMessage(err));
         return false;
     }
 }
@@ -575,8 +558,7 @@ function deleteEntityLinksForDocPath(db, phrenPath, docPath, fallbackProject, fa
         db.run("DELETE FROM global_entities WHERE doc_key = ?", [sourceDoc]);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] deleteEntityLinksForDocPath globalEntities: ${errorMessage(err)}\n`);
+        logger.debug("deleteEntityLinksForDocPath globalEntities", errorMessage(err));
     }
 }
 /**
@@ -591,15 +573,13 @@ export function updateFileInIndex(db, filePath, phrenPath) {
         deleteEntityLinksForDocPath(db, phrenPath, resolvedPath);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] updateFileInIndex deleteEntityLinks: ${errorMessage(err)}\n`);
+        logger.debug("updateFileInIndex deleteEntityLinks", errorMessage(err));
     }
     try {
         db.run("DELETE FROM docs WHERE path = ?", [resolvedPath]);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] updateFileInIndex deleteDocs: ${errorMessage(err)}\n`);
+        logger.debug("updateFileInIndex deleteDocs", errorMessage(err));
     }
     // Re-insert if file still exists
     if (fs.existsSync(resolvedPath)) {
@@ -618,8 +598,7 @@ export function updateFileInIndex(db, filePath, phrenPath) {
                     extractAndLinkFragments(db, content, getEntrySourceDocKey(entry, phrenPath), phrenPath);
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] updateFileInIndex entityExtraction: ${errorMessage(err)}\n`);
+                    logger.debug("updateFileInIndex entityExtraction", errorMessage(err));
                 }
             }
         }
@@ -630,22 +609,20 @@ export function updateFileInIndex(db, filePath, phrenPath) {
             saveHashMap(phrenPath, hashData.hashes);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] updateFileInIndex hashMap: ${errorMessage(err)}\n`);
+            logger.debug("updateFileInIndex hashMap", errorMessage(err));
         }
     }
     else {
         // Remove stale embedding if file was deleted
         void (async () => {
             try {
-                const { getEmbeddingCache } = await import("./shared-embedding-cache.js");
+                const { getEmbeddingCache } = await import("./embedding-cache.js");
                 const c = getEmbeddingCache(phrenPath);
                 c.delete(resolvedPath);
                 await c.flush();
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] updateFileInIndex embeddingDelete: ${errorMessage(err)}\n`);
+                logger.debug("updateFileInIndex embeddingDelete", errorMessage(err));
             }
         })();
     }
@@ -664,8 +641,7 @@ function readHashSentinel(phrenPath) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] readHashSentinel: ${errorMessage(err)}\n`);
+        logger.debug("readHashSentinel", errorMessage(err));
     }
     return null;
 }
@@ -675,8 +651,7 @@ function writeHashSentinel(phrenPath, hash) {
         fs.writeFileSync(sentinelPath, JSON.stringify({ hash, computedAt: Date.now() }));
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] writeHashSentinel: ${errorMessage(err)}\n`);
+        logger.debug("writeHashSentinel", errorMessage(err));
     }
 }
 function isSentinelFresh(phrenPath, sentinel) {
@@ -693,8 +668,7 @@ function isSentinelFresh(phrenPath, sentinel) {
                 return false;
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] isSentinelFresh statDir: ${errorMessage(err)}\n`);
+            logger.debug("isSentinelFresh statDir", errorMessage(err));
         }
     }
     return true;
@@ -715,8 +689,7 @@ function loadCachedEntityGraph(db, graphPath, allFiles, phrenPath) {
                 return fs.statSync(f.fullPath).mtimeMs > graphMtime;
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] loadCachedEntityGraph statFile: ${errorMessage(err)}\n`);
+                logger.debug("loadCachedEntityGraph statFile", errorMessage(err));
                 return true;
             }
         });
@@ -743,8 +716,7 @@ function loadCachedEntityGraph(db, graphPath, allFiles, phrenPath) {
                         db.run("INSERT OR IGNORE INTO global_entities (entity, project, doc_key) VALUES (?, ?, ?)", [entity, project, docKey]);
                     }
                     catch (err) {
-                        if ((process.env.PHREN_DEBUG))
-                            process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert2: ${errorMessage(err)}\n`);
+                        logger.debug("loadCachedEntityGraph globalEntitiesInsert2", errorMessage(err));
                     }
                 }
             }
@@ -762,23 +734,20 @@ function loadCachedEntityGraph(db, graphPath, allFiles, phrenPath) {
                                 db.run("INSERT OR IGNORE INTO global_entities (entity, project, doc_key) VALUES (?, ?, ?)", [name, proj, sourceDoc]);
                             }
                             catch (err) {
-                                if ((process.env.PHREN_DEBUG))
-                                    process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert: ${errorMessage(err)}\n`);
+                                logger.debug("loadCachedEntityGraph globalEntitiesInsert", errorMessage(err));
                             }
                         }
                     }
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] entityGraph globalEntitiesRestore: ${errorMessage(err)}\n`);
+                    logger.debug("entityGraph globalEntitiesRestore", errorMessage(err));
                 }
             }
             return true;
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] entityGraph cacheLoad: ${errorMessage(err)}\n`);
+        logger.debug("entityGraph cacheLoad", errorMessage(err));
     }
     return false;
 }
@@ -797,8 +766,7 @@ function mergeManualLinks(db, phrenPath) {
                 // Validate: skip manual links whose sourceDoc no longer exists in the index
                 const docCheck = queryDocBySourceKey(db, phrenPath, link.sourceDoc);
                 if (!docCheck) {
-                    if ((process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] manualLinks: pruning stale link to "${link.sourceDoc}"\n`);
+                    logger.debug("manualLinks", `pruning stale link to "${link.sourceDoc}"`);
                     pruned = true;
                     continue;
                 }
@@ -819,14 +787,12 @@ function mergeManualLinks(db, phrenPath) {
                         db.run("INSERT OR IGNORE INTO global_entities (entity, project, doc_key) VALUES (?, ?, ?)", [link.entity, projectMatch[1], link.sourceDoc]);
                     }
                     catch (err) {
-                        if ((process.env.PHREN_DEBUG))
-                            process.stderr.write(`[phren] manualLinks globalEntities: ${errorMessage(err)}\n`);
+                        logger.debug("manualLinks globalEntities", errorMessage(err));
                     }
                 }
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] manualLinks entry: ${errorMessage(err)}\n`);
+                logger.debug("manualLinks entry", errorMessage(err));
             }
         }
         // Rewrite manual-links.json if stale entries were pruned
@@ -839,14 +805,12 @@ function mergeManualLinks(db, phrenPath) {
                 });
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] manualLinks prune write: ${errorMessage(err)}\n`);
+                logger.debug("manualLinks prune write", errorMessage(err));
             }
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] mergeManualLinks: ${errorMessage(err)}\n`);
+        logger.debug("mergeManualLinks", errorMessage(err));
     }
 }
 async function buildIndexImpl(phrenPath, profile) {
@@ -859,8 +823,7 @@ async function buildIndexImpl(phrenPath, profile) {
             userSuffix = String(os.userInfo().uid);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] buildIndexImpl userInfo: ${errorMessage(err)}\n`);
+            logger.debug("buildIndexImpl userInfo", errorMessage(err));
             userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
         }
         const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
@@ -965,8 +928,7 @@ async function buildIndexImpl(phrenPath, profile) {
                             }
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex hashFile: ${errorMessage(err)}\n`);
+                            logger.debug("buildIndex hashFile", errorMessage(err));
                         }
                     }
                     // Check for files missing from the index (deleted files)
@@ -1001,28 +963,24 @@ async function buildIndexImpl(phrenPath, profile) {
                                     deleteEntityLinksForDocPath(db, phrenPath, missingPath);
                                 }
                                 catch (err) {
-                                    if ((process.env.PHREN_DEBUG))
-                                        process.stderr.write(`[phren] buildIndex deleteEntityLinksForMissing: ${errorMessage(err)}\n`);
+                                    logger.debug("buildIndex deleteEntityLinksForMissing", errorMessage(err));
                                 }
                                 try {
                                     db.run("DELETE FROM docs WHERE path = ?", [missingPath]);
                                 }
                                 catch (err) {
-                                    if ((process.env.PHREN_DEBUG))
-                                        process.stderr.write(`[phren] buildIndex deleteDocForMissing: ${errorMessage(err)}\n`);
+                                    logger.debug("buildIndex deleteDocForMissing", errorMessage(err));
                                 }
                             }
                             db.run("COMMIT");
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex incrementalDeleteCommit: ${errorMessage(err)}\n`);
+                            logger.debug("buildIndex incrementalDeleteCommit", errorMessage(err));
                             try {
                                 db.run("ROLLBACK");
                             }
                             catch (e2) {
-                                if ((process.env.PHREN_DEBUG))
-                                    process.stderr.write(`[phren] buildIndex incrementalDeleteRollback: ${e2 instanceof Error ? e2.message : String(e2)}\n`);
+                                logger.debug("buildIndex incrementalDeleteRollback", e2 instanceof Error ? e2.message : String(e2));
                             }
                         }
                         let updatedCount = 0;
@@ -1058,8 +1016,7 @@ async function buildIndexImpl(phrenPath, profile) {
                                     db.run("ROLLBACK");
                                 }
                                 catch (e2) {
-                                    if ((process.env.PHREN_DEBUG))
-                                        process.stderr.write(`[phren] buildIndex perFileRollback: ${e2 instanceof Error ? e2.message : String(e2)}\n`);
+                                    logger.debug("buildIndex perFileRollback", e2 instanceof Error ? e2.message : String(e2));
                                 }
                                 throw err;
                             }
@@ -1073,8 +1030,7 @@ async function buildIndexImpl(phrenPath, profile) {
                             fs.writeFileSync(cacheFile, db.export());
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex incrementalCacheSave: ${errorMessage(err)}\n`);
+                            logger.debug("buildIndex incrementalCacheSave", errorMessage(err));
                         }
                         const incMs = Date.now() - t0;
                         debugLog(`Incremental FTS update: ${updatedCount} changed, ${missingFromIndex.length} removed in ${incMs}ms`);
@@ -1131,8 +1087,7 @@ async function buildIndexImpl(phrenPath, profile) {
                 newHashes[entry.fullPath] = hashFileContent(entry.fullPath);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
+                logger.debug("computePhrenHash skip", errorMessage(err));
             }
             if (insertFileIntoIndex(db, entry, phrenPath, { scheduleEmbeddings: true })) {
                 fileCount++;
@@ -1159,8 +1114,7 @@ async function buildIndexImpl(phrenPath, profile) {
                 fs.writeFileSync(graphPath, JSON.stringify({ entities: entityRows, links: linkRows, globalEntities: globalEntityRows, ts: Date.now() }));
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] buildIndex entityGraphPersist: ${errorMessage(err)}\n`);
+                logger.debug("buildIndex entityGraphPersist", errorMessage(err));
             }
         }
         // Always merge manual links (survive rebuild)
@@ -1192,8 +1146,7 @@ async function buildIndexImpl(phrenPath, profile) {
                     fs.unlinkSync(path.join(cacheDir, f));
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] buildIndex staleCacheCleanup: ${errorMessage(err)}\n`);
+                    logger.debug("buildIndex staleCacheCleanup", errorMessage(err));
                 }
             }
             debugLog(`Saved FTS index cache (${hash.slice(0, 8)}) — total ${Date.now() - t0}ms`);
@@ -1229,8 +1182,7 @@ function isRebuildLockHeld(phrenPath) {
         return Date.now() - stat.mtimeMs <= staleThreshold;
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] isRebuildLockHeld stat: ${errorMessage(err)}\n`);
+        logger.debug("isRebuildLockHeld stat", errorMessage(err));
         return false;
     }
 }
@@ -1241,8 +1193,7 @@ async function loadIndexSnapshotOrEmpty(phrenPath, profile) {
         userSuffix = String(os.userInfo().uid);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] loadIndexSnapshotOrEmpty userInfo: ${errorMessage(err)}\n`);
+        logger.debug("loadIndexSnapshotOrEmpty userInfo", errorMessage(err));
         userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
     }
     const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
@@ -1257,7 +1208,27 @@ async function loadIndexSnapshotOrEmpty(phrenPath, profile) {
             debugLog(`Failed to open cached FTS snapshot while rebuild lock held: ${errorMessage(err)}`);
         }
     }
-    debugLog("FTS rebuild already in progress; returning empty snapshot");
+    // Before returning empty, try to load any stale-but-usable cache file
+    try {
+        if (fs.existsSync(cacheDir)) {
+            const cacheFiles = fs.readdirSync(cacheDir)
+                .filter(f => f.endsWith(".db"))
+                .map(f => ({ name: f, mtime: fs.statSync(path.join(cacheDir, f)).mtimeMs }))
+                .sort((a, b) => b.mtime - a.mtime);
+            for (const cf of cacheFiles) {
+                try {
+                    const staleDb = new SQL.Database(fs.readFileSync(path.join(cacheDir, cf.name)));
+                    debugLog(`FTS rebuild in progress; falling back to stale cache: ${cf.name}`);
+                    return staleDb;
+                }
+                catch { /* try next */ }
+            }
+        }
+    }
+    catch (err) {
+        debugLog(`Failed to scan stale FTS caches: ${errorMessage(err)}`);
+    }
+    debugLog("FTS rebuild already in progress; no usable cache found, returning empty snapshot");
     return createEmptyIndexDb(SQL);
 }
 // Serialize concurrent in-process buildIndex calls to prevent SQLite corruption
@@ -1342,8 +1313,7 @@ export function findFtsCacheForPath(phrenPath, profile) {
         userSuffix = String(os.userInfo().uid);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] findFtsCacheForPath userInfo: ${errorMessage(err)}\n`);
+        logger.debug("findFtsCacheForPath userInfo", errorMessage(err));
         userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
     }
     const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
@@ -1357,8 +1327,7 @@ export function findFtsCacheForPath(phrenPath, profile) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] findFtsCacheForPath: ${errorMessage(err)}\n`);
+        logger.debug("findFtsCacheForPath", errorMessage(err));
     }
     return { exists: false };
 }

package/mcp/dist/{shared-ollama.js → shared/ollama.js}

@@ -1,4 +1,4 @@
-import { debugLog } from "./shared.js";
+import { debugLog } from "../shared.js";
 const DEFAULT_OLLAMA_URL = "http://localhost:11434";
 const DEFAULT_EMBEDDING_MODEL = "nomic-embed-text";
 const DEFAULT_EXTRACT_MODEL = "llama3.2";
@@ -178,4 +178,4 @@ export async function generateText(prompt, model, url) {
         return null;
     }
 }
-export { cosineSimilarity } from "./embedding.js";
+export { cosineSimilarity } from "../embedding.js";

package/mcp/dist/{shared-retrieval.js → shared/retrieval.js}

@@ -1,17 +1,18 @@
 // shared-retrieval.ts — shared retrieval core used by hooks and MCP search.
-import { getQualityMultiplier, entryScoreKey, } from "./shared-governance.js";
-import { queryDocRows, queryRows, cosineFallback, extractSnippet, getDocSourceKey, getEntityBoostDocs, decodeFiniteNumber, rowToDocWithRowid, buildIndex, } from "./shared-index.js";
-import { filterTrustedFindingsDetailed, } from "./shared-content.js";
-import { parseCitationComment } from "./content-citation.js";
-import { getHighImpactFindings } from "./finding-impact.js";
-import { buildFtsQueryVariants, buildRelaxedFtsQuery, isFeatureEnabled, STOP_WORDS, errorMessage } from "./utils.js";
+import { getQualityMultiplier, entryScoreKey, } from "./governance.js";
+import { queryDocRows, queryRows, cosineFallback, extractSnippet, getDocSourceKey, getEntityBoostDocs, decodeFiniteNumber, rowToDocWithRowid, buildIndex, } from "./index.js";
+import { filterTrustedFindingsDetailed, } from "./content.js";
+import { parseCitationComment } from "../content/citation.js";
+import { getHighImpactFindings } from "../finding/impact.js";
+import { buildFtsQueryVariants, buildRelaxedFtsQuery, isFeatureEnabled, STOP_WORDS, errorMessage } from "../utils.js";
+import { logger } from "../logger.js";
 import * as fs from "fs";
 import * as path from "path";
-import { getProjectGlobBoost } from "./cli-hooks-globs.js";
-import { vectorFallback, deterministicSeed } from "./shared-search-fallback.js";
-import { getOllamaUrl, getCloudEmbeddingUrl } from "./shared-ollama.js";
-import { keywordFallbackSearch } from "./core-search.js";
-import { debugLog } from "./shared.js";
+import { getProjectGlobBoost } from "../cli/hooks-globs.js";
+import { vectorFallback, deterministicSeed } from "./search-fallback.js";
+import { getOllamaUrl, getCloudEmbeddingUrl } from "./ollama.js";
+import { keywordFallbackSearch } from "../core/search.js";
+import { debugLog } from "../shared.js";
 // ── Scoring constants ─────────────────────────────────────────────────────────
 /** Number of docs sampled for token-overlap semantic fallback search. */
 const SEMANTIC_FALLBACK_SAMPLE_LIMIT = 100;
@@ -383,8 +384,7 @@ export async function searchDocumentsAsync(db, safeQuery, prompt, keywords, dete
     }
     catch (err) {
         // Vector search failure is non-fatal — return sync result
-        if ((process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] hybridSearch vectorFallback: ${errorMessage(err)}\n`);
+        logger.debug("hybridSearch vectorFallback", errorMessage(err));
         return syncResult;
     }
 }
@@ -483,9 +483,7 @@ export async function searchKnowledgeRows(db, options) {
             }
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG)) {
-                process.stderr.write(`[phren] vectorFallback: ${errorMessage(err)}\n`);
-            }
+            logger.debug("vectorFallback", errorMessage(err));
         }
     }
     return { safeQuery, rows, usedFallback };
@@ -523,9 +521,7 @@ export async function searchFederatedStores(localPhrenPath, options) {
             }
         }
         catch (err) {
-            if (process.env.PHREN_DEBUG) {
-                process.stderr.write(`[phren] federatedSearch storePath=${storePath}: ${errorMessage(err)}\n`);
-            }
+            logger.debug(`federatedSearch storePath=${storePath}`, errorMessage(err));
             // Federation errors are non-fatal — continue with other stores
         }
     }
@@ -771,8 +767,7 @@ export function markStaleCitations(snippet) {
                             }
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] applyCitationAnnotations fileRead: ${errorMessage(err)}\n`);
+                            logger.debug("applyCitationAnnotations fileRead", errorMessage(err));
                             stale = true;
                         }
                     }