@pellux/goodvibes-tui 0.18.13 → 0.18.18

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

@@ -1,242 +0,0 @@
-/**
- * Health diagnostic panel data provider.
- *
- * Subscribes to the RuntimeHealthAggregator and produces HealthDashboardData
- * snapshots for the health dashboard diagnostics panel.
- *
- * Implements the health visualization layer for diagnostics.
- * SLO status rows are included when an SloCollector is attached.
- * Remediation actions are included when a CascadeTimer is attached.
- */
-import type { RuntimeHealthAggregator } from '@pellux/goodvibes-sdk/platform/runtime/health/aggregator';
-import type { CompositeHealth, HealthDomain, HealthStatus } from '@pellux/goodvibes-sdk/platform/runtime/health/types';
-import type { HealthDashboardData, DomainHealthSummary, SloRow, SloGateStatus, RemediationAction } from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/types';
-import type { SloCollector } from '@pellux/goodvibes-sdk/platform/runtime/perf/slo-collector';
-import type { CascadeTimer } from '@pellux/goodvibes-sdk/platform/runtime/health/cascade-timing';
-import { SLO_METRICS } from '@pellux/goodvibes-sdk/platform/runtime/perf/slo-collector';
-import { DEFAULT_BUDGETS } from '@pellux/goodvibes-sdk/platform/runtime/perf/budgets';
-
-/**
- * Human-readable names for playbooks, keyed by playbook ID.
- * Used to populate RemediationAction.playbookName in the health dashboard.
- */
-const PLAYBOOK_NAMES: ReadonlyMap<string, string> = new Map([
-  ['stuck-turn', 'Stuck Turn / Task'],
-  ['reconnect-failure', 'Reconnect Failure'],
-  ['permission-deadlock', 'Permission Deadlock'],
-  ['plugin-degradation', 'Plugin Degradation'],
-  ['export-recovery', 'Export Recovery'],
-  ['session-unrecoverable', 'Session Unrecoverable'],
-  ['compaction-failure', 'Compaction Failure'],
-]);
-
-/**
- * HealthPanel — diagnostic data provider for runtime health telemetry.
- *
- * Subscribes to health aggregator updates and maintains a current
- * HealthDashboardData snapshot for the panel to render.
- */
-/** Warn threshold: 20% above the SLO target triggers a 'warn' status. */
-const SLO_WARN_FACTOR = 1.2;
-
-/** SLO budget metadata needed for row construction, keyed by metric name. */
-const SLO_BUDGET_META = new Map(
-  DEFAULT_BUDGETS
-    .filter((b) => b.metric.startsWith('slo.'))
-    .map((b) => [b.metric, { name: b.name, targetMs: b.threshold }])
-);
-
-export class HealthPanel {
-  private readonly _aggregator: RuntimeHealthAggregator;
-  private readonly _sloCollector: SloCollector | null;
-  private readonly _cascadeTimer: CascadeTimer | null;
-  private _current: HealthDashboardData;
-  /** Registered change notification callbacks. */
-  private readonly _subscribers = new Set<() => void>();
-  /** Unsubscribe function from the aggregator. */
-  private _unsub: (() => void) | null = null;
-
-  /**
-   * @param aggregator - The runtime health aggregator to subscribe to.
-   * @param sloCollector - Optional SLO collector for SLO status rows.
-   *   When provided, SLO rows are included in every dashboard snapshot.
-   * @param cascadeTimer - Optional CascadeTimer for remediation action rows.
-   *   When provided, active failed domains are evaluated and remediation
-   *   playbook IDs are surfaced in every dashboard snapshot.
-   */
-  constructor(
-    aggregator: RuntimeHealthAggregator,
-    sloCollector: SloCollector | null = null,
-    cascadeTimer: CascadeTimer | null = null,
-  ) {
-    this._aggregator = aggregator;
-    this._sloCollector = sloCollector;
-    this._cascadeTimer = cascadeTimer;
-    // Capture the initial snapshot before subscribing
-    this._current = this._buildDashboard(aggregator.getCompositeHealth());
-    this._unsub = aggregator.subscribe((health) => {
-      this._current = this._buildDashboard(health);
-      this._notify();
-    });
-  }
-
-  /**
-   * Build a HealthDashboardData snapshot from a CompositeHealth record.
-   */
-  private _buildDashboard(composite: CompositeHealth): HealthDashboardData {
-    const domains: DomainHealthSummary[] = [];
-    for (const [, dh] of composite.domains) {
-      domains.push({
-        domain: dh.domain,
-        status: dh.status,
-        lastTransitionAt: dh.lastTransitionAt,
-        degradedCapabilities: dh.degradedCapabilities ?? [],
-        failureReason: dh.failureReason,
-        recoveryAttempts: dh.recoveryAttempts,
-      });
-    }
-    // Sort: failed first, then degraded, then healthy, alphabetically within tier
-    domains.sort((a, b) => {
-      const order = { failed: 0, degraded: 1, healthy: 2, unknown: 3 };
-      const diff = (order[a.status] ?? 3) - (order[b.status] ?? 3);
-      return diff !== 0 ? diff : a.domain.localeCompare(b.domain);
-    });
-    return {
-      overall: composite.overall,
-      domains,
-      degradedDomains: composite.degradedDomains,
-      failedDomains: composite.failedDomains,
-      lastUpdatedAt: composite.lastUpdatedAt,
-      sloRows: this._buildSloRows(),
-      remediationActions: this._buildRemediationActions(composite),
-    };
-  }
-
-  /**
-   * Build remediation action rows by evaluating cascade rules for all
-   * currently-failed domains using the CascadeTimer.
-   *
-   * Returns an empty array when no CascadeTimer is attached or when
-   * no domains are in the failed state.
-   */
-  private _buildRemediationActions(composite: CompositeHealth): readonly RemediationAction[] {
-    if (this._cascadeTimer === null || composite.failedDomains.length === 0) {
-      return [];
-    }
-
-    const actions: RemediationAction[] = [];
-    const seen = new Set<string>(); // deduplicate by playbookId+ruleId
-
-    for (const domain of composite.failedDomains) {
-      const { cascades } = this._cascadeTimer.evaluate(
-        domain,
-        'failed',
-      );
-
-      for (const cascade of cascades) {
-        for (const playbookId of cascade.remediationPlaybookIds) {
-          const key = `${playbookId}:${cascade.ruleId}`;
-          if (seen.has(key)) continue;
-          seen.add(key);
-          actions.push({
-            playbookId,
-            playbookName: PLAYBOOK_NAMES.get(playbookId) ?? playbookId,
-            ruleId: cascade.ruleId,
-            sourceDomain: cascade.source,
-            severity: cascade.severity ?? 'low',
-          });
-        }
-      }
-    }
-
-    // Sort by severity: critical first, then high, medium, low
-    const severityOrder: Record<string, number> = { critical: 0, high: 1, medium: 2, low: 3 };
-    actions.sort((a, b) => (severityOrder[a.severity] ?? 3) - (severityOrder[b.severity] ?? 3));
-
-    return actions;
-  }
-
-  /**
-   * Build SLO status rows from the current SloCollector snapshot.
-   * Returns an empty array when no SloCollector is attached.
-   */
-  private _buildSloRows(): SloRow[] {
-    if (this._sloCollector === null) return [];
-
-    const metrics = this._sloCollector.getMetrics();
-    const counts = this._sloCollector.getSampleCounts();
-
-    const SLO_ORDER = [
-      SLO_METRICS.TURN_START,
-      SLO_METRICS.CANCEL,
-      SLO_METRICS.RECONNECT_RECOVERY,
-      SLO_METRICS.PERMISSION_DECISION,
-    ] as const;
-
-    return SLO_ORDER.map((metricKey): SloRow => {
-      const metric = metrics.find((m) => m.name === metricKey);
-      const meta = SLO_BUDGET_META.get(metricKey);
-      const p95Ms = metric?.value ?? 0;
-      const targetMs = meta?.targetMs ?? 0;
-      const sampleCount = counts[metricKey] ?? 0;
-
-      let status: SloGateStatus;
-      if (sampleCount === 0) {
-        status = 'no_data';
-      } else if (p95Ms > targetMs) {
-        status = 'violated';
-      } else if (p95Ms > targetMs / SLO_WARN_FACTOR) {
-        status = 'warn';
-      } else {
-        status = 'ok';
-      }
-
-      return {
-        metric: metricKey,
-        name: meta?.name ?? metricKey,
-        p95Ms,
-        targetMs,
-        sampleCount,
-        status,
-      };
-    });
-  }
-
-  /**
-   * Return the current health dashboard snapshot.
-   * This is updated synchronously when the aggregator fires.
-   */
-  public getSnapshot(): HealthDashboardData {
-    return this._current;
-  }
-
-  /**
-   * Register a callback invoked whenever health data changes.
-   * @returns An unsubscribe function.
-   */
-  public subscribe(callback: () => void): () => void {
-    this._subscribers.add(callback);
-    return () => this._subscribers.delete(callback);
-  }
-
-  /**
-   * Release the aggregator subscription.
-   */
-  public dispose(): void {
-    if (this._unsub) {
-      this._unsub();
-      this._unsub = null;
-    }
-    this._subscribers.clear();
-  }
-
-  private _notify(): void {
-    for (const cb of this._subscribers) {
-      try {
-        cb();
-      } catch {
-        // Non-fatal: subscriber errors must not crash the provider
-      }
-    }
-  }
-}

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

