@pellux/goodvibes-agent 0.1.70 → 0.1.72

package/src/panels/forensics-panel.ts

@@ -1,364 +0,0 @@
-/**
- * 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],
-    ]));
-  }
-}

package/src/panels/hooks-panel.ts

@@ -1,239 +0,0 @@
-import type { Line } from '../types/grid.ts';
-import { ScrollableListPanel } from './scrollable-list-panel.ts';
-import { listHookPointContracts } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookDispatcher } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookPointContract } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookActivityRecord, HookActivityTracker } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookAuthoringAction, HookSimulationResult } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookChain, HookDefinition } from '@pellux/goodvibes-sdk/platform/hooks';
-import type { HookWorkbench } from '@pellux/goodvibes-sdk/platform/hooks';
-import { truncateDisplay } from '../utils/terminal-width.ts';
-import {
-  buildPanelLine,
-  buildStatusPill,
-  DEFAULT_PANEL_PALETTE,
-} from './polish.ts';
-
-const C = {
-  ...DEFAULT_PANEL_PALETTE,
-  header: '#94a3b8',
-  headerBg: '#1e293b',
-  ok: '#22c55e',
-  warn: '#eab308',
-  error: '#ef4444',
-  info: '#38bdf8',
-  selectBg: '#0f172a',
-} as const;
-
-export interface HooksPanelWorkbenchView {
-  listManagedHooks(): Array<{ pattern: string; hook: HookDefinition }>;
-  listManagedChains(): HookChain[];
-  listRecentActions(limit?: number): HookAuthoringAction[];
-  getLastSimulation(): HookSimulationResult | null;
-  getHooksFilePath(): string;
-}
-
-export interface HooksPanelDataSource {
-  listContracts(): HookPointContract[];
-  listHooks(): Array<{ pattern: string; hook: HookDefinition }>;
-  listChains(): HookChain[];
-  listRecentActivity(limit?: number): readonly HookActivityRecord[];
-  getWorkbench(): HooksPanelWorkbenchView;
-}
-
-function createDefaultDataSource(
-  hookDispatcher: Pick<HookDispatcher, 'listHooks' | 'getChains'>,
-  hookWorkbench: HookWorkbench,
-  hookActivityTracker: Pick<HookActivityTracker, 'listRecent'>,
-): HooksPanelDataSource {
-  return {
-    listContracts: () => listHookPointContracts(),
-    listHooks: () => hookDispatcher.listHooks(),
-    listChains: () => hookDispatcher.getChains(),
-    listRecentActivity: (limit = 3) => hookActivityTracker.listRecent(limit),
-    getWorkbench: () => hookWorkbench,
-  };
-}
-
-type HookEntry = { pattern: string; hook: HookDefinition };
-
-export class HooksPanel extends ScrollableListPanel<HookEntry> {
-  private readonly dataSource: HooksPanelDataSource;
-
-  public constructor(
-    hookDispatcher: Pick<HookDispatcher, 'listHooks' | 'getChains'>,
-    hookWorkbench: HookWorkbench,
-    hookActivityTracker: Pick<HookActivityTracker, 'listRecent'>,
-    dataSource: HooksPanelDataSource = createDefaultDataSource(hookDispatcher, hookWorkbench, hookActivityTracker),
-  ) {
-    super('hooks', 'Hooks', 'H', 'monitoring');
-    this.showSelectionGutter = true; // I5: non-color selection affordance
-    this.dataSource = dataSource;
-  }
-
-  protected override getPalette() { return C; }
-  protected override getEmptyStateMessage() { return ' No hooks are currently registered.'; }
-  protected override getEmptyStateActions() {
-    return [
-      { command: '/hooks', summary: 'review hook contracts and managed authoring actions' },
-      { command: '/settings', summary: 'review hook/runtime behavior in the settings surface' },
-    ];
-  }
-
-  protected getItems(): readonly HookEntry[] {
-    return this.dataSource.listHooks();
-  }
-
-  protected renderItem(entry: HookEntry, index: number, selected: boolean, width: number): Line {
-    const bg = selected ? C.selectBg : undefined;
-    return buildPanelLine(width, [
-      [' ', C.label, bg],
-      [truncateDisplay(entry.hook.name ?? '(unnamed)', 20).padEnd(20), C.value, bg],
-      [` ${truncateDisplay(entry.pattern, 28).padEnd(28)}`, C.info, bg],
-      ...buildStatusPill(entry.hook.enabled === false ? 'warn' : 'good', ` ${(entry.hook.enabled === false ? 'DISABLED' : 'ENABLED').padEnd(8)}`, { bg }),
-      [` ${entry.hook.type}`, C.dim, bg],
-    ]);
-  }
-
-  public handleInput(key: string): boolean {
-    if (key === 'r') {
-      this.markDirty();
-      return true;
-    }
-    return super.handleInput(key);
-  }
-
-  public render(width: number, height: number): Line[] {
-    this.clampSelection();
-    const hooks = this.dataSource.listHooks();
-    const contracts = this.dataSource.listContracts();
-    const chains = this.dataSource.listChains();
-    const recentActivity = this.dataSource.listRecentActivity(3);
-    const workbench = this.dataSource.getWorkbench();
-    const managedHooks = workbench.listManagedHooks();
-    const managedChains = workbench.listManagedChains();
-    const recentAuthoring = workbench.listRecentActions(3);
-    const lastSimulation = workbench.getLastSimulation();
-    const intro = 'Hook contracts, active registrations, managed authoring, recent runtime activity, and simulation matches.';
-
-    const selected = hooks[this.selectedIndex];
-    const contract = selected ? contracts.find((c) => c.pattern === selected.pattern) : undefined;
-
-    const detailLines: Line[] = [];
-    if (selected) {
-      detailLines.push(buildPanelLine(width, [
-        ['  Hook: ', C.label],
-        [selected.hook.name ?? '(unnamed)', C.value],
-        ['  Type: ', C.label],
-        [selected.hook.type, C.info],
-        ['  Match: ', C.label],
-        [selected.hook.matcher ?? selected.hook.match, C.value],
-      ]));
-      detailLines.push(buildPanelLine(width, [
-        ['  Pattern: ', C.label],
-        [truncateDisplay(selected.pattern, Math.max(0, width - 12)), C.value],
-      ]));
-      if (contract) {
-        detailLines.push(buildPanelLine(width, [
-          ['  Contract: ', C.label],
-          [`${contract.authority} / ${contract.executionMode}`, C.info],
-          ['  Policy: ', C.label],
-          [contract.failurePolicy, C.value],
-        ]));
-        detailLines.push(buildPanelLine(width, [
-          ['  Capabilities: ', C.label],
-          [`deny=${contract.canDeny ? 'yes' : 'no'} mutate=${contract.canMutateInput ? 'yes' : 'no'} inject=${contract.canInjectContext ? 'yes' : 'no'}`, C.dim],
-        ]));
-      } else {
-        detailLines.push(buildPanelLine(width, [['  Contract: No exact contract registered for this pattern.', C.warn]]));
-      }
-      detailLines.push(buildPanelLine(width, [
-        ['  Summary: ', C.label],
-        [`hooks=${hooks.length} chains=${chains.length} contracts=${contracts.length} managed=${managedHooks.length}/${managedChains.length}`, C.dim],
-      ]));
-      detailLines.push(buildPanelLine(width, [
-        ['  Hooks file: ', C.label],
-        [truncateDisplay(workbench.getHooksFilePath(), Math.max(0, width - 15)), C.dim],
-      ]));
-    }
-
-    const activityLines: Line[] = recentActivity.length === 0
-      ? [buildPanelLine(width, [['  No hook activity recorded yet.', C.empty]])]
-      : recentActivity.map((record) => {
-          const color = !record.ok ? C.error : record.decision === 'deny' ? C.warn : C.ok;
-          return buildPanelLine(width, [
-            ['  ', C.label],
-            [truncateDisplay(record.hookName, 18).padEnd(18), C.value],
-            ['  ', C.label],
-            [truncateDisplay(record.path, 26).padEnd(26), C.info],
-            ['  ', C.label],
-            [record.ok ? (record.decision ?? 'ok') : 'error', color],
-          ]);
-        });
-
-    const authoringLines: Line[] = recentAuthoring.length === 0
-      ? [buildPanelLine(width, [['  No managed hook authoring actions recorded yet.', C.empty]])]
-      : recentAuthoring.map((action) => buildPanelLine(width, [
-          ['  ', C.label],
-          [truncateDisplay(action.kind, 14).padEnd(14), C.info],
-          ['  ', C.label],
-          [truncateDisplay(action.target, Math.max(0, width - 20)), C.dim],
-        ]));
-    if (lastSimulation) {
-      authoringLines.push(buildPanelLine(width, [
-        ['  Last Simulation: ', C.label],
-        [truncateDisplay(lastSimulation.eventPath, Math.max(0, width - 20)), C.value],
-      ]));
-      authoringLines.push(buildPanelLine(width, [
-        ['  Matches: ', C.label],
-        [`hooks=${lastSimulation.matchedHooks.length} chains=${lastSimulation.matchedChains.length}`, C.dim],
-      ]));
-    }
-
-    // Empty state: show extra context lines (hooks file, contracts, authoring) before base empty state
-    if (hooks.length === 0) {
-      const extraHeader: Line[] = [
-        buildPanelLine(width, [
-          ['  Contracts: ', C.label],
-          [String(contracts.length), C.value],
-          ['  Chains: ', C.label],
-          [String(chains.length), C.value],
-          ['  Managed: ', C.label],
-          [String(managedHooks.length), C.info],
-        ]),
-        buildPanelLine(width, [
-          ['  Hooks file: ', C.label],
-          [truncateDisplay(workbench.getHooksFilePath(), Math.max(0, width - 15)), C.dim],
-        ]),
-      ];
-      if (recentAuthoring.length > 0) {
-        extraHeader.push(buildPanelLine(width, [
-          ['  Authoring: ', C.label],
-          [truncateDisplay(`${recentAuthoring[0]!.kind} ${recentAuthoring[0]!.target}`, Math.max(0, width - 14)), C.info],
-        ]));
-      }
-      if (lastSimulation) {
-        extraHeader.push(buildPanelLine(width, [
-          ['  Last Simulation: ', C.label],
-          [truncateDisplay(lastSimulation.eventPath, Math.max(0, width - 20)), C.value],
-        ]));
-      }
-      return this.renderList(width, height, {
-        title: 'Hooks Control Room',
-        header: extraHeader,
-      });
-    }
-
-    return this.renderList(width, height, {
-      title: 'Hooks Control Room',
-      footer: [
-        ...detailLines,
-        buildPanelLine(width, [['  Recent Activity', C.label]]),
-        ...activityLines,
-        buildPanelLine(width, [['  Authoring', C.label]]),
-        ...authoringLines,
-        buildPanelLine(width, [['  Up/Down move  r refresh  /hooks for full contract listing', C.dim]]),
-      ],
-    });
-  }
-}