import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
import { type ForgeToolDefs } from "../forge-tools.js";
export interface ParsedMigrateArgs {
    /** True when --structural flag present OR .forge/structure-versions.json absent. */
    structural: boolean;
    /** True when --dry-run flag present (schema branch only). */
    dryRun: boolean;
}
/**
 * Parse /forge:migrate arguments.
 *
 * Also checks filesystem for .forge/structure-versions.json to determine
 * structural vs schema branch (absence → structural).
 */
export declare function parseMigrateArgs(args: string, cwd: string): ParsedMigrateArgs;
export interface RegisterMigrateOptions {
    /** Override bundleRoot — for testing only. Production: always undefined (resolved via getBundledPayloadRoot). */
    _testBundleRoot?: string;
    /** Forge tool definitions for subagent injection. */
    forgeToolDefs?: ForgeToolDefs;
}
export declare function registerMigrate(pi: ExtensionAPI, opts?: RegisterMigrateOptions): void;