@ethlete/cli 2.0.1-next.2 → 2.1.0-next.11

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPendingMigrations = exports.manualGeneratorCommand = exports.runInstall = exports.runAutoMigration = exports.generatorArgs = exports.hasNx = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const package_manager_1 = require("./package-manager");
+/** Nx runs the auto migrations, so a repo without it gets the command printed instead. */
+const hasNx = (root) => (0, fs_1.existsSync)((0, path_1.join)(root, 'node_modules', 'nx', 'package.json')) && (0, fs_1.existsSync)((0, path_1.join)(root, 'nx.json'));
+exports.hasNx = hasNx;
+/** The `nx generate` arguments for one auto migration. Non-interactive: an update must not stop to ask. */
+const generatorArgs = (options) => {
+    var _a, _b;
+    const { migration, dryRun } = options;
+    return [
+        'generate',
+        (_a = migration.generator) !== null && _a !== void 0 ? _a : '',
+        '--interactive=false',
+        ...Object.entries((_b = migration.options) !== null && _b !== void 0 ? _b : {}).map(([key, value]) => `--${key}=${String(value)}`),
+        ...(dryRun ? ['--dry-run'] : []),
+    ];
+};
+exports.generatorArgs = generatorArgs;
+const runAutoMigration = (options) => {
+    const { root, manager, pending, dryRun } = options;
+    const [binary, ...args] = (0, package_manager_1.nxCommand)({
+        manager,
+        args: (0, exports.generatorArgs)({ migration: pending.migration, dryRun }),
+    });
+    if (binary === undefined)
+        return { pending, state: 'failed', reason: 'no command to run the generator with' };
+    const result = (0, child_process_1.spawnSync)(binary, args, { cwd: root, stdio: 'inherit' });
+    if (result.error)
+        return { pending, state: 'failed', reason: result.error.message };
+    if (result.status !== 0)
+        return { pending, state: 'failed', reason: `${binary} exited with ${result.status}` };
+    return { pending, state: dryRun ? 'planned' : 'applied' };
+};
+exports.runAutoMigration = runAutoMigration;
+const runInstall = (options) => {
+    const { root, manager, env } = options;
+    const [binary, ...args] = manager.install;
+    if (binary === undefined)
+        return { ok: false, reason: 'no install command' };
+    const result = (0, child_process_1.spawnSync)(binary, args, { cwd: root, stdio: 'inherit', env: (0, package_manager_1.installEnv)(env) });
+    if (result.error)
+        return { ok: false, reason: result.error.message };
+    if (result.status !== 0)
+        return { ok: false, reason: `${manager.install.join(' ')} exited with ${result.status}` };
+    return { ok: true };
+};
+exports.runInstall = runInstall;
+/** The command a developer runs by hand when this repo has no Nx to run the generator with. */
+const manualGeneratorCommand = (options) => (0, package_manager_1.nxCommand)({ manager: options.manager, args: (0, exports.generatorArgs)({ migration: options.migration, dryRun: false }) }).join(' ');
+exports.manualGeneratorCommand = manualGeneratorCommand;
+const runPendingMigrations = (options) => {
+    const { root, manager, pending, dryRun } = options;
+    const nxAvailable = (0, exports.hasNx)(root);
+    return pending.map((entry) => {
+        if (entry.migration.kind !== 'auto')
+            return { pending: entry, state: 'task' };
+        if (!nxAvailable) {
+            return {
+                pending: entry,
+                state: 'unsupported',
+                reason: 'this repo has no Nx, so the generator has to be run by hand',
+            };
+        }
+        return (0, exports.runAutoMigration)({ root, manager, pending: entry, dryRun });
+    });
+};
+exports.runPendingMigrations = runPendingMigrations;
+//# sourceMappingURL=run-migrations.js.map

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

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

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

