koppler 0.0.0-stage → 0.0.2

package/dist/cli/doctor.js

@@ -0,0 +1,173 @@
+// The commands that say whether something can run here, and what it needs: doctor (tools, what the user still has to
+// do, secrets, connections), the tunnels of a plan, and the secrets themselves.
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { isProtected } from "../core/plan.js";
+import { describePlan, planSteps, planTunnels } from "../core/ports.js";
+import { readData, readStack } from "../data.js";
+import { secretTest } from "../engine/app-start.js";
+import { checkTools, missingTunnels, report } from "../engine/checks.js";
+import { needs } from "../engine/needs.js";
+import { live } from "../engine/history.js";
+import { tunnelsOf } from "../engine/up.js";
+import { cableTest } from "../server/cable-test.js";
+import { APP, BIN } from "../paths.js";
+import { confirm, envOf, positional } from "./output.js";
+import { fail } from "../failure.js";
+import { appOn, storeOf } from "../core/stack.js";
+const loaded = () => readStack() ?? fail('no stack loaded (koppler init)');
+const portOf = (stack, id) => Number(new URL(stack.apps[id]?.url ?? 'http://x').port);
+/** The tunnels a set of apps needs, with shared, moved and loopback-aliased ones worked out (default: the apps on the canvas). */
+export function ports(args) {
+    const stack = loaded();
+    const envAt = args.indexOf('--env');
+    const env = (envAt >= 0 ? args[envAt + 1] : stack.envs[0]) ?? '';
+    const ENV = env.toUpperCase();
+    if (!stack.envs.includes(env))
+        fail(`unknown env ${String(args[envAt + 1])}; the stack has ${stack.envs.join(', ')}`);
+    const given = args.filter((arg, at) => !arg.startsWith('--') && (envAt < 0 || at !== envAt + 1));
+    const ids = given.length ? given : Object.keys(readData('state')?.['nodes'] ?? {});
+    const name = (id) => stack.apps[id]?.name ?? id;
+    for (const id of ids)
+        if (!stack.apps[id])
+            fail(`${id} is not an app in the stack`);
+    for (const id of ids) {
+        const outside = stack.apps[id]?.outside;
+        if (outside)
+            fail(`${name(id)} does not run on this Mac: ${String(outside)}`);
+    }
+    // An app with no tunnels for this environment never gets the first environment's: that would reach the wrong database.
+    const noTunnel = missingTunnels(stack, env).filter(id => ids.includes(id));
+    if (noTunnel.length)
+        fail(`${noTunnel.map(name).join(', ')}: the stack has no ${ENV} tunnel, and another environment's is never used. Set it with koppler stack set apps.<id>.envs.${env}.prereqs before running on ${ENV}.`);
+    const needed = ids.flatMap(id => tunnelsOf(stack, id, env));
+    const taken = ids.map(id => portOf(stack, id)).filter(Boolean);
+    const plan = planTunnels(needed, taken).map(tunnel => ({ ...tunnel, steps: planSteps(tunnel) }));
+    if (args.includes('--json')) {
+        console.log(JSON.stringify(plan, null, 2));
+        return;
+    }
+    if (!plan.length) {
+        console.log(`no tunnels needed for ${ids.join(', ') || 'these apps'}`);
+        return;
+    }
+    for (const line of describePlan(plan, name))
+        console.log(line);
+    for (const tunnel of plan) {
+        const { steps } = tunnel;
+        const port = String(tunnel.port);
+        const bind = tunnel.needsAlias ? ` --bind ${tunnel.bind}` : '';
+        console.log(`\n${tunnel.host} -> ${tunnel.bind}:${port}  (for ${tunnel.apps.map(name).join(', ')})`);
+        for (const command of steps.sudo)
+            console.log(`  you run: ${command}`);
+        for (const command of steps.undo)
+            console.log(`  undo:    ${command}`);
+        console.log(`  tunnel:  koppler run ${steps.name} --port ${port}${bind} --restart -- ${steps.tunnel}`);
+        for (const { app, env: setting, value } of steps.settings)
+            console.log(`  setting: ${setting}=${value} in ${name(app)}'s -LOCAL profile`);
+    }
+}
+/** Tries each stored secret the apps declare and says only whether it works; the values stay in their store. */
+function secretTests(stack, ids, env) {
+    return ids.flatMap(id => {
+        const app = appOn(stack, id, env) ?? fail(`${id} is not an app in the stack`);
+        const store = storeOf(stack, id, env);
+        return (app.secrets ?? []).flatMap(secret => secret.env ? [{ app: id, name: secret.env, env, ...secretTest(store, secret) }] : []);
+    });
+}
+/**
+ * Every connection of what runs now, tested the way the canvas's Flow check does: each app answers, each cable reaches
+ * its local app, each tunnel reaches its database or cache.
+ */
+async function flowCheck(args) {
+    const stack = loaded();
+    const board = live();
+    if (!board || !Object.keys(board.nodes).length) {
+        console.log('Nothing is running, so there is nothing to test.');
+        return;
+    }
+    const env = board.env ?? stack.envs[0] ?? '';
+    const name = (id) => stack.apps[id]?.name ?? id;
+    const ids = Object.keys(board.nodes).filter(id => stack.apps[id]);
+    const tunnels = planTunnels(ids.filter(id => board.nodes[id]?.tunnels !== false).flatMap(id => tunnelsOf(stack, id, env)));
+    const jobs = [
+        ...ids.filter(id => stack.apps[id]?.url).map(id => ({ label: name(id), body: { env, node: id } })),
+        ...board.edges.map(({ from, to }) => ({ label: `${name(from)} to local ${name(to)}`, body: { env, from, to } })),
+        ...tunnels.flatMap(tunnel => tunnel.apps.map(id => ({
+            label: `${name(id)} to ${tunnel.what}`,
+            body: { env, app: id, host: tunnel.bind, port: tunnel.port, original: tunnel.original },
+        }))),
+    ];
+    const results = [];
+    for (const { label, body } of jobs)
+        results.push({ label, result: await cableTest(stack, body) });
+    if (args.includes('--json')) {
+        const shown = results.map(({ label, result }) => ({
+            connection: label,
+            ok: result.ok,
+            text: result.text,
+            detail: result.detail,
+        }));
+        console.log(JSON.stringify(shown, null, 2));
+    }
+    else
+        for (const { label, result } of results) {
+            const state = result.ok ? 'ok     ' : result.unsure ? 'unsure ' : 'FAILED ';
+            console.log(`${state} ${label}: ${result.text}${result.ok ? '' : ` (${result.detail})`}`);
+        }
+    if (results.some(({ result }) => !result.ok && !result.unsure))
+        process.exitCode = 1;
+}
+/**
+ * Can these apps run here? The tools this stack needs, then what the user still has to do for the apps, then (asked
+ * for) whether each stored secret works, or whether every connection of what runs now answers.
+ */
+export async function doctor(args) {
+    if (args.includes('--flow')) {
+        await flowCheck(args);
+        return;
+    }
+    const json = args.includes('--json');
+    const stack = loaded();
+    const env = envOf(stack, args);
+    const ids = positional(args, ['--env', '--no-tunnels']);
+    // Approving runs commands from a shared file on this Mac: only a person at the terminal can say yes, never --yes.
+    const tools = await checkTools({ approve: args.includes('--approve'), confirm: question => confirm(question) });
+    if (tools.error !== undefined)
+        fail(tools.error);
+    const forNeeds = args.filter(arg => arg !== '--secrets' && arg !== '--approve');
+    const todo = ids.length ? needs(forNeeds, { skill: APP, collect: json }) : undefined;
+    const wanted = args.includes('--secrets');
+    const secrets = wanted ? secretTests(stack, ids.length ? ids : Object.keys(stack.apps), env) : [];
+    if (json) {
+        console.log(JSON.stringify({ tools: tools.results, ...todo, ...(wanted && { secrets }) }, null, 2));
+        return;
+    }
+    if (!ids.length)
+        report(tools.results);
+    for (const secret of secrets)
+        console.log(`${secret.app} ${secret.name} (${env.toUpperCase()}): ${secret.message}`);
+    if (tools.results.some(result => result.state === 'missing') || secrets.some(secret => secret.code === 1))
+        process.exitCode = 1;
+}
+const SCRIPTS = { set: 'secret-set', list: 'secret-list', psql: 'secret-psql' };
+/** Secrets, in the user's own terminal: the values never pass through Koppler's output. */
+export function secret(args) {
+    const [action = '', ...rest] = args;
+    if (action === 'remove') {
+        const [store, name] = rest;
+        if (!store || !name)
+            fail('usage: koppler secret remove <app>[@<env>] <NAME>');
+        process.exit(spawnSync(path.join(BIN, 'secret-store'), ['remove', store, name], { stdio: 'inherit' }).status ?? 1);
+    }
+    const script = (Object.hasOwn(SCRIPTS, action) ? SCRIPTS[action] : undefined) ??
+        fail('usage: koppler secret set|list|remove|psql <app>[@<env>] [<NAME>]');
+    // A protected environment's value is stored so that every read asks the user (the stack says which; else all but
+    // the first).
+    const stack = readStack();
+    const env = (rest[0] ?? '').split('@')[1] ?? stack?.envs[0] ?? '';
+    const mark = stack ? { KOPPLER_SECRET_PROTECTED: isProtected(stack, env) ? '1' : '0' } : {};
+    const ran = spawnSync(path.join(BIN, script), rest, { stdio: 'inherit', env: { ...process.env, ...mark } });
+    process.exit(ran.status ?? 1);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAe,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,GAAG,GAAa,EAAE,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,gCAAgC,CAAC,CAAC;AACrF,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAExG,kIAAkI;AAClI,MAAM,UAAU,KAAK,CAAC,IAAc;IAClC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACxD,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IACpF,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QACxC,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,8BAA8B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,uHAAuH;IACvH,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,MAAM;QACjB,IAAI,CACF,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,kGAAkG,GAAG,8BAA8B,GAAG,GAAG,CACnM,CAAC;IACJ,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACjG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;QACvE,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,UAAU,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrG,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,CAAC,IAAI,WAAW,IAAI,GAAG,IAAI,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACvG,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ;YACvD,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,IAAI,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,SAAS,WAAW,CAAC,KAAe,EAAE,GAAa,EAAE,GAAW;IAC9D,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,SAAS,CAAC,IAAc;IACrC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAC9F,CAAC;IACF,MAAM,IAAI,GAAG;QACX,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAClG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChH,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrB,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,IAAI,EAAE;YACtC,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SACxF,CAAC,CAAC,CACJ;KACF,CAAC;IACF,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAChD,UAAU,EAAE,KAAK;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;;QACC,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACxD,kHAAkH;IAClH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChH,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,WAAW,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpG,OAAO;IACT,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACpH,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;QACvG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,OAAO,GAAuC,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACpH,2FAA2F;AAC3F,MAAM,UAAU,MAAM,CAAC,IAAc;IACnC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACrH,CAAC;IACD,MAAM,MAAM,GACV,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAC5E,iHAAiH;IACjH,cAAc;IACd,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5G,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/cli/mcp.js

@@ -0,0 +1,204 @@
+// `koppler mcp`: an MCP server on stdio, so an agent reads and waits on Koppler without the listen loop.
+// Each tool runs the koppler command itself with fixed flags; nothing that needs the user's approval is offered.
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import readline from 'node:readline';
+import { z } from 'zod';
+import { APP_ID, RUN_ID } from "../ids.js";
+import { CODE } from "../paths.js";
+const app = z.string().regex(APP_ID).describe('An app id from the stack, such as orders-api');
+const env = z.string().regex(APP_ID).describe('An environment of the stack, such as qa; the first one when left out');
+const JSON_OUT = { type: 'object' };
+const tool = (one) => one;
+const TOOLS = {
+    status: tool({
+        description: 'What Koppler runs now (apps, tunnels, the canvas), each with its state, port and uptime.',
+        input: z.strictObject({
+            apps: z.boolean().optional().describe("Add every app in the stack with its clone's branch"),
+        }),
+        readOnly: true,
+        json: true,
+        command: ({ apps }) => ({ args: ['status', '--json', ...(apps ? ['--apps'] : [])] }),
+    }),
+    logs: tool({
+        description: "The last lines of an app's or tunnel's log, secrets masked.",
+        input: z.strictObject({
+            name: app,
+            lines: z.number().int().min(1).max(2000).optional().describe('How many, 100 when left out'),
+        }),
+        readOnly: true,
+        json: false,
+        command: ({ name, lines }) => ({ args: ['logs', name, '-n', String(lines ?? 100)] }),
+    }),
+    doctor: tool({
+        description: 'Whether apps can run on this Mac: tools, sign-ins, tunnels, hosts entries, secrets, and what the user still has to do.',
+        input: z.strictObject({
+            apps: z.array(app).max(50).optional().describe('The apps to check; every app on the board when left out'),
+            env: env.optional(),
+            secrets: z.boolean().optional().describe('Also check that each stored secret is there'),
+            flow: z.boolean().optional().describe('Also test every connection between the apps that run'),
+        }),
+        readOnly: true,
+        json: true,
+        command: ({ apps, env: on, secrets, flow }) => ({
+            args: [
+                'doctor',
+                ...(apps ?? []),
+                ...(on ? ['--env', on] : []),
+                ...(secrets ? ['--secrets'] : []),
+                ...(flow ? ['--flow'] : []),
+                '--json',
+            ],
+        }),
+    }),
+    plan: tool({
+        description: 'What the newest run does compared with what runs now: what starts, restarts, stops and keeps running.',
+        input: z.strictObject({ apps: z.array(app).max(50).optional(), env: env.optional() }),
+        readOnly: true,
+        json: true,
+        command: ({ apps, env: on }) => ({ args: ['plan', ...(apps ?? []), ...(on ? ['--env', on] : []), '--json'] }),
+    }),
+    history: tool({
+        description: 'Recent runs and Stops, and how each ended.',
+        input: z.strictObject({}),
+        readOnly: true,
+        json: true,
+        command: () => ({ args: ['history', '--json'] }),
+    }),
+    wait: tool({
+        description: 'Waits until apps are healthy (answering, and passing their ready check), up or down. Fails on a timeout or an app that exits, naming each state.',
+        input: z.strictObject({
+            apps: z.array(app).min(1).max(50),
+            until: z.enum(['healthy', 'up', 'down']),
+            timeoutSeconds: z.number().int().min(1).max(1800).optional().describe('120 when left out'),
+        }),
+        readOnly: true,
+        json: true,
+        command: ({ apps, until, timeoutSeconds }) => ({
+            args: ['wait', ...apps, `--${until}`, '--timeout', String(timeoutSeconds ?? 120), '--json'],
+        }),
+    }),
+    say: tool({
+        description: "Shows a question, a result or a failure in the canvas's inbox. Commands for the user go in a section's commands.",
+        input: z.strictObject({
+            kind: z.enum(['question', 'result', 'failure', 'info']),
+            title: z.string().min(1).max(120),
+            summary: z.string().max(800).optional(),
+            run: z.string().regex(RUN_ID).optional().describe('The run it is about'),
+            sections: z
+                .array(z.strictObject({
+                title: z.string().max(80),
+                items: z.array(z.string().max(400)).max(12),
+                commands: z.array(z.string().max(1000)).max(6).optional(),
+            }))
+                .max(8)
+                .optional(),
+            choices: z
+                .array(z.strictObject({
+                id: z.string().regex(/^[a-z0-9-]{1,32}$/),
+                label: z.string().min(1).max(80),
+                detail: z.string().max(300).optional(),
+            }))
+                .max(6)
+                .optional(),
+        }),
+        readOnly: false,
+        json: false,
+        command: message => ({ args: ['say'], stdin: JSON.stringify(message) }),
+    }),
+};
+const ENTRY = path.join(CODE, 'koppler.mjs');
+/** Runs koppler with the given arguments: what it printed, and whether it failed. */
+const koppler = (args, stdin) => new Promise(resolve => {
+    const child = execFile(process.execPath, [ENTRY, ...args], { maxBuffer: 8 << 20, timeout: 31 * 60_000 }, (error, out, err) => {
+        resolve({ out, err, failed: !!error });
+    });
+    child.stdin?.end(stdin ?? '');
+});
+async function call(name, given) {
+    if (!Object.hasOwn(TOOLS, name))
+        return { content: [{ type: 'text', text: `No tool called ${name}` }], isError: true };
+    const one = TOOLS[name];
+    const parsed = one.input.safeParse(given ?? {});
+    if (!parsed.success)
+        return { content: [{ type: 'text', text: z.prettifyError(parsed.error) }], isError: true };
+    const { args, stdin } = one.command(parsed.data);
+    const { out, err, failed } = await koppler(args, stdin);
+    const text = [out.trim(), err.trim()].filter(Boolean).join('\n') || (failed ? 'failed' : 'done');
+    let structured;
+    if (one.json)
+        try {
+            structured = JSON.parse(out);
+        }
+        catch {
+            // Not JSON (a failure said in words): the text says it.
+        }
+    const object = structured && typeof structured === 'object' && !Array.isArray(structured);
+    return {
+        content: [{ type: 'text', text }],
+        ...(object
+            ? { structuredContent: structured }
+            : structured !== undefined && { structuredContent: { result: structured } }),
+        isError: failed,
+    };
+}
+const PROTOCOLS = ['2025-06-18', '2025-03-26', '2024-11-05'];
+async function answer(request, version) {
+    const { method, params = {} } = request;
+    if (method === 'initialize') {
+        const asked = typeof params['protocolVersion'] === 'string' ? params['protocolVersion'] : '';
+        return {
+            protocolVersion: PROTOCOLS.includes(asked) ? asked : PROTOCOLS[0],
+            capabilities: { tools: {} },
+            serverInfo: { name: 'koppler', version },
+            instructions: 'Koppler runs part of a stack locally. Read with status, plan, history, logs and doctor; wait for apps with wait; talk to the user on the canvas with say. Starting, stopping and approving stay with the koppler command and the user.',
+        };
+    }
+    if (method === 'ping')
+        return {};
+    if (method === 'tools/list')
+        return {
+            tools: Object.entries(TOOLS).map(([name, one]) => ({
+                name,
+                description: one.description,
+                inputSchema: z.toJSONSchema(one.input),
+                ...(one.json && { outputSchema: JSON_OUT }),
+                annotations: { readOnlyHint: one.readOnly },
+            })),
+        };
+    if (method === 'tools/call')
+        return call(typeof params['name'] === 'string' ? params['name'] : '', params['arguments']);
+    throw Object.assign(new Error(`Method not found: ${String(method)}`), { code: -32601 });
+}
+/** Serves MCP over stdin and stdout, one JSON message a line, until stdin closes. */
+export async function mcp(version) {
+    const send = (message) => process.stdout.write(`${JSON.stringify(message)}\n`);
+    const lines = readline.createInterface({ input: process.stdin });
+    const pending = new Set();
+    for await (const line of lines) {
+        if (!line.trim())
+            continue;
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            send({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+            continue;
+        }
+        // A notification gets no answer.
+        if (request.id === undefined)
+            continue;
+        const id = request.id;
+        const done = answer(request, version).then(result => {
+            send({ jsonrpc: '2.0', id, result });
+        }, (error) => {
+            const { code = -32603, message = String(error) } = error;
+            send({ jsonrpc: '2.0', id, error: { code, message } });
+        });
+        pending.add(done);
+        void done.finally(() => pending.delete(done));
+    }
+    await Promise.all(pending);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/mcp.js.map

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

package/dist/cli/output.js

@@ -0,0 +1,37 @@
+// What every command shares when it talks to the person at the terminal: asking, tables, and reading its arguments.
+import { fail } from "../failure.js";
+/** A y/N question in a terminal; without one (a script, an agent), only --yes says yes. */
+export async function confirm(question, args = []) {
+    if (args.includes('--yes') || args.includes('-y'))
+        return true;
+    if (!process.stdin.isTTY)
+        return false;
+    const { createInterface } = await import('node:readline/promises');
+    const terminal = createInterface({ input: process.stdin, output: process.stderr });
+    const answer = (await terminal.question(`${question} [y/N] `)).trim().toLowerCase();
+    terminal.close();
+    return answer === 'y' || answer === 'yes';
+}
+/** Rows as columns, each as wide as its longest cell. */
+export function table(rows) {
+    const widths = (rows[0] ?? []).map((_, column) => Math.max(...rows.map(row => String(row[column] ?? '').length)));
+    for (const row of rows)
+        console.log(row
+            .map((cell, column) => String(cell).padEnd(widths[column] ?? 0))
+            .join('  ')
+            .trimEnd());
+}
+/** The arguments that are not options, nor the value of one of the `valued` options. */
+export const positional = (args, valued = []) => args.filter((arg, at) => !arg.startsWith('-') && !valued.includes(args[at - 1] ?? ''));
+export const flagValue = (args, name) => {
+    const at = args.indexOf(name);
+    return at >= 0 ? args[at + 1] : undefined;
+};
+/** The environment a command was asked for, the stack's first when none was; an unknown one ends the command. */
+export function envOf(stack, args) {
+    const env = flagValue(args, '--env') ?? stack.envs[0] ?? '';
+    if (!stack.envs.includes(env))
+        fail(`unknown env ${env}; the stack has ${stack.envs.join(', ')}`);
+    return env;
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

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

package/dist/cli/records.js

@@ -0,0 +1,121 @@
+// What an agent records while it helps with a run, through commands: the changes Stop must undo, and the steps a card
+// shows. Nobody writes these files by hand, so each entry is checked and each file is written whole.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fail } from "../failure.js";
+import { readActions, updateActions } from "../engine/actions.js";
+import { APP_ID } from "../ids.js";
+import { readJson, writeJson } from "../json-files.js";
+import { tempDir } from "../paths.js";
+import { redact } from "../scrub.js";
+import { flagValue, positional } from "./output.js";
+const LOG = () => path.join(tempDir(), 'actions.json');
+/** What each kind of entry cannot do without. `checkout` is written by `koppler switch` only. */
+const NEEDS = {
+    edit: ['file', 'before', 'after'],
+    profile: ['file', 'name'],
+    'env-file': ['file', 'lines'],
+    file: ['file'],
+    'npm-local': ['repo', 'packages'],
+    process: ['command'],
+    secret: ['app', 'env'],
+};
+const ACTIONS = "usage: koppler actions [--json] | add '<json>' | add --file <json file> | clear [--app <app>]";
+function checked(entry) {
+    if (typeof entry !== 'object' || entry === null || Array.isArray(entry))
+        fail('an entry is an object with a kind');
+    const fields = entry;
+    const kind = typeof fields['kind'] === 'string' ? fields['kind'] : '';
+    const needs = Object.hasOwn(NEEDS, kind) ? NEEDS[kind] : undefined;
+    if (!needs)
+        fail(`kind "${kind}" is not one an entry can have: ${Object.keys(NEEDS).join(', ')}`);
+    const missing = needs.filter(name => fields[name] === undefined);
+    if (missing.length)
+        fail(`a ${kind} entry needs ${missing.join(', ')}`);
+    if (fields['app'] !== undefined && !(typeof fields['app'] === 'string' && APP_ID.test(fields['app'])))
+        fail('app is an app id of the stack');
+    // Stop looks a file up by its full path; one written from another folder would be found in the wrong place.
+    if (typeof fields['file'] === 'string' && !path.isAbsolute(fields['file']))
+        fail(`file is a full path, not ${fields['file']}`);
+    const text = JSON.stringify(entry);
+    if (redact(text) !== text)
+        fail('the entry holds what looks like a secret value; the log never keeps one');
+    return entry;
+}
+/** `koppler actions`: the changes Stop undoes; `add` logs one before it is made, `clear` empties the log after a revert. */
+export function actionsCommand(args) {
+    const [verb] = positional(args, ['--file', '--app']);
+    if (verb === 'add') {
+        const file = flagValue(args, '--file');
+        const given = file ? fs.readFileSync(file, 'utf8') : (positional(args, ['--file'])[1] ?? fail(ACTIONS));
+        let parsed;
+        try {
+            parsed = JSON.parse(given);
+        }
+        catch {
+            fail('that is not JSON: an entry such as {"kind":"env-file","app":"orders","file":"/full/path/.env.local","lines":["A=1"]}');
+        }
+        const entries = [parsed].flat().map(checked);
+        const total = updateActions(LOG(), list => list.push(...entries));
+        console.log(`Logged ${String(entries.length)} ${entries.length === 1 ? 'change' : 'changes'}; ${String(total)} for Stop to undo.`);
+        return;
+    }
+    if (verb === 'clear') {
+        const app = flagValue(args, '--app');
+        const left = updateActions(LOG(), list => {
+            const keep = app ? list.filter(action => action.app !== app) : [];
+            list.splice(0, list.length, ...keep);
+            return keep.length;
+        });
+        console.log(app ? `Cleared ${app}'s entries; ${String(left)} left.` : 'The action log is empty.');
+        return;
+    }
+    if (verb)
+        fail(ACTIONS);
+    const list = readActions(LOG());
+    if (args.includes('--json'))
+        console.log(JSON.stringify(list, null, 2));
+    else if (!list.length)
+        console.log('Nothing logged: Stop has no change to undo.');
+    else
+        for (const action of list)
+            console.log(`${action.app ?? '-'}  ${action.kind}  ${'file' in action ? action.file : ''}`);
+}
+const STATES = ['done', 'todo', 'user', 'failed'];
+const STEP = 'usage: koppler status step <app> "<label>" done|todo|user|failed [--detail "<what>"] [--copy "<command>"] [--port <n>] [--log <file>] | step <app> --clear';
+/** `koppler status step`: one step of an app's checklist on its card, set or replaced by its label. */
+export function stepCommand(args) {
+    const [app, label, state] = positional(args, ['--detail', '--copy', '--port', '--log']);
+    if (!app || !APP_ID.test(app))
+        fail(STEP);
+    const file = path.join(tempDir(), 'status.json');
+    const read = readJson(file);
+    const shown = typeof read === 'object' && read !== null && !Array.isArray(read) ? read : {};
+    const apps = { ...shown.apps };
+    if (args.includes('--clear')) {
+        delete apps[app]; // eslint-disable-line @typescript-eslint/no-dynamic-delete -- checked to be an app id
+        writeJson(file, { ...shown, apps });
+        console.log(`${app}: no steps of yours on its card.`);
+        return;
+    }
+    if (!label || !state || !STATES.includes(state))
+        fail(STEP);
+    const cut = (text, most) => (text ? redact(text).slice(0, most) : undefined);
+    const detail = cut(flagValue(args, '--detail'), 400);
+    const copy = cut(flagValue(args, '--copy'), 2000);
+    const port = Number(flagValue(args, '--port'));
+    const log = flagValue(args, '--log');
+    const step = { label: label.slice(0, 60), state, ...(detail && { detail }), ...(copy && { copy }) };
+    const now = apps[app] ?? {};
+    const steps = now.steps ?? [];
+    const at = steps.findIndex(one => one.label === step.label);
+    apps[app] = {
+        ...now,
+        ...(Number.isInteger(port) && port > 0 && port < 65536 && { port }),
+        ...(log && { log: path.resolve(log) }),
+        steps: at >= 0 ? steps.with(at, step) : [...steps, step],
+    };
+    writeJson(file, { ...shown, apps });
+    console.log(`${app}: ${step.label} ${state}`);
+}
+//# sourceMappingURL=records.js.map

package/dist/cli/records.js.map

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