/**
 * Boulder State Types
 *
 * Manages the active work plan state for Sisyphus orchestrator.
 * Named after Sisyphus's boulder - the eternal task that must be rolled.
 */
export interface BoulderState {
    schema_version?: 2;
    active_work_id?: string;
    works?: Record<string, BoulderWorkState>;
    /** Absolute path to the active plan file */
    active_plan: string;
    /** ISO timestamp when work started */
    started_at: string;
    ended_at?: string;
    elapsed_ms?: number;
    status?: BoulderWorkStatus;
    updated_at?: string;
    /** Session IDs that have worked on this plan */
    session_ids: string[];
    session_origins?: Record<string, "direct" | "appended">;
    /** Plan name derived from filename */
    plan_name: string;
    /** Agent type to use when resuming (e.g., 'atlas') */
    agent?: string;
    /** Absolute path to the git worktree root where work happens */
    worktree_path?: string;
    /** Preferred reusable subagent sessions keyed by current top-level plan task */
    task_sessions?: Record<string, TaskSessionState>;
}
export type BoulderSessionOrigin = "direct" | "appended";
export type BoulderWorkStatus = "active" | "completed" | "paused" | "abandoned";
export type BoulderTaskStatus = "running" | "completed" | "cancelled";
export interface BoulderWorkState {
    work_id: string;
    active_plan: string;
    plan_name: string;
    status?: BoulderWorkStatus;
    started_at: string;
    ended_at?: string;
    elapsed_ms?: number;
    updated_at?: string;
    session_ids: string[];
    session_origins?: Record<string, BoulderSessionOrigin>;
    agent?: string;
    worktree_path?: string;
    task_sessions?: Record<string, TaskSessionState>;
}
export interface PlanProgress {
    /** Total number of checkboxes */
    total: number;
    /** Number of completed checkboxes */
    completed: number;
    /** Whether all tasks are done */
    isComplete: boolean;
}
export interface TaskSessionState {
    /** Stable identifier for the current top-level plan task (e.g. todo:1 / final-wave:F1) */
    task_key: string;
    /** Original task label from the plan file */
    task_label: string;
    /** Full task title from the plan file */
    task_title: string;
    /** Preferred reusable subagent session */
    session_id: string;
    /** Agent associated with the task session, when known */
    agent?: string;
    /** Category associated with the task session, when known */
    category?: string;
    started_at?: string;
    ended_at?: string;
    elapsed_ms?: number;
    status?: BoulderTaskStatus;
    /** Last update timestamp */
    updated_at: string;
}
export interface BoulderWorkResumeOption {
    work_id: string;
    plan_name: string;
    active_plan: string;
    worktree_path?: string;
    status: BoulderWorkStatus;
    started_at: string;
    updated_at: string;
    ended_at?: string;
    elapsed_ms?: number;
    session_count: number;
    progress: PlanProgress;
    is_current_mirror: boolean;
}
export interface TopLevelTaskRef {
    /** Stable identifier for the current top-level plan task */
    key: string;
    /** Task section in the Prometheus plan */
    section: "todo" | "final-wave";
    /** Original label token (e.g. 1 / F1) */
    label: string;
    /** Full task title extracted from the checkbox line */
    title: string;
}