export declare const ULTRAGOAL_DIR = ".omx/ultragoal";
export declare const ULTRAGOAL_BRIEF = "brief.md";
export declare const ULTRAGOAL_GOALS = "goals.json";
export declare const ULTRAGOAL_LEDGER = "ledger.jsonl";
export type UltragoalStatus = 'pending' | 'in_progress' | 'complete' | 'failed' | 'review_blocked' | 'needs_user_decision';
export type UltragoalCodexGoalMode = 'aggregate' | 'per_story';
export type UltragoalSteeringStatus = 'superseded' | 'blocked';
export type UltragoalSteeringMutationKind = 'add_subgoal' | 'split_subgoal' | 'reorder_pending' | 'revise_pending_wording' | 'annotate_ledger' | 'mark_blocked_superseded';
export type UltragoalSteeringSource = 'user_prompt_submit' | 'finding' | 'cli';
export declare const ULTRAGOAL_STEERING_MUTATION_KINDS: readonly UltragoalSteeringMutationKind[];
export declare const ULTRAGOAL_STEERING_SOURCES: readonly UltragoalSteeringSource[];
export interface UltragoalSteeringInvariantResult {
    accepted: boolean;
    structuralInvariantAccepted: boolean;
    evidenceBackedNecessity: boolean;
    noEasierCompletion: boolean;
    rejectedReasons: string[];
    reasons?: string[];
}
export interface UltragoalSteeringChildGoal {
    title: string;
    objective: string;
    tokenBudget?: number;
}
export interface UltragoalSteeringAfterPayload {
    title?: string;
    objective?: string;
    pendingGoalIds?: string[];
    children?: UltragoalSteeringChildGoal[];
}
export interface UltragoalSteeringProposal {
    kind: UltragoalSteeringMutationKind;
    source: UltragoalSteeringSource;
    targetGoalId?: string;
    targetGoalIds?: string[];
    evidence: string;
    rationale: string;
    title?: string;
    objective?: string;
    childGoals?: UltragoalSteeringChildGoal[];
    revisedTitle?: string;
    revisedObjective?: string;
    pendingOrder?: string[];
    blockedReason?: string;
    after?: UltragoalSteeringAfterPayload;
    directiveText?: string;
    promptSignature?: string;
    idempotencyKey?: string;
    now?: Date;
}
export interface UltragoalSteeringAudit {
    kind: UltragoalSteeringMutationKind;
    source: UltragoalSteeringSource;
    targetGoalIds: string[];
    before?: unknown;
    after?: unknown;
    evidence: string;
    rationale: string;
    invariant: UltragoalSteeringInvariantResult;
    directiveText?: string;
    promptSignature?: string;
    idempotencyKey?: string;
    deduped?: boolean;
}
export interface SteerUltragoalResult {
    plan: UltragoalPlan;
    accepted: boolean;
    audit: UltragoalSteeringAudit;
    rejectedReasons: string[];
    deduped: boolean;
}
export interface UltragoalItem {
    id: string;
    title: string;
    objective: string;
    status: UltragoalStatus;
    tokenBudget?: number;
    attempt: number;
    createdAt: string;
    updatedAt: string;
    startedAt?: string;
    completedAt?: string;
    failedAt?: string;
    reviewBlockedAt?: string;
    evidence?: string;
    failureReason?: string;
    steeringStatus?: UltragoalSteeringStatus;
    supersededBy?: string[];
    supersedes?: string[];
    blockedReason?: string;
    blockerSignature?: string;
    blockerOccurrenceCount?: number;
    requiredExternalDecision?: string;
    nonRetriable?: boolean;
    steeringEvidence?: string;
    steeringRationale?: string;
}
export interface UltragoalAggregateCompletion {
    status: 'complete';
    completedAt: string;
    evidence: string;
    codexGoal?: unknown;
}
export interface UltragoalPlan {
    version: 1;
    createdAt: string;
    updatedAt: string;
    briefPath: string;
    goalsPath: string;
    ledgerPath: string;
    codexGoalMode?: UltragoalCodexGoalMode;
    codexObjective?: string;
    codexObjectiveAliases?: string[];
    aggregateCompletion?: UltragoalAggregateCompletion;
    activeGoalId?: string;
    goals: UltragoalItem[];
}
export interface UltragoalLedgerEntry {
    ts: string;
    event: 'plan_created' | 'goal_started' | 'goal_resumed' | 'goal_completed' | 'goal_blocked' | 'goal_failed' | 'goal_needs_user_decision' | 'goal_retried' | 'aggregate_completed' | 'aggregate_objective_migrated' | 'goal_added' | 'steering_accepted' | 'steering_rejected' | 'final_review_failed' | 'goal_review_blocked';
    goalId?: string;
    status?: UltragoalStatus;
    message?: string;
    codexGoal?: unknown;
    evidence?: string;
    qualityGate?: UltragoalQualityGate;
    steering?: UltragoalSteeringAudit;
    before?: unknown;
    after?: unknown;
    mutationKind?: UltragoalSteeringMutationKind;
    idempotencyKey?: string;
    blockerSignature?: string;
    blockerOccurrenceCount?: number;
    requiredExternalDecision?: string;
}
export interface CreateUltragoalOptions {
    brief: string;
    goals?: Array<{
        title?: string;
        objective: string;
        tokenBudget?: number;
    }>;
    codexGoalMode?: UltragoalCodexGoalMode;
    now?: Date;
    force?: boolean;
}
export interface StartNextOptions {
    now?: Date;
    retryFailed?: boolean;
}
export interface CheckpointOptions {
    goalId: string;
    status: Extract<UltragoalStatus, 'complete' | 'failed'> | 'blocked';
    evidence?: string;
    codexGoal?: unknown;
    qualityGate?: unknown;
    allowActiveFinalCodexGoal?: boolean;
    now?: Date;
}
export interface AddUltragoalGoalOptions {
    title: string;
    objective: string;
    evidence?: string;
    now?: Date;
}
export interface RecordFinalReviewBlockersOptions extends AddUltragoalGoalOptions {
    goalId: string;
    codexGoal?: unknown;
}
export interface UltragoalQualityGate {
    aiSlopCleaner: {
        status: 'passed';
        evidence: string;
    };
    verification: {
        status: 'passed';
        commands: string[];
        evidence: string;
    };
    codeReview: {
        recommendation: 'APPROVE';
        architectStatus: 'CLEAR';
        evidence: string;
    };
}
export declare class UltragoalError extends Error {
}
export declare function ultragoalDir(cwd: string): string;
export declare function ultragoalBriefPath(cwd: string): string;
export declare function ultragoalGoalsPath(cwd: string): string;
export declare function ultragoalLedgerPath(cwd: string): string;
export declare const ULTRAGOAL_AGGREGATE_CODEX_OBJECTIVE = "Complete the durable ultragoal plan in .omx/ultragoal/goals.json, including later accepted/appended stories, under the original brief constraints; use .omx/ultragoal/ledger.jsonl as the audit trail.";
export declare function isFinalRunCompletionCandidate(plan: UltragoalPlan, goal: UltragoalItem): boolean;
export declare function isUltragoalDone(plan: UltragoalPlan): boolean;
export declare function deriveGoalCandidates(brief: string): Array<{
    title: string;
    objective: string;
}>;
export declare function readUltragoalPlan(cwd: string): Promise<UltragoalPlan>;
export declare function createUltragoalPlan(cwd: string, options: CreateUltragoalOptions): Promise<UltragoalPlan>;
export declare function summarizeUltragoalPlan(plan: UltragoalPlan): {
    total: number;
    pending: number;
    inProgress: number;
    complete: number;
    failed: number;
    reviewBlocked: number;
    needsUserDecision: number;
    superseded: number;
    steeringBlocked: number;
    aggregateComplete: boolean;
    activeGoalId?: string;
};
export declare function parseUltragoalSteeringDirective(raw: string): UltragoalSteeringProposal | null;
export declare function addUltragoalGoal(cwd: string, options: AddUltragoalGoalOptions): Promise<{
    plan: UltragoalPlan;
    goal: UltragoalItem;
}>;
export declare function validateUltragoalSteeringProposal(plan: UltragoalPlan, proposal: UltragoalSteeringProposal): UltragoalSteeringInvariantResult;
export declare const validateSteeringProposal: typeof validateUltragoalSteeringProposal;
export declare function steerUltragoal(cwd: string, proposal: UltragoalSteeringProposal, options?: {
    now?: Date;
    directiveText?: string;
}): Promise<SteerUltragoalResult>;
export declare function startNextUltragoal(cwd: string, options?: StartNextOptions): Promise<{
    plan: UltragoalPlan;
    goal: UltragoalItem | null;
    resumed: boolean;
    done: boolean;
}>;
export declare function checkpointUltragoal(cwd: string, options: CheckpointOptions): Promise<UltragoalPlan>;
export declare function recordFinalReviewBlockers(cwd: string, options: RecordFinalReviewBlockersOptions): Promise<{
    plan: UltragoalPlan;
    blockedGoal: UltragoalItem;
    addedGoal: UltragoalItem;
}>;
export declare function buildCodexGoalInstruction(goal: UltragoalItem, plan: UltragoalPlan): string;
//# sourceMappingURL=artifacts.d.ts.map