@pi-unipi/unipi 2.4.0 → 2.4.2

package/packages/compactor/src/session/analytics.ts

@@ -1,205 +0,0 @@
-/**
- * AnalyticsEngine — Runtime savings + session continuity reporting.
- *
- * Ported from context-mode's AnalyticsEngine, trimmed to budget-focused stats.
- * Omits: formatReport(), categoryLabels, categoryHints, ThinkInCodeComparison,
- * SandboxIO, dataBar(), visual formatting helpers.
- *
- * Usage:
- *   const engine = new AnalyticsEngine(sessionDb);
- *   const report = engine.queryAll(runtimeStats);
- */
-
-// ─────────────────────────────────────────────────────────
-// Types
-// ─────────────────────────────────────────────────────────
-
-/** Database adapter — anything with a prepare() method (better-sqlite3, bun:sqlite, etc.) */
-export interface DatabaseAdapter {
-  prepare(sql: string): {
-    run(...params: unknown[]): unknown;
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-  };
-}
-
-/** Context savings result */
-export interface ContextSavings {
-  rawBytes: number;
-  contextBytes: number;
-  savedBytes: number;
-  savedPercent: number;
-}
-
-/** Runtime stats tracked during a live session. */
-export interface RuntimeStats {
-  bytesReturned: Record<string, number>;
-  bytesIndexed: number;
-  bytesSandboxed: number;
-  calls: Record<string, number>;
-  sessionStart: number;
-  cacheHits: number;
-  cacheBytesSaved: number;
-}
-
-/** Unified report combining runtime stats, DB analytics, and continuity data. */
-export interface FullReport {
-  /** Runtime context savings */
-  savings: {
-    processed_kb: number;
-    entered_kb: number;
-    saved_kb: number;
-    pct: number;
-    savings_ratio: number;
-    by_tool: Array<{ tool: string; calls: number; context_kb: number; tokens: number }>;
-    total_calls: number;
-    total_bytes_returned: number;
-    kept_out: number;
-    total_processed: number;
-  };
-  /** Session metadata from SessionDB */
-  session: {
-    id: string;
-    uptime_min: string;
-  };
-  /** Session continuity data */
-  continuity: {
-    total_events: number;
-    compact_count: number;
-    all_time_compact_count: number;
-    resume_ready: boolean;
-  };
-  /** Persistent project memory — all events across all sessions */
-  projectMemory: {
-    total_events: number;
-    session_count: number;
-  };
-}
-
-// ─────────────────────────────────────────────────────────
-// AnalyticsEngine
-// ─────────────────────────────────────────────────────────
-
-export class AnalyticsEngine {
-  private readonly db: DatabaseAdapter;
-
-  constructor(db: DatabaseAdapter) {
-    this.db = db;
-  }
-
-  /**
-   * Build a FullReport by merging runtime stats (passed in)
-   * with continuity data from the DB.
-   */
-  queryAll(runtimeStats: RuntimeStats): FullReport {
-    // ── Resolve latest session ID ──
-    const latestSession = this.db.prepare(
-      "SELECT session_id FROM session_meta ORDER BY started_at DESC LIMIT 1",
-    ).get() as { session_id: string } | undefined;
-    const sid = latestSession?.session_id ?? "";
-
-    // ── Runtime savings ──
-    const totalBytesReturned = Object.values(runtimeStats.bytesReturned).reduce(
-      (sum, b) => sum + b, 0,
-    );
-    const totalCalls = Object.values(runtimeStats.calls).reduce(
-      (sum, c) => sum + c, 0,
-    );
-    const keptOut = runtimeStats.bytesIndexed + runtimeStats.bytesSandboxed;
-    const totalProcessed = keptOut + totalBytesReturned;
-    const savingsRatio = totalProcessed / Math.max(totalBytesReturned, 1);
-    const reductionPct = totalProcessed > 0
-      ? Math.round((1 - totalBytesReturned / totalProcessed) * 100)
-      : 0;
-
-    const toolNames = new Set([
-      ...Object.keys(runtimeStats.calls),
-      ...Object.keys(runtimeStats.bytesReturned),
-    ]);
-    const byTool = Array.from(toolNames).sort().map((tool) => ({
-      tool,
-      calls: runtimeStats.calls[tool] || 0,
-      context_kb: Math.round((runtimeStats.bytesReturned[tool] || 0) / 1024 * 10) / 10,
-      tokens: Math.round((runtimeStats.bytesReturned[tool] || 0) / 4),
-    }));
-
-    const uptimeMs = Date.now() - runtimeStats.sessionStart;
-    const uptimeMin = (uptimeMs / 60_000).toFixed(1);
-
-    // ── Continuity data (scoped to current session) ──
-    const eventTotal = (this.db.prepare(
-      "SELECT COUNT(*) as cnt FROM session_events WHERE session_id = ?",
-    ).get(sid) as { cnt: number }).cnt;
-
-    const meta = this.db.prepare(
-      "SELECT compact_count FROM session_meta WHERE session_id = ?",
-    ).get(sid) as { compact_count: number } | undefined;
-    const compactCount = meta?.compact_count ?? 0;
-
-    // ── All-time compaction count across all sessions ──
-    const allTimeCompactions = (this.db.prepare(
-      "SELECT COALESCE(SUM(compact_count), 0) as total FROM session_meta",
-    ).get() as { total: number }).total;
-
-    const resume = this.db.prepare(
-      "SELECT event_count, consumed FROM session_resume WHERE session_id = ? ORDER BY created_at DESC LIMIT 1",
-    ).get(sid) as { event_count: number; consumed: number } | undefined;
-    const resumeReady = resume ? !resume.consumed : false;
-
-    // ── Project-wide persistent memory (all sessions, no session_id filter) ──
-    const projectTotals = this.db.prepare(
-      "SELECT COUNT(*) as cnt, COUNT(DISTINCT session_id) as sessions FROM session_events",
-    ).get() as { cnt: number; sessions: number };
-
-    return {
-      savings: {
-        processed_kb: Math.round(totalProcessed / 1024 * 10) / 10,
-        entered_kb: Math.round(totalBytesReturned / 1024 * 10) / 10,
-        saved_kb: Math.round(keptOut / 1024 * 10) / 10,
-        pct: reductionPct,
-        savings_ratio: Math.round(savingsRatio * 10) / 10,
-        by_tool: byTool,
-        total_calls: totalCalls,
-        total_bytes_returned: totalBytesReturned,
-        kept_out: keptOut,
-        total_processed: totalProcessed,
-      },
-      session: {
-        id: sid,
-        uptime_min: uptimeMin,
-      },
-      continuity: {
-        total_events: eventTotal,
-        compact_count: compactCount,
-        all_time_compact_count: allTimeCompactions,
-        resume_ready: resumeReady,
-      },
-      projectMemory: {
-        total_events: projectTotals.cnt,
-        session_count: projectTotals.sessions,
-      },
-    };
-  }
-}
-
-// ─────────────────────────────────────────────────────────
-// createMinimalDb — in-memory SQLite fallback
-// ─────────────────────────────────────────────────────────
-
-/**
- * Create a minimal in-memory DatabaseAdapter for when SessionDB is unavailable.
- * Returns zeroed/empty results for all queries.
- */
-export function createMinimalDb(): DatabaseAdapter {
-  // Use an in-memory SQLite database with the expected schema
-  // so AnalyticsEngine queries don't fail.
-  const emptyStmt = {
-    run: (..._params: unknown[]) => {},
-    get: (..._params: unknown[]) => ({ cnt: 0, sessions: 0, compact_count: 0, total: 0, session_id: "", event_count: 0, consumed: 1 }),
-    all: (..._params: unknown[]) => [] as unknown[],
-  };
-
-  return {
-    prepare: (_sql: string) => emptyStmt,
-  };
-}

