@ethlete/cli 2.1.0-next.7 → 2.1.0-next.9

package/src/lib/update/semver.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionOfRange = exports.rangePrefix = exports.prereleaseTag = exports.isValidVersion = exports.isInUpdateRange = exports.isNewer = exports.compareVersions = void 0;
+const NUMERIC = /^\d+$/;
+const parseVersion = (version) => {
+    const [core = '', ...prereleaseParts] = version.split('-');
+    const prerelease = prereleaseParts.join('-');
+    return {
+        numbers: core.split('.').map((part) => Number.parseInt(part, 10) || 0),
+        prerelease: prerelease === '' ? [] : prerelease.split('.'),
+    };
+};
+const comparePrerelease = (left, right) => {
+    // Semver: a version without a prerelease outranks the same version with one.
+    if (left.length === 0 && right.length === 0)
+        return 0;
+    if (left.length === 0)
+        return 1;
+    if (right.length === 0)
+        return -1;
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const leftPart = left[index];
+        const rightPart = right[index];
+        if (leftPart === undefined)
+            return -1;
+        if (rightPart === undefined)
+            return 1;
+        if (NUMERIC.test(leftPart) && NUMERIC.test(rightPart)) {
+            const leftNumber = Number.parseInt(leftPart, 10);
+            const rightNumber = Number.parseInt(rightPart, 10);
+            if (leftNumber !== rightNumber)
+                return leftNumber < rightNumber ? -1 : 1;
+            continue;
+        }
+        if (leftPart !== rightPart)
+            return leftPart < rightPart ? -1 : 1;
+    }
+    return 0;
+};
+/** `-1`, `0` or `1`, prerelease-aware for the `x.y.z-next.N` versions this repo publishes. */
+const compareVersions = (left, right) => {
+    var _a, _b;
+    const parsedLeft = parseVersion(left);
+    const parsedRight = parseVersion(right);
+    for (let index = 0; index < Math.max(parsedLeft.numbers.length, parsedRight.numbers.length); index += 1) {
+        const leftNumber = (_a = parsedLeft.numbers[index]) !== null && _a !== void 0 ? _a : 0;
+        const rightNumber = (_b = parsedRight.numbers[index]) !== null && _b !== void 0 ? _b : 0;
+        if (leftNumber !== rightNumber)
+            return leftNumber < rightNumber ? -1 : 1;
+    }
+    return comparePrerelease(parsedLeft.prerelease, parsedRight.prerelease);
+};
+exports.compareVersions = compareVersions;
+const isNewer = (candidate, than) => (0, exports.compareVersions)(candidate, than) > 0;
+exports.isNewer = isNewer;
+/** True when `version` sits inside `(after, upTo]`, the range a pending migration is selected by. */
+const isInUpdateRange = (options) => (0, exports.compareVersions)(options.version, options.after) > 0 && (0, exports.compareVersions)(options.version, options.upTo) <= 0;
+exports.isInUpdateRange = isInUpdateRange;
+const isValidVersion = (version) => /^\d+\.\d+\.\d+(?:[-+].*)?$/.test(version);
+exports.isValidVersion = isValidVersion;
+/**
+ * The dist tag a prerelease belongs to, for example `next` for `5.0.0-next.46`. A stable version has
+ * none, and neither has a prerelease that only numbers its identifiers.
+ */
+const prereleaseTag = (version) => parseVersion(version).prerelease.find((part) => !NUMERIC.test(part));
+exports.prereleaseTag = prereleaseTag;
+/** The `^` or `~` a range keeps, or `''` for an exact one. `undefined` for a range with no single version. */
+const rangePrefix = (range) => {
+    const match = /^([\^~]?)(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)$/.exec(range.trim());
+    return match ? match[1] : undefined;
+};
+exports.rangePrefix = rangePrefix;
+/** The version a range points at, for example `5.0.0-next.46` for `^5.0.0-next.46`. */
+const versionOfRange = (range) => {
+    const match = /^[\^~]?(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)$/.exec(range.trim());
+    return match === null || match === void 0 ? void 0 : match[1];
+};
+exports.versionOfRange = versionOfRange;
+//# sourceMappingURL=semver.js.map

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

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

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

