@ethlete/cli 2.1.0-next.3 → 2.1.0-next.5

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

@@ -0,0 +1,10 @@
+export * from './api-command';
+export * from './compose';
+export * from './auth-hint';
+export * from './clone';
+export * from './definition';
+export * from './git';
+export * from './help';
+export * from './load-definitions';
+export * from './resolve-checkout';
+export * from './run';

package/src/lib/api/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./api-command"), exports);
+tslib_1.__exportStar(require("./compose"), exports);
+tslib_1.__exportStar(require("./auth-hint"), exports);
+tslib_1.__exportStar(require("./clone"), exports);
+tslib_1.__exportStar(require("./definition"), exports);
+tslib_1.__exportStar(require("./git"), exports);
+tslib_1.__exportStar(require("./help"), exports);
+tslib_1.__exportStar(require("./load-definitions"), exports);
+tslib_1.__exportStar(require("./resolve-checkout"), exports);
+tslib_1.__exportStar(require("./run"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,oDAA0B;AAC1B,sDAA4B;AAC5B,kDAAwB;AACxB,uDAA6B;AAC7B,gDAAsB;AACtB,iDAAuB;AACvB,6DAAmC;AACnC,6DAAmC;AACnC,gDAAsB"}

package/src/lib/api/load-definitions.d.ts

@@ -0,0 +1,16 @@
+import { ApiDefinitions } from './definition';
+export declare const API_DEFINITIONS_FILE_NAMES: string[];
+export type LoadApiDefinitionsResult = {
+    found: true;
+    apis: ApiDefinitions;
+    fileName: string;
+} | {
+    found: false;
+    apis?: undefined;
+    fileName?: undefined;
+};
+/**
+ * Loads the repo's API definitions from `ethlete.apis.js`. The file is a module rather than JSON
+ * because a definition's `env` is a function, which JSON cannot hold.
+ */
+export declare const loadApiDefinitions: (root: string) => LoadApiDefinitionsResult;

package/src/lib/api/load-definitions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadApiDefinitions = exports.API_DEFINITIONS_FILE_NAMES = void 0;
+const fs_1 = require("fs");
+const module_1 = require("module");
+const path_1 = require("path");
+exports.API_DEFINITIONS_FILE_NAMES = ['ethlete.apis.js', 'ethlete.apis.cjs'];
+/**
+ * Loads the repo's API definitions from `ethlete.apis.js`. The file is a module rather than JSON
+ * because a definition's `env` is a function, which JSON cannot hold.
+ */
+const loadApiDefinitions = (root) => {
+    var _a;
+    const fileName = exports.API_DEFINITIONS_FILE_NAMES.find((candidate) => (0, fs_1.existsSync)((0, path_1.join)(root, candidate)));
+    if (!fileName)
+        return { found: false };
+    const loaded = (0, module_1.createRequire)((0, path_1.join)(root, 'package.json'))((0, path_1.join)(root, fileName));
+    const apis = (_a = loaded.default) !== null && _a !== void 0 ? _a : loaded;
+    return { found: true, apis, fileName };
+};
+exports.loadApiDefinitions = loadApiDefinitions;
+//# sourceMappingURL=load-definitions.js.map

package/src/lib/api/load-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-definitions.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/load-definitions.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,mCAAuC;AACvC,+BAA4B;AAGf,QAAA,0BAA0B,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAKlF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA4B,EAAE;;IAC3E,MAAM,QAAQ,GAAG,kCAA0B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAY,IAAA,sBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAC,MAAuC,CAAC,OAAO,mCAAK,MAAyB,CAAC;IAE5F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC,CAAC;AATW,QAAA,kBAAkB,sBAS7B"}

package/src/lib/api/resolve-checkout.d.ts

@@ -0,0 +1,35 @@
+import { CloneRequest } from './clone';
+import { ApiDefinition } from './definition';
+export type ApiCheckout = {
+    repoPath: string;
+    /** The directory the compose commands run in. */
+    composePath: string;
+};
+/**
+ * `legacyConfigWarning` is set on failure too. A wrong path is exactly when the developer needs to
+ * know which file the value actually came from.
+ */
+export type ApiCheckoutResult = {
+    legacyConfigWarning?: string;
+} & ({
+    ok: true;
+    checkout: ApiCheckout;
+} | {
+    ok: false;
+    problem: string;
+    /** Set when the managed directory is empty and the API declares where to clone from. */
+    clonable?: CloneRequest;
+});
+/** Where an API's managed checkout goes when the developer configured no path of their own. */
+export declare const managedCheckoutPath: (root: string, name: string) => string;
+/** Resolves where an API's containers live, with the one message that explains each way it can fail. */
+export declare const resolveApiCheckout: (options: {
+    root: string;
+    name: string;
+    api: ApiDefinition;
+    /**
+     * The git commands act on the checkout itself, so they must not demand a compose directory or the
+     * output of `setupCommand` — both can legitimately be absent on a checkout that was just cloned.
+     */
+    requireCompose?: boolean;
+}) => ApiCheckoutResult;

package/src/lib/api/resolve-checkout.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiCheckout = exports.managedCheckoutPath = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const local_config_1 = require("../config/local-config");
+const clone_1 = require("./clone");
+const isDirectory = (path) => (0, fs_1.existsSync)(path) && (0, fs_1.statSync)(path).isDirectory();
+const missingPathProblem = (options) => {
+    var _a;
+    const { name, api, reason } = options;
+    return (`${reason}\n\nAdd the path of your ${name} API checkout to ${local_config_1.LOCAL_CONFIG_FILE_NAME} in the repo ` +
+        `root. The file is gitignored, so it changes nothing for anyone else:\n\n` +
+        `  {\n    "apiRepoPaths": {\n      "${name}": "${(_a = api.examplePath) !== null && _a !== void 0 ? _a : `../${name}-api`}"\n    }\n  }`);
+};
+/** Where an API's managed checkout goes when the developer configured no path of their own. */
+const managedCheckoutPath = (root, name) => (0, path_1.join)(root, clone_1.DEFAULT_CHECKOUT_DIR, name);
+exports.managedCheckoutPath = managedCheckoutPath;
+/** Resolves where an API's containers live, with the one message that explains each way it can fail. */
+const resolveApiCheckout = (options) => {
+    const { root, name, api, requireCompose = true } = options;
+    const { config, fileName, isLegacy } = (0, local_config_1.readLocalConfig)(root);
+    const configured = (0, local_config_1.configuredApiRepoPath)(config, name);
+    const legacyConfigWarning = isLegacy
+        ? `${local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME} still holds "apiRepoPaths". Move it to ${local_config_1.LOCAL_CONFIG_FILE_NAME}.`
+        : undefined;
+    const repoPath = configured ? (0, local_config_1.resolveConfiguredPath)(root, configured) : (0, exports.managedCheckoutPath)(root, name);
+    if (!isDirectory(repoPath)) {
+        if (configured) {
+            return {
+                ok: false,
+                legacyConfigWarning,
+                problem: `apiRepoPaths.${name} points at ${repoPath}, which is not a directory that exists.`,
+            };
+        }
+        if (!api.repoUrl) {
+            return {
+                ok: false,
+                legacyConfigWarning,
+                problem: missingPathProblem({
+                    name,
+                    api,
+                    reason: fileName
+                        ? `${fileName} has no apiRepoPaths entry for "${name}", and the API declares no repoUrl.`
+                        : `${name} has no checkout, and the API declares no repoUrl.`,
+                }),
+            };
+        }
+        return {
+            ok: false,
+            legacyConfigWarning,
+            problem: `${name} has no checkout at ${repoPath}.`,
+            clonable: {
+                repoUrl: api.repoUrl,
+                into: repoPath,
+                branch: (0, local_config_1.configuredApiRepoBranch)(config, name),
+            },
+        };
+    }
+    const composePath = (0, path_1.join)(repoPath, api.composeDir);
+    if (requireCompose && !isDirectory(composePath)) {
+        return {
+            ok: false,
+            legacyConfigWarning,
+            problem: `${repoPath} has no ${api.composeDir} directory. Is apiRepoPaths.${name} the right checkout?`,
+        };
+    }
+    if (requireCompose && api.envFile && !(0, fs_1.existsSync)((0, path_1.join)(composePath, api.envFile))) {
+        return {
+            ok: false,
+            legacyConfigWarning,
+            problem: `Missing ${api.envFile} in ${composePath}.${api.setupCommand ? ` Run "${api.setupCommand}" there first.` : ''}`,
+        };
+    }
+    return { ok: true, legacyConfigWarning, checkout: { repoPath, composePath } };
+};
+exports.resolveApiCheckout = resolveApiCheckout;
+//# sourceMappingURL=resolve-checkout.js.map

package/src/lib/api/resolve-checkout.js.map

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

package/src/lib/api/run.d.ts

@@ -0,0 +1,10 @@
+import { ApiDefinitions } from './definition';
+export type RunApiCommandOptions = {
+    apis: ApiDefinitions;
+    /** Arguments after the command name, for example `['up', 'hub', '--host']`. */
+    argv: string[];
+    root?: string;
+    /** How the caller is invoked, used in the usage line. */
+    invocation?: string;
+};
+export declare const runApiCommand: ({ apis, argv, root, invocation, }: RunApiCommandOptions) => Promise<number>;

package/src/lib/api/run.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runApiCommand = void 0;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const compose_1 = require("./compose");
+const definition_1 = require("./definition");
+const git_1 = require("./git");
+const help_1 = require("./help");
+const resolve_checkout_1 = require("./resolve-checkout");
+const clone_1 = require("./clone");
+const auth_hint_1 = require("./auth-hint");
+const utils_1 = require("../utils");
+const local_config_1 = require("../config/local-config");
+const confirmClone = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { problem, repoUrl, into } = options;
+    if (!process.stdin.isTTY) {
+        console.error(`${problem}\n\nRe-run with --clone to clone ${repoUrl} into ${into}.`);
+        return false;
+    }
+    const answer = yield (0, utils_1.askQuestion)(`${problem}\n\nClone ${repoUrl}\ninto ${into}? [y/N] `);
+    return /^y(es)?$/i.test(answer.trim());
+});
+const definedEntries = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+const runApiCommand = (_a) => tslib_1.__awaiter(void 0, [_a], void 0, function* ({ apis, argv, root = process.cwd(), invocation = 'et api', }) {
+    var _b, _c, _d, _e;
+    const exposeOnLan = argv.includes('--host');
+    const [command, name] = argv.filter((arg) => !arg.startsWith('--'));
+    const api = name === undefined ? undefined : apis[name];
+    if (argv.includes('--help') || argv.includes('-h') || command === 'help') {
+        console.log((0, help_1.apiHelp)(apis, invocation));
+        return 0;
+    }
+    if (command === undefined || name === undefined || !api) {
+        console.error((0, help_1.apiHelp)(apis, invocation));
+        return 1;
+    }
+    const commands = (0, definition_1.apiCommandNames)(api);
+    if (!commands.includes(command)) {
+        console.error(`Unknown command "${command}" for the ${name} API.\n\nCommands: ${commands.join(', ')}`);
+        return 1;
+    }
+    const isGitCommand = definition_1.GIT_API_COMMANDS.includes(command);
+    const checkout = (0, resolve_checkout_1.resolveApiCheckout)({ root, name, api, requireCompose: !isGitCommand });
+    if (checkout.legacyConfigWarning) {
+        console.warn(`${checkout.legacyConfigWarning}\n`);
+    }
+    if (!checkout.ok) {
+        if (!checkout.clonable) {
+            console.error(checkout.problem);
+            return 1;
+        }
+        const { repoUrl, into, branch } = checkout.clonable;
+        const accepted = command === 'clone' ||
+            argv.includes('--clone') ||
+            (yield confirmClone({ problem: checkout.problem, repoUrl, into }));
+        if (!accepted)
+            return 1;
+        if (!(0, clone_1.isGitIgnored)(root, into)) {
+            console.warn(`\n${clone_1.DEFAULT_CHECKOUT_DIR}/ is not gitignored. Add it before you commit anything.\n`);
+        }
+        const cloned = (0, clone_1.cloneApiRepo)({ repoUrl, into, branch });
+        if (cloned !== 0) {
+            (0, auth_hint_1.printPrivateDependencyHint)({ repoHost: (0, auth_hint_1.gitUrlHost)(repoUrl) });
+            return cloned;
+        }
+        if (command === 'clone')
+            return 0;
+        return (0, exports.runApiCommand)({ apis, argv, root, invocation });
+    }
+    if (command === 'clone') {
+        console.log(`${name} already has a checkout at ${checkout.checkout.repoPath}.`);
+        return 0;
+    }
+    const { repoPath, composePath: cwd } = checkout.checkout;
+    if (isGitCommand) {
+        const expectedBranch = (0, local_config_1.configuredApiRepoBranch)((0, local_config_1.readLocalConfig)(root).config, name);
+        if (command === 'checkout') {
+            if (!expectedBranch) {
+                console.error(`No branch configured for "${name}". Add it to apiRepoBranches:\n\n` +
+                    `  {\n    "apiRepoBranches": {\n      "${name}": "main"\n    }\n  }`);
+                return 1;
+            }
+            return (0, git_1.checkoutApiBranch)({ repoPath, branch: expectedBranch });
+        }
+        return (0, git_1.pullApiBranch)({ repoPath, expectedBranch, force: argv.includes('--force') });
+    }
+    const tool = (0, compose_1.resolveComposeTool)();
+    if (!tool) {
+        console.error(`No compose tool found. Tried: ${(0, compose_1.composeToolNames)().join(', ')}.`);
+        return 1;
+    }
+    const { engine, compose } = tool;
+    const [binary, ...composePrefix] = compose;
+    const env = Object.assign(Object.assign(Object.assign({}, (0, compose_1.engineEnv)(engine)), process.env), definedEntries((_c = (_b = api.env) === null || _b === void 0 ? void 0 : _b.call(api)) !== null && _c !== void 0 ? _c : {}));
+    let exitCode = 0;
+    const runCompose = (...composeArgs) => {
+        var _a;
+        const result = (0, child_process_1.spawnSync)(binary, [...composePrefix, ...composeArgs], { cwd, env, stdio: 'inherit' });
+        if (result.error) {
+            console.error(result.error.message);
+            exitCode = 1;
+            return;
+        }
+        exitCode = (_a = result.status) !== null && _a !== void 0 ? _a : 1;
+    };
+    if (command === 'up') {
+        if (api.network) {
+            (0, child_process_1.spawnSync)(engine, ['network', 'create', api.network], { stdio: 'ignore' });
+        }
+        runCompose('up', '-d', ...api.services);
+        // podman-compose exits 0 even when it fails to build or pull an image, so the state has to be
+        // read back rather than inferred from the exit code.
+        console.log(`\n${name} API at http://localhost:${api.port}. State:\n`);
+        runCompose('ps');
+        if (exposeOnLan) {
+            const address = (0, compose_1.lanAddress)();
+            if (!address) {
+                console.error('\nThis machine has no external IPv4 address, so the API cannot be reached over the network.');
+                return 1;
+            }
+            const envKeyStep = api.envKey
+                ? `\n  2. Run localStorage.setItem('${api.envKey}', 'http://${address}:${api.port}') on that device.`
+                : '';
+            console.log(`\nThe published ports already listen on every interface, so the API also answers on\n` +
+                `http://${address}:${api.port}. Two more steps make another device use it:\n\n` +
+                `  1. Serve the app with a host binding of 0.0.0.0.${envKeyStep}\n\n` +
+                `A host firewall can still block port ${api.port}.`);
+        }
+    }
+    else if (command === 'down') {
+        runCompose('down');
+    }
+    else if (command === 'logs') {
+        runCompose('logs', '-f', api.execService);
+    }
+    else if (command === 'shell') {
+        runCompose('exec', api.execService, 'bash');
+    }
+    else {
+        runCompose('exec', api.execService, ...((_e = (_d = api.exec) === null || _d === void 0 ? void 0 : _d[command]) !== null && _e !== void 0 ? _e : []));
+        if (exitCode !== 0) {
+            (0, auth_hint_1.printPrivateDependencyHint)({ repoHost: api.repoUrl ? (0, auth_hint_1.gitUrlHost)(api.repoUrl) : undefined });
+        }
+    }
+    return exitCode;
+});
+exports.runApiCommand = runApiCommand;
+//# sourceMappingURL=run.js.map

