export declare enum SetupError {
    GH_NOT_INSTALLED = "GH_NOT_INSTALLED",
    GH_NOT_AUTHENTICATED = "GH_NOT_AUTHENTICATED",
    SOPS_NOT_INSTALLED = "SOPS_NOT_INSTALLED",
    AGE_NOT_INSTALLED = "AGE_NOT_INSTALLED",
    AGE_KEY_MISSING = "AGE_KEY_MISSING",
    REPO_CLONE_FAILED = "REPO_CLONE_FAILED",
    REPO_PUSH_FAILED = "REPO_PUSH_FAILED",
    SOPS_DECRYPT_FAILED = "SOPS_DECRYPT_FAILED",
    NETWORK_UNREACHABLE = "NETWORK_UNREACHABLE",
    BREW_NOT_AVAILABLE = "BREW_NOT_AVAILABLE",
    PERMISSION_DENIED = "PERMISSION_DENIED"
}
export interface ErrorGuide {
    error: SetupError;
    userMessage: string;
    autoFixCommand?: string;
    manualFixSteps: string[];
    docUrl?: string;
}
/**
 * Get the guide for a specific setup error.
 */
export declare function getErrorGuide(error: SetupError): ErrorGuide;
/**
 * Format an error guide as a user-friendly string for CON/terminal output.
 */
export declare function formatErrorGuide(error: SetupError): string;
/**
 * Classify an error from a catch block into a SetupError.
 */
export declare function classifyError(err: unknown, context?: string): SetupError | null;