@phren/cli 0.0.10 → 0.0.12

package/mcp/dist/shared-retrieval.js

@@ -4,11 +4,11 @@ import { queryDocRows, queryRows, cosineFallback, extractSnippet, getDocSourceKe
 import { filterTrustedFindingsDetailed, } from "./shared-content.js";
 import { parseCitationComment } from "./content-citation.js";
 import { getHighImpactFindings } from "./finding-impact.js";
-import { buildFtsQueryVariants, buildRelaxedFtsQuery, isFeatureEnabled, STOP_WORDS } from "./utils.js";
+import { buildFtsQueryVariants, buildRelaxedFtsQuery, isFeatureEnabled, STOP_WORDS, errorMessage } from "./utils.js";
 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";
@@ -34,17 +34,23 @@ const TASK_RESCUE_SCORE_MARGIN = 0.6;
 /** Fraction of bullets that must be low-value before applying the low-value penalty. */
 const LOW_VALUE_BULLET_FRACTION = 0.5;
 // ── Intent and scoring helpers ───────────────────────────────────────────────
+const INTENT_SKILL_CMD_RE = /(?:^|\s)\/(?!(?:home|usr|var|tmp|etc|opt|api|mnt)\b)[a-z][\w-]*\b/;
+const INTENT_SKILL_KW_RE = /\bskill\b/;
+const INTENT_DEBUG_RE = /(bug|error|fix|broken|regression|fail|stack trace)/;
+const INTENT_REVIEW_RE = /(review|audit|pr|pull request|nit|refactor)/;
+const INTENT_BUILD_RE = /(build|deploy|release|ci|workflow|pipeline|test)/;
+const INTENT_DOCS_RE = /\b(doc|docs|readme|explain|guide|instructions?)\b/;
 export function detectTaskIntent(prompt) {
     const p = prompt.toLowerCase();
-    if (/(?:^|\s)\/(?!(?:home|usr|var|tmp|etc|opt|api|mnt)\b)[a-z][\w-]*\b/.test(p) || /\bskill\b/.test(p))
+    if (INTENT_SKILL_CMD_RE.test(p) || INTENT_SKILL_KW_RE.test(p))
         return "skill";
-    if (/(bug|error|fix|broken|regression|fail|stack trace)/.test(p))
+    if (INTENT_DEBUG_RE.test(p))
         return "debug";
-    if (/(review|audit|pr|pull request|nit|refactor)/.test(p))
+    if (INTENT_REVIEW_RE.test(p))
         return "review";
-    if (/(build|deploy|release|ci|workflow|pipeline|test)/.test(p))
+    if (INTENT_BUILD_RE.test(p))
         return "build";
-    if (/\b(doc|docs|readme|explain|guide|instructions?)\b/.test(p))
+    if (INTENT_DOCS_RE.test(p))
         return "docs";
     return "general";
 }
@@ -155,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 = ?" : "",
@@ -244,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;
@@ -385,8 +383,8 @@ 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.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] hybridSearch vectorFallback: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] hybridSearch vectorFallback: ${errorMessage(err)}\n`);
         return syncResult;
     }
 }
@@ -445,7 +443,7 @@ export async function searchKnowledgeRows(db, options) {
             }
         }
         catch (err) {
-            debugLog(`rowid dedup query failed: ${err instanceof Error ? err.message : String(err)}`);
+            debugLog(`rowid dedup query failed: ${errorMessage(err)}`);
         }
         const cosineResults = cosineFallback(db, query, ftsRowids, maxResults - rows.length)
             .filter((doc) => (!filterProject || doc.project === filterProject) && (!filterType || doc.type === filterType));
@@ -485,8 +483,8 @@ export async function searchKnowledgeRows(db, options) {
             }
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG)) {
-                process.stderr.write(`[phren] vectorFallback: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG)) {
+                process.stderr.write(`[phren] vectorFallback: ${errorMessage(err)}\n`);
             }
         }
     }
@@ -732,8 +730,8 @@ export function markStaleCitations(snippet) {
                             }
                         }
                         catch (err) {
-                            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] applyCitationAnnotations fileRead: ${err instanceof Error ? err.message : String(err)}\n`);
+                            if ((process.env.PHREN_DEBUG))
+                                process.stderr.write(`[phren] applyCitationAnnotations fileRead: ${errorMessage(err)}\n`);
                             stale = true;
                         }
                     }

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

@@ -1,6 +1,6 @@
 import { createHash } from "crypto";
 import { debugLog } from "./shared.js";
-import { STOP_WORDS } from "./utils.js";
+import { STOP_WORDS, errorMessage } from "./utils.js";
 import { porterStem } from "./shared-stemmer.js";
 import { classifyFile, normalizeIndexedContent, rowToDocWithRowid } from "./shared-index.js";
 import { embedText, cosineSimilarity, getEmbeddingModel, getOllamaUrl, getCloudEmbeddingUrl } from "./shared-ollama.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,
@@ -191,8 +181,8 @@ export function cosineFallback(db, query, excludeRowids, limit) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] cosineFallback count: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] cosineFallback count: ${errorMessage(err)}\n`);
         return [];
     }
     if (totalDocs > COSINE_MAX_CORPUS) {
@@ -220,8 +210,8 @@ export function cosineFallback(db, query, excludeRowids, limit) {
                         ftsRows.push(...ftsRes[0].values);
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] cosineFallback FTS pre-filter: ${err instanceof Error ? err.message : String(err)}\n`);
+                    if ((process.env.PHREN_DEBUG))
+                        process.stderr.write(`[phren] cosineFallback FTS pre-filter: ${errorMessage(err)}\n`);
                 }
             }
             // If FTS gave fewer than cap, supplement with deterministic rowid windows.
@@ -258,8 +248,8 @@ export function cosineFallback(db, query, excludeRowids, limit) {
                     }
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                        process.stderr.write(`[phren] cosineFallback deterministicSample: ${err instanceof Error ? err.message : String(err)}\n`);
+                    if ((process.env.PHREN_DEBUG))
+                        process.stderr.write(`[phren] cosineFallback deterministicSample: ${errorMessage(err)}\n`);
                 }
             }
             if (ftsRows.length === 0)
@@ -269,8 +259,8 @@ export function cosineFallback(db, query, excludeRowids, limit) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] cosineFallback loadDocs: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] cosineFallback loadDocs: ${errorMessage(err)}\n`);
         return [];
     }
     // Separate rowids, DocRows, and content strings for scoring