package/src/lib/api/run.js.map

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

package/src/lib/config/diagnose.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Every problem with the repo topology config: a file that cannot be parsed, a key nothing reads, a
+ * checkout that is not there, and values still sitting in the file they moved out of.
+ */
+export declare const diagnoseLocalConfig: ({ root }: {
+    root: string;
+}) => string[];

package/src/lib/config/diagnose.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diagnoseLocalConfig = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const local_config_1 = require("./local-config");
+/** Marks a directory as an `ethlete-sdk` checkout rather than some other folder. */
+const SDK_CHECKOUT_MARKERS = ['libs/components', 'libs/core', 'libs/agent-rules'];
+const quoted = (keys) => keys.map((key) => `"${key}"`).join(', ');
+const describeSdkSourcePath = (options) => {
+    const { root, value, fileName } = options;
+    if (value === undefined)
+        return [];
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        return [`${fileName} has an invalid "sdkSourcePath" — use a path to an ethlete-sdk checkout.`];
+    }
+    const absolute = (0, local_config_1.resolveConfiguredPath)(root, value);
+    if (!(0, fs_1.existsSync)(absolute)) {
+        return [`${fileName} points "sdkSourcePath" at ${absolute}, which does not exist.`];
+    }
+    if (SDK_CHECKOUT_MARKERS.some((marker) => !(0, fs_1.existsSync)((0, path_1.join)(absolute, marker)))) {
+        return [`${fileName} points "sdkSourcePath" at ${absolute}, which is not an ethlete-sdk checkout.`];
+    }
+    return [];
+};
+const describeApiRepoPaths = (options) => {
+    const { root, value, fileName } = options;
+    if (value === undefined)
+        return [];
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return [
+            `${fileName} has an invalid "apiRepoPaths" value — use an object mapping an app name to its API repo path.`,
+        ];
+    }
+    return Object.entries(value).flatMap(([app, path]) => {
+        if (typeof path !== 'string' || path.trim().length === 0) {
+            return [`${fileName} has an invalid "apiRepoPaths.${app}" value — use a path to the API repo.`];
+        }
+        const absolute = (0, local_config_1.resolveConfiguredPath)(root, path);
+        if (!(0, fs_1.existsSync)(absolute)) {
+            return [`${fileName} points "apiRepoPaths.${app}" at ${absolute}, which does not exist.`];
+        }
+        if (!(0, fs_1.statSync)(absolute).isDirectory()) {
+            return [`${fileName} points "apiRepoPaths.${app}" at ${absolute}, which is not a directory.`];
+        }
+        return [];
+    });
+};
+const describeApiRepoBranches = (options) => {
+    const { value, fileName } = options;
+    if (value === undefined)
+        return [];
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return [
+            `${fileName} has an invalid "apiRepoBranches" value — use an object mapping an app name to its expected API branch.`,
+        ];
+    }
+    return Object.entries(value).flatMap(([app, branch]) => typeof branch === 'string' && branch.trim().length > 0
+        ? []
+        : [`${fileName} has an invalid "apiRepoBranches.${app}" value — use a non-empty branch name.`]);
+};
+const describeValues = (options) => {
+    const { root, config, fileName } = options;
+    return [
+        ...describeSdkSourcePath({ root, value: config.sdkSourcePath, fileName }),
+        ...describeApiRepoPaths({ root, value: config.apiRepoPaths, fileName }),
+        ...describeApiRepoBranches({ value: config.apiRepoBranches, fileName }),
+    ];
+};
+/**
+ * Every problem with the repo topology config: a file that cannot be parsed, a key nothing reads, a
+ * checkout that is not there, and values still sitting in the file they moved out of.
+ */
+const diagnoseLocalConfig = ({ root }) => {
+    const primary = (0, local_config_1.readLocalConfigFile)((0, path_1.join)(root, local_config_1.LOCAL_CONFIG_FILE_NAME));
+    if (primary.status === 'unreadable')
+        return [`${local_config_1.LOCAL_CONFIG_FILE_NAME} is not valid JSON.`];
+    if (primary.status === 'not-an-object')
+        return [`${local_config_1.LOCAL_CONFIG_FILE_NAME} is not a JSON object.`];
+    if (primary.status === 'ok') {
+        const unknownKeys = Object.keys(primary.config).filter((key) => !local_config_1.LOCAL_CONFIG_KEYS.includes(key));
+        return [
+            ...(unknownKeys.length > 0
+                ? [
+                    `${local_config_1.LOCAL_CONFIG_FILE_NAME} contains key(s) nothing reads: ${quoted(unknownKeys)} — it supports ${quoted(local_config_1.LOCAL_CONFIG_KEYS)}.`,
+                ]
+                : []),
+            ...describeValues({ root, config: primary.config, fileName: local_config_1.LOCAL_CONFIG_FILE_NAME }),
+        ];
+    }
+    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 [];
+    const held = local_config_1.LOCAL_CONFIG_KEYS.filter((key) => legacy.config[key] !== undefined);
+    if (held.length === 0)
+        return [];
+    return [
+        `${local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME} still holds ${quoted(held)} — move ${held.length === 1 ? 'it' : 'them'} to ${local_config_1.LOCAL_CONFIG_FILE_NAME}.`,
+        ...describeValues({ root, config: legacy.config, fileName: local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME }),
+    ];
+};
+exports.diagnoseLocalConfig = diagnoseLocalConfig;
+//# sourceMappingURL=diagnose.js.map

