@phren/cli 0.0.10 → 0.0.11

package/mcp/dist/shared-index.js

@@ -49,8 +49,8 @@ async function _drainEmbQueue() {
             await cache.load();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] embeddingQueue cacheLoad: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] embeddingQueue cacheLoad: ${errorMessage(err)}\n`);
         }
         const model = getEmbeddingModel();
         for (const { docPath, content } of docs) {
@@ -62,16 +62,16 @@ async function _drainEmbQueue() {
                     cache.set(docPath, getEmbeddingModel(), vec);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] embeddingQueue embedText: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] embeddingQueue embedText: ${errorMessage(err)}\n`);
             }
         }
         try {
             await cache.flush();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] embeddingQueue cacheFlush: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] embeddingQueue cacheFlush: ${errorMessage(err)}\n`);
         }
     }
 }
@@ -133,8 +133,8 @@ function _resolveImportsRecursive(content, phrenPath, seen, depth) {
             normalized = fs.realpathSync.native(resolved);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] resolveImports realpath: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] resolveImports realpath: ${errorMessage(err)}\n`);
             return `<!-- @import not found: ${trimmed} -->`;
         }
         let normalizedGlobalRoot = globalRoot;
@@ -158,8 +158,8 @@ function _resolveImportsRecursive(content, phrenPath, seen, depth) {
             return _resolveImportsRecursive(imported, phrenPath, childSeen, depth + 1);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] resolveImports fileRead: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] resolveImports fileRead: ${errorMessage(err)}\n`);
             return `<!-- @import error: ${trimmed} -->`;
         }
     });
@@ -180,8 +180,8 @@ function touchSentinel(phrenPath) {
         fs.writeFileSync(sentinelPath, Date.now().toString());
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] touchSentinel: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] touchSentinel: ${errorMessage(err)}\n`);
     }
 }
 function computePhrenHash(phrenPath, profile, preGlobbed) {
@@ -197,8 +197,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
             }
         }
         for (const configPath of topicConfigEntries) {
@@ -207,8 +207,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`topic-config:${configPath}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${errorMessage(err)}\n`);
             }
         }
     }
@@ -239,8 +239,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 }
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash globDir: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash globDir: ${errorMessage(err)}\n`);
             }
         }
         files.sort();
@@ -250,8 +250,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
             }
         }
         for (const configPath of topicConfigEntries) {
@@ -260,8 +260,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`topic-config:${configPath}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash topicConfig: ${errorMessage(err)}\n`);
             }
         }
     }
@@ -271,8 +271,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`native:${mem.fullPath}:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
         }
     }
     // Include global/ files (pulled via @import) so changes invalidate the cache
@@ -286,8 +286,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
                 hash.update(`global:${f}:${stat.mtimeMs}:${stat.size}`);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
             }
         }
     }
@@ -299,8 +299,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`manual-links:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
         }
     }
     const indexPolicyPath = path.join(phrenPath, ".governance", "index-policy.json");
@@ -310,8 +310,8 @@ function computePhrenHash(phrenPath, profile, preGlobbed) {
             hash.update(`index-policy-file:${stat.mtimeMs}:${stat.size}`);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
         }
     }
     if (profile)
@@ -334,8 +334,8 @@ function loadHashMap(phrenPath) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] loadHashMap: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] loadHashMap: ${errorMessage(err)}\n`);
     }
     return { hashes: {} };
 }
@@ -355,8 +355,8 @@ function saveHashMap(phrenPath, hashes) {
                     existing = data.hashes;
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] saveHashMap readExisting: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] saveHashMap readExisting: ${errorMessage(err)}\n`);
             }
             const merged = { ...existing, ...hashes };
             // Remove entries for paths that no longer exist on disk
@@ -494,8 +494,8 @@ function insertFileIntoIndex(db, entry, phrenPath, opts) {
         return true;
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] insertFileIntoIndex: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] insertFileIntoIndex: ${errorMessage(err)}\n`);
         return false;
     }
 }
@@ -575,8 +575,8 @@ 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.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] deleteEntityLinksForDocPath globalEntities: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] deleteEntityLinksForDocPath globalEntities: ${errorMessage(err)}\n`);
     }
 }
 /**
@@ -591,15 +591,15 @@ export function updateFileInIndex(db, filePath, phrenPath) {
         deleteEntityLinksForDocPath(db, phrenPath, resolvedPath);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] updateFileInIndex deleteEntityLinks: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] updateFileInIndex deleteEntityLinks: ${errorMessage(err)}\n`);
     }
     try {
         db.run("DELETE FROM docs WHERE path = ?", [resolvedPath]);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] updateFileInIndex deleteDocs: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] updateFileInIndex deleteDocs: ${errorMessage(err)}\n`);
     }
     // Re-insert if file still exists
     if (fs.existsSync(resolvedPath)) {
@@ -618,8 +618,8 @@ export function updateFileInIndex(db, filePath, phrenPath) {
                     extractAndLinkFragments(db, content, getEntrySourceDocKey(entry, phrenPath), phrenPath);
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] updateFileInIndex entityExtraction: ${err instanceof Error ? err.message : String(err)}\n`);
+                    if ((process.env.PHREN_DEBUG))
+                        process.stderr.write(`[phren] updateFileInIndex entityExtraction: ${errorMessage(err)}\n`);
                 }
             }
         }
