/**
 * Doctor utility functions - ported from lib/validation/doctor-utils.sh
 *
 * Functions for project categorization, health summaries, journey stage
 * detection, and guidance generation.
 *
 * @task T4525
 * @epic T4454
 */
export interface ProjectDetail {
    name: string;
    path: string;
    status: 'healthy' | 'warning' | 'failed' | 'orphaned';
    issues?: string[];
    isTemp: boolean;
    isOrphaned?: boolean;
    reason?: string;
}
export interface CategorizedProjects {
    active: ProjectDetail[];
    temp: ProjectDetail[];
    orphaned: ProjectDetail[];
}
export type UserJourneyStage = 'new-user' | 'cleanup-needed' | 'setup-agents-needed' | 'maintenance-mode';
/**
 * Check if a project path is a temporary/test directory.
 * @task T4525
 */
export declare function isTempProject(path: string): boolean;
/**
 * Filter projects into categories: active, temp, orphaned.
 * @task T4525
 */
export declare function categorizeProjects(projects: ProjectDetail[]): CategorizedProjects;
/**
 * Get human-readable project category name.
 * @task T4525
 */
export declare function getProjectCategoryName(category: 'active' | 'temp' | 'orphaned'): string;
export interface HealthSummary {
    total: number;
    healthy: number;
    warnings: number;
    failed: number;
    orphaned: number;
    temp: number;
}
/**
 * Format project health summary for display.
 * @task T4525
 */
export declare function formatProjectHealthSummary(summary: HealthSummary): string;
/**
 * Get actionable guidance for project issues.
 * @task T4525
 */
export declare function getProjectGuidance(activeFailed: number, activeWarnings: number, tempCount: number, orphanedCount: number): string[];
/**
 * Check user journey stage based on system state.
 * @task T4525
 */
export declare function getUserJourneyStage(hasProjects: boolean, tempProjectCount: number, agentConfigsOk: boolean): UserJourneyStage;
/**
 * Get journey-specific guidance text.
 * @task T4525
 */
export declare function getJourneyGuidance(stage: UserJourneyStage): string[];
//# sourceMappingURL=utils.d.ts.map