koppler 0.0.0-stage → 0.0.2

package/dist/engine/session.js

@@ -0,0 +1,130 @@
+// Session review, while Koppler itself is worked on (run from its source folder): after a full Stop and revert, everything
+// the session left behind is gathered in one folder, and the agent is asked to find and fix the problems the user ran into.
+import fs from 'node:fs';
+import path from 'node:path';
+import { CODE } from "../paths.js";
+import { redact } from "../scrub.js";
+export const isDev = () => !fs.realpathSync(CODE).split(path.sep).join('/').includes('/plugins/cache/');
+const read = (file) => {
+    try {
+        return fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return '';
+    }
+};
+const lastLines = (text, count) => text.trimEnd().split('\n').slice(-count).join('\n');
+const jsonl = (text) => text.split('\n').flatMap(line => {
+    try {
+        const entry = JSON.parse(line);
+        return entry ? [entry] : [];
+    }
+    catch {
+        return [];
+    }
+});
+const PROBLEM = /\b(error|exception|failed|fatal|unhandled|refused|denied|timed? ?out)\b/i;
+const STATES = ['done', 'failed', 'replaced', 'applying', 'waiting'];
+const indented = (text) => text
+    .trim()
+    .split('\n')
+    .map(line => `  ${line.trim()}`)
+    .join('\n');
+/** Gathers the session in a folder and returns it. The session is every run after the previous finished Stop, up to and with this one, or up to now. */
+export function collectSession({ temp, logsDir, stop, runs, }) {
+    const at = stop ? runs.findIndex(run => run.id === stop.id) : runs.length - 1;
+    const before = runs.slice(0, stop ? at : at + 1).findLastIndex(run => run.kind === 'stop' && run.state === 'done');
+    const session = runs.slice(before + 1, at + 1);
+    const from = session[0]?.at ?? '';
+    const to = new Date().toISOString();
+    const inRange = (entry) => (entry.at ?? '') >= from && (entry.at ?? '') <= to;
+    const dir = path.join(temp, 'sessions', stop?.id ?? 'current');
+    // What is going on is gathered afresh each time: nothing of an earlier look stays behind.
+    if (!stop)
+        fs.rmSync(dir, { recursive: true, force: true });
+    fs.mkdirSync(path.join(dir, 'logs'), { recursive: true });
+    const write = (name, body) => {
+        fs.writeFileSync(path.join(dir, name), body, { mode: 0o600 });
+    };
+    const lines = (entries) => entries.map(entry => JSON.stringify(entry)).join('\n');
+    write('runs.json', JSON.stringify(session.map(({ layout, ...run }) => run), null, 2));
+    const clicks = jsonl(read(path.join(temp, 'debug.jsonl'))).filter(inRange);
+    write('debug.jsonl', lines(clicks));
+    const messages = jsonl(read(path.join(temp, 'messages.jsonl'))).filter(entry => !entry.at || inRange(entry));
+    write('messages.jsonl', lines(messages));
+    const ups = session
+        .map(run => [run.id, redact(read(path.join(temp, `up-${run.id}.log`)))])
+        .filter(([, text]) => text);
+    for (const [id, text] of ups)
+        write(`up-${id}.log`, text);
+    const apps = [...new Set(session.flatMap(run => Object.keys(run.nodes ?? {})))];
+    const appLogs = apps
+        .map(id => {
+        const log = path.join(logsDir, `${id}.log`);
+        return [id, redact(lastLines(read(`${log}.history`) + read(log), 3000))];
+    })
+        .filter(([, text]) => text.trim());
+    for (const [id, text] of appLogs)
+        write(path.join('logs', `${id}.log`), text);
+    write('canvas.log', redact(lastLines(read(path.join(logsDir, 'canvas.log')), 400)));
+    // What went wrong, at a glance; the details are in the files next to it.
+    const failed = session.filter(run => run.state === 'failed');
+    const left = ups.filter(([, text]) => text.includes('Left for the agent:'));
+    const pageErrors = clicks.filter(entry => entry.kind === 'error');
+    const warnings = clicks.filter(entry => entry.kind === 'message');
+    const questions = messages.filter(message => message.kind === 'question');
+    const clicked = {};
+    for (const { kind, what = '' } of clicks)
+        if (kind === 'click')
+            clicked[what] = (clicked[what] ?? 0) + 1;
+    const repeats = Object.entries(clicked)
+        .filter(([, count]) => count >= 4)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const logProblems = appLogs
+        .map(([id, text]) => [id, text.split('\n').filter(line => PROBLEM.test(line)).length])
+        .filter(([, count]) => count);
+    const states = STATES.map(state => [state, session.filter(run => run.state === state).length])
+        .filter(([, count]) => count)
+        .map(([state, count]) => `${String(count)} ${state}`);
+    const quoted = (texts) => texts.map(text => `"${String(text)}"`).join('; ');
+    const summary = [
+        `# Session ${from.slice(0, 16)} to ${to.slice(0, 16)}`,
+        '',
+        `${String(session.length)} runs: ${states.join(', ')}.`,
+        ...failed.map(run => `- Failed ${String(run.kind)} ${run.id}: ${run.reason ?? 'no reason given'}`),
+        ...left.map(([id, text]) => `- Koppler left work for the agent in ${id}:\n${indented(text.split('Left for the agent:')[1] ?? '')}`),
+        `${String(questions.length)} questions from the agent${questions.length ? `: ${quoted(questions.map(question => question.title))}` : ''}.`,
+        `${String(pageErrors.length)} page errors${pageErrors.length
+            ? `: ${pageErrors
+                .slice(0, 5)
+                .map(error => String(error.what))
+                .join('; ')}`
+            : ''}.`,
+        `Messages the user saw: ${quoted(warnings.slice(-10).map(warning => warning.what)) || 'none'}.`,
+        repeats.length
+            ? `Clicked many times (a sign of something not working): ${repeats.map(([what, count]) => `${what} x${String(count)}`).join('; ')}.`
+            : 'Nothing clicked over and over.',
+        logProblems.length
+            ? `Error-like lines in app logs: ${logProblems.map(([id, count]) => `${id} ${String(count)}`).join(', ')} (logs/).`
+            : 'No error-like lines in app logs.',
+    ];
+    write('summary.md', summary.join('\n') + '\n');
+    const quiet = ![failed, left, pageErrors, questions, repeats, logProblems].some(list => list.length);
+    return { dir, quiet };
+}
+/** The previous log of an app is kept before a new run starts, so a session keeps every run's output (rolling, 5 MB). */
+export function keepPreviousLog(log) {
+    try {
+        const old = fs.readFileSync(log, 'utf8');
+        if (!old.trim())
+            return;
+        const history = `${log}.history`;
+        const joined = read(history) + old + '\n';
+        fs.writeFileSync(history, joined.length > 5_000_000 ? joined.slice(-5_000_000) : joined, { mode: 0o600 });
+    }
+    catch {
+        // No log yet: nothing to keep.
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/engine/session.js.map

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

package/dist/engine/share.js

@@ -0,0 +1,124 @@
+// Sharing a board with the team: it joins the stack's team boards through a pull request on the stack's repo on
+// GitHub, made from the shared file as it is there, so nothing else of this Mac's copy goes with it and the clone here
+// is never touched. A stack that is not on GitHub keeps the board in its file here, for the user to commit.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { migrate } from "../core/presets.js";
+import { validateStack } from "../core/stack.js";
+import { fileUrl, proposeFile, readFile, gh } from "../github.js";
+import { readJson } from "../json-files.js";
+import { sourceOf } from "./linked.js";
+import { saveStack } from "./stack-file.js";
+const git = (cwd, ...args) => {
+    try {
+        return execFileSync('git', ['-C', cwd, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return '';
+    }
+};
+/** A GitHub remote as owner and repo: git@github.com:o/r.git, https://github.com/o/r(.git), ssh://git@github.com/o/r. */
+export function githubRepo(remote) {
+    const found = /^(?:git@github\.com:|(?:https|ssh):\/\/(?:[\w.-]+@)?github\.com\/)([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/.exec(remote.trim());
+    return found?.[1] && found[2] ? { owner: found[1], repo: found[2] } : null;
+}
+/** The stack file on GitHub a pull request goes to: a linked stack's source, else the GitHub repo its folder is in. */
+export async function shareTarget(dir) {
+    const linked = sourceOf(dir);
+    if (linked?.file)
+        return { file: linked.file, repo: `${linked.file.owner}/${linked.file.repo}` };
+    const top = git(dir, 'rev-parse', '--show-toplevel');
+    const remote = top ? githubRepo(git(dir, 'remote', 'get-url', 'origin')) : null;
+    if (!top || !remote)
+        return { error: "The stack's folder is not a clone of a repo on GitHub." };
+    const branch = await gh([`repos/${remote.owner}/${remote.repo}`, '--jq', '.default_branch']);
+    if (!branch.ok)
+        return { error: `Could not reach ${remote.owner}/${remote.repo}. Check that gh is signed in.` };
+    // Git names the clone by its real path: a folder reached through a link (/var is /private/var on macOS) is too.
+    const stackPath = path
+        .relative(top, path.join(fs.realpathSync(dir), 'stack.json'))
+        .split(path.sep)
+        .join('/');
+    if (stackPath.startsWith('..'))
+        return { error: "The stack's file is not inside its repo." };
+    return { file: { ...remote, ref: branch.out.trim(), path: stackPath }, repo: `${remote.owner}/${remote.repo}` };
+}
+/** The team's stack with this board among its team boards: replacing one of the same name, else added at the end. */
+export function withBoard(stack, board) {
+    const presets = (Array.isArray(stack['presets']) ? stack['presets'] : []);
+    const at = presets.findIndex(one => one.name === board.name);
+    return { ...stack, presets: at < 0 ? [...presets, board] : presets.map((one, n) => (n === at ? board : one)) };
+}
+/** What of a board the team gets: its apps, cables and places, never this Mac's own notes on it. */
+export function teamBoard(preset) {
+    const checked = migrate(preset);
+    if (checked.error !== undefined)
+        return { error: checked.error };
+    const { name, version, nodes, edges } = checked.preset;
+    const { layout, outside } = preset;
+    return {
+        board: {
+            name,
+            ...(version !== undefined && { version }),
+            nodes,
+            edges,
+            ...(layout ? { layout } : {}),
+            ...(outside ? { outside } : {}),
+        },
+    };
+}
+/** Opens the pull request that adds the board to the stack's team boards on GitHub. */
+export async function shareBoard(dir, preset) {
+    const team = teamBoard(preset);
+    if (team.error !== undefined)
+        return { error: `${preset.name}: ${team.error}` };
+    const { board } = team;
+    const target = await shareTarget(dir);
+    if (target.error !== undefined) {
+        if (!sourceOf(dir) && !git(dir, 'rev-parse', '--show-toplevel').length)
+            return keepHere(dir, board);
+        const remote = githubRepo(git(dir, 'remote', 'get-url', 'origin'));
+        return remote ? target : keepHere(dir, board);
+    }
+    const text = await readFile(target.file);
+    if (text === null)
+        return { error: `Could not read ${fileUrl(target.file)}. Check that gh is signed in.` };
+    let shared;
+    try {
+        shared = JSON.parse(text);
+    }
+    catch {
+        return { error: `${fileUrl(target.file)} is not JSON.` };
+    }
+    const next = withBoard(shared, board);
+    const problems = validateStack(next);
+    if (problems.length)
+        return { error: `The team's stack would not pass its check: ${problems.slice(0, 3).join('; ')}` };
+    const replaces = (shared['presets'] ?? []).some(one => one.name === board.name);
+    const slug = board.name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 40) || 'board';
+    const title = `${replaces ? 'Update' : 'Add'} the "${board.name}" board`;
+    const opened = await proposeFile(target.file, `${JSON.stringify(next, null, 2)}\n`, {
+        branch: `koppler/board-${slug}-${Date.now().toString(36)}`,
+        title,
+        body: `${title} among the team boards of this stack, as shared from the Koppler canvas.\n\nOnce merged, it shows under Team boards for everyone who uses the stack.`,
+    });
+    return opened.error !== undefined ? opened : { url: opened.url, repo: target.repo };
+}
+/** A stack that is not on GitHub: the board joins its file here, for the user to commit. */
+function keepHere(dir, board) {
+    const source = path.join(dir, 'stack.json');
+    const before = readJson(source);
+    if (!before)
+        return { error: `cannot read ${source}` };
+    const next = withBoard(before, board);
+    const problems = validateStack(next);
+    if (problems.length)
+        return { error: `The stack would not pass its check: ${problems.slice(0, 3).join('; ')}` };
+    return saveStack(source, before, next) ?? { local: true };
+}
+//# sourceMappingURL=share.js.map

package/dist/engine/share.js.map

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

package/dist/engine/stack-file.js

@@ -0,0 +1,206 @@
+// Changes to the stack file in use: adding and removing apps and outside systems, and setting any field.
+import path from 'node:path';
+import { readJson, writeJson } from "../json-files.js";
+import { kindsFor } from "../core/kinds.js";
+import { validateStack } from "../core/stack.js";
+import { getAt, parsePath, setAt } from "../core/stack-path.js";
+import { brokenLock, LOCKED } from "./locks.js";
+import { readData, writeData } from "../data.js";
+import { loadConfig, readIndex } from "./config.js";
+import { candidateRepos } from "./repos.js";
+const NO_STACK = 'No stack is set up yet: koppler init';
+/** The stack file in use, with where it is. */
+function stackInUse(config) {
+    if (!config.stack)
+        return { error: NO_STACK };
+    const source = path.join(config.stack, 'stack.json');
+    const stack = readJson(source);
+    return stack ? { source, stack } : { error: `cannot read ${source}` };
+}
+const NOT_SET_UP = 'Run facts not collected yet: read the repo (launchSettings/README/infra) and fill run, url, prereqs before using.';
+/** Adds picked clones to stack.json as apps that are not set up yet. Only clones from the index can be added. */
+export function addApps(picks, { config = loadConfig(), index = readIndex() } = {}) {
+    if (!config.stack || !index)
+        return { error: NO_STACK };
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    const { source, stack } = used;
+    const known = new Map(candidateRepos(index, stack, config.stack).map(candidate => [candidate.slug, candidate]));
+    const added = [];
+    for (const picked of (Array.isArray(picks) ? picks : []).slice(0, 200)) {
+        const pick = (picked ?? {});
+        const candidate = known.get(pick.slug ?? '');
+        if (!candidate || candidate.inStack)
+            continue;
+        const kind = Object.hasOwn(kindsFor(stack), pick.kind ?? '') ? pick.kind : candidate.kind;
+        if (!kind)
+            return { error: `Say what kind of app ${candidate.slug} is.` };
+        const repo = candidate.slug.split('/').pop() ?? '';
+        const base = repo
+            .toLowerCase()
+            .replace(/[^a-z0-9-]+/g, '-')
+            .replace(/^-+|-+$/g, '') || 'app';
+        let id = base;
+        for (let n = 2; stack.apps[id]; n++)
+            id = `${base}-${String(n)}`;
+        const name = typeof pick.name === 'string' && pick.name.trim() ? pick.name.trim() : candidate.name;
+        stack.apps[id] = { name: name.slice(0, 80), kind, slug: candidate.slug, pending: NOT_SET_UP };
+        candidate.inStack = id;
+        added.push(id);
+    }
+    // ponytail: picks are added to `stack` in place above; the copy taken here is what was there before.
+    if (added.length) {
+        const refused = saveStack(source, readJson(source), stack);
+        if (refused)
+            return refused;
+    }
+    return { added };
+}
+/** The stack file in use, as edits write it and locks are kept by; null with no stack. */
+export const stackSource = (config = loadConfig()) => config.stack ? path.join(config.stack, 'stack.json') : null;
+/** Writes the stack file, unless the change alters a field the user locked: then it says which, and writes nothing. */
+export function saveStack(source, before, next) {
+    const locked = brokenLock(source, before, next);
+    if (locked)
+        return { error: LOCKED(locked) };
+    writeJson(source, next);
+    return null;
+}
+/** Copies the stack file in use to the canvas's registry again, keeping what the last sync found: a quick reload after one field changed. */
+export function refreshRegistry() {
+    const source = stackSource();
+    const registry = readData('registry');
+    const stack = source ? readJson(source) : null;
+    if (source && registry && stack)
+        writeData('registry', { ...stack, source, found: registry['found'] });
+}
+/**
+ * Replaces the whole stack with an edited copy, as the settings panels save it: checked against every rule first and
+ * against the locks, and written only when it passes. The problems are given as `where: what`, so each finds its field.
+ */
+export function replaceStack(next, { config = loadConfig() } = {}) {
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    const before = new Set(validateStack(used.stack));
+    const problems = validateStack(next).filter(problem => !before.has(problem));
+    if (problems.length)
+        return { error: problems.slice(0, 5).join('; '), problems };
+    return saveStack(used.source, used.stack, next) ?? { problems: [] };
+}
+/** What the stack in use holds at a path (the whole stack without one). */
+export function readStackAt(pathText = '', { config = loadConfig() } = {}) {
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    if (!pathText)
+        return { value: used.stack };
+    const parsed = parsePath(pathText);
+    if ('error' in parsed)
+        return parsed;
+    return { value: getAt(used.stack, parsed) };
+}
+/**
+ * Changes one field of the stack in use, or takes it out when no value is given. The first of the values that keeps
+ * the stack valid is written (a value typed in a terminal may be meant as text or as JSON); a change that breaks one of
+ * the stack's rules is refused with what it breaks, and nothing is written.
+ */
+export function editStack(pathText, values, { config = loadConfig() } = {}) {
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    const parsed = parsePath(pathText);
+    if ('error' in parsed)
+        return parsed;
+    const before = new Set(validateStack(used.stack));
+    let first = '';
+    for (const value of values ?? [undefined]) {
+        let next;
+        try {
+            next = setAt(used.stack, parsed, value);
+        }
+        catch (error) {
+            return { error: `${pathText}: ${error.message}` };
+        }
+        const broken = validateStack(next).filter(problem => !before.has(problem));
+        if (!broken.length)
+            return saveStack(used.source, used.stack, next) ?? { path: pathText, value };
+        first ||= broken.slice(0, 5).join('; ');
+    }
+    return { error: first };
+}
+/**
+ * Adds a system the apps call that never runs here (a SaaS API, a managed service), with the apps that call it, so it
+ * shows on their boards as an outside card.
+ */
+export function addOutside(given, { config = loadConfig() } = {}) {
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    const { source, stack } = used;
+    const text = (value, max) => (typeof value === 'string' ? value.trim().slice(0, max) : '');
+    const name = text(given.name, 80);
+    if (!name)
+        return { error: 'Give the outside system a name.' };
+    const url = text(given.url, 500);
+    if (url && !/^https?:\/\//.test(url))
+        return { error: `${url} is not a web address (https://...).` };
+    if (url && !URL.canParse(url))
+        return { error: `${url} is not a web address.` };
+    const apps = stack.apps;
+    if (Object.values(apps).some(app => app.name?.toLowerCase() === name.toLowerCase()))
+        return { error: `The stack already has ${name}.` };
+    const ids = (list) => [...new Set(Array.isArray(list) ? list : [])].filter((id) => typeof id === 'string');
+    const callers = ids(given.calledBy);
+    const called = ids(given.sendsTo);
+    const unknown = [...callers, ...called].filter(id => !apps[id] || apps[id].outside);
+    if (unknown.length)
+        return { error: `Not apps of the stack that run here: ${[...new Set(unknown)].join(', ')}.` };
+    if (!callers.length && !called.length)
+        return { error: `Say which apps call ${name}, or which it sends to: its card shows next to them.` };
+    const base = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'outside';
+    let id = base;
+    for (let n = 2; apps[id]; n++)
+        id = `${base}-${String(n)}`;
+    apps[id] = {
+        name,
+        kind: 'other',
+        outside: text(given.why, 200) || 'An outside system: it never runs here.',
+        ...(url && { deployedUrl: url }),
+        ...(called.length && { consumes: Object.fromEntries(called.map(to => [to, {}])) }),
+    };
+    for (const caller of callers) {
+        const app = apps[caller];
+        if (app)
+            app.consumes = { ...app.consumes, [id]: {} };
+    }
+    return saveStack(source, readJson(source), stack) ?? { added: id };
+}
+/**
+ * Takes an app out of the stack. Other apps' calls to it go too, since a call to a missing app makes the stack invalid.
+ * The clone stays where it is; boards that list the app skip it when they open.
+ */
+export function removeApp(id, { config = loadConfig() } = {}) {
+    const used = stackInUse(config);
+    if (used.error !== undefined)
+        return used;
+    const { source, stack } = used;
+    const app = stack.apps?.[id];
+    if (!app)
+        return { error: `${id} is not in the stack` };
+    const name = app.name ?? id;
+    const { [id]: removed, ...apps } = stack.apps;
+    for (const other of Object.values(apps))
+        if (other.consumes)
+            other.consumes = dropKey(other.consumes, id);
+    return saveStack(source, readJson(source), { ...stack, apps }) ?? { removed: id, name };
+}
+function dropKey(from, key) {
+    const { [key]: dropped, ...rest } = from;
+    return rest;
+}
+//# sourceMappingURL=stack-file.js.map

package/dist/engine/stack-file.js.map

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

package/dist/engine/stack-share.js

@@ -0,0 +1,86 @@
+// The stack file shared in the team's repo: its schema, the check CI runs on it, and a pull request with what this
+// Mac's copy learned since its last commit.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import * as z from 'zod';
+import { StackSchema, validateStack } from "../core/stack.js";
+import { fail } from "../failure.js";
+import { proposeFile, readFile } from "../github.js";
+import { changes, proposeChanges, sourceOf } from "./linked.js";
+import { shareTarget } from "./share.js";
+import { currentStack } from "./stacks.js";
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The JSON Schema of stack.json, for editors (`$schema`) and the settings panels. */
+export const stackSchema = () => z.toJSONSchema(StackSchema, { unrepresentable: 'any', io: 'input' });
+/** The stack file's problems, every check `koppler stack set` makes; none when it is fine. */
+export function checkStackFile(file) {
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        return [`${file} cannot be read as JSON: ${error.message}`];
+    }
+    return validateStack(data);
+}
+/**
+ * What changed from `base` to `mine`, made on `theirs`: the changes this copy made, on the file as others left it. A
+ * list is taken whole.
+ */
+export function patch(base, mine, theirs) {
+    if (JSON.stringify(base) === JSON.stringify(mine))
+        return theirs;
+    if (!isObject(base) || !isObject(mine) || !isObject(theirs))
+        return mine;
+    const changed = [...new Set([...Object.keys(base), ...Object.keys(mine)])].filter(key => JSON.stringify(base[key]) !== JSON.stringify(mine[key]));
+    const kept = Object.entries(theirs).filter(([key]) => !changed.includes(key) || key in mine);
+    return Object.fromEntries([
+        ...kept.map(([key, value]) => [key, changed.includes(key) ? patch(base[key], mine[key], value) : value]),
+        ...changed.filter(key => key in mine && !(key in theirs)).map(key => [key, mine[key]]),
+    ]);
+}
+const git = (cwd, ...args) => execFileSync('git', ['-C', cwd, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+/** `koppler stack propose`: a pull request on the stack's repo with what the copy here changed since its last commit. */
+export async function proposeStack() {
+    const dir = currentStack() ?? fail('no stack in use (koppler use)');
+    if (sourceOf(dir)) {
+        const done = await proposeChanges(dir);
+        if (done.error !== undefined)
+            fail(done.error);
+        console.log(`PROPOSED: ${done.url}`);
+        return;
+    }
+    const target = await shareTarget(dir);
+    if (target.error !== undefined)
+        fail(target.error);
+    const file = path.join(dir, 'stack.json');
+    const mine = JSON.parse(fs.readFileSync(file, 'utf8'));
+    let base;
+    try {
+        base = JSON.parse(git(dir, 'show', `HEAD:./stack.json`));
+    }
+    catch {
+        fail(`stack.json is not committed in ${dir} yet: commit it first`);
+    }
+    const list = changes(base, mine);
+    if (!list.length)
+        fail('Nothing to propose: stack.json matches its last commit.');
+    const text = await readFile(target.file);
+    if (text === null)
+        fail(`Could not read the stack on ${target.repo}. Check that gh is signed in.`);
+    const next = patch(base, mine, JSON.parse(text));
+    const problems = validateStack(next);
+    if (problems.length)
+        fail(`The stack would not pass its check: ${problems.slice(0, 3).join('; ')}`);
+    const name = typeof mine.name === 'string' ? mine.name : 'stack';
+    const opened = await proposeFile(target.file, `${JSON.stringify(next, null, 2)}\n`, {
+        branch: `koppler/stack-${Date.now().toString(36)}`,
+        title: `${name}: ${String(list.length)} ${list.length === 1 ? 'change' : 'changes'} from Koppler`,
+        body: `What Koppler learned while running these apps locally:\n\n${list.map(line => `- ${line}`).join('\n')}\n\nNames and addresses only; no secret values.`,
+    });
+    if (opened.error !== undefined)
+        fail(opened.error);
+    console.log(`PROPOSED ${String(list.length)} ${list.length === 1 ? 'change' : 'changes'} on ${target.repo}: ${opened.url}`);
+}
+//# sourceMappingURL=stack-share.js.map

package/dist/engine/stack-share.js.map

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