package/src/lib/config/diagnose.js.map

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

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

@@ -0,0 +1,2 @@
+export * from './diagnose';
+export * from './local-config';

package/src/lib/config/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/config/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,yDAA+B"}

package/src/lib/config/local-config.d.ts

@@ -0,0 +1,44 @@
+export declare const LOCAL_CONFIG_FILE_NAME = "ethlete.config.local.json";
+/**
+ * The file these keys lived in before they moved to `ethlete.config.local.json`. Still read as a
+ * fallback so an existing checkout keeps working, and reported so the developer can move them.
+ */
+export declare const LEGACY_LOCAL_CONFIG_FILE_NAME = "ethlete-agents.config.local.json";
+/**
+ * Machine-local repo topology: where the sibling checkouts this repo works with live. The file is
+ * gitignored, so every value is per-machine and never changes what anyone else sees.
+ */
+export type LocalConfig = {
+    /** Path to a local `ethlete-sdk` checkout, for reading its source or building it into this repo. */
+    sdkSourcePath?: string;
+    /** Path to the checkout of the API an app talks to, keyed by app name. `"*"` matches any app. */
+    apiRepoPaths?: Record<string, string>;
+    /** Branch that represents each API's deployed state, keyed by app name. `"*"` matches any app. */
+    apiRepoBranches?: Record<string, string>;
+};
+export declare const LOCAL_CONFIG_KEYS: (keyof LocalConfig)[];
+export type LocalConfigFileState = {
+    status: 'absent';
+} | {
+    status: 'unreadable';
+} | {
+    status: 'not-an-object';
+} | {
+    status: 'ok';
+    config: LocalConfig;
+};
+export type LocalConfigSource = {
+    config: LocalConfig;
+    /** The file the values came from, or `undefined` when neither file exists. */
+    fileName?: string;
+    /** True when the values came from `LEGACY_LOCAL_CONFIG_FILE_NAME`. */
+    isLegacy: boolean;
+};
+/** Reads one config file, keeping "not there" apart from "there but broken" for `et doctor`. */
+export declare const readLocalConfigFile: (path: string) => LocalConfigFileState;
+/** Reads the local config, falling back to the file the keys used to live in. */
+export declare const readLocalConfig: (root: string) => LocalConfigSource;
+export declare const configuredApiRepoPath: (config: LocalConfig, api: string) => string | undefined;
+export declare const configuredApiRepoBranch: (config: LocalConfig, api: string) => string | undefined;
+/** Resolves a configured path against the repo root, so a relative path in the file works. */
+export declare const resolveConfiguredPath: (root: string, configured: string) => string;

