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

package/src/lib/design/serve.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveDesign = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const calls_tsconfig_1 = require("./calls-tsconfig");
+const paths_1 = require("./paths");
+const VIRTUAL = 'virtual:design-explore';
+/** What a slug says about which project drew it: its first segment. */
+const projectOf = (slug) => { var _a; return (_a = slug.split('/')[0]) !== null && _a !== void 0 ? _a : ''; };
+const fsUrl = (target, path) => `/@fs/${(0, path_1.resolve)(target, path).replace(/^\//, '')}`;
+const registry = (target, config) => {
+    var _a;
+    const root = (0, paths_1.callsRootOf)(target);
+    const entries = (0, fs_1.globSync)('**/call.ts', { cwd: root })
+        .sort()
+        .map((file) => [(0, path_1.dirname)(file), fsUrl(target, (0, path_1.resolve)(root, file))]);
+    return `export const calls = {\n${entries
+        .map(([slug, url]) => `  ${JSON.stringify(slug)}: () => import(${JSON.stringify(url)}),`)
+        .join('\n')}\n};\nexport const defaultCall = ${JSON.stringify((_a = config.defaultCall) !== null && _a !== void 0 ? _a : null)};\n`;
+};
+/**
+ * Vite's own tsconfigPaths resolves against the tsconfig nearest the importing file, which is not
+ * the one that carries the workspace paths. The aliases are read from the base config instead.
+ */
+const workspaceAliases = (target) => {
+    var _a, _b;
+    const basePath = (0, path_1.resolve)(target, 'tsconfig.base.json');
+    if (!(0, fs_1.existsSync)(basePath))
+        return [];
+    const base = JSON.parse((0, fs_1.readFileSync)(basePath, 'utf8'));
+    const paths = (_b = (_a = base.compilerOptions) === null || _a === void 0 ? void 0 : _a.paths) !== null && _b !== void 0 ? _b : {};
+    return Object.entries(paths).flatMap(([key, [mapped]]) => {
+        if (!mapped)
+            return [];
+        return [
+            {
+                find: key.endsWith('/*') ? new RegExp(`^${key.slice(0, -2)}/`) : new RegExp(`^${key}$`),
+                replacement: key.endsWith('/*') ? `${(0, path_1.resolve)(target, mapped.slice(0, -2))}/` : (0, path_1.resolve)(target, mapped),
+            },
+        ];
+    });
+};
+/**
+ * The stylesheet of every project, each behind its own loader. A frame loads the one its call
+ * belongs to: two projects define the same theme variables, so a frame that loaded both would
+ * draw under whichever stylesheet came last.
+ */
+const env = (target, config) => {
+    var _a;
+    const loaders = Object.entries((_a = config.projects) !== null && _a !== void 0 ? _a : {}).map(([name, project]) => {
+        var _a;
+        return `  ${JSON.stringify(name)}: () => Promise.all([${((_a = project.styles) !== null && _a !== void 0 ? _a : [])
+            .map((style) => `import(${JSON.stringify(fsUrl(target, style))})`)
+            .join(', ')}]),`;
+    });
+    return (`const envs = {\n${loaders.join('\n')}\n};\n` +
+        `export const loadEnv = (project) => (envs[project] ?? (() => Promise.resolve()))();\n`);
+};
+/** Serves the call registry and each project's global stylesheet to the web pages. */
+const designExplore = (target, config) => ({
+    name: 'design-explore',
+    resolveId: (id) => (id === VIRTUAL || id === `${VIRTUAL}/env` ? `\0${id}` : null),
+    load: (id) => {
+        if (id === `\0${VIRTUAL}`)
+            return registry(target, config);
+        if (id === `\0${VIRTUAL}/env`)
+            return env(target, config);
+        return null;
+    },
+    transformIndexHtml: {
+        order: 'pre',
+        handler: (html, ctx) => {
+            var _a, _b, _c, _d;
+            if (!ctx.path.includes('frame'))
+                return html;
+            const asked = new URL((_a = ctx.originalUrl) !== null && _a !== void 0 ? _a : ctx.path, 'http://localhost');
+            const head = (_d = (_b = config.projects) === null || _b === void 0 ? void 0 : _b[projectOf((_c = asked.searchParams.get('call')) !== null && _c !== void 0 ? _c : '')]) === null || _d === void 0 ? void 0 : _d.head;
+            if (!head)
+                return html;
+            return html.replace('<!--head-->', (0, fs_1.readFileSync)((0, path_1.resolve)(target, head), 'utf8'));
+        },
+    },
+    /** The registry is built once per load, so a new call folder is invisible until it is invalidated. */
+    configureServer: (vite) => {
+        const callsRoot = (0, paths_1.callsRootOf)(target);
+        const refresh = (file) => {
+            if (!file.startsWith(callsRoot) || !file.endsWith('/call.ts'))
+                return;
+            const module = vite.moduleGraph.getModuleById(`\0${VIRTUAL}`);
+            if (module)
+                vite.moduleGraph.invalidateModule(module);
+            vite.ws.send({ type: 'full-reload' });
+        };
+        vite.watcher.add(callsRoot);
+        vite.watcher.on('add', refresh);
+        vite.watcher.on('unlink', refresh);
+    },
+});
+/**
+ * Starts the design page for a checkout and keeps it running. The returned exit code is the
+ * command's, not the server's: a listening server holds the process open on its own.
+ */
+const serveDesign = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { target } = options;
+    const config = (0, paths_1.readConfig)(target);
+    if (!config) {
+        console.error(`design-explore: no config at ${(0, paths_1.configPathOf)(target)}`);
+        return 1;
+    }
+    (0, calls_tsconfig_1.writeCallsTsconfig)(target);
+    // Vite reads a tsconfig out of the working directory to transpile a call, and the calls sit
+    // outside its root. From a directory that holds none, every call compiles to an empty module.
+    process.chdir(target);
+    const { createServer } = yield import('vite');
+    const { default: tailwind } = yield import('@tailwindcss/postcss');
+    const here = (0, paths_1.assetRoot)();
+    const server = yield createServer({
+        configFile: false,
+        root: (0, path_1.resolve)(here, 'web'),
+        // Every drawing is ruled under Tailwind 4, whatever the checkout installs. The tool brings its
+        // own pipeline so no checkout's postcss config reaches a drawing.
+        css: { postcss: { plugins: [tailwind()] } },
+        cacheDir: (0, path_1.resolve)((0, paths_1.workRootOf)(target), 'vite'),
+        resolve: {
+            alias: [{ find: /^@design-explore$/, replacement: (0, path_1.resolve)(here, 'define-call.ts') }, ...workspaceAliases(target)],
+        },
+        plugins: [designExplore(target, config)],
+        server: {
+            port: (0, paths_1.portOf)(config),
+            strictPort: true,
+            // The web pages live inside this package, which is outside the checkout it draws. Vite
+            // serves neither root unless both are allowed.
+            fs: { allow: [target, here] },
+        },
+    });
+    yield server.listen();
+    console.log(`design-explore: drawing ${target}`);
+    server.printUrls();
+    return 0;
+});
+exports.serveDesign = serveDesign;
+//# sourceMappingURL=serve.js.map

