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

package/src/lib/index.js

@@ -4,7 +4,9 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./api"), exports);
 tslib_1.__exportStar(require("./auth"), exports);
 tslib_1.__exportStar(require("./config"), exports);
+tslib_1.__exportStar(require("./design"), exports);
 tslib_1.__exportStar(require("./doctor"), exports);
 tslib_1.__exportStar(require("./invocation"), exports);
 tslib_1.__exportStar(require("./release"), exports);
+tslib_1.__exportStar(require("./update"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,iDAAuB;AACvB,mDAAyB;AACzB,mDAAyB;AACzB,uDAA6B;AAC7B,oDAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,iDAAuB;AACvB,mDAAyB;AACzB,mDAAyB;AACzB,mDAAyB;AACzB,uDAA6B;AAC7B,oDAA0B;AAC1B,mDAAyB"}

package/src/lib/release.js

@@ -4,6 +4,25 @@ exports.release = void 0;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
 const utils_1 = require("./utils");
+const NO_CHANGESETS_MESSAGE = 'No unreleased changesets found';
+const changesetMajorVersion = () => {
+    var _a, _b;
+    const version = (0, child_process_1.execSync)('yarn changeset --version').toString();
+    return Number((_b = (_a = /(\d+)\.\d+\.\d+/.exec(version)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : 0);
+};
+const runChangesetVersion = () => {
+    try {
+        return (0, child_process_1.execSync)('yarn changeset version', { stdio: 'pipe' }).toString();
+    }
+    catch (error) {
+        const { stdout, stderr } = error;
+        const output = `${stdout !== null && stdout !== void 0 ? stdout : ''}${stderr !== null && stderr !== void 0 ? stderr : ''}`;
+        if (!output.includes(NO_CHANGESETS_MESSAGE))
+            throw error;
+        console.error(`${NO_CHANGESETS_MESSAGE}, aborting...\n`);
+        process.exit(1);
+    }
+};
 const release = (args) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
     const shouldForce = args.findIndex((arg) => arg.includes('--force') || arg.includes('-f')) !== -1;
     const skipPush = args.findIndex((arg) => arg.includes('--skip-push') || arg.includes('-sp')) !== -1;
@@ -22,9 +41,8 @@ const release = (args) => tslib_1.__awaiter(void 0, void 0, void 0, function* ()
         console.error('Aborting...');
         process.exit(1);
     }
-    const changesetVersion = (0, child_process_1.execSync)('yarn changeset version').toString();
-    console.log(changesetVersion);
-    const changesetTag = (0, child_process_1.execSync)('yarn changeset tag').toString();
+    console.log(runChangesetVersion());
+    const changesetTag = (0, child_process_1.execSync)(`yarn changeset ${changesetMajorVersion() >= 3 ? 'git-tag' : 'tag'}`).toString();
     console.log(changesetTag);
     (0, child_process_1.execSync)('git add .');
     console.log('Committing release... 🚀 \n(This may take a while depending on your pre-commit hooks) \n');

package/src/lib/release.js.map

@@ -1 +1 @@
-{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/release.ts"],"names":[],"mappings":";;;;AAAA,iDAAyC;AACzC,mCAAsC;AAE/B,MAAM,OAAO,GAAG,CAAO,IAAc,EAAE,EAAE;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAClG,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpG,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAE7D,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAW,EAC9B,2KAA2K,CAC5K,CAAC;IAEF,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAA,wBAAQ,EAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEvE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE9B,MAAM,YAAY,GAAG,IAAA,wBAAQ,EAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAE/D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE1B,IAAA,wBAAQ,EAAC,WAAW,CAAC,CAAC;IAEtB,OAAO,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC;IAExG,IAAA,wBAAQ,EAAC,kCAAkC,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAA,wBAAQ,EAAC,wBAAwB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC,CAAA,CAAC;AA5CW,QAAA,OAAO,WA4ClB"}
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/release.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import { UpdateTask } from './tasks';
+/** Where the agent command sits in `ethlete.config.local.json`. */
+export declare const AGENT_COMMAND_KEY = "updateAgentCommand";
+/** What the command template is asked to hold, so the prompt can go anywhere in it. */
+export declare const PROMPT_PLACEHOLDER = "<prompt>";
+/**
+ * The command that hands one task to an agent. `<prompt>` becomes the path of the task file; a template
+ * without it gets the path appended, which is what a plain `claude -p` needs.
+ */
+export declare const agentCommand: (options: {
+    template: string;
+    promptPath: string;
+}) => string;
+export type AgentRun = {
+    task: UpdateTask;
+    command: string;
+    ok: boolean;
+    reason?: string;
+};
+/** The tasks an agent can work on: the ones whose instructions were written as a prompt. */
+export declare const assistedTasks: (tasks: readonly UpdateTask[]) => UpdateTask[];
+/**
+ * Runs the configured agent once per assisted task, in order, so each run has one change to make. The
+ * command is a user-written string, so it runs through a shell.
+ */
+export declare const runAgentTasks: (options: {
+    root: string;
+    template: string;
+    tasks: readonly UpdateTask[];
+}) => AgentRun[];

package/src/lib/update/ai.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgentTasks = exports.assistedTasks = exports.agentCommand = exports.PROMPT_PLACEHOLDER = exports.AGENT_COMMAND_KEY = void 0;
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+/** Where the agent command sits in `ethlete.config.local.json`. */
+exports.AGENT_COMMAND_KEY = 'updateAgentCommand';
+/** What the command template is asked to hold, so the prompt can go anywhere in it. */
+exports.PROMPT_PLACEHOLDER = '<prompt>';
+/**
+ * The command that hands one task to an agent. `<prompt>` becomes the path of the task file; a template
+ * without it gets the path appended, which is what a plain `claude -p` needs.
+ */
+const agentCommand = (options) => {
+    const { template, promptPath } = options;
+    const quoted = /\s/.test(promptPath) ? `"${promptPath}"` : promptPath;
+    return template.includes(exports.PROMPT_PLACEHOLDER)
+        ? template.split(exports.PROMPT_PLACEHOLDER).join(quoted)
+        : `${template} ${quoted}`;
+};
+exports.agentCommand = agentCommand;
+/** The tasks an agent can work on: the ones whose instructions were written as a prompt. */
+const assistedTasks = (tasks) => tasks.filter((task) => task.kind === 'assisted' && task.instructionsFile !== undefined);
+exports.assistedTasks = assistedTasks;
+/**
+ * Runs the configured agent once per assisted task, in order, so each run has one change to make. The
+ * command is a user-written string, so it runs through a shell.
+ */
+const runAgentTasks = (options) => {
+    const { root, template, tasks } = options;
+    return (0, exports.assistedTasks)(tasks).map((task) => {
+        var _a;
+        const command = (0, exports.agentCommand)({ template, promptPath: (0, path_1.join)(root, (_a = task.instructionsFile) !== null && _a !== void 0 ? _a : '') });
+        console.log(`\n  ${command}`);
+        const result = (0, child_process_1.spawnSync)(command, { cwd: root, stdio: 'inherit', shell: true });
+        if (result.error)
+            return { task, command, ok: false, reason: result.error.message };
+        if (result.status !== 0)
+            return { task, command, ok: false, reason: `exited with ${result.status}` };
+        return { task, command, ok: true };
+    });
+};
+exports.runAgentTasks = runAgentTasks;
+//# sourceMappingURL=ai.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/ai.ts"],"names":[],"mappings":";;;AAAA,iDAA0C;AAC1C,+BAA4B;AAG5B,mEAAmE;AACtD,QAAA,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD,uFAAuF;AAC1E,QAAA,kBAAkB,GAAG,UAAU,CAAC;AAE7C;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,OAAiD,EAAE,EAAE;IAChF,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;IAEtE,OAAO,QAAQ,CAAC,QAAQ,CAAC,0BAAkB,CAAC;QAC1C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,0BAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACjD,CAAC,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;AAC9B,CAAC,CAAC;AAPW,QAAA,YAAY,gBAOvB;AASF,4FAA4F;AACrF,MAAM,aAAa,GAAG,CAAC,KAA4B,EAAE,EAAE,CAC5D,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC;AAD7E,QAAA,aAAa,iBACgE;AAE1F;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,OAI7B,EAAc,EAAE;IACf,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1C,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;;QACvC,MAAM,OAAO,GAAG,IAAA,oBAAY,EAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,MAAA,IAAI,CAAC,gBAAgB,mCAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAEhG,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAEpF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAErG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AApBW,QAAA,aAAa,iBAoBxB"}

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

@@ -0,0 +1,21 @@
+export type UpdateArgs = {
+    /** Full package names the run is limited to. Empty means every `@ethlete/*` the manifest declares. */
+    packages: string[];
+    tag?: string;
+    /** A single version named with `--to`. */
+    version?: string;
+    /** The version the migrations of a package run from, keyed by full package name. */
+    from: Record<string, string>;
+    check: boolean;
+    dryRun: boolean;
+    install: boolean;
+    resume: boolean;
+    ai: boolean;
+    force: boolean;
+    help: boolean;
+    problems: string[];
+};
+/** `core` and `@ethlete/core` both name the same package on the command line. */
+export declare const fullPackageName: (name: string) => string;
+/** Reads the flags of `et update`, collecting every problem so one run reports them all. */
+export declare const parseUpdateArgs: (argv: readonly string[]) => UpdateArgs;

package/src/lib/update/args.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUpdateArgs = exports.fullPackageName = void 0;
+const packages_1 = require("./packages");
+const VALUE_FLAGS = ['--tag', '--to', '--from'];
+const BOOLEAN_FLAGS = ['--check', '--dry-run', '--no-install', '--continue', '--ai', '--force', '--help', '-h'];
+/** `core` and `@ethlete/core` both name the same package on the command line. */
+const fullPackageName = (name) => (name.includes('/') ? name : `${packages_1.ETHLETE_SCOPE}${name}`);
+exports.fullPackageName = fullPackageName;
+const splitFlag = (argument) => {
+    const separator = argument.indexOf('=');
+    return separator === -1
+        ? { flag: argument, inline: undefined }
+        : { flag: argument.slice(0, separator), inline: argument.slice(separator + 1) };
+};
+/** Reads the flags of `et update`, collecting every problem so one run reports them all. */
+const parseUpdateArgs = (argv) => {
+    var _a;
+    const args = {
+        packages: [],
+        from: {},
+        check: false,
+        dryRun: false,
+        install: true,
+        resume: false,
+        ai: false,
+        force: false,
+        help: false,
+        problems: [],
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = (_a = argv[index]) !== null && _a !== void 0 ? _a : '';
+        if (!argument.startsWith('-')) {
+            args.packages.push((0, exports.fullPackageName)(argument));
+            continue;
+        }
+        const { flag, inline } = splitFlag(argument);
+        if (VALUE_FLAGS.includes(flag)) {
+            const value = inline !== null && inline !== void 0 ? inline : argv[index + 1];
+            if (inline === undefined)
+                index += 1;
+            if (value === undefined || value.startsWith('-')) {
+                args.problems.push(`${flag} needs a value.`);
+                continue;
+            }
+            if (flag === '--tag')
+                args.tag = value;
+            if (flag === '--to')
+                args.version = value;
+            if (flag === '--from') {
+                const separator = value.lastIndexOf('@');
+                const name = separator > 0 ? value.slice(0, separator) : undefined;
+                const version = separator > 0 ? value.slice(separator + 1) : undefined;
+                if (!name || !version)
+                    args.problems.push(`--from needs <package>@<version>, not "${value}".`);
+                else
+                    args.from[(0, exports.fullPackageName)(name)] = version;
+            }
+            continue;
+        }
+        if (!BOOLEAN_FLAGS.includes(flag)) {
+            args.problems.push(`Unknown flag "${flag}".`);
+            continue;
+        }
+        if (flag === '--check')
+            args.check = true;
+        if (flag === '--dry-run')
+            args.dryRun = true;
+        if (flag === '--no-install')
+            args.install = false;
+        if (flag === '--continue')
+            args.resume = true;
+        if (flag === '--ai')
+            args.ai = true;
+        if (flag === '--force')
+            args.force = true;
+        if (flag === '--help' || flag === '-h')
+            args.help = true;
+    }
+    if (args.version !== undefined && args.tag !== undefined) {
+        args.problems.push('--to and --tag ask for different targets. Pass one of them.');
+    }
+    if (args.version !== undefined && args.packages.length !== 1) {
+        args.problems.push('--to sets the version of one package, so name that package.');
+    }
+    return args;
+};
+exports.parseUpdateArgs = parseUpdateArgs;
+//# sourceMappingURL=args.js.map

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

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

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

@@ -0,0 +1,12 @@
+export * from './ai';
+export * from './args';
+export * from './migration-manifest';
+export * from './package-manager';
+export * from './packages';
+export * from './pending';
+export * from './plan';
+export * from './registry';
+export * from './run-migrations';
+export * from './semver';
+export * from './tasks';
+export * from './update-command';

package/src/lib/update/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./ai"), exports);
+tslib_1.__exportStar(require("./args"), exports);
+tslib_1.__exportStar(require("./migration-manifest"), 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("./semver"), exports);
+tslib_1.__exportStar(require("./tasks"), exports);
+tslib_1.__exportStar(require("./update-command"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,40 @@
+/** The `package.json` field a package points at its own migration manifest with. */
+export declare const MIGRATIONS_MANIFEST_KEY = "ethlete";
+export declare const MIGRATION_KINDS: readonly ["auto", "manual", "assisted"];
+export type MigrationKind = (typeof MIGRATION_KINDS)[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;
+    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>;
+    /** Markdown next to the manifest: the recommendation for `manual`, the prompt for `assisted`. */
+    instructions?: string;
+    /** Path on the docs site, for example `/components/button`. */
+    docs?: string;
+};
+export type PackageMigrations = {
+    packageName: string;
+    migrations: Migration[];
+    /** Where the manifest was read from, so an instructions path can be resolved against it. */
+    manifestPath?: string;
+    problems: string[];
+};
+/**
+ * The migrations an installed package ships, read from the manifest its `package.json` points at.
+ * A package that declares none is not a problem — most versions need no migration.
+ */
+export declare const readPackageMigrations: (options: {
+    root: string;
+    packageName: string;
+}) => PackageMigrations;
+/** The absolute path of a migration's instructions file, or `undefined` when it names none. */
+export declare const instructionsPath: (options: {
+    manifestPath?: string;
+    migration: Migration;
+}) => string | undefined;

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

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instructionsPath = exports.readPackageMigrations = 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'];
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const readJson = (path) => {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const readString = (record, key) => {
+    const value = record[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+};
+const readOptions = (value) => {
+    if (!isRecord(value))
+        return undefined;
+    const options = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean')
+            options[key] = entry;
+    }
+    return options;
+};
+const parseEntry = (options) => {
+    const { value, origin, index } = options;
+    const at = `${origin} entry ${index}`;
+    if (!isRecord(value))
+        return { problem: `${at} is not an object.` };
+    const name = readString(value, 'name');
+    const version = readString(value, 'version');
+    const kind = readString(value, 'kind');
+    const description = readString(value, 'description');
+    if (!name)
+        return { problem: `${at} has no "name".` };
+    if (!version)
+        return { problem: `${origin} "${name}" has no "version".` };
+    if (!(0, semver_1.isValidVersion)(version))
+        return { problem: `${origin} "${name}" has an invalid version "${version}".` };
+    if (!kind)
+        return { problem: `${origin} "${name}" has no "kind".` };
+    if (!exports.MIGRATION_KINDS.includes(kind)) {
+        return { problem: `${origin} "${name}" has kind "${kind}" — use one of ${exports.MIGRATION_KINDS.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 (kind === 'assisted' && !instructions) {
+        return { problem: `${origin} "${name}" is assisted but names no "instructions" file.` };
+    }
+    return {
+        migration: {
+            name,
+            version,
+            kind: kind,
+            description,
+            generator,
+            options: readOptions(value['options']),
+            instructions,
+            docs: readString(value, 'docs'),
+        },
+    };
+};
+const parseManifest = (options) => {
+    const { source, origin, packageName } = options;
+    if (!isRecord(source))
+        return { packageName, migrations: [], problems: [`${origin} is not a JSON object.`] };
+    const entries = source['migrations'];
+    if (!Array.isArray(entries))
+        return { packageName, migrations: [], problems: [`${origin} has no "migrations" array.`] };
+    const migrations = [];
+    const problems = [];
+    const seen = new Set();
+    entries.forEach((value, index) => {
+        const parsed = parseEntry({ value, origin, index });
+        if (parsed.problem !== undefined) {
+            problems.push(parsed.problem);
+            return;
+        }
+        const { migration } = parsed;
+        if (seen.has(migration.name)) {
+            problems.push(`${origin} declares "${migration.name}" twice.`);
+            return;
+        }
+        seen.add(migration.name);
+        migrations.push(migration);
+    });
+    return { packageName, migrations, problems };
+};
+/**
+ * The migrations an installed package ships, read from the manifest its `package.json` points at.
+ * A package that declares none is not a problem — most versions need no migration.
+ */
+const readPackageMigrations = (options) => {
+    const { root, packageName } = options;
+    const packageJsonPath = (0, path_1.join)(root, 'node_modules', ...packageName.split('/'), 'package.json');
+    if (!(0, fs_1.existsSync)(packageJsonPath)) {
+        return { packageName, migrations: [], problems: [`${packageName} is not installed.`] };
+    }
+    const packageJson = readJson(packageJsonPath);
+    const field = isRecord(packageJson) ? packageJson[exports.MIGRATIONS_MANIFEST_KEY] : undefined;
+    const declared = isRecord(field) ? field['migrations'] : undefined;
+    if (typeof declared !== 'string')
+        return { packageName, migrations: [], problems: [] };
+    const manifestPath = (0, path_1.resolve)((0, path_1.dirname)(packageJsonPath), declared);
+    if (!(0, fs_1.existsSync)(manifestPath)) {
+        return {
+            packageName,
+            migrations: [],
+            problems: [`${packageName} points "${exports.MIGRATIONS_MANIFEST_KEY}.migrations" at ${manifestPath}, which is missing.`],
+        };
+    }
+    return Object.assign(Object.assign({}, parseManifest({ source: readJson(manifestPath), origin: `${packageName} migrations.json`, packageName })), { manifestPath });
+};
+exports.readPackageMigrations = readPackageMigrations;
+/** The absolute path of a migration's instructions file, or `undefined` when it names none. */
+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;
+//# sourceMappingURL=migration-manifest.js.map

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

@@ -0,0 +1 @@
+{"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/package-manager.d.ts

@@ -0,0 +1,23 @@
+import { Manifest } from './packages';
+export type PackageManagerName = 'yarn' | 'pnpm' | 'bun' | 'npm';
+export type PackageManager = {
+    name: PackageManagerName;
+    /** The command that installs what `package.json` declares. */
+    install: string[];
+    /** How this manager runs a binary from `node_modules`, for example `yarn nx`. */
+    run: string[];
+};
+/**
+ * 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.
+ */
+export declare const detectPackageManager: (options: {
+    root: string;
+    manifest?: Manifest;
+    env?: NodeJS.ProcessEnv;
+}) => PackageManager;
+/** 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[];

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxCommand = exports.detectPackageManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const MANAGERS = {
+    yarn: { name: 'yarn', install: ['yarn', 'install'], run: ['yarn'] },
+    pnpm: { name: 'pnpm', install: ['pnpm', 'install'], run: ['pnpm', 'exec'] },
+    bun: { name: 'bun', install: ['bun', 'install'], run: ['bunx'] },
+    npm: { name: 'npm', install: ['npm', 'install'], run: ['npx'] },
+};
+const LOCKFILES = [
+    ['yarn.lock', 'yarn'],
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['bun.lockb', 'bun'],
+    ['bun.lock', 'bun'],
+    ['package-lock.json', 'npm'],
+];
+const declaredName = (manifest, userAgent) => {
+    var _a;
+    const declared = (_a = manifest === null || manifest === void 0 ? void 0 : manifest.packageManager) !== null && _a !== void 0 ? _a : userAgent;
+    return declared
+        ? Object.keys(MANAGERS).find((name) => declared.startsWith(name))
+        : undefined;
+};
+/**
+ * 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.
+ */
+const detectPackageManager = (options) => {
+    var _a;
+    const { root, manifest, env = process.env } = options;
+    const declared = declaredName(manifest, env['npm_config_user_agent']);
+    if (declared)
+        return MANAGERS[declared];
+    const found = LOCKFILES.find(([fileName]) => (0, fs_1.existsSync)((0, path_1.join)(root, fileName)));
+    return MANAGERS[(_a = found === null || found === void 0 ? void 0 : found[1]) !== null && _a !== void 0 ? _a : 'npm'];
+};
+exports.detectPackageManager = detectPackageManager;
+/** The command that runs an `nx` from this repo, for example `yarn nx generate …`. */
+const nxCommand = (options) => [
+    ...options.manager.run,
+    'nx',
+    ...options.args,
+];
+exports.nxCommand = nxCommand;
+//# sourceMappingURL=package-manager.js.map

package/src/lib/update/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/package-manager.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,+BAA4B;AAa5B,MAAM,QAAQ,GAA+C;IAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;IACnE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAC3E,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;IAChE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE;CAChE,CAAC;AAEF,MAAM,SAAS,GAAmC;IAChD,CAAC,WAAW,EAAE,MAAM,CAAC;IACrB,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAC7B,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAA8B,EAAE,SAA6B,EAAE,EAAE;;IACrF,MAAM,QAAQ,GAAG,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,cAAc,mCAAI,SAAS,CAAC;IAEvD,OAAO,QAAQ;QACb,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAA0B,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3F,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAAC,OAIpC,EAAkB,EAAE;;IACnB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAEtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/E,OAAO,QAAQ,CAAC,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAG,CAAC,CAAC,mCAAI,KAAK,CAAC,CAAC;AACvC,CAAC,CAAC;AAbW,QAAA,oBAAoB,wBAa/B;AAEF,sFAAsF;AAC/E,MAAM,SAAS,GAAG,CAAC,OAA6D,EAAE,EAAE,CAAC;IAC1F,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG;IACtB,IAAI;IACJ,GAAG,OAAO,CAAC,IAAI;CAChB,CAAC;AAJW,QAAA,SAAS,aAIpB"}

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

@@ -0,0 +1,65 @@
+export declare const ETHLETE_SCOPE = "@ethlete/";
+export declare const ROOT_MANIFEST = "package.json";
+export declare const DEPENDENCY_FIELDS: readonly ["dependencies", "devDependencies", "peerDependencies"];
+export type DependencyField = (typeof DEPENDENCY_FIELDS)[number];
+export type Manifest = Partial<Record<DependencyField, Record<string, string>>> & {
+    packageManager?: string;
+};
+/** One place a manifest declares a package: which file, which field, and the range written there. */
+export type DeclaredSite = {
+    /** Relative to the root, with `/` separators. `package.json` for the root manifest. */
+    manifestPath: string;
+    field: DependencyField;
+    range: string;
+    /** The version the range points at, or `undefined` for a range no single version can be read from. */
+    declaredVersion?: string;
+};
+export type DeclaredPackage = {
+    name: string;
+    /** Every field of every manifest in the repo that declares this package. */
+    sites: DeclaredSite[];
+    /** The version in `node_modules`, which is what the migrations of an update run against. */
+    installedVersion?: string;
+};
+export declare const manifestPath: (root: string) => string;
+export declare const readManifest: (root: string, relativePath?: string) => Manifest | undefined;
+/**
+ * Every `package.json` in the repo, root first. An Nx repo keeps a manifest per buildable library, and
+ * those pin `@ethlete/*` too, so an update that only rewrites the root leaves the rest behind.
+ */
+export declare const findManifests: (root: string) => string[];
+/** The version of `packageName` in `node_modules`, which is the one the running code came from. */
+export declare const installedVersion: (root: string, packageName: string) => string | undefined;
+/**
+ * The version an update starts from when nothing is installed: the newest one any manifest declares, so
+ * a library manifest that lags behind the root does not read as the current version.
+ */
+export declare const newestDeclaredVersion: (sites: readonly DeclaredSite[]) => string | undefined;
+/** Every `@ethlete/*` dependency the repo declares, gathered across all of its manifests. */
+export declare const declaredEthletePackages: (options: {
+    root: string;
+    manifests?: readonly string[];
+}) => DeclaredPackage[];
+export type RangeWrite = {
+    name: string;
+    manifestPath: string;
+    field: DependencyField;
+    range: string;
+};
+/**
+ * Writes new ranges into the manifests they came from, keeping each file's indentation. A whole file is
+ * re-serialised, so a comment or a key order the parser cannot represent would not survive -
+ * `package.json` holds neither.
+ */
+export declare const writeRanges: (options: {
+    root: string;
+    writes: readonly RangeWrite[];
+}) => string[];
+/**
+ * The range that carries `version` while keeping how the declared one was written, for example `^`.
+ * `undefined` for a range this cannot rewrite safely, such as `workspace:*` or `>=5 <6`.
+ */
+export declare const rangeFor: (options: {
+    current: string;
+    version: string;
+}) => string | undefined;