package/packages/image/index.ts

@@ -1 +0,0 @@
-export { default } from "./src/index.js";

package/packages/input-shortcuts/index.ts

@@ -1,5 +0,0 @@
-/**
- * @pi-unipi/input-shortcuts — Re-exports
- */
-
-export { default } from "./src/index.ts";

package/packages/input-shortcuts/src/status.ts

@@ -1,35 +0,0 @@
-/**
- * Status bar feedback helper using ctx.ui.setStatus() with auto-clear.
- */
-
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { STATUS_SUCCESS_MS, STATUS_ERROR_MS } from "./types.ts";
-
-const STATUS_KEY = "input-shortcuts";
-
-/** Show a success status message with auto-clear. */
-export function showSuccess(ctx: ExtensionContext, text: string, durationMs = STATUS_SUCCESS_MS): void {
-  showStatus(ctx, text, durationMs);
-}
-
-/** Show an error status message with auto-clear. */
-export function showError(ctx: ExtensionContext, text: string, durationMs = STATUS_ERROR_MS): void {
-  showStatus(ctx, text, durationMs);
-}
-
-/** Show status text with auto-clear after duration. */
-export function showStatus(ctx: ExtensionContext, text: string, durationMs: number): void {
-  ctx.ui.setStatus(STATUS_KEY, text);
-  setTimeout(() => {
-    try {
-      ctx.ui.setStatus(STATUS_KEY, undefined);
-    } catch {
-      // Context may be gone — ignore
-    }
-  }, durationMs);
-}
-
-/** Clear the status bar entry immediately. */
-export function clearStatus(ctx: ExtensionContext): void {
-  ctx.ui.setStatus(STATUS_KEY, undefined);
-}

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