package/src/lib/design/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/serve.ts"],"names":[],"mappings":";;;;AAAA,2BAAwD;AACxD,+BAAwC;AACxC,qDAAsD;AACtD,mCAA6G;AAI7G,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC,uEAAuE;AACvE,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC;AAE7D,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,QAAQ,IAAA,cAAO,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AAEnG,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,MAAoB,EAAE,EAAE;;IACxD,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAA,aAAQ,EAAC,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;SAClD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,IAAA,cAAO,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE,OAAO,2BAA2B,OAAO;SACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;SACxF,IAAI,CAAC,IAAI,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,MAAA,MAAM,CAAC,WAAW,mCAAI,IAAI,CAAC,KAAK,CAAC;AACnG,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,EAAE;;IAC1C,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAEvD,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAA+D,CAAC;IACtH,MAAM,KAAK,GAAG,MAAA,MAAA,IAAI,CAAC,eAAe,0CAAE,KAAK,mCAAI,EAAE,CAAC;IAEhD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE;QACvD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,OAAO;YACL;gBACE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;gBACvF,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAA,cAAO,EAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,cAAO,EAAC,MAAM,EAAE,MAAM,CAAC;aACvG;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,MAAoB,EAAE,EAAE;;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAA,MAAM,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,GAAG,CACvD,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;;QAClB,OAAA,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAA,OAAO,CAAC,MAAM,mCAAI,EAAE,CAAC;aACpE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC;aACjE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAA;KAAA,CACrB,CAAC;IAEF,OAAO,CACL,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ;QAC7C,uFAAuF,CACxF,CAAC;AACJ,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,MAAoB,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE;QACnB,IAAI,EAAE,KAAK,KAAK,OAAO,EAAE;YAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,EAAE,KAAK,KAAK,OAAO,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,KAAc;QACrB,OAAO,EAAE,CAAC,IAAY,EAAE,GAA2C,EAAE,EAAE;;YACrE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;YAE7C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAA,GAAG,CAAC,WAAW,mCAAI,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;YACvE,MAAM,IAAI,GAAG,MAAA,MAAA,MAAM,CAAC,QAAQ,0CAAG,SAAS,CAAC,MAAA,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,EAAE,CAAC,CAAC,0CAAE,IAAI,CAAC;YAEtF,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEvB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAA,iBAAY,EAAC,IAAA,cAAO,EAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAClF,CAAC;KACF;IACD,sGAAsG;IACtG,eAAe,EAAE,CAAC,IAAmB,EAAE,EAAE;QACvC,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO;YAEtE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;YAC9D,IAAI,MAAM;gBAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAO,OAA2B,EAAmB,EAAE;IAChF,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;IAElC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAA,oBAAY,EAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAA,mCAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,4FAA4F;IAC5F,8FAA8F;IAC9F,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAA,iBAAS,GAAE,CAAC;IAEzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,IAAA,cAAO,EAAC,IAAI,EAAE,KAAK,CAAC;QAC1B,+FAA+F;QAC/F,kEAAkE;QAClE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE;QAC3C,QAAQ,EAAE,IAAA,cAAO,EAAC,IAAA,kBAAU,EAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAC7C,OAAO,EAAE;YACP,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,IAAA,cAAO,EAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;SAClH;QACD,OAAO,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,EAAE;YACN,IAAI,EAAE,IAAA,cAAM,EAAC,MAAM,CAAC;YACpB,UAAU,EAAE,IAAI;YAChB,uFAAuF;YACvF,+CAA+C;YAC/C,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;SAC9B;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,SAAS,EAAE,CAAC;IAEnB,OAAO,CAAC,CAAC;AACX,CAAC,CAAA,CAAC;AA7CW,QAAA,WAAW,eA6CtB"}

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