@@ -630,8 +630,8 @@ export function updateFileInIndex(db, filePath, phrenPath) {
             saveHashMap(phrenPath, hashData.hashes);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] updateFileInIndex hashMap: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] updateFileInIndex hashMap: ${errorMessage(err)}\n`);
         }
     }
     else {
@@ -644,8 +644,8 @@ export function updateFileInIndex(db, filePath, phrenPath) {
                 await c.flush();
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] updateFileInIndex embeddingDelete: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] updateFileInIndex embeddingDelete: ${errorMessage(err)}\n`);
             }
         })();
     }
@@ -664,8 +664,8 @@ function readHashSentinel(phrenPath) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] readHashSentinel: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] readHashSentinel: ${errorMessage(err)}\n`);
     }
     return null;
 }
@@ -675,8 +675,8 @@ function writeHashSentinel(phrenPath, hash) {
         fs.writeFileSync(sentinelPath, JSON.stringify({ hash, computedAt: Date.now() }));
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] writeHashSentinel: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] writeHashSentinel: ${errorMessage(err)}\n`);
     }
 }
 function isSentinelFresh(phrenPath, sentinel) {
@@ -693,8 +693,8 @@ function isSentinelFresh(phrenPath, sentinel) {
                 return false;
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] isSentinelFresh statDir: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] isSentinelFresh statDir: ${errorMessage(err)}\n`);
         }
     }
     return true;
@@ -715,8 +715,8 @@ function loadCachedEntityGraph(db, graphPath, allFiles, phrenPath) {
                 return fs.statSync(f.fullPath).mtimeMs > graphMtime;
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] loadCachedEntityGraph statFile: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] loadCachedEntityGraph statFile: ${errorMessage(err)}\n`);
                 return true;
             }
         });
@@ -743,8 +743,8 @@ 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.env.PHREN_DEBUG))
-                            process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert2: ${err instanceof Error ? err.message : String(err)}\n`);
+                        if ((process.env.PHREN_DEBUG))
+                            process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert2: ${errorMessage(err)}\n`);
                     }
                 }
             }
@@ -762,23 +762,23 @@ 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.env.PHREN_DEBUG))
-                                    process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert: ${err instanceof Error ? err.message : String(err)}\n`);
+                                if ((process.env.PHREN_DEBUG))
+                                    process.stderr.write(`[phren] loadCachedEntityGraph globalEntitiesInsert: ${errorMessage(err)}\n`);
                             }
                         }
                     }
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] entityGraph globalEntitiesRestore: ${err instanceof Error ? err.message : String(err)}\n`);
+                    if ((process.env.PHREN_DEBUG))
+                        process.stderr.write(`[phren] entityGraph globalEntitiesRestore: ${errorMessage(err)}\n`);
                 }
             }
             return true;
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] entityGraph cacheLoad: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] entityGraph cacheLoad: ${errorMessage(err)}\n`);
     }
     return false;
 }
@@ -797,7 +797,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.env.PHREN_DEBUG))
+                    if ((process.env.PHREN_DEBUG))
                         process.stderr.write(`[phren] manualLinks: pruning stale link to "${link.sourceDoc}"\n`);
                     pruned = true;
                     continue;
@@ -819,14 +819,14 @@ 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.env.PHREN_DEBUG))
-                            process.stderr.write(`[phren] manualLinks globalEntities: ${err instanceof Error ? err.message : String(err)}\n`);
+                        if ((process.env.PHREN_DEBUG))
+                            process.stderr.write(`[phren] manualLinks globalEntities: ${errorMessage(err)}\n`);
                     }
                 }
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] manualLinks entry: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] manualLinks entry: ${errorMessage(err)}\n`);
             }
         }
         // Rewrite manual-links.json if stale entries were pruned
