@phren/cli 0.0.56 → 0.0.57

package/dist/shell/render-api.js

@@ -0,0 +1,101 @@
+import { listProjectCards } from "../data/access.js";
+import { renderShell } from "./view.js";
+import { getListItems } from "./input.js";
+// ── View cycling order (same as the shell tab bar) ──────────────────────────
+const VIEW_ORDER = [
+    "Projects", "Tasks", "Findings", "Review Queue", "Skills", "Hooks",
+];
+// ── Render ──────────────────────────────────────────────────────────────────
+/** Render a full shell frame for the given state. Read-only, no mutations. */
+export async function renderMenuFrame(phrenPath, profile, state) {
+    const shellState = {
+        version: 3,
+        view: state.view,
+        project: state.project,
+        filter: state.filter,
+    };
+    const ctx = {
+        phrenPath,
+        profile,
+        state: shellState,
+        currentCursor: () => state.cursor,
+        currentScroll: () => state.scroll,
+        setScroll: () => { },
+    };
+    const stubDoctor = async () => ({
+        ok: true,
+        checks: [],
+    });
+    const output = await renderShell(ctx, "navigate", // always navigate mode (no input mode in agent menu)
+    "", // no inputCtx
+    "", // no inputBuf
+    false, // no help
+    "Tab: Chat  ←→: Views  ↑↓: Navigate  Enter: Select  /: Filter  Esc: Back", stubDoctor, null, // subsectionsCache
+    () => { }, // setHealthLineCount
+    () => { });
+    const listCount = getListItems(phrenPath, profile, shellState, 0).length;
+    return { output, listCount };
+}
+// ── Navigation (pure function) ──────────────────────────────────────────────
+/**
+ * Apply a key to the menu state. Returns a new state, or null to signal
+ * "exit menu mode" (Tab or Escape at top level).
+ */
+export function handleMenuKey(state, keyName, listCount, phrenPath, profile) {
+    switch (keyName) {
+        // Exit menu
+        case "tab":
+        case "q":
+            return null;
+        // View cycling
+        case "left": {
+            const idx = VIEW_ORDER.indexOf(state.view);
+            const next = idx <= 0 ? VIEW_ORDER[VIEW_ORDER.length - 1] : VIEW_ORDER[idx - 1];
+            return { ...state, view: next, cursor: 0, scroll: 0, filter: undefined };
+        }
+        case "right": {
+            const idx = VIEW_ORDER.indexOf(state.view);
+            const next = idx >= VIEW_ORDER.length - 1 ? VIEW_ORDER[0] : VIEW_ORDER[idx + 1];
+            return { ...state, view: next, cursor: 0, scroll: 0, filter: undefined };
+        }
+        // Cursor movement
+        case "up":
+            return { ...state, cursor: Math.max(0, state.cursor - 1) };
+        case "down":
+            return { ...state, cursor: Math.min(Math.max(0, listCount - 1), state.cursor + 1) };
+        // Enter: drill into project (Projects view only)
+        case "return": {
+            if (state.view === "Projects" && phrenPath && profile) {
+                const cards = listProjectCards(phrenPath, profile);
+                const filtered = state.filter
+                    ? cards.filter((c) => `${c.name} ${c.summary} ${c.docs.join(" ")}`.toLowerCase().includes(state.filter.toLowerCase()))
+                    : cards;
+                const selected = filtered[state.cursor];
+                if (selected) {
+                    return { ...state, view: "Tasks", project: selected.name, cursor: 0, scroll: 0 };
+                }
+            }
+            // Escape from sub-view back to Projects
+            if (state.view !== "Projects" && state.project) {
+                return state; // no-op for non-projects views on enter
+            }
+            return state;
+        }
+        // Escape: clear filter, or go back to projects, or exit
+        case "escape": {
+            if (state.filter)
+                return { ...state, filter: undefined, cursor: 0, scroll: 0 };
+            if (state.view !== "Projects" && state.project) {
+                return { ...state, view: "Projects", project: undefined, cursor: 0, scroll: 0 };
+            }
+            return null; // exit menu
+        }
+        // Health shortcut
+        case "h":
+            if (state.view === "Health")
+                return { ...state, view: "Projects", cursor: 0, scroll: 0 };
+            return { ...state, view: "Health", cursor: 0, scroll: 0 };
+        default:
+            return state;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/cli",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "description": "Knowledge layer for AI agents — CLI, MCP server, and data layer",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
     "./data/access": "./dist/data/access.js",
     "./data/tasks": "./dist/data/tasks.js",
     "./core/finding": "./dist/core/finding.js",
-    "./session/utils": "./dist/session/utils.js"
+    "./session/utils": "./dist/session/utils.js",
+    "./shell/render-api": "./dist/shell/render-api.js"
   },
   "files": [
     "dist",