@@ -0,0 +1,7 @@
+import { ComposeTool } from '../api/compose';
+/** Reports every problem with this machine's setup, so `et api` does not have to find them one at a time. */
+export declare const doctorCommand: ({ root, apiInvocation, composeTools, }: {
+    root: string;
+    apiInvocation?: string;
+    composeTools?: ComposeTool[];
+}) => 0 | 1;

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = void 0;
+const compose_1 = require("../api/compose");
+const path_1 = require("path");
+const load_definitions_1 = require("../api/load-definitions");
+const resolve_checkout_1 = require("../api/resolve-checkout");
+const diagnose_1 = require("../config/diagnose");
+const local_config_1 = require("../config/local-config");
+const indent = (text) => text.replace(/\n/g, '\n    ');
+const describeComposeTool = (composeTools) => {
+    const tool = (0, compose_1.resolveComposeTool)(composeTools);
+    return tool
+        ? { line: `container engine: ${(0, compose_1.composeBinary)(tool.compose).join(' ')}`, problems: [] }
+        : { line: undefined, problems: [`No compose tool found. Tried: ${(0, compose_1.composeToolNames)(composeTools).join(', ')}.`] };
+};
+const describeApis = (root, apiInvocation) => {
+    const { found, apis, fileName } = (0, load_definitions_1.loadApiDefinitions)(root);
+    if (!found)
+        return { lines: [], problems: [] };
+    const lines = [];
+    const problems = [];
+    for (const [name, api] of Object.entries(apis)) {
+        const checkout = (0, resolve_checkout_1.resolveApiCheckout)({ root, name, api });
+        if (checkout.ok) {
+            lines.push(`${fileName}: ${name} → ${checkout.checkout.composePath}`);
+        }
+        else {
+            problems.push((0, resolve_checkout_1.checkoutProblem)({ failure: checkout, name, invocation: apiInvocation }));
+        }
+    }
+    return { lines, problems };
+};
+/** Reports every problem with this machine's setup, so `et api` does not have to find them one at a time. */
+const doctorCommand = ({ root, apiInvocation = 'et api', composeTools, }) => {
+    // A file that exists but cannot be parsed still has to be reported, so this asks whether the file
+    // is there rather than whether it could be read.
+    const hasConfig = [local_config_1.LOCAL_CONFIG_FILE_NAME, local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME].some((fileName) => (0, local_config_1.readLocalConfigFile)((0, path_1.join)(root, fileName)).status !== 'absent');
+    const hasApis = (0, load_definitions_1.loadApiDefinitions)(root).found;
+    if (!hasConfig && !hasApis) {
+        console.log(`Nothing to check: ${root} has no ${local_config_1.LOCAL_CONFIG_FILE_NAME} and no ${load_definitions_1.API_DEFINITIONS_FILE_NAMES[0]}.`);
+        return 0;
+    }
+    const configProblems = (0, diagnose_1.diagnoseLocalConfig)({ root });
+    const compose = describeComposeTool(composeTools);
+    const apis = describeApis(root, apiInvocation);
+    const problems = [...configProblems, ...compose.problems, ...apis.problems];
+    for (const line of [compose.line, ...apis.lines].filter(Boolean)) {
+        console.log(`  ${line}`);
+    }
+    if (problems.length === 0) {
+        console.log('\nNo problems found.');
+        return 0;
+    }
+    console.error(`\n${problems.length} problem(s):\n`);
+    for (const problem of problems) {
+        console.error(`  - ${indent(problem)}`);
+    }
+    return 1;
+};
+exports.doctorCommand = doctorCommand;
+//# sourceMappingURL=doctor-command.js.map

