@cortexkit/aft-opencode 0.56.2 → 0.57.0

package/src/tui/sidebar.tsx

@@ -10,238 +10,54 @@ import { canonicalizeProjectRoot } from "@cortexkit/aft-bridge";
 import type { TuiPluginApi, TuiSlotPlugin, TuiThemeCurrent } from "@opencode/plugin/tui";
 import { createEffect, createMemo, createSignal, on, onCleanup } from "solid-js";
 import { AftRpcClient } from "../shared/rpc-client";
-import {
-  type AftStatusSnapshot,
-  coerceAftStatus,
-  formatSemanticIndexStatus,
-  formatSemanticRefreshing,
-  type StatusBar,
-  type StatusCompression,
-  worktreeCacheRoleNote,
-} from "../shared/status";
+import { type AftStatusSnapshot, coerceAftStatus } from "../shared/status";
 import { resolveCortexKitStorageRoot } from "../shared/storage-paths";
-import { badgeTextColor } from "./badge-contrast";
 import {
   createDebouncedStatusRefresh,
   refreshAftTuiSocketScope,
   subscribeStatusInvalidations,
 } from "./notification-socket";
 import {
-  type AftTuiPrefs,
   computeEffectiveOrder,
-  DEFAULT_PREFS,
   DEFAULT_SLOT_ORDER,
   PLUGIN_KEY,
-  persistCollapsedIfEnabled,
   readTuiPreferencesFile,
-  resolveAftPrefs,
-  seedCollapsedFromPrefs,
-  watchTuiPreferences,
 } from "./preferences";
+import { AftSidebarPanel, createSidebarPreferences, type SidebarPalette } from "./sidebar-view";
+
+// The panel itself lives in ./sidebar-view, so the newer host's entry
+// (./v2.tsx) renders exactly the same components. These re-exports keep this
+// module the import site it has always been for callers that only want the
+// formatting helpers.
+export {
+  type CompressionRow,
+  collapsedCompressionValue,
+  collapsedHealthLights,
+  degradedReasonLabel,
+  formatCompressionSidebarRows,
+  type HealthLights,
+  type HealthLightTone,
+} from "./sidebar-view";
 
-const SINGLE_BORDER = { type: "single" } as any;
 const REFRESH_DEBOUNCE_MS = 200;
 
