koppler 0.0.0-stage → 0.0.2

package/dist/engine/investigate.js

@@ -0,0 +1,278 @@
+// Goes through every stack app's clone and reports the ports it listens on locally, its calls, port conflicts and gaps
+// against stack.json. Suggestions go to temp/stack.suggestions.json; the shared stack is never changed.
+// Usage: koppler discover
+import fs from 'node:fs';
+import path from 'node:path';
+import { table } from "../cli/output.js";
+import { fail } from "../failure.js";
+import { frameworkOf } from "../core/frameworks.js";
+import { defaultPort, detect, of as kindOf } from "../core/kinds.js";
+import { describePlan, planTunnels } from "../core/ports.js";
+import { readClones, readStack } from "../data.js";
+import { tempDir } from "../paths.js";
+import { hostsByApp } from "./calls.js";
+import { writeJson } from "../json-files.js";
+const SKIP = new Set([
+    'node_modules',
+    '.git',
+    'bin',
+    'obj',
+    'build',
+    'dist',
+    '.dart_tool',
+    'Pods',
+    'coverage',
+    '.next',
+    'vendor',
+    'target',
+]);
+const read = (file) => {
+    try {
+        return fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+};
+/** Files up to a few levels deep whose name matches, skipping build output and dependencies. */
+export function findFiles(dir, test, depth = 5, found = []) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return found;
+    }
+    for (const entry of entries) {
+        const file = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (depth > 0 && !SKIP.has(entry.name) && !entry.name.startsWith('.'))
+                findFiles(file, test, depth - 1, found);
+        }
+        else if (test(entry.name, file))
+            found.push(file);
+    }
+    return found;
+}
+const LISTENS = String.raw `(?:localhost|127\.0\.0\.1|0\.0\.0\.0|\*|\+):(\d{2,5})`;
+export const urlsIn = (text) => [...text.matchAll(new RegExp(`(https?)://${LISTENS}`, 'g'))].map(match => ({
+    scheme: match[1] ?? '',
+    port: Number(match[2]),
+}));
+export const portsIn = (text) => [
+    ...new Set([...text.matchAll(new RegExp(LISTENS, 'g'))].map(match => Number(match[1]))),
+];
+/** .NET: every launch profile's applicationUrl. */
+export function dotnetPorts(launchSettingsText) {
+    let profiles;
+    try {
+        const settings = JSON.parse(launchSettingsText.replace(/^\uFEFF/, ''));
+        profiles = settings.profiles ?? {};
+    }
+    catch {
+        return portsIn(launchSettingsText).map(port => ({ port, where: 'launchSettings.json' }));
+    }
+    return Object.entries(profiles).flatMap(([name, profile]) => urlsIn(profile?.applicationUrl ?? '').map(url => ({ ...url, where: `profile ${name}` })));
+}
+/** Node: PORT in .env files, a dev server port in vite/serverless config, --port in package.json scripts. */
+export function nodePorts(files) {
+    const out = [];
+    const add = (text, pattern, where) => {
+        for (const match of text.matchAll(pattern))
+            out.push({ port: Number(match[1]), where });
+    };
+    for (const [name, text] of Object.entries(files)) {
+        if (!text)
+            continue;
+        if (name.startsWith('.env'))
+            add(text, /^\s*PORT\s*=\s*(\d{2,5})/gm, `${name} PORT`);
+        if (/^vite\.config|^serverless\./.test(name))
+            add(text, /\b(?:port|httpPort)\s*[:=]\s*(\d{2,5})/g, name);
+        if (name !== 'package.json')
+            continue;
+        let scripts = {};
+        try {
+            scripts = JSON.parse(text).scripts ?? {};
+        }
+        catch {
+            // Not JSON: no scripts to read.
+        }
+        for (const [script, command] of Object.entries(scripts))
+            add(String(command), /(?:--port|-p|--httpPort)[ =](\d{2,5})/g, `npm run ${script}`);
+    }
+    return out;
+}
+/** A clone as the kind recipes see it (core/kinds): which files it has, their text, what a folder holds. */
+export const repoFiles = (repo) => ({
+    has: file => fs.existsSync(path.join(repo, file)),
+    read: file => {
+        try {
+            const full = path.join(repo, file);
+            return fs.statSync(full).size < 512 * 1024 ? fs.readFileSync(full, 'utf8') : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    list: dir => {
+        try {
+            const entries = fs.readdirSync(path.join(repo, dir), { withFileTypes: true });
+            return entries.filter(entry => entry.isDirectory()).map(entry => entry.name);
+        }
+        catch {
+            return [];
+        }
+    },
+    find: suffix => findFiles(repo, name => name.endsWith(suffix), 4).length > 0,
+});
+export const detectKind = (repo, stack) => detect(repoFiles(repo), stack);
+const inProperties = (name, file) => name === 'launchSettings.json' && file.includes(`${path.sep}Properties${path.sep}`);
+const NODE_FILE = /^package\.json$|^\.env|^vite\.config\.|^serverless\./;
+const ENTRY_FILES = ['server', 'index', 'app', 'main'].flatMap(name => ['js', 'mjs', 'cjs', 'ts'].flatMap(ext => [`${name}.${ext}`, `src/${name}.${ext}`]));
+/**
+ * The port a Node app's entry file falls back to, `process.env.PORT || 3000` or `.listen(3000)`: the file its start
+ * script runs, else its `main`, else the usual names.
+ */
+function entryPorts(repo, pkg) {
+    const run = Object.values(pkg?.scripts ?? {}).flatMap(command => [...command.matchAll(/\b(?:node|nodemon|tsx|ts-node)\s+(?:-\S+\s+)*([\w./-]+\.[cm]?[jt]s)\b/g)].map(found => found[1] ?? ''));
+    const main = typeof pkg?.main === 'string' ? [pkg.main] : [];
+    for (const name of new Set([...run, ...main, ...ENTRY_FILES])) {
+        if (!name || name.startsWith('/') || name.split('/').includes('..'))
+            continue;
+        const text = read(path.join(repo, name)) ?? '';
+        const port = /process\.env\.PORT\)?\s*(?:\|\||\?\?)\s*['"]?(\d{2,5})/.exec(text)?.[1] ??
+            /\.listen\(\s*(\d{2,5})\b/.exec(text)?.[1];
+        if (port)
+            return [{ port: Number(port), where: name }];
+    }
+    return [];
+}
+export function localPorts(repo, kind, stack) {
+    if (kind === 'dotnet')
+        return findFiles(repo, inProperties).flatMap(file => dotnetPorts(read(file) ?? '').map(found => ({ ...found, where: `${path.relative(repo, file)} ${found.where}` })));
+    if (kind === 'node' || kind === 'web') {
+        const names = fs.readdirSync(repo).filter(name => NODE_FILE.test(name));
+        const found = nodePorts(Object.fromEntries(names.map(name => [name, read(path.join(repo, name))])));
+        // A front end with no port set uses its framework's default.
+        let pkg = null;
+        try {
+            pkg = JSON.parse(read(path.join(repo, 'package.json')) ?? 'null');
+        }
+        catch {
+            // Not JSON: no framework to tell.
+        }
+        if (found.length)
+            return found;
+        const framework = kind === 'web' ? frameworkOf(pkg) : null;
+        if (framework)
+            return [{ port: framework.port, scheme: 'http', where: `${framework.name} default` }];
+        return entryPorts(repo, pkg);
+    }
+    const usual = kind ? defaultPort(kind, repoFiles(repo), stack) : null;
+    return usual
+        ? [{ port: usual, scheme: 'http', where: `${kindOf({ kind: kind ?? undefined }, stack).label} default` }]
+        : [];
+}
+const portOf = (url) => {
+    try {
+        return Number(new URL(url ?? '').port) || null;
+    }
+    catch {
+        return null;
+    }
+};
+/** Ports that two different things want at once. A tunnel to one host is one thing, even when several apps need it. */
+export function conflicts(apps) {
+    const owners = new Map();
+    const claim = (port, owner, label) => {
+        const claims = owners.get(port) ?? new Map();
+        claims.set(owner, [...(claims.get(owner) ?? []), label]);
+        owners.set(port, claims);
+    };
+    for (const app of apps) {
+        const own = app.stackPort ?? app.ports[0]?.port;
+        if (own)
+            claim(own, `app:${app.id}`, app.id);
+        for (const { tunnel, port } of app.tunnels)
+            if (port)
+                claim(port, `tunnel:${String(tunnel)}`, `tunnel to ${String(tunnel)} (for ${app.id})`);
+    }
+    // Two tunnels on one port are planned by core/ports (share, move or loopback); only clashes involving an app are
+    // reported here.
+    return [...owners]
+        .filter(([, claims]) => claims.size > 1 && [...claims.keys()].some(owner => owner.startsWith('app:')))
+        .map(([port, claims]) => ({ port, who: [...claims.values()].map(labels => labels.join(', ')) }));
+}
+export function investigate({ afterSync = false } = {}) {
+    const stack = readStack() ?? fail('no stack loaded (koppler init)');
+    const clones = readClones();
+    const found = stack.found ?? {};
+    const known = hostsByApp(stack);
+    const apps = Object.entries(stack.apps).map(([id, app]) => {
+        const repo = clones[id]?.path;
+        const kind = app.kind ?? (repo ? (detectKind(repo, stack) ?? undefined) : undefined);
+        return {
+            id,
+            name: app.name,
+            kind,
+            repo,
+            ports: repo ? localPorts(repo, kind, stack) : [],
+            tunnels: (app.prereqs ?? []).filter(need => need.tunnel && need.port),
+            stackPort: portOf(app.url),
+            stackUrl: app.url ?? null,
+            deployed: app.deployedUrl ?? null,
+            calls: Object.keys(app.consumes ?? {}),
+            found: Object.keys(found[id] ?? {}),
+        };
+    });
+    const portsOf = (app) => [...new Set(app.ports.map(found => found.port))];
+    const rows = apps.map(app => {
+        const listens = app.kind === 'flutter'
+            ? '(app, calls out only)'
+            : portsOf(app).join(', ') || (app.repo ? 'none found' : 'not cloned');
+        const counted = [
+            app.calls.length && `${String(app.calls.length)} recorded`,
+            app.found.length && `${String(app.found.length)} found`,
+        ];
+        const tunnels = app.tunnels.map(tunnel => tunnel.port).join(', ') || '-';
+        return [app.id, app.kind ?? '?', listens, app.stackPort ?? '-', tunnels, counted.filter(Boolean).join(', ') || '-'];
+    });
+    table([['APP', 'KIND', 'LISTENS ON', 'STACK PORT', 'TUNNELS', 'CALLS'], ...rows]);
+    const suggestions = {};
+    console.log('');
+    for (const clash of conflicts(apps))
+        console.log(`CONFLICT port ${String(clash.port)}: ${clash.who.join(', ')}`);
+    // Tunnels that clash when the apps needing them run together, and how koppler plan resolves it.
+    const needs = apps.flatMap(app => app.tunnels.flatMap(({ tunnel, port, env, connectsAs }) => tunnel && port ? [{ app: app.id, tunnel, port, env, connectsAs }] : []));
+    const clashing = new Set(needs
+        .filter(need => needs.some(other => other.port === need.port && other.tunnel !== need.tunnel))
+        .map(need => need.port));
+    for (const port of clashing) {
+        const plan = planTunnels(needs.filter(need => need.port === port));
+        const who = plan.map(tunnel => `${tunnel.host.split('.')[0] ?? ''} (${tunnel.apps.join(', ')})`);
+        console.log(`TUNNELS port ${String(port)}: ${who.join(' and ')} clash when run together`);
+        for (const line of describePlan(plan))
+            console.log(`  RESOLVE ${line}`);
+    }
+    for (const app of apps) {
+        if (!app.repo || app.kind === 'flutter')
+            continue;
+        const ports = portsOf(app);
+        const [first] = app.ports;
+        if (!app.stackUrl && first) {
+            const url = `${first.scheme ?? 'http'}://localhost:${String(first.port)}/`;
+            (suggestions[app.id] ??= {})['url'] = url;
+            console.log(`SUGGEST ${app.id}.url = ${JSON.stringify(url)}  (from ${first.where})`);
+        }
+        else if (app.stackPort && ports.length && !ports.includes(app.stackPort))
+            console.log(`MISMATCH ${app.id}: stack.json says port ${String(app.stackPort)}, the repo uses ${ports.join(', ')}`);
+        if (!afterSync && !known[app.id]?.size && kindOf(app, stack).serves)
+            console.log(`UNKNOWN ${app.id}: no deployed address in stack.json, so calls to it cannot be found`);
+        for (const callee of app.found)
+            console.log(`FOUND ${app.id} -> ${callee}: not in stack.json (koppler sync shows where)`);
+    }
+    const file = path.join(tempDir(), 'stack.suggestions.json');
+    writeJson(file, { at: new Date().toISOString(), apps, suggestions });
+    console.log(`\nFull results and suggestions: ${file}`);
+}
+//# sourceMappingURL=investigate.js.map

package/dist/engine/investigate.js.map

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

package/dist/engine/libraries.js

@@ -0,0 +1,129 @@
+// Local libraries: an app uses your clone of a library it depends on instead of the published one, without a change to
+// any tracked file, and back again on Stop.
+//   Dart / Flutter: a pubspec_overrides.yaml in the app with a path override (Dart reads it on top of pubspec.yaml).
+//   npm: `npm install --no-save <path>` (package.json and the lockfile stay as they are; Stop reinstalls from them).
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { readJson } from "../json-files.js";
+import { readActions, updateActions } from "./actions.js";
+const read = (file) => {
+    try {
+        return fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+};
+const packageJson = (dir) => readJson(path.join(dir, 'package.json'));
+/** The package a clone publishes: its Dart package name or its npm name. */
+export function packageOf(dir) {
+    const dart = /^name:\s*([\w]+)\s*$/m.exec(read(path.join(dir, 'pubspec.yaml')) ?? '')?.[1];
+    if (dart)
+        return { name: dart, ecosystem: 'dart' };
+    const npm = packageJson(dir)?.name;
+    return npm ? { name: npm, ecosystem: 'npm' } : null;
+}
+/** The packages an app depends on, by name. */
+export function dependenciesOf(dir) {
+    const pubspec = read(path.join(dir, 'pubspec.yaml'));
+    if (pubspec) {
+        const names = new Set();
+        for (const section of ['dependencies', 'dev_dependencies', 'dependency_overrides']) {
+            const block = new RegExp(`^${section}:\\s*\\n((?:[ \\t]+.*\\n?|\\s*\\n)*)`, 'm').exec(pubspec)?.[1] ?? '';
+            for (const entry of block.matchAll(/^ {2}([\w]+):/gm))
+                if (entry[1])
+                    names.add(entry[1]);
+        }
+        return { ecosystem: 'dart', names: [...names] };
+    }
+    const pkg = packageJson(dir);
+    return pkg ? { ecosystem: 'npm', names: Object.keys({ ...pkg.dependencies, ...pkg.devDependencies }) } : null;
+}
+/** The libraries an app can use locally: clones that publish a package it depends on (other than itself). */
+export function librariesFor(appDir, clones) {
+    const deps = dependenciesOf(appDir);
+    if (!deps)
+        return [];
+    return clones
+        .filter(clone => clone.path !== appDir && clone.ecosystem === deps.ecosystem && deps.names.includes(clone.name))
+        .map(({ name, path: clonePath, ecosystem }) => ({ name, path: clonePath, ecosystem }));
+}
+const OVERRIDES = 'pubspec_overrides.yaml';
+const MARK = '# Written by Koppler for a local run; Stop removes it.';
+const SECTION = /^dependency_overrides:\s*$/m;
+/** The overrides file with the local libraries in it, keeping what the user had there. */
+function withOverrides(before, libraries) {
+    const lines = libraries.map(library => `  ${library.name}:\n    path: ${library.path}`).join('\n');
+    // A file Koppler wrote on an earlier run is replaced; the user's own is added to.
+    const own = before && !before.includes(MARK) ? before : null;
+    if (!own)
+        return `${MARK}\ndependency_overrides:\n${lines}\n`;
+    return SECTION.test(own)
+        ? own.replace(SECTION, () => `dependency_overrides:\n${lines}`)
+        : `${own.trimEnd()}\n\ndependency_overrides:\n${lines}\n`;
+}
+/** Points the app at the local libraries; returns the action-log entries that undo it. */
+export function link(appId, appDir, libraries, logFile) {
+    const log = readActions(logFile);
+    const done = [];
+    // Each change is logged before it is made, so a crash part-way still leaves Stop an entry to undo.
+    const record = (entry) => {
+        updateActions(logFile, list => void list.push(entry));
+        done.push(entry);
+    };
+    const dart = libraries.filter(library => library.ecosystem === 'dart');
+    const npm = libraries.filter(library => library.ecosystem === 'npm');
+    if (dart.length > 0) {
+        const file = path.join(appDir, OVERRIDES);
+        const before = read(file);
+        const text = withOverrides(before, dart);
+        const logged = (action) => action.kind === 'file' && action.file === file;
+        // Stop puts back the file as it was before the first change of this run, if it still holds what Koppler wrote
+        // last.
+        if (!log.some(logged))
+            record({ kind: 'file', app: appId, file, before, after: text });
+        else
+            updateActions(logFile, list => {
+                const entry = list.find(logged);
+                if (entry)
+                    entry.after = text;
+            });
+        fs.writeFileSync(file, text);
+    }
+    if (npm.length > 0) {
+        const names = npm.map(library => library.name);
+        record({ kind: 'npm-local', app: appId, repo: appDir, packages: names });
+        const installed = spawnSync('npm', ['install', '--no-save', ...npm.map(library => library.path)], {
+            cwd: appDir,
+            encoding: 'utf8',
+        });
+        if (installed.status !== 0) {
+            const why = installed.stderr.trim().split('\n').pop() ?? '';
+            throw new Error(`npm could not install the local ${names.join(', ')}: ${why}`);
+        }
+    }
+    return done;
+}
+/** Undoes one entry from link(); returns what happened, in words. Throws when it would overwrite the user's edits. */
+export function unlink(entry) {
+    if (entry.kind === 'npm-local') {
+        const installed = spawnSync('npm', ['install'], { cwd: entry.repo, encoding: 'utf8' });
+        if (installed.status !== 0)
+            throw new Error(`npm install failed in ${entry.repo}`);
+        return `published ${entry.packages.join(', ')} back`;
+    }
+    const name = path.basename(entry.file);
+    const before = entry.before ?? null;
+    const now = read(entry.file);
+    if (now === before)
+        return `${name} already as before`;
+    if (entry.after !== undefined && now !== entry.after)
+        throw new Error(`${name} changed since Koppler wrote it; take Koppler's lines out by hand`);
+    if (before === null)
+        fs.rmSync(entry.file, { force: true });
+    else
+        fs.writeFileSync(entry.file, before);
+    return `${name} ${before === null ? 'removed' : 'restored'}`;
+}
+//# sourceMappingURL=libraries.js.map

package/dist/engine/libraries.js.map

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

package/dist/engine/linked.js

@@ -0,0 +1,146 @@
+// Stacks used straight from GitHub. Koppler keeps a copy in the private config; what it learns goes into that copy,
+// shows as changes not in the shared stack yet, and reaches the team only through a pull request the user opens.
+// Next to the copy, .source.json holds the link and `base`: the shared file as it was when last fetched.
+import path from 'node:path';
+import { validateStack } from "../core/stack.js";
+import { fileUrl, githubFile, proposeFile, readFile } from "../github.js";
+import { setStack } from "./stacks.js";
+import { configDir } from "../paths.js";
+import { readJson, writeJson } from "../json-files.js";
+const SOURCE = '.source.json';
+const NOT_LINKED = { error: 'That stack is not linked to GitHub.' };
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+const stamp = () => new Date().toISOString();
+export const sourceOf = (dir) => readJson(path.join(dir, SOURCE));
+const copyIn = (dir) => readJson(path.join(dir, 'stack.json'));
+async function fetchStack(file, read = readFile) {
+    const text = await read(file);
+    if (text === null)
+        return { error: 'Could not read that file. Check the link, and that gh is signed in for a private repo.' };
+    let stack;
+    try {
+        stack = JSON.parse(text);
+    }
+    catch {
+        return { error: 'That file is not JSON.' };
+    }
+    const errors = validateStack(stack);
+    return errors.length ? { error: `That is not a stack Koppler can use: ${errors.slice(0, 3).join('; ')}` } : { stack };
+}
+/** Links a stack on GitHub and makes it the one in use. */
+export async function linkStack(link, { config, save, read } = {}) {
+    const file = githubFile(link);
+    if (!file)
+        return {
+            error: 'Paste a link to a stack.json on GitHub, e.g. https://github.com/<owner>/<repo>/blob/main/stacks/<name>/stack.json',
+        };
+    const got = await fetchStack(file, read);
+    if (got.error !== undefined)
+        return got;
+    const folder = path.basename(path.dirname(file.path)) || 'stack';
+    const slug = `${file.owner}-${file.repo}-${folder}`.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    const dir = path.join(configDir(), 'stacks', slug);
+    const old = sourceOf(dir);
+    if (old && old.url !== fileUrl(file))
+        return { error: `A different linked stack already uses the name ${slug}.` };
+    if (!old) {
+        writeJson(path.join(dir, 'stack.json'), got.stack);
+        writeJson(path.join(dir, SOURCE), { url: fileUrl(file), file, base: got.stack, fetchedAt: stamp() });
+    }
+    const configFile = path.join(configDir(), 'config.json');
+    setStack(config ?? readJson(configFile) ?? {}, dir, save ??
+        (next => {
+            writeJson(configFile, next);
+        }));
+    return { stack: dir, name: got.stack.name };
+}
+/** What differs between the shared stack as last fetched and the copy here, in plain lines. */
+export function changes(base, local) {
+    const out = [];
+    const name = (stack, id) => stack.apps?.[id]?.['name'] ?? id;
+    const before = base.apps ?? {};
+    const after = local.apps ?? {};
+    for (const id of Object.keys(after))
+        if (!before[id])
+            out.push(`added ${name(local, id)}`);
+    for (const id of Object.keys(before))
+        if (!after[id])
+            out.push(`removed ${name(base, id)}`);
+    for (const [id, now] of Object.entries(after)) {
+        const was = before[id];
+        if (!was || !now || same(was, now))
+            continue;
+        const keys = [...new Set([...Object.keys(was), ...Object.keys(now)])].filter(key => !same(was[key], now[key]));
+        out.push(`changed ${name(local, id)}: ${keys.join(', ')}`);
+    }
+    for (const key of new Set([...Object.keys(base), ...Object.keys(local)]))
+        if (key !== 'apps' && !same(base[key], local[key]))
+            out.push(`changed ${key}`);
+    return out;
+}
+export function linkedStatus(dir) {
+    const source = sourceOf(dir);
+    const local = copyIn(dir);
+    if (!source || !local)
+        return null;
+    return {
+        url: source.url,
+        fetchedAt: source.fetchedAt,
+        changes: changes(source.base, local),
+        ...(source.pr && { pr: source.pr }),
+    };
+}
+/** Brings in what changed on GitHub. A copy with changes of its own is only updated when nothing would be lost. */
+export async function updateStack(dir, { read } = {}) {
+    const source = sourceOf(dir);
+    const local = copyIn(dir);
+    if (!source)
+        return NOT_LINKED;
+    const got = await fetchStack(source.file, read);
+    if (got.error !== undefined)
+        return got;
+    const remote = got.stack;
+    const keep = (next) => {
+        writeJson(path.join(dir, SOURCE), { ...source, ...next, fetchedAt: stamp() });
+    };
+    if (same(remote, source.base)) {
+        keep({});
+        return { updated: false, message: 'Already up to date.' };
+    }
+    const merged = same(local, remote);
+    if (same(local, source.base) || merged) {
+        writeJson(path.join(dir, 'stack.json'), remote);
+        keep({ base: remote, pr: merged ? undefined : source.pr });
+        return { updated: true, message: merged ? 'Your changes are in the shared stack now.' : 'Updated from GitHub.' };
+    }
+    return {
+        error: 'The shared stack changed on GitHub, and this copy has changes of its own. Open a pull request with yours first, or discard them, then check again.',
+    };
+}
+export function discardChanges(dir) {
+    const source = sourceOf(dir);
+    if (!source)
+        return NOT_LINKED;
+    writeJson(path.join(dir, 'stack.json'), source.base);
+    return { discarded: true };
+}
+/** A pull request with this copy's changes. Outward-facing: only from the user's own confirmation on the canvas or in the terminal. */
+export async function proposeChanges(dir, { propose = proposeFile } = {}) {
+    const source = sourceOf(dir);
+    const local = copyIn(dir);
+    if (!source || !local)
+        return NOT_LINKED;
+    const list = changes(source.base, local);
+    if (!list.length)
+        return { error: 'There is nothing to share: this copy matches the shared stack.' };
+    const slug = (local.name ?? 'stack').toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    const result = await propose(source.file, JSON.stringify(local, null, 2) + '\n', {
+        branch: `koppler/${slug}-${Date.now().toString(36)}`,
+        title: `${String(local.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 (result.error === undefined)
+        writeJson(path.join(dir, SOURCE), { ...source, pr: result.url });
+    return result;
+}
+//# sourceMappingURL=linked.js.map

package/dist/engine/linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked.js","sourceRoot":"","sources":["../../src/engine/linked.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,iHAAiH;AACjH,yGAAyG;AACzG,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAmB,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqBvD,MAAM,MAAM,GAAG,cAAc,CAAC;AAC9B,MAAM,UAAU,GAAW,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;AAC5E,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACjF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAkB,CAAC;AAC3F,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAqB,CAAC;AAE3F,KAAK,UAAU,UAAU,CACvB,IAAgB,EAChB,OAAa,QAAQ;IAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QACf,OAAO,EAAE,KAAK,EAAE,wFAAwF,EAAE,CAAC;IAC7G,IAAI,KAAgB,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,wCAAwC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AACxH,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAwE,EAAE;IAE9F,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI;QACP,OAAO;YACL,KAAK,EACH,mHAAmH;SACtH,CAAC;IACJ,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC;IACjE,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,kDAAkD,IAAI,GAAG,EAAE,CAAC;IAClH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC;IACzD,QAAQ,CACN,MAAM,IAAK,QAAQ,CAAC,UAAU,CAAmB,IAAI,EAAE,EACvD,GAAG,EACH,IAAI;QACF,CAAC,IAAI,CAAC,EAAE;YACN,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC,CACL,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,OAAO,CAAC,IAAe,EAAE,KAAgB;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAE,EAAU,EAAE,EAAE,CAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAwB,IAAI,EAAE,CAAC;IACxG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3F,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5F,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC;YAAE,SAAS;QAC7C,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/G,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IACjF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;QACpC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,EAAE,IAAI,KAAsB,EAAE;IAE9B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,IAAqB,EAAE,EAAE;QACrC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;IACnH,CAAC;IACD,OAAO;QACL,KAAK,EACH,oJAAoJ;KACvJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC;IAC/B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,uIAAuI;AACvI,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE;IAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;QAAE,OAAO,UAAU,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,gEAAgE,EAAE,CAAC;IACrG,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;QAC/E,MAAM,EAAE,WAAW,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;QACpD,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,eAAe;QAC/G,IAAI,EAAE,6DAA6D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iDAAiD;KAC7J,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC;AAChB,CAAC"}