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

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;AAC1B,mDAAyB"}
+{"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.d.ts

@@ -1 +1,38 @@
-export declare const release: (args: string[]) => Promise<void>;
+import { PackageManager } from './update/package-manager';
+export declare const releaseUsage: (invocation: string) => string;
+export type ReleaseFlags = {
+    shouldForce: boolean;
+    skipPush: boolean;
+    message: string;
+    help: boolean;
+    problems: string[];
+};
+/** Reads the flags of `et release`, collecting every problem so one run reports them all. */
+export declare const releaseFlags: (args: readonly string[]) => ReleaseFlags;
+export type WorkingTreeSnapshot = Map<string, string>;
+export declare const pathsChangedBetween: (before: WorkingTreeSnapshot, after: WorkingTreeSnapshot) => string[];
+export type CommandResult = {
+    status: number | null;
+    output: string;
+};
+export type ReleaseIo = {
+    /** Runs a command. `inherit` streams its output to the terminal instead of capturing it. */
+    run: (command: readonly string[], options?: {
+        inherit?: boolean;
+    }) => CommandResult;
+    snapshot: () => WorkingTreeSnapshot;
+    ask: (question: string) => Promise<string>;
+    log: (message: string) => void;
+    error: (message: string) => void;
+};
+export type ReleaseOptions = {
+    args: readonly string[];
+    root?: string;
+    invocation?: string;
+    manager?: PackageManager;
+    /** Whether the repo declares `@changesets/cli`. Read from the root `package.json` when left out. */
+    hasChangesets?: boolean;
+    io?: Partial<ReleaseIo>;
+};
+/** Runs `et release`: version, commit, tag, push. Resolves to the exit code. */
+export declare const release: (options: ReleaseOptions) => Promise<number>;

package/src/lib/release.js

@@ -1,41 +1,166 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.release = void 0;
+exports.release = exports.pathsChangedBetween = exports.releaseFlags = exports.releaseUsage = void 0;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const package_manager_1 = require("./update/package-manager");
+const packages_1 = require("./update/packages");
 const utils_1 = require("./utils");
-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;
-    const status = (0, child_process_1.execSync)('git status --porcelain').toString();
-    if (status) {
-        if (shouldForce) {
-            console.warn('🚨 Proceed with caution 🚨 \n\nForcing release with uncommitted changes...\n');
+const NO_CHANGESETS_MESSAGE = 'No unreleased changesets found';
+const DEFAULT_COMMIT_MESSAGE = 'Release versions';
+const releaseUsage = (invocation) => [
+    `Usage: ${invocation} [flags]`,
+    '',
+    'Turns pending changesets into a release commit, tags it and pushes both.',
+    '',
+    '  --force, -f          Release although the working tree has uncommitted changes',
+    '  --skip-push, -sp     Commit and tag, but do not push',
+    `  --message, -m <text> The release commit message (default "${DEFAULT_COMMIT_MESSAGE}")`,
+    '  --help, -h           Print this help',
+    '',
+].join('\n');
+exports.releaseUsage = releaseUsage;
+/** Reads the flags of `et release`, collecting every problem so one run reports them all. */
+const releaseFlags = (args) => {
+    var _a;
+    const flags = {
+        shouldForce: false,
+        skipPush: false,
+        message: DEFAULT_COMMIT_MESSAGE,
+        help: false,
+        problems: [],
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = (_a = args[index]) !== null && _a !== void 0 ? _a : '';
+        const separator = argument.indexOf('=');
+        const flag = separator === -1 ? argument : argument.slice(0, separator);
+        if (flag === '--message' || flag === '-m') {
+            const value = separator === -1 ? args[++index] : argument.slice(separator + 1);
+            if (!value || value.startsWith('-'))
+                flags.problems.push(`${flag} needs a value.`);
+            else
+                flags.message = value;
         }
-        else {
-            console.error('There are uncommitted changes, aborting...\n');
-            process.exit(1);
+        else if (separator !== -1)
+            flags.problems.push(`${flag} takes no value.`);
+        else if (flag === '--force' || flag === '-f')
+            flags.shouldForce = true;
+        else if (flag === '--skip-push' || flag === '-sp')
+            flags.skipPush = true;
+        else if (flag === '--help' || flag === '-h')
+            flags.help = true;
+        else
+            flags.problems.push(`Unknown flag "${argument}".`);
+    }
+    return flags;
+};
+exports.releaseFlags = releaseFlags;
+const pathsChangedBetween = (before, after) => {
+    const paths = new Set([...before.keys(), ...after.keys()]);
+    return [...paths].filter((path) => before.get(path) !== after.get(path));
+};
+exports.pathsChangedBetween = pathsChangedBetween;
+const defaultRun = ([binary = '', ...args], options = {}) => {
+    var _a, _b;
+    const result = binary === 'git'
+        ? (0, child_process_1.spawnSync)(binary, args, { stdio: options.inherit ? 'inherit' : 'pipe' })
+        : (0, package_manager_1.spawnPackageManager)({ binary, args, spawn: { stdio: options.inherit ? 'inherit' : 'pipe' } });
+    return { status: result.status, output: `${(_a = result.stdout) !== null && _a !== void 0 ? _a : ''}${(_b = result.stderr) !== null && _b !== void 0 ? _b : ''}` };
+};
+const snapshotWorkingTree = () => {
+    const entries = (0, child_process_1.execFileSync)('git', ['status', '--porcelain', '-z', '-uall']).toString().split('\0').filter(Boolean);
+    return new Map(entries.map((entry) => {
+        const path = entry.slice(3);
+        return [path, (0, fs_1.existsSync)(path) ? (0, child_process_1.execFileSync)('git', ['hash-object', '--', path]).toString().trim() : 'deleted'];
+    }));
+};
+const defaultIo = {
+    run: defaultRun,
+    snapshot: snapshotWorkingTree,
+    ask: utils_1.askQuestion,
+    log: (message) => console.log(message),
+    error: (message) => console.error(message),
+};
+const tagSubcommand = (io, changeset) => {
+    var _a, _b;
+    const version = io.run(changeset('--version')).output;
+    return Number((_b = (_a = /(\d+)\.\d+\.\d+/.exec(version)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : 0) >= 3 ? 'git-tag' : 'tag';
+};
+const CHANGESETS_CLI = '@changesets/cli';
+/** Runs `et release`: version, commit, tag, push. Resolves to the exit code. */
+const release = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const root = (_a = options.root) !== null && _a !== void 0 ? _a : process.cwd();
+    const invocation = (_b = options.invocation) !== null && _b !== void 0 ? _b : 'et release';
+    const io = Object.assign(Object.assign({}, defaultIo), options.io);
+    const flags = (0, exports.releaseFlags)(options.args);
+    if (flags.problems.length) {
+        io.error(`${flags.problems.join('\n')}\n\n${(0, exports.releaseUsage)(invocation)}`);
+        return 1;
+    }
+    if (flags.help) {
+        io.log((0, exports.releaseUsage)(invocation));
+        return 0;
+    }
+    const manifest = (0, packages_1.readManifest)(root);
+    const manager = (_c = options.manager) !== null && _c !== void 0 ? _c : (0, package_manager_1.detectPackageManager)({ root, manifest });
+    const hasChangesets = (_d = options.hasChangesets) !== null && _d !== void 0 ? _d : Boolean((_f = (_e = manifest === null || manifest === void 0 ? void 0 : manifest.devDependencies) === null || _e === void 0 ? void 0 : _e[CHANGESETS_CLI]) !== null && _f !== void 0 ? _f : (_g = manifest === null || manifest === void 0 ? void 0 : manifest.dependencies) === null || _g === void 0 ? void 0 : _g[CHANGESETS_CLI]);
+    const changeset = (...args) => [...manager.run, 'changeset', ...args];
+    if (!hasChangesets) {
+        io.error(`${CHANGESETS_CLI} is not in the root package.json, so there is nothing to release with. Add it as a dev dependency and run \`${changeset('init').join(' ')}\`.\n`);
+        return 1;
+    }
+    if (io.run(['git', 'status', '--porcelain']).output.trim()) {
+        if (!flags.shouldForce) {
+            io.error('There are uncommitted changes, aborting...\n');
+            return 1;
         }
+        io.log('🚨 Proceed with caution 🚨 \n\nForcing release with uncommitted changes...\n');
     }
-    const answer = yield (0, utils_1.askQuestion)('You are about to release a new version. Make sure you are not releasing a version that has already been released on a different branch. \n\n Press enter to continue...\n');
+    const answer = yield io.ask('You are about to release a new version. Make sure you are not releasing a version that has already been released on a different branch. \n\n Press enter to continue...\n');
     if (answer !== '') {
-        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(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');
-    (0, child_process_1.execSync)(`git commit -m "Release versions"`);
-    if (!skipPush) {
-        (0, child_process_1.execSync)('git push --follow-tags');
-        console.log('🚀 Release complete 🚀 Have a great day ❤️');
-    }
-    else {
-        console.log('🚀 Release complete without pushing the commit 🚀 Have a great day ❤️ ');
+        io.error('Aborting...');
+        return 1;
+    }
+    const before = io.snapshot();
+    const version = io.run(changeset('version'));
+    if (version.status !== 0) {
+        io.error(version.output.includes(NO_CHANGESETS_MESSAGE)
+            ? `${NO_CHANGESETS_MESSAGE}, aborting...\n`
+            : `\`${changeset('version').join(' ')}\` failed:\n${version.output}`);
+        return 1;
+    }
+    io.log(version.output);
+    const changedPaths = (0, exports.pathsChangedBetween)(before, io.snapshot());
+    if (changedPaths.length)
+        io.run(['git', 'add', '--', ...changedPaths]);
+    io.log('Committing release... 🚀 \n(This may take a while depending on your pre-commit hooks) \n');
+    if (io.run(['git', 'commit', '-m', flags.message], { inherit: true }).status !== 0) {
+        io.error([
+            'git commit failed, so no tag was written. The version bump is staged.',
+            `Fix what the hook reported (a commit-msg hook may need \`--message "<text>"\`), commit the staged files,`,
+            `then run \`${changeset(tagSubcommand(io, changeset)).join(' ')}\` and \`git push --follow-tags\`.`,
+            '',
+        ].join('\n'));
+        return 1;
+    }
+    const tag = io.run(changeset(tagSubcommand(io, changeset)));
+    if (tag.status !== 0) {
+        io.error(`The release commit exists, but tagging it failed:\n${tag.output}`);
+        return 1;
+    }
+    io.log(tag.output);
+    if (flags.skipPush) {
+        io.log('🚀 Release complete without pushing the commit 🚀 Have a great day ❤️ ');
+        return 0;
+    }
+    if (io.run(['git', 'push', '--follow-tags'], { inherit: true }).status !== 0) {
+        io.error('The release commit and its tags exist locally, but `git push --follow-tags` failed.');
+        return 1;
     }
+    io.log('🚀 Release complete 🚀 Have a great day ❤️');
+    return 0;
 });
 exports.release = release;
 //# sourceMappingURL=release.js.map

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":";;;;AAAA,iDAAwD;AACxD,2BAAgC;AAChC,8DAAqG;AACrG,gDAAiD;AACjD,mCAAsC;AAEtC,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAE/D,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAE3C,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAE,EAAE,CACjD;IACE,UAAU,UAAU,UAAU;IAC9B,EAAE;IACF,0EAA0E;IAC1E,EAAE;IACF,kFAAkF;IAClF,wDAAwD;IACxD,+DAA+D,sBAAsB,IAAI;IACzF,wCAAwC;IACxC,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAXF,QAAA,YAAY,gBAWV;AAUf,6FAA6F;AACtF,MAAM,YAAY,GAAG,CAAC,IAAuB,EAAgB,EAAE;;IACpE,MAAM,KAAK,GAAiB;QAC1B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,sBAAsB;QAC/B,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAExE,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAE/E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAC;;gBAC9E,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC;aAAM,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC;aACvE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;aAClE,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,KAAK;YAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;aACpE,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;;YAC1D,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,QAAQ,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AA3BW,QAAA,YAAY,gBA2BvB;AAIK,MAAM,mBAAmB,GAAG,CAAC,MAA2B,EAAE,KAA0B,EAAE,EAAE;IAC7F,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3D,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC,CAAC;AAJW,QAAA,mBAAmB,uBAI9B;AAaF,MAAM,UAAU,GAAqB,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;;IAC5E,MAAM,MAAM,GACV,MAAM,KAAK,KAAK;QACd,CAAC,CAAC,IAAA,yBAAS,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1E,CAAC,CAAC,IAAA,qCAAmB,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEpG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,EAAE,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,EAAE,EAAE,EAAE,CAAC;AAC3F,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,GAAwB,EAAE;IACpD,MAAM,OAAO,GAAG,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAErH,OAAO,IAAI,GAAG,CACZ,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE5B,OAAO,CAAC,IAAI,EAAE,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAc;IAC3B,GAAG,EAAE,UAAU;IACf,QAAQ,EAAE,mBAAmB;IAC7B,GAAG,EAAE,mBAAW;IAChB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACtC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;CAC3C,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,EAAa,EAAE,SAA0C,EAAE,EAAE;;IAClF,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtD,OAAO,MAAM,CAAC,MAAA,MAAA,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACpF,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAYzC,gFAAgF;AACzE,MAAM,OAAO,GAAG,CAAO,OAAuB,EAAmB,EAAE;;IACxE,MAAM,IAAI,GAAG,MAAA,OAAO,CAAC,IAAI,mCAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,YAAY,CAAC;IACtD,MAAM,EAAE,mCAAQ,SAAS,GAAK,OAAO,CAAC,EAAE,CAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAA,oBAAY,EAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAExE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,EAAE,CAAC,GAAG,CAAC,IAAA,oBAAY,EAAC,UAAU,CAAC,CAAC,CAAC;QAEjC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,IAAA,sCAAoB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,MAAM,aAAa,GACjB,MAAA,OAAO,CAAC,aAAa,mCACrB,OAAO,CAAC,MAAA,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,eAAe,0CAAG,cAAc,CAAC,mCAAI,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,YAAY,0CAAG,cAAc,CAAC,CAAC,CAAC;IACnG,MAAM,SAAS,GAAG,CAAC,GAAG,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,CACN,GAAG,cAAc,+GAA+G,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CACnK,CAAC;QAEF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,EAAE,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAEzD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,EAAE,CAAC,GAAG,CAAC,8EAA8E,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CACzB,2KAA2K,CAC5K,CAAC;IAEF,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAExB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,EAAE,CAAC,KAAK,CACN,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC5C,CAAC,CAAC,GAAG,qBAAqB,iBAAiB;YAC3C,CAAC,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CACvE,CAAC;QAEF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,YAAY,GAAG,IAAA,2BAAmB,EAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhE,IAAI,YAAY,CAAC,MAAM;QAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAEvE,EAAE,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC;IAEnG,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,EAAE,CAAC,KAAK,CACN;YACE,uEAAuE;YACvE,0GAA0G;YAC1G,cAAc,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,oCAAoC;YACnG,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QAEF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAE5D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,EAAE,CAAC,KAAK,CAAC,sDAAsD,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,EAAE,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QAEjF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7E,EAAE,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;QAEhG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,EAAE,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAErD,OAAO,CAAC,CAAC;AACX,CAAC,CAAA,CAAC;AAhHW,QAAA,OAAO,WAgHlB"}

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 fs_1 = require("fs");
+const path_1 = require("path");
+const package_manager_1 = require("./package-manager");
+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, package_manager_1.spawnPackageManager)({ binary, args, spawn: { 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,2BAAgC;AAChC,+BAA4B;AAC5B,uDAAwE;AAG3D,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,qCAAmB,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAE7F,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/agent-setup.d.ts

@@ -0,0 +1,33 @@
+export type AgentCli = {
+    binary: string;
+    label: string;
+    /** Opens a session the developer can answer questions in, and exits when they close it. */
+    interactive: string;
+    /** Runs to the end without a question, so a task that needs a decision stays open. */
+    headless: string;
+};
+export declare const AGENT_CLIS: readonly AgentCli[];
+export type AgentChoice = {
+    label: string;
+    command: string;
+};
+export declare const onPath: (options: {
+    binary: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}) => boolean;
+/** The commands of every installed agent CLI, the interactive one of each first. */
+export declare const agentChoices: (options?: {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}) => AgentChoice[];
+/**
+ * Asks which agent command `--ai` uses and saves the answer in the local config. Without a terminal it
+ * names the key and the installed CLIs instead. Returns `undefined` when there is no command to use.
+ */
+export declare const setUpAgentCommand: (options: {
+    root: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    isTTY?: boolean;
+}) => Promise<string | undefined>;

package/src/lib/update/agent-setup.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpAgentCommand = exports.agentChoices = exports.onPath = exports.AGENT_CLIS = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const local_config_1 = require("../config/local-config");
+const utils_1 = require("../utils");
+const ai_1 = require("./ai");
+const gitignore_1 = require("./gitignore");
+exports.AGENT_CLIS = [
+    {
+        binary: 'claude',
+        label: 'Claude Code',
+        interactive: 'claude --permission-mode auto',
+        headless: 'claude --permission-mode auto -p',
+    },
+    {
+        binary: 'codex',
+        label: 'Codex',
+        interactive: 'codex --sandbox workspace-write',
+        headless: 'codex exec --sandbox workspace-write',
+    },
+    {
+        binary: 'gemini',
+        label: 'Gemini CLI',
+        interactive: 'gemini --approval-mode auto_edit -i',
+        headless: 'gemini --approval-mode auto_edit -p',
+    },
+    {
+        binary: 'copilot',
+        label: 'GitHub Copilot CLI',
+        interactive: 'copilot --allow-all-tools -i',
+        headless: 'copilot --allow-all-tools -p',
+    },
+    {
+        binary: 'cursor-agent',
+        label: 'Cursor Agent',
+        interactive: 'cursor-agent --force',
+        headless: 'cursor-agent --force -p',
+    },
+];
+const isExecutable = (path, platform) => {
+    try {
+        (0, fs_1.accessSync)(path, platform === 'win32' ? fs_1.constants.F_OK : fs_1.constants.X_OK);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+const onPath = (options) => {
+    var _a, _b, _c;
+    const { binary, env = process.env, platform = process.platform } = options;
+    const dirs = ((_b = (_a = env['PATH']) !== null && _a !== void 0 ? _a : env['Path']) !== null && _b !== void 0 ? _b : '').split(path_1.delimiter).filter(Boolean);
+    const extensions = platform === 'win32' ? ['', ...((_c = env['PATHEXT']) !== null && _c !== void 0 ? _c : '.EXE;.CMD;.BAT').split(';')] : [''];
+    return dirs.some((dir) => extensions.some((extension) => isExecutable((0, path_1.join)(dir, binary + extension), platform)));
+};
+exports.onPath = onPath;
+/** The commands of every installed agent CLI, the interactive one of each first. */
+const agentChoices = (options = {}) => exports.AGENT_CLIS.filter(({ binary }) => (0, exports.onPath)(Object.assign({ binary }, options))).flatMap((cli) => [
+    { label: `${cli.label}, interactive: you can answer its questions`, command: cli.interactive },
+    { label: `${cli.label}, headless: a task that needs a decision stays open`, command: cli.headless },
+]);
+exports.agentChoices = agentChoices;
+const missingKeyMessage = `--ai needs "${ai_1.AGENT_COMMAND_KEY}" in ${local_config_1.LOCAL_CONFIG_FILE_NAME}, for example "${ai_1.AGENT_COMMAND_EXAMPLE}".`;
+const pick = (choices) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const list = choices.map((choice, index) => `  ${index + 1}. ${choice.label}\n     ${choice.command}`).join('\n');
+    const question = choices.length > 0
+        ? `${list}\n\nPick a number, or type a command of your own. Press Enter for 1, or Ctrl+C to stop: `
+        : 'No agent CLI was found on PATH. Type the command to hand a task to, or press Enter to stop: ';
+    const answer = (yield (0, utils_1.askQuestion)(`\n${missingKeyMessage}\n\n${question}`)).trim();
+    if (answer === '')
+        return (_a = choices[0]) === null || _a === void 0 ? void 0 : _a.command;
+    const index = /^\d+$/.test(answer) ? Number(answer) - 1 : -1;
+    if (index >= 0)
+        return (_b = choices[index]) === null || _b === void 0 ? void 0 : _b.command;
+    return answer;
+});
+/** The file the key goes in: the one that holds the local config now, or a new `ethlete.config.local.json`. */
+const targetFile = (root) => {
+    const primary = (0, local_config_1.readLocalConfigFile)((0, path_1.join)(root, local_config_1.LOCAL_CONFIG_FILE_NAME));
+    if (primary.status === 'ok')
+        return { fileName: local_config_1.LOCAL_CONFIG_FILE_NAME, config: primary.config };
+    if (primary.status !== 'absent')
+        return undefined;
+    const legacy = (0, local_config_1.readLocalConfigFile)((0, path_1.join)(root, local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME));
+    if (legacy.status === 'ok')
+        return { fileName: local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME, config: legacy.config };
+    return { fileName: local_config_1.LOCAL_CONFIG_FILE_NAME, config: {} };
+};
+/**
+ * Asks which agent command `--ai` uses and saves the answer in the local config. Without a terminal it
+ * names the key and the installed CLIs instead. Returns `undefined` when there is no command to use.
+ */
+const setUpAgentCommand = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { root, isTTY = process.stdin.isTTY === true } = options;
+    const choices = (0, exports.agentChoices)(options);
+    if (!isTTY) {
+        const found = choices.map(({ command }) => `  ${command}`).join('\n');
+        console.error(`${missingKeyMessage}\n` +
+            (found ? `Commands for the agent CLIs on PATH:\n${found}\n` : '') +
+            'Nothing was changed.');
+        return undefined;
+    }
+    const target = targetFile(root);
+    if (!target) {
+        console.error(`${missingKeyMessage}\n${local_config_1.LOCAL_CONFIG_FILE_NAME} cannot be read, so it stays as it is. Nothing was changed.`);
+        return undefined;
+    }
+    const command = yield pick(choices);
+    if (!command) {
+        console.error('No agent command was picked. Nothing was changed.');
+        return undefined;
+    }
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, target.fileName), `${JSON.stringify(Object.assign(Object.assign({}, target.config), { [ai_1.AGENT_COMMAND_KEY]: command }), null, 2)}\n`, 'utf8');
+    console.log(`\n  Saved "${ai_1.AGENT_COMMAND_KEY}": "${command}" in ${target.fileName}.`);
+    if ((0, gitignore_1.ignoreEntry)({ root, entry: target.fileName }))
+        console.log(`  Added ${target.fileName} to .gitignore.`);
+    return command;
+});
+exports.setUpAgentCommand = setUpAgentCommand;
+//# sourceMappingURL=agent-setup.js.map

package/src/lib/update/agent-setup.js.map

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

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

@@ -1,30 +1,59 @@
 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. */
+/** An interactive agent command that can edit files without asking, for the error that names the key. */
+export declare const AGENT_COMMAND_EXAMPLE = "claude --permission-mode auto";
+/** 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 file an agent writes to tell `et update` that it is finished with a task. */
+export declare const finishedPath: (taskPath: string) => string;
+/** The prompt one assisted task is handed to an agent with. */
+export declare const agentPrompt: (taskPath: string) => string;
+export declare const PROMPT_ENV = "ETHLETE_UPDATE_PROMPT";
+export declare const FILE_ENV = "ETHLETE_UPDATE_TASK_FILE";
+export declare const FINISHED_ENV = "ETHLETE_UPDATE_FINISHED_FILE";
 /**
- * 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.
+ * 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. Both
+ * values reach the shell as variable references; run it with `agentEnv`.
  */
 export declare const agentCommand: (options: {
     template: string;
-    promptPath: string;
+    platform?: NodeJS.Platform;
 }) => string;
+export declare const agentEnv: (taskPath: string) => {
+    ETHLETE_UPDATE_PROMPT: string;
+    ETHLETE_UPDATE_TASK_FILE: string;
+    ETHLETE_UPDATE_FINISHED_FILE: string;
+};
+export type AgentRunState = 'done' | 'open' | 'failed';
 export type AgentRun = {
     task: UpdateTask;
     command: string;
-    ok: boolean;
+    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[];
+/** `settleMs` lets the agent print its last message after it writes the finished file; `killMs` is the SIGTERM grace. */
+export type AgentTiming = {
+    pollMs: number;
+    settleMs: number;
+    killMs: number;
+};
 /**
- * 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.
+ * 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.
+ * A run ends when the agent exits, or shortly after it writes the finished file the prompt names.
+ * `afterRun` runs after each task, before the next one starts; it is how `et update` commits a task that
+ * ended done, so the report of any other task says it is not committed.
  */
 export declare const runAgentTasks: (options: {
     root: string;
     template: string;
     tasks: readonly UpdateTask[];
-}) => AgentRun[];
+    afterRun?: (run: AgentRun) => void;
+    timing?: Partial<AgentTiming>;
+}) => Promise<AgentRun[]>;