@mrclrchtr/supi-code-intelligence 1.16.0 → 2.0.0

package/src/ui/tui/common.ts

@@ -0,0 +1,220 @@
+/**
+ * Shared TUI rendering utilities for code-intelligence tool results.
+ *
+ * Extracted from the per-tool renderers to eliminate duplication:
+ * evidence section rendering, markdown detail, count badges,
+ * partial/error guards, and the shared simple-result pattern.
+ */
+
+import { getMarkdownTheme, type Theme } from "@earendil-works/pi-coding-agent";
+import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
+import { formatEvidenceBadge } from "@mrclrchtr/supi-code-runtime/api";
+
+// ── Result type ──────────────────────────────────────────────────
+
+/** Shape of a pi tool result consumed by renderResult functions. */
+export interface ToolResult {
+  content: Array<{ type: string; text?: string }>;
+  details?: { type: string; data: Record<string, unknown> };
+  isError?: boolean;
+}
+
+// ── Evidence key labels ──────────────────────────────────────────
+
+export const EVIDENCE_KEY_LABELS: Record<string, string> = {
+  "callees.calls": "calls",
+  "exports.symbols": "exports",
+  "find.astMatches": "AST matches",
+  "find.semanticSymbols": "symbols",
+  "find.textMatches": "matches",
+  "health.dirtyFiles": "dirty files",
+  "implements.locations": "implementations",
+  "imports.modules": "imports",
+  "inspect.codeActions": "code actions",
+  "references.locations": "references",
+  "refactor.edits": "edits",
+  "resolve.candidates": "candidates",
+  "resolve.targets": "targets",
+};
+
+/** Resolve a human-readable label for an evidence list key. */
+export function evidenceLabel(key: string): string {
+  return EVIDENCE_KEY_LABELS[key] ?? key;
+}
+
+// ── Evidence entires ─────────────────────────────────────────────
+
+export interface EvidenceEntry {
+  key?: string;
+  shownCount?: number;
+  totalCount?: number | null;
+  omittedCount?: number | null;
+  partialReason?: string | null;
+}
+
+// ── Evidence section ─────────────────────────────────────────────
+
+/** Append formatted evidence badge lines to a container. */
+export function renderEvidenceLines(
+  container: Container,
+  entries: EvidenceEntry[] | undefined,
+  theme: Theme,
+): void {
+  if (!entries || entries.length === 0) return;
+  for (const ev of entries) {
+    const badge = formatEvidenceBadge({
+      shownCount: Number(ev.shownCount ?? 0),
+      totalCount: ev.totalCount != null ? Number(ev.totalCount) : null,
+      omittedCount: ev.omittedCount != null ? Number(ev.omittedCount) : null,
+      partialReason: typeof ev.partialReason === "string" ? ev.partialReason : null,
+      label: evidenceLabel(String(ev.key ?? "")),
+    });
+    container.addChild(new Text(theme.fg("muted", badge), 0, 0));
+  }
+}
+
+// ── Markdown detail ──────────────────────────────────────────────
+
+interface MarkdownSource {
+  content?: Array<{ type: string; text?: string }>;
+}
+
+/** Append a "raw markdown" section to a container when markdown content is present. */
+export function renderMarkdownDetail(
+  container: Container,
+  source: MarkdownSource,
+  theme: Theme,
+): void {
+  const markdownText = source.content?.find((c) => c.type === "text")?.text ?? "";
+  if (!markdownText) return;
+  container.addChild(new Spacer(1));
+  const divider = `${theme.fg("border", "────")} ${theme.fg("dim", "raw markdown")} ${theme.fg("border", "─".repeat(100))}`;
+  container.addChild(new Text(divider, 0, 0));
+  container.addChild(new Markdown(markdownText, 0, 0, getMarkdownTheme()));
+}
+
+// ── Partial / error guards ───────────────────────────────────────
+
+export function renderPartial(label: string, theme: Theme): Text {
+  return new Text(theme.fg("warning", label), 0, 0);
+}
+
+export function renderError(label: string, theme: Theme): Text {
+  return new Text(theme.fg("error", label), 0, 0);
+}
+
+// ── Result optios ────────────────────────────────────────────────
+
+export interface ResultOptios {
+  expanded: boolean;
+  isPartial: boolean;
+}
+
+// ── Shared simple-result renderer ────────────────────────────────
+
+/**
+ * Shared result renderer for the "simple" code-intelligence tools
+ * (resolve, inspect, find, impact, refactor_plan, refactor_apply).
+ *
+ * Handles partial, error, compact, and expanded states uniformly.
+ */
+export function renderSimpleResult(
+  result: ToolResult,
+  options: ResultOptios,
+  theme: Theme,
+  partialLabel: string,
+): Container | Text {
+  if (options.isPartial) return renderPartial(partialLabel, theme);
+  if (result.isError) return renderError("Tool failed", theme);
+
+  const data = result.details?.data as Record<string, unknown> | undefined;
+  if (options.expanded) return buildExpandedView(result, data, theme);
+
+  return buildSimpleCompact(data, theme);
+}
+
+function buildExpandedView(
+  result: ToolResult,
+  data: Record<string, unknown> | undefined,
+  theme: Theme,
+): Container {
+  const container = new Container();
+
+  const header = buildSimpleHeader(data, theme);
+  if (header) container.addChild(header);
+
+  const lists = data?.evidenceLists as EvidenceEntry[] | undefined;
+  if (lists && lists.length > 0) {
+    container.addChild(new Spacer(1));
+    renderEvidenceLines(container, lists, theme);
+    container.addChild(new Spacer(1));
+  }
+
+  renderMarkdownDetail(container, result, theme);
+
+  return container;
+}
+
+/** Options for {@link buildSimpleCompact} and {@link buildSimpleHeader}. */
+export interface SimpleResultOptions {
+  /** Omitted count for the evidence badge. Defaults to 0. */
+  omittedCount?: number;
+}
+
+export function buildSimpleCompact(
+  data: Record<string, unknown> | undefined,
+  theme: Theme,
+  opts?: SimpleResultOptions,
+): Text {
+  if (!data) return new Text(theme.fg("dim", "No results"), 0, 0);
+
+  const candidateCount = (data.candidateCount as number) ?? (data.targetCount as number) ?? 0;
+  const omittedCount = opts?.omittedCount ?? 0;
+  const confidence = (data.confidence as string) ?? "";
+
+  const badge = formatEvidenceBadge({
+    shownCount: candidateCount,
+    totalCount: candidateCount + omittedCount,
+    omittedCount,
+    partialReason: null,
+    label: "results",
+  });
+
+  const dot = theme.fg("dim", "·");
+  const segments = [theme.fg("success", theme.bold(badge))];
+  if (confidence) {
+    segments.push(`${theme.fg("dim", "confidence")} ${theme.fg("muted", confidence)}`);
+  }
+
+  return new Text(segments.join(` ${dot} `), 0, 0);
+}
+
+export function buildSimpleHeader(
+  data: Record<string, unknown> | undefined,
+  theme: Theme,
+  opts?: SimpleResultOptions,
+): Text | null {
+  if (!data) return null;
+
+  const candidateCount = (data.candidateCount as number) ?? (data.targetCount as number) ?? 0;
+  const omittedCount = opts?.omittedCount ?? 0;
+  const confidence = (data.confidence as string) ?? "";
+
+  if (candidateCount === 0 && !confidence) return null;
+
+  const badge = formatEvidenceBadge({
+    shownCount: candidateCount,
+    totalCount: candidateCount + omittedCount,
+    omittedCount,
+    partialReason: null,
+    label: "results",
+  });
+
+  const dot = theme.fg("dim", "·");
+  const segments = [theme.fg("accent", theme.bold(badge))];
+  if (confidence) {
+    segments.push(`${theme.fg("dim", "confidence")} ${theme.fg("muted", confidence)}`);
+  }
+
+  return new Text(segments.join(` ${dot} `), 0, 0);
+}