package/src/lib/doctor/doctor-command.js.map

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

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

@@ -0,0 +1 @@
+export * from './doctor-command';

package/src/lib/doctor/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./doctor-command"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/doctor/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC"}

package/src/lib/index.d.ts

@@ -1 +1,8 @@
+export * from './api';
+export * from './auth';
+export * from './config';
+export * from './design';
+export * from './doctor';
+export * from './invocation';
 export * from './release';
+export * from './update';

package/src/lib/index.js

@@ -1,5 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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,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/invocation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What the reader of a message can type to reach `et <subcommand>` in this repo, because `et` itself
+ * is rarely on the PATH: the package script that wraps it, or the package manager's own way to run
+ * the binary, for example `npx et api`.
+ */
+export declare const repoInvocation: (options: {
+    root: string;
+    subcommand: string;
+}) => string;

package/src/lib/invocation.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repoInvocation = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * How each package manager runs a script, and how it runs a binary from `node_modules` when no
+ * script wraps it.
+ */
+const RUNNERS = [
+    { name: 'yarn', script: 'yarn', binary: 'yarn et' },
+    { name: 'pnpm', script: 'pnpm', binary: 'pnpm exec et' },
+    { name: 'bun', script: 'bun run', binary: 'bunx et' },
+    { name: 'npm', script: 'npm run', binary: 'npx et' },
+];
+const readManifest = (root) => {
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(root, 'package.json'), 'utf8'));
+    }
+    catch (_a) {
+        return {};
+    }
+    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed) ? parsed : {};
+};
+const runnerFor = (manifest) => {
+    var _a;
+    const declared = (_a = manifest.packageManager) !== null && _a !== void 0 ? _a : process.env['npm_config_user_agent'];
+    return declared ? RUNNERS.find((runner) => declared.startsWith(runner.name)) : undefined;
+};
+const scriptFor = (manifest, command) => { var _a, _b; return (_b = Object.entries((_a = manifest.scripts) !== null && _a !== void 0 ? _a : {}).find(([, value]) => value.trim() === command)) === null || _b === void 0 ? void 0 : _b[0]; };
+/**
+ * What the reader of a message can type to reach `et <subcommand>` in this repo, because `et` itself
+ * is rarely on the PATH: the package script that wraps it, or the package manager's own way to run
+ * the binary, for example `npx et api`.
+ */
+const repoInvocation = (options) => {
+    const { root, subcommand } = options;
+    const manifest = readManifest(root);
+    const runner = runnerFor(manifest);
+    if (!runner)
+        return `et ${subcommand}`;
+    const script = scriptFor(manifest, `et ${subcommand}`);
+    return script ? `${runner.script} ${script}` : `${runner.binary} ${subcommand}`;
+};
+exports.repoInvocation = repoInvocation;
+//# sourceMappingURL=invocation.js.map