@@ -1,251 +0,0 @@
-/**
- * Tasks diagnostic panel data provider.
- *
- * Subscribes to task lifecycle events via the RuntimeEventBus and maintains
- * a bounded buffer of TaskEntry records. Provides filtered snapshots
- * for the tasks diagnostics panel.
- *
- * Covers all task kinds: exec, agent, acp, scheduler, daemon, mcp, plugin, integration.
- */
-import type { RuntimeEventBus, EnvelopeListener } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { AnyRuntimeEvent } from '@pellux/goodvibes-sdk/platform/runtime/events/domain-map';
-import type { RuntimeEventEnvelope } from '@pellux/goodvibes-sdk/platform/runtime/events/envelope';
-import {
-  type TaskEntry,
-  type DiagnosticFilter,
-  type PanelConfig,
-  DEFAULT_PANEL_CONFIG,
-  applyFilter,
-  appendBounded,
-} from '@pellux/goodvibes-sdk/platform/runtime/diagnostics/types';
-
-/** Task state as tracked internally while a task is in progress. */
-type MutableTaskState = TaskEntry['state'];
-
-/** Internal mutable task record used while the task is in progress. */
-interface MutableTaskRecord {
-  taskId: string;
-  agentId?: string;
-  description: string;
-  priority: number;
-  state: MutableTaskState;
-  createdAt: number;
-  completedAt?: number;
-  durationMs?: number;
-  progress?: number;
-  progressMessage?: string;
-  blockReason?: string;
-  error?: string;
-  traceId: string;
-  sessionId: string;
-}
-
-/**
- * TasksPanel — diagnostic data provider for runtime task telemetry.
- *
- * Active tasks are tracked in a live map; terminal tasks are moved
- * to the history buffer for filtering and display.
- */
-export class TasksPanel {
-  private readonly _config: PanelConfig;
-  private readonly _eventBus: RuntimeEventBus;
-  /** Active tasks keyed by taskId. */
-  private readonly _active = new Map<string, MutableTaskRecord>();
-  /** Completed task history (oldest first). */
-  private readonly _history: TaskEntry[] = [];
-  /** Registered change notification callbacks. */
-  private readonly _subscribers = new Set<() => void>();
-  /** Unsubscribe function from the event bus. */
-  private _unsub: (() => void) | null = null;
-
-  constructor(eventBus: RuntimeEventBus, config: PanelConfig = DEFAULT_PANEL_CONFIG) {
-    this._eventBus = eventBus;
-    this._config = config;
-    this._start();
-  }
-
-  private _start(): void {
-    const handler: EnvelopeListener<AnyRuntimeEvent> = (
-      envelope: RuntimeEventEnvelope<AnyRuntimeEvent['type'], AnyRuntimeEvent>
-    ) => {
-      this._handleEnvelope(envelope);
-    };
-    this._unsub = this._eventBus.onDomain('tasks', handler as EnvelopeListener);
-  }
-
-  private _handleEnvelope(
-    envelope: RuntimeEventEnvelope<AnyRuntimeEvent['type'], AnyRuntimeEvent>
-  ): void {
-    const p = envelope.payload;
-    if (!('type' in p)) return;
-    const type = (p as { type: string }).type;
-    const traceId = envelope.traceId;
-    const sessionId = envelope.sessionId;
-
-    switch (type) {
-      case 'TASK_CREATED': {
-        const evt = p as { type: 'TASK_CREATED'; taskId: string; agentId?: string; description: string; priority: number };
-        this._active.set(evt.taskId, {
-          taskId: evt.taskId,
-          agentId: evt.agentId,
-          description: evt.description,
-          priority: evt.priority,
-          state: 'created',
-          createdAt: envelope.ts,
-          traceId,
-          sessionId,
-        });
-        this._notify();
-        break;
-      }
-      case 'TASK_STARTED': {
-        const evt = p as { type: 'TASK_STARTED'; taskId: string };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'running';
-          this._notify();
-        }
-        break;
-      }
-      case 'TASK_BLOCKED': {
-        const evt = p as { type: 'TASK_BLOCKED'; taskId: string; reason: string };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'blocked';
-          record.blockReason = evt.reason;
-          this._notify();
-        }
-        break;
-      }
-      case 'TASK_PROGRESS': {
-        const evt = p as { type: 'TASK_PROGRESS'; taskId: string; progress: number; message?: string };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'progressing';
-          record.progress = evt.progress;
-          record.progressMessage = evt.message;
-          this._notify();
-        }
-        break;
-      }
-      case 'TASK_COMPLETED': {
-        const evt = p as { type: 'TASK_COMPLETED'; taskId: string; durationMs: number };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'completed';
-          record.completedAt = envelope.ts;
-          record.durationMs = evt.durationMs;
-          this._finalize(record);
-        }
-        break;
-      }
-      case 'TASK_FAILED': {
-        const evt = p as { type: 'TASK_FAILED'; taskId: string; error: string; durationMs: number };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'failed';
-          record.completedAt = envelope.ts;
-          record.durationMs = evt.durationMs;
-          record.error = evt.error;
-          this._finalize(record);
-        }
-        break;
-      }
-      case 'TASK_CANCELLED': {
-        const evt = p as { type: 'TASK_CANCELLED'; taskId: string; reason?: string };
-        const record = this._active.get(evt.taskId);
-        if (record) {
-          record.state = 'cancelled';
-          record.completedAt = envelope.ts;
-          record.error = evt.reason;
-          this._finalize(record);
-        }
-        break;
-      }
-      default:
-        break;
-    }
-  }
-
-  private _finalize(record: MutableTaskRecord): void {
-    this._active.delete(record.taskId);
-    const entry: TaskEntry = {
-      taskId: record.taskId,
-      agentId: record.agentId,
-      description: record.description,
-      priority: record.priority,
-      state: record.state,
-      createdAt: record.createdAt,
-      completedAt: record.completedAt,
-      durationMs: record.durationMs,
-      progress: record.progress,
-      progressMessage: record.progressMessage,
-      blockReason: record.blockReason,
-      error: record.error,
-      traceId: record.traceId,
-      sessionId: record.sessionId,
-    };
-    appendBounded(this._history, entry, this._config.bufferLimit);
-    this._notify();
-  }
-
-  /**
-   * Return a filtered snapshot combining active tasks and completed history.
-   * Ordered most-recent first.
-   *
-   * @param filter - Optional filter to restrict entries.
-   */
-  public getSnapshot(filter?: DiagnosticFilter): TaskEntry[] {
-    const activeEntries: TaskEntry[] = [];
-    for (const record of this._active.values()) {
-      activeEntries.push({
-        taskId: record.taskId,
-        agentId: record.agentId,
-        description: record.description,
-        priority: record.priority,
-        state: record.state,
-        createdAt: record.createdAt,
-        completedAt: record.completedAt,
-        durationMs: record.durationMs,
-        progress: record.progress,
-        progressMessage: record.progressMessage,
-        blockReason: record.blockReason,
-        error: record.error,
-        traceId: record.traceId,
-        sessionId: record.sessionId,
-      });
-    }
-    const combined: TaskEntry[] = [...this._history, ...activeEntries];
-    return applyFilter(combined, filter, (e) => e.createdAt);
-  }
-
-  /**
-   * Register a callback invoked whenever the data changes.
-   * @returns An unsubscribe function.
-   */
-  public subscribe(callback: () => void): () => void {
-    this._subscribers.add(callback);
-    return () => this._subscribers.delete(callback);
-  }
-
-  /**
-   * Release all event bus subscriptions and clear internal state.
-   */
-  public dispose(): void {
-    if (this._unsub) {
-      this._unsub();
-      this._unsub = null;
-    }
-    this._subscribers.clear();
-  }
-
-  private _notify(): void {
-    for (const cb of this._subscribers) {
-      try {
-        cb();
-      } catch {
-        // Non-fatal: subscriber errors must not crash the provider
-      }
-    }
-  }
-}