@pellux/goodvibes-agent 0.1.0

package/src/panels/forensics-panel.ts

@@ -0,0 +1,364 @@
+/**
+ * ForensicsPanel — failure forensics TUI panel.
+ *
+ * Displays the most recent failure reports with auto-classified causes,
+ * causal chains, phase timings, and jump links to related panels.
+ *
+ * Open via /forensics or the panel picker.
+ */
+import type { Line } from '../types/grid.ts';
+import type { ForensicsRegistry } from '@/runtime/index.ts';
+import type { FailureReport, CausalChainEntry, PhaseTimingEntry } from '@/runtime/index.ts';
+import { ForensicsDataPanel } from '@/runtime/index.ts';
+import { BasePanel } from './base-panel.ts';
+import { createEmptyLine } from '../types/grid.ts';
+import {
+  buildEmptyState,
+  buildPanelLine,
+  buildPanelWorkspace,
+  resolveScrollablePanelSection,
+  DEFAULT_PANEL_PALETTE,
+  type PanelWorkspaceSection,
+} from './polish.ts';
+
+// ── Colour palette ────────────────────────────────────────────────────────────
+const C = {
+  ...DEFAULT_PANEL_PALETTE,
+  header:          '#94a3b8',
+  headerBg:        '#1e293b',
+  reportId:        '#475569',
+  timestamp:       '#64748b',
+  classification:  '#f97316',
+  classOk:         '#22c55e',
+  classCancelled:  '#94a3b8',
+  classError:      '#ef4444',
+  classWarn:       '#eab308',
+  summaryText:     '#cbd5e1',
+  label:           '#64748b',
+  value:           '#e2e8f0',
+  chainRoot:       '#f97316',
+  chainEntry:      '#94a3b8',
+  phaseOk:         '#22c55e',
+  phaseFail:       '#ef4444',
+  phasePending:    '#64748b',
+  jumpLink:        '#38bdf8',
+  separator:       '#1e293b',
+  dim:             '#334155',
+  empty:           '#4b5563',
+  selectBg:        '#1e3a5f',
+} as const;
+
+// ── Helpers ────────────────────────────────────────────────────────────────────
+
+function fmtTime(ts: number): string {
+  const d = new Date(ts);
+  const hh = String(d.getHours()).padStart(2, '0');
+  const mm = String(d.getMinutes()).padStart(2, '0');
+  const ss = String(d.getSeconds()).padStart(2, '0');
+  return `${hh}:${mm}:${ss}`;
+}
+
+function fmtDuration(ms: number | undefined): string {
+  if (ms === undefined) return '?ms';
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+
+function classificationColor(cls: FailureReport['classification']): string {
+  switch (cls) {
+    case 'cancelled':        return C.classCancelled;
+    case 'max_tokens':       return C.classWarn;
+    case 'unknown':          return C.classWarn;
+    case 'llm_error':        return C.classError;
+    case 'tool_failure':     return C.classError;
+    case 'permission_denied':return C.classError;
+    case 'cascade_failure':  return C.classError;
+    case 'turn_timeout':     return C.classError;
+    case 'compaction_error': return C.classError;
+    default:                 return C.classification;
+  }
+}
+
+// ── ForensicsPanel ────────────────────────────────────────────────────────────
+
+export class ForensicsPanel extends BasePanel {
+  private readonly _data: ForensicsDataPanel;
+  private _unsub: (() => void) | null = null;
+  // eslint-disable-next-line @typescript-eslint/prefer-readonly -- mutated in _renderDetail via direct assignment
+  private _scrollOffset = 0;
+  /** Index of the selected report in the all-reports list (newest-first). */
+  private _selectedIndex = 0;
+  /** View mode: 'list' shows report list; 'detail' shows a single report expanded. */
+  private _mode: 'list' | 'detail' = 'list';
+
+  public constructor(registry: ForensicsRegistry) {
+    super('forensics', 'Forensics', 'F', 'monitoring');
+    this._data = new ForensicsDataPanel(registry);
+    this._unsub = this._data.subscribe(() => this.markDirty());
+  }
+
+  public override onActivate(): void {
+    super.onActivate();
+    this._scrollOffset = 0;
+    this._selectedIndex = 0;
+    this._mode = 'list';
+  }
+
+  public handleInput(key: string): boolean {
+    if (this._mode === 'list') {
+      if (key === 'up' || key === 'k') {
+        this._selectedIndex = Math.max(0, this._selectedIndex - 1);
+        this.markDirty();
+        return true;
+      }
+      if (key === 'down' || key === 'j') {
+        const count = this._data.getAll().length;
+        this._selectedIndex = Math.min(count - 1, this._selectedIndex + 1);
+        this.markDirty();
+        return true;
+      }
+      if (key === 'return' || key === 'enter') {
+        this._mode = 'detail';
+        this._scrollOffset = 0;
+        this.markDirty();
+        return true;
+      }
+    } else {
+      if (key === 'escape' || key === 'q') {
+        this._mode = 'list';
+        this.markDirty();
+        return true;
+      }
+      if (key === 'up' || key === 'k') {
+        this._scrollOffset = Math.max(0, this._scrollOffset - 1);
+        this.markDirty();
+        return true;
+      }
+      if (key === 'down' || key === 'j') {
+        this._scrollOffset++;
+        this.markDirty();
+        return true;
+      }
+    }
+    return false;
+  }
+
+  public override onDestroy(): void {
+    if (this._unsub) {
+      this._unsub();
+      this._unsub = null;
+    }
+    this._data.dispose();
+  }
+
+  public render(width: number, height: number): Line[] {
+    this.needsRender = false;
+    const intro = 'Recent failure reports, causal chains, phase timings, and cross-panel jump targets for incident investigation.';
+    const reports = this._data.getAll();
+
+    if (reports.length === 0) {
+      const workspace = buildPanelWorkspace(width, height, {
+        title: 'Failure Forensics',
+        intro,
+        sections: [{
+          lines: buildEmptyState(
+            width,
+            ' No failure reports. All systems nominal.',
+            'Failures will appear here with classification, causal chains, phase timings, and jump links as runtime incidents are captured.',
+            [{ command: '/incident', summary: 'open the incident review workspace and forensics surfaces' }],
+            C,
+          ),
+        }],
+        palette: C,
+      });
+      while (workspace.length < height) workspace.push(createEmptyLine(width));
+      return workspace;
+    }
+
+    const lines: Line[] = [];
+    if (this._mode === 'list') {
+      this._renderList(lines, reports, width, height, intro);
+    } else {
+      const report = reports[this._selectedIndex];
+      if (report) {
+        this._renderDetail(lines, report, width, height, intro);
+      } else {
+        this._mode = 'list';
+        this._renderList(lines, reports, width, height, intro);
+      }
+    }
+
+    while (lines.length < height) lines.push(createEmptyLine(width));
+    return lines;
+  }
+
+  // ── List view ──────────────────────────────────────────────────────────────
+
+  private _renderList(lines: Line[], reports: FailureReport[], width: number, height: number, intro: string): void {
+    const reportRows: Line[] = [
+      buildPanelLine(width, [['  ID       TIME      CLASS                 SUMMARY', C.label]]),
+    ];
+
+    for (let i = 0; i < reports.length; i++) {
+      const report = reports[i]!;
+      const isSelected = i === this._selectedIndex;
+      const bg = isSelected ? C.selectBg : undefined;
+
+      const idStr   = report.id.slice(0, 8).padEnd(8, ' ');
+      const timeStr = fmtTime(report.generatedAt);
+      const cls     = report.classification.slice(0, 20).padEnd(20, ' ');
+      const clsColor = classificationColor(report.classification);
+      const summaryMax = Math.max(0, width - 42);
+      const summaryStr = report.summary.slice(0, summaryMax);
+
+      const segs: Array<[string, string, string?]> = [
+        [isSelected ? '▸' : ' ', C.jumpLink, bg],
+        [`${idStr} `, C.reportId, bg],
+        [`${timeStr} `, C.timestamp, bg],
+        [`${cls} `, clsColor, bg],
+        [summaryStr, C.summaryText, bg],
+      ];
+      reportRows.push(buildPanelLine(width, segs));
+    }
+    const reportsSection = resolveScrollablePanelSection(width, height, {
+      intro,
+      palette: C,
+      section: {
+        title: 'Reports',
+        scrollableLines: reportRows,
+        selectedIndex: this._selectedIndex + 1,
+        scrollOffset: this._scrollOffset,
+        minRows: 4,
+        appendWindowSummary: {
+          dimColor: C.label,
+          formatter: () => buildPanelLine(width, [[` [${this._selectedIndex + 1}/${reports.length}] Up/Down navigate  Enter expand`, C.label]]),
+        },
+      },
+    });
+    this._scrollOffset = reportsSection.scrollOffset;
+
+    lines.push(...buildPanelWorkspace(width, height, {
+      title: 'Failure Forensics',
+      intro,
+      sections: [reportsSection.section],
+      palette: C,
+    }));
+  }
+
+  // ── Detail view ────────────────────────────────────────────────────────────
+
+  private _renderDetail(lines: Line[], report: FailureReport, width: number, height: number, intro: string): void {
+    const detailLines: Line[] = [];
+
+    detailLines.push(buildPanelLine(width, [
+      [' Report: ', C.label],
+      [report.id, C.value],
+      ['  Generated: ', C.label],
+      [fmtTime(report.generatedAt), C.timestamp],
+    ]));
+    detailLines.push(buildPanelLine(width, [
+      [' Class:   ', C.label],
+      [report.classification, classificationColor(report.classification)],
+    ]));
+    detailLines.push(buildPanelLine(width, [
+      [' Summary: ', C.label],
+      [report.summary.slice(0, width - 11), C.summaryText],
+    ]));
+
+    if (report.errorMessage) {
+      detailLines.push(buildPanelLine(width, [
+        [' Error:   ', C.label],
+        [report.errorMessage.slice(0, width - 11), C.classError],
+      ]));
+    }
+    if (report.stopReason) {
+      detailLines.push(buildPanelLine(width, [
+        [' Stop:    ', C.label],
+        [report.stopReason, C.classWarn],
+      ]));
+    }
+    if (report.taskId) {
+      detailLines.push(buildPanelLine(width, [[` Task:    ${report.taskId}`, C.value]]));
+    }
+    if (report.turnId) {
+      detailLines.push(buildPanelLine(width, [[` Turn:    ${report.turnId}`, C.value]]));
+    }
+
+    // Phase timings
+    if (report.phaseTimings.length > 0) {
+      detailLines.push(buildPanelLine(width, [[' Phase Timings:', C.label]]));
+      for (const pt of report.phaseTimings) {
+        this._renderPhase(detailLines, pt, width);
+      }
+    }
+
+    // Causal chain
+    if (report.causalChain.length > 0) {
+      detailLines.push(buildPanelLine(width, [[' Causal Chain:', C.label]]));
+      for (const entry of report.causalChain) {
+        this._renderCausal(detailLines, entry, width);
+      }
+    }
+
+    // Jump links
+    if (report.jumpLinks.length > 0) {
+      detailLines.push(buildPanelLine(width, [[' Jump Links:', C.label]]));
+      for (const link of report.jumpLinks) {
+        const kindTag = link.kind === 'panel' ? '[panel]' : '[cmd]  ';
+        detailLines.push(buildPanelLine(width, [
+          ['  ', C.dim],
+          [kindTag, C.timestamp],
+          [` ${link.label}`, C.jumpLink],
+          [link.args ? ` (${link.args})` : '', C.dim],
+        ]));
+      }
+    }
+
+    detailLines.push(buildPanelLine(width, [[' Esc/q: back to list  Up/Down: scroll', C.dim]]));
+
+    const detailSection = resolveScrollablePanelSection(width, height, {
+      intro,
+      palette: C,
+      section: {
+        title: 'Report Detail',
+        scrollableLines: detailLines,
+        scrollOffset: this._scrollOffset,
+        minRows: 1,
+      },
+    });
+    this._scrollOffset = detailSection.scrollOffset;
+    lines.push(...buildPanelWorkspace(width, height, {
+      title: 'Failure Forensics',
+      intro,
+      sections: [detailSection.section],
+      palette: C,
+    }));
+  }
+
+  private _renderPhase(lines: Line[], pt: PhaseTimingEntry, width: number): void {
+    const statusChar = pt.success ? '✓' : '✕';
+    const statusColor = pt.success ? C.phaseOk : C.phaseFail;
+    const dur = fmtDuration(pt.durationMs);
+    const phaseLabel = pt.phase.slice(0, 14).padEnd(14, ' ');
+    const errPart = pt.error ? `  ${pt.error.slice(0, Math.max(0, width - 32))}` : '';
+    lines.push(buildPanelLine(width, [
+      ['  ', C.dim],
+      [statusChar + ' ', statusColor],
+      [phaseLabel, C.value],
+      [dur.padStart(6, ' '), C.timestamp],
+      [errPart, C.classError],
+    ]));
+  }
+
+  private _renderCausal(lines: Line[], entry: CausalChainEntry, width: number): void {
+    const prefix = entry.isRootCause ? '  * ' : '  - ';
+    const color = entry.isRootCause ? C.chainRoot : C.chainEntry;
+    const timeStr = fmtTime(entry.ts);
+    const descMax = Math.max(0, width - prefix.length - 9);
+    lines.push(buildPanelLine(width, [
+      [prefix, color],
+      [`${timeStr} `, C.timestamp],
+      [entry.description.slice(0, descMax), color],
+    ]));
+  }
+}