package/src/lib/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/invocation.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAA4B;AAI5B;;;GAGG;AACH,MAAM,OAAO,GAAG;IACd,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;IACnD,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE;IACxD,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;IACrD,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;CACrD,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAY,EAAE;IAC9C,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7G,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,QAAkB,EAAE,EAAE;;IACvC,MAAM,QAAQ,GAAG,MAAA,QAAQ,CAAC,cAAc,mCAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAEjF,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,QAAkB,EAAE,OAAe,EAAE,EAAE,eACxD,OAAA,MAAA,MAAM,CAAC,OAAO,CAAC,MAAA,QAAQ,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,0CAAG,CAAC,CAAC,CAAA,EAAA,CAAC;AAE5F;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAC,OAA6C,EAAE,EAAE;IAC9E,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,UAAU,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,UAAU,EAAE,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;AAClF,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB"}

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/agent-rules-sync.d.ts

@@ -0,0 +1,37 @@
+import { PackageManager } from './package-manager';
+import { UpdatedPackage } from './plan';
+export declare const AGENT_RULES_PACKAGE = "@ethlete/agent-rules";
+export declare const AGENT_RULES_CONFIG_FILE = "ethlete-agents.config.json";
+export type AgentRulesSyncPlan = {
+    state: 'not-updated';
+} | {
+    state: 'no-config';
+    command: string[];
+} | {
+    state: 'sync';
+    command: string[];
+};
+export type AgentRulesSyncOutcome = {
+    state: 'not-updated';
+} | {
+    state: 'no-config';
+    command: string[];
+} | {
+    state: 'synced';
+    command: string[];
+} | {
+    state: 'failed';
+    command: string[];
+    reason: string;
+};
+export declare const agentRulesSyncCommand: (manager: PackageManager) => string[];
+/**
+ * Whether an update has to regenerate the repo's agent rules and skills: only when it moved
+ * `@ethlete/agent-rules`, and only in a repo that configured them.
+ */
+export declare const planAgentRulesSync: (options: {
+    root: string;
+    manager: PackageManager;
+    updates: readonly UpdatedPackage[];
+}) => AgentRulesSyncPlan;
+export declare const runAgentRulesSync: (plan: AgentRulesSyncPlan, root: string) => AgentRulesSyncOutcome;

