@pi-unipi/unipi 2.1.3 → 2.2.0

package/packages/kanboard/tui/kanboard-overlay.ts

@@ -0,0 +1,300 @@
+/**
+ * @pi-unipi/kanboard — Kanboard TUI Overlay
+ *
+ * Two tabs: Tasks list and Kanban Board.
+ * Uses pi-tui overlay API (same pattern as MCP add overlay).
+ */
+
+import {
+  Key,
+  matchesKey,
+  truncateToWidth,
+  type TUI,
+  visibleWidth,
+} from "@earendil-works/pi-tui";
+import type { Theme, KeybindingsManager } from "@earendil-works/pi-coding-agent";
+import type { ParsedDoc, ParsedItem, ItemStatus } from "../types.js";
+import { createDefaultRegistry } from "../parser/index.js";
+
+type Tab = "tasks" | "board";
+
+interface KanboardState {
+  tab: Tab;
+  tasks: ParsedItem[];
+  taskIndex: number;
+  taskScroll: number;
+  /** Board columns: index into tasks array grouped by status */
+  boardColumns: {
+    todo: number[];
+    inProgress: number[];
+    done: number[];
+  };
+  boardCol: number; // 0=todo, 1=inProgress, 2=done
+  boardIndex: number[];
+  pendingG: boolean;
+  docsRoot: string;
+}
+
+/** Status icon */
+function statusIcon(status: ItemStatus): string {
+  switch (status) {
+    case "done":
+      return "✓";
+    case "in-progress":
+      return "◐";
+    default:
+      return "○";
+  }
+}
+
+/** Pad string to visible width */
+function padVisible(content: string, targetWidth: number): string {
+  const pad = Math.max(0, targetWidth - visibleWidth(content));
+  return content + " ".repeat(pad);
+}
+
+/**
+ * Render the kanboard overlay.
+ */
+export function renderKanboardOverlay(params?: {
+  docsRoot?: string;
+  onComplete?: () => void;
+}) {
+  return (
+    tui: TUI,
+    theme: Theme,
+    _kb: KeybindingsManager,
+    done: (result: { viewed: boolean } | null) => void,
+  ) => {
+    const state: KanboardState = {
+      tab: "tasks",
+      tasks: [],
+      taskIndex: 0,
+      taskScroll: 0,
+      boardColumns: { todo: [], inProgress: [], done: [] },
+      boardCol: 0,
+      boardIndex: [0, 0, 0],
+      pendingG: false,
+      docsRoot: params?.docsRoot ?? ".unipi/docs",
+    };
+
+    // Load data
+    let loaded = false;
+    const ensureLoaded = async () => {
+      if (loaded) return;
+      const registry = await createDefaultRegistry();
+      const docs = registry.parseAll(state.docsRoot);
+      state.tasks = docs.flatMap((d) => d.items);
+
+      // Build board columns
+      state.boardColumns = { todo: [], inProgress: [], done: [] };
+      state.tasks.forEach((item, idx) => {
+        if (item.status === "done") state.boardColumns.done.push(idx);
+        else if (item.status === "in-progress") state.boardColumns.inProgress.push(idx);
+        else state.boardColumns.todo.push(idx);
+      });
+
+      // Init board indices
+      state.boardIndex = [
+        0,
+        0,
+        0,
+      ];
+
+      loaded = true;
+    };
+
+    const render = async () => {
+      await ensureLoaded();
+
+      const width = tui.terminal?.columns ?? 80;
+      const height = tui.terminal?.rows ?? 24;
+      const lines: string[] = [];
+
+      // Header
+      const header = " 📋 Kanboard ";
+      const tabLine =
+        "  [T]asks  |  [B]oard  ".replace(
+          state.tab === "tasks" ? "[T]" : "T",
+          state.tab === "tasks" ? "▸T" : " T",
+        ).replace(
+          state.tab === "board" ? "[B]" : "B",
+          state.tab === "board" ? "▸B" : " B",
+        );
+      lines.push(truncateToWidth(header, width));
+      lines.push(truncateToWidth(tabLine, width));
+      lines.push("─".repeat(width));
+
+      if (state.tab === "tasks") {
+        renderTasksTab(lines, width, height - 5);
+      } else {
+        renderBoardTab(lines, width, height - 5);
+      }
+
+      // Footer
+      lines.push("─".repeat(width));
+      const footer = " j/k: navigate  Tab: switch tab  q/Esc: close ";
+      lines.push(truncateToWidth(footer, width));
+
+      (tui as unknown as { setContent(lines: string[]): void }).setContent(lines);
+    };
+
+    const renderTasksTab = (lines: string[], width: number, maxLines: number) => {
+      if (state.tasks.length === 0) {
+        lines.push(truncateToWidth("  No tasks found.", width));
+        return;
+      }
+
+      // Ensure index in range
+      state.taskIndex = Math.min(state.taskIndex, state.tasks.length - 1);
+      state.taskIndex = Math.max(0, state.taskIndex);
+
+      // Scroll to keep selected visible
+      if (state.taskIndex < state.taskScroll) state.taskScroll = state.taskIndex;
+      if (state.taskIndex >= state.taskScroll + maxLines) {
+        state.taskScroll = state.taskIndex - maxLines + 1;
+      }
+
+      const visible = state.tasks.slice(
+        state.taskScroll,
+        state.taskScroll + maxLines,
+      );
+
+      for (let i = 0; i < visible.length; i++) {
+        const item = visible[i];
+        const globalIdx = state.taskScroll + i;
+        const selected = globalIdx === state.taskIndex;
+        const prefix = selected ? " ▸ " : "   ";
+        const icon = statusIcon(item.status);
+        const source = `[${item.sourceFile}]`;
+        const line = `${prefix}${icon} ${item.text}  ${source}`;
+        lines.push(
+          truncateToWidth(
+            selected ? `\x1b[7m${padVisible(line, width)}\x1b[0m` : line,
+            width,
+          ),
+        );
+      }
+    };
+
+    const renderBoardTab = (lines: string[], width: number, maxLines: number) => {
+      const colWidth = Math.floor(width / 3);
+      const cols: Array<{ title: string; indices: number[]; colIdx: number }> = [
+        { title: "To Do", indices: state.boardColumns.todo, colIdx: 0 },
+        { title: "In Progress", indices: state.boardColumns.inProgress, colIdx: 1 },
+        { title: "Done", indices: state.boardColumns.done, colIdx: 2 },
+      ];
+
+      // Column headers
+      let headerLine = "";
+      for (const col of cols) {
+        const isActive = col.colIdx === state.boardCol;
+        const title = isActive ? `▸ ${col.title}` : `  ${col.title}`;
+        headerLine += padVisible(` ${title} (${col.indices.length})`, colWidth);
+      }
+      lines.push(truncateToWidth(headerLine, width));
+      lines.push("─".repeat(width));
+
+      // Column items
+      const maxItems = Math.max(
+        ...cols.map((c) => c.indices.length),
+        maxLines - 2,
+      );
+      for (let row = 0; row < Math.min(maxItems, maxLines - 2); row++) {
+        let rowLine = "";
+        for (const col of cols) {
+          const active = col.colIdx === state.boardCol;
+          const boardIdx = state.boardIndex[col.colIdx] ?? 0;
+          if (row < col.indices.length) {
+            const item = state.tasks[col.indices[row]];
+            const selected = active && row === boardIdx;
+            const icon = statusIcon(item.status);
+            const text = truncateToWidth(` ${icon} ${item.text}`, colWidth - 1);
+            if (selected) {
+              rowLine += `\x1b[7m${padVisible(text, colWidth)}\x1b[0m`;
+            } else {
+              rowLine += padVisible(text, colWidth);
+            }
+          } else {
+            rowLine += padVisible("", colWidth);
+          }
+        }
+        lines.push(truncateToWidth(rowLine, width));
+      }
+    };
+
+    const handleKey = async (key: string) => {
+      await ensureLoaded();
+
+      // Close
+      if (matchesKey(key, "q") || matchesKey(key, "escape")) {
+        done({ viewed: true });
+        return;
+      }
+
+      // Tab switching
+      if (matchesKey(key, "tab") || matchesKey(key, "b")) {
+        state.tab = state.tab === "tasks" ? "board" : "tasks";
+        render();
+        return;
+      }
+
+      if (matchesKey(key, "t")) {
+        state.tab = "tasks";
+        render();
+        return;
+      }
+
+      // Navigation
+      if (state.tab === "tasks") {
+        if (matchesKey(key, "j") || matchesKey(key, "down")) {
+          state.taskIndex = Math.min(state.taskIndex + 1, state.tasks.length - 1);
+        } else if (matchesKey(key, "k") || matchesKey(key, "up")) {
+          state.taskIndex = Math.max(state.taskIndex - 1, 0);
+        } else if (matchesKey(key, "g")) {
+          if (state.pendingG) {
+            state.taskIndex = 0;
+            state.pendingG = false;
+          } else {
+            state.pendingG = true;
+            setTimeout(() => {
+              state.pendingG = false;
+            }, 500);
+          }
+        } else if (matchesKey(key, "shift+g")) {
+          state.taskIndex = state.tasks.length - 1;
+        }
+      } else {
+        // Board navigation
+        const cols = [
+          state.boardColumns.todo,
+          state.boardColumns.inProgress,
+          state.boardColumns.done,
+        ];
+
+        if (matchesKey(key, "h") || matchesKey(key, "left")) {
+          state.boardCol = Math.max(0, state.boardCol - 1);
+        } else if (matchesKey(key, "l") || matchesKey(key, "right")) {
+          state.boardCol = Math.min(2, state.boardCol + 1);
+        } else if (matchesKey(key, "j") || matchesKey(key, "down")) {
+          const col = cols[state.boardCol];
+          state.boardIndex[state.boardCol] = Math.min(
+            state.boardIndex[state.boardCol] + 1,
+            col.length - 1,
+          );
+        } else if (matchesKey(key, "k") || matchesKey(key, "up")) {
+          state.boardIndex[state.boardCol] = Math.max(
+            state.boardIndex[state.boardCol] - 1,
+            0,
+          );
+        }
+      }
+
+      render();
+    };
+
+    // Start
+    render();
+    (tui as unknown as { on(event: string, handler: (data: string) => void): void }).on("key", handleKey);
+  };
+}

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -27,7 +27,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.1.3"
+    "@pi-unipi/core": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/src/tui/add-overlay.ts

