/**
 * v1 -> v2 skaile.yaml migration utility.
 *
 * Detects a v1 workspace config (no `version` field) and upgrades it to v2.
 * The upgrade is non-destructive: all existing v1 fields are preserved and
 * the only structural change is adding `version: 2`.
 *
 * @docLink packages/library/api-reference#migration
 */
/**
 * Result returned by {@link migrateWorkspaceConfig}.
 *
 * @docLink packages/library/api-reference#migration
 */
export interface MigrationResult {
    /** Whether the file was actually modified (false in dry-run or already v2). */
    migrated: boolean;
    /** Detected version after migration (or current version if no migration). */
    version: 1 | 2;
    /** Human-readable warnings about v1 patterns that need manual attention. */
    warnings: string[];
}
/**
 * Check if a workspace config needs migration and optionally perform it.
 *
 * The upgrade preserves all existing YAML content (including comments) and
 * inserts `version: 2` at the top of the document.
 *
 * @param dir - Directory containing skaile.yaml.
 * @param opts - `dryRun` to check without writing; `filename` to override the default filename.
 * @returns Migration result with `migrated` flag and any v1-pattern warnings.
 * @docLink packages/library/api-reference#migration
 */
export declare function migrateWorkspaceConfig(dir: string, opts?: {
    dryRun?: boolean;
    filename?: string;
}): MigrationResult;
//# sourceMappingURL=migration.d.ts.map