@phnx-labs/agents-cli 1.20.78 → 1.20.83

package/dist/commands/doctor.d.ts

@@ -23,6 +23,10 @@
  */
 import type { Command } from 'commander';
 import { type FleetDivergenceReport } from '../lib/devices/fleet-divergence.js';
+import { type VersionResourceReport } from '../lib/doctor-diff.js';
+import { type DuplicateVersionHook } from '../lib/hooks.js';
+import { type SyncStatusRow, type OrphanRow } from '../lib/drift.js';
+import { type FetchStatusMarker } from '../lib/auto-pull.js';
 export declare function wrapLine(prefix: string, text: string, width?: number): string[];
 /**
  * Windows-only advisory lines. When the effective PowerShell execution policy
@@ -42,4 +46,66 @@ export declare function execPolicyWarningLines(platform: NodeJS.Platform, policy
  * couldn't be compared (offline / older CLI) are named so the readout is honest.
  */
 export declare function renderFleetDivergence(report: FleetDivergenceReport): string[];
+export type IssueSeverity = 'critical' | 'warning' | 'info';
+/**
+ * One triaged health finding. `severity`/`category`/`subject`/`impact`/`fix` are
+ * the triage backbone the human report renders and `--json` carries; `text`/`color`
+ * stay the terse combined label older readers used, so the shape is additive.
+ *
+ * Severity model (agent-agnostic — applies to every agent doctor inspects):
+ *   - critical (silent breakage): an unwired hook, a missing/unparseable
+ *     settings.json, a MISSING resource.
+ *   - warning (stale / drift): a source layer behind origin, a DIVERGENT resource,
+ *     a stale / never-synced version.
+ *   - info (orphan): an EXTRA resource → `agents prune cleanup`.
+ */
+export interface VerdictIssue {
+    severity: IssueSeverity;
+    /** machine-stable class: unwired-hook | settings-missing | settings-unparseable
+     *  | missing | source-behind | divergent | extra | stale | never-synced | orphan */
+    category: string;
+    /** the hook / resource / layer / version the finding is about */
+    subject: string;
+    /** one-line plain-English consequence */
+    impact: string;
+    /** exact remediation command */
+    fix: string;
+    /** terse combined label (legacy) */
+    text: string;
+    color: 'yellow' | 'red' | 'magenta';
+}
+export interface DoctorVerdict {
+    healthy: boolean;
+    issues: VerdictIssue[];
+    /** Resources (target) / versions (overview) reconciled clean — drives the
+     *  healthy line's count. */
+    reconciled: number;
+}
+export declare function verdictIsAutoFixable(v: DoctorVerdict): boolean;
+/**
+ * Fold a version report's divergences into a triaged verdict — one severity-tagged
+ * finding per unwired hook, missing/divergent/extra resource, and behind-origin
+ * source layer, each carrying its subject, plain-English impact, and exact fix. An
+ * UNWIRED hook or a stale source is as unhealthy as a divergent file, not a
+ * footnote. Pure so the health rollup is unit-testable without a version home.
+ */
+export declare function computeVerdict(report: VersionResourceReport): DoctorVerdict;
+/**
+ * Build the lines of a triaged health block: a single green ✓ line when healthy,
+ * otherwise a severity-counted ✗ header followed by one row per finding (icon ·
+ * severity · subject — impact, then the exact fix under it) and an optional heal
+ * footer. Pure — returns the lines so the rendered output is unit-testable. Shared
+ * by target mode and the bare overview so both read the same way.
+ */
+export declare function healthBlockLines(verdict: DoctorVerdict, opts: {
+    healthySummary: string;
+    healFix?: string;
+}): string[];
+/**
+ * Aggregate the bare `agents doctor` overview into the same triaged verdict target
+ * mode uses — folding per-version wiring/sync drift, behind-origin source layers,
+ * and orphan resources into severity-tagged findings. Agent-agnostic: every
+ * installed version is classified the same way. Pure, so it is unit-testable.
+ */
+export declare function computeOverviewHealth(syncRows: SyncStatusRow[], orphanRows: OrphanRow[], repoBehindMarkers: FetchStatusMarker[], duplicateHooks?: DuplicateVersionHook[]): DoctorVerdict;
 export declare function registerDoctorCommand(program: Command): void;