@phren/cli 0.0.11 → 0.0.12

package/mcp/dist/session-checkpoints.js

@@ -110,21 +110,21 @@ export function clearTaskCheckpoint(phrenPath, args) {
             debugLog(`checkpoint clear ${filePath}: ${errorMessage(err)}`);
         }
     }
-    const allProjectCheckpoints = listTaskCheckpoints(phrenPath, args.project);
-    for (const checkpoint of allProjectCheckpoints) {
-        const idMatch = ids.size > 0 && ids.has(checkpoint.taskId);
-        const lineMatch = args.taskLine && checkpoint.taskLine === args.taskLine;
-        if (!idMatch && !lineMatch)
-            continue;
-        const filePath = checkpointPath(phrenPath, checkpoint.project, checkpoint.taskId);
-        try {
-            if (fs.existsSync(filePath)) {
-                fs.unlinkSync(filePath);
-                removed++;
+    if (args.taskLine) {
+        const allProjectCheckpoints = listTaskCheckpoints(phrenPath, args.project);
+        for (const checkpoint of allProjectCheckpoints) {
+            if (checkpoint.taskLine !== args.taskLine)
+                continue;
+            const filePath = checkpointPath(phrenPath, checkpoint.project, checkpoint.taskId);
+            try {
+                if (fs.existsSync(filePath)) {
+                    fs.unlinkSync(filePath);
+                    removed++;
+                }
+            }
+            catch (err) {
+                debugLog(`checkpoint clear scan ${filePath}: ${errorMessage(err)}`);
             }
-        }
-        catch (err) {
-            debugLog(`checkpoint clear scan ${filePath}: ${errorMessage(err)}`);
         }
     }
     return removed;

package/mcp/dist/shared-data-utils.js

@@ -0,0 +1,28 @@
+import * as fs from "fs";
+import * as path from "path";
+import { phrenErr, PhrenError, phrenOk, } from "./shared.js";
+import { withFileLock as withFileLockRaw } from "./shared-governance.js";
+import { isValidProjectName, safeProjectPath, errorMessage } from "./utils.js";
+export function withSafeLock(filePath, fn) {
+    try {
+        return withFileLockRaw(filePath, fn);
+    }
+    catch (err) {
+        const msg = errorMessage(err);
+        if (msg.includes("could not acquire lock")) {
+            return phrenErr(`Could not acquire write lock for "${path.basename(filePath)}". Another write may be in progress; please retry.`, PhrenError.LOCK_TIMEOUT);
+        }
+        throw err;
+    }
+}
+export function ensureProject(phrenPath, project) {
+    if (!isValidProjectName(project))
+        return phrenErr(`Project name "${project}" is not valid. Use lowercase letters, numbers, and hyphens (e.g. "my-project").`, PhrenError.INVALID_PROJECT_NAME);
+    const dir = safeProjectPath(phrenPath, project);
+    if (!dir)
+        return phrenErr(`Project name "${project}" is not valid. Use lowercase letters, numbers, and hyphens (e.g. "my-project").`, PhrenError.INVALID_PROJECT_NAME);
+    if (!fs.existsSync(dir)) {
+        return phrenErr(`No project "${project}" found. Add it with 'cd ~/your-project && phren add'.`, PhrenError.PROJECT_NOT_FOUND);
+    }
+    return phrenOk(dir);
+}

package/mcp/dist/shared-fragment-graph.js

@@ -22,7 +22,7 @@ export function escapeLike(s) { return s.replace(/[%_\\]/g, '\\$&'); }
  * found" -> suggest adding it).
  */
 export function logFragmentMiss(phrenPath, name, context, project) {
-    if (!process.env.PHREN_DEBUG && !(process.env.PHREN_DEBUG))
+    if (!process.env.PHREN_DEBUG)
         return;
     if (!name || name.length <= 2)
         return;
@@ -116,7 +116,7 @@ function getOrCreateFragment(db, name, type) {
         db.run("INSERT OR IGNORE INTO entities (name, type, first_seen_at) VALUES (?, ?, ?)", [name, type, new Date().toISOString().slice(0, 10)]);
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] fragmentInsert: ${errorMessage(err)}\n`);
     }
     const result = db.exec("SELECT id FROM entities WHERE name = ? AND type = ?", [name, type]);
@@ -139,7 +139,7 @@ export function ensureGlobalEntitiesTable(db) {
       )`);
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] ensureGlobalEntitiesTable: ${errorMessage(err)}\n`);
     }
 }
@@ -186,7 +186,7 @@ export function beginUserFragmentBuildCache(phrenPath, projects) {
             _buildUserFragmentCache.set(cacheKey, loaded.fragments);
         }
         catch (err) {
-            if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+            if (process.env.PHREN_DEBUG)
                 process.stderr.write(`[phren] beginUserFragmentBuildCache: ${errorMessage(err)}\n`);
             _buildUserFragmentCache.set(cacheKey, []);
         }
@@ -225,7 +225,7 @@ function parseUserDefinedFragments(phrenPath, project) {
                 }
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                if (process.env.PHREN_DEBUG)
                     process.stderr.write(`[phren] parseUserDefinedFragments statCheck: ${errorMessage(err)}\n`);
             }
         }
@@ -236,7 +236,7 @@ function parseUserDefinedFragments(phrenPath, project) {
         return loaded.fragments;
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] parseUserDefinedFragments: ${errorMessage(err)}\n`);
         return [];
     }