@@ -1,300 +0,0 @@
-/**
- * @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/index.ts

@@ -1 +0,0 @@
-export { default } from "./src/index.js";

package/packages/memory/search.ts

@@ -1,134 +0,0 @@
-/**
- * @unipi/memory — Hybrid search algorithm
- *
- * Combines vector similarity search with fuzzy text matching
- * for best recall across semantic and exact matches.
- */
-
-import type { MemoryStorage, MemoryRecord, SearchResult } from "./storage.js";
-
-/**
- * Perform hybrid search combining vector + fuzzy.
- */
-export function hybridSearch(
-  storage: MemoryStorage,
-  query: string,
-  limit = 10,
-  embedding?: Float32Array | null
-): SearchResult[] {
-  // Delegate to storage's search method which already implements hybrid
-  return storage.search(query, limit, embedding);
-}
-
-/**
- * Calculate fuzzy match score between text and query.
- * Returns 0-1 score (1 = perfect match).
- */
-export function fuzzyMatch(text: string, query: string): number {
-  const lowerText = text.toLowerCase();
-  const lowerQuery = query.toLowerCase();
-
-  // Exact match
-  if (lowerText === lowerQuery) return 1.0;
-
-  // Starts with
-  if (lowerText.startsWith(lowerQuery)) return 0.9;
-
-  // Contains
-  if (lowerText.includes(lowerQuery)) return 0.7;
-
-  // Word boundary match
-  const words = lowerQuery.split(/\s+/);
-  let matchedWords = 0;
-  for (const word of words) {
-    if (lowerText.includes(word)) {
-      matchedWords++;
-    }
-  }
-  if (matchedWords > 0) {
-    return 0.3 + (matchedWords / words.length) * 0.4;
-  }
-
-  // Subsequence match
-  let textIdx = 0;
-  let queryIdx = 0;
-  let subsequenceMatches = 0;
-
-  while (textIdx < lowerText.length && queryIdx < lowerQuery.length) {
-    if (lowerText[textIdx] === lowerQuery[queryIdx]) {
-      subsequenceMatches++;
-      queryIdx++;
-    }
-    textIdx++;
-  }
-
-  if (queryIdx === lowerQuery.length) {
-    // All query chars found in order
-    return 0.2 + (subsequenceMatches / lowerQuery.length) * 0.2;
-  }
-
-  return 0;
-}
-
-/**
- * Extract a snippet around the query match.
- */
-export function extractSnippet(
-  content: string,
-  query: string,
-  chars = 150
-): string {
-  const lowerContent = content.toLowerCase();
-  const lowerQuery = query.toLowerCase();
-
-  // Find best match position
-  let bestIdx = -1;
-  let bestScore = 0;
-
-  const words = lowerQuery.split(/\s+/);
-  for (const word of words) {
-    const idx = lowerContent.indexOf(word);
-    if (idx !== -1 && (bestIdx === -1 || idx < bestIdx)) {
-      bestIdx = idx;
-      bestScore = 0.8;
-    }
-  }
-
-  if (bestIdx === -1) {
-    // No match, return beginning
-    return content.slice(0, chars) + (content.length > chars ? "..." : "");
-  }
-
-  const start = Math.max(0, bestIdx - chars / 3);
-  const end = Math.min(content.length, bestIdx + chars * 2 / 3);
-  let snippet = content.slice(start, end);
-
-  if (start > 0) snippet = "..." + snippet;
-  if (end < content.length) snippet = snippet + "...";
-
-  return snippet;
-}
-
-/**
- * Merge and deduplicate search results from multiple sources.
- */
-export function mergeResults(
-  ...resultSets: SearchResult[][]
-): SearchResult[] {
-  const merged = new Map<string, SearchResult>();
-
-  for (const results of resultSets) {
-    for (const result of results) {
-      const existing = merged.get(result.record.id);
-      if (existing) {
-        // Boost score if found in multiple sources
-        existing.score = Math.min(existing.score + result.score * 0.2, 1);
-      } else {
-        merged.set(result.record.id, { ...result });
-      }
-    }
-  }
-
-  return Array.from(merged.values())
-    .sort((a, b) => b.score - a.score);
-}