@ethlete/cli 2.1.0-next.8 → 3.0.0-next.16

package/src/lib/update/gitignore.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ignoreUpdateDir = exports.ignoreEntry = exports.UPDATE_IGNORE_ENTRY = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const git_1 = require("../api/git");
+exports.UPDATE_IGNORE_ENTRY = '.ethlete/update/';
+/** Appends `entry` to `.gitignore` unless git ignores `probe` already. True when it wrote the line. */
+const ignoreEntry = (options) => {
+    const { root, entry, probe = entry } = options;
+    if ((0, git_1.ignoredByGit)(root, probe) !== false)
+        return false;
+    const path = (0, path_1.join)(root, '.gitignore');
+    const current = (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf8') : '';
+    const separator = current.length === 0 || current.endsWith('\n') ? '' : '\n';
+    (0, fs_1.writeFileSync)(path, `${current}${separator}${entry}\n`, 'utf8');
+    return true;
+};
+exports.ignoreEntry = ignoreEntry;
+const ignoreUpdateDir = (root) => (0, exports.ignoreEntry)({ root, entry: exports.UPDATE_IGNORE_ENTRY, probe: `${exports.UPDATE_IGNORE_ENTRY}pending.json` });
+exports.ignoreUpdateDir = ignoreUpdateDir;
+//# sourceMappingURL=gitignore.js.map

package/src/lib/update/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/gitignore.ts"],"names":[],"mappings":";;;AAAA,2BAA6D;AAC7D,+BAA4B;AAC5B,oCAA0C;AAE7B,QAAA,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD,uGAAuG;AAChG,MAAM,WAAW,GAAG,CAAC,OAAwD,EAAE,EAAE;IACtF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE/C,IAAI,IAAA,kBAAY,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAEtD,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7E,IAAA,kBAAa,EAAC,IAAI,EAAE,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAZW,QAAA,WAAW,eAYtB;AAEK,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAC9C,IAAA,mBAAW,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,2BAAmB,EAAE,KAAK,EAAE,GAAG,2BAAmB,cAAc,EAAE,CAAC,CAAC;AADpF,QAAA,eAAe,mBACqE"}

package/src/lib/update/index.d.ts

@@ -1,12 +1,18 @@
+export * from './agent-rules-sync';
 export * from './ai';
 export * from './args';
+export * from './available-migrations';
+export * from './commits';
 export * from './migration-manifest';
+export * from './migration-record';
+export * from './migrations-command';
 export * from './package-manager';
 export * from './packages';
 export * from './pending';
 export * from './plan';
 export * from './registry';
 export * from './run-migrations';
+export * from './scan';
 export * from './semver';
 export * from './tasks';
 export * from './update-command';

package/src/lib/update/index.js

@@ -1,15 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./agent-rules-sync"), exports);
 tslib_1.__exportStar(require("./ai"), exports);
 tslib_1.__exportStar(require("./args"), exports);
+tslib_1.__exportStar(require("./available-migrations"), exports);
+tslib_1.__exportStar(require("./commits"), exports);
 tslib_1.__exportStar(require("./migration-manifest"), exports);
+tslib_1.__exportStar(require("./migration-record"), exports);
+tslib_1.__exportStar(require("./migrations-command"), exports);
 tslib_1.__exportStar(require("./package-manager"), exports);
 tslib_1.__exportStar(require("./packages"), exports);
 tslib_1.__exportStar(require("./pending"), exports);
 tslib_1.__exportStar(require("./plan"), exports);
 tslib_1.__exportStar(require("./registry"), exports);
 tslib_1.__exportStar(require("./run-migrations"), exports);
+tslib_1.__exportStar(require("./scan"), exports);
 tslib_1.__exportStar(require("./semver"), exports);
 tslib_1.__exportStar(require("./tasks"), exports);
 tslib_1.__exportStar(require("./update-command"), exports);

package/src/lib/update/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/index.ts"],"names":[],"mappings":";;;AAAA,+CAAqB;AACrB,iDAAuB;AACvB,+DAAqC;AACrC,4DAAkC;AAClC,qDAA2B;AAC3B,oDAA0B;AAC1B,iDAAuB;AACvB,qDAA2B;AAC3B,2DAAiC;AACjC,mDAAyB;AACzB,kDAAwB;AACxB,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,+CAAqB;AACrB,iDAAuB;AACvB,iEAAuC;AACvC,oDAA0B;AAC1B,+DAAqC;AACrC,6DAAmC;AACnC,+DAAqC;AACrC,4DAAkC;AAClC,qDAA2B;AAC3B,oDAA0B;AAC1B,iDAAuB;AACvB,qDAA2B;AAC3B,2DAAiC;AACjC,iDAAuB;AACvB,mDAAyB;AACzB,kDAAwB;AACxB,2DAAiC"}

package/src/lib/update/migration-manifest.d.ts

@@ -2,17 +2,27 @@
 export declare const MIGRATIONS_MANIFEST_KEY = "ethlete";
 export declare const MIGRATION_KINDS: readonly ["auto", "manual", "assisted"];
 export type MigrationKind = (typeof MIGRATION_KINDS)[number];
+export declare const MIGRATION_LEVELS: readonly ["required", "recommended", "optional"];
+export type MigrationLevel = (typeof MIGRATION_LEVELS)[number];
 export type Migration = {
     /** Unique inside its package, and stable: it names the migration in every report. */
     name: string;
     /** The version the change landed in. The migration is pending for an update that crosses it. */
     version: string;
     kind: MigrationKind;
+    /** Whether `et update` must run it. A manifest entry without a level is `required`. */
+    level: MigrationLevel;
     description: string;
     /** `auto` only: the Nx generator that rewrites the code, as `@ethlete/core:migrate-x`. */
     generator?: string;
     /** `auto` only: flags handed to the generator, for example `{ skipFormat: true }`. */
     options?: Record<string, string | number | boolean>;
+    /**
+     * An Nx generator that finds the files the migration would touch and changes none. `et migrations` runs it
+     * with `--dry-run`, the migration's `options` and the env var `ETHLETE_SCAN_FILE` set to a path, and the
+     * generator writes a JSON array of the affected workspace-relative paths to that file.
+     */
+    scan?: string;
     /** Markdown next to the manifest: the recommendation for `manual`, the prompt for `assisted`. */
     instructions?: string;
     /** Path on the docs site, for example `/components/button`. */

package/src/lib/update/migration-manifest.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.instructionsPath = exports.readPackageMigrations = exports.MIGRATION_KINDS = exports.MIGRATIONS_MANIFEST_KEY = void 0;
+exports.instructionsPath = exports.readPackageMigrations = exports.MIGRATION_LEVELS = exports.MIGRATION_KINDS = exports.MIGRATIONS_MANIFEST_KEY = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const semver_1 = require("./semver");
 /** The `package.json` field a package points at its own migration manifest with. */
 exports.MIGRATIONS_MANIFEST_KEY = 'ethlete';
 exports.MIGRATION_KINDS = ['auto', 'manual', 'assisted'];
+exports.MIGRATION_LEVELS = ['required', 'recommended', 'optional'];
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const readJson = (path) => {
     try {
@@ -31,6 +32,7 @@ const readOptions = (value) => {
     return options;
 };
 const parseEntry = (options) => {
+    var _a;
     const { value, origin, index } = options;
     const at = `${origin} entry ${index}`;
     if (!isRecord(value))
@@ -38,9 +40,13 @@ const parseEntry = (options) => {
     const name = readString(value, 'name');
     const version = readString(value, 'version');
     const kind = readString(value, 'kind');
+    const level = (_a = readString(value, 'level')) !== null && _a !== void 0 ? _a : 'required';
     const description = readString(value, 'description');
     if (!name)
         return { problem: `${at} has no "name".` };
+    if (!/^[\w.-]+$/.test(name) || /^\.+$/.test(name)) {
+        return { problem: `${origin} "${name}" has a name outside letters, digits, ".", "_" and "-".` };
+    }
     if (!version)
         return { problem: `${origin} "${name}" has no "version".` };
     if (!(0, semver_1.isValidVersion)(version))
@@ -50,12 +56,18 @@ const parseEntry = (options) => {
     if (!exports.MIGRATION_KINDS.includes(kind)) {
         return { problem: `${origin} "${name}" has kind "${kind}" — use one of ${exports.MIGRATION_KINDS.join(', ')}.` };
     }
+    if (!exports.MIGRATION_LEVELS.includes(level)) {
+        return { problem: `${origin} "${name}" has level "${level}" — use one of ${exports.MIGRATION_LEVELS.join(', ')}.` };
+    }
     if (!description)
         return { problem: `${origin} "${name}" has no "description".` };
     const generator = readString(value, 'generator');
     const instructions = readString(value, 'instructions');
     if (kind === 'auto' && !generator)
         return { problem: `${origin} "${name}" is auto but names no "generator".` };
+    if (instructions && ((0, path_1.isAbsolute)(instructions) || instructions.split(/[\\/]/).includes('..'))) {
+        return { problem: `${origin} "${name}" names "instructions" outside its package: ${instructions}.` };
+    }
     if (kind === 'assisted' && !instructions) {
         return { problem: `${origin} "${name}" is assisted but names no "instructions" file.` };
     }
@@ -64,9 +76,11 @@ const parseEntry = (options) => {
             name,
             version,
             kind: kind,
+            level: level,
             description,
             generator,
             options: readOptions(value['options']),
+            scan: readString(value, 'scan'),
             instructions,
             docs: readString(value, 'docs'),
         },
@@ -129,8 +143,6 @@ const instructionsPath = (options) => {
     const { manifestPath, migration } = options;
     if (!migration.instructions)
         return undefined;
-    if ((0, path_1.isAbsolute)(migration.instructions))
-        return migration.instructions;
     return manifestPath ? (0, path_1.resolve)((0, path_1.dirname)(manifestPath), migration.instructions) : undefined;
 };
 exports.instructionsPath = instructionsPath;

package/src/lib/update/migration-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"migration-manifest.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/migration-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"migration-manifest.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/migration-manifest.ts"],"names":[],"mappings":"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"}

package/src/lib/update/migration-record.d.ts

@@ -0,0 +1,24 @@
+export declare const MIGRATION_RECORD_FILE: string;
+export type MigrationRun = {
+    /** The installed version of the package when the migration ran. */
+    version: string;
+    ranAt: string;
+};
+/** The runs of the recommended and optional migrations, keyed by `<package>:<name>`. */
+export type MigrationRecord = Record<string, MigrationRun>;
+export type ReadMigrationRecord = {
+    record: MigrationRecord;
+    problems: string[];
+};
+export declare const migrationKey: (options: {
+    packageName: string;
+    name: string;
+}) => string;
+export declare const readMigrationRecord: (root: string) => ReadMigrationRecord;
+/** Adds one run to the record, keeping the runs that are there. */
+export declare const writeMigrationRun: (options: {
+    root: string;
+    packageName: string;
+    name: string;
+    run: MigrationRun;
+}) => void;

package/src/lib/update/migration-record.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeMigrationRun = exports.readMigrationRecord = exports.migrationKey = exports.MIGRATION_RECORD_FILE = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.MIGRATION_RECORD_FILE = (0, path_1.join)('.ethlete', 'migrations.json');
+const migrationKey = (options) => `${options.packageName}:${options.name}`;
+exports.migrationKey = migrationKey;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isRun = (value) => isRecord(value) && typeof value['version'] === 'string' && typeof value['ranAt'] === 'string';
+const readMigrationRecord = (root) => {
+    const path = (0, path_1.join)(root, exports.MIGRATION_RECORD_FILE);
+    if (!(0, fs_1.existsSync)(path))
+        return { record: {}, problems: [] };
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return { record: {}, problems: [`${exports.MIGRATION_RECORD_FILE} is not valid JSON.`] };
+    }
+    if (!isRecord(parsed) || !isRecord(parsed['runs'])) {
+        return { record: {}, problems: [`${exports.MIGRATION_RECORD_FILE} has no "runs" object.`] };
+    }
+    const record = {};
+    const problems = [];
+    for (const [key, run] of Object.entries(parsed['runs'])) {
+        if (!/^@[^/:]+\/[^/:]+:.+$/.test(key))
+            problems.push(`${exports.MIGRATION_RECORD_FILE} has a run "${key}" with no package.`);
+        else if (!isRun(run))
+            problems.push(`${exports.MIGRATION_RECORD_FILE} run "${key}" needs a "version" and a "ranAt".`);
+        else
+            record[key] = { version: run.version, ranAt: run.ranAt };
+    }
+    return { record, problems };
+};
+exports.readMigrationRecord = readMigrationRecord;
+/** Adds one run to the record, keeping the runs that are there. */
+const writeMigrationRun = (options) => {
+    const { root, packageName, name, run } = options;
+    const path = (0, path_1.join)(root, exports.MIGRATION_RECORD_FILE);
+    const runs = Object.assign(Object.assign({}, (0, exports.readMigrationRecord)(root).record), { [(0, exports.migrationKey)({ packageName, name })]: run });
+    const sorted = Object.fromEntries(Object.entries(runs).sort(([left], [right]) => left.localeCompare(right)));
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
+    (0, fs_1.writeFileSync)(path, `${JSON.stringify({ runs: sorted }, null, 2)}\n`, 'utf8');
+};
+exports.writeMigrationRun = writeMigrationRun;
+//# sourceMappingURL=migration-record.js.map

package/src/lib/update/migration-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-record.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/migration-record.ts"],"names":[],"mappings":"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"}

package/src/lib/update/migrations-command.d.ts

@@ -0,0 +1,14 @@
+export type MigrationsCommandOptions = {
+    /** Arguments after `migrations`, for example `['run', 'query:to-query-v3']`. */
+    argv: string[];
+    root?: string;
+    /** How the caller is invoked, used in the usage line. */
+    invocation?: string;
+    /** How `et update` is invoked in this repo, for the hint on a required migration. */
+    updateInvocation?: string;
+};
+/**
+ * Lists the recommended and optional migrations this repo has not run, or runs one of them with the commit
+ * and task-report flow of `et update`, and records the run in `.ethlete/migrations.json`.
+ */
+export declare const migrationsCommand: ({ argv, root, invocation, updateInvocation, }: MigrationsCommandOptions) => 0 | 1;

package/src/lib/update/migrations-command.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrationsCommand = void 0;
+const git_1 = require("../api/git");
+const args_1 = require("./args");
+const available_migrations_1 = require("./available-migrations");
+const commits_1 = require("./commits");
+const migration_manifest_1 = require("./migration-manifest");
+const migration_record_1 = require("./migration-record");
+const package_manager_1 = require("./package-manager");
+const packages_1 = require("./packages");
+const pending_1 = require("./pending");
+const run_migrations_1 = require("./run-migrations");
+const scan_1 = require("./scan");
+const semver_1 = require("./semver");
+const tasks_1 = require("./tasks");
+const update_command_1 = require("./update-command");
+const usage = (invocation) => [
+    `Usage: ${invocation}`,
+    `       ${invocation} run <package>:<name> [flags]`,
+    '',
+    'Lists the recommended and optional migrations the installed @ethlete/* versions ship and this repo',
+    `has not run yet, or runs one of them. Each run is recorded in ${migration_record_1.MIGRATION_RECORD_FILE}; commit it.`,
+    '',
+    'Flags',
+    '  --no-commit  Leave the change uncommitted. By default the run is committed by itself',
+    '  --force      Run even when the working tree has uncommitted changes',
+].join('\n');
+const parseArgs = (argv) => {
+    const args = { commit: true, force: false, help: false, problems: [] };
+    const [first, ...rest] = argv;
+    const positional = [];
+    for (const argument of first === 'run' ? rest : argv) {
+        if (argument === '--no-commit')
+            args.commit = false;
+        else if (argument === '--force')
+            args.force = true;
+        else if (argument === '--help' || argument === '-h')
+            args.help = true;
+        else if (argument.startsWith('-'))
+            args.problems.push(`Unknown flag "${argument}".`);
+        else
+            positional.push(argument);
+    }
+    if (first !== 'run') {
+        if (positional.length > 0)
+            args.problems.push(`Unknown command "${positional.join(' ')}".`);
+        return args;
+    }
+    if (positional.length !== 1)
+        args.problems.push('run needs one migration, as <package>:<name>.');
+    else
+        args.run = positional[0];
+    return args;
+};
+const scanLabel = (scan) => {
+    if (scan === undefined)
+        return '';
+    if ('problem' in scan)
+        return ` - affected files unknown (${scan.problem})`;
+    return ` - ${scan.files.length} affected file${scan.files.length === 1 ? '' : 's'}`;
+};
+const printAvailable = (options) => {
+    const { available, invocation, scan } = options;
+    console.log(`${available.length} migration${available.length === 1 ? ' is' : 's are'} available:\n`);
+    for (const entry of available) {
+        const { migration, packageName, installed } = entry;
+        console.log(`  ${migration.level}  ${(0, migration_record_1.migrationKey)({ packageName, name: migration.name })} (${migration.kind})${scanLabel(scan(entry))}`);
+        console.log(`    ${migration.description}`);
+        if (migration.docs)
+            console.log(`    Docs: ${(0, tasks_1.docsBaseUrl)(installed)}${migration.docs}`);
+        console.log(`    Run: ${invocation} run ${(0, migration_record_1.migrationKey)({ packageName, name: migration.name })}\n`);
+    }
+};
+const list = (options) => {
+    const { root, invocation } = options;
+    const { available, problems } = (0, available_migrations_1.collectAvailableMigrations)(root);
+    for (const problem of problems)
+        console.error(`  ${problem}`);
+    if (available.length === 0) {
+        console.log('No recommended or optional migration is available.');
+        return problems.length > 0 ? 1 : 0;
+    }
+    const manifest = (0, packages_1.readManifest)(root);
+    const manager = manifest && (0, package_manager_1.detectPackageManager)({ root, manifest });
+    const scan = ({ migration }) => {
+        if (!migration.scan)
+            return undefined;
+        if (!manager)
+            return { problem: `${(0, packages_1.manifestPath)(root)} cannot be read` };
+        return (0, scan_1.runScan)({ root, manager, migration });
+    };
+    printAvailable({ available, invocation, scan });
+    return problems.length > 0 ? 1 : 0;
+};
+const findAvailable = (options) => {
+    const { root, key, invocation, updateInvocation } = options;
+    const separator = key.indexOf(':');
+    if (separator <= 0 || separator === key.length - 1) {
+        return { problem: `"${key}" names no migration. Name one as <package>:<name>.` };
+    }
+    const packageName = (0, args_1.fullPackageName)(key.slice(0, separator));
+    const name = key.slice(separator + 1);
+    const fullKey = (0, migration_record_1.migrationKey)({ packageName, name });
+    const installed = (0, packages_1.installedVersion)(root, packageName);
+    if (installed === undefined)
+        return { problem: `${packageName} is not installed.` };
+    const packageMigrations = (0, migration_manifest_1.readPackageMigrations)({ root, packageName });
+    const migration = packageMigrations.migrations.find((candidate) => candidate.name === name);
+    if (!migration) {
+        return {
+            problem: `${packageName} ${installed} ships no migration "${name}". Run \`${invocation}\` to list the available ones.`,
+        };
+    }
+    if (migration.level === 'required') {
+        return { problem: `${fullKey} is required, so \`${updateInvocation}\` runs it. It cannot run on its own.` };
+    }
+    const run = (0, migration_record_1.readMigrationRecord)(root).record[fullKey];
+    if (run)
+        return { problem: `${fullKey} already ran on ${run.ranAt}, with ${packageName} ${run.version}.` };
+    if ((0, semver_1.compareVersions)(migration.version, installed) > 0) {
+        return {
+            problem: `${fullKey} lands in ${migration.version}, and ${packageName} is on ${installed}. Run \`${updateInvocation}\` first.`,
+        };
+    }
+    return { entry: { packageName, migration, manifestPath: packageMigrations.manifestPath, installed } };
+};
+const runOne = (options) => {
+    const { root, args, invocation, updateInvocation } = options;
+    const manifest = (0, packages_1.readManifest)(root);
+    if (!manifest) {
+        console.error(`${(0, packages_1.manifestPath)(root)} cannot be read.`);
+        return 1;
+    }
+    const lookup = findAvailable({ root, key: args.run, invocation, updateInvocation });
+    if ('problem' in lookup) {
+        console.error(lookup.problem);
+        return 1;
+    }
+    const unfinished = (0, pending_1.readPendingUpdate)(root);
+    if (unfinished) {
+        console.error(`The update started at ${unfinished.startedAt} is not finished (${pending_1.PENDING_FILE}).\n` +
+            `Run \`${updateInvocation} --continue\` to finish it first.`);
+        return 1;
+    }
+    if (!args.force && (0, git_1.hasUncommittedChanges)(root)) {
+        console.error('The working tree has uncommitted changes, and the migration rewrites files.\n' +
+            'Commit or stash them first, or re-run with --force.');
+        return 1;
+    }
+    const { entry } = lookup;
+    const manager = (0, package_manager_1.detectPackageManager)({ root, manifest });
+    const commits = args.commit ? (0, commits_1.startCommits)(root) : undefined;
+    if (args.commit && !commits)
+        console.log(update_command_1.NOT_A_CHECKOUT);
+    const committer = commits && (0, commits_1.createStepCommitter)({ root, state: commits, save: () => undefined });
+    (0, update_command_1.ignoreTaskList)(root);
+    console.log(`\nRunning ${(0, migration_record_1.migrationKey)({ packageName: entry.packageName, name: entry.migration.name })}:\n`);
+    const outcomes = (0, run_migrations_1.runPendingMigrations)({
+        root,
+        manager,
+        pending: [entry],
+        dryRun: false,
+        afterEach: (outcome) => {
+            if (outcome.state !== 'failed') {
+                (0, migration_record_1.writeMigrationRun)({
+                    root,
+                    packageName: entry.packageName,
+                    name: entry.migration.name,
+                    run: { version: entry.installed, ranAt: new Date().toISOString() },
+                });
+            }
+            if (outcome.state === 'task' || outcome.state === 'unsupported') {
+                committer === null || committer === void 0 ? void 0 : committer.commit({
+                    message: `chore(deps): Record the ${entry.packageName} ${entry.migration.name} migration`,
+                });
+            }
+            else
+                (0, update_command_1.commitMigration)(committer, outcome);
+        },
+    });
+    (0, update_command_1.printOutcomes)(outcomes, undefined);
+    const written = (0, tasks_1.writeUpdateTasks)({ root, updates: [], outcomes, manager, generatedAt: new Date().toISOString() });
+    if (written.tasks.length > 0) {
+        console.log(`\n  ${written.tasks.length} task(s) written to ${written.reportPath}`);
+        console.log(`  The same list for an agent: ${written.dataPath}`);
+    }
+    if (entry.migration.kind === 'assisted') {
+        console.log(`\n  Run \`${updateInvocation} --continue --ai\` to hand the task to an agent.`);
+    }
+    return outcomes.some((outcome) => outcome.state === 'failed') ? 1 : 0;
+};
+/**
+ * Lists the recommended and optional migrations this repo has not run, or runs one of them with the commit
+ * and task-report flow of `et update`, and records the run in `.ethlete/migrations.json`.
+ */
+const migrationsCommand = ({ argv, root = process.cwd(), invocation = 'et migrations', updateInvocation = 'et update', }) => {
+    const args = parseArgs(argv);
+    if (args.help) {
+        console.log(usage(invocation));
+        return 0;
+    }
+    if (args.problems.length > 0) {
+        console.error(`${args.problems.join('\n')}\n\n${usage(invocation)}`);
+        return 1;
+    }
+    if (args.run === undefined)
+        return list({ root, invocation });
+    return runOne({ root, args: Object.assign(Object.assign({}, args), { run: args.run }), invocation, updateInvocation });
+};
+exports.migrationsCommand = migrationsCommand;
+//# sourceMappingURL=migrations-command.js.map

package/src/lib/update/migrations-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-command.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/migrations-command.ts"],"names":[],"mappings":"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"}

package/src/lib/update/package-manager.d.ts

@@ -1,3 +1,4 @@
+import { SpawnSyncOptions } from 'child_process';
 import { Manifest } from './packages';
 export type PackageManagerName = 'yarn' | 'pnpm' | 'bun' | 'npm';
 export type PackageManager = {
@@ -9,15 +10,33 @@ export type PackageManager = {
 };
 /**
  * The package manager this repo uses: what `packageManager` declares, else the lockfile that is there,
- * else npm. `et update` runs the install itself, so it has to be the same one the repo already uses.
+ * else the one running this command, else npm. `et update` runs the install itself, so it has to be
+ * the same one the repo already uses.
  */
 export declare const detectPackageManager: (options: {
     root: string;
     manifest?: Manifest;
     env?: NodeJS.ProcessEnv;
 }) => PackageManager;
+/**
+ * The environment for the install `et update` spawns. Inside a package manager script, yarn 1 exports
+ * its own default registry as `npm_config_registry`, which the child install would read over the
+ * repo's `.npmrc` and `.yarnrc`. Dropping it lets the child read the repo's config, as it does when
+ * `et` runs outside a script.
+ */
+export declare const installEnv: (env?: NodeJS.ProcessEnv) => NodeJS.ProcessEnv;
 /** The command that runs an `nx` from this repo, for example `yarn nx generate …`. */
 export declare const nxCommand: (options: {
     manager: PackageManager;
     args: readonly string[];
 }) => string[];
+/**
+ * Runs a package manager command such as `yarn install`. On Windows the managers are `.cmd` shims,
+ * which Node spawns only through a shell (CVE-2024-27980), so the command runs as one quoted line there.
+ */
+export declare const spawnPackageManager: (options: {
+    binary: string;
+    args: readonly string[];
+    spawn: SpawnSyncOptions;
+    platform?: NodeJS.Platform;
+}) => import("child_process").SpawnSyncReturns<string | NonSharedBuffer>;