@pellux/goodvibes-tui 0.28.0 → 0.29.0

package/src/panels/forensics-panel.ts

@@ -1,378 +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 { fitDisplay, truncateDisplay } from '../utils/terminal-width.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';
-import { formatShortDuration } from '../utils/format-duration.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 {
-  return formatShortDuration(ms);
-}
-
-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 {
-    // Posture summary: how many reports and how many are hard errors, so the
-    // most important signal (recent failures) is visible before scrolling.
-    const errorCount = reports.filter((r) => classificationColor(r.classification) === C.classError).length;
-    const newest = reports[0];
-    const summaryLine = buildPanelLine(width, [
-      [' reports ', C.label],
-      [String(reports.length), C.value],
-      ['  errors ', C.label],
-      [String(errorCount), errorCount > 0 ? C.classError : C.classOk],
-      ['  newest ', C.label],
-      [newest ? fmtTime(newest.generatedAt) : 'n/a', C.timestamp],
-    ]);
-
-    const reportRows: Line[] = [
-      summaryLine,
-      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   = fitDisplay(report.id, 8);
-      const timeStr = fmtTime(report.generatedAt);
-      const cls     = fitDisplay(report.classification, 20);
-      const clsColor = classificationColor(report.classification);
-      const summaryMax = Math.max(0, width - 42);
-      const summaryStr = truncateDisplay(report.summary, 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 + 2,
-        scrollOffset: this._scrollOffset,
-        minRows: 4,
-        appendWindowSummary: {
-          dimColor: C.label,
-          formatter: () => buildPanelLine(width, [[` [${this._selectedIndex + 1}/${reports.length}] ↑/↓ navigate  Enter expand report`, 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],
-      [truncateDisplay(report.summary, Math.max(0, width - 11)), C.summaryText],
-    ]));
-
-    if (report.errorMessage) {
-      detailLines.push(buildPanelLine(width, [
-        [' Error:   ', C.label],
-        [truncateDisplay(report.errorMessage, Math.max(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 = fitDisplay(pt.phase, 14);
-    const errPart = pt.error ? `  ${truncateDisplay(pt.error, 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],
-      [truncateDisplay(entry.description, descMax), color],
-    ]));
-  }
-}

package/src/panels/provider-account-snapshot.ts

@@ -1,259 +0,0 @@
-import { listBuiltinSubscriptionProviders } from '@pellux/goodvibes-sdk/platform/config';
-import type {
-  ProviderAccountInspectionQuery,
-} from '../runtime/ui-service-queries.ts';
-
-export type ProviderAuthRoute = 'api-key' | 'subscription' | 'service-oauth' | 'unconfigured';
-export type ProviderAuthFreshness = 'healthy' | 'expiring' | 'expired' | 'pending' | 'unconfigured';
-
-export interface ProviderUsageWindow {
-  readonly label: string;
-  readonly detail: string;
-}
-
-export interface ProviderRouteRecord {
-  readonly route: Exclude<ProviderAuthRoute, 'unconfigured'>;
-  readonly usable: boolean;
-  readonly freshness: ProviderAuthFreshness;
-  readonly detail: string;
-  readonly issues: readonly string[];
-}
-
-export interface ProviderAccountRecord {
-  readonly providerId: string;
-  readonly active: boolean;
-  readonly modelCount: number;
-  readonly configured: boolean;
-  readonly oauthReady: boolean;
-  readonly pendingLogin: boolean;
-  readonly availableRoutes: readonly ProviderAuthRoute[];
-  readonly preferredRoute: ProviderAuthRoute;
-  readonly activeRoute: ProviderAuthRoute;
-  readonly activeRouteReason: string;
-  readonly authFreshness: ProviderAuthFreshness;
-  readonly fallbackRoute?: ProviderAuthRoute;
-  readonly fallbackRisk?: string;
-  readonly expiresAt?: number;
-  readonly tokenType?: string;
-  readonly notes: readonly string[];
-  readonly usageWindows: readonly ProviderUsageWindow[];
-  readonly issues: readonly string[];
-  readonly recommendedActions: readonly string[];
-  readonly routeRecords: readonly ProviderRouteRecord[];
-}
-
-export interface ProviderAccountSnapshot {
-  readonly capturedAt: number;
-  readonly providers: readonly ProviderAccountRecord[];
-  readonly configuredCount: number;
-  readonly issueCount: number;
-}
-
-export interface ProviderAccountSnapshotDeps extends ProviderAccountInspectionQuery {}
-
-export interface ProviderAccountSnapshotQuery {
-  readonly loadSnapshot: () => Promise<ProviderAccountSnapshot>;
-}
-
-export function createProviderAccountSnapshotQuery(
-  deps: ProviderAccountSnapshotDeps,
-): ProviderAccountSnapshotQuery {
-  return {
-    loadSnapshot: () => buildProviderAccountSnapshot(deps),
-  };
-}
-
-function determineActiveRoute(routes: readonly ProviderAuthRoute[]): ProviderAuthRoute {
-  if (routes.includes('subscription')) return 'subscription';
-  if (routes.includes('service-oauth')) return 'service-oauth';
-  if (routes.includes('api-key')) return 'api-key';
-  return 'unconfigured';
-}
-
-function isExpired(expiresAt?: number): boolean {
-  return typeof expiresAt === 'number' && Number.isFinite(expiresAt) && expiresAt <= Date.now();
-}
-
-function determineFreshness(input: {
-  readonly hasSubscription: boolean;
-  readonly expiresAt?: number;
-  readonly pending: boolean;
-  readonly hasServiceOAuth: boolean;
-  readonly hasApiKey: boolean;
-}): ProviderAuthFreshness {
-  if (input.hasSubscription) {
-    if (isExpired(input.expiresAt)) return 'expired';
-    if (input.expiresAt && input.expiresAt <= Date.now() + 24 * 60 * 60 * 1000) return 'expiring';
-    if (input.pending) return 'pending';
-    return 'healthy';
-  }
-  if (input.hasServiceOAuth || input.hasApiKey) return 'healthy';
-  return 'unconfigured';
-}
-
-function builtinWindowsForProvider(providerId: string): readonly ProviderUsageWindow[] {
-  if (providerId === 'openai') {
-    return [
-      { label: '5-hour window', detail: 'Subscription-backed Codex access may be constrained by rolling 5-hour usage limits.' },
-      { label: '1-week window', detail: 'Subscription-backed Codex access may also be constrained by a rolling weekly limit.' },
-    ];
-  }
-  return [];
-}
-
-export async function buildProviderAccountSnapshot(
-  deps: ProviderAccountSnapshotDeps,
-): Promise<ProviderAccountSnapshot> {
-  const models = deps.providerModels.listModels();
-  const services = deps.services.getAll();
-  const subscriptions = deps.subscriptions;
-  const builtinSubscriptionProviders = new Set(listBuiltinSubscriptionProviders().map((entry) => entry.provider));
-  const serviceInspections = await Promise.all(Object.keys(services).map(async (name) => ({
-    name,
-    inspection: await deps.services.inspect(name),
-  })));
-  const serviceOauthByProvider = new Map<string, { configured: boolean; usable: boolean }>();
-  for (const { inspection } of serviceInspections) {
-    if (!inspection || inspection.config.authType !== 'oauth') continue;
-    const providerId = inspection.config.providerId ?? inspection.config.name;
-    const existing = serviceOauthByProvider.get(providerId);
-    serviceOauthByProvider.set(providerId, {
-      configured: true,
-      usable: Boolean(existing?.usable || inspection.hasPrimaryCredential),
-    });
-  }
-
-  const providerIds = new Set<string>([
-    ...models.map((model) => model.provider),
-    ...Object.keys(services),
-    ...subscriptions.list().map((entry) => entry.provider),
-    ...subscriptions.listPending().map((entry) => entry.provider),
-    ...builtinSubscriptionProviders,
-  ]);
-
-  const providers = await Promise.all([...providerIds].sort((a, b) => a.localeCompare(b)).map(async (providerId) => {
-    const subscription = subscriptions.get(providerId);
-    const pending = subscriptions.getPending(providerId);
-    const serviceConfig = Object.values(services).find((entry) => (entry.providerId ?? entry.name) === providerId) ?? null;
-    const serviceOauth = serviceOauthByProvider.get(providerId);
-    const hasApiKey = Boolean(serviceConfig?.tokenKey && deps.environment.hasEnvironmentVariable(serviceConfig.tokenKey));
-    const hasSubscription = subscription != null;
-    const hasServiceOAuth = Boolean(serviceOauth?.configured);
-    const routes: ProviderAuthRoute[] = [];
-    if (hasApiKey) routes.push('api-key');
-    if (hasSubscription) routes.push('subscription');
-    if (hasServiceOAuth) routes.push('service-oauth');
-    if (routes.length === 0) routes.push('unconfigured');
-
-    const usableRoutes: Exclude<ProviderAuthRoute, 'unconfigured'>[] = [];
-    if (hasApiKey) usableRoutes.push('api-key');
-    if (hasSubscription && !isExpired(subscription.expiresAt)) usableRoutes.push('subscription');
-    if (hasServiceOAuth) usableRoutes.push('service-oauth');
-
-    const activeRoute = determineActiveRoute(usableRoutes.length > 0 ? usableRoutes : routes);
-    const preferredRoute = determineActiveRoute(routes);
-    const freshness = determineFreshness({
-      hasSubscription,
-      expiresAt: subscription?.expiresAt,
-      pending: pending != null,
-      hasServiceOAuth,
-      hasApiKey,
-    });
-    const usageWindows = builtinWindowsForProvider(providerId);
-    const routeRecords: ProviderRouteRecord[] = [];
-
-    if (hasApiKey) {
-      routeRecords.push({
-        route: 'api-key',
-        usable: true,
-        freshness: 'healthy',
-        detail: 'Ambient API key is available for direct provider access.',
-        issues: [],
-      });
-    }
-    if (hasSubscription) {
-      routeRecords.push({
-        route: 'subscription',
-        usable: !isExpired(subscription?.expiresAt),
-        freshness: pending ? 'pending' : isExpired(subscription?.expiresAt) ? 'expired' : 'healthy',
-        detail: subscription?.overrideAmbientApiKeys
-          ? 'Subscription route is configured to override ambient API-key resolution.'
-          : 'Subscription route is configured, but ambient API keys remain active unless selected explicitly.',
-        issues: isExpired(subscription?.expiresAt) ? ['Stored subscription session is expired.'] : [],
-      });
-    }
-    if (hasServiceOAuth) {
-      routeRecords.push({
-        route: 'service-oauth',
-        usable: true,
-        freshness: 'healthy',
-        detail: 'Service OAuth credential is available for this provider.',
-        issues: [],
-      });
-    }
-
-    const issues: string[] = [];
-    const notes: string[] = [`${models.filter((model) => model.provider === providerId).length} model${models.filter((model) => model.provider === providerId).length === 1 ? '' : 's'} registered`];
-    if (serviceConfig) notes.push(`service config: ${serviceConfig.authType}`);
-    const recommendedActions: string[] = [];
-    if (routes.length === 1 && routes[0] === 'unconfigured') {
-      issues.push('Provider has no configured auth route.');
-      recommendedActions.push(`Configure API keys, subscriptions, or service OAuth for ${providerId}.`);
-    }
-    if (hasSubscription && isExpired(subscription?.expiresAt)) {
-      issues.push('Stored subscription session is expired and needs refresh.');
-      recommendedActions.push(`Refresh or replace the ${providerId} subscription session before relying on it.`);
-    } else if (hasSubscription && subscription?.expiresAt && subscription.expiresAt <= Date.now() + 24 * 60 * 60 * 1000) {
-      issues.push('Stored subscription session is nearing expiry.');
-      recommendedActions.push(`Renew or verify the ${providerId} subscription session soon to avoid route drift.`);
-    }
-    if (pending) {
-      issues.push('Provider has a pending OAuth login that has not been completed yet.');
-      recommendedActions.push(`Finish /subscription login ${providerId} finish <code> or clear the pending login.`);
-    }
-    if (hasSubscription && hasApiKey) {
-      issues.push('Provider has both subscription and API-key auth paths; routing must remain explicit.');
-      recommendedActions.push('Review provider routing before switching models or auth paths.');
-    }
-    if (hasServiceOAuth && !serviceOauth?.usable) {
-      issues.push('Service OAuth is configured but missing a usable credential.');
-      recommendedActions.push(`Repair service OAuth credentials for ${providerId} in /services or /settings.`);
-    }
-
-    return {
-      providerId,
-      active: activeRoute !== 'unconfigured',
-      modelCount: models.filter((model) => model.provider === providerId).length,
-      configured: hasApiKey || hasSubscription || hasServiceOAuth || models.some((model) => model.provider === providerId),
-      oauthReady: Boolean(serviceConfig?.oauth),
-      pendingLogin: Boolean(pending),
-      availableRoutes: routes,
-      preferredRoute,
-      activeRoute,
-      activeRouteReason: activeRoute === 'subscription'
-        ? 'Subscription route is currently preferred.'
-        : activeRoute === 'service-oauth'
-          ? 'Service OAuth route is currently preferred.'
-          : activeRoute === 'api-key'
-            ? 'Ambient API-key route is currently preferred.'
-            : 'No usable auth route is configured for this provider.',
-      authFreshness: freshness,
-      fallbackRoute: activeRoute !== preferredRoute ? preferredRoute : undefined,
-      fallbackRisk: hasSubscription && hasApiKey ? 'Both subscription and API key are present; check route priority.' : undefined,
-      expiresAt: subscription?.expiresAt,
-      tokenType: subscription?.tokenType,
-      notes,
-      usageWindows,
-      issues,
-      recommendedActions,
-      routeRecords,
-    };
-  }));
-
-  return {
-    capturedAt: Date.now(),
-    providers,
-    configuredCount: providers.filter((provider) => provider.configured).length,
-    issueCount: providers.reduce((sum, provider) => sum + provider.issues.length, 0),
-  };
-}