@@ -31,6 +31,7 @@ import {
   getProjectConfigDir,
 } from "../config/manager.js";
 import { validateMcpConfig, DEFAULT_MCP_CONFIG, DEFAULT_METADATA } from "../config/schema.js";
+import { boxInnerWidth, normalizeWidth, WidthKeyedCache } from "@pi-unipi/core";
 
 type Mode = "normal" | "search" | "editor";
 type StatusKind = "info" | "success" | "warn" | "error";
@@ -158,11 +159,12 @@ export function renderMcpAddOverlay(params?: {
     // Ctrl+S handles saving; no submit path needed.
     (editor as any).disableSubmit = true;
 
-    let cachedLines: string[] | undefined;
+    // Width-keyed so a terminal resize can never serve stale, over-wide lines.
+    const lineCache = new WidthKeyedCache();
     let lastListHeight = 12;
 
     function refresh() {
-      cachedLines = undefined;
+      lineCache.clear();
       tui.requestRender();
     }
 
@@ -537,11 +539,13 @@ export function renderMcpAddOverlay(params?: {
 
     // ─── Rendering ────────────────────────────────────────────────────
 
-    function render(width: number): string[] {
-      if (cachedLines) return cachedLines;
+    function render(rawWidth: number): string[] {
+      const width = normalizeWidth(rawWidth);
+      const cached = lineCache.get(width);
+      if (cached) return cached;
 
       const lines: string[] = [];
-      const innerWidth = Math.max(40, width - 2);
+      const innerWidth = boxInnerWidth(width);
 
       // Pane widths: account for left │, middle │, right │ borders
       const leftW = Math.floor((innerWidth - 1) / 2);
@@ -776,8 +780,7 @@ export function renderMcpAddOverlay(params?: {
       );
       lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
 
-      cachedLines = lines;
-      return lines;
+      return lineCache.set(width, lines);
     }
 
     return { render, invalidate: refresh, handleInput };

package/packages/mcp/src/tui/settings-overlay.ts

@@ -16,6 +16,7 @@ import {
   getGlobalConfigDir,
   getProjectConfigDir,
 } from "../config/manager.js";
+import { boxInnerWidth, normalizeWidth, WidthKeyedCache } from "@pi-unipi/core";
 
 /** Server display item */
 interface ServerDisplayItem {
@@ -65,7 +66,8 @@ export function renderMcpSettingsOverlay(params?: {
       confirmDelete: null,
     };
 
-    let cachedLines: string[] | undefined;
+    // Width-keyed so a terminal resize can never serve stale, over-wide lines.
+    const lineCache = new WidthKeyedCache();
 
     function refreshServers() {
       const configDir =
@@ -115,7 +117,7 @@ export function renderMcpSettingsOverlay(params?: {
     refreshServers();
 
     function refresh() {
-      cachedLines = undefined;
+      lineCache.clear();
       tui.requestRender();
     }
 
@@ -275,11 +277,13 @@ export function renderMcpSettingsOverlay(params?: {
       return content + " ".repeat(pad);
     }
 
-    function render(width: number): string[] {
-      if (cachedLines) return cachedLines;
+    function render(rawWidth: number): string[] {
+      const width = normalizeWidth(rawWidth);
+      const cached = lineCache.get(width);
+      if (cached) return cached;
 
       const lines: string[] = [];
-      const innerWidth = Math.max(22, width - 2);
+      const innerWidth = boxInnerWidth(width);
 
       // ── Header ──────────────────────────────────────────────────────
       const header = " MCP Settings ";
@@ -356,8 +360,7 @@ export function renderMcpSettingsOverlay(params?: {
       );
       lines.push(theme.fg("accent", `╰${"─".repeat(innerWidth)}╯`));
 
-      cachedLines = lines;
-      return lines;
+      return lineCache.set(width, lines);
     }
 
     return { render, invalidate: refresh, handleInput };

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -43,8 +43,8 @@
     "better-sqlite3": "^12.9.0",
     "sqlite-vec": "^0.1.9",
     "js-yaml": "^4.1.0",
-    "@pi-unipi/core": "2.1.3",
-    "@pi-unipi/info-screen": "2.1.3"
+    "@pi-unipi/core": "2.2.0",
+    "@pi-unipi/info-screen": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",