import { type ResolvedScope } from '../roster.js';
export interface OracleError {
    error: string;
    message: string;
    hint?: string;
}
export declare function isOracleError(result: unknown): result is OracleError;
export type Priority = 'low' | 'med' | 'high';
export interface NextActionsInput {
    projectId?: string;
    focus?: string;
    /** EPIC-0040: scope to one person's or agent's issues and epics. */
    assignee?: string;
    /** EPIC-0040: scope to one team's issues and epics. */
    team?: string;
}
export interface Action {
    description: string;
    source: string;
    priority: Priority;
    domain?: 'designer' | 'architect' | 'sentinel' | 'friction';
    location?: 'project' | 'global';
}
export interface NextActionsOutput {
    actions: Action[];
    friction_summary?: {
        total_open: number;
        high_signal: number;
        blocking: number;
    };
    data_locations: {
        project_local: boolean;
        global: boolean;
    };
    /** Present on a scoped call: only that scope's issues and epics are listed. */
    scope?: ResolvedScope;
}
export declare function nextActions(input: NextActionsInput): Promise<NextActionsOutput | OracleError>;
export interface RoadmapInput {
    projectId?: string;
    dryRun?: boolean;
    noSignals?: boolean;
}
export interface MilestoneProgress {
    id: string;
    label: string;
    target_date: string;
    epics_total: number;
    epics_completed: number;
    epics_in_progress: number;
    epics_blocked: number;
    progress_percent: number;
    status: 'on_track' | 'at_risk' | 'behind' | 'completed';
    days_remaining: number;
}
export interface ObjectiveProgress {
    id: string;
    title: string;
    timeframe: string;
    key_results: Array<{
        metric: string;
        target: string;
        current?: string;
        progress_percent?: number;
    }>;
    overall_progress: number;
}
export interface EpicStatus {
    epic_id: string;
    status: 'not_started' | 'in_progress' | 'completed' | 'blocked';
    issue_count: number;
    open_issues: number;
    health_score?: number;
    risk_flags?: string[];
}
export interface RoadmapOutput {
    project_id: string;
    evaluated_at: string;
    milestones: MilestoneProgress[];
    objectives: ObjectiveProgress[];
    epics: EpicStatus[];
    signals?: {
        blocking_issues: number;
        high_severity_issues: number;
        friction_points: number;
    };
    summary: {
        total_milestones: number;
        on_track: number;
        at_risk: number;
        behind: number;
        completed: number;
    };
    progress_file?: string;
    /** Non-fatal warnings (e.g. shadow roadmap files detected). */
    warnings?: string[];
}
export declare function roadmapProgress(input: RoadmapInput): Promise<RoadmapOutput | OracleError>;
//# sourceMappingURL=oracle.d.ts.map