import type { WorkspaceKitProfile } from "./profile-support.js";
import type { InitProjectDetection } from "./init-detection.js";
export type InitMode = "fresh-install" | "already-initialized" | "partial-repair";
export type PlannedWriteKind = "create" | "update" | "preserve" | "skip-conflict";
export type PlannedWrite = {
    path: string;
    kind: PlannedWriteKind;
    reason: string;
};
export type InitPlan = {
    schemaVersion: 1;
    mode: InitMode;
    detection: InitProjectDetection;
    synthesizedProfile: WorkspaceKitProfile;
    profileValidationErrors?: string[];
    plannedWrites: PlannedWrite[];
    warnings: string[];
    notes: string[];
};
export type BuildInitPlanOptions = {
    /** Reserved for future hints (e.g. repair-only). */
    force?: boolean;
};
/**
 * Build a dry-run init plan: modes, warnings, and planned kit-owned paths (no I/O writes).
 */
export declare function buildInitPlan(cwd: string, detection: InitProjectDetection, _options?: BuildInitPlanOptions): Promise<InitPlan>;