-function formatBytes(n: number): string {
-  if (!Number.isFinite(n) || n <= 0) return "—";
-  if (n >= 1_073_741_824) return `${(n / 1_073_741_824).toFixed(1)} GB`;
-  if (n >= 1_048_576) return `${(n / 1_048_576).toFixed(1)} MB`;
-  if (n >= 1_024) return `${Math.round(n / 1_024)} KB`;
-  return `${n} B`;
-}
-
-function formatCount(n: number | null | undefined): string {
-  if (n == null || !Number.isFinite(n)) return "—";
-  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
-  if (n >= 1_000) return `${Math.round(n / 1_000)}K`;
-  return String(n);
-}
-
-/** Tagged rows for the Compression section. Each scope (Session / Project)
- * emits a "scope" header followed by two "stat" rows — Tokens Saved and
- * Compression Ratio — so the renderer can use the same StatRow layout as
- * Search Index / Semantic Index above. Pi's monospace overlay and the
- * OpenCode TUI dialog/sidebar all consume this same shape. */
-export type CompressionRow =
-  | { kind: "scope"; label: string }
-  | { kind: "stat"; label: string; value: string };
-
-function appendScope(
-  rows: CompressionRow[],
-  label: string,
-  scope: {
-    events: number;
-    original_tokens: number;
-    compressed_tokens: number;
-    savings_tokens: number;
-  },
-): void {
-  const savings = scope.savings_tokens;
-  const pct = scope.original_tokens > 0 ? Math.round((savings / scope.original_tokens) * 100) : 0;
-  rows.push({ kind: "scope", label });
-  rows.push({ kind: "stat", label: "Tokens Saved", value: savings.toLocaleString("en-US") });
-  rows.push({ kind: "stat", label: "Compression Ratio", value: `${pct}%` });
-}
-
-export function formatCompressionSidebarRows(
-  compression: StatusCompression | undefined,
-): CompressionRow[] {
-  if (!compression || compression.project.events <= 0) return [];
-
-  const rows: CompressionRow[] = [];
-  if (compression.session.events > 0) {
-    appendScope(rows, "Session", compression.session);
-  }
-  appendScope(rows, "Project", compression.project);
-
-  return rows;
-}
-
-// Map index status → (label, theme color name). The label is what we want
-// the user to see; the color encodes severity so the eye lands on warnings.
-function statusDisplay(status: string): { label: string; tone: "ok" | "warn" | "err" | "muted" } {
-  switch (status) {
-    case "ready":
-      return { label: "ready", tone: "ok" };
-    case "loading":
-    case "building":
-      return { label: status, tone: "warn" };
-    case "failed":
-    case "error":
-      return { label: status, tone: "err" };
-    case "disabled":
-      return { label: "disabled", tone: "muted" };
-    default:
-      return { label: status || "unknown", tone: "muted" };
-  }
-}
-
-const StatRow = (props: {
-  theme: TuiThemeCurrent;
-  label: string;
-  value: string;
-  tone?: "ok" | "warn" | "err" | "muted" | "accent";
-}) => {
-  const fg = createMemo(() => {
-    switch (props.tone) {
-      case "ok":
-        return props.theme.success ?? props.theme.accent;
-      case "warn":
-        return props.theme.warning;
-      case "err":
-        return props.theme.error;
-      case "muted":
-        return props.theme.textMuted;
-      case "accent":
-        return props.theme.accent;
-      default:
-        return props.theme.text;
-    }
-  });
-
-  return (
-    <box width="100%" flexDirection="row" justifyContent="space-between">
-      <text fg={props.theme.textMuted}>{props.label}</text>
-      <text fg={fg()}>
-        <b>{props.value}</b>
-      </text>
-    </box>
-  );
-};
-
-const SectionHeader = (props: { theme: TuiThemeCurrent; title: string; marginTop?: number }) => (
-  <box width="100%" marginTop={props.marginTop ?? 1}>
-    <text fg={props.theme.text}>
-      <b>{props.title}</b>
-    </text>
-  </box>
-);
-
-// Map a status tone to a theme color — used for the collapsed-view status dots.
-function toneColor(theme: TuiThemeCurrent, tone: "ok" | "warn" | "err" | "muted"): string {
-  switch (tone) {
-    case "ok":
-      return theme.success ?? theme.accent;
-    case "warn":
-      return theme.warning;
-    case "err":
-      return theme.error;
-    default:
-      return theme.textMuted;
-  }
-}
-
-// Collapsed-view row: label on the left, a status dot (or compact value) on the
-// right. Mirrors the expanded StatRow layout so the columns line up.
-const CollapsedRow = (props: { theme: TuiThemeCurrent; label: string; children: JSX.Element }) => (
-  <box width="100%" flexDirection="row" justifyContent="space-between">
-    <text fg={props.theme.textMuted}>{props.label}</text>
-    {props.children}
-  </box>
-);
-
-// Compact "saved / ratio" string for the collapsed Compression row — e.g.
-// "7.6M / 64%". Uses the local `formatCount` (not the aft-bridge token
-// formatter) so the TUI bundle doesn't pull the bridge barrel, which exports
-// URL-fetch helpers unsuitable for Bun's TUI runtime. Returns null when no
-// compression has been recorded yet.
-export function collapsedCompressionValue(
-  compression: StatusCompression | undefined,
-): string | null {
-  if (!compression || compression.project.events <= 0) return null;
-  const { savings_tokens, original_tokens } = compression.project;
-  const pct = original_tokens > 0 ? Math.round((savings_tokens / original_tokens) * 100) : 0;
-  return `${formatCount(savings_tokens)} / ${pct}%`;
-}
-
-export type HealthLightTone = "ok" | "warn" | "err" | "muted";
-
-// Degraded-mode reason → human-readable hint. Distinct strings per reason
-// because the UX direction is different: "home_root" tells the user to open a
-// real project subdirectory, "search_too_many_files" tells them the tree is too
-// big for full indexing, and "watcher_unavailable" is an honest soft
-// degradation (AFT continues without live external-change invalidation).
-export function degradedReasonLabel(reason: string): string {
-  if (reason === "home_root") {
-    return "project root is your home directory";
-  }
-  if (reason.startsWith("search_too_many_files:")) {
-    const threshold = reason.split(":")[1] ?? "20000";
-    return `project exceeds ${threshold} files`;
-  }
-  if (reason === "watcher_unavailable") {
-    return "file watcher unavailable; continuing without live external-change invalidation";
-  }
-  return reason; // unknown reason — surface verbatim so users can grep logs
-}
-
-export interface HealthLights {
-  diagnostics: HealthLightTone;
-  code: HealthLightTone;
-  todos: HealthLightTone;
-}
-
-// Missing categories are intentionally muted: a green light requires an
-// explicit zero for every category that feeds that light.
-export function collapsedHealthLights(statusBar: StatusBar | undefined): HealthLights | null {
-  if (!statusBar) return null;
-  const diagnostics: HealthLightTone =
-    statusBar.errors !== undefined && statusBar.errors > 0
-      ? "err"
-      : statusBar.warnings !== undefined && statusBar.warnings > 0
-        ? "warn"
-        : statusBar.errors === 0 && statusBar.warnings === 0
-          ? "ok"
-          : "muted";
-  const codeValues = [statusBar.dead_code, statusBar.unused_exports, statusBar.duplicates];
-  const code: HealthLightTone = codeValues.some((value) => value !== undefined && value > 0)
-    ? "warn"
-    : codeValues.every((value) => value === 0)
-      ? "ok"
-      : "muted";
-  const todos: HealthLightTone =
-    statusBar.todos === undefined ? "muted" : statusBar.todos > 0 ? "warn" : "ok";
-  return { diagnostics, code, todos };
+/**
+ * Slot-plugin theme → the panel's palette. The host this file serves publishes
+ * one flat colour per role (`theme.success`, `theme.textMuted`, ...), so the
+ * mapping is a rename; `success` keeps its historical fall back to the accent
+ * for themes that never defined it.
+ */
+export function resolveV1Palette(theme: TuiThemeCurrent): SidebarPalette {
+  return {
+    text: theme.text,
+    textMuted: theme.textMuted,
+    success: theme.success ?? theme.accent,
+    warning: theme.warning,
+    error: theme.error,
+    accent: theme.accent,
+    background: theme.background,
+    border: theme.borderActive,
+  };
 }
 
 // Keep the TUI on the bridge's shared resolver so its root matches the
@@ -350,8 +166,7 @@ const SidebarContent = (props: {
   pluginVersion: string;
 }) => {
   const [status, setStatus] = createSignal<ScopedSidebarStatus | null>(null);
-  const [prefs, setPrefs] = createSignal<AftTuiPrefs>(structuredClone(DEFAULT_PREFS));
-  const [collapsed, setCollapsed] = createSignal(seedCollapsedFromPrefs(DEFAULT_PREFS));
+  const preferences = createSidebarPreferences(() => requestRender());
   let inflight: {
     controller: AbortController;
     generation: number;
@@ -479,21 +294,7 @@ const SidebarContent = (props: {
   const statusDebouncer = createDebouncedStatusRefresh(refresh, REFRESH_DEBOUNCE_MS);
   const scheduleRefresh = () => statusDebouncer.schedule();
 
-  const reloadPrefs = async () => {
-    const root = await readTuiPreferencesFile();
-    const next = resolveAftPrefs(root);
-    setPrefs(next);
-    setCollapsed(seedCollapsedFromPrefs(next));
-    requestRender();
-  };
-
-  void reloadPrefs();
-  const unwatchPrefs = watchTuiPreferences(() => {
-    void reloadPrefs();
-  });
-
   onCleanup(() => {
-    unwatchPrefs();
     generation++;
     abortInflight();
     statusDebouncer.dispose();
@@ -531,334 +332,15 @@ const SidebarContent = (props: {
 
   const s = () => scopedSidebarSnapshot(status(), currentDirectory(), props.sessionID());
 
-  // Lazy-bridge: while AFT has no live bridge yet, the RPC server returns a
-  // synthetic snapshot with `cache_role === "not_initialized"`. In that state
-  // every metric is unknown by design — not "disabled" — so we hide the
-  // version line and the entire Search Index / Semantic Index / Compression
-  // grid until a first tool call warms the bridge. Users were reading the
-  // pre-init `vunknown` + `Status: unknown` rows as broken state instead of
-  // "AFT has not been used yet for this project".
-  const notInitialized = () => s()?.cache_role === "not_initialized";
-
-  // Pre-compute display values so the JSX stays readable. createMemo for
-  // each derived field would be overkill — these are cheap derivations.
-  const searchStatus = () => statusDisplay(s()?.search_index?.status ?? "disabled");
-  const semanticStatus = () => {
-    const rawStatus = s()?.semantic_index?.status ?? "disabled";
-    const display = statusDisplay(rawStatus);
-    return {
-      ...display,
-      label: formatSemanticIndexStatus(rawStatus, s()?.semantic_index?.stage),
-    };
-  };
-  const semanticRefreshing = () =>
-    formatSemanticRefreshing(s()?.semantic_index?.refreshing_count ?? 0);
-  const trigramBytes = () => s()?.disk?.trigram_disk_bytes ?? 0;
-  const semanticBytes = () => s()?.disk?.semantic_disk_bytes ?? 0;
-  const compressionRows = () => formatCompressionSidebarRows(s()?.compression);
-  const statusBar = () => s()?.status_bar;
-
-  const degradedSummary = () => {
-    const snap = s();
-    if (!snap?.degraded) return null;
-    const reasons = snap.degraded_reasons ?? [];
-    if (reasons.length === 0) return null;
-    return reasons.map(degradedReasonLabel).join("; ");
-  };
-
-  // Worktree borrow is a shared-index arrangement, not a degraded_reasons
-  // entry. Keep this muted and separate from the DEGRADED badge above.
-  const worktreeNote = () => worktreeCacheRoleNote(s()?.cache_role);
-
   return (
-    <box
-      width="100%"
-      flexDirection="column"
-      border={SINGLE_BORDER}
-      borderColor={props.theme.borderActive}
-      paddingTop={1}
-      paddingBottom={1}
-      paddingLeft={1}
-      paddingRight={1}
-    >
-      {/* Header: triangle toggle + AFT badge + binary version + degraded badge.
-          Clicking the header row collapses/expands the panel (mirrors OpenCode's
-          native MCP sidebar section). Only interactive once initialized — the
-          lazy-bridge placeholder has nothing to collapse. */}
-      <box
-        flexDirection="row"
-        justifyContent="space-between"
-        alignItems="center"
-        onMouseDown={() => {
-          if (notInitialized()) return;
-          setCollapsed((x) => {
-            const next = !x;
-            persistCollapsedIfEnabled(prefs(), next);
-            return next;
-          });
-        }}
-      >
-        <box flexDirection="row" alignItems="center">
-          {/* Triangle lives inside the accent badge so the toggle reads as one
-              unit: "▶ AFT" / "▼ AFT". Hidden pre-init (nothing to collapse). */}
-          <box paddingLeft={1} paddingRight={1} backgroundColor={props.theme.accent}>
-            <text fg={badgeTextColor(props.theme.accent, props.theme.background)}>
-              <b>
-                {notInitialized() ? "" : collapsed() ? "▶ " : "▼ "}
-                {prefs().header.label}
-              </b>
-            </text>
-          </box>
-          {s()?.degraded && (
-            <box
-              paddingLeft={1}
-              paddingRight={1}
-              marginLeft={1}
-              backgroundColor={props.theme.warning}
-            >
-              <text fg={badgeTextColor(props.theme.warning, props.theme.background)}>
-                <b>DEGRADED</b>
-              </text>
-            </box>
-          )}
-        </box>
-        {!notInitialized() && prefs().header.showVersion && (
-          <text fg={props.theme.textMuted}>v{s()?.version ?? props.pluginVersion}</text>
-        )}
-      </box>
-
-      {/* Degraded reason — explains why heavy tools (aft_search, aft_callgraph)
-          are disabled. Surface this prominently so users know to open a real
-          project subdirectory if they want full features. */}
-      {s()?.degraded && degradedSummary() && (
-        <box marginTop={1} width="100%">
-          <text fg={props.theme.warning}>⚠ {degradedSummary()}</text>
-        </box>
-      )}
-
-      {!notInitialized() && worktreeNote() && (
-        <box marginTop={1} width="100%">
-          <text fg={props.theme.textMuted}>{worktreeNote()}</text>
-        </box>
-      )}
-
-      {/* Lazy-bridge placeholder. AFT skips spawning the `aft` binary at
-          plugin init to keep memory/CPU low on OpenCode Desktop sessions
-          that have many projects pinned in the sidebar. The RPC server
-          returns a synthetic `cache_role === "not_initialized"` snapshot
-          until the first tool call routes through `callBridge()` and warms
-          the bridge. Show the explanatory message instead of empty status
-          rows so users understand why metrics are blank. */}
-      {notInitialized() && (
-        <box marginTop={1} width="100%">
-          <text fg={props.theme.textMuted}>
-            {s()!.message ||
-              "AFT bridge is now spawned lazily, information here will be populated after first tool call."}
-          </text>
-        </box>
-      )}
-
-      {/* Collapsed view — condensed status dots + compact compression. Shown
-          only when initialized AND collapsed. Three rows mirroring the section
-          order of the expanded grid. */}
-      {!notInitialized() && collapsed() && (
-        <box width="100%" flexDirection="column">
-          {prefs().sections.searchIndex && (
-            <CollapsedRow theme={props.theme} label="Search Index">
-              <text fg={toneColor(props.theme, searchStatus().tone)}>●</text>
-            </CollapsedRow>
-          )}
-          {prefs().sections.semanticIndex && (
-            <CollapsedRow theme={props.theme} label="Semantic Index">
-              <text fg={toneColor(props.theme, semanticStatus().tone)}>●</text>
-            </CollapsedRow>
-          )}
-          {prefs().sections.codeHealth && collapsedHealthLights(statusBar()) && (
-            <CollapsedRow theme={props.theme} label="Code Health">
-              <box flexDirection="row" gap={1}>
-                <text fg={toneColor(props.theme, collapsedHealthLights(statusBar())!.diagnostics)}>
-                  ●
-                </text>
-                <text fg={toneColor(props.theme, collapsedHealthLights(statusBar())!.code)}>●</text>
-                <text fg={toneColor(props.theme, collapsedHealthLights(statusBar())!.todos)}>
-                  ●
-                </text>
-              </box>
-            </CollapsedRow>
-          )}
-          {prefs().sections.compression && collapsedCompressionValue(s()?.compression) && (
-            <CollapsedRow theme={props.theme} label="Compression">
-              <text fg={props.theme.textMuted}>
-                <b>{collapsedCompressionValue(s()?.compression)}</b>
-              </text>
-            </CollapsedRow>
-          )}
-        </box>
-      )}
-
-      {/* Search index */}
-      {!notInitialized() && !collapsed() && (
-        <>
-          {prefs().sections.searchIndex && (
-            <>
-              <SectionHeader theme={props.theme} title="Search Index" />
-              <StatRow
-                theme={props.theme}
-                label="Status"
-                value={searchStatus().label}
-                tone={searchStatus().tone}
-              />
-              {(s()?.search_index?.files ?? null) != null && (
-                <StatRow
-                  theme={props.theme}
-                  label="Files"
-                  value={formatCount(s()!.search_index.files)}
-                  tone="muted"
-                />
-              )}
-              <StatRow
-                theme={props.theme}
-                label="Disk"
-                value={formatBytes(trigramBytes())}
-                tone="muted"
-              />
-            </>
-          )}
-
-          {prefs().sections.semanticIndex && (
-            <>
-              <SectionHeader theme={props.theme} title="Semantic Index" />
-              <StatRow
-                theme={props.theme}
-                label="Status"
-                value={semanticStatus().label}
-                tone={semanticStatus().tone}
-              />
-              {semanticRefreshing() && (
-                <box width="100%">
-                  <text fg={props.theme.textMuted}>{semanticRefreshing()}</text>
-                </box>
-              )}
-              {/* When loading, magic-context-style progress hint helps users see
-          background work is making progress instead of stuck. */}
-              {s()?.semantic_index?.status === "loading" &&
-                s()?.semantic_index?.entries_total != null &&
-                s()!.semantic_index.entries_total! > 0 && (
-                  <StatRow
-                    theme={props.theme}
-                    label="Progress"
-                    value={`${formatCount(s()!.semantic_index.entries_done)} / ${formatCount(
-                      s()!.semantic_index.entries_total,
-                    )}`}
-                    tone="warn"
-                  />
-                )}
-              {(s()?.semantic_index?.entries ?? null) != null && (
-                <StatRow
-                  theme={props.theme}
-                  label="Entries"
-                  value={formatCount(s()!.semantic_index.entries)}
-                  tone="muted"
-                />
-              )}
-              <StatRow
-                theme={props.theme}
-                label="Disk"
-                value={formatBytes(semanticBytes())}
-                tone="muted"
-              />
-            </>
-          )}
-
-          {/* Human health values are optional. A category stays absent until the
-          server proves it, rather than appearing as a clean zero. */}
-          {prefs().sections.codeHealth && statusBar() && (
-            <>
-              <SectionHeader
-                theme={props.theme}
-                title={statusBar()!.tier2_stale ? "Code Health ~" : "Code Health"}
-              />
-              {statusBar()!.errors !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="Errors"
-                  value={formatCount(statusBar()!.errors)}
-                  tone={statusBar()!.errors! > 0 ? "err" : "muted"}
-                />
-              )}
-              {statusBar()!.warnings !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="Warnings"
-                  value={formatCount(statusBar()!.warnings)}
-                  tone={statusBar()!.warnings! > 0 ? "warn" : "muted"}
-                />
-              )}
-              {statusBar()!.dead_code !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="Dead Code"
-                  value={formatCount(statusBar()!.dead_code)}
-                  tone="muted"
-                />
-              )}
-              {statusBar()!.unused_exports !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="Unused Exports"
-                  value={formatCount(statusBar()!.unused_exports)}
-                  tone="muted"
-                />
-              )}
-              {statusBar()!.duplicates !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="Duplicates"
-                  value={formatCount(statusBar()!.duplicates)}
-                  tone="muted"
-                />
-              )}
-              {statusBar()!.todos !== undefined && (
-                <StatRow
-                  theme={props.theme}
-                  label="TODOs"
-                  value={formatCount(statusBar()!.todos)}
-                  tone="muted"
-                />
-              )}
-            </>
-          )}
-
-          {/* Compression aggregates. Tabular layout matching Search/Semantic
-          Index above: each scope ("Session", "Project") renders as a
-          subheader followed by two StatRows (Tokens Saved, Compression
-          Ratio). Keeps numbers right-aligned in the value column instead
-          of jamming them after the label on the same line. */}
-          {prefs().sections.compression && compressionRows().length > 0 && (
-            <>
-              <SectionHeader theme={props.theme} title="Compression" />
-              {compressionRows().map((row) =>
-                row.kind === "scope" ? (
-                  <box width="100%">
-                    <text fg={props.theme.text}>{row.label}</text>
-                  </box>
-                ) : (
-                  <StatRow theme={props.theme} label={row.label} value={row.value} tone="muted" />
-                ),
-              )}
-            </>
-          )}
-
-          {/* Surface failures clearly so users know to act (install ONNX,
-          fix config, etc.) rather than silently leaving the panel "off". */}
-          {s()?.semantic_index?.status === "failed" && s()?.semantic_index?.error && (
-            <box marginTop={1} width="100%">
-              <text fg={props.theme.error}>⚠ {s()!.semantic_index.error}</text>
-            </box>
-          )}
-        </>
-      )}
-    </box>
+    <AftSidebarPanel
+      palette={resolveV1Palette(props.theme)}
+      snapshot={s()}
+      prefs={preferences.prefs()}
+      collapsed={preferences.collapsed()}
+      onToggleCollapsed={preferences.toggleCollapsed}
+      pluginVersion={props.pluginVersion}
+    />
   );
 };
 

package/src/tui/v2-status.ts

@@ -22,7 +22,6 @@ export type AftSidebarSummary = {
   semantic: string;
   health: string;
 };
-
 function healthSummary(bar: StatusBar | undefined): string {
   if (!bar) return "health pending";
   const stale = bar.tier2_stale ? "~" : "";
@@ -33,6 +32,14 @@ function healthSummary(bar: StatusBar | undefined): string {
   );
 }
 
+/**
+ * A one-line-per-field digest of the status snapshot.
+ *
+ * This is no longer what the sidebar draws: the sidebar now renders the shared
+ * panel in ./sidebar-view, which labels each section and reuses the status
+ * wording ./sidebar.tsx established. The digest is still pinned by
+ * test/tui/v2-status.test.ts.
+ */
 export function summarizeAftSidebar(status: AftStatusSnapshot | null): AftSidebarSummary {
   if (!status || status.cache_role === "not_initialized") {
     return {