@wp-typia/project-tools 0.16.11 → 0.16.13

package/dist/runtime/migrations.js

@@ -1,153 +1,19 @@
 import fs from "node:fs";
 import path from "node:path";
-import { execFileSync } from "node:child_process";
 import { createReadlinePrompt } from "./cli-prompt.js";
+import { formatMigrationHelpText, parseMigrationArgs, parseNonNegativeInteger, parsePositiveInteger, } from "./migration-command-surface.js";
 import { formatRunScript } from "./package-managers.js";
-import { ROOT_PHP_MIGRATION_REGISTRY, SNAPSHOT_DIR, } from "./migration-constants.js";
+import { SNAPSHOT_DIR, } from "./migration-constants.js";
 import { createMigrationDiff } from "./migration-diff.js";
-import { createMigrationFuzzPlan } from "./migration-fuzz-plan.js";
-import { createEdgeFixtureDocument, ensureEdgeFixtureFile } from "./migration-fixtures.js";
-import { assertRuleHasNoTodos, assertNoLegacySemverMigrationWorkspace, discoverMigrationInitLayout, discoverMigrationEntries, ensureAdvancedMigrationProject, ensureMigrationDirectories, getFixtureFilePath, getAvailableSnapshotVersionsForBlock, getGeneratedDirForBlock, getProjectPaths, getRuleFilePath, getSnapshotBlockJsonPath, getSnapshotManifestPath, getSnapshotRoot, getSnapshotSavePath, loadMigrationProject, readRuleMetadata, writeInitialMigrationScaffold, writeMigrationConfig, } from "./migration-project.js";
-import { formatDiffReport, renderFuzzFile, renderGeneratedDeprecatedFile, renderGeneratedMigrationIndexFile, renderMigrationRegistryFile, renderMigrationRuleFile, renderPhpMigrationRegistryFile, renderVerifyFile, } from "./migration-render.js";
+import { ensureEdgeFixtureFile } from "./migration-fixtures.js";
+import { regenerateGeneratedArtifacts, } from "./migration-generated-artifacts.js";
+import { assertDistinctMigrationEdge, createMigrationPlanNextSteps, createMissingProjectSnapshotMessage, formatEdgeCommand, hasSnapshotForVersion, listPreviewableLegacyVersions, resolveLegacyVersions, } from "./migration-planning.js";
+import { assertNoLegacySemverMigrationWorkspace, discoverMigrationInitLayout, ensureAdvancedMigrationProject, ensureMigrationDirectories, getProjectPaths, getRuleFilePath, getSnapshotBlockJsonPath, getSnapshotManifestPath, getSnapshotRoot, getSnapshotSavePath, loadMigrationProject, writeInitialMigrationScaffold, writeMigrationConfig, } from "./migration-project.js";
+import { formatDiffReport, renderMigrationRuleFile, } from "./migration-render.js";
 import { createMigrationRiskSummary, formatMigrationRiskSummary } from "./migration-risk.js";