@@ -839,14 +839,14 @@ function mergeManualLinks(db, phrenPath) {
                 });
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] manualLinks prune write: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] manualLinks prune write: ${errorMessage(err)}\n`);
             }
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] mergeManualLinks: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] mergeManualLinks: ${errorMessage(err)}\n`);
     }
 }
 async function buildIndexImpl(phrenPath, profile) {
@@ -859,21 +859,21 @@ async function buildIndexImpl(phrenPath, profile) {
             userSuffix = String(os.userInfo().uid);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] buildIndexImpl userInfo: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] buildIndexImpl userInfo: ${errorMessage(err)}\n`);
             userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
         }
         const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
         // Fast path: if the sentinel is fresh, skip the expensive glob + hash computation
         const sentinel = readHashSentinel(phrenPath);
         let hash;
-        let globResult;
+        let globResult = null;
         if (sentinel && isSentinelFresh(phrenPath, sentinel)) {
             hash = sentinel.hash;
             const cacheFile = path.join(cacheDir, `${hash}.db`);
             if (fs.existsSync(cacheFile)) {
-                // Sentinel cache hit — defer full glob until we actually need it
-                globResult = globAllFiles(phrenPath, profile);
+                // Sentinel cache hit — defer glob; only load it if incremental path needs it
+                globResult = null;
             }
             else {
                 // Cache file was cleaned up, fall through to full computation
@@ -896,6 +896,39 @@ async function buildIndexImpl(phrenPath, profile) {
         const schemaChanged = savedHashData.version !== INDEX_SCHEMA_VERSION;
         // Try loading cached DB for incremental update
         if (!schemaChanged && fs.existsSync(cacheFile)) {
+            // Pure sentinel hit: glob was skipped, return DB without computing file diffs
+            if (!globResult) {
+                try {
+                    const cached = fs.readFileSync(cacheFile);
+                    const db = new SQL.Database(cached);
+                    const docCountResult = db.exec("SELECT COUNT(*) FROM docs");
+                    const docCount = docCountResult?.[0]?.values?.[0]?.[0] ?? 0;
+                    if (docCount > 0) {
+                        try {
+                            db.run("ALTER TABLE entities ADD COLUMN first_seen_at TEXT");
+                        }
+                        catch { /* column already exists */ }
+                        debugLog(`Loaded FTS index from cache (${hash.slice(0, 8)}) in ${Date.now() - t0}ms [sentinel-hit]`);
+                        appendIndexEvent(phrenPath, {
+                            event: "build_index",
+                            cache: "hit",
+                            hash: hash.slice(0, 12),
+                            elapsedMs: Date.now() - t0,
+                            profile: profile || "",
+                        });
+                        return db;
+                    }
+                    // Empty DB — fall through to full rebuild with glob
+                    db.close();
+                }
+                catch (err) {
+                    debugLog(`sentinel-hit DB load failed, falling back to full rebuild: ${errorMessage(err)}`);
+                }
+                // Need glob for rebuild
+                globResult = globAllFiles(phrenPath, profile);
+                hash = computePhrenHash(phrenPath, profile, globResult.filePaths);
+                writeHashSentinel(phrenPath, hash);
+            }
             try {
                 const cached = fs.readFileSync(cacheFile);
                 let db;
@@ -932,8 +965,8 @@ async function buildIndexImpl(phrenPath, profile) {
                             }
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex hashFile: ${err instanceof Error ? err.message : String(err)}\n`);
+                            if ((process.env.PHREN_DEBUG))
+                                process.stderr.write(`[phren] buildIndex hashFile: ${errorMessage(err)}\n`);
                         }
                     }
                     // Check for files missing from the index (deleted files)
@@ -968,27 +1001,27 @@ async function buildIndexImpl(phrenPath, profile) {
                                     deleteEntityLinksForDocPath(db, phrenPath, missingPath);
                                 }
                                 catch (err) {
-                                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                        process.stderr.write(`[phren] buildIndex deleteEntityLinksForMissing: ${err instanceof Error ? err.message : String(err)}\n`);
+                                    if ((process.env.PHREN_DEBUG))
+                                        process.stderr.write(`[phren] buildIndex deleteEntityLinksForMissing: ${errorMessage(err)}\n`);
                                 }
                                 try {
                                     db.run("DELETE FROM docs WHERE path = ?", [missingPath]);
                                 }
                                 catch (err) {
-                                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                        process.stderr.write(`[phren] buildIndex deleteDocForMissing: ${err instanceof Error ? err.message : String(err)}\n`);
+                                    if ((process.env.PHREN_DEBUG))
+                                        process.stderr.write(`[phren] buildIndex deleteDocForMissing: ${errorMessage(err)}\n`);
                                 }
                             }
                             db.run("COMMIT");
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex incrementalDeleteCommit: ${err instanceof Error ? err.message : String(err)}\n`);
+                            if ((process.env.PHREN_DEBUG))
+                                process.stderr.write(`[phren] buildIndex incrementalDeleteCommit: ${errorMessage(err)}\n`);
                             try {
                                 db.run("ROLLBACK");
                             }
                             catch (e2) {
-                                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                if ((process.env.PHREN_DEBUG))
                                     process.stderr.write(`[phren] buildIndex incrementalDeleteRollback: ${e2 instanceof Error ? e2.message : String(e2)}\n`);
                             }
                         }
@@ -1025,7 +1058,7 @@ async function buildIndexImpl(phrenPath, profile) {
                                     db.run("ROLLBACK");
                                 }
                                 catch (e2) {
-                                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                    if ((process.env.PHREN_DEBUG))
                                         process.stderr.write(`[phren] buildIndex perFileRollback: ${e2 instanceof Error ? e2.message : String(e2)}\n`);
                                 }
                                 throw err;
@@ -1040,8 +1073,8 @@ async function buildIndexImpl(phrenPath, profile) {
                             fs.writeFileSync(cacheFile, db.export());
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] buildIndex incrementalCacheSave: ${err instanceof Error ? err.message : String(err)}\n`);
+                            if ((process.env.PHREN_DEBUG))
+                                process.stderr.write(`[phren] buildIndex incrementalCacheSave: ${errorMessage(err)}\n`);
                         }
                         const incMs = Date.now() - t0;
                         debugLog(`Incremental FTS update: ${updatedCount} changed, ${missingFromIndex.length} removed in ${incMs}ms`);
