@pellux/goodvibes-tui 0.28.0 → 1.0.0

package/src/renderer/file-tree.ts

@@ -1,153 +0,0 @@
-import { type Line, createStyledCell } from '../types/grid.ts';
-import { UIFactory } from './ui-factory.ts';
-import { getDisplayWidth } from '../utils/terminal-width.ts';
-
-/** Color by file extension category. */
-function getFileColor(name: string): string {
-  if (name.endsWith('/')) return '#00ffff'; // directory
-  const ext = name.split('.').pop()?.toLowerCase() ?? '';
-  if (['ts', 'tsx', 'js', 'jsx', 'mjs'].includes(ext)) return '#dcdcaa';
-  if (['json', 'yaml', 'yml', 'toml'].includes(ext)) return '#ce9178';
-  if (['md', 'txt', 'rst'].includes(ext)) return '252';
-  if (['sh', 'bash', 'zsh'].includes(ext)) return '#22c55e';
-  if (['css', 'scss', 'less'].includes(ext)) return '#569cd6';
-  if (['html', 'htm', 'xml', 'svg'].includes(ext)) return '#f97316';
-  if (['png', 'jpg', 'jpeg', 'gif', 'webp', 'ico'].includes(ext)) return '#a855f7';
-  if (['lock', 'env', 'gitignore'].includes(name)) return '238';
-  return '252';
-}
-
-export interface FileTreeEntry {
-  name: string;
-  isDir: boolean;
-  size?: number;
-  depth: number;
-  isLast: boolean;
-  isLastAtDepth: boolean[]; // tracks if each ancestor was last child
-}
-
-/**
- * renderFileTree - Render a directory listing as a tree with colored file types.
- * Returns Line[] for the cell-based pipeline.
- */
-export function renderFileTree(
-  entries: FileTreeEntry[],
-  width: number,
-  title?: string
-): Line[] {
-  const lines: Line[] = [];
-
-  // Optional header
-  if (title) {
-    lines.push(UIFactory.stringToLine(` [dir] ${title}`, width, { fg: '#00ffff', bold: true }));
-    lines.push(UIFactory.stringToLine(' ' + '-'.repeat(width - 2), width, { fg: '240' }));
-  }
-
-  for (const entry of entries) {
-    const { name, isDir, size, depth, isLast, isLastAtDepth } = entry;
-
-    // Build tree prefix
-    let prefix = '';
-    for (let d = 0; d < depth; d++) {
-      if (d < depth - 1) {
-        prefix += isLastAtDepth[d] ? '   ' : '|  ';
-      }
-    }
-    if (depth > 0) {
-      prefix += isLast ? '`-- ' : '|-- ';
-    } else {
-      prefix += '';
-    }
-
-    const displayName = isDir ? name + '/' : name;
-    const fg = getFileColor(isDir ? displayName : name);
-
-    // Size info (dimmed)
-    let sizeStr = '';
-    if (size !== undefined && !isDir) {
-      if (size < 1024) sizeStr = ` ${size}B`;
-      else if (size < 1024 * 1024) sizeStr = ` ${(size / 1024).toFixed(1)}K`;
-      else sizeStr = ` ${(size / (1024 * 1024)).toFixed(1)}M`;
-    }
-
-    const fullText = prefix + displayName;
-    const sizeW = getDisplayWidth(sizeStr);
-    const nameW = getDisplayWidth(fullText);
-    const maxNameW = width - sizeW - 1;
-
-    const truncated = nameW > maxNameW ? fullText.slice(0, Math.max(0, maxNameW - 3)) + '...' : fullText;
-
-    // Compose: name + padding + size
-    const paddingW = Math.max(0, width - getDisplayWidth(truncated) - sizeW);
-    const fullLine = truncated + ' '.repeat(paddingW);
-
-    // Build the line with per-character styles
-    const line = UIFactory.stringToLine(fullLine, width, { fg });
-
-    // Dim the size info
-    if (sizeStr && sizeW > 0) {
-      const sizeStartX = width - sizeW;
-      let cx = sizeStartX;
-      for (const ch of sizeStr) {
-        if (cx >= width) break;
-        const cw = getDisplayWidth(ch);
-        line[cx] = createStyledCell(ch, { fg: '240', dim: true });
-        if (cw === 2 && cx + 1 < width) line[cx + 1] = { ...line[cx], char: '' };
-        cx += cw;
-      }
-    }
-
-    lines.push(line);
-  }
-
-  return lines;
-}
-
-/**
- * parseListDirOutput - Convert a simple list directory output string to FileTreeEntry[].
- * Expects one path per line, relative paths with '/' for directories.
- */
-export function parseListDirOutput(output: string, rootDir: string): FileTreeEntry[] {
-  const rawLines = output.trim().split('\n').filter(Boolean);
-  const entries: FileTreeEntry[] = [];
-
-  for (const line of rawLines) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const isDir = trimmed.endsWith('/');
-    const name = isDir ? trimmed.slice(0, -1).split('/').pop() + '/' : trimmed.split('/').pop() ?? trimmed;
-    const depth = (trimmed.match(/\//g) ?? []).length - (isDir ? 1 : 0);
-
-    entries.push({
-      name: name || trimmed,
-      isDir,
-      depth: Math.max(0, depth),
-      isLast: false,
-      isLastAtDepth: [],
-    });
-  }
-
-  // Mark isLast for each entry (last sibling at same depth under same parent)
-  for (let i = 0; i < entries.length; i++) {
-    const nextSameOrLower = entries.slice(i + 1).findIndex(
-      e => e.depth <= entries[i].depth
-    );
-    entries[i].isLast = nextSameOrLower === 0 || nextSameOrLower === -1;
-
-    // Build isLastAtDepth[d] = true if the ancestor at depth d was the last child
-    // of its parent. This governs whether to draw '|  ' or '   ' vertical bars.
-    const isLastAtDepth: boolean[] = new Array(entries[i].depth).fill(false);
-    for (let d = 0; d < entries[i].depth; d++) {
-      // Walk backwards to find the most recent ancestor at depth d
-      for (let j = i - 1; j >= 0; j--) {
-        if (entries[j].depth === d) {
-          isLastAtDepth[d] = entries[j].isLast;
-          break;
-        }
-      }
-    }
-    entries[i].isLastAtDepth = isLastAtDepth;
-  }
-
-  return entries;
-}

package/src/renderer/progress.ts

@@ -1,99 +0,0 @@
-import { type Line } from '../types/grid.ts';
-import { UIFactory } from './ui-factory.ts';
-import { getDisplayWidth, padDisplayEnd } from '../utils/terminal-width.ts';
-import { abbreviateCount } from '../utils/format-number.ts';
-
-// Rich spinner frames (used by progress indicators)
-export const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-// Braille thinking spinner frames (used by the orchestrator thinking animation)
-export const THINKING_SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-
-/**
- * renderSpinner - Render a spinner with label as a single Line.
- */
-export function renderSpinner(
-  frame: string,
-  label: string,
-  width: number,
-  fg: string = '135'
-): Line {
-  const text = ` ${frame} ${label}`;
-  return UIFactory.stringToLine(padDisplayEnd(text, width), width, { fg, bold: true });
-}
-
-/**
- * renderToolProgress - Render tool execution progress.
- * E.g. "[2/5] Editing src/config.ts..."
- */
-export function renderToolProgress(
-  current: number,
-  total: number,
-  label: string,
-  width: number
-): Line[] {
-  const counter = `[${current}/${total}]`;
-  const text = ` ${counter} ${label}`;
-  return [
-    UIFactory.stringToLine(padDisplayEnd(text, width), width, { fg: '#ffcc00', bold: true }),
-  ];
-}
-
-/**
- * renderTokenBar - Render a token usage bar for the footer.
- * Shows used/max tokens as a visual bar + numbers.
- */
-export function renderTokenBar(
-  used: number,
-  max: number,
-  width: number,
-  model: string,
-  toolCount: number
-): Line[] {
-  const lines: Line[] = [];
-
-  // Stats row
-  const usedK = abbreviateCount(used, { noM: true });
-  const maxK = abbreviateCount(max, { noM: true });
-  const pct = max > 0 ? Math.min(100, Math.round((used / max) * 100)) : 0;
-  const toolStr = toolCount > 0 ? `  tools:${toolCount}` : '';
-  const statsText = ` ${model}  in:${usedK}/${maxK} (${pct}%)${toolStr}`;
-
-  // Progress bar
-  const barLabel = ' ctx ';
-  const barLabelW = getDisplayWidth(barLabel);
-  const barW = Math.max(10, Math.floor(width * 0.3));
-  const filled = Math.round((pct / 100) * barW);
-  const empty = barW - filled;
-
-  // Color based on usage
-  const barFg = pct > 85 ? '#ef4444' : pct > 60 ? '#ffcc00' : '#22c55e';
-
-  const bar = '#'.repeat(filled) + '-'.repeat(empty);
-  const barText = barLabel + bar;
-
-  const statsW = getDisplayWidth(statsText);
-  const barTextW = getDisplayWidth(barText);
-  const spacingW = Math.max(1, width - statsW - barTextW - 2);
-
-  // Build with mixed colors
-  const line = UIFactory.stringToLine(statsText + ' '.repeat(spacingW), width, { fg: '244', dim: true });
-
-  // Overlay the bar with color
-  let barStartX = getDisplayWidth(statsText) + spacingW;
-  for (const ch of barLabel) {
-    if (barStartX >= width) break;
-    const cw = getDisplayWidth(ch);
-    line[barStartX] = { char: ch, fg: '244', bg: '', bold: false, dim: true, underline: false, italic: false, strikethrough: false };
-    if (cw === 2 && barStartX + 1 < width) line[barStartX + 1] = { ...line[barStartX], char: '' };
-    barStartX += cw;
-  }
-  for (let i = 0; i < filled && barStartX + i < width; i++) {
-    line[barStartX + i] = { char: '#', fg: barFg, bg: '', bold: false, dim: false, underline: false, italic: false, strikethrough: false };
-  }
-  for (let i = 0; i < empty && barStartX + filled + i < width; i++) {
-    line[barStartX + filled + i] = { char: '-', fg: '238', bg: '', bold: false, dim: true, underline: false, italic: false, strikethrough: false };
-  }
-
-  lines.push(line);
-  return lines;
-}

package/src/renderer/status-token.ts

@@ -1,67 +0,0 @@
-// ---------------------------------------------------------------------------
-// buildStatusToken — always glyph + color, never color-only.
-//
-// Maps a semantic state to a Unicode glyph AND a palette color so that
-// colorblind users and screen readers can distinguish states without color.
-//
-// Glyphs:
-//   good  ✓  (CHECK MARK)
-//   warn  ⚠  (WARNING SIGN)
-//   bad   ✕  (MULTIPLICATION X)
-//   info  ○  (WHITE CIRCLE)
-// ---------------------------------------------------------------------------
-
-import type { Cell } from '../types/grid.ts';
-import { DEFAULT_PANEL_PALETTE } from '../panels/polish.ts';
-import { type StatusState, STATE_GLYPHS } from './status-glyphs.ts';
-
-// Re-export for downstream consumers that import from this module.
-export type { StatusState } from './status-glyphs.ts';
-export { STATE_GLYPHS } from './status-glyphs.ts';
-
-const STATE_COLORS: Record<StatusState, string> = {
-  good: DEFAULT_PANEL_PALETTE.good,
-  warn: DEFAULT_PANEL_PALETTE.warn,
-  bad:  DEFAULT_PANEL_PALETTE.bad,
-  info: DEFAULT_PANEL_PALETTE.info,
-};
-
-export interface StatusTokenOpts {
-  /** Append a numeric count after the label, e.g. "label (3)". */
-  count?: number;
-  /** Override the default glyph for this state. */
-  glyph?: string;
-}
-
-/**
- * Build a small sequence of styled cells: [glyph, space, label, optional count]
- *
- * Always prepends the glyph so colorblind users can parse the state.
- * The color is applied to both glyph and label as a redundant cue.
- *
- * @param state   Semantic state — controls default glyph and color.
- * @param label   Human-readable label string.
- * @param opts    Optional count suffix or glyph override.
- * @returns       Array of Cell objects ready to embed in a Line.
- */
-export function buildStatusToken(
-  state: StatusState,
-  label: string,
-  opts?: StatusTokenOpts,
-): Cell[] {
-  const glyph = opts?.glyph ?? STATE_GLYPHS[state];
-  const color = STATE_COLORS[state];
-  const suffix = opts?.count !== undefined ? ` (${opts.count})` : '';
-  const text = `${glyph} ${label}${suffix}`;
-
-  return text.split('').map((char): Cell => ({
-    char,
-    fg: color,
-    bg: '',
-    bold: false,
-    dim: false,
-    underline: false,
-    italic: false,
-    strikethrough: false,
-  }));
-}

package/src/runtime/diagnostics/panels/panel-resources.ts

@@ -1,118 +0,0 @@
-/**
- * Panel resource diagnostics panel data provider.
- *
- * Polls the shared TUI-owned ComponentHealthMonitor and produces PanelResourceSnapshot
- * values for the diagnostics panel to render.
- */
-import type { ComponentHealthMonitor } from '../../perf/panel-health-monitor.ts';
-import type {
-  ComponentResourceEntry,
-  ComponentResourceSnapshot,
-} from '@/runtime/index.ts';
-
-const DEFAULT_POLL_INTERVAL_MS = 500;
-
-const HEALTH_ORDER: Record<string, number> = {
-  overloaded: 0,
-  warning: 1,
-  healthy: 2,
-};
-
-export class PanelResourcesPanel {
-  private readonly _pollIntervalMs: number;
-  private readonly _monitor: ComponentHealthMonitor;
-  private _current: ComponentResourceSnapshot;
-  private _timerId: ReturnType<typeof setInterval> | null = null;
-  private readonly _subscribers = new Set<() => void>();
-
-  constructor(monitor: ComponentHealthMonitor, pollIntervalMs: number = DEFAULT_POLL_INTERVAL_MS) {
-    this._monitor = monitor;
-    this._pollIntervalMs = pollIntervalMs;
-    this._current = this._buildSnapshot(Date.now());
-  }
-
-  start(): void {
-    if (this._timerId !== null) return;
-    this._timerId = setInterval(() => {
-      this._current = this._buildSnapshot(Date.now());
-      this._notify();
-    }, this._pollIntervalMs);
-  }
-
-  stop(): void {
-    if (this._timerId !== null) {
-      clearInterval(this._timerId);
-      this._timerId = null;
-    }
-  }
-
-  getSnapshot(): ComponentResourceSnapshot {
-    return this._current;
-  }
-
-  refresh(now: number = Date.now()): ComponentResourceSnapshot {
-    this._current = this._buildSnapshot(now);
-    return this._current;
-  }
-
-  subscribe(callback: () => void): () => void {
-    this._subscribers.add(callback);
-    return () => this._subscribers.delete(callback);
-  }
-
-  dispose(): void {
-    this.stop();
-    this._subscribers.clear();
-  }
-
-  private _buildSnapshot(capturedAt: number): ComponentResourceSnapshot {
-    const healthStates = this._monitor.getAllHealth();
-
-    const panels: ComponentResourceEntry[] = healthStates.map((health) => {
-      const contract = this._monitor.getContract(health.componentId);
-      return {
-        componentId: health.componentId,
-        throttleStatus: health.throttleStatus,
-        healthStatus: health.healthStatus,
-        renderP95Ms: health.renderP95Ms,
-        maxRenderMs: contract?.maxRenderMs ?? 0,
-        rendersInWindow: health.rendersInWindow,
-        maxUpdatesPerSecond: contract?.maxUpdatesPerSecond ?? 0,
-        consecutiveViolations: health.consecutiveViolations,
-        totalSuppressed: health.totalSuppressed,
-        totalPermitted: health.totalPermitted,
-        lastRenderAt: health.lastRenderAt,
-        nextAllowedAt: health.nextAllowedAt,
-      };
-    });
-
-    panels.sort((left, right) => {
-      const diff = (HEALTH_ORDER[left.healthStatus] ?? 2) - (HEALTH_ORDER[right.healthStatus] ?? 2);
-      return diff !== 0 ? diff : left.componentId.localeCompare(right.componentId);
-    });
-
-    const overloadedCount = panels.filter((panel) => panel.healthStatus === 'overloaded').length;
-    const warningCount = panels.filter((panel) => panel.healthStatus === 'warning').length;
-    const healthyCount = panels.filter((panel) => panel.healthStatus === 'healthy').length;
-    const totalSuppressed = panels.reduce((sum, panel) => sum + panel.totalSuppressed, 0);
-
-    return {
-      panels,
-      overloadedCount,
-      warningCount,
-      healthyCount,
-      totalSuppressed,
-      capturedAt,
-    };
-  }
-
-  private _notify(): void {
-    for (const callback of this._subscribers) {
-      try {
-        callback();
-      } catch {
-        // Subscriber failures must not take down diagnostics polling.
-      }
-    }
-  }
-}

package/src/runtime/diagnostics/panels/policy.ts

@@ -1,177 +0,0 @@
-/**
- * Policy diagnostics panel data provider.
- *
- * Wraps a `PolicyRegistry` and optionally a `DivergencePanel` to expose
- * combined policy state (current bundle, candidate, simulation status,
- * divergence trends) for the diagnostics view.
- *
- * This panel is push-passive: it does not drive timers. Callers must
- * call `recordTrendEntry()` periodically if a divergence panel is attached.
- */
-
-import type { PolicyBundleVersion, PolicyDiffResult } from '@/runtime/index.ts';
-import { PolicyRegistry } from '@/runtime/index.ts';
-import type { DivergenceDashboardSnapshot } from '@/runtime/index.ts';
-import type { DivergencePanel } from '@/runtime/index.ts';
-import type { PanelConfig } from '@/runtime/index.ts';
-import { DEFAULT_PANEL_CONFIG } from '@/runtime/index.ts';
-import type { PermissionAuditEntry } from '@/runtime/index.ts';
-import type { PolicyLintFinding } from '@/runtime/index.ts';
-import type { PolicySimulationSummary } from '@/runtime/index.ts';
-import type { PolicyPreflightReview } from '@/runtime/index.ts';
-import { logger } from '@pellux/goodvibes-sdk/platform/utils';
-
-/**
- * A point-in-time snapshot of policy state for diagnostics rendering.
- */
-export interface PolicyPanelSnapshot {
-  /** The currently enforced bundle, or null if no policy is active. */
-  current: PolicyBundleVersion | null;
-  /** The pending candidate bundle, or null if none loaded. */
-  candidate: PolicyBundleVersion | null;
-  /** History of previous active bundles (most recent first). */
-  history: PolicyBundleVersion[];
-  /** Diff between current and candidate, or null if unavailable. */
-  diff: PolicyDiffResult | null;
-  /** Divergence dashboard snapshot, or null if no panel attached. */
-  divergence: DivergenceDashboardSnapshot | null;
-  /** Recent permission requests and decisions for operator audit review. */
-  recentPermissionAudit: readonly PermissionAuditEntry[];
-  /** Policy lint findings for current and candidate bundles. */
-  lintFindings: readonly PolicyLintFinding[];
-  /** Concrete scenario results from the most recent policy simulation run. */
-  lastSimulationSummary: PolicySimulationSummary | null;
-  /** Most recent proactive policy preflight review. */
-  lastPreflightReview: PolicyPreflightReview | null;
-  /** ISO 8601 timestamp of when this snapshot was captured. */
-  capturedAt: string;
-}
-
-/**
- * PolicyPanel — diagnostics data provider for the policy registry.
- *
- * Usage:
- * ```ts
- * const registry = new PolicyRegistry();
- * const panel = new PolicyPanel(registry, divergencePanel);
- *
- * panel.subscribe(() => {
- *   const snap = panel.getSnapshot();
- *   render(snap);
- * });
- *
- * // Notify when the registry state changes:
- * panel.notify();
- *
- * // On cleanup:
- * panel.dispose();
- * ```
- */
-export class PolicyPanel {
-  private readonly _registry: PolicyRegistry;
-  private readonly _divergencePanel: DivergencePanel | null;
-  private readonly _config: PanelConfig;
-  private readonly _recentPermissionAudit: readonly PermissionAuditEntry[];
-  private readonly _lintFindings: readonly PolicyLintFinding[];
-  private readonly _lastSimulationSummary: PolicySimulationSummary | null;
-  private readonly _lastPreflightReview: PolicyPreflightReview | null;
-  private readonly _subscribers = new Set<() => void>();
-
-  constructor(
-    registry: PolicyRegistry,
-    divergencePanel: DivergencePanel | null = null,
-    recentPermissionAudit: readonly PermissionAuditEntry[] = [],
-    lintFindings: readonly PolicyLintFinding[] = [],
-    lastSimulationSummary: PolicySimulationSummary | null = null,
-    lastPreflightReview: PolicyPreflightReview | null = null,
-    config: PanelConfig = DEFAULT_PANEL_CONFIG,
-  ) {
-    this._registry = registry;
-    this._divergencePanel = divergencePanel;
-    this._recentPermissionAudit = recentPermissionAudit;
-    this._lintFindings = lintFindings;
-    this._lastSimulationSummary = lastSimulationSummary;
-    this._lastPreflightReview = lastPreflightReview;
-    this._config = config;
-  }
-
-  /**
-   * recordTrendEntry — Forwards to the attached DivergencePanel if present.
-   *
-   * Call periodically (e.g. every 30 seconds) while simulation is active.
-   */
-  public recordTrendEntry(): void {
-    this._divergencePanel?.recordTrendEntry();
-    this._notify();
-  }
-
-  /**
-   * notify — Trigger a subscriber notification.
-   *
-   * Call after registry state changes (load, promote, rollback) so the
-   * diagnostics view can re-render.
-   */
-  public notify(): void {
-    this._notify();
-  }
-
-  /**
-   * getSnapshot — Returns the current combined policy + divergence snapshot.
-   */
-  public getSnapshot(): PolicyPanelSnapshot {
-    const current = this._registry.getCurrent();
-    const candidate = this._registry.getCandidate();
-    const rawHistory = this._registry.getHistory();
-    // Most recent first, capped for display
-    const history = rawHistory
-      .slice()
-      .reverse()
-      .slice(0, this._config.bufferLimit);
-
-    const diff = this._registry.diff();
-
-    let divergence: DivergenceDashboardSnapshot | null = null;
-    if (this._divergencePanel) {
-      divergence = this._divergencePanel.getSnapshot();
-    }
-
-    return {
-      current,
-      candidate,
-      history,
-      diff,
-      divergence,
-      recentPermissionAudit: this._recentPermissionAudit.slice(0, this._config.bufferLimit),
-      lintFindings: this._lintFindings.slice(0, this._config.bufferLimit),
-      lastSimulationSummary: this._lastSimulationSummary,
-      lastPreflightReview: this._lastPreflightReview,
-      capturedAt: new Date().toISOString(),
-    };
-  }
-
-  /**
-   * Register a callback invoked whenever the panel state changes.
-   * @returns An unsubscribe function.
-   */
-  public subscribe(callback: () => void): () => void {
-    this._subscribers.add(callback);
-    return () => this._subscribers.delete(callback);
-  }
-
-  /**
-   * Release all subscriptions.
-   */
-  public dispose(): void {
-    this._subscribers.clear();
-  }
-
-  private _notify(): void {
-    for (const cb of this._subscribers) {
-      try {
-        cb();
-      } catch (err) {
-        logger.warn(`[PolicyPanel] subscriber error: ${err}`);
-      }
-    }
-  }
-}