@@ -0,0 +1,19 @@
+/** `-1`, `0` or `1`, prerelease-aware for the `x.y.z-next.N` versions this repo publishes. */
+export declare const compareVersions: (left: string, right: string) => 0 | 1 | -1;
+export declare const isNewer: (candidate: string, than: string) => boolean;
+/** True when `version` sits inside `(after, upTo]`, the range a pending migration is selected by. */
+export declare const isInUpdateRange: (options: {
+    version: string;
+    after: string;
+    upTo: string;
+}) => boolean;
+export declare const isValidVersion: (version: string) => boolean;
+/**
+ * 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.
+ */
+export declare const prereleaseTag: (version: string) => string | undefined;
+/** The `^` or `~` a range keeps, or `''` for an exact one. `undefined` for a range with no single version. */
+export declare const rangePrefix: (range: string) => string | undefined;
+/** The version a range points at, for example `5.0.0-next.46` for `^5.0.0-next.46`. */
+export declare const versionOfRange: (range: string) => string | undefined;

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,75 @@
+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 declare const NEXT_DOCS_BASE_URL = "https://ethlete-sdk-docs-next.web.app";
+/** The docs site of a version's release line: `main` deploys the stable site, `next` the prerelease one. */
+export declare const docsBaseUrl: (version: string) => "https://ethlete-sdk-docs.web.app" | "https://ethlete-sdk-docs-next.web.app";
+/** The agent rules sync of an update that failed, with the command to run again by hand. */
+export type SyncFailure = {
+    command: string;
+    reason: string;
+};
+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;
+    updates?: readonly UpdatedPackage[];
+}) => UpdateTask[];
+export declare const renderTasks: (options: {
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    tasks: readonly UpdateTask[];
+    syncFailure?: SyncFailure;
+}) => 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. A task an earlier
+ * run left is kept while its file is still there.
+ */
+export declare const writeUpdateTasks: (options: {
+    root: string;
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    manager: PackageManager;
+    generatedAt: string;
+    syncFailure?: SyncFailure;
+}) => WrittenTasks;
+/**
+ * Rewrites the task list of an earlier run without the tasks whose file was deleted, and returns the
+ * tasks still open. `undefined` when no run has written a task list.
+ */
+export declare const refreshUpdateTasks: (root: string) => UpdateTask[] | undefined;

