@agent-native/core 0.109.3 → 0.110.0

package/dist/cli/migration-codemod.js

@@ -0,0 +1,363 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { Project, QuoteKind, } from "ts-morph";
+import { bundledCorePackageVersion, isMigrationManifestActive, loadMigrationManifestsForProject, migrationMoveStatus, resolveMigrationSymbolMove, } from "../package-lifecycle/migration-manifest.js";
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx"]);
+const SKIP_DIRECTORIES = new Set([
+    ".git",
+    ".next",
+    ".output",
+    ".turbo",
+    "build",
+    "coverage",
+    "dist",
+    "node_modules",
+]);
+function collectSourceFiles(root) {
+    const files = [];
+    const visit = (directory) => {
+        for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+            if (entry.isDirectory() && SKIP_DIRECTORIES.has(entry.name))
+                continue;
+            const entryPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                visit(entryPath);
+            }
+            else if (SOURCE_EXTENSIONS.has(path.extname(entry.name)) &&
+                !entry.name.endsWith(".d.ts")) {
+                files.push(entryPath);
+            }
+        }
+    };
+    visit(root);
+    return files.sort();
+}
+function mergeManifestMoves(manifests) {
+    const moves = {};
+    for (const manifest of manifests) {
+        Object.assign(moves, manifest.moves);
+    }
+    return moves;
+}
+export function loadMigrationManifests(projectRoot) {
+    const packageVersion = bundledCorePackageVersion();
+    return loadMigrationManifestsForProject(projectRoot).filter((manifest) => isMigrationManifestActive(manifest, packageVersion));
+}
+function packageNameFromSpecifier(specifier) {
+    if (specifier.startsWith("@")) {
+        const [scope, name] = specifier.split("/");
+        return scope && name ? `${scope}/${name}` : null;
+    }
+    const [name] = specifier.split("/");
+    return name && !name.startsWith(".") ? name : null;
+}
+function nearestPackageFile(file, root) {
+    let directory = path.dirname(file);
+    const boundary = path.resolve(root);
+    while (directory.startsWith(boundary)) {
+        const packageFile = path.join(directory, "package.json");
+        if (fs.existsSync(packageFile))
+            return packageFile;
+        if (directory === boundary)
+            break;
+        directory = path.dirname(directory);
+    }
+    return null;
+}
+function recordIntroducedDependency(pending, sourceFile, root, from, to) {
+    const fromPackage = packageNameFromSpecifier(from);
+    const toPackage = packageNameFromSpecifier(to);
+    if (!toPackage || toPackage === fromPackage)
+        return;
+    const packageFile = nearestPackageFile(sourceFile, root);
+    if (!packageFile)
+        return;
+    if (!pending.some((entry) => entry.packageFile === packageFile && entry.packageName === toPackage)) {
+        pending.push({ packageFile, packageName: toPackage });
+    }
+}
+function importedNameStructure(importedName, localName, nextName, typeOnly) {
+    return {
+        name: nextName,
+        alias: localName !== nextName
+            ? localName
+            : importedName !== nextName
+                ? importedName
+                : undefined,
+        isTypeOnly: typeOnly,
+    };
+}
+function warnSkippedTarget(warnings, sourceFile, target, reason) {
+    const message = reason === "planned"
+        ? `${sourceFile}: migration to ${target} is planned but not active; no rewrite was applied`
+        : `${sourceFile}: migration target ${target} is not exported by an installed package; no rewrite was applied`;
+    if (!warnings.includes(message))
+        warnings.push(message);
+}
+function rewriteImportDeclaration(declaration, move, root, pendingDependencies, warnings, targetExists) {
+    const originalSpecifier = declaration.getModuleSpecifierValue();
+    const sourceFile = declaration.getSourceFile();
+    const namedImports = declaration.getNamedImports();
+    if (!move.symbols) {
+        if (migrationMoveStatus(move) === "planned") {
+            warnSkippedTarget(warnings, sourceFile.getFilePath(), move.to, "planned");
+            return false;
+        }
+        if (!targetExists(move.to)) {
+            warnSkippedTarget(warnings, sourceFile.getFilePath(), move.to, "unresolved");
+            return false;
+        }
+        declaration.setModuleSpecifier(move.to);
+        recordIntroducedDependency(pendingDependencies, sourceFile.getFilePath(), root, originalSpecifier, move.to);
+        return originalSpecifier !== move.to;
+    }
+    if (namedImports.length === 0) {
+        warnings.push(`${sourceFile.getFilePath()}: cannot split default, namespace, or side-effect import from ${originalSpecifier}`);
+        return false;
+    }
+    const groups = new Map();
+    const movedImports = new Set();
+    for (const namedImport of namedImports) {
+        const importedName = namedImport.getName();
+        const resolved = resolveMigrationSymbolMove(move, importedName);
+        if (!resolved || resolved.to === originalSpecifier)
+            continue;
+        if (resolved.status === "planned") {
+            warnSkippedTarget(warnings, sourceFile.getFilePath(), resolved.to, "planned");
+            continue;
+        }
+        if (!targetExists(resolved.to)) {
+            warnSkippedTarget(warnings, sourceFile.getFilePath(), resolved.to, "unresolved");
+            continue;
+        }
+        const localName = namedImport.getAliasNode()?.getText() ?? importedName;
+        const group = groups.get(resolved.to) ?? [];
+        group.push(importedNameStructure(importedName, localName, resolved.name, !declaration.isTypeOnly() && namedImport.isTypeOnly()));
+        groups.set(resolved.to, group);
+        movedImports.add(namedImport);
+        recordIntroducedDependency(pendingDependencies, sourceFile.getFilePath(), root, originalSpecifier, resolved.to);
+    }
+    if (groups.size === 0)
+        return false;
+    const declarationIndex = declaration.getChildIndex();
+    for (const namedImport of movedImports)
+        namedImport.remove();
+    let offset = 1;
+    for (const [target, imports] of groups) {
+        sourceFile.insertImportDeclaration(declarationIndex + offset, {
+            moduleSpecifier: target,
+            isTypeOnly: declaration.isTypeOnly(),
+            namedImports: imports,
+        });
+        offset += 1;
+    }
+    if (declaration.getNamedImports().length === 0 &&
+        !declaration.getDefaultImport() &&
+        !declaration.getNamespaceImport()) {
+        declaration.remove();
+    }
+    return true;
+}
+function rewriteExportDeclarations(sourceFile, moves, root, pendingDependencies, warnings, targetExists) {
+    for (const declaration of [...sourceFile.getExportDeclarations()]) {
+        const originalSpecifier = declaration.getModuleSpecifierValue();
+        if (!originalSpecifier)
+            continue;
+        const move = moves[originalSpecifier];
+        if (!move)
+            continue;
+        const namedExports = declaration.getNamedExports();
+        if (!move.symbols) {
+            if (migrationMoveStatus(move) === "planned") {
+                warnSkippedTarget(warnings, sourceFile.getFilePath(), move.to, "planned");
+                continue;
+            }
+            if (!targetExists(move.to)) {
+                warnSkippedTarget(warnings, sourceFile.getFilePath(), move.to, "unresolved");
+                continue;
+            }
+            declaration.setModuleSpecifier(move.to);
+            recordIntroducedDependency(pendingDependencies, sourceFile.getFilePath(), root, originalSpecifier, move.to);
+            continue;
+        }
+        if (namedExports.length === 0) {
+            warnings.push(`${sourceFile.getFilePath()}: cannot split export star from ${originalSpecifier}`);
+            continue;
+        }
+        const groups = new Map();
+        const movedExports = new Set();
+        for (const namedExport of namedExports) {
+            const exportedFromName = namedExport.getName();
+            const resolved = resolveMigrationSymbolMove(move, exportedFromName);
+            if (!resolved || resolved.to === originalSpecifier)
+                continue;
+            if (resolved.status === "planned") {
+                warnSkippedTarget(warnings, sourceFile.getFilePath(), resolved.to, "planned");
+                continue;
+            }
+            if (!targetExists(resolved.to)) {
+                warnSkippedTarget(warnings, sourceFile.getFilePath(), resolved.to, "unresolved");
+                continue;
+            }
+            const publicName = namedExport.getAliasNode()?.getText() ?? exportedFromName;
+            const group = groups.get(resolved.to) ?? [];
+            group.push({
+                name: resolved.name,
+                alias: publicName !== resolved.name
+                    ? publicName
+                    : exportedFromName !== resolved.name
+                        ? exportedFromName
+                        : undefined,
+                isTypeOnly: !declaration.isTypeOnly() && namedExport.isTypeOnly()
+                    ? true
+                    : undefined,
+            });
+            groups.set(resolved.to, group);
+            movedExports.add(namedExport);
+            recordIntroducedDependency(pendingDependencies, sourceFile.getFilePath(), root, originalSpecifier, resolved.to);
+        }
+        if (groups.size === 0)
+            continue;
+        const declarationIndex = declaration.getChildIndex();
+        for (const namedExport of movedExports)
+            namedExport.remove();
+        let offset = 1;
+        for (const [target, exports] of groups) {
+            sourceFile.insertExportDeclaration(declarationIndex + offset, {
+                moduleSpecifier: target,
+                isTypeOnly: declaration.isTypeOnly(),
+                namedExports: exports,
+            });
+            offset += 1;
+        }
+        if (declaration.getNamedExports().length === 0)
+            declaration.remove();
+    }
+}
+function readPackageJson(packageFile) {
+    try {
+        return JSON.parse(fs.readFileSync(packageFile, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function addDependencies(pending, apply) {
+    const changes = [];
+    const byFile = new Map();
+    for (const entry of pending) {
+        const packages = byFile.get(entry.packageFile) ?? new Set();
+        packages.add(entry.packageName);
+        byFile.set(entry.packageFile, packages);
+    }
+    for (const [packageFile, packageNames] of byFile) {
+        const packageJson = readPackageJson(packageFile);
+        if (!packageJson)
+            continue;
+        const allDependencySections = [
+            "dependencies",
+            "devDependencies",
+            "optionalDependencies",
+            "peerDependencies",
+        ];
+        const missing = [...packageNames].filter((packageName) => !allDependencySections.some((section) => {
+            const dependencies = packageJson[section];
+            return (dependencies &&
+                typeof dependencies === "object" &&
+                packageName in dependencies);
+        }));
+        if (missing.length === 0)
+            continue;
+        const before = `${JSON.stringify(packageJson, null, 2)}\n`;
+        const dependencies = packageJson.dependencies && typeof packageJson.dependencies === "object"
+            ? packageJson.dependencies
+            : {};
+        for (const packageName of missing.sort())
+            dependencies[packageName] = "latest";
+        packageJson.dependencies = Object.fromEntries(Object.entries(dependencies).sort(([left], [right]) => left.localeCompare(right)));
+        const after = `${JSON.stringify(packageJson, null, 2)}\n`;
+        changes.push({ file: packageFile, before, after });
+        if (apply)
+            fs.writeFileSync(packageFile, after);
+    }
+    return changes;
+}
+export function runMigrationCodemods(options) {
+    const root = path.resolve(options.root);
+    const manifests = options.manifests ?? loadMigrationManifests(root);
+    const moves = mergeManifestMoves(manifests);
+    const requireFromProject = createRequire(path.join(root, "package.json"));
+    const targetExists = options.targetExists ??
+        ((specifier) => {
+            try {
+                requireFromProject.resolve(specifier);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        manipulationSettings: { quoteKind: QuoteKind.Double },
+    });
+    const sourceFiles = project.addSourceFilesAtPaths(collectSourceFiles(root));
+    const pendingDependencies = [];
+    const warnings = [];
+    const changes = [];
+    for (const sourceFile of sourceFiles) {
+        const before = sourceFile.getFullText();
+        for (const declaration of [...sourceFile.getImportDeclarations()]) {
+            const move = moves[declaration.getModuleSpecifierValue()];
+            if (!move)
+                continue;
+            rewriteImportDeclaration(declaration, move, root, pendingDependencies, warnings, targetExists);
+        }
+        rewriteExportDeclarations(sourceFile, moves, root, pendingDependencies, warnings, targetExists);
+        const after = sourceFile.getFullText();
+        if (before === after)
+            continue;
+        changes.push({ file: sourceFile.getFilePath(), before, after });
+        if (options.apply)
+            sourceFile.saveSync();
+    }
+    const dependencyChanges = addDependencies(pendingDependencies, Boolean(options.apply));
+    return {
+        changes: [...changes, ...dependencyChanges],
+        dependencyFiles: dependencyChanges.map((change) => change.file),
+        warnings,
+    };
+}
+function focusedDiff(change, root) {
+    const beforeLines = change.before.split("\n");
+    const afterLines = change.after.split("\n");
+    let prefix = 0;
+    while (prefix < beforeLines.length &&
+        prefix < afterLines.length &&
+        beforeLines[prefix] === afterLines[prefix]) {
+        prefix += 1;
+    }
+    let suffix = 0;
+    while (suffix < beforeLines.length - prefix &&
+        suffix < afterLines.length - prefix &&
+        beforeLines[beforeLines.length - 1 - suffix] ===
+            afterLines[afterLines.length - 1 - suffix]) {
+        suffix += 1;
+    }
+    const beforeChanged = beforeLines.slice(prefix, beforeLines.length - suffix);
+    const afterChanged = afterLines.slice(prefix, afterLines.length - suffix);
+    return [
+        `--- ${path.relative(root, change.file)}`,
+        `+++ ${path.relative(root, change.file)}`,
+        `@@ -${prefix + 1} +${prefix + 1} @@`,
+        ...beforeChanged.map((line) => `-${line}`),
+        ...afterChanged.map((line) => `+${line}`),
+    ].join("\n");
+}
+export function formatMigrationCodemodDiff(result, root) {
+    return result.changes
+        .map((change) => focusedDiff(change, path.resolve(root)))
+        .join("\n");
+}
+//# sourceMappingURL=migration-codemod.js.map

package/dist/cli/migration-codemod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-codemod.js","sourceRoot":"","sources":["../../src/cli/migration-codemod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,OAAO,EACP,SAAS,GAIV,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,0BAA0B,GAG3B,MAAM,4CAA4C,CAAC;AAEpD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM;IACN,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,UAAU;IACV,MAAM;IACN,cAAc;CACf,CAAC,CAAC;AA0BH,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAQ,EAAE;QACxC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACvE,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,SAAS,CAAC,CAAC;YACnB,CAAC;iBAAM,IACL,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/C,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC7B,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,kBAAkB,CACzB,SAA8B;IAE9B,MAAM,KAAK,GAAkC,EAAE,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAAmB;IAEnB,MAAM,cAAc,GAAG,yBAAyB,EAAE,CAAC;IACnD,OAAO,gCAAgC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CACvE,yBAAyB,CAAC,QAAQ,EAAE,cAAc,CAAC,CACpD,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,SAAiB;IACjD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACpD,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,WAAW,CAAC;QACnD,IAAI,SAAS,KAAK,QAAQ;YAAE,MAAM;QAClC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,0BAA0B,CACjC,OAA4B,EAC5B,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,EAAU;IAEV,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO;IACpD,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW;QAAE,OAAO;IACzB,IACE,CAAC,OAAO,CAAC,IAAI,CACX,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,WAAW,KAAK,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CACvE,EACD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,YAAoB,EACpB,SAAiB,EACjB,QAAgB,EAChB,QAAiB;IAEjB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EACH,SAAS,KAAK,QAAQ;YACpB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,YAAY,KAAK,QAAQ;gBACzB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,SAAS;QACjB,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAkB,EAClB,UAAkB,EAClB,MAAc,EACd,MAAgC;IAEhC,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,GAAG,UAAU,kBAAkB,MAAM,oDAAoD;QAC3F,CAAC,CAAC,GAAG,UAAU,sBAAsB,MAAM,kEAAkE,CAAC;IAClH,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,wBAAwB,CAC/B,WAA8B,EAC9B,IAAmB,EACnB,IAAY,EACZ,mBAAwC,EACxC,QAAkB,EAClB,YAA4C;IAE5C,MAAM,iBAAiB,GAAG,WAAW,CAAC,uBAAuB,EAAE,CAAC;IAChE,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IAEnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5C,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,CAAC,EAAE,EACP,YAAY,CACb,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,0BAA0B,CACxB,mBAAmB,EACnB,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,EACJ,iBAAiB,EACjB,IAAI,CAAC,EAAE,CACR,CAAC;QACF,OAAO,iBAAiB,KAAK,IAAI,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX,GAAG,UAAU,CAAC,WAAW,EAAE,iEAAiE,iBAAiB,EAAE,CAChH,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC9D,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,iBAAiB;YAAE,SAAS;QAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,QAAQ,CAAC,EAAE,EACX,SAAS,CACV,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,QAAQ,CAAC,EAAE,EACX,YAAY,CACb,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,YAAY,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CACR,qBAAqB,CACnB,YAAY,EACZ,SAAS,EACT,QAAQ,CAAC,IAAI,EACb,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,WAAW,CAAC,UAAU,EAAE,CACtD,CACF,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/B,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,0BAA0B,CACxB,mBAAmB,EACnB,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,EACJ,iBAAiB,EACjB,QAAQ,CAAC,EAAE,CACZ,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,MAAM,gBAAgB,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC;IACrD,KAAK,MAAM,WAAW,IAAI,YAAY;QAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IAC7D,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,UAAU,CAAC,uBAAuB,CAAC,gBAAgB,GAAG,MAAM,EAAE;YAC5D,eAAe,EAAE,MAAM;YACvB,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE;YACpC,YAAY,EAAE,OAAO;SACtB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,IACE,WAAW,CAAC,eAAe,EAAE,CAAC,MAAM,KAAK,CAAC;QAC1C,CAAC,WAAW,CAAC,gBAAgB,EAAE;QAC/B,CAAC,WAAW,CAAC,kBAAkB,EAAE,EACjC,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB,CAChC,UAAsB,EACtB,KAAoC,EACpC,IAAY,EACZ,mBAAwC,EACxC,QAAkB,EAClB,YAA4C;IAE5C,KAAK,MAAM,WAAW,IAAI,CAAC,GAAG,UAAU,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;QAClE,MAAM,iBAAiB,GAAG,WAAW,CAAC,uBAAuB,EAAE,CAAC;QAChE,IAAI,CAAC,iBAAiB;YAAE,SAAS;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;QAEnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC5C,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,CAAC,EAAE,EACP,SAAS,CACV,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,CAAC,EAAE,EACP,YAAY,CACb,CAAC;gBACF,SAAS;YACX,CAAC;YACD,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxC,0BAA0B,CACxB,mBAAmB,EACnB,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,EACJ,iBAAiB,EACjB,IAAI,CAAC,EAAE,CACR,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CACX,GAAG,UAAU,CAAC,WAAW,EAAE,mCAAmC,iBAAiB,EAAE,CAClF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAGnB,CAAC;QACJ,MAAM,YAAY,GAAG,IAAI,GAAG,EAAiC,CAAC;QAC9D,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YACpE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,iBAAiB;gBAAE,SAAS;YAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,QAAQ,CAAC,EAAE,EACX,SAAS,CACV,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC/B,iBAAiB,CACf,QAAQ,EACR,UAAU,CAAC,WAAW,EAAE,EACxB,QAAQ,CAAC,EAAE,EACX,YAAY,CACb,CAAC;gBACF,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GACd,WAAW,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,gBAAgB,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EACH,UAAU,KAAK,QAAQ,CAAC,IAAI;oBAC1B,CAAC,CAAC,UAAU;oBACZ,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,IAAI;wBAClC,CAAC,CAAC,gBAAgB;wBAClB,CAAC,CAAC,SAAS;gBACjB,UAAU,EACR,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,WAAW,CAAC,UAAU,EAAE;oBACnD,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC/B,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9B,0BAA0B,CACxB,mBAAmB,EACnB,UAAU,CAAC,WAAW,EAAE,EACxB,IAAI,EACJ,iBAAiB,EACjB,QAAQ,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QAEhC,MAAM,gBAAgB,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC;QACrD,KAAK,MAAM,WAAW,IAAI,YAAY;YAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QAC7D,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;YACvC,UAAU,CAAC,uBAAuB,CAAC,gBAAgB,GAAG,MAAM,EAAE;gBAC5D,eAAe,EAAE,MAAM;gBACvB,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE;gBACpC,YAAY,EAAE,OAAO;aACtB,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QACD,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IACvE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,WAAmB;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAGtD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,OAA4B,EAC5B,KAAc;IAEd,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QACpE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,MAAM,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,MAAM,qBAAqB,GAAG;YAC5B,cAAc;YACd,iBAAiB;YACjB,sBAAsB;YACtB,kBAAkB;SACnB,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,MAAM,CACtC,CAAC,WAAW,EAAE,EAAE,CACd,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,CACL,YAAY;gBACZ,OAAO,YAAY,KAAK,QAAQ;gBAChC,WAAW,IAAI,YAAY,CAC5B,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAC3D,MAAM,YAAY,GAChB,WAAW,CAAC,YAAY,IAAI,OAAO,WAAW,CAAC,YAAY,KAAK,QAAQ;YACtE,CAAC,CAAE,WAAW,CAAC,YAAuC;YACtD,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE;YACtC,YAAY,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;QACvC,WAAW,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CACpD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B,CACF,CAAC;QACF,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAoC;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1E,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;QACpB,CAAC,CAAC,SAAiB,EAAW,EAAE;YAC9B,IAAI,CAAC;gBACH,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;QAC1B,2BAA2B,EAAE,IAAI;QACjC,oBAAoB,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE;KACtD,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,mBAAmB,GAAwB,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAiC,EAAE,CAAC;IAEjD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,KAAK,MAAM,WAAW,IAAI,CAAC,GAAG,UAAU,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,wBAAwB,CACtB,WAAW,EACX,IAAI,EACJ,IAAI,EACJ,mBAAmB,EACnB,QAAQ,EACR,YAAY,CACb,CAAC;QACJ,CAAC;QACD,yBAAyB,CACvB,UAAU,EACV,KAAK,EACL,IAAI,EACJ,mBAAmB,EACnB,QAAQ,EACR,YAAY,CACb,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,MAAM,KAAK,KAAK;YAAE,SAAS;QAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,KAAK;YAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,iBAAiB,GAAG,eAAe,CACvC,mBAAmB,EACnB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CACvB,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,GAAG,iBAAiB,CAAC;QAC3C,eAAe,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/D,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAAkC,EAAE,IAAY;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OACE,MAAM,GAAG,WAAW,CAAC,MAAM;QAC3B,MAAM,GAAG,UAAU,CAAC,MAAM;QAC1B,WAAW,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,EAC1C,CAAC;QACD,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OACE,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM;QACpC,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM;QACnC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC;YAC1C,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,EAC5C,CAAC;QACD,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1E,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;QACzC,OAAO,MAAM,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,KAAK;QACrC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAA8B,EAC9B,IAAY;IAEZ,OAAO,MAAM,CAAC,OAAO;SAClB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SACxD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC","sourcesContent":["import fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nimport {\n  Project,\n  QuoteKind,\n  type ImportDeclaration,\n  type ImportSpecifierStructure,\n  type SourceFile,\n} from \"ts-morph\";\n\nimport {\n  bundledCorePackageVersion,\n  isMigrationManifestActive,\n  loadMigrationManifestsForProject,\n  migrationMoveStatus,\n  resolveMigrationSymbolMove,\n  type MigrationManifest,\n  type MigrationMove,\n} from \"../package-lifecycle/migration-manifest.js\";\n\nconst SOURCE_EXTENSIONS = new Set([\".ts\", \".tsx\"]);\nconst SKIP_DIRECTORIES = new Set([\n  \".git\",\n  \".next\",\n  \".output\",\n  \".turbo\",\n  \"build\",\n  \"coverage\",\n  \"dist\",\n  \"node_modules\",\n]);\n\nexport interface MigrationCodemodFileChange {\n  file: string;\n  before: string;\n  after: string;\n}\n\nexport interface MigrationCodemodResult {\n  changes: MigrationCodemodFileChange[];\n  dependencyFiles: string[];\n  warnings: string[];\n}\n\nexport interface RunMigrationCodemodsOptions {\n  root: string;\n  manifests?: MigrationManifest[];\n  apply?: boolean;\n  targetExists?: (specifier: string) => boolean;\n}\n\ninterface PendingDependency {\n  packageFile: string;\n  packageName: string;\n}\n\nfunction collectSourceFiles(root: string): string[] {\n  const files: string[] = [];\n  const visit = (directory: string): void => {\n    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {\n      if (entry.isDirectory() && SKIP_DIRECTORIES.has(entry.name)) continue;\n      const entryPath = path.join(directory, entry.name);\n      if (entry.isDirectory()) {\n        visit(entryPath);\n      } else if (\n        SOURCE_EXTENSIONS.has(path.extname(entry.name)) &&\n        !entry.name.endsWith(\".d.ts\")\n      ) {\n        files.push(entryPath);\n      }\n    }\n  };\n  visit(root);\n  return files.sort();\n}\n\nfunction mergeManifestMoves(\n  manifests: MigrationManifest[],\n): Record<string, MigrationMove> {\n  const moves: Record<string, MigrationMove> = {};\n  for (const manifest of manifests) {\n    Object.assign(moves, manifest.moves);\n  }\n  return moves;\n}\n\nexport function loadMigrationManifests(\n  projectRoot: string,\n): MigrationManifest[] {\n  const packageVersion = bundledCorePackageVersion();\n  return loadMigrationManifestsForProject(projectRoot).filter((manifest) =>\n    isMigrationManifestActive(manifest, packageVersion),\n  );\n}\n\nfunction packageNameFromSpecifier(specifier: string): string | null {\n  if (specifier.startsWith(\"@\")) {\n    const [scope, name] = specifier.split(\"/\");\n    return scope && name ? `${scope}/${name}` : null;\n  }\n  const [name] = specifier.split(\"/\");\n  return name && !name.startsWith(\".\") ? name : null;\n}\n\nfunction nearestPackageFile(file: string, root: string): string | null {\n  let directory = path.dirname(file);\n  const boundary = path.resolve(root);\n  while (directory.startsWith(boundary)) {\n    const packageFile = path.join(directory, \"package.json\");\n    if (fs.existsSync(packageFile)) return packageFile;\n    if (directory === boundary) break;\n    directory = path.dirname(directory);\n  }\n  return null;\n}\n\nfunction recordIntroducedDependency(\n  pending: PendingDependency[],\n  sourceFile: string,\n  root: string,\n  from: string,\n  to: string,\n): void {\n  const fromPackage = packageNameFromSpecifier(from);\n  const toPackage = packageNameFromSpecifier(to);\n  if (!toPackage || toPackage === fromPackage) return;\n  const packageFile = nearestPackageFile(sourceFile, root);\n  if (!packageFile) return;\n  if (\n    !pending.some(\n      (entry) =>\n        entry.packageFile === packageFile && entry.packageName === toPackage,\n    )\n  ) {\n    pending.push({ packageFile, packageName: toPackage });\n  }\n}\n\nfunction importedNameStructure(\n  importedName: string,\n  localName: string,\n  nextName: string,\n  typeOnly: boolean,\n): ImportSpecifierStructure {\n  return {\n    name: nextName,\n    alias:\n      localName !== nextName\n        ? localName\n        : importedName !== nextName\n          ? importedName\n          : undefined,\n    isTypeOnly: typeOnly,\n  };\n}\n\nfunction warnSkippedTarget(\n  warnings: string[],\n  sourceFile: string,\n  target: string,\n  reason: \"planned\" | \"unresolved\",\n): void {\n  const message =\n    reason === \"planned\"\n      ? `${sourceFile}: migration to ${target} is planned but not active; no rewrite was applied`\n      : `${sourceFile}: migration target ${target} is not exported by an installed package; no rewrite was applied`;\n  if (!warnings.includes(message)) warnings.push(message);\n}\n\nfunction rewriteImportDeclaration(\n  declaration: ImportDeclaration,\n  move: MigrationMove,\n  root: string,\n  pendingDependencies: PendingDependency[],\n  warnings: string[],\n  targetExists: (specifier: string) => boolean,\n): boolean {\n  const originalSpecifier = declaration.getModuleSpecifierValue();\n  const sourceFile = declaration.getSourceFile();\n  const namedImports = declaration.getNamedImports();\n\n  if (!move.symbols) {\n    if (migrationMoveStatus(move) === \"planned\") {\n      warnSkippedTarget(warnings, sourceFile.getFilePath(), move.to, \"planned\");\n      return false;\n    }\n    if (!targetExists(move.to)) {\n      warnSkippedTarget(\n        warnings,\n        sourceFile.getFilePath(),\n        move.to,\n        \"unresolved\",\n      );\n      return false;\n    }\n    declaration.setModuleSpecifier(move.to);\n    recordIntroducedDependency(\n      pendingDependencies,\n      sourceFile.getFilePath(),\n      root,\n      originalSpecifier,\n      move.to,\n    );\n    return originalSpecifier !== move.to;\n  }\n\n  if (namedImports.length === 0) {\n    warnings.push(\n      `${sourceFile.getFilePath()}: cannot split default, namespace, or side-effect import from ${originalSpecifier}`,\n    );\n    return false;\n  }\n\n  const groups = new Map<string, ImportSpecifierStructure[]>();\n  const movedImports = new Set<(typeof namedImports)[number]>();\n  for (const namedImport of namedImports) {\n    const importedName = namedImport.getName();\n    const resolved = resolveMigrationSymbolMove(move, importedName);\n    if (!resolved || resolved.to === originalSpecifier) continue;\n    if (resolved.status === \"planned\") {\n      warnSkippedTarget(\n        warnings,\n        sourceFile.getFilePath(),\n        resolved.to,\n        \"planned\",\n      );\n      continue;\n    }\n    if (!targetExists(resolved.to)) {\n      warnSkippedTarget(\n        warnings,\n        sourceFile.getFilePath(),\n        resolved.to,\n        \"unresolved\",\n      );\n      continue;\n    }\n    const localName = namedImport.getAliasNode()?.getText() ?? importedName;\n    const group = groups.get(resolved.to) ?? [];\n    group.push(\n      importedNameStructure(\n        importedName,\n        localName,\n        resolved.name,\n        !declaration.isTypeOnly() && namedImport.isTypeOnly(),\n      ),\n    );\n    groups.set(resolved.to, group);\n    movedImports.add(namedImport);\n    recordIntroducedDependency(\n      pendingDependencies,\n      sourceFile.getFilePath(),\n      root,\n      originalSpecifier,\n      resolved.to,\n    );\n  }\n  if (groups.size === 0) return false;\n\n  const declarationIndex = declaration.getChildIndex();\n  for (const namedImport of movedImports) namedImport.remove();\n  let offset = 1;\n  for (const [target, imports] of groups) {\n    sourceFile.insertImportDeclaration(declarationIndex + offset, {\n      moduleSpecifier: target,\n      isTypeOnly: declaration.isTypeOnly(),\n      namedImports: imports,\n    });\n    offset += 1;\n  }\n  if (\n    declaration.getNamedImports().length === 0 &&\n    !declaration.getDefaultImport() &&\n    !declaration.getNamespaceImport()\n  ) {\n    declaration.remove();\n  }\n  return true;\n}\n\nfunction rewriteExportDeclarations(\n  sourceFile: SourceFile,\n  moves: Record<string, MigrationMove>,\n  root: string,\n  pendingDependencies: PendingDependency[],\n  warnings: string[],\n  targetExists: (specifier: string) => boolean,\n): void {\n  for (const declaration of [...sourceFile.getExportDeclarations()]) {\n    const originalSpecifier = declaration.getModuleSpecifierValue();\n    if (!originalSpecifier) continue;\n    const move = moves[originalSpecifier];\n    if (!move) continue;\n    const namedExports = declaration.getNamedExports();\n\n    if (!move.symbols) {\n      if (migrationMoveStatus(move) === \"planned\") {\n        warnSkippedTarget(\n          warnings,\n          sourceFile.getFilePath(),\n          move.to,\n          \"planned\",\n        );\n        continue;\n      }\n      if (!targetExists(move.to)) {\n        warnSkippedTarget(\n          warnings,\n          sourceFile.getFilePath(),\n          move.to,\n          \"unresolved\",\n        );\n        continue;\n      }\n      declaration.setModuleSpecifier(move.to);\n      recordIntroducedDependency(\n        pendingDependencies,\n        sourceFile.getFilePath(),\n        root,\n        originalSpecifier,\n        move.to,\n      );\n      continue;\n    }\n    if (namedExports.length === 0) {\n      warnings.push(\n        `${sourceFile.getFilePath()}: cannot split export star from ${originalSpecifier}`,\n      );\n      continue;\n    }\n\n    const groups = new Map<\n      string,\n      Array<{ name: string; alias?: string; isTypeOnly?: boolean }>\n    >();\n    const movedExports = new Set<(typeof namedExports)[number]>();\n    for (const namedExport of namedExports) {\n      const exportedFromName = namedExport.getName();\n      const resolved = resolveMigrationSymbolMove(move, exportedFromName);\n      if (!resolved || resolved.to === originalSpecifier) continue;\n      if (resolved.status === \"planned\") {\n        warnSkippedTarget(\n          warnings,\n          sourceFile.getFilePath(),\n          resolved.to,\n          \"planned\",\n        );\n        continue;\n      }\n      if (!targetExists(resolved.to)) {\n        warnSkippedTarget(\n          warnings,\n          sourceFile.getFilePath(),\n          resolved.to,\n          \"unresolved\",\n        );\n        continue;\n      }\n      const publicName =\n        namedExport.getAliasNode()?.getText() ?? exportedFromName;\n      const group = groups.get(resolved.to) ?? [];\n      group.push({\n        name: resolved.name,\n        alias:\n          publicName !== resolved.name\n            ? publicName\n            : exportedFromName !== resolved.name\n              ? exportedFromName\n              : undefined,\n        isTypeOnly:\n          !declaration.isTypeOnly() && namedExport.isTypeOnly()\n            ? true\n            : undefined,\n      });\n      groups.set(resolved.to, group);\n      movedExports.add(namedExport);\n      recordIntroducedDependency(\n        pendingDependencies,\n        sourceFile.getFilePath(),\n        root,\n        originalSpecifier,\n        resolved.to,\n      );\n    }\n    if (groups.size === 0) continue;\n\n    const declarationIndex = declaration.getChildIndex();\n    for (const namedExport of movedExports) namedExport.remove();\n    let offset = 1;\n    for (const [target, exports] of groups) {\n      sourceFile.insertExportDeclaration(declarationIndex + offset, {\n        moduleSpecifier: target,\n        isTypeOnly: declaration.isTypeOnly(),\n        namedExports: exports,\n      });\n      offset += 1;\n    }\n    if (declaration.getNamedExports().length === 0) declaration.remove();\n  }\n}\n\nfunction readPackageJson(packageFile: string): Record<string, unknown> | null {\n  try {\n    return JSON.parse(fs.readFileSync(packageFile, \"utf-8\")) as Record<\n      string,\n      unknown\n    >;\n  } catch {\n    return null;\n  }\n}\n\nfunction addDependencies(\n  pending: PendingDependency[],\n  apply: boolean,\n): MigrationCodemodFileChange[] {\n  const changes: MigrationCodemodFileChange[] = [];\n  const byFile = new Map<string, Set<string>>();\n  for (const entry of pending) {\n    const packages = byFile.get(entry.packageFile) ?? new Set<string>();\n    packages.add(entry.packageName);\n    byFile.set(entry.packageFile, packages);\n  }\n  for (const [packageFile, packageNames] of byFile) {\n    const packageJson = readPackageJson(packageFile);\n    if (!packageJson) continue;\n    const allDependencySections = [\n      \"dependencies\",\n      \"devDependencies\",\n      \"optionalDependencies\",\n      \"peerDependencies\",\n    ];\n    const missing = [...packageNames].filter(\n      (packageName) =>\n        !allDependencySections.some((section) => {\n          const dependencies = packageJson[section];\n          return (\n            dependencies &&\n            typeof dependencies === \"object\" &&\n            packageName in dependencies\n          );\n        }),\n    );\n    if (missing.length === 0) continue;\n    const before = `${JSON.stringify(packageJson, null, 2)}\\n`;\n    const dependencies =\n      packageJson.dependencies && typeof packageJson.dependencies === \"object\"\n        ? (packageJson.dependencies as Record<string, string>)\n        : {};\n    for (const packageName of missing.sort())\n      dependencies[packageName] = \"latest\";\n    packageJson.dependencies = Object.fromEntries(\n      Object.entries(dependencies).sort(([left], [right]) =>\n        left.localeCompare(right),\n      ),\n    );\n    const after = `${JSON.stringify(packageJson, null, 2)}\\n`;\n    changes.push({ file: packageFile, before, after });\n    if (apply) fs.writeFileSync(packageFile, after);\n  }\n  return changes;\n}\n\nexport function runMigrationCodemods(\n  options: RunMigrationCodemodsOptions,\n): MigrationCodemodResult {\n  const root = path.resolve(options.root);\n  const manifests = options.manifests ?? loadMigrationManifests(root);\n  const moves = mergeManifestMoves(manifests);\n  const requireFromProject = createRequire(path.join(root, \"package.json\"));\n  const targetExists =\n    options.targetExists ??\n    ((specifier: string): boolean => {\n      try {\n        requireFromProject.resolve(specifier);\n        return true;\n      } catch {\n        return false;\n      }\n    });\n  const project = new Project({\n    skipAddingFilesFromTsConfig: true,\n    manipulationSettings: { quoteKind: QuoteKind.Double },\n  });\n  const sourceFiles = project.addSourceFilesAtPaths(collectSourceFiles(root));\n  const pendingDependencies: PendingDependency[] = [];\n  const warnings: string[] = [];\n  const changes: MigrationCodemodFileChange[] = [];\n\n  for (const sourceFile of sourceFiles) {\n    const before = sourceFile.getFullText();\n    for (const declaration of [...sourceFile.getImportDeclarations()]) {\n      const move = moves[declaration.getModuleSpecifierValue()];\n      if (!move) continue;\n      rewriteImportDeclaration(\n        declaration,\n        move,\n        root,\n        pendingDependencies,\n        warnings,\n        targetExists,\n      );\n    }\n    rewriteExportDeclarations(\n      sourceFile,\n      moves,\n      root,\n      pendingDependencies,\n      warnings,\n      targetExists,\n    );\n    const after = sourceFile.getFullText();\n    if (before === after) continue;\n    changes.push({ file: sourceFile.getFilePath(), before, after });\n    if (options.apply) sourceFile.saveSync();\n  }\n\n  const dependencyChanges = addDependencies(\n    pendingDependencies,\n    Boolean(options.apply),\n  );\n  return {\n    changes: [...changes, ...dependencyChanges],\n    dependencyFiles: dependencyChanges.map((change) => change.file),\n    warnings,\n  };\n}\n\nfunction focusedDiff(change: MigrationCodemodFileChange, root: string): string {\n  const beforeLines = change.before.split(\"\\n\");\n  const afterLines = change.after.split(\"\\n\");\n  let prefix = 0;\n  while (\n    prefix < beforeLines.length &&\n    prefix < afterLines.length &&\n    beforeLines[prefix] === afterLines[prefix]\n  ) {\n    prefix += 1;\n  }\n  let suffix = 0;\n  while (\n    suffix < beforeLines.length - prefix &&\n    suffix < afterLines.length - prefix &&\n    beforeLines[beforeLines.length - 1 - suffix] ===\n      afterLines[afterLines.length - 1 - suffix]\n  ) {\n    suffix += 1;\n  }\n  const beforeChanged = beforeLines.slice(prefix, beforeLines.length - suffix);\n  const afterChanged = afterLines.slice(prefix, afterLines.length - suffix);\n  return [\n    `--- ${path.relative(root, change.file)}`,\n    `+++ ${path.relative(root, change.file)}`,\n    `@@ -${prefix + 1} +${prefix + 1} @@`,\n    ...beforeChanged.map((line) => `-${line}`),\n    ...afterChanged.map((line) => `+${line}`),\n  ].join(\"\\n\");\n}\n\nexport function formatMigrationCodemodDiff(\n  result: MigrationCodemodResult,\n  root: string,\n): string {\n  return result.changes\n    .map((change) => focusedDiff(change, path.resolve(root)))\n    .join(\"\\n\");\n}\n"]}

package/dist/cli/package-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-lifecycle.d.ts","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAK/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7E,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;CAC1B;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,EACA,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAaD,wBAAgB,qBAAqB,IAAI,MAAM,CAS9C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,OAAO,SAAqB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAkFjC"}
+{"version":3,"file":"package-lifecycle.d.ts","sourceRoot":"","sources":["../../src/cli/package-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAK/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7E,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;CAC1B;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,EACA,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAaD,wBAAgB,qBAAqB,IAAI,MAAM,CAW9C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,OAAO,SAAqB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAkFjC"}

package/dist/cli/package-lifecycle.js

@@ -66,6 +66,8 @@ function flagValue(args, name) {
 }
 export function packageLifecycleUsage() {
     return [
+        "Install-on-demand Toolkit capability module lifecycle:",
+        "",
         "Usage:",
         "  agent-native package inspect <package> [--root <dir>] [--app <name>] [--json]",
         "  agent-native package add <package> [--root <dir>] [--app <name>] [--apply] [--json]",