@@ -0,0 +1,58 @@
+import { PackageManager } from './package-manager';
+import { UpdatedPackage } from './plan';
+import { MigrationOutcome } from './run-migrations';
+export declare const UPDATE_DIR: string;
+export declare const TASKS_FILE = "tasks.md";
+export declare const TASKS_DATA_FILE = "tasks.json";
+export declare const DOCS_BASE_URL = "https://ethlete-sdk-docs.web.app";
+export type UpdateTask = {
+    packageName: string;
+    name: string;
+    version: string;
+    kind: 'manual' | 'assisted' | 'unsupported';
+    description: string;
+    /** Repo-relative path of the copied instructions, when the migration ships any. */
+    instructionsFile?: string;
+    docsUrl?: string;
+    /** For an `unsupported` auto migration: the generator command to run by hand. */
+    command?: string;
+};
+export declare const taskFileName: (options: {
+    packageName: string;
+    name: string;
+}) => string;
+/** The tasks an update leaves behind: what needs a decision, a prompt, or a command Nx could not run. */
+export declare const collectTasks: (options: {
+    outcomes: readonly MigrationOutcome[];
+    manager: PackageManager;
+}) => UpdateTask[];
+export declare const renderTasks: (options: {
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    tasks: readonly UpdateTask[];
+}) => string;
+/**
+ * One task as its own file: what moved and where to read more, then the instructions the package ships.
+ * The header is what makes the file readable on its own once the update is over.
+ */
+export declare const renderTaskFile: (options: {
+    task: UpdateTask;
+    instructions: string;
+}) => string;
+export type WrittenTasks = {
+    /** Repo-relative path of the report. */
+    reportPath: string;
+    dataPath: string;
+    tasks: UpdateTask[];
+};
+/**
+ * Writes the report, the machine-readable task list an agent reads, and a copy of every instructions
+ * file, so the whole task list stands on its own once `node_modules` changes again.
+ */
+export declare const writeUpdateTasks: (options: {
+    root: string;
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    manager: PackageManager;
+    generatedAt: string;
+}) => WrittenTasks;