@@ -353,7 +353,7 @@ export function extractAndLinkFragments(db, content, sourceDoc, phrenPath) {
             db.run("INSERT OR IGNORE INTO entity_links (source_id, target_id, rel_type, source_doc) VALUES (?, ?, ?, ?)", [docFragmentId, fragmentId, "mentions", sourceDoc]);
         }
         catch (err) {
-            if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+            if (process.env.PHREN_DEBUG)
                 process.stderr.write(`[phren] fragmentLinksInsert: ${errorMessage(err)}\n`);
         }
         // Write to global_entities for cross-project queries
@@ -362,7 +362,7 @@ export function extractAndLinkFragments(db, content, sourceDoc, phrenPath) {
                 db.run("INSERT OR IGNORE INTO global_entities (entity, project, doc_key) VALUES (?, ?, ?)", [name, project, sourceDoc]);
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                if (process.env.PHREN_DEBUG)
                     process.stderr.write(`[phren] globalFragmentsInsert: ${errorMessage(err)}\n`);
             }
         }
@@ -391,7 +391,7 @@ export function queryFragmentLinks(db, name) {
         }
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] queryFragmentLinks: ${errorMessage(err)}\n`);
     }
     return { related };
@@ -427,7 +427,7 @@ export function queryCrossProjectFragments(db, fragmentName, excludeProject) {
         }
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] queryCrossProjectFragments: ${errorMessage(err)}\n`);
     }
     return results;
@@ -448,7 +448,7 @@ export function getFragmentBoostDocs(db, query) {
         return boostDocs;
     }
     catch (err) {
-        if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+        if (process.env.PHREN_DEBUG)
             process.stderr.write(`[phren] getFragmentBoostDocs: ${errorMessage(err)}\n`);
         return new Set();
     }

package/mcp/dist/shared-governance.js

@@ -1,4 +1,4 @@
 export * from './governance-policy.js';
 export * from './governance-scores.js';
 export * from './governance-audit.js';
-export { withFileLock } from './governance-locks.js';
+export { withFileLock, isFiniteNumber, hasValidSchemaVersion } from './governance-locks.js';

package/mcp/dist/shared-retrieval.js

