export interface GoalAdvanceOptions {
    /** Directory containing goal state files (e.g., `.aiws/goals/`) */
    goalDir: string;
    /** Optional goal ID. If omitted, auto-detect active goal */
    goalId?: string;
    /** Target phase to advance to. If omitted, auto-detect next phase */
    phase?: string;
    /** If true, only show what would change without writing */
    dryRun?: boolean;
    /** If true, output structured JSON for AI consumption */
    json?: boolean;
    /**
     * If true, heal dirty state (or migrate missing state.json from active .md)
     * before advancing. Sole writer path for dirty recovery (contract §10).
     */
    heal?: boolean;
}
export interface GoalAdvanceResult {
    ok: boolean;
    goalId: string;
    previousPhase: string | null;
    currentPhase: string | null;
    status: "active" | "complete" | "blocked" | "error" | "healed";
    done: boolean;
    nextActions: {
        phase: string;
        description: string;
        needsUserInput: boolean;
        blockers: string[];
    } | null;
    currentGroup: string | null;
    message: string;
    healed?: boolean;
    healActions?: string[];
}
/**
 * `aiws goal advance` — sole phase-boundary writer for goal state.json (TOOLING-003D / §10).
 *
 * Completes the current phase (if in_progress), then advances to the next phase.
 * Skills/commands MUST call this at each phase boundary; they must not hand-edit
 * checkpoint status / current_phase / status fields.
 */
export declare function goalAdvanceCommand(options: GoalAdvanceOptions): Promise<{
    ok: boolean;
    output: string;
}>;