package/src/lib/update/tasks.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeUpdateTasks = exports.renderTaskFile = exports.renderTasks = exports.collectTasks = exports.taskFileName = exports.DOCS_BASE_URL = exports.TASKS_DATA_FILE = exports.TASKS_FILE = exports.UPDATE_DIR = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const migration_manifest_1 = require("./migration-manifest");
+const run_migrations_1 = require("./run-migrations");
+exports.UPDATE_DIR = (0, path_1.join)('.ethlete', 'update');
+exports.TASKS_FILE = 'tasks.md';
+exports.TASKS_DATA_FILE = 'tasks.json';
+exports.DOCS_BASE_URL = 'https://ethlete-sdk-docs.web.app';
+const withoutScope = (packageName) => packageName.replace('@ethlete/', '');
+const taskFileName = (options) => `${withoutScope(options.packageName)}-${options.name}.md`;
+exports.taskFileName = taskFileName;
+/** The tasks an update leaves behind: what needs a decision, a prompt, or a command Nx could not run. */
+const collectTasks = (options) => {
+    const { outcomes, manager } = options;
+    const tasks = [];
+    for (const outcome of outcomes) {
+        const { migration, packageName, manifestPath } = outcome.pending;
+        const source = (0, migration_manifest_1.instructionsPath)({ manifestPath, migration });
+        const shared = {
+            packageName,
+            name: migration.name,
+            version: migration.version,
+            description: migration.description,
+            instructionsFile: source ? (0, path_1.join)(exports.UPDATE_DIR, (0, exports.taskFileName)({ packageName, name: migration.name })) : undefined,
+            docsUrl: migration.docs ? `${exports.DOCS_BASE_URL}${migration.docs}` : undefined,
+        };
+        if (outcome.state === 'unsupported') {
+            tasks.push(Object.assign(Object.assign({}, shared), { kind: 'unsupported', command: (0, run_migrations_1.manualGeneratorCommand)({ manager, migration }) }));
+            continue;
+        }
+        if (outcome.state !== 'task')
+            continue;
+        if (migration.kind === 'manual' || migration.kind === 'assisted')
+            tasks.push(Object.assign(Object.assign({}, shared), { kind: migration.kind }));
+    }
+    return tasks;
+};
+exports.collectTasks = collectTasks;
+const KIND_HEADINGS = {
+    unsupported: 'Codemods to run by hand',
+    manual: 'Changes that need a decision',
+    assisted: 'Changes an agent can make',
+};
+const renderTask = (task) => [
+    `### ${task.packageName} — ${task.name}`,
+    '',
+    `Landed in ${task.version}. ${task.description}`,
+    ...(task.command ? ['', `Run: \`${task.command}\``] : []),
+    ...(task.instructionsFile ? ['', `Instructions: \`${task.instructionsFile}\``] : []),
+    ...(task.docsUrl ? ['', `Docs: ${task.docsUrl}`] : []),
+    '',
+].join('\n');
+const renderGroup = (kind, tasks) => {
+    const group = tasks.filter((task) => task.kind === kind);
+    if (group.length === 0)
+        return [];
+    return [`## ${KIND_HEADINGS[kind]}`, '', ...group.map(renderTask)];
+};
+const renderTasks = (options) => {
+    const { updates, outcomes, tasks } = options;
+    const applied = outcomes.filter((outcome) => outcome.state === 'applied');
+    const failed = outcomes.filter((outcome) => outcome.state === 'failed');
+    return [
+        '# Ethlete update: what is left to do',
+        '',
+        '`et update` moved these packages:',
+        '',
+        ...updates.map((update) => { var _a; return `- \`${update.name}\`: ${(_a = update.from) !== null && _a !== void 0 ? _a : 'not installed'} → ${update.to}`; }),
+        '',
+        ...(applied.length > 0
+            ? [
+                'It applied these codemods:',
+                '',
+                ...applied.map((outcome) => `- \`${outcome.pending.packageName}\` ${outcome.pending.migration.name} (${outcome.pending.migration.generator})`),
+                '',
+            ]
+            : []),
+        ...(failed.length > 0
+            ? [
+                'These codemods failed. Run each one again by hand and read its output:',
+                '',
+                ...failed.map((outcome) => `- \`${outcome.pending.packageName}\` ${outcome.pending.migration.name} — ${outcome.reason}`),
+                '',
+            ]
+            : []),
+        ...(tasks.length === 0
+            ? ['Nothing else needs a decision.', '']
+            : [
+                'Everything below needs a decision the codemods cannot make.',
+                '',
+                ...renderGroup('unsupported', tasks),
+                ...renderGroup('manual', tasks),
+                ...renderGroup('assisted', tasks),
+            ]),
+    ].join('\n');
+};
+exports.renderTasks = renderTasks;
+/**
+ * One task as its own file: what moved and where to read more, then the instructions the package ships.
+ * The header is what makes the file readable on its own once the update is over.
+ */
+const renderTaskFile = (options) => {
+    const { task, instructions } = options;
+    return [
+        `<!-- Written by et update. ${task.packageName} ${task.version}, migration "${task.name}". -->`,
+        '',
+        ...(task.kind === 'assisted'
+            ? ['> Hand this file to an agent. It describes one change to apply across this repository.', '']
+            : []),
+        `- Package: \`${task.packageName}\``,
+        `- Landed in: ${task.version}`,
+        `- Summary: ${task.description}`,
+        ...(task.docsUrl ? [`- Docs: ${task.docsUrl}`] : []),
+        '',
+        '---',
+        '',
+        instructions.trim(),
+    ].join('\n');
+};
+exports.renderTaskFile = renderTaskFile;
+/**
+ * Writes the report, the machine-readable task list an agent reads, and a copy of every instructions
+ * file, so the whole task list stands on its own once `node_modules` changes again.
+ */
+const writeUpdateTasks = (options) => {
+    const { root, updates, outcomes, manager, generatedAt } = options;
+    const tasks = (0, exports.collectTasks)({ outcomes, manager });
+    const directory = (0, path_1.join)(root, exports.UPDATE_DIR);
+    (0, fs_1.mkdirSync)(directory, { recursive: true });
+    for (const outcome of outcomes) {
+        const source = (0, migration_manifest_1.instructionsPath)({
+            manifestPath: outcome.pending.manifestPath,
+            migration: outcome.pending.migration,
+        });
+        const task = tasks.find((candidate) => candidate.packageName === outcome.pending.packageName && candidate.name === outcome.pending.migration.name);
+        if (!source || !task)
+            continue;
+        (0, fs_1.writeFileSync)((0, path_1.join)(directory, (0, exports.taskFileName)({ packageName: task.packageName, name: task.name })), `${(0, exports.renderTaskFile)({ task, instructions: (0, fs_1.readFileSync)(source, 'utf8') })}\n`, 'utf8');
+    }
+    const reportPath = (0, path_1.join)(exports.UPDATE_DIR, exports.TASKS_FILE);
+    const dataPath = (0, path_1.join)(exports.UPDATE_DIR, exports.TASKS_DATA_FILE);
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, reportPath), `${(0, exports.renderTasks)({ updates, outcomes, tasks })}\n`, 'utf8');
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, dataPath), `${JSON.stringify({
+        generatedAt,
+        updates: updates.map((update) => { var _a; return ({ package: update.name, from: (_a = update.from) !== null && _a !== void 0 ? _a : null, to: update.to }); }),
+        applied: outcomes
+            .filter((outcome) => outcome.state === 'applied')
+            .map((outcome) => {
+            var _a;
+            return ({
+                package: outcome.pending.packageName,
+                name: outcome.pending.migration.name,
+                generator: (_a = outcome.pending.migration.generator) !== null && _a !== void 0 ? _a : null,
+            });
+        }),
+        failed: outcomes
+            .filter((outcome) => outcome.state === 'failed')
+            .map((outcome) => {
+            var _a;
+            return ({
+                package: outcome.pending.packageName,
+                name: outcome.pending.migration.name,
+                reason: (_a = outcome.reason) !== null && _a !== void 0 ? _a : null,
+            });
+        }),
+        tasks,
+    }, null, 2)}\n`, 'utf8');
+    return { reportPath, dataPath, tasks };
+};
+exports.writeUpdateTasks = writeUpdateTasks;
+//# sourceMappingURL=tasks.js.map

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

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

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

