@thinkrun/cli 0.1.27

package/dist/src/commands/doctor.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Diagnostic command for local/cloud endpoint clarity.
+ * Reflects effective command-path health: warns when routing would fail.
+ */
+import { Command } from 'commander';
+import { readBridgePort as _readBridgePort } from '../utils.js';
+import { type NativeHostManifestInspectionEntry } from './install.js';
+import { getSessionContext } from '../session/context.js';
+/** Prefix used by the native-host circuit breaker when setting lastDisconnectReason. */
+export declare const CIRCUIT_BREAKER_REASON_PREFIX = "Circuit breaker:";
+type CheckResult = {
+    ok: boolean;
+    message: string;
+    extensionConnected?: boolean;
+    lastDisconnectReason?: string;
+    recoveryState?: 'healthy' | 'flapping' | 'recently_recovered' | 'recovering' | 'circuit_breaker_open' | 'disconnected';
+    recentDisconnectCount?: number;
+    lastRecoveredAt?: string;
+    /** true = CB trip; false = other disconnect reason; undefined = extension connected OR disconnected with no reason field. */
+    isCircuitBreakerTrip?: boolean;
+};
+export type DoctorExtensionIdSource = 'flag' | 'config' | 'env' | 'default' | 'registered';
+export type ManifestRegistrationIssue = 'missing' | 'parse_error' | 'wrong_id' | 'inconsistent' | null;
+export declare function getManifestRegistrationIssue(opts: {
+    manifestExtensionIds: string[] | null;
+    manifestEntries?: NativeHostManifestInspectionEntry[] | null;
+    registeredExtensionId?: string;
+    effectiveExtensionId: string;
+}): ManifestRegistrationIssue;
+export declare function hasExtensionRegistrationMismatch(opts: {
+    manifestExtensionIds: string[] | null;
+    manifestEntries?: NativeHostManifestInspectionEntry[] | null;
+    registeredExtensionId?: string;
+    effectiveExtensionId: string;
+}): boolean;
+export declare function resolveDoctorExtensionId(opts: {
+    resolvedExtensionId: {
+        extensionId: string;
+        source: DoctorExtensionIdSource;
+    };
+    registeredExtensionId?: string;
+    preferPackagedDefaultExtensionId?: boolean;
+    manifestExtensionIds?: string[] | null;
+    manifestParseStatus?: 'parsed' | 'unavailable' | 'parse_error';
+    manifestExists?: boolean | null;
+}): {
+    extensionId: string;
+    source: DoctorExtensionIdSource;
+};
+type HealthFetch = typeof fetch;
+export declare const DEFAULT_BRIDGE_PORT = 3012;
+export declare const readBridgePort: typeof _readBridgePort;
+export declare function checkHealth(url: string, apiKey?: string, fetchFn?: HealthFetch): Promise<CheckResult>;
+export type DisconnectState = 'daemon_down' | 'socket_down' | 'socket_up_tab_gone' | 'socket_state_unknown' | 'breaker_open';
+export type DisconnectDiagnosis = {
+    state: DisconnectState;
+    hint: string;
+};
+/**
+ * Classify the current disconnect state into one of four mutually exclusive buckets.
+ *
+ * Priority order (highest to lowest):
+ *   daemon_down > breaker_open > socket_down > socket_up_tab_gone
+ */
+export declare function classifyDisconnectState(opts: {
+    daemonReachable: boolean;
+    extensionSocketConnected: boolean | undefined;
+    tabReadiness: 'unknown' | 'ready' | 'gone' | undefined;
+    isBreakerOpen: boolean;
+}): DisconnectDiagnosis;
+export declare function getExtensionDisconnectHint(result: Pick<CheckResult, 'extensionConnected' | 'isCircuitBreakerTrip' | 'recoveryState' | 'recentDisconnectCount'>, disconnectStateOpts?: {
+    daemonReachable: boolean;
+    extensionSocketConnected: boolean | undefined;
+    tabReadiness: 'unknown' | 'ready' | 'gone' | undefined;
+    isBreakerOpen: boolean;
+}): string | null;
+export type SuggestedNextStepOptions = {
+    apiKey: string | undefined;
+    localEndpoint: boolean;
+    apiHealthOk: boolean;
+    activeLocalTabId?: string;
+    activeCloudSessionId?: string;
+    activeSessionId: string | undefined;
+    bridgeRelevant?: boolean;
+    bridgeHealthOk?: boolean;
+    commandPathOk?: boolean;
+    extensionConnected?: boolean;
+    isCircuitBreakerTrip?: boolean;
+    recoveryState?: CheckResult['recoveryState'];
+    recentDisconnectCount?: number;
+    configuredExtensionId?: string;
+    extensionIdSource?: DoctorExtensionIdSource;
+    manifestMismatch?: boolean;
+    manifestIssue?: ManifestRegistrationIssue;
+    manifestParseStatus?: 'parsed' | 'unavailable' | 'parse_error';
+};
+export declare function getSuggestedNextStep(opts: SuggestedNextStepOptions): string;
+export type DaemonStatus = 'up' | 'down' | 'orphaned' | 'mismatch';
+export interface DaemonDoctorResult {
+    /** Whether the daemon section should be shown at all */
+    show: boolean;
+    status: DaemonStatus;
+    port?: number;
+    protocolVersion?: number;
+    binaryVersion?: string;
+    pid?: number;
+    /** True when bun is not found on PATH (daemon requires bun) */
+    bunMissing: boolean;
+    /** flagOwnerMismatch: daemon.json owner=native but localTransport=daemon, or vice-versa */
+    flagOwnerMismatch: boolean;
+}
+/** Check whether `bun` is available on PATH. */
+export declare function isBunAvailable(): boolean;
+/**
+ * Inspect daemon state for the doctor section.
+ * Only shown when localTransport=daemon OR daemon.json exists.
+ */
+export declare function checkDaemonDoctor(): Promise<DaemonDoctorResult>;
+export type DoctorSessionDisplay = {
+    activeLocalTab: string;
+    activeCloudSession: string;
+    activeSessionSummary: string;
+};
+export declare function getDoctorSessionDisplay(activeSessionId: string | undefined, sessionContext?: ReturnType<typeof getSessionContext>): DoctorSessionDisplay;
+export declare function createDoctorCommand(): Command;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/src/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor.ts"],"names":[],"mappings":"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"}