package/src/ui/tui/index.ts

@@ -0,0 +1,37 @@
+/**
+ * Barrel export for code-intelligence TUI renderers.
+ */
+
+export {
+  renderFindCall,
+  renderFindResult,
+} from "../../tool/find/tui.ts";
+export {
+  renderGraphCall,
+  renderGraphResult,
+} from "../../tool/graph/tui.ts";
+export {
+  renderHealthCall,
+  renderHealthResult,
+} from "../../tool/health/tui.ts";
+export {
+  renderImpactCall,
+  renderImpactResult,
+} from "../../tool/impact/tui.ts";
+export {
+  renderInspectCall,
+  renderInspectResult,
+} from "../../tool/inspect/tui.ts";
+export { renderOrientationCall, renderOrientationResult } from "../../tool/orientation/tui.ts";
+export {
+  renderRefactorApplyCall,
+  renderRefactorApplyResult,
+} from "../../tool/refactor-apply/tui.ts";
+export {
+  renderRefactorPlanCall,
+  renderRefactorPlanResult,
+} from "../../tool/refactor-plan/tui.ts";
+export {
+  renderResolveCall,
+  renderResolveResult,
+} from "../../tool/resolve/tui.ts";

package/node_modules/@mrclrchtr/supi-lsp/src/extension.ts

