koppler 0.0.0-stage → 0.0.2

package/dist/engine/app-commands.js

@@ -0,0 +1,106 @@
+// `koppler do`: a command an app declares in the stack (Seed, Migrate), run in its clone with its secrets, once the
+// user has allowed the stack's commands. From the canvas, its end is said in the inbox.
+import path from 'node:path';
+import { confirm, flagValue, positional } from "../cli/output.js";
+import { appOn, storeOf } from "../core/stack.js";
+import { readClones, readStack } from "../data.js";
+import { fail, Failure } from "../failure.js";
+import { BIN } from "../paths.js";
+import { loadsCode } from "../safe-env.js";
+import { APPROVE, approved } from "./checks.js";
+import { live } from "./history.js";
+import { appendMessage } from "./messages.js";
+import { startProcess } from "./processes.js";
+const USAGE = 'usage: koppler do <app> <command> [--arg <name>=<value>]... [--env <env>] [--yes]';
+function argsFor(asked, args) {
+    const given = {};
+    args.forEach((arg, at) => {
+        if (args[at - 1] !== '--arg')
+            return;
+        const cut = arg.indexOf('=');
+        if (cut < 1)
+            fail(`--arg takes <name>=<value> (got ${arg})`);
+        given[arg.slice(0, cut)] = arg.slice(cut + 1);
+    });
+    for (const name of Object.keys(given))
+        if (!asked.some(one => one.name === name))
+            fail(`it takes no ${name}; it takes ${asked.map(one => one.name).join(', ') || 'nothing'}`);
+    const kept = {};
+    for (const one of asked) {
+        if (loadsCode(one.name))
+            fail(`${one.name} cannot be given: it would make the runtime load other code`);
+        const value = given[one.name] ?? '';
+        if (!value) {
+            if (one.required)
+                fail(`it needs ${one.name}: --arg ${one.name}=<value>`);
+            continue;
+        }
+        if (one.type === 'number' && !/^-?\d+(\.\d+)?$/.test(value))
+            fail(`${one.name} is a number (got ${value})`);
+        if (one.type === 'choice' && !(one.choices ?? []).includes(value))
+            fail(`${one.name} is one of ${(one.choices ?? []).join(', ')} (got ${value})`);
+        kept[one.name] = value;
+    }
+    return kept;
+}
+async function doIt(args, canvas) {
+    const [id = '', key = ''] = positional(args, ['--env', '--arg']);
+    if (!id || !key)
+        fail(USAGE);
+    const stack = readStack() ?? fail('no stack loaded (koppler init)');
+    const app = Object.hasOwn(stack.apps, id) ? stack.apps[id] : undefined;
+    if (!app)
+        fail(`${id} is not an app in the stack`);
+    const commands = app.commands ?? {};
+    const command = Object.hasOwn(commands, key) ? commands[key] : undefined;
+    if (!command)
+        fail(`${app.name} has no command ${key}; it has ${Object.keys(commands).join(', ') || 'none'}`);
+    const show = command.show ?? 'both';
+    if (show === (canvas ? 'cli' : 'canvas'))
+        fail(`${command.label} is offered ${show === 'canvas' ? 'on the canvas' : 'with koppler do'} only`);
+    if (!approved(stack.source ?? '', stack))
+        fail(`${command.label} is a command from the stack that you have not allowed yet, or that changed since. Review it in your own terminal: ${APPROVE}`);
+    const given = argsFor(command.args ?? [], args);
+    if (command.confirm && !(await confirm(command.confirm, args)))
+        fail(`not run: ${command.confirm} Pass --yes to run it.`);
+    const env = flagValue(args, '--env') ?? live()?.env ?? stack.envs[0] ?? '';
+    if (!stack.envs.includes(env))
+        fail(`unknown env ${env}; the stack has ${stack.envs.join(', ')}`);
+    if ((appOn(stack, id, env) ?? app).outside)
+        fail(`${app.name} does not run on this Mac`);
+    const repo = readClones()[id]?.path ?? fail(`${id} is not cloned (koppler sync --rescan after cloning)`);
+    await startProcess({
+        name: `${id}-${key}`.slice(0, 64).replace(/-+$/, ''),
+        command: [path.join(BIN, 'with-secrets'), storeOf(stack, id, env), '--', 'sh', '-c', command.run],
+        cwd: repo,
+        restart: false,
+        env,
+        holdsSecrets: true,
+        setEnv: given,
+        once: { timeout: command.timeout ?? 1800 },
+    });
+    return { app: app.name, label: command.label };
+}
+/** `koppler do`: runs it and waits for it; from the canvas (--from-canvas), says how it ended in the inbox. */
+export async function doCommand(args) {
+    const canvas = args.includes('--from-canvas');
+    try {
+        const { app, label } = await doIt(args, canvas);
+        if (canvas)
+            appendMessage({ kind: 'result', title: `${label} finished on ${app}` });
+    }
+    catch (error) {
+        if (canvas && error instanceof Failure && error.message) {
+            const [first = '', ...rest] = error.message.split('\n');
+            appendMessage({
+                kind: 'failure',
+                title: first.slice(0, 120),
+                ...(rest.length && {
+                    sections: [{ title: 'Its last lines', items: rest.slice(-12).map(line => line.slice(0, 400)) }],
+                }),
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=app-commands.js.map

package/dist/engine/app-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-commands.js","sourceRoot":"","sources":["../../src/engine/app-commands.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,wFAAwF;AACxF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,KAAK,GAAG,mFAAmF,CAAC;AASlG,SAAS,OAAO,CAAC,KAAc,EAAE,IAAc;IAC7C,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE;QACvB,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,OAAO;YAAE,OAAO;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,GAAG,CAAC;YAAE,IAAI,CAAC,mCAAmC,GAAG,GAAG,CAAC,CAAC;QAC7D,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;YACvC,IAAI,CAAC,eAAe,IAAI,cAAc,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,6DAA6D,CAAC,CAAC;QACxG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,GAAG,CAAC,QAAQ;gBAAE,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC;YAC1E,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,qBAAqB,KAAK,GAAG,CAAC,CAAC;QAC5G,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC/D,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,MAAe;IACjD,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG;QAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,SAAS,EAAE,IAAI,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,IAAI,CAAC,GAAG;QAAE,IAAI,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,mBAAmB,GAAG,YAAY,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9G,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IACpC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,eAAe,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,CAAC;IACtG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC;QACtC,IAAI,CACF,GAAG,OAAO,CAAC,KAAK,sHAAsH,OAAO,EAAE,CAChJ,CAAC;IACJ,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,eAAe,GAAG,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO;QAAE,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,2BAA2B,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,sDAAsD,CAAC,CAAC;IACzG,MAAM,YAAY,CAAC;QACjB,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;QACjG,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,KAAK;QACd,GAAG;QACH,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE;KAC3C,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,gBAAgB,GAAG,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,IAAI,KAAK,YAAY,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxD,aAAa,CAAC;gBACZ,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI;oBACjB,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;iBAChG,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/engine/app-start.js

@@ -0,0 +1,167 @@
+// Starting a stack app by its id: the facts are gathered here (the app as the environment has it, its clone, launch
+// profiles, the device), the command comes from core/launch, and the app's stored secrets are checked and attached.
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { APPROVE, approved, startsFromStack } from "./checks.js";
+import { fail } from "../failure.js";
+import { launchProfile, mockCommand, startCommand } from "../core/launch.js";
+import { isProtected } from "../core/plan.js";
+import { readClones, readStack } from "../data.js";
+import { repoFiles } from "./investigate.js";
+import { readJson } from "../json-files.js";
+import { BIN, CODE, tempDir } from "../paths.js";
+import { resolveDevice } from "./devices.js";
+import { sh } from "./processes.js";
+import { appOn, storeOf } from "../core/stack.js";
+/** Where a Flutter app's `flutter run` keeps its process id: hot reload signals it. */
+export const flutterPid = (id) => path.join(tempDir(), `flutter-${id}.pid`);
+/** The file a run writes for a Lambda: the keys of its secret that point at local apps. */
+export const lambdaOverrides = (id) => path.join(tempDir(), `lambda-${id}.json`);
+/** A .NET app's launch profiles, from its clone. */
+export function profilesOf(app, repo) {
+    if (app.kind !== 'dotnet' || !app.launchSettings || !repo)
+        return {};
+    const settings = readJson(path.join(repo, app.launchSettings));
+    return settings?.profiles ?? {};
+}
+/** A .NET app's plain http address from its launch profile, for callers that cannot use its development certificate. */
+export function httpUrlOf(app, repo, env) {
+    if (app.kind !== 'dotnet' || !app.launchSettings)
+        return null;
+    const profiles = profilesOf(app, repo);
+    const profile = profiles[launchProfile(app, profiles, env).name];
+    return (profile?.applicationUrl ?? '').split(';').find(url => url.startsWith('http://')) ?? null;
+}
+/** Tries one stored secret against the address inside it; the outcome only, never the value. */
+export function secretTest(store, secret) {
+    const args = [store, secret.env ?? '', ...(secret.type ? ['--type', secret.type] : [])];
+    try {
+        const said = execFileSync(path.join(BIN, 'secret-test'), args, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 40000,
+        });
+        return { code: 0, message: said.trim() };
+    }
+    catch (error) {
+        const failed = error;
+        return { code: failed.status ?? 1, message: (failed.stdout ?? '').trim() || 'failed: the check did not finish' };
+    }
+}
+/** The facts core/launch needs for this app, read from its clone and from what was asked for. */
+function contextFor(id, app, repo, env, options, aliases, device) {
+    // Settings given for this start (a cable's local address) come from the environment and must win over the launch
+    // profile.
+    const ctx = {
+        repo,
+        env,
+        id,
+        engine: CODE,
+        lambdaOverrides: lambdaOverrides(id),
+        flutterPid: flutterPid(id),
+        override: Object.keys(options.setEnv ?? {}),
+        envNames: [env, ...aliases],
+    };
+    if (app.kind === 'dotnet' && app.launchSettings)
+        ctx.profiles = profilesOf(app, repo);
+    if (app.kind === 'node' || app.kind === 'web') {
+        ctx.pkg = readJson(path.join(repo, 'package.json'));
+        if (ctx.pkg?.scripts)
+            ctx.scripts = ctx.pkg.scripts;
+    }
+    if (device)
+        ctx.device = device;
+    else {
+        ctx.files = repoFiles(repo);
+        if (options.device === 'ios' || options.device === 'android')
+            ctx.platform = options.device;
+    }
+    if (options.lan) {
+        ctx.lan = true;
+        ctx.httpPort = Number(new URL(httpUrlOf(app, repo, env) ?? 'http://x').port) || undefined;
+    }
+    return ctx;
+}
+/**
+ * Each environment after the first has its own secret store, so a value of one never replaces or leaks into another.
+ * Ends the command when a secret the app always needs is not stored there, or when a stored one does not pass its test.
+ */
+function checkSecrets(id, app, store, env, test) {
+    // A secret needed only in some case (`when`) is not asked for up front.
+    const always = ({ when }) => typeof when !== 'string' || !when || /^always\b/i.test(when.trim());
+    const named = (app.secrets ?? []).filter(secret => secret.env);
+    const wanted = named.filter(always).map(secret => secret.env ?? '');
+    if (store !== id && wanted.length > 0) {
+        const have = sh(path.join(BIN, 'secret-list'), [store]).split(/\s+/);
+        const missing = wanted.filter(name => !have.includes(name));
+        if (missing.length > 0)
+            fail(`${id} has no ${missing.join(', ')} stored for ${env.toUpperCase()}; see: koppler doctor ${id} --env ${env}`);
+    }
+    if (!test)
+        return;
+    for (const secret of named) {
+        const result = secretTest(store, secret);
+        const name = secret.env ?? '';
+        if (result.code === 1) {
+            const why = result.message.replace(/^failed: /, 'did not pass its test: ');
+            fail(`${id}: ${name} for ${env.toUpperCase()} ${why}. Fix it, or start anyway with --no-test.`);
+        }
+        if (result.code === 0)
+            console.log(`${name}: ${result.message}`);
+    }
+}
+/** How to start a stack app by id, in the chosen environment; null when the stack has no such app. */
+export function appStart(id, options) {
+    const stack = readStack();
+    const base = stack?.apps[id];
+    if (!stack || !base)
+        return null;
+    // An app the stack marks as living outside this machine (a SaaS, a managed service) is never started here.
+    if (base.outside)
+        fail(`${base.name} does not run on this Mac: ${String(base.outside)}`);
+    const first = stack.envs[0];
+    const env = options.env ?? first ?? '';
+    if (!stack.envs.includes(env))
+        fail(`unknown env ${env}; the stack has ${stack.envs.join(', ')}`);
+    const app = appOn(stack, id, env) ?? base;
+    if (options.mock) {
+        const mock = mockCommand(app, CODE);
+        if (mock.error !== undefined)
+            fail(`${id}: ${mock.error}`);
+        return { cwd: undefined, command: mock.command, port: mock.port, onStop: undefined, device: undefined, env };
+    }
+    // A start command written in the shared stack runs only once the user has seen and allowed it, and again after it
+    // changes.
+    if (startsFromStack(stack, id, env) && !approved(stack.source ?? '', stack))
+        fail(`${base.name} is started by a command from the stack that you have not allowed yet, or that changed since. Review it in your own terminal: ${APPROVE}`);
+    const repo = readClones()[id]?.path ?? fail(`${id} is not cloned (koppler sync --rescan after cloning)`);
+    const device = app.kind === 'flutter' ? resolveDevice(options.device, app) : undefined;
+    const ctx = { ...contextFor(id, app, repo, env, options, stack.envAliases?.[env] ?? [], device), stack };
+    const start = startCommand(app, ctx);
+    if (start.error !== undefined)
+        fail(`${id}: ${start.error}; or run any command: koppler run ${id} -- <command>`);
+    const store = storeOf(stack, id, env);
+    // A protected environment's store asks the user on every read, so it is only tried when asked (--test); --no-test
+    // skips the check everywhere.
+    checkSecrets(id, app, store, env, !options.dryRun && (options.test ?? !isProtected(stack, env)));
+    // Only an app started by id gets its stored secrets; an arbitrary command never does.
+    return {
+        cwd: start.cwd,
+        command: [path.join(BIN, 'with-secrets'), store, '--', ...start.command],
+        port: start.port,
+        onStop: start.onStop,
+        device,
+        env,
+        // On its own address, so an https app is asked over https.
+        ...(app.once && { once: app.once }),
+        ...(app.ready &&
+            app.url && {
+            ready: {
+                url: new URL(app.ready.path, app.url).toString(),
+                status: app.ready.status,
+                timeout: app.ready.timeout,
+            },
+        }),
+    };
+}
+//# sourceMappingURL=app-start.js.map

package/dist/engine/app-start.js.map

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

package/dist/engine/app-state.js

@@ -0,0 +1,43 @@
+// An app's state in words the canvas, `koppler status --json` and `koppler wait` share.
+import { readStack } from "../data.js";
+import { alive, listener, readRecord, statusOf, tailOf } from "./processes.js";
+/** What its process says: building until its port answers, unhealthy while its ready check fails; null when none ran. */
+export async function processState(name) {
+    const record = readRecord(name);
+    if (!record)
+        return null;
+    if (!alive(record)) {
+        const last = tailOf(record.log, 1).trim();
+        return { state: 'exited', detail: last ? `It stopped. Its last line: ${last.slice(0, 200)}` : 'It stopped.' };
+    }
+    if (record.port && !listener(record.port, record.bind))
+        return { state: 'building', detail: `Nothing answers on port ${String(record.port)} yet.` };
+    const app = readStack()?.apps[name];
+    if (!app?.ready || !app.url)
+        return { state: 'running', detail: '' };
+    const url = new URL(app.ready.path, app.url);
+    const status = await statusOf(url);
+    const ok = status !== null && (app.ready.status === undefined ? status < 400 : status === app.ready.status);
+    if (ok)
+        return { state: 'running', detail: '' };
+    return {
+        state: 'unhealthy',
+        detail: status === null ? `Nothing answers at ${url.pathname}.` : `${url.pathname} answers ${String(status)}.`,
+    };
+}
+/** The state to show: a live process first, then what the run says of its start, then a secret it lacks. */
+export function stateOf(process, steps = [], missing = []) {
+    const start = steps.find(step => step.label === 'Start');
+    if (process && process.state !== 'exited')
+        return process;
+    if (start?.state === 'failed')
+        return { state: 'failed-to-start', detail: start.detail ?? '' };
+    if (process)
+        return process;
+    if (start?.state === 'todo')
+        return { state: 'waiting', detail: start.detail ?? '' };
+    if (missing.length)
+        return { state: 'secret-missing', detail: missing.join(', ') };
+    return null;
+}
+//# sourceMappingURL=app-state.js.map

package/dist/engine/app-state.js.map

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

package/dist/engine/boards.js

@@ -0,0 +1,219 @@
+// Changing a board from the terminal. The change goes into state.json at once, and waits in board-edits.json for an
+// open canvas to make it on its own copy too, so the canvas shows it and never saves its older copy over it.
+import path from 'node:path';
+import { describeEdit, editPreset, migrate, VERSION } from "../core/presets.js";
+import { canvas } from "../cli/running.js";
+import { fetchPresets } from "../server/sanitize.js";
+import { readClones, readData, readStack, writeData } from "../data.js";
+import { fail } from "../failure.js";
+import { appendMessage } from "./messages.js";
+import { alive, readRecord } from "./processes.js";
+import { shareBoard } from "./share.js";
+import { currentStack } from "./stacks.js";
+const queued = () => (readData('board-edits')?.['edits'] ?? []);
+const DAY = 86_400_000;
+/** The edits an open canvas of the stack in use has not made yet. */
+export const boardEdits = () => queued().filter(one => one.stack === currentStack());
+/** The canvas made it (or had it already): it waits no longer. */
+export function editDone(id) {
+    writeData('board-edits', { edits: queued().filter(one => one.id !== id) });
+}
+const CHANGES = '[--propose] [--add <app,...>] [--remove <app,...>] [--cable <caller>:<callee>]... [--uncable <caller>:<callee>]... [--branch <app>=<branch>]... [--note <app>="<note>"]... [--arrange]';
+const USAGE = `usage: koppler board new "<name>" ${CHANGES}\n       koppler board edit "<name>" ${CHANGES}\n       koppler board share "<name>"\n       koppler board open <file or link>`;
+/** Your own board, by name, as kept for this stack. */
+const ownBoard = (name) => {
+    const own = (readData('state')?.['presets'] ?? []);
+    return own.find(one => one.name === name) ?? own.find(one => one.name.toLowerCase() === name.toLowerCase());
+};
+/** Opens the pull request that makes one of your boards a team board of the stack in use. */
+async function share(name) {
+    const dir = currentStack() ?? fail('no stack in use (koppler use)');
+    const board = ownBoard(name) ?? fail(`${name} is not one of your boards; koppler use --boards lists them`);
+    const shared = await shareBoard(dir, board);
+    if (shared.error !== undefined)
+        fail(shared.error);
+    if (shared.local)
+        console.log(`KEPT ${board.name} among the stack's team boards in ${dir}; commit the stack there so your team gets it.`);
+    else
+        console.log(`PROPOSED ${board.name} to the team on ${shared.repo}: ${shared.url}`);
+}
+export function boardCommand(args) {
+    const [what, name] = args;
+    if (what === 'share' && name && !name.startsWith('-'))
+        return share(name);
+    if (what === 'open' && name && !name.startsWith('-'))
+        return openBoard(name, args.includes('--no-open'));
+    if ((what !== 'edit' && what !== 'new') || !name?.trim() || name.startsWith('-'))
+        fail(USAGE);
+    const create = what === 'new';
+    const values = (flag) => args.filter((_, at) => args[at - 1] === flag);
+    const ids = (flag) => values(flag).flatMap(value => value
+        .split(',')
+        .map(id => id.trim())
+        .filter(Boolean));
+    const pairs = (flag, by) => values(flag).map(value => {
+        const at = value.indexOf(by);
+        if (at < 1)
+            fail(`${flag} ${value}: expected <app>${by}<value>\n${USAGE}`);
+        return [value.slice(0, at), value.slice(at + 1)];
+    });
+    const cables = (flag) => pairs(flag, ':').map(([from, to]) => ({ from, to }));
+    const edit = {
+        add: ids('--add'),
+        remove: ids('--remove'),
+        cable: cables('--cable'),
+        uncable: cables('--uncable'),
+        branch: Object.fromEntries(pairs('--branch', '=')),
+        note: Object.fromEntries(pairs('--note', '=')),
+        ...(args.includes('--arrange') && { arrange: true }),
+    };
+    for (const line of changeBoard(name, edit, create, args.includes('--propose')))
+        console.log(line);
+}
+/**
+ * `koppler board open <file or link>`: a board from a file here or a link on GitHub joins your boards, and the canvas
+ * opens on it. It remembers where it came from, so the canvas can read it again (Reload).
+ */
+async function openBoard(where, quiet) {
+    const source = /^https?:\/\//.test(where) ? where : path.resolve(where);
+    if (!/^https?:/.test(source) && !source.endsWith('.json'))
+        fail(`${where}: a board file is a .json file`);
+    const read = await fetchPresets(source);
+    if (read.error !== undefined)
+        fail(read.error);
+    const [first] = read.presets;
+    const checked = first && migrate(first);
+    if (!first || !checked || checked.error !== undefined)
+        fail(checked?.error ?? 'No board found in it.');
+    // Kept as the plain board it was read as.
+    const board = JSON.parse(JSON.stringify({ ...first, name: first.name.trim().slice(0, 80), source }));
+    const state = readData('state') ?? {};
+    const own = (state['presets'] ?? []);
+    writeData('state', { ...state, presets: [...own.filter(one => one.name !== board.name), board] });
+    const now = Date.now();
+    writeData('board-edits', {
+        edits: [
+            ...queued().filter(one => now - Date.parse(one.at) < DAY),
+            {
+                id: now.toString(36) + Math.random().toString(36).slice(2, 8),
+                at: new Date(now).toISOString(),
+                stack: currentStack(),
+                board: board.name,
+                edit: {},
+                preset: board,
+            },
+        ],
+    });
+    console.log(`OPENED ${board.name} from ${source}`);
+    if (quiet)
+        console.log(`An open canvas shows it; or: koppler canvas --board "${board.name}"`);
+    else
+        await canvas(['--board', board.name]);
+}
+const proposals = () => (readData('board-proposals')?.['proposals'] ?? []);
+/**
+ * The user answered a proposal: the change is made as `koppler board edit` makes it, or left. Null when the message
+ * was no proposal.
+ */
+export function answerProposal(message, accepted) {
+    const proposal = proposals().find(one => one.message === message);
+    if (!proposal)
+        return null;
+    writeData('board-proposals', { proposals: proposals().filter(one => one !== proposal && one.message !== message) });
+    if (!accepted)
+        return `Left ${proposal.board} as it is.`;
+    return changeBoard(proposal.board, proposal.edit, !!proposal.create, false).join(' ');
+}
+/** Checks a change to a board and makes it, or, proposed, asks the user in the inbox first and changes nothing. */
+export function changeBoard(name, edit, create, propose) {
+    const stack = readStack() ?? fail('no stack loaded (koppler init)');
+    const state = readData('state') ?? {};
+    const own = (state['presets'] ?? []);
+    const team = (stack.presets ?? []);
+    const lower = name.toLowerCase();
+    const found = [...own, ...team].find(one => one.name === name) ?? [...own, ...team].find(one => one.name.toLowerCase() === lower);
+    if (create && found)
+        fail(`a board called ${found.name} already exists; change it with koppler board edit`);
+    const board = found ??
+        (create
+            ? { name: name.trim(), version: VERSION, nodes: {}, edges: [] }
+            : fail(`no board called ${name}; koppler board new makes one, koppler use --boards lists them`));
+    const app = (id) => stack.apps[id];
+    const clones = readClones();
+    for (const id of edit.add ?? []) {
+        if (!app(id))
+            fail(`${id} is not an app in the stack`);
+        if (app(id)?.outside)
+            fail(`${app(id)?.name ?? id} does not run on this Mac`);
+        if (!clones[id])
+            fail(`${app(id)?.name ?? id} is not cloned on this Mac (koppler sync prints how)`);
+    }
+    const on = new Set([...Object.keys(board.nodes).filter(id => !edit.remove?.includes(id)), ...(edit.add ?? [])]);
+    const here = (id, why) => {
+        if (!on.has(id))
+            fail(`${id} is not on ${board.name}, so it cannot ${why}`);
+    };
+    for (const id of edit.remove ?? [])
+        if (!Object.hasOwn(board.nodes, id))
+            fail(`${id} is not on ${board.name}`);
+    for (const id of Object.keys(edit.branch ?? {}))
+        here(id, 'take a branch');
+    for (const id of Object.keys(edit.note ?? {}))
+        here(id, 'take a note');
+    for (const { from, to } of edit.cable ?? []) {
+        here(from, 'call');
+        here(to, 'be called');
+    }
+    const changed = { ...editPreset(board, edit), name: board.name };
+    if (!create && JSON.stringify(changed) === JSON.stringify(board))
+        return [`Nothing to change on ${board.name}.`];
+    const named = (id) => app(id)?.name ?? id;
+    if (propose) {
+        const asked = appendMessage({
+            kind: 'question',
+            title: create ? `Make the board ${board.name}?` : `Change ${board.name}?`,
+            summary: 'The agent proposes this. Nothing changes until you say yes.',
+            sections: [{ title: 'It would', items: describeEdit(edit, named, true).split('; ').filter(Boolean) }],
+            choices: [
+                { id: 'accept', label: create ? 'Make it' : 'Make the change' },
+                { id: 'reject', label: 'Leave it as it is' },
+            ],
+        });
+        writeData('board-proposals', {
+            proposals: [
+                ...proposals(),
+                { message: asked.id, stack: currentStack(), board: board.name, edit, ...(create && { create: true }) },
+            ],
+        });
+        return [
+            `PROPOSED ${board.name}: ${describeEdit(edit, named)}`,
+            'The user answers in the canvas inbox; the answer comes back as a koppler-reply prompt.',
+        ];
+    }
+    const mine = own.some(one => one.name === board.name);
+    writeData('state', {
+        ...state,
+        presets: mine ? own.map(one => (one.name === board.name ? changed : one)) : [...own, changed],
+    });
+    const now = Date.now();
+    const entry = {
+        id: now.toString(36) + Math.random().toString(36).slice(2, 8),
+        at: new Date(now).toISOString(),
+        stack: currentStack(),
+        board: board.name,
+        edit,
+        ...(create && { create: true }),
+    };
+    writeData('board-edits', {
+        edits: [...queued().filter(one => now - Date.parse(one.at) < DAY), entry],
+    });
+    const canvas = readRecord('canvas');
+    const said = describeEdit(edit, named);
+    return [
+        `${create ? 'MADE' : 'CHANGED'} ${board.name}${said ? `: ${said}` : ''}`,
+        canvas && alive(canvas)
+            ? 'An open canvas shows the change as soon as it is in view.'
+            : 'The canvas shows the change when it is opened.',
+    ];
+}
+//# sourceMappingURL=boards.js.map

package/dist/engine/boards.js.map

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