pi-weave 0.1.1

package/src/pi/viewer/tui/run.ts

@@ -0,0 +1,69 @@
+/**
+ * runWeaveViewTui — wires the WeaveExplorer into a pi session
+ * (weave-view-tui-design §2, §4.1, §3.2).
+ *
+ * Guards (interactive terminal only), builds the graph from disk in the
+ * handler, then hands a ready WeaveExplorer to `ctx.ui.custom` so the
+ * explorer owns input for its whole lifetime. After `done(null)` resolves,
+ * the workspace status line is refreshed. Dependencies are injected so the
+ * component never touches a real terminal directly.
+ */
+
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import {
+  buildCurrentGraph,
+  readNoteForView,
+  readOkfFileForView,
+  resolveVaultRoot,
+  type GraphModel,
+} from "../../../core";
+import { openNoteInEditor } from "../server";
+import { WeaveExplorer, type WeaveLoaders, type WeaveTheme, type WeaveTui } from "./explorer";
+import { getWorkspaceStatus, formatStatusLine } from "../../../core";
+
+/** Open the in-terminal knowledge explorer. Returns when the explorer closes. */
+export async function runWeaveViewTui(ctx: ExtensionCommandContext): Promise<void> {
+  // Guard: the TUI needs an interactive terminal (design §2).
+  if (!ctx.hasUI || ctx.mode !== "tui") {
+    ctx.ui.notify(
+      "pi-weave: '/weave-view tui' needs an interactive terminal — run /weave-view for the browser viewer.",
+      "warning",
+    );
+    return;
+  }
+
+  const cwd = ctx.cwd;
+  const vaultRoot = resolveVaultRoot();
+  const model = await buildCurrentGraph(cwd, vaultRoot);
+
+  const loaders: WeaveLoaders = {
+    loadNote: (slug) => readNoteForView(vaultRoot, slug),
+    loadOkf: (rel) => readOkfFileForView(cwd, rel),
+    openNote: (slug) => openNoteInEditor(vaultRoot, slug),
+    rebuild: () => buildCurrentGraph(cwd, vaultRoot),
+  };
+
+  await ctx.ui.custom(
+    (tui, theme, _keybindings, done) => {
+      const explorer = new WeaveExplorer({
+        model,
+        theme: theme as unknown as WeaveTheme,
+        tui: tui as unknown as WeaveTui,
+        loaders,
+        done,
+        rows: tui.terminal.rows,
+      });
+      return explorer;
+    },
+    // Full-screen, not an overlay (design §4.1).
+  );
+
+  // Refresh the status line after close (a /weave-scan may have landed meanwhile).
+  const status = await getWorkspaceStatus(ctx.cwd);
+  ctx.ui.setStatus("weave", formatStatusLine(status));
+}
+
+/** Test seam: build the model the explorer opens with, without a terminal. */
+export async function buildTuiModel(cwd: string, vaultRoot: string = resolveVaultRoot()): Promise<GraphModel> {
+  return buildCurrentGraph(cwd, vaultRoot);
+}

package/src/pi/viewer/tui/theme.ts

@@ -0,0 +1,90 @@
+/**
+ * Provenance & kind → glyph + theme color-slot maps for the weave-view TUI
+ * (weave-view-tui-design §7).
+ *
+ * Pure data: imports only core types. Theme slots are names only
+ * (`theme.fg(slot, …)` applies the actual color), so pi themes restyle
+ * everything — never hardcoded hex. Style-first per v2 P1: provenance is
+ * glyph + dimness, color is the weak secondary channel.
+ */
+
+import type { NodeKind } from "../../../core/graph/model";
+import type { NoteSource } from "../../../core/types";
+
+/** Theme foreground color-slot names understood by pi's `Theme`. */
+export type ThemeSlot =
+  | "accent"
+  | "success"
+  | "warning"
+  | "dim"
+  | "muted"
+  | "text";
+
+/** Provenance rendering: glyph prefix, whole-row dimness, and theme slot. */
+export interface ProvenanceStyle {
+  glyph: string;
+  /** When true, the whole row is rendered dim (generated knowledge). */
+  dim: boolean;
+  slot: ThemeSlot;
+  /** Word printed in the provenance cycle / header banner, e.g. "human". */
+  word: string;
+}
+
+/** The provenance cycle order for the `p` key: all → human → agent → generated → all. */
+export const PROVENANCE_CYCLE: readonly (NoteSource | null)[] = [null, "human", "agent", "generated"];
+
+export function provenanceStyle(prov: NoteSource | null): ProvenanceStyle {
+  switch (prov) {
+    case "human":
+      return { glyph: "●", dim: false, slot: "success", word: "human" };
+    case "agent":
+      return { glyph: "◐", dim: false, slot: "accent", word: "agent" };
+    case "generated":
+      return { glyph: "○", dim: true, slot: "dim", word: "generated" };
+    default:
+      // structural node — no provenance glyph; kind glyph leads.
+      return { glyph: "", dim: false, slot: "muted", word: "" };
+  }
+}
+
+export interface KindStyle {
+  glyph: string;
+  slot: ThemeSlot;
+}
+
+/** Kind → glyph + slot. Notes defer to their provenance glyph (trust-first). */
+export function kindStyle(kind: NodeKind): KindStyle {
+  switch (kind) {
+    case "vault":
+      return { glyph: "◆", slot: "accent" };
+    case "note":
+      // provenance glyph leads; kind slot unused for the marker.
+      return { glyph: "", slot: "text" };
+    case "repository":
+      return { glyph: "■", slot: "accent" };
+    case "module":
+      return { glyph: "▪", slot: "success" };
+    case "package":
+      return { glyph: "▲", slot: "success" };
+    case "entryPoint":
+      return { glyph: "▹", slot: "warning" };
+    case "gitState":
+      return { glyph: "⎇", slot: "warning" };
+    case "external":
+      return { glyph: "↗", slot: "warning" };
+    case "file":
+      return { glyph: "·", slot: "dim" };
+  }
+}
+
+/** Chevron shown for an expandable tree row. */
+export function chevron(expanded: boolean, hasKids: boolean): string {
+  if (!hasKids) return " ";
+  return expanded ? "▾" : "▸";
+}
+
+/** Selection gutter marker. */
+export const SELECTION_MARKER = "›";
+
+/** Maximum length of the inline search/filter string (design §9.4). */
+export const MAX_FILTER_LEN = 200;