/** Canonical progress record written to .forge/init-progress.json */
export interface InitProgress {
    lastPhase: 1 | 2 | 3 | 4;
    timestamp: string;
}
export type ReadProgressResult = {
    kind: "none";
} | {
    kind: "stale";
    reason: string;
} | {
    kind: "malformed";
} | {
    kind: "valid";
    progress: InitProgress;
};
/**
 * Read the init-progress checkpoint file.
 *
 * Returns:
 *   - `{ kind: "none" }` — file does not exist
 *   - `{ kind: "malformed" }` — file exists but JSON parse failed
 *   - `{ kind: "stale", reason }` — file is a legacy 12-phase checkpoint
 *   - `{ kind: "valid", progress }` — clean 4-phase checkpoint
 */
export declare function readInitProgress(cwd: string): ReadProgressResult;
/**
 * Write a progress checkpoint. Called at the end of each completed phase.
 *
 * @param cwd - project working directory
 * @param lastPhase - completed phase number (1, 2, or 3; 4 is written then deleted)
 * @param timestamp - ISO 8601 timestamp; defaults to now
 */
export declare function writeInitProgress(cwd: string, lastPhase: 1 | 2 | 3 | 4, timestamp?: string): void;
/**
 * Delete the init-progress checkpoint. Called at the end of Phase 4
 * to signal successful completion.
 */
export declare function deleteInitProgress(cwd: string): void;