package/src/lib/update/agent-rules-sync.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgentRulesSync = exports.planAgentRulesSync = exports.agentRulesSyncCommand = exports.AGENT_RULES_CONFIG_FILE = exports.AGENT_RULES_PACKAGE = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.AGENT_RULES_PACKAGE = '@ethlete/agent-rules';
+exports.AGENT_RULES_CONFIG_FILE = 'ethlete-agents.config.json';
+const agentRulesSyncCommand = (manager) => [...manager.run, 'ethlete-agents', 'sync'];
+exports.agentRulesSyncCommand = agentRulesSyncCommand;
+/**
+ * Whether an update has to regenerate the repo's agent rules and skills: only when it moved
+ * `@ethlete/agent-rules`, and only in a repo that configured them.
+ */
+const planAgentRulesSync = (options) => {
+    const { root, manager, updates } = options;
+    if (!updates.some((update) => update.name === exports.AGENT_RULES_PACKAGE))
+        return { state: 'not-updated' };
+    const command = (0, exports.agentRulesSyncCommand)(manager);
+    if (!(0, fs_1.existsSync)((0, path_1.join)(root, exports.AGENT_RULES_CONFIG_FILE)))
+        return { state: 'no-config', command };
+    return { state: 'sync', command };
+};
+exports.planAgentRulesSync = planAgentRulesSync;
+const runAgentRulesSync = (plan, root) => {
+    if (plan.state !== 'sync')
+        return plan;
+    const [binary, ...args] = plan.command;
+    if (binary === undefined)
+        return { state: 'failed', command: plan.command, reason: 'no command to run sync with' };
+    const result = (0, child_process_1.spawnSync)(binary, args, { cwd: root, stdio: 'inherit' });
+    if (result.error)
+        return { state: 'failed', command: plan.command, reason: result.error.message };
+    if (result.status !== 0) {
+        return { state: 'failed', command: plan.command, reason: `${binary} exited with ${result.status}` };
+    }
+    return { state: 'synced', command: plan.command };
+};
+exports.runAgentRulesSync = runAgentRulesSync;
+//# sourceMappingURL=agent-rules-sync.js.map

package/src/lib/update/agent-rules-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rules-sync.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/agent-rules-sync.ts"],"names":[],"mappings":";;;AAAA,iDAA0C;AAC1C,2BAAgC;AAChC,+BAA4B;AAIf,QAAA,mBAAmB,GAAG,sBAAsB,CAAC;AAC7C,QAAA,uBAAuB,GAAG,4BAA4B,CAAC;AAW7D,MAAM,qBAAqB,GAAG,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAAhG,QAAA,qBAAqB,yBAA2E;AAE7G;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,OAIlC,EAAsB,EAAE;IACvB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,2BAAmB,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAEpG,MAAM,OAAO,GAAG,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAE/C,IAAI,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,+BAAuB,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAE7F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC;AAdW,QAAA,kBAAkB,sBAc7B;AAEK,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAE,IAAY,EAAyB,EAAE;IACjG,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;IAEvC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IAEnH,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAElG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACtG,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC,CAAC;AAhBW,QAAA,iBAAiB,qBAgB5B"}

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