package/src/lib/config/local-config.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfiguredPath = exports.configuredApiRepoBranch = exports.configuredApiRepoPath = exports.readLocalConfig = exports.readLocalConfigFile = exports.LOCAL_CONFIG_KEYS = exports.LEGACY_LOCAL_CONFIG_FILE_NAME = exports.LOCAL_CONFIG_FILE_NAME = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.LOCAL_CONFIG_FILE_NAME = 'ethlete.config.local.json';
+/**
+ * The file these keys lived in before they moved to `ethlete.config.local.json`. Still read as a
+ * fallback so an existing checkout keeps working, and reported so the developer can move them.
+ */
+exports.LEGACY_LOCAL_CONFIG_FILE_NAME = 'ethlete-agents.config.local.json';
+exports.LOCAL_CONFIG_KEYS = ['sdkSourcePath', 'apiRepoPaths', 'apiRepoBranches'];
+/** Reads one config file, keeping "not there" apart from "there but broken" for `et doctor`. */
+const readLocalConfigFile = (path) => {
+    if (!(0, fs_1.existsSync)(path))
+        return { status: 'absent' };
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return { status: 'unreadable' };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return { status: 'not-an-object' };
+    return { status: 'ok', config: parsed };
+};
+exports.readLocalConfigFile = readLocalConfigFile;
+const readJsonObject = (path) => {
+    const state = (0, exports.readLocalConfigFile)(path);
+    return state.status === 'ok' ? state.config : undefined;
+};
+/** Reads the local config, falling back to the file the keys used to live in. */
+const readLocalConfig = (root) => {
+    const current = readJsonObject((0, path_1.join)(root, exports.LOCAL_CONFIG_FILE_NAME));
+    if (current)
+        return { config: current, fileName: exports.LOCAL_CONFIG_FILE_NAME, isLegacy: false };
+    const legacy = readJsonObject((0, path_1.join)(root, exports.LEGACY_LOCAL_CONFIG_FILE_NAME));
+    if (legacy)
+        return { config: legacy, fileName: exports.LEGACY_LOCAL_CONFIG_FILE_NAME, isLegacy: true };
+    return { config: {}, isLegacy: false };
+};
+exports.readLocalConfig = readLocalConfig;
+const entryFor = (record, key) => { var _a; return (_a = record === null || record === void 0 ? void 0 : record[key]) !== null && _a !== void 0 ? _a : record === null || record === void 0 ? void 0 : record['*']; };
+const configuredApiRepoPath = (config, api) => entryFor(config.apiRepoPaths, api);
+exports.configuredApiRepoPath = configuredApiRepoPath;
+const configuredApiRepoBranch = (config, api) => entryFor(config.apiRepoBranches, api);
+exports.configuredApiRepoBranch = configuredApiRepoBranch;
+/** Resolves a configured path against the repo root, so a relative path in the file works. */
+const resolveConfiguredPath = (root, configured) => (0, path_1.isAbsolute)(configured) ? configured : (0, path_1.resolve)(root, configured);
+exports.resolveConfiguredPath = resolveConfiguredPath;
+//# sourceMappingURL=local-config.js.map

package/src/lib/config/local-config.js.map

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

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

@@ -0,0 +1,4 @@
+/** 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 }: {
+    root: string;
+}) => 0 | 1;