-import { assertMigrationVersionLabel, compareMigrationVersionLabels, copyFile, detectPackageManagerId, formatLegacyMigrationWorkspaceResetGuidance, getLocalTsxBinary, isInteractiveTerminal, readJson, resolveTargetMigrationVersion, runProjectScriptIfPresent, sanitizeSaveSnapshotSource, sanitizeSnapshotBlockJson, } from "./migration-utils.js";
-import { readWorkspaceInventory } from "./workspace-inventory.js";
-import { getInvalidWorkspaceProjectReason, tryResolveWorkspaceProject } from "./workspace-project.js";
-/**
- * Returns the formatted help text for migration CLI commands and flags.
- *
- * @returns Multi-line usage text for the `wp-typia migrate` command surface.
- */
-export function formatMigrationHelpText() {
-    return `Usage:
-  wp-typia migrate init --current-migration-version <label>
-  wp-typia migrate snapshot --migration-version <label>
-  wp-typia migrate plan --from-migration-version <label> [--to-migration-version current]
-  wp-typia migrate wizard
-  wp-typia migrate diff --from-migration-version <label> [--to-migration-version current]
-  wp-typia migrate scaffold --from-migration-version <label> [--to-migration-version current]
-  wp-typia migrate verify [--from-migration-version <label>|--all]
-  wp-typia migrate doctor [--from-migration-version <label>|--all]
-  wp-typia migrate fixtures [--from-migration-version <label>|--all] [--to-migration-version current] [--force]
-  wp-typia migrate fuzz [--from-migration-version <label>|--all] [--iterations <n>] [--seed <n>]
-
-Notes:
-  \`migrate init\` auto-detects supported single-block and \`src/blocks/*\` multi-block layouts.
-  Migration versions use strict schema labels like \`v1\`, \`v2\`, and \`v3\`.
-  \`migrate wizard\` is TTY-only and helps you choose one legacy migration version to preview.
-  \`migrate plan\` and \`migrate wizard\` are read-only previews; they do not scaffold rules or fixtures.
-  --all runs across every configured legacy migration version and every configured block target.
-  Existing fixture files are preserved and reported as skipped unless you pass \`--force\`.
-  Use \`migrate fixtures --force\` as the explicit refresh path for generated fixture files.
-  In TTY usage, \`migrate fixtures --force\` asks before overwriting existing fixture files.
-  In non-interactive usage, \`migrate fixtures --force\` overwrites immediately for script compatibility.`;
-}
-/**
- * Parses migration CLI arguments into a structured command payload.
- *
- * @param argv Command-line arguments that follow the `migrate` subcommand.
- * @returns Parsed migration command and normalized flags for runtime dispatch.
- * @throws Error When no arguments are provided, an unknown flag is encountered, or legacy semver flags are used.
- */
-export function parseMigrationArgs(argv) {
-    const parsed = {
-        command: undefined,
-        flags: {
-            all: false,
-            currentMigrationVersion: undefined,
-            force: false,
-            fromMigrationVersion: undefined,
-            iterations: undefined,
-            migrationVersion: undefined,
-            seed: undefined,
-            toMigrationVersion: "current",
-        },
-    };
-    if (argv.length === 0) {
-        throw new Error(formatMigrationHelpText());
-    }
-    parsed.command = argv[0];
-    for (let index = 1; index < argv.length; index += 1) {
-        const arg = argv[index];
-        const next = argv[index + 1];
-        if (arg === "--")
-            continue;
-        if (arg === "--all") {
-            parsed.flags.all = true;
-            continue;
-        }
-        if (arg === "--force") {
-            parsed.flags.force = true;
-            continue;
-        }
-        if (arg === "--current-migration-version") {
-            parsed.flags.currentMigrationVersion = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--current-migration-version=")) {
-            parsed.flags.currentMigrationVersion = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--from-migration-version") {
-            parsed.flags.fromMigrationVersion = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--from-migration-version=")) {
-            parsed.flags.fromMigrationVersion = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--iterations") {
-            parsed.flags.iterations = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--iterations=")) {
-            parsed.flags.iterations = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--seed") {
-            parsed.flags.seed = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--seed=")) {
-            parsed.flags.seed = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--to-migration-version") {
-            parsed.flags.toMigrationVersion = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--to-migration-version=")) {
-            parsed.flags.toMigrationVersion = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--migration-version") {
-            parsed.flags.migrationVersion = next;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--migration-version=")) {
-            parsed.flags.migrationVersion = arg.split("=", 2)[1];
-            continue;
-        }
-        if (arg === "--current-version" ||
-            arg.startsWith("--current-version=") ||
-            arg === "--version" ||
-            arg.startsWith("--version=") ||
-            arg === "--from" ||
-            arg.startsWith("--from=") ||
-            arg === "--to" ||
-            arg.startsWith("--to=")) {
-            throwLegacyMigrationFlagError(arg);
-        }
-        throw new Error(`Unknown migration flag: ${arg}`);
-    }
-    return parsed;
-}
+import { assertMigrationVersionLabel, compareMigrationVersionLabels, copyFile, detectPackageManagerId, isInteractiveTerminal, readJson, resolveTargetMigrationVersion, runProjectScriptIfPresent, sanitizeSaveSnapshotSource, sanitizeSnapshotBlockJson, } from "./migration-utils.js";
+import { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations, } from "./migration-maintenance.js";
+export { formatMigrationHelpText, parseMigrationArgs };
 export { formatDiffReport };
 /**
  * Dispatch a parsed migration command to the matching runtime workflow.
@@ -231,7 +97,7 @@ export function runMigrationCommand(command, cwd, { prompt, renderLine = console
                 fromMigrationVersion: command.flags.fromMigrationVersion,
                 iterations: parsePositiveInteger(command.flags.iterations, "iterations") ?? 25,
                 renderLine,
-                seed: parseNonNegativeInteger(command.flags.seed, "seed") ?? undefined,
+                seed: parseNonNegativeInteger(command.flags.seed, "seed"),
             });
         default:
             throw new Error(formatMigrationHelpText());
@@ -517,438 +383,7 @@ export function scaffoldProjectMigrations(projectDir, { fromMigrationVersion, to
     }
     return scaffolded.length === 1 ? scaffolded[0] : { scaffolded };
 }
-/**
- * Run deterministic migration verification against generated fixtures.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Verification scope and console rendering options.
- * @returns Verified legacy versions.
- */
-export function verifyProjectMigrations(projectDir, { all = false, fromMigrationVersion, renderLine = console.log } = {}) {
-    const state = loadMigrationProject(projectDir);
-    const targetVersions = resolveLegacyVersions(state, { all, fromMigrationVersion });
-    const blockEntries = getSelectedEntriesByBlock(state, targetVersions, "verify");
-    const legacySingleBlock = isLegacySingleBlockProject(state);
-    if (targetVersions.length === 0) {
-        renderLine("No legacy migration versions configured for verification.");
-        return { verifiedVersions: [] };
-    }
-    const tsxBinary = getLocalTsxBinary(projectDir);
-    for (const [blockKey, entries] of Object.entries(blockEntries)) {
-        const block = state.blocks.find((entry) => entry.key === blockKey);
-        if (!block || entries.length === 0) {
-            continue;
-        }
-        for (const entry of entries) {
-            assertRuleHasNoTodos(projectDir, block, entry.fromVersion, state.config.currentMigrationVersion);
-        }
-        const verifyScriptPath = path.join(getGeneratedDirForBlock(state.paths, block), "verify.ts");
-        if (!fs.existsSync(verifyScriptPath)) {
-            const selectedVersionsForBlock = entries.map((entry) => entry.fromVersion);
-            throw new Error(`Generated verify script is missing for ${block.blockName} (${selectedVersionsForBlock.join(", ")}). ` +
-                `Run \`${formatScaffoldCommand(selectedVersionsForBlock)}\` first, then \`wp-typia migrate doctor --all\` if the workspace should already be scaffolded.`);
-        }
-        const selectedVersionsForBlock = entries.map((entry) => entry.fromVersion);
-        const filteredArgs = all
-            ? ["--all"]
-            : ["--from-migration-version", selectedVersionsForBlock[0]];
-        execFileSync(tsxBinary, [verifyScriptPath, ...filteredArgs], {
-            cwd: projectDir,
-            shell: process.platform === "win32",
-            stdio: "inherit",
-        });
-        renderLine(legacySingleBlock
-            ? `Verified migrations for ${selectedVersionsForBlock.join(", ")}`
-            : `Verified ${block.blockName} migrations for ${selectedVersionsForBlock.join(", ")}`);
-    }
-    return { verifiedVersions: targetVersions };
-}
-function recordWorkspaceMigrationTargetAlignment(projectDir, state, recordCheck) {
-    let invalidWorkspaceReason = null;
-    let workspace;
-    try {
-        invalidWorkspaceReason = getInvalidWorkspaceProjectReason(projectDir);
-        workspace = tryResolveWorkspaceProject(projectDir);
-    }
-    catch (error) {
-        recordCheck("fail", "Workspace migration targets", error instanceof Error ? error.message : String(error));
-        return;
-    }
-    if (!workspace) {
-        if (invalidWorkspaceReason) {
-            recordCheck("fail", "Workspace migration targets", invalidWorkspaceReason);
-        }
-        return;
-    }
-    try {
-        const inventory = readWorkspaceInventory(workspace.projectDir);
-        const expectedTargets = inventory.blocks.map((block) => `${workspace.workspace.namespace}/${block.slug}`);
-        const configuredTargets = state.blocks.map((block) => block.blockName);
-        const expectedTargetSet = new Set(expectedTargets);
-        const configuredTargetSet = new Set(configuredTargets);
-        const missingTargets = expectedTargets.filter((target) => !configuredTargetSet.has(target));
-        const staleTargets = configuredTargets.filter((target) => !expectedTargetSet.has(target));
-        recordCheck(missingTargets.length === 0 && staleTargets.length === 0 ? "pass" : "fail", "Workspace migration targets", missingTargets.length === 0 && staleTargets.length === 0
-            ? `${expectedTargets.length} workspace block target(s) align with migration config`
-            : [
-                missingTargets.length > 0
-                    ? `Missing from migration config: ${missingTargets.join(", ")}`
-                    : null,
-                staleTargets.length > 0
-                    ? `Not present in scripts/block-config.ts: ${staleTargets.join(", ")}`
-                    : null,
-            ]
-                .filter((detail) => typeof detail === "string")
-                .join("; "));
-    }
-    catch (error) {
-        recordCheck("fail", "Workspace migration targets", error instanceof Error ? error.message : String(error));
-    }
-}
-/**
- * Validate the migration workspace without mutating files.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Doctor scope and console rendering options.
- * @returns Structured doctor check results for the selected legacy versions.
- */
-export function doctorProjectMigrations(projectDir, { all = false, fromMigrationVersion, renderLine = console.log } = {}) {
-    const checks = [];
-    const recordCheck = (status, label, detail) => {
-        checks.push({ detail, label, status });
-        renderLine(`${status === "pass" ? "PASS" : "FAIL"} ${label}: ${detail}`);
-    };
-    let state;
-    try {
-        state = loadMigrationProject(projectDir);
-        const legacySingleBlock = isLegacySingleBlockProject(state);
-        recordCheck("pass", "Migration config", legacySingleBlock
-            ? `Loaded ${state.blocks[0]?.blockName} @ ${state.config.currentMigrationVersion}`
-            : `Loaded ${state.blocks.length} block target(s) @ ${state.config.currentMigrationVersion}`);
-    }
-    catch (error) {
-        recordCheck("fail", "Migration config", error instanceof Error ? error.message : String(error));
-        throw new Error("Migration doctor failed.");
-    }
-    const targetVersions = resolveLegacyVersions(state, { all, fromMigrationVersion });
-    const legacySingleBlock = isLegacySingleBlockProject(state);
-    const snapshotVersions = new Set(targetVersions.length > 0
-        ? [state.config.currentMigrationVersion, ...targetVersions]
-        : state.config.supportedMigrationVersions);
-    recordWorkspaceMigrationTargetAlignment(projectDir, state, recordCheck);
-    for (const version of snapshotVersions) {
-        for (const block of state.blocks) {
-            const snapshotRoot = getSnapshotRoot(projectDir, block, version);
-            const blockJsonPath = getSnapshotBlockJsonPath(projectDir, block, version);
-            const manifestPath = getSnapshotManifestPath(projectDir, block, version);
-            const savePath = getSnapshotSavePath(projectDir, block, version);
-            const hasSnapshot = fs.existsSync(snapshotRoot);
-            const snapshotIsOptional = !hasSnapshot && isSnapshotOptionalForBlockVersion(state, block, version);
-            recordCheck(hasSnapshot || snapshotIsOptional ? "pass" : "fail", legacySingleBlock ? `Snapshot ${version}` : `Snapshot ${block.blockName} @ ${version}`, hasSnapshot
-                ? path.relative(projectDir, snapshotRoot)
-                : `Not present for this version`);
-            if (!hasSnapshot) {
-                continue;
-            }
-            for (const targetPath of [blockJsonPath, manifestPath, savePath]) {
-                recordCheck(fs.existsSync(targetPath) ? "pass" : "fail", legacySingleBlock
-                    ? `Snapshot file ${version}`
-                    : `Snapshot file ${block.blockName} @ ${version}`, fs.existsSync(targetPath)
-                    ? path.relative(projectDir, targetPath)
-                    : `Missing ${path.relative(projectDir, targetPath)}`);
-            }
-        }
-    }
-    try {
-        const generatedEntries = collectGeneratedMigrationEntries(state);
-        const expectedGeneratedFiles = new Map();
-        for (const block of state.blocks) {
-            const blockGeneratedEntries = generatedEntries.filter(({ entry }) => entry.block.key === block.key);
-            const entries = blockGeneratedEntries.map(({ entry }) => entry);
-            const generatedDir = getGeneratedDirForBlock(state.paths, block);
-            expectedGeneratedFiles.set(path.join(generatedDir, "registry.ts"), renderMigrationRegistryFile(state, block.key, blockGeneratedEntries));
-            expectedGeneratedFiles.set(path.join(generatedDir, "deprecated.ts"), renderGeneratedDeprecatedFile(state, block.key, entries));
-            expectedGeneratedFiles.set(path.join(generatedDir, "verify.ts"), renderVerifyFile(state, block.key, entries));
-            expectedGeneratedFiles.set(path.join(generatedDir, "fuzz.ts"), renderFuzzFile(state, block.key, blockGeneratedEntries));
-        }
-        expectedGeneratedFiles.set(path.join(state.paths.generatedDir, "index.ts"), renderGeneratedMigrationIndexFile(state, generatedEntries.map(({ entry }) => entry)));
-        expectedGeneratedFiles.set(path.join(projectDir, ROOT_PHP_MIGRATION_REGISTRY), renderPhpMigrationRegistryFile(state, generatedEntries.map(({ entry }) => entry)));
-        for (const [filePath, expectedSource] of expectedGeneratedFiles) {
-            const inSync = fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === expectedSource;
-            recordCheck(inSync ? "pass" : "fail", `Generated ${path.relative(projectDir, filePath)}`, inSync
-                ? "In sync"
-                : `Run \`wp-typia migrate scaffold --from-migration-version <label>\` or regenerate artifacts`);
-        }
-    }
-    catch (error) {
-        recordCheck("fail", "Generated artifacts", error instanceof Error ? error.message : String(error));
-    }
-    for (const version of targetVersions) {
-        for (const block of state.blocks) {
-            if (!hasSnapshotForVersion(state, block, version)) {
-                recordCheck("pass", `Snapshot coverage ${block.blockName} @ ${version}`, "Target not present for this version");
-                continue;
-            }
-            const rulePath = getRuleFilePath(state.paths, block, version, state.config.currentMigrationVersion);
-            const fixturePath = getFixtureFilePath(state.paths, block, version, state.config.currentMigrationVersion);
-            recordCheck(fs.existsSync(rulePath) ? "pass" : "fail", legacySingleBlock ? `Rule ${version}` : `Rule ${block.blockName} @ ${version}`, fs.existsSync(rulePath)
-                ? path.relative(projectDir, rulePath)
-                : `Missing ${path.relative(projectDir, rulePath)}`);
-            recordCheck(fs.existsSync(fixturePath) ? "pass" : "fail", legacySingleBlock ? `Fixture ${version}` : `Fixture ${block.blockName} @ ${version}`, fs.existsSync(fixturePath)
-                ? path.relative(projectDir, fixturePath)
-                : `Missing ${path.relative(projectDir, fixturePath)}`);
-            if (!fs.existsSync(rulePath) || !fs.existsSync(fixturePath)) {
-                continue;
-            }
-            try {
-                assertRuleHasNoTodos(projectDir, block, version, state.config.currentMigrationVersion);
-                recordCheck("pass", legacySingleBlock
-                    ? `Rule TODOs ${version}`
-                    : `Rule TODOs ${block.blockName} @ ${version}`, "No TODO MIGRATION markers remain");
-            }
-            catch (error) {
-                recordCheck("fail", legacySingleBlock
-                    ? `Rule TODOs ${version}`
-                    : `Rule TODOs ${block.blockName} @ ${version}`, error instanceof Error ? error.message : String(error));
-            }
-            try {
-                const ruleMetadata = readRuleMetadata(rulePath);
-                recordCheck(ruleMetadata.unresolved.length === 0 ? "pass" : "fail", legacySingleBlock
-                    ? `Rule unresolved ${version}`
-                    : `Rule unresolved ${block.blockName} @ ${version}`, ruleMetadata.unresolved.length === 0
-                    ? "No unresolved entries remain"
-                    : ruleMetadata.unresolved.join(", "));
-            }
-            catch (error) {
-                recordCheck("fail", legacySingleBlock
-                    ? `Rule unresolved ${version}`
-                    : `Rule unresolved ${block.blockName} @ ${version}`, error instanceof Error ? error.message : String(error));
-            }
-            try {
-                const fixtureDocument = readJson(fixturePath);
-                recordCheck(Array.isArray(fixtureDocument.cases) && fixtureDocument.cases.length > 0 ? "pass" : "fail", legacySingleBlock
-                    ? `Fixture parse ${version}`
-                    : `Fixture parse ${block.blockName} @ ${version}`, Array.isArray(fixtureDocument.cases) && fixtureDocument.cases.length > 0
-                    ? `${fixtureDocument.cases.length} case(s)`
-                    : "Fixture document has no cases");
-                const diff = createMigrationDiff(state, block, version, state.config.currentMigrationVersion);
-                const expectedFixture = createEdgeFixtureDocument(projectDir, block, version, state.config.currentMigrationVersion, diff);
-                const actualCaseNames = new Set((fixtureDocument.cases ?? []).map((fixtureCase) => fixtureCase.name));
-                const missingCases = expectedFixture.cases
-                    .map((fixtureCase) => fixtureCase.name)
-                    .filter((name) => !actualCaseNames.has(name));
-                recordCheck(missingCases.length === 0 ? "pass" : "fail", legacySingleBlock
-                    ? `Fixture coverage ${version}`
-                    : `Fixture coverage ${block.blockName} @ ${version}`, missingCases.length === 0 ? "All expected fixture cases are present" : `Missing ${missingCases.join(", ")}`);
-                recordCheck("pass", legacySingleBlock
-                    ? `Risk summary ${version}`
-                    : `Risk summary ${block.blockName} @ ${version}`, formatMigrationRiskSummary(createMigrationRiskSummary(diff)));
-            }
-            catch (error) {
-                recordCheck("fail", legacySingleBlock
-                    ? `Fixture parse ${version}`
-                    : `Fixture parse ${block.blockName} @ ${version}`, error instanceof Error ? error.message : String(error));
-            }
-        }
-    }
-    const failedChecks = checks.filter((check) => check.status === "fail");
-    renderLine(`${failedChecks.length === 0 ? "PASS" : "FAIL"} Migration doctor summary: ${checks.length - failedChecks.length}/${checks.length} checks passed`);
-    if (failedChecks.length > 0) {
-        throw new Error("Migration doctor failed.");
-    }
-    return {
-        checkedVersions: targetVersions,
-        checks,
-    };
-}
-/**
- * Generate or refresh migration fixtures for one or more legacy edges.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Fixture generation scope and refresh options.
- * @returns Generated and skipped legacy versions.
- */
-export function fixturesProjectMigrations(projectDir, { all = false, confirmOverwrite, force = false, fromMigrationVersion, isInteractive = isInteractiveTerminal(), renderLine = console.log, toMigrationVersion = "current", } = {}) {
-    ensureMigrationDirectories(projectDir);
-    const state = loadMigrationProject(projectDir);
-    const targetMigrationVersion = resolveTargetMigrationVersion(state.config.currentMigrationVersion, toMigrationVersion);
-    const targetVersions = resolveLegacyVersions(state, { all, fromMigrationVersion });
-    if (targetVersions.length === 0) {
-        renderLine("No legacy migration versions configured for fixture generation.");
-        return { generatedVersions: [], skippedVersions: [] };
-    }
-    const generatedVersions = [];
-    const skippedVersions = [];
-    const fixtureTargets = collectFixtureTargets(state, targetVersions, targetMigrationVersion);
-    if (force) {
-        const overwriteTargets = fixtureTargets.filter(({ fixturePath }) => fs.existsSync(fixturePath));
-        if (isInteractive && overwriteTargets.length > 0) {
-            const confirmed = confirmOverwrite?.(`About to overwrite ${overwriteTargets.length} existing migration fixture file(s). Continue?`) ?? promptForConfirmation(`About to overwrite ${overwriteTargets.length} existing migration fixture file(s). Continue?`);
-            if (!confirmed) {
-                renderLine(`Cancelled fixture refresh. Kept ${overwriteTargets.length} existing fixture file(s).`);
-                return {
-                    generatedVersions,
-                    skippedVersions: overwriteTargets.map(({ scopedLabel }) => scopedLabel),
-                };
-            }
-        }
-    }
-    for (const { block, fixturePath, scopedLabel, version } of fixtureTargets) {
-        const existed = fs.existsSync(fixturePath);
-        const diff = createMigrationDiff(state, block, version, targetMigrationVersion);
-        const result = ensureEdgeFixtureFile(projectDir, block, version, targetMigrationVersion, diff, { force });
-        if (result.written) {
-            generatedVersions.push(scopedLabel);
-            renderLine(`${existed ? "Refreshed" : "Generated"} fixture ${path.relative(projectDir, fixturePath)}`);
-        }
-        else {
-            skippedVersions.push(scopedLabel);
-            renderLine(`Preserved existing fixture ${path.relative(projectDir, fixturePath)} (use --force to refresh)`);
-        }
-    }
-    return {
-        generatedVersions,
-        skippedVersions,
-    };
-}
-/**
- * Run seeded migration fuzz verification against generated fuzz artifacts.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Fuzz scope, iteration count, seed, and console rendering options.
- * @returns Fuzzed legacy versions and the effective seed.
- */
-export function fuzzProjectMigrations(projectDir, { all = false, fromMigrationVersion, iterations = 25, renderLine = console.log, seed, } = {}) {
-    const state = loadMigrationProject(projectDir);
-    const targetVersions = resolveLegacyVersions(state, { all, fromMigrationVersion });
-    const blockEntries = getSelectedEntriesByBlock(state, targetVersions, "fuzz");
-    const legacySingleBlock = isLegacySingleBlockProject(state);
-    if (targetVersions.length === 0) {
-        renderLine("No legacy migration versions configured for fuzzing.");
-        return { fuzzedVersions: [] };
-    }
-    const tsxBinary = getLocalTsxBinary(projectDir);
-    for (const [blockKey, entries] of Object.entries(blockEntries)) {
-        const block = state.blocks.find((entry) => entry.key === blockKey);
-        if (!block || entries.length === 0) {
-            continue;
-        }
-        for (const entry of entries) {
-            assertRuleHasNoTodos(projectDir, block, entry.fromVersion, state.config.currentMigrationVersion);
-        }
-        const fuzzScriptPath = path.join(getGeneratedDirForBlock(state.paths, block), "fuzz.ts");
-        if (!fs.existsSync(fuzzScriptPath)) {
-            const selectedVersionsForBlock = entries.map((entry) => entry.fromVersion);
-            throw new Error(`Generated fuzz script is missing for ${block.blockName} (${selectedVersionsForBlock.join(", ")}). ` +
-                `Run \`${formatScaffoldCommand(selectedVersionsForBlock)}\` first, then \`wp-typia migrate doctor --all\` if the workspace should already be scaffolded.`);
-        }
-        const selectedVersionsForBlock = entries.map((entry) => entry.fromVersion);
-        const args = [
-            fuzzScriptPath,
-            ...(all ? ["--all"] : ["--from-migration-version", selectedVersionsForBlock[0]]),
-            "--iterations",
-            String(iterations),
-            ...(seed === undefined ? [] : ["--seed", String(seed)]),
-        ];
-        execFileSync(tsxBinary, args, {
-            cwd: projectDir,
-            shell: process.platform === "win32",
-            stdio: "inherit",
-        });
-        renderLine(legacySingleBlock
-            ? `Fuzzed migrations for ${selectedVersionsForBlock.join(", ")}`
-            : `Fuzzed ${block.blockName} migrations for ${selectedVersionsForBlock.join(", ")}`);
-    }
-    return { fuzzedVersions: targetVersions, seed };
-}
-function parsePositiveInteger(value, label) {
-    if (!value) {
-        return undefined;
-    }
-    if (!/^\d+$/.test(value)) {
-        throw new Error(`Invalid ${label}: ${value}. Expected a positive integer.`);
-    }
-    const parsed = Number.parseInt(value, 10);
-    if (!Number.isInteger(parsed) || parsed <= 0) {
-        throw new Error(`Invalid ${label}: ${value}. Expected a positive integer.`);
-    }
-    return parsed;
-}
-function parseNonNegativeInteger(value, label) {
-    if (!value) {
-        return undefined;
-    }
-    if (!/^\d+$/.test(value)) {
-        throw new Error(`Invalid ${label}: ${value}. Expected a non-negative integer.`);
-    }
-    const parsed = Number.parseInt(value, 10);
-    if (!Number.isInteger(parsed) || parsed < 0) {
-        throw new Error(`Invalid ${label}: ${value}. Expected a non-negative integer.`);
-    }
-    return parsed;
-}
-function resolveLegacyVersions(state, { all = false, availableVersions, fromMigrationVersion, }) {
-    const configuredLegacyVersions = listConfiguredLegacyVersions(state);
-    const legacyVersions = availableVersions ?? configuredLegacyVersions;
-    if (fromMigrationVersion) {
-        if (!legacyVersions.includes(fromMigrationVersion)) {
-            throw new Error(legacyVersions.length === 0
-                ? availableVersions && configuredLegacyVersions.length > 0
-                    ? `Unsupported migration version: ${fromMigrationVersion}. No previewable legacy migration versions are available yet because none currently have snapshot coverage. ` +
-                        `Restore or recapture the missing snapshots first.`
-                    : `Unsupported migration version: ${fromMigrationVersion}. No legacy migration versions are configured yet. ` +
-                        `Capture an older schema release with \`wp-typia migrate snapshot --migration-version <label>\` first.`
-                : `Unsupported migration version: ${fromMigrationVersion}. Available legacy migration versions: ${legacyVersions.join(", ")}.`);
-        }
-        return [fromMigrationVersion];
-    }
-    if (all) {
-        return legacyVersions;
-    }
-    return legacyVersions.slice(0, 1);
-}
-function listConfiguredLegacyVersions(state) {
-    return state.config.supportedMigrationVersions
-        .filter((version) => version !== state.config.currentMigrationVersion)
-        .sort(compareMigrationVersionLabels);
-}
-function listPreviewableLegacyVersions(state) {
-    return [...new Set(state.blocks.flatMap((block) => getAvailableSnapshotVersionsForBlock(state.projectDir, state.config.supportedMigrationVersions, block)))]
-        .filter((version) => version !== state.config.currentMigrationVersion)
-        .sort(compareMigrationVersionLabels);
-}
-function collectGeneratedMigrationEntries(state) {
-    return discoverMigrationEntries(state).map((entry) => {
-        const block = state.blocks.find((target) => target.key === entry.block.key);
-        if (!block) {
-            throw new Error(`Unknown migration block target: ${entry.block.key}`);
-        }
-        const diff = createMigrationDiff(state, entry.block, entry.fromVersion, entry.toVersion);
-        const legacyManifest = readJson(getSnapshotManifestPath(state.projectDir, entry.block, entry.fromVersion));
-        return {
-            diff,
-            entry,
-            fuzzPlan: createMigrationFuzzPlan(legacyManifest, block.currentManifest, diff),
-            riskSummary: createMigrationRiskSummary(diff),
-        };
-    });
-}
-function regenerateGeneratedArtifacts(projectDir) {
-    const state = loadMigrationProject(projectDir);
-    const generatedEntries = collectGeneratedMigrationEntries(state);
-    for (const block of state.blocks) {
-        const blockGeneratedEntries = generatedEntries.filter(({ entry }) => entry.block.key === block.key);
-        const entries = blockGeneratedEntries.map(({ entry }) => entry);
-        const generatedDir = getGeneratedDirForBlock(state.paths, block);
-        fs.mkdirSync(generatedDir, { recursive: true });
-        fs.writeFileSync(path.join(generatedDir, "registry.ts"), renderMigrationRegistryFile(state, block.key, blockGeneratedEntries), "utf8");
-        fs.writeFileSync(path.join(generatedDir, "deprecated.ts"), renderGeneratedDeprecatedFile(state, block.key, entries), "utf8");
-        fs.writeFileSync(path.join(generatedDir, "verify.ts"), renderVerifyFile(state, block.key, entries), "utf8");
-        fs.writeFileSync(path.join(generatedDir, "fuzz.ts"), renderFuzzFile(state, block.key, blockGeneratedEntries), "utf8");
-    }
-    fs.writeFileSync(path.join(state.paths.generatedDir, "index.ts"), renderGeneratedMigrationIndexFile(state, generatedEntries.map(({ entry }) => entry)), "utf8");
-    fs.writeFileSync(path.join(projectDir, ROOT_PHP_MIGRATION_REGISTRY), renderPhpMigrationRegistryFile(state, generatedEntries.map(({ entry }) => entry)), "utf8");
-}
+export { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations, };
 /**
  * Initialize migration scaffolding for one or more block targets.
  *
@@ -981,126 +416,3 @@ export function seedProjectMigrations(projectDir, currentMigrationVersion, block
     renderLine(`Initialized migrations for ${blocks.map((block) => block.blockName).join(", ")} at migration version ${currentMigrationVersion}`);
     return loadMigrationProject(projectDir);
 }
-function hasSnapshotForVersion(state, block, version) {
-    return fs.existsSync(getSnapshotManifestPath(state.projectDir, block, version));
-}
-function getSelectedEntriesByBlock(state, targetVersions, command) {
-    const discoveredEntries = discoverMigrationEntries(state);
-    const discoveredEntryKeys = new Set(discoveredEntries.map((entry) => `${entry.block.key}:${entry.fromVersion}`));
-    const missingEntries = targetVersions.flatMap((version) => state.blocks
-        .filter((block) => hasSnapshotForVersion(state, block, version))
-        .filter((block) => !discoveredEntryKeys.has(`${block.key}:${version}`))
-        .map((block) => ({ block, version })));
-    if (missingEntries.length > 0) {
-        const missingLabels = missingEntries
-            .map(({ block, version }) => `${block.blockName} @ ${version}`)
-            .join(", ");
-        const missingVersions = [...new Set(missingEntries.map(({ version }) => version))].sort(compareMigrationVersionLabels);
-        throw new Error(`Missing migration ${command} inputs for ${missingLabels}. ` +
-            `Run \`${formatScaffoldCommand(missingVersions)}\` first, then \`wp-typia migrate doctor --all\` if the workspace should already be scaffolded.`);
-    }
-    return groupEntriesByBlock(discoveredEntries.filter((entry) => targetVersions.includes(entry.fromVersion)));
-}
-function isSnapshotOptionalForBlockVersion(state, block, version) {
-    if (block.layout !== "multi") {
-        return false;
-    }
-    const introducedVersions = [...new Set(state.config.supportedMigrationVersions)]
-        .filter((candidateVersion) => hasSnapshotForVersion(state, block, candidateVersion))
-        .sort(compareMigrationVersionLabels);
-    const firstIntroducedVersion = introducedVersions[0];
-    if (!firstIntroducedVersion) {
-        return false;
-    }
-    return compareMigrationVersionLabels(version, firstIntroducedVersion) < 0;
-}
-function groupEntriesByBlock(entries) {
-    return entries.reduce((accumulator, entry) => {
-        if (!accumulator[entry.block.key]) {
-            accumulator[entry.block.key] = [];
-        }
-        accumulator[entry.block.key].push(entry);
-        return accumulator;
-    }, {});
-}
-function isLegacySingleBlockProject(state) {
-    return state.blocks.length === 1 && state.blocks[0]?.layout === "legacy";
-}
-function assertDistinctMigrationEdge(command, fromVersion, toVersion) {
-    if (fromVersion === toVersion) {
-        throw new Error(`\`migrate ${command}\` requires different source and target migration versions, but both resolved to ${fromVersion}. ` +
-            `Choose an older snapshot with \`--from-migration-version <label>\` or capture a newer schema release with \`wp-typia migrate snapshot --migration-version <label>\` first.`);
-    }
-}
-function createMigrationPlanNextSteps(fromVersion, targetVersion, currentVersion) {
-    if (targetVersion !== currentVersion) {
-        return [
-            formatEdgeCommand("scaffold", fromVersion, targetVersion, currentVersion),
-        ];
-    }
-    return [
-        formatEdgeCommand("scaffold", fromVersion, targetVersion, currentVersion),
-        `wp-typia migrate doctor --from-migration-version ${fromVersion}`,
-        `wp-typia migrate verify --from-migration-version ${fromVersion}`,
-        `wp-typia migrate fuzz --from-migration-version ${fromVersion}`,
-    ];
-}
-function formatEdgeCommand(command, fromVersion, targetVersion, currentVersion) {
-    return targetVersion === currentVersion
-        ? `wp-typia migrate ${command} --from-migration-version ${fromVersion}`
-        : `wp-typia migrate ${command} --from-migration-version ${fromVersion} --to-migration-version ${targetVersion}`;
-}
-function createMissingProjectSnapshotMessage(state, fromVersion) {
-    const snapshotVersions = [...new Set(state.blocks.flatMap((block) => getAvailableSnapshotVersionsForBlock(state.projectDir, state.config.supportedMigrationVersions, block)))].sort(compareMigrationVersionLabels);
-    return snapshotVersions.length === 0
-        ? `No migration block targets have a snapshot for ${fromVersion}. No snapshots exist yet in this project. ` +
-            `Run \`wp-typia migrate snapshot --migration-version ${fromVersion}\` first if you want to preserve that schema state.`
-        : `No migration block targets have a snapshot for ${fromVersion}. ` +
-            `Available snapshot versions in this project: ${snapshotVersions.join(", ")}. ` +
-            `Run \`wp-typia migrate snapshot --migration-version ${fromVersion}\` first if you want to preserve that schema state.`;
-}
-function formatScaffoldCommand(versions) {
-    const uniqueVersions = [...new Set(versions)].sort(compareMigrationVersionLabels);
-    return uniqueVersions.length === 1
-        ? `wp-typia migrate scaffold --from-migration-version ${uniqueVersions[0]}`
-        : "wp-typia migrate scaffold --from-migration-version <label>";
-}
-function throwLegacyMigrationFlagError(flag) {
-    const replacement = flag.startsWith("--current-version")
-        ? "--current-migration-version"
-        : flag.startsWith("--version")
-            ? "--migration-version"
-            : flag.startsWith("--from")
-                ? "--from-migration-version"
-                : "--to-migration-version";
-    throw new Error(`Legacy migration flag \`${flag}\` is no longer supported. Use \`${replacement}\` with schema labels like \`v1\` and \`v2\` instead. ` +
-        formatLegacyMigrationWorkspaceResetGuidance());
-}
-function promptForConfirmation(message) {
-    process.stdout.write(`${message} [y/N]: `);
-    const buffer = Buffer.alloc(1);
-    let answer = "";
-    while (true) {
-        const bytesRead = fs.readSync(process.stdin.fd, buffer, 0, 1, null);
-        if (bytesRead === 0) {
-            break;
-        }
-        const char = buffer.toString("utf8", 0, bytesRead);
-        if (char === "\n" || char === "\r") {
-            break;
-        }
-        answer += char;
-    }
-    const normalized = answer.trim().toLowerCase();
-    return normalized === "y" || normalized === "yes";
-}
-function collectFixtureTargets(state, targetVersions, targetVersion) {
-    return targetVersions.flatMap((version) => state.blocks
-        .filter((block) => hasSnapshotForVersion(state, block, version))
-        .map((block) => ({
-        block,
-        fixturePath: getFixtureFilePath(state.paths, block, version, targetVersion),
-        scopedLabel: `${block.key}@${version}`,
-        version,
-    })));
-}