package/src/lib/update/tasks.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshUpdateTasks = exports.writeUpdateTasks = exports.renderTaskFile = exports.renderTasks = exports.collectTasks = exports.taskFileName = exports.docsBaseUrl = exports.NEXT_DOCS_BASE_URL = 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");
+const semver_1 = require("./semver");
+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';
+exports.NEXT_DOCS_BASE_URL = 'https://ethlete-sdk-docs-next.web.app';
+/** The docs site of a version's release line: `main` deploys the stable site, `next` the prerelease one. */
+const docsBaseUrl = (version) => ((0, semver_1.prereleaseTag)(version) ? exports.NEXT_DOCS_BASE_URL : exports.DOCS_BASE_URL);
+exports.docsBaseUrl = docsBaseUrl;
+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) => {
+    var _a, _b;
+    const { outcomes, manager, updates = [] } = options;
+    const tasks = [];
+    for (const outcome of outcomes) {
+        const { migration, packageName, manifestPath } = outcome.pending;
+        const source = (0, migration_manifest_1.instructionsPath)({ manifestPath, migration });
+        const target = (_b = (_a = updates.find((update) => update.name === packageName)) === null || _a === void 0 ? void 0 : _a.to) !== null && _b !== void 0 ? _b : migration.version;
+        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 ? `${(0, exports.docsBaseUrl)(target)}${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 appliedOf = (outcomes) => 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,
+    });
+});
+const failedOf = (outcomes) => 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,
+    });
+});
+const renderReport = (options) => {
+    const { updates, applied, failed, tasks, syncFailure } = options;
+    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((codemod) => `- \`${codemod.package}\` ${codemod.name} (${codemod.generator})`),
+                '',
+            ]
+            : []),
+        ...(failed.length > 0
+            ? [
+                'These codemods failed. Run each one again by hand and read its output:',
+                '',
+                ...failed.map((codemod) => `- \`${codemod.package}\` ${codemod.name} — ${codemod.reason}`),
+                '',
+            ]
+            : []),
+        ...(syncFailure
+            ? [
+                `The agent rules sync failed — ${syncFailure.reason}. Run \`${syncFailure.command}\` again by hand and read its output.`,
+                '',
+            ]
+            : []),
+        ...(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');
+};
+const renderTasks = (options) => renderReport({
+    updates: options.updates,
+    applied: appliedOf(options.outcomes),
+    failed: failedOf(options.outcomes),
+    tasks: options.tasks,
+    syncFailure: options.syncFailure,
+});
+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;
+const TASK_KINDS = ['manual', 'assisted', 'unsupported'];
+const isTask = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    return (['packageName', 'name', 'version', 'description'].every((key) => typeof record[key] === 'string') &&
+        typeof record['kind'] === 'string' &&
+        TASK_KINDS.includes(record['kind']));
+};
+const arrayOf = (value) => (Array.isArray(value) ? value : []);
+const readTaskData = (root) => {
+    const path = (0, path_1.join)(root, exports.UPDATE_DIR, exports.TASKS_DATA_FILE);
+    if (!(0, fs_1.existsSync)(path))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const record = parsed;
+    return Object.assign(Object.assign({}, record), { updates: arrayOf(record['updates']), applied: arrayOf(record['applied']), failed: arrayOf(record['failed']), tasks: arrayOf(record['tasks']).filter(isTask) });
+};
+/** Deleting a task file is how a task is done, so a task is open while its file is still there. */
+const openTasksOf = (root, tasks) => tasks.filter((task) => task.instructionsFile && (0, fs_1.existsSync)((0, path_1.join)(root, task.instructionsFile)));
+const unfinishedEarlierTasks = (root) => { var _a, _b; return openTasksOf(root, (_b = (_a = readTaskData(root)) === null || _a === void 0 ? void 0 : _a.tasks) !== null && _b !== void 0 ? _b : []); };
+const sameTask = (left, right) => left.packageName === right.packageName && left.name === right.name;
+/**
+ * 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. A task an earlier
+ * run left is kept while its file is still there.
+ */
+const writeUpdateTasks = (options) => {
+    const { root, updates, outcomes, manager, generatedAt, syncFailure } = options;
+    const collected = (0, exports.collectTasks)({ outcomes, manager, updates });
+    const earlier = unfinishedEarlierTasks(root).filter((task) => !collected.some((next) => sameTask(task, next)));
+    const tasks = [...earlier, ...collected];
+    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 = collected.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, syncFailure }).trimEnd()}\n`, 'utf8');
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, dataPath), `${JSON.stringify(Object.assign(Object.assign({ 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: appliedOf(outcomes), failed: failedOf(outcomes) }, (syncFailure ? { syncFailed: syncFailure } : {})), { tasks }), null, 2)}\n`, 'utf8');
+    return { reportPath, dataPath, tasks };
+};
+exports.writeUpdateTasks = writeUpdateTasks;
+/**
+ * Rewrites the task list of an earlier run without the tasks whose file was deleted, and returns the
+ * tasks still open. `undefined` when no run has written a task list.
+ */
+const refreshUpdateTasks = (root) => {
+    const data = readTaskData(root);
+    if (!data)
+        return undefined;
+    const tasks = openTasksOf(root, data.tasks);
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, exports.UPDATE_DIR, exports.TASKS_FILE), `${renderReport({
+        updates: data.updates.map((update) => { var _a; return ({ name: update.package, from: (_a = update.from) !== null && _a !== void 0 ? _a : undefined, to: update.to }); }),
+        applied: data.applied,
+        failed: data.failed,
+        tasks,
+        syncFailure: data.syncFailed,
+    }).trimEnd()}\n`, 'utf8');
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, exports.UPDATE_DIR, exports.TASKS_DATA_FILE), `${JSON.stringify(Object.assign(Object.assign({}, data), { tasks }), null, 2)}\n`, 'utf8');
+    return tasks;
+};
+exports.refreshUpdateTasks = refreshUpdateTasks;
+//# 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>;