@@ -0,0 +1,37 @@
+import { UpdateTask } from './tasks';
+/** Where the agent command sits in `ethlete.config.local.json`. */
+export declare const AGENT_COMMAND_KEY = "updateAgentCommand";
+/** An agent command that can edit files without asking, for the docs and the error that names the key. */
+export declare const AGENT_COMMAND_EXAMPLE = "claude --permission-mode acceptEdits -p";
+/** Where the command template takes the whole prompt. */
+export declare const PROMPT_PLACEHOLDER = "<prompt>";
+/** Where the command template takes only the path of the task file. */
+export declare const FILE_PLACEHOLDER = "<file>";
+/** The prompt one assisted task is handed to an agent with. */
+export declare const agentPrompt: (taskPath: string) => string;
+/**
+ * The command that hands one task to an agent. `<prompt>` becomes the prompt, `<file>` the path of the
+ * task file; a template with neither gets the prompt appended, which is what `claude -p` needs.
+ */
+export declare const agentCommand: (options: {
+    template: string;
+    taskPath: string;
+}) => string;
+export type AgentRunState = 'done' | 'open' | 'failed';
+export type AgentRun = {
+    task: UpdateTask;
+    command: string;
+    state: AgentRunState;
+    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, and
+ * reports each one as it ends. 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,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgentTasks = exports.assistedTasks = exports.agentCommand = exports.agentPrompt = exports.FILE_PLACEHOLDER = exports.PROMPT_PLACEHOLDER = exports.AGENT_COMMAND_EXAMPLE = exports.AGENT_COMMAND_KEY = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+/** Where the agent command sits in `ethlete.config.local.json`. */
+exports.AGENT_COMMAND_KEY = 'updateAgentCommand';
+/** An agent command that can edit files without asking, for the docs and the error that names the key. */
+exports.AGENT_COMMAND_EXAMPLE = 'claude --permission-mode acceptEdits -p';
+/** Where the command template takes the whole prompt. */
+exports.PROMPT_PLACEHOLDER = '<prompt>';
+/** Where the command template takes only the path of the task file. */
+exports.FILE_PLACEHOLDER = '<file>';
+/** The prompt one assisted task is handed to an agent with. */
+const agentPrompt = (taskPath) => `Apply the migration task described in ${taskPath} to this repository. ` +
+    'Follow its instructions, then delete that file once the change is complete.';
+exports.agentPrompt = agentPrompt;
+const quoted = (value) => (/\s/.test(value) ? `"${value}"` : value);
+/**
+ * The command that hands one task to an agent. `<prompt>` becomes the prompt, `<file>` the path of the
+ * task file; a template with neither gets the prompt appended, which is what `claude -p` needs.
+ */
+const agentCommand = (options) => {
+    const { template, taskPath } = options;
+    const prompt = quoted((0, exports.agentPrompt)(taskPath));
+    if (template.includes(exports.PROMPT_PLACEHOLDER) || template.includes(exports.FILE_PLACEHOLDER)) {
+        return template.split(exports.PROMPT_PLACEHOLDER).join(prompt).split(exports.FILE_PLACEHOLDER).join(quoted(taskPath));
+    }
+    return `${template} ${prompt}`;
+};
+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;
+const runOne = (options) => {
+    var _a;
+    const { root, template, task } = options;
+    const taskPath = (0, path_1.join)(root, (_a = task.instructionsFile) !== null && _a !== void 0 ? _a : '');
+    const command = (0, exports.agentCommand)({ template, taskPath });
+    console.log(`  ${command}\n`);
+    const result = (0, child_process_1.spawnSync)(command, { cwd: root, stdio: 'inherit', shell: true });
+    if (result.error)
+        return { task, command, state: 'failed', reason: result.error.message };
+    if (result.status !== 0)
+        return { task, command, state: 'failed', reason: `exited with ${result.status}` };
+    if ((0, fs_1.existsSync)(taskPath)) {
+        return { task, command, state: 'open', reason: `the agent left ${task.instructionsFile}, so the task stays open` };
+    }
+    return { task, command, state: 'done' };
+};
+/**
+ * Runs the configured agent once per assisted task, in order, so each run has one change to make, and
+ * reports each one as it ends. The command is a user-written string, so it runs through a shell.
+ */
+const runAgentTasks = (options) => {
+    const { root, template } = options;
+    const tasks = (0, exports.assistedTasks)(options.tasks);
+    return tasks.map((task, index) => {
+        const label = `[${index + 1}/${tasks.length}] ${task.packageName} ${task.name}`;
+        console.log(`\n  ${label}`);
+        const run = runOne({ root, template, task });
+        if (run.state === 'done')
+            console.log(`\n  ${label}: done`);
+        else
+            console.error(`\n  ${label}: ${run.reason}`);
+        return run;
+    });
+};
+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":"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"}

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;