@@ -1 +0,0 @@
-export { default } from "./lsp.ts";

package/node_modules/@mrclrchtr/supi-lsp/src/format.ts

@@ -1,373 +0,0 @@
-// LSP result formatting — converts LSP response types into readable text.
-
-import * as path from "node:path";
-import type {
-  AnnotatedTextEdit,
-  CodeAction,
-  DocumentSymbol,
-  Hover,
-  Location,
-  LocationLink,
-  MarkedString,
-  MarkupContent,
-  SnippetTextEdit,
-  SymbolInformation,
-  TextEdit,
-  WorkspaceEdit,
-  WorkspaceSymbol,
-} from "./config/types.ts";
-import { isProjectSource } from "./summary.ts";
-import { uriToFile } from "./utils.ts";
-
-// ── Hover ─────────────────────────────────────────────────────────────
-
-export function formatHover(hover: Hover): string {
-  const contents = hover.contents;
-
-  if (typeof contents === "string") return contents;
-  if ("value" in contents) {
-    const mc = contents as MarkupContent | { language: string; value: string };
-    if ("kind" in mc) return mc.value;
-    return `\`\`\`${mc.language}\n${mc.value}\n\`\`\``;
-  }
-  if (Array.isArray(contents)) {
-    return (contents as MarkedString[])
-      .map((c) => (typeof c === "string" ? c : `\`\`\`${c.language}\n${c.value}\n\`\`\``))
-      .join("\n\n");
-  }
-
-  return String(contents);
-}
-
-// ── Locations ─────────────────────────────────────────────────────────
-
-function formatLocationLine(loc: Location, cwd: string): string {
-  const file = relPath(uriToFile(loc.uri), cwd);
-  const line = loc.range.start.line + 1;
-  const col = loc.range.start.character + 1;
-  return `${file}:${line}:${col}`;
-}
-
-function formatLocationList(label: string, locs: Location[], cwd: string): string {
-  const lines = [`${label} (${locs.length} locations):\n`];
-  for (const loc of locs) {
-    lines.push(`- ${formatLocationLine(loc, cwd)}`);
-  }
-  return lines.join("\n");
-}
-
-function formatExternalFallback(label: string, locs: Location[], cwd: string): string {
-  const maxShown = 3;
-  const shown = locs.slice(0, maxShown);
-  const hidden = locs.length - maxShown;
-
-  let result: string;
-  if (shown.length === 1) {
-    result = `${label}: ${formatLocationLine(shown[0], cwd)}`;
-  } else {
-    const lines = [`${label} (${locs.length} locations):\n`];
-    for (const loc of shown) {
-      lines.push(`- ${formatLocationLine(loc, cwd)}`);
-    }
-    result = lines.join("\n");
-  }
-
-  if (hidden > 0) {
-    result += `\n+${hidden} more external ${hidden === 1 ? "location" : "locations"}`;
-  }
-
-  return result;
-}
-
-function formatExternalSuffix(count: number): string {
-  return count === 1
-    ? "+1 external location (node_modules, .pnpm, or out-of-tree)"
-    : `+${count} external locations (node_modules, .pnpm, or out-of-tree)`;
-}
-
-export function formatLocations(label: string, locations: Location[], cwd: string): string {
-  const projectLocs: Location[] = [];
-  const externalLocs: Location[] = [];
-  for (const loc of locations) {
-    if (isProjectSource(uriToFile(loc.uri), cwd)) {
-      projectLocs.push(loc);
-    } else {
-      externalLocs.push(loc);
-    }
-  }
-
-  let result: string;
-
-  if (projectLocs.length === 1) {
-    result = `${label}: ${formatLocationLine(projectLocs[0], cwd)}`;
-  } else if (projectLocs.length > 1) {
-    result = formatLocationList(label, projectLocs, cwd);
-  } else if (externalLocs.length > 0) {
-    return formatExternalFallback(label, externalLocs, cwd);
-  } else {
-    return `${label}: No locations found.`;
-  }
-
-  if (externalLocs.length > 0) {
-    result += `\n${formatExternalSuffix(externalLocs.length)}`;
-  }
-
-  return result;
-}
-
-export function normalizeLocations(result: Location | Location[] | LocationLink[]): Location[] {
-  if (Array.isArray(result)) {
-    return result.map((item) => {
-      if ("targetUri" in item) {
-        const link = item as LocationLink;
-        return { uri: link.targetUri, range: link.targetSelectionRange };
-      }
-      return item as Location;
-    });
-  }
-  return [result as Location];
-}
-
-// ── Symbols ───────────────────────────────────────────────────────────
-
-export function formatDocumentSymbols(symbols: DocumentSymbol[], indent: number): string {
-  const lines: string[] = [];
-  const prefix = "  ".repeat(indent);
-
-  for (const sym of symbols) {
-    const kind = symbolKindName(sym.kind);
-    const line = sym.selectionRange.start.line + 1;
-    const detail = sym.detail ? ` — ${sym.detail}` : "";
-    lines.push(`${prefix}- ${kind} **${sym.name}**${detail} (line ${line})`);
-
-    if (sym.children && sym.children.length > 0) {
-      lines.push(formatDocumentSymbols(sym.children, indent + 1));
-    }
-  }
-
-  return lines.join("\n");
-}
-
-export function formatSymbolInformation(symbols: SymbolInformation[], cwd: string): string {
-  const projectSyms: (SymbolInformation | WorkspaceSymbol)[] = [];
-  const externalSyms: (SymbolInformation | WorkspaceSymbol)[] = [];
-  for (const sym of symbols) {
-    if (isProjectSource(uriToFile(sym.location.uri), cwd)) {
-      projectSyms.push(sym);
-    } else {
-      externalSyms.push(sym);
-    }
-  }
-
-  const lines: string[] = [];
-  const symbolsToShow = projectSyms.length > 0 ? projectSyms : externalSyms;
-  for (const sym of symbolsToShow) {
-    const kind = symbolKindName(sym.kind);
-    const file = relPath(uriToFile(sym.location.uri), cwd);
-    const line = "range" in sym.location ? sym.location.range.start.line + 1 : "?";
-    const container = sym.containerName ? ` (in ${sym.containerName})` : "";
-    lines.push(`- ${kind} **${sym.name}**${container} — ${file}:${line}`);
-  }
-
-  if (projectSyms.length > 0 && externalSyms.length > 0) {
-    const suffix =
-      externalSyms.length === 1
-        ? "+1 external symbol (node_modules, .pnpm, or out-of-tree)"
-        : `+${externalSyms.length} external symbols (node_modules, .pnpm, or out-of-tree)`;
-    lines.push(`- _${suffix}_`);
-  }
-
-  return lines.join("\n");
-}
-
-// ── Workspace Edits ───────────────────────────────────────────────────
-
-interface DisplayEdit {
-  range: { start: { line: number } };
-  newText: string;
-}
-
-interface EditEntry {
-  file: string;
-  edits: DisplayEdit[];
-}
-
-/**
- * Normalize a TextEdit/AnnotatedTextEdit/SnippetTextEdit to a display-friendly form.
- *
- * @since 3.18.0 — vscode-languageserver-types widened TextDocumentEdit.edits to include
- * SnippetTextEdit (guarded by `workspace.workspaceEdit.snippetEditSupport` client capability).
- */
-function editToDisplay(edit: TextEdit | AnnotatedTextEdit | SnippetTextEdit): DisplayEdit {
-  if ("snippet" in edit) {
-    return { range: edit.range, newText: edit.snippet.value };
-  }
-  return { range: edit.range, newText: edit.newText };
-}
-
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pre-existing — not introduced by this change
-function partitionWorkspaceEdit(
-  edit: WorkspaceEdit,
-  cwd: string,
-): { projectChanges: EditEntry[]; externalCount: number } {
-  const projectChanges: EditEntry[] = [];
-  let externalCount = 0;
-
-  if (edit.changes) {
-    for (const [uri, edits] of Object.entries(edit.changes)) {
-      const filePath = uriToFile(uri);
-      if (isProjectSource(filePath, cwd)) {
-        projectChanges.push({
-          file: relPath(filePath, cwd),
-          edits: edits.map(editToDisplay),
-        });
-      } else {
-        externalCount++;
-      }
-    }
-  }
-
-  if (edit.documentChanges) {
-    for (const dc of edit.documentChanges) {
-      if (!("textDocument" in dc)) continue;
-      const filePath = uriToFile(dc.textDocument.uri);
-      if (isProjectSource(filePath, cwd)) {
-        projectChanges.push({
-          file: relPath(filePath, cwd),
-          edits: dc.edits.map(editToDisplay),
-        });
-      } else {
-        externalCount++;
-      }
-    }
-  }
-
-  return { projectChanges, externalCount };
-}
-
-export function formatWorkspaceEdit(edit: WorkspaceEdit, cwd: string): string {
-  const { projectChanges, externalCount } = partitionWorkspaceEdit(edit, cwd);
-
-  const lines: string[] = ["Rename workspace edit:\n"];
-  for (const { file, edits } of projectChanges) {
-    lines.push(`**${file}** (${edits.length} change(s))`);
-    for (const e of edits) {
-      const line = e.range.start.line + 1;
-      lines.push(`  Line ${line}: → "${e.newText}"`);
-    }
-  }
-
-  if (externalCount > 0) {
-    const suffix =
-      externalCount === 1
-        ? "+1 external file (node_modules, .pnpm, or out-of-tree)"
-        : `+${externalCount} external files (node_modules, .pnpm, or out-of-tree)`;
-    lines.push(`\n_${suffix}_`);
-  }
-
-  return lines.join("\n");
-}
-
-// ── Code Actions ──────────────────────────────────────────────────────
-
-export function formatCodeActions(actions: CodeAction[]): string {
-  const lines = [`Available code actions (${actions.length}):\n`];
-  for (const action of actions) {
-    const kind = action.kind ? ` [${action.kind}]` : "";
-    const preferred = action.isPreferred ? " ⭐" : "";
-    lines.push(`- **${action.title}**${kind}${preferred}`);
-    if (action.edit) {
-      const fileCount = action.edit.changes
-        ? Object.keys(action.edit.changes).length
-        : (action.edit.documentChanges?.length ?? 0);
-      lines.push(`  Edits ${fileCount} file(s)`);
-    }
-  }
-  return lines.join("\n");
-}
-
-// ── Workspace Symbols ─────────────────────────────────────────────────
-
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pre-existing — threshold exceeded by widened parameter type for WorkspaceSymbol compatibility
-export function formatWorkspaceSymbols(
-  symbols: (SymbolInformation | WorkspaceSymbol)[],
-  cwd: string,
-): string {
-  if (symbols.length === 0) return "No symbols found.";
-
-  const projectSyms: (SymbolInformation | WorkspaceSymbol)[] = [];
-  const externalSyms: (SymbolInformation | WorkspaceSymbol)[] = [];
-  for (const sym of symbols) {
-    if (isProjectSource(uriToFile(sym.location.uri), cwd)) {
-      projectSyms.push(sym);
-    } else {
-      externalSyms.push(sym);
-    }
-  }
-
-  if (projectSyms.length === 0 && externalSyms.length > 0) {
-    return `Workspace symbols: No in-project symbols found.\n+${externalSyms.length} external symbol${externalSyms.length === 1 ? "" : "s"} (node_modules, .pnpm, or out-of-tree).`;
-  }
-
-  const lines = [`Workspace symbols (${projectSyms.length}):\n`];
-  for (const sym of projectSyms) {
-    const kind = symbolKindName(sym.kind);
-    const file = relPath(uriToFile(sym.location.uri), cwd);
-    const loc = "range" in sym.location ? sym.location.range : null;
-    const line = loc ? loc.start.line + 1 : "?";
-    const col = loc ? loc.start.character + 1 : "?";
-    const container = sym.containerName ? ` — ${sym.containerName}` : "";
-    lines.push(`- **${sym.name}** (${kind})${container} — ${file}:${line}:${col}`);
-  }
-
-  if (externalSyms.length > 0) {
-    const suffix =
-      externalSyms.length === 1
-        ? "+1 external symbol (node_modules, .pnpm, or out-of-tree)"
-        : `+${externalSyms.length} external symbols (node_modules, .pnpm, or out-of-tree)`;
-    lines.push(`\n_${suffix}_`);
-  }
-
-  return lines.join("\n");
-}
-
-// ── Symbol Kind Names ─────────────────────────────────────────────────
-
-const SYMBOL_KIND_NAMES: Record<number, string> = {
-  1: "File",
-  2: "Module",
-  3: "Namespace",
-  4: "Package",
-  5: "Class",
-  6: "Method",
-  7: "Property",
-  8: "Field",
-  9: "Constructor",
-  10: "Enum",
-  11: "Interface",
-  12: "Function",
-  13: "Variable",
-  14: "Constant",
-  15: "String",
-  16: "Number",
-  17: "Boolean",
-  18: "Array",
-  19: "Object",
-  20: "Key",
-  21: "Null",
-  22: "EnumMember",
-  23: "Struct",
-  24: "Event",
-  25: "Operator",
-  26: "TypeParameter",
-};
-
-function symbolKindName(kind: number): string {
-  return SYMBOL_KIND_NAMES[kind] ?? `Kind(${kind})`;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────
-
-function relPath(filePath: string, cwd: string): string {
-  return path.relative(cwd, filePath);
-}