@@ -1069,6 +1102,12 @@ async function buildIndexImpl(phrenPath, profile) {
             }
         }
         // ── Full rebuild ──────────────────────────────────────────────────────────
+        // Ensure glob data is available for full rebuild (may be null from sentinel fast-path fallback)
+        if (!globResult) {
+            globResult = globAllFiles(phrenPath, profile);
+            hash = computePhrenHash(phrenPath, profile, globResult.filePaths);
+            writeHashSentinel(phrenPath, hash);
+        }
         const db = new SQL.Database();
         db.run(`
     CREATE VIRTUAL TABLE docs USING fts5(
@@ -1092,8 +1131,8 @@ async function buildIndexImpl(phrenPath, profile) {
                 newHashes[entry.fullPath] = hashFileContent(entry.fullPath);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] computePhrenHash skip: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] computePhrenHash skip: ${errorMessage(err)}\n`);
             }
             if (insertFileIntoIndex(db, entry, phrenPath, { scheduleEmbeddings: true })) {
                 fileCount++;
@@ -1120,8 +1159,8 @@ 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.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] buildIndex entityGraphPersist: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] buildIndex entityGraphPersist: ${errorMessage(err)}\n`);
             }
         }
         // Always merge manual links (survive rebuild)
@@ -1132,7 +1171,7 @@ async function buildIndexImpl(phrenPath, profile) {
         invalidateDfCache();
         const buildMs = Date.now() - t0;
         debugLog(`Built FTS index: ${fileCount} files from ${getProjectDirs(phrenPath, profile).length} projects in ${buildMs}ms`);
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+        if ((process.env.PHREN_DEBUG))
             console.error(`Indexed ${fileCount} files from ${getProjectDirs(phrenPath, profile).length} projects`);
         appendIndexEvent(phrenPath, {
             event: "build_index",
@@ -1153,8 +1192,8 @@ async function buildIndexImpl(phrenPath, profile) {
                     fs.unlinkSync(path.join(cacheDir, f));
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] buildIndex staleCacheCleanup: ${err instanceof Error ? err.message : String(err)}\n`);
+                    if ((process.env.PHREN_DEBUG))
+                        process.stderr.write(`[phren] buildIndex staleCacheCleanup: ${errorMessage(err)}\n`);
                 }
             }
             debugLog(`Saved FTS index cache (${hash.slice(0, 8)}) — total ${Date.now() - t0}ms`);
@@ -1190,8 +1229,8 @@ function isRebuildLockHeld(phrenPath) {
         return Date.now() - stat.mtimeMs <= staleThreshold;
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] isRebuildLockHeld stat: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] isRebuildLockHeld stat: ${errorMessage(err)}\n`);
         return false;
     }
 }
@@ -1202,8 +1241,8 @@ async function loadIndexSnapshotOrEmpty(phrenPath, profile) {
         userSuffix = String(os.userInfo().uid);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] loadIndexSnapshotOrEmpty userInfo: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] loadIndexSnapshotOrEmpty userInfo: ${errorMessage(err)}\n`);
         userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
     }
     const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
@@ -1303,8 +1342,8 @@ export function findFtsCacheForPath(phrenPath, profile) {
         userSuffix = String(os.userInfo().uid);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] findFtsCacheForPath userInfo: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] findFtsCacheForPath userInfo: ${errorMessage(err)}\n`);
         userSuffix = crypto.createHash("sha1").update(homeDir()).digest("hex").slice(0, 12);
     }
     const cacheDir = path.join(os.tmpdir(), `phren-fts-${userSuffix}`);
@@ -1318,8 +1357,8 @@ export function findFtsCacheForPath(phrenPath, profile) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] findFtsCacheForPath: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] findFtsCacheForPath: ${errorMessage(err)}\n`);
     }
     return { exists: false };
 }