import type { OnboardingStage } from './onboardingStage.js';
export interface CodexSetupFailureDiagnostic {
    readonly schema: 'dharma.codex-setup-failure-diagnostic/v1';
    readonly stage: OnboardingStage | 'bootstrap' | 'completion';
    readonly category: string;
}
export type CodexSetupFailureObserver = (failure: Readonly<CodexSetupFailureDiagnostic>) => void;
/** Fixed classifications only: no messages, causes, commands or private values leave this function. */
export declare function classifyCodexSetupFailure(error: unknown, fallback: 'bootstrap' | 'completion'): Readonly<CodexSetupFailureDiagnostic>;
export declare function reportCodexSetupFailure(observer: CodexSetupFailureObserver | undefined, error: unknown, fallback: 'bootstrap' | 'completion'): void;
//# sourceMappingURL=codexSetupDiagnostic.d.ts.map