@@ -8,7 +8,7 @@ import { buildFtsQueryVariants, buildRelaxedFtsQuery, isFeatureEnabled, STOP_WOR
 import * as fs from "fs";
 import * as path from "path";
 import { getProjectGlobBoost } from "./cli-hooks-globs.js";
-import { vectorFallback } from "./shared-search-fallback.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";
@@ -161,14 +161,6 @@ function docOverlapScore(queryTokens, doc) {
     const corpus = `${doc.project} ${doc.filename} ${doc.type} ${doc.path}\n${doc.content.slice(0, 5000)}`;
     return overlapScore(queryTokens, corpus);
 }
-function semanticFallbackSeed(text) {
-    let hash = 2166136261;
-    for (let i = 0; i < text.length; i++) {
-        hash ^= text.charCodeAt(i);
-        hash = Math.imul(hash, 16777619);
-    }
-    return hash >>> 0;
-}
 function loadSemanticFallbackWindow(db, startRowid, limit, project, wrapBefore) {
     const where = [
         project ? "project = ?" : "",
@@ -250,7 +242,7 @@ function semanticFallbackDocs(db, prompt, project) {
         const windowCount = Math.min(SEMANTIC_FALLBACK_WINDOW_COUNT, cappedLimit);
         const perWindow = Math.max(1, Math.ceil(cappedLimit / windowCount));
         const stride = Math.max(1, Math.floor(span / windowCount));
-        const seed = semanticFallbackSeed(`${project ?? "*"}\n${terms.join(" ")}`);
+        const seed = deterministicSeed(`${project ?? "*"}\n${terms.join(" ")}`);
         for (let i = 0; i < windowCount && docs.length < cappedLimit; i++) {
             const offset = (seed + i * stride) % span;
             const startRowid = minRowid + offset;

package/mcp/dist/shared-search-fallback.js

@@ -72,7 +72,7 @@ function cachedTokenize(text) {
     tokenCache.set(key, tokens);
     return tokens;
 }
-function deterministicSeed(text) {
+export function deterministicSeed(text) {
     let hash = 2166136261;
     for (let i = 0; i < text.length; i++) {
         hash ^= text.charCodeAt(i);
@@ -153,18 +153,8 @@ function tfidfCosine(docs, query, corpusN) {
             return termTf * idf;
         });
     }
-    function cosine(a, b) {
-        let dot = 0, normA = 0, normB = 0;
-        for (let i = 0; i < a.length; i++) {
-            dot += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
-        }
-        const denom = Math.sqrt(normA) * Math.sqrt(normB);
-        return denom === 0 ? 0 : dot / denom;
-    }
     const queryVec = buildVector(queryTokens);
-    return docTokenLists.map(docTokens => cosine(queryVec, buildVector(docTokens)));
+    return docTokenLists.map(docTokens => cosineSimilarity(queryVec, buildVector(docTokens)));
 }
 /**
  * Cosine fallback search: when FTS5 returns fewer than COSINE_FALLBACK_THRESHOLD results,

package/mcp/dist/shared.js

@@ -3,10 +3,9 @@ import * as path from "path";
 import { debugLog, runtimeFile } from "./phren-paths.js";
 import { errorMessage } from "./utils.js";
 export { HOOK_TOOL_NAMES, hookConfigPath } from "./provider-adapters.js";
-export { EXEC_TIMEOUT_MS, EXEC_TIMEOUT_QUICK_MS, PhrenError, phrenOk, phrenErr, forwardErr, parsePhrenErrorCode, isRecord, withDefaults, FINDING_TYPES, FINDING_TAGS, KNOWN_OBSERVATION_TAGS, DOC_TYPES, capCache, } from "./phren-core.js";
+export { EXEC_TIMEOUT_MS, EXEC_TIMEOUT_QUICK_MS, PhrenError, phrenOk, phrenErr, forwardErr, parsePhrenErrorCode, isRecord, withDefaults, FINDING_TYPES, FINDING_TAGS, KNOWN_OBSERVATION_TAGS, DOC_TYPES, capCache, RESERVED_PROJECT_DIR_NAMES, } from "./phren-core.js";
 export { ROOT_MANIFEST_FILENAME, homeDir, homePath, expandHomePath, defaultPhrenPath, rootManifestPath, readRootManifest, writeRootManifest, resolveInstallContext, findNearestPhrenPath, isProjectLocalMode, runtimeDir, tryUnlink, sessionsDir, runtimeFile, installPreferencesFile, runtimeHealthFile, shellStateFile, sessionMetricsFile, memoryScoresFile, memoryUsageLogFile, sessionMarker, debugLog, appendIndexEvent, resolveFindingsPath, findPhrenPath, ensurePhrenPath, findPhrenPathWithArg, normalizeProjectNameForCreate, findProjectNameCaseInsensitive, getProjectDirs, collectNativeMemoryFiles, computePhrenLiveStateToken, getPhrenPath, qualityMarkers, atomicWriteText, } from "./phren-paths.js";
 export { PROACTIVITY_LEVELS, getProactivityLevel, getProactivityLevelForFindings, getProactivityLevelForTask, hasExplicitFindingSignal, hasExplicitTaskSignal, hasExecutionIntent, hasDiscoveryIntent, shouldAutoCaptureFindingsForLevel, shouldAutoCaptureTaskForLevel, } from "./proactivity.js";
-const RESERVED_PROJECT_DIR_NAMES = new Set(["profiles", "templates", "global"]);
 const MEMORY_SCOPE_PATTERN = /^[a-z][a-z0-9_-]{0,63}$/;
 export function normalizeMemoryScope(scope) {
     if (typeof scope !== "string")
@@ -81,7 +80,7 @@ export function appendAuditLog(phrenPath, event, details) {
             if (stat.size > 1_000_000) {
                 const content = fs.readFileSync(logPath, "utf8");
                 const lines = content.split("\n");
-                fs.writeFileSync(logPath, lines.slice(-500).join("\n"));
+                fs.writeFileSync(logPath, lines.slice(-500).join("\n") + "\n");
             }
         }
         else {

package/mcp/dist/shell-entry.js

@@ -147,7 +147,7 @@ export async function startShell(phrenPath, profile) {
     const shell = new PhrenShell(phrenPath, profile);
     if (!process.stdin.isTTY) {
         const { createInterface } = await import("readline");
-        const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+        const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: process.stdin.isTTY ?? false });
         const repaint = async () => { clearScreen(); process.stdout.write(await shell.render()); rl.setPrompt(`\n${style.boldCyan(":phren>")} `); rl.prompt(); };
         const stopPoll = startLiveStatePoller({ phrenPath, shell, repaint });
         await repaint();

package/mcp/dist/shell-input.js

@@ -740,6 +740,67 @@ function showCursorPosition(host) {
     const short = label.length > 50 ? label.slice(0, 48) + "…" : label;
     host.setMessage(`  ${style.dim(`${cursor + 1} / ${count}`)}${short ? `  ${style.dimItalic(short)}` : ""}`);
 }
+// ── View shortcut keys (shared between handleInput text mode and handleNavigateKey) ─
+/**
+ * Handle p/b/l/m/s/k/h shortcut keys that switch the active view.
+ * Returns true if the key was handled.
+ */
+export function applyViewShortcut(host, key) {
+    if (key === "p") {
+        host.setView("Projects");
+        host.setMessage(`  ${TAB_ICONS.Projects} Projects`);
+        return true;
+    }
+    if (key === "b") {
+        if (!host.state.project) {
+            host.setMessage(style.dim("  Select a project first (↵)"));
+            return true;
+        }
+        host.setView("Tasks");
+        host.setMessage(`  ${TAB_ICONS.Tasks} Tasks`);
+        return true;
+    }
+    if (key === "l") {
+        if (!host.state.project) {
+            host.setMessage(style.dim("  Select a project first (↵)"));
+            return true;
+        }
+        host.setView("Findings");
+        host.setMessage(`  ${TAB_ICONS.Findings} Findings`);
+        return true;
+    }
+    if (key === "m") {
+        if (!host.state.project) {
+            host.setMessage(style.dim("  Select a project first (↵)"));
+            return true;
+        }
+        host.setView("Review Queue");
+        host.setMessage(`  ${TAB_ICONS["Review Queue"]} Review Queue`);
+        return true;
+    }
+    if (key === "s") {
+        if (!host.state.project) {
+            host.setMessage(style.dim("  Select a project first (↵)"));
+            return true;
+        }
+        host.setView("Skills");
+        host.setMessage(`  ${TAB_ICONS.Skills} Skills`);
+        return true;
+    }
+    if (key === "k") {
+        host.setView("Hooks");
+        host.setMessage(`  ${TAB_ICONS.Hooks} Hooks`);
+        return true;
+    }
+    if (key === "h") {
+        host.prevHealthView = host.state.view === "Health" ? host.prevHealthView : host.state.view;
+        host.healthCache = undefined;
+        host.setView("Health");
+        host.setMessage(`  ${TAB_ICONS.Health} Health  ${style.dim("(esc to return)")}`);
+        return true;
+    }
+    return false;
+}
 // ── Navigate-mode key handler ─────────────────────────────────────────────────
 export async function handleNavigateKey(host, key) {
     if (key === "\x1b[A") {
@@ -836,59 +897,8 @@ export async function handleNavigateKey(host, key) {
         }
         return true;
     }
-    if (key === "p") {
-        host.setView("Projects");
-        host.setMessage(`  ${TAB_ICONS.Projects} Projects`);
-        return true;
-    }
-    if (key === "b") {
-        if (!host.state.project) {
-            host.setMessage(style.dim("  Select a project first (↵)"));
-            return true;
-        }
-        host.setView("Tasks");
-        host.setMessage(`  ${TAB_ICONS.Tasks} Tasks`);
+    if (applyViewShortcut(host, key))
         return true;
-    }
-    if (key === "l") {
-        if (!host.state.project) {
-            host.setMessage(style.dim("  Select a project first (↵)"));
-            return true;
-        }
-        host.setView("Findings");
-        host.setMessage(`  ${TAB_ICONS.Findings} Fragments`);
-        return true;
-    }
-    if (key === "m") {
-        if (!host.state.project) {
-            host.setMessage(style.dim("  Select a project first (↵)"));
-            return true;
-        }
-        host.setView("Review Queue");
-        host.setMessage(`  ${TAB_ICONS["Review Queue"]} Review Queue`);
-        return true;
-    }
-    if (key === "s") {
-        if (!host.state.project) {
-            host.setMessage(style.dim("  Select a project first (↵)"));
-            return true;
-        }
-        host.setView("Skills");
-        host.setMessage(`  ${TAB_ICONS.Skills} Skills`);
-        return true;
-    }
-    if (key === "k") {
-        host.setView("Hooks");
-        host.setMessage(`  ${TAB_ICONS.Hooks} Hooks`);
-        return true;
-    }
-    if (key === "h") {
-        host.prevHealthView = host.state.view === "Health" ? host.prevHealthView : host.state.view;
-        host.healthCache = undefined;
-        host.setView("Health");
-        host.setMessage(`  ${TAB_ICONS.Health} Health  ${style.dim("(esc to return)")}`);
-        return true;
-    }
     if (key === "i" && host.state.view === "Projects") {
         const next = host.state.introMode === "always" ? "once-per-version" : host.state.introMode === "off" ? "always" : "off";
         host.state.introMode = next;

package/mcp/dist/shell-palette.js

@@ -7,7 +7,12 @@ import { EXEC_TIMEOUT_MS, } from "./shared.js";
 export function resultMsg(r) {
     if (!r.ok)
         return r.error;
-    return typeof r.data === "string" ? r.data : JSON.stringify(r.data);
+    if (typeof r.data === "string")
+        return r.data;
+    if (r.data && typeof r.data === "object" && "message" in r.data && typeof r.data.message === "string") {
+        return r.data.message;
+    }
+    return JSON.stringify(r.data);
 }
 export function editDistance(a, b) {
     const m = a.length;

package/mcp/dist/shell-render.js

@@ -1,6 +1,12 @@
 // ── ANSI utilities ──────────────────────────────────────────────────────────
 const ESC = "\x1b[";
 export const RESET = `${ESC}0m`;
+export const BOLD = `${ESC}1m`;
+export const DIM = `${ESC}2m`;
+export const GREEN = `${ESC}32m`;
+export const YELLOW = `${ESC}33m`;
+export const RED = `${ESC}31m`;
+export const CYAN = `${ESC}36m`;
 export const style = {
     bold: (s) => `${ESC}1m${s}${RESET}`,
     dim: (s) => `${ESC}2m${s}${RESET}`,
@@ -144,9 +150,7 @@ const PHREN_LOGO = [
     "██║     ██║  ██║██║  ██║███████╗██║ ╚████║",
     "╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═══╝",
 ];
-// Compact phren character for startup (uses PHREN_ART from phren-art.ts via import)
 import { PHREN_ART as PHREN_STARTUP_ART } from "./phren-art.js";
-const PHREN_STARTUP = PHREN_STARTUP_ART;
 // ── Line-based viewport: edge-triggered scroll (stable, no jumpiness) ─────────
 export function lineViewport(allLines, cursorFirstLine, cursorLastLine, height, prevStart) {
     if (allLines.length === 0 || height <= 0)
@@ -181,7 +185,7 @@ export function shellHelpText() {
         hdr("View-specific keys"),
         `  ${style.bold("Projects")}     ${k("↵")} ${d("open project tasks")}  ${k("i")} ${d("cycle intro mode")}`,
         `  ${style.bold("Tasks")}        ${k("a")} ${d("add task")}  ${k("d")} ${d("toggle active/queue")}  ${k("↵")} ${d("mark complete")}`,
-        `  ${style.bold("Fragments")}   ${k("a")} ${d("tell phren")}  ${k("d")} ${d("delete selected")}`,
+        `  ${style.bold("Findings")}    ${k("a")} ${d("tell phren")}  ${k("d")} ${d("delete selected")}`,
         `  ${style.bold("Review Queue")} ${k("↵")} ${d("inspect selected item")}  ${d("(read-only)")}`,
         `  ${style.bold("Skills")}       ${k("t")} ${d("toggle enabled")}  ${k("d")} ${d("remove")}`,
         "",
@@ -221,7 +225,7 @@ export function shellStartupFrames(version) {
     const versionBadge = badge(`v${version}`, style.boldBlue);
     if (cols >= 72) {
         // Side-by-side: phren character on left, logo text on right
-        const phrenLines = PHREN_STARTUP;
+        const phrenLines = PHREN_STARTUP_ART;
         const logoLines = PHREN_LOGO.map(line => gradient(line));
         const infoLine = `${gradient("◆")} ${style.bold("phren")}  ${versionBadge}  ${tagline}`;
         // Logo is 6 lines, pad to align vertically with character center
@@ -252,7 +256,7 @@ export function shellStartupFrames(version) {
         ];
     }
     // Narrow terminal: progressive text reveal with gradient
-    const stages = ["c", "cor", "phren"];
+    const stages = ["p", "phr", "phren"];
     const spinners = ["◜", "◠", "◝"];
     return stages.map((stage, i) => [
         "",

package/mcp/dist/shell-state-store.js

@@ -1,7 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
 import { phrenErr, PhrenError, phrenOk, shellStateFile } from "./shared.js";
-import { getRuntimeHealth, withFileLock as withFileLockRaw } from "./shared-governance.js";
+import { withFileLock as withFileLockRaw } from "./shared-governance.js";
 import { errorMessage } from "./utils.js";
 function withSafeLock(filePath, fn) {
     try {
@@ -76,6 +76,3 @@ export function resetShellState(phrenPath) {
         return phrenOk("Shell state reset.");
     });
 }
-export function readRuntimeHealth(phrenPath) {
-    return getRuntimeHealth(phrenPath);
-}

package/mcp/dist/shell-view.js

@@ -67,7 +67,7 @@ function renderBottomBar(state, navMode, inputCtx, inputBuf) {
         Tasks: [`${k("a")} ${d("add")}`, `${k("↵")} ${d("mark done")}`, `${k("d")} ${d("toggle active")}`],
         Findings: [`${k("a")} ${d("add")}`, `${k("d")} ${d("remove")}`],
         "Review Queue": [`${k("↵")} ${d("inspect")}`],
-        Skills: [`${k("t")} ${d("toggle")}`, `${k("d")} ${d("remove")}`],
+        Skills: [`${k("a")} ${d("add")}`, `${k("t")} ${d("toggle")}`, `${k("d")} ${d("remove")}`],
         Hooks: [`${k("a")} ${d("enable")}`, `${k("d")} ${d("disable")}`],
         Health: [`${k("↑↓")} ${d("scroll")}`, `${k("esc")} ${d("back")}`],
     };
@@ -136,9 +136,9 @@ function renderProjectsDashboard(ctx, entries, height) {
     const findingsPreview = scoped
         .filter((entry) => entry.findingCount > 0)
         .slice(0, 3)
-        .map((entry) => `${style.bold(entry.name)} ${style.dim(`${entry.findingCount} fragments`)}`);
+        .map((entry) => `${style.bold(entry.name)} ${style.dim(`${entry.findingCount} findings`)}`);
     const lines = [
-        `  ${badge(ctx.profile || "default", style.boldBlue)}  ${style.bold(String(scoped.length))} projects  ${style.dim("·")}  ${style.boldGreen(String(totals.active))} active  ${style.dim("·")}  ${style.boldYellow(String(totals.queue))} queued  ${style.dim("·")}  ${style.boldCyan(String(totals.findings))} fragments  ${style.dim("·")}  ${style.boldMagenta(String(totals.review))} review`,
+        `  ${badge(ctx.profile || "default", style.boldBlue)}  ${style.bold(String(scoped.length))} projects  ${style.dim("·")}  ${style.boldGreen(String(totals.active))} active  ${style.dim("·")}  ${style.boldYellow(String(totals.queue))} queued  ${style.dim("·")}  ${style.boldCyan(String(totals.findings))} findings  ${style.dim("·")}  ${style.boldMagenta(String(totals.review))} review`,
         ctx.state.project
             ? `  ${style.green("●")} active context ${style.boldCyan(ctx.state.project)}  ${style.dim("· ↵ opens selected project tasks")}`
             : `  ${style.dim("No project selected yet")}  ${style.dim("· ↵ sets context and opens tasks")}`,
@@ -517,7 +517,7 @@ function renderSkillsView(ctx, cursor, height) {
 }
 const LIFECYCLE_HOOKS = [
     { event: "UserPromptSubmit", description: "inject context before each prompt" },
-    { event: "Stop", description: "phren saves fragments after each response" },
+    { event: "Stop", description: "phren saves findings after each response" },
     { event: "SessionStart", description: "git pull at session start" },
 ];
 export function getHookEntries(phrenPath, project) {

package/mcp/dist/shell.js

@@ -2,11 +2,11 @@ import * as fs from "fs";
 import * as path from "path";
 import { addTask, addFinding, loadShellState, saveShellState, } from "./data-access.js";
 import { style } from "./shell-render.js";
-import { MAX_UNDO_STACK, TAB_ICONS, } from "./shell-types.js";
+import { MAX_UNDO_STACK, } from "./shell-types.js";
 import { resultMsg, defaultRunHooks, defaultRunUpdate, defaultRunRelink, } from "./shell-palette.js";
 import { runDoctor } from "./link.js";
 import { renderShell, } from "./shell-view.js";
-import { executePalette, completeInput as completeInputFn, getListItems, handleNavigateKey, } from "./shell-input.js";
+import { executePalette, completeInput as completeInputFn, getListItems, handleNavigateKey, applyViewShortcut, } from "./shell-input.js";
 import { errorMessage } from "./utils.js";
 // ── Shell class ──────────────────────────────────────────────────────────────
 export class PhrenShell {
@@ -16,7 +16,7 @@ export class PhrenShell {
     state;
     message = `  ${style.boldCyan("←→")} ${style.dim("tabs")}  ${style.boldCyan("↑↓")} ${style.dim("move")}  ${style.boldCyan("↵")} ${style.dim("activate")}  ${style.boldCyan("?")} ${style.dim("help")}`;
     healthCache;
-    prevHealthView;
+    prevHealthView = undefined;
     showHelp = false;
     pendingConfirm;
     undoStack = [];
@@ -277,58 +277,8 @@ export class PhrenShell {
             return true;
         if (["q", "quit", ":q", ":quit", ":exit"].includes(input.toLowerCase()))
             return false;
-        if (input === "p") {
-            this.setView("Projects");
-            this.setMessage(`  ${TAB_ICONS.Projects} Projects`);
+        if (applyViewShortcut(this.asNavigationHost(), input))
             return true;
-        }
-        if (input === "b") {
-            if (!this.state.project) {
-                this.setMessage(style.dim("  Select a project first (↵)"));
-                return true;
-            }
-            this.setView("Tasks");
-            this.setMessage(`  ${TAB_ICONS.Tasks} Tasks`);
-            return true;
-        }
-        if (input === "l") {
-            if (!this.state.project) {
-                this.setMessage(style.dim("  Select a project first (↵)"));
-                return true;
-            }
-            this.setView("Findings");
-            this.setMessage(`  ${TAB_ICONS.Findings} Fragments`);
-            return true;
-        }
-        if (input === "m") {
-            if (!this.state.project) {
-                this.setMessage(style.dim("  Select a project first (↵)"));
-                return true;
-            }
-            this.setView("Review Queue");
-            this.setMessage(`  ${TAB_ICONS["Review Queue"]} Review Queue`);
-            return true;
-        }
-        if (input === "s") {
-            if (!this.state.project) {
-                this.setMessage(style.dim("  Select a project first (↵)"));
-                return true;
-            }
-            this.setView("Skills");
-            this.setMessage(`  ${TAB_ICONS.Skills} Skills`);
-            return true;
-        }
-        if (input === "k") {
-            this.setView("Hooks");
-            this.setMessage(`  ${TAB_ICONS.Hooks} Hooks`);
-            return true;
-        }
-        if (input === "h") {
-            this.healthCache = undefined;
-            this.setView("Health");
-            this.setMessage(`  ${TAB_ICONS.Health} Health`);
-            return true;
-        }
         if (input.startsWith("/")) {
             this.setFilter(input.slice(1));
             return true;

package/mcp/dist/status.js

@@ -10,6 +10,7 @@ import { runGit as runGitShared, errorMessage } from "./utils.js";
 import { readRuntimeHealth, resolveTaskFilePath } from "./data-access.js";
 import { resolveRuntimeProfile } from "./runtime-profile.js";
 import { renderPhrenArt } from "./phren-art.js";
+import { RESET, BOLD, DIM, GREEN, YELLOW, RED, CYAN } from "./shell-render.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function readPackageVersion() {
     try {
@@ -23,13 +24,6 @@ function readPackageVersion() {
         return "unknown";
     }
 }
-const RESET = "\x1b[0m";
-const BOLD = "\x1b[1m";
-const DIM = "\x1b[2m";
-const GREEN = "\x1b[32m";
-const YELLOW = "\x1b[33m";
-const RED = "\x1b[31m";
-const CYAN = "\x1b[36m";
 function check(ok) {
     return ok ? `${GREEN}ok${RESET}` : `${RED}missing${RESET}`;
 }
@@ -302,7 +296,7 @@ export async function runStatus() {
             totalTask += countBullets(taskPath);
         totalQueue += countQueueItems(phrenPath, projName);
     }
-    console.log(`\n  ${DIM}phren holds${RESET}  ${projectDirs.length} projects, ${totalFindings} fragments, ${totalTask} tasks, ${totalQueue} queued`);
+    console.log(`\n  ${DIM}phren holds${RESET}  ${projectDirs.length} projects, ${totalFindings} findings, ${totalTask} tasks, ${totalQueue} queued`);
     const gitTarget = manifest?.installMode === "project-local" && manifest.workspaceRoot ? manifest.workspaceRoot : phrenPath;
     const isGitRepo = runGit(gitTarget, ["rev-parse", "--is-inside-work-tree"]) === "true";
     const hasOriginRemote = isGitRepo && Boolean(runGit(gitTarget, ["remote", "get-url", "origin"]));

package/mcp/dist/utils.js

@@ -241,7 +241,7 @@ export function sanitizeFts5Query(raw) {
     if (raw.length > 500)
         raw = raw.slice(0, 500);
     // Whitelist approach: only allow alphanumeric, spaces, hyphens, apostrophes, double quotes, asterisks
-    let q = raw.replace(/[^a-zA-Z0-9 \-'"*]/g, " ");
+    let q = raw.replace(/[^a-zA-Z0-9 \-"*]/g, " ");
     q = q.replace(/\s+/g, " ");
     q = q.trim();
     // Q83: FTS5 only accepts * as a prefix operator directly attached to a token

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/cli",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Knowledge layer for AI agents. Phren learns and recalls.",
   "type": "module",
   "bin": {
@@ -18,7 +18,6 @@
     "glob": "^13.0.6",
     "inquirer": "^12.10.0",
     "js-yaml": "^4.1.1",
-    "sharp": "^0.34.5",
     "sql.js-fts5": "^1.4.0",
     "zod": "^4.3.6"
   },