@@ -0,0 +1,12 @@
+export type UpdateCommandOptions = {
+    /** Arguments after `update`, for example `['core', '--tag', 'next']`. */
+    argv: string[];
+    root?: string;
+    /** How the caller is invoked, used in the usage line. */
+    invocation?: string;
+};
+/**
+ * Moves this repo's `@ethlete/*` dependencies to a newer version and runs the migrations those versions
+ * ship. Everything the codemods cannot decide is written to a task list under `.ethlete/update`.
+ */
+export declare const updateCommand: ({ argv, root, invocation, }: UpdateCommandOptions) => Promise<number>;

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

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateCommand = void 0;
+const tslib_1 = require("tslib");
+const git_1 = require("../api/git");
+const local_config_1 = require("../config/local-config");
+const ai_1 = require("./ai");
+const args_1 = require("./args");
+const migration_manifest_1 = require("./migration-manifest");
+const package_manager_1 = require("./package-manager");
+const packages_1 = require("./packages");
+const plan_1 = require("./plan");
+const pending_1 = require("./pending");
+const registry_1 = require("./registry");
+const run_migrations_1 = require("./run-migrations");
+const tasks_1 = require("./tasks");
+const usage = (invocation) => [
+    `Usage: ${invocation} [packages...] [flags]`,
+    '',
+    'Moves the @ethlete/* packages this repo declares to a newer version, then runs the migrations',
+    'those versions ship: the codemods by itself, and a report for everything that needs a decision.',
+    '',
+    'Every package.json in the repo is rewritten, not only the root one, so a library manifest that',
+    'pins @ethlete/* moves with it.',
+    '',
+    'A package may be named short (`core`) or in full (`@ethlete/core`). With no name, every',
+    '@ethlete/* dependency is updated.',
+    '',
+    'Flags',
+    '  --check         Print what would change and exit 1 when an update is pending. Writes nothing',
+    '  --dry-run       Print the plan, and the migrations the installed versions know about',
+    '  --tag <tag>     Dist tag to update to. Defaults to the tag the installed prerelease is on',
+    '  --to <version>  Exact version for the one package you name',
+    '  --from <p@ver>  The version a package migrates from, when the installed one is already newer',
+    '  --no-install    Write package.json, then stop. Install yourself and re-run with --continue',
+    '  --continue      Run the migrations of an update that was written but never finished',
+    '  --ai            Hand every agent-assisted task to the command in updateAgentCommand',
+    '  --force         Update even when the working tree has uncommitted changes',
+].join('\n');
+const padded = (value, width) => value.padEnd(width);
+const printUpdates = (updates) => {
+    var _a;
+    const width = Math.max(...updates.map((update) => update.name.length));
+    for (const update of updates) {
+        const tag = update.tag ? `  (${update.tag})` : '';
+        console.log(`  ${padded(update.name, width)}  ${(_a = update.from) !== null && _a !== void 0 ? _a : 'not installed'} → ${update.to}${tag}`);
+    }
+};
+const problemsOf = (updates) => updates.flatMap((update) => update.unwritable.map((site) => `${site.manifestPath} declares ${update.name} as "${site.range}", which no single version can be ` +
+    `written into. Change it to ${update.to} by hand.`));
+const resolveUpdates = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { declared, version, tag } = options;
+    const registry = (0, registry_1.registryUrl)();
+    const result = { updates: [], problems: [], upToDate: [] };
+    const lookups = yield Promise.all(declared.map((entry) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        return ({
+            entry,
+            lookup: yield (0, registry_1.fetchRegistryPackage)({ packageName: entry.name, registry }),
+        });
+    })));
+    for (const { entry, lookup } of lookups) {
+        if (!lookup.ok) {
+            result.problems.push(`${entry.name}: ${lookup.reason}`);
+            continue;
+        }
+        const choice = (0, plan_1.chooseTarget)({ declared: entry, registry: lookup.package, request: { version, tag } });
+        if ('problem' in choice) {
+            result.problems.push(choice.problem);
+            continue;
+        }
+        if ('upToDate' in choice) {
+            result.upToDate.push(entry.name);
+            continue;
+        }
+        result.updates.push(choice.update);
+    }
+    return result;
+});
+const collectMigrations = (options) => {
+    var _a;
+    const { root, updates, from } = options;
+    const collected = { pending: [], notes: [], problems: [] };
+    for (const update of updates) {
+        const start = (_a = from[update.name]) !== null && _a !== void 0 ? _a : update.from;
+        if (start === undefined) {
+            collected.notes.push(`${update.name} was not installed before, so it has nothing to migrate.`);
+            continue;
+        }
+        const packageMigrations = (0, migration_manifest_1.readPackageMigrations)({ root, packageName: update.name });
+        collected.problems.push(...packageMigrations.problems);
+        collected.pending.push(...(0, plan_1.pendingMigrations)({ packageMigrations, from: start, to: update.to }));
+    }
+    collected.pending = (0, plan_1.orderMigrations)(collected.pending);
+    return collected;
+};
+const printMigrations = (pending) => {
+    for (const entry of pending) {
+        console.log(`  ${entry.migration.version}  ${entry.packageName}  ${entry.migration.name} (${entry.migration.kind})`);
+    }
+};
+const printOutcomes = (outcomes) => {
+    const applied = outcomes.filter((outcome) => outcome.state === 'applied').length;
+    const failed = outcomes.filter((outcome) => outcome.state === 'failed');
+    const tasks = outcomes.filter((outcome) => outcome.state === 'task' || outcome.state === 'unsupported').length;
+    console.log(`\n  ${applied} codemod(s) applied, ${tasks} task(s) left, ${failed.length} failed`);
+    for (const outcome of failed) {
+        console.error(`  - ${outcome.pending.packageName} ${outcome.pending.migration.name}: ${outcome.reason}`);
+    }
+};
+const runMigrationPhase = (options) => {
+    const { root, manager, updates, from, dryRun, ai } = options;
+    const collected = collectMigrations({ root, updates, from });
+    for (const note of collected.notes)
+        console.log(`  ${note}`);
+    for (const problem of collected.problems)
+        console.error(`  ${problem}`);
+    if (collected.pending.length === 0) {
+        console.log('\nNo migration is pending for those versions.');
+        return { failed: collected.problems.length > 0 };
+    }
+    console.log(`\n${collected.pending.length} migration(s) to run:\n`);
+    printMigrations(collected.pending);
+    if (!(0, run_migrations_1.hasNx)(root)) {
+        console.log('\n  This repo has no Nx, so every codemod is reported as a command to run by hand.');
+    }
+    const outcomes = (0, run_migrations_1.runPendingMigrations)({ root, manager, pending: collected.pending, dryRun });
+    printOutcomes(outcomes);
+    if (dryRun) {
+        console.log('\nDry run: no report was written.');
+        return { failed: false };
+    }
+    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 (ai) {
+        const template = (0, local_config_1.readLocalConfig)(root).config.updateAgentCommand;
+        const assisted = (0, ai_1.assistedTasks)(written.tasks);
+        if (assisted.length === 0)
+            console.log('\n  --ai had nothing to do: no task is agent-assisted.');
+        else if (!template) {
+            console.error(`\n  --ai needs "${ai_1.AGENT_COMMAND_KEY}" in ethlete.config.local.json, for example "claude -p".`);
+        }
+        else {
+            const runs = (0, ai_1.runAgentTasks)({ root, template, tasks: written.tasks });
+            const failed = runs.filter((run) => !run.ok);
+            for (const run of failed)
+                console.error(`  ${run.task.name}: ${run.reason}`);
+        }
+    }
+    return { failed: outcomes.some((outcome) => outcome.state === 'failed') || collected.problems.length > 0 };
+};
+const resume = (options) => {
+    var _a;
+    const { root, manager, argv } = options;
+    const pending = (0, pending_1.readPendingUpdate)(root);
+    if (!pending) {
+        console.error(`Nothing to continue: ${pending_1.PENDING_FILE} is not there.`);
+        return 1;
+    }
+    console.log(`\nContinuing the update started at ${pending.startedAt}:\n`);
+    const updates = pending.packages.map((entry) => {
+        var _a;
+        return ({
+            name: entry.name,
+            from: (_a = entry.from) !== null && _a !== void 0 ? _a : undefined,
+            to: entry.to,
+        });
+    });
+    for (const update of updates) {
+        console.log(`  ${update.name}  ${(_a = update.from) !== null && _a !== void 0 ? _a : 'not installed'} → ${update.to}`);
+    }
+    const result = runMigrationPhase({
+        root,
+        manager,
+        updates,
+        from: argv.from,
+        dryRun: argv.dryRun,
+        ai: argv.ai,
+    });
+    if (!result.failed && !argv.dryRun)
+        (0, pending_1.clearPendingUpdate)(root);
+    return result.failed ? 1 : 0;
+};
+/**
+ * Moves this repo's `@ethlete/*` dependencies to a newer version and runs the migrations those versions
+ * ship. Everything the codemods cannot decide is written to a task list under `.ethlete/update`.
+ */
+const updateCommand = (_a) => tslib_1.__awaiter(void 0, [_a], void 0, function* ({ argv, root = process.cwd(), invocation = 'et update', }) {
+    var _b;
+    const args = (0, args_1.parseUpdateArgs)(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;
+    }
+    const manifest = (0, packages_1.readManifest)(root);
+    if (!manifest) {
+        console.error(`${(0, packages_1.manifestPath)(root)} cannot be read, so there is nothing to update.`);
+        return 1;
+    }
+    const manager = (0, package_manager_1.detectPackageManager)({ root, manifest });
+    if (args.resume)
+        return resume({ root, manager, argv: args });
+    const manifests = (0, packages_1.findManifests)(root);
+    const all = (0, packages_1.declaredEthletePackages)({ root, manifests });
+    const named = args.packages.filter((name) => !all.some((entry) => entry.name === name));
+    if (named.length > 0) {
+        console.error(`This repo declares no ${named.join(', ')}.`);
+        return 1;
+    }
+    const declared = args.packages.length === 0 ? all : all.filter((entry) => args.packages.includes(entry.name));
+    if (declared.length === 0) {
+        console.log('This repo declares no @ethlete/* dependency.');
+        return 0;
+    }
+    const resolved = yield resolveUpdates({ declared, version: args.version, tag: args.tag });
+    for (const problem of resolved.problems)
+        console.error(`  ${problem}`);
+    if (resolved.updates.length === 0) {
+        console.log(`\nEvery @ethlete package is on its newest version (${resolved.upToDate.length} checked).`);
+        return resolved.problems.length > 0 ? 1 : 0;
+    }
+    console.log('');
+    if (manifests.length > 1)
+        console.log(`  ${manifests.length} package.json files scanned.\n`);
+    printUpdates(resolved.updates);
+    for (const update of resolved.updates.filter(plan_1.isDowngrade)) {
+        console.log(`\n  ${update.name} moves back to ${update.to}, which is older than the installed ${update.from}.`);
+    }
+    const rangeProblems = problemsOf(resolved.updates);
+    for (const problem of rangeProblems)
+        console.error(`\n  ${problem}`);
+    const writable = resolved.updates.filter((update) => update.writes.length > 0);
+    if (args.check) {
+        console.log(`\nRun \`${invocation}\` to apply this.`);
+        return 1;
+    }
+    if (args.dryRun) {
+        console.log('\nMigrations the installed versions know about. The target may ship more:\n');
+        printMigrations(collectMigrations({ root, updates: writable, from: args.from }).pending);
+        console.log('\nDry run: nothing was written.');
+        return 0;
+    }
+    if (writable.length === 0) {
+        console.error('\nNo range could be written. Nothing was changed.');
+        return 1;
+    }
+    if (!args.force && (0, git_1.hasUncommittedChanges)(root)) {
+        console.error('\nThe working tree has uncommitted changes, and the codemods rewrite files.\n' +
+            'Commit or stash them first, or re-run with --force.');
+        return 1;
+    }
+    const changedManifests = (0, packages_1.writeRanges)({ root, writes: writable.flatMap((update) => update.writes) });
+    (0, pending_1.writePendingUpdate)({
+        root,
+        pending: {
+            startedAt: new Date().toISOString(),
+            packages: writable.map((update) => { var _a; return ({ name: update.name, from: (_a = update.from) !== null && _a !== void 0 ? _a : null, to: update.to }); }),
+        },
+    });
+    const manifestNote = changedManifests.length === 1
+        ? ((_b = changedManifests[0]) !== null && _b !== void 0 ? _b : packages_1.ROOT_MANIFEST)
+        : `${changedManifests.length} package.json files`;
+    console.log(`\n  ${manifestNote} updated. The migration plan is in ${pending_1.PENDING_FILE}.`);
+    if (!args.install) {
+        console.log(`\nInstall the new versions, then run \`${invocation} --continue\`.`);
+        return 0;
+    }
+    console.log(`\n  ${manager.install.join(' ')}\n`);
+    const installed = (0, run_migrations_1.runInstall)({ root, manager });
+    if (!installed.ok) {
+        console.error(`\nThe install failed: ${installed.reason}\n` +
+            `Fix it, then run \`${invocation} --continue\` to run the migrations.`);
+        return 1;
+    }
+    const result = runMigrationPhase({
+        root,
+        manager,
+        updates: writable,
+        from: args.from,
+        dryRun: false,
+        ai: args.ai,
+    });
+    if (result.failed) {
+        console.error(`\nRun \`${invocation} --continue\` again once the failures above are fixed.`);
+        return 1;
+    }
+    (0, pending_1.clearPendingUpdate)(root);
+    console.log(`\nDone. Read ${tasks_1.UPDATE_DIR} for anything left to do.`);
+    return rangeProblems.length > 0 ? 1 : 0;
+});
+exports.updateCommand = updateCommand;
+//# sourceMappingURL=update-command.js.map