@@ -315,8 +305,8 @@ export async function vectorFallback(phrenPath, query, excludePaths, limit, proj
             await cache.load();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] vectorFallback cacheLoad: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] vectorFallback cacheLoad: ${errorMessage(err)}\n`);
         }
     }
     if (cache.size() === 0)
@@ -367,8 +357,8 @@ export async function vectorFallback(phrenPath, query, excludePaths, limit, proj
             }
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] vectorFallback fileRead: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] vectorFallback fileRead: ${errorMessage(err)}\n`);
         }
         return { project: entryProject, filename, type, content, path: e.path };
     });

package/mcp/dist/shared-sqljs.js

@@ -2,6 +2,7 @@ import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import { createRequire } from "module";
+import { errorMessage } from "./utils.js";
 const require = createRequire(import.meta.url);
 /**
  * Locate the sql.js-fts5 WASM binary by require.resolve with path-probe fallback.
@@ -14,8 +15,8 @@ function findWasmBinary() {
             return fs.readFileSync(resolved);
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] findWasmBinary requireResolve: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] findWasmBinary requireResolve: ${errorMessage(err)}\n`);
         // fall through to path probing
     }
     const __filename = fileURLToPath(import.meta.url);

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")
@@ -50,7 +49,7 @@ export function appendAuditLog(phrenPath, event, details) {
                 break;
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                if ((process.env.PHREN_DEBUG))
                     process.stderr.write(`[phren] appendAuditLog lockWrite: ${errorMessage(err)}\n`);
                 try {
                     const stat = fs.statSync(lockPath);
@@ -68,7 +67,7 @@ export function appendAuditLog(phrenPath, event, details) {
                     }
                 }
                 catch (statErr) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                    if ((process.env.PHREN_DEBUG))
                         process.stderr.write(`[phren] appendAuditLog staleStat: ${errorMessage(statErr)}\n`);
                 }
                 Atomics.wait(waiter, 0, 0, pollMs);
@@ -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 {
@@ -97,7 +96,7 @@ export function appendAuditLog(phrenPath, event, details) {
                 fs.unlinkSync(lockPath);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                if ((process.env.PHREN_DEBUG))
                     process.stderr.write(`[phren] appendAuditLog unlock: ${errorMessage(err)}\n`);
             }
         }

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

@@ -379,7 +379,7 @@ export async function executePalette(host, input) {
                 }
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                if ((process.env.PHREN_DEBUG))
                     process.stderr.write(`[phren] shell status gitStatus: ${errorMessage(err)}\n`);
             }
             const auditPathNew = runtimeFile(host.phrenPath, "audit.log");
@@ -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 {
@@ -45,7 +45,7 @@ export function loadShellState(phrenPath) {
         };
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+        if ((process.env.PHREN_DEBUG))
             process.stderr.write(`[phren] loadShellState parse: ${errorMessage(err)}\n`);
         return fallback;
     }
@@ -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

@@ -13,6 +13,7 @@ import { listMachines, listProfiles, } from "./data-access.js";
 import { readInstallPreferences } from "./init-preferences.js";
 import { isProjectHookEnabled, readProjectConfig } from "./project-config.js";
 import { getScopedSkills } from "./skill-registry.js";
+import { errorMessage } from "./utils.js";
 // ── Tab bar ────────────────────────────────────────────────────────────────
 function renderTabBar(state) {
     const cols = renderWidth();
@@ -66,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")}`],
     };
@@ -135,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")}`,
@@ -248,8 +249,8 @@ function parseSubsections(taskPath, project, cache) {
         }
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] buildSubsectionMap: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] buildSubsectionMap: ${errorMessage(err)}\n`);
     }
     const newCache = { project, map };
     return { map, cache: newCache };
@@ -516,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 = [];
@@ -72,7 +72,7 @@ export class PhrenShell {
             }
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+            if ((process.env.PHREN_DEBUG))
                 process.stderr.write(`[phren] shell pushUndo: ${errorMessage(err)}\n`);
         }
     }
@@ -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;