koppler 0.0.0-stage → 0.0.2

package/dist/engine/queues.js

@@ -0,0 +1,100 @@
+// Queues switched to local on the board.
+//   SQS: one AWS emulator in Docker (the image the Lambda kind uses) holds them all; every app on one starts with the AWS
+//   SDK's SQS endpoint pointed at it and its queue settings set to the local queue.
+//   Kafka: one local broker in Docker (apache/kafka); the topic is created on it and every app on one starts with its
+//   broker settings pointed at it.
+import { execFileSync } from 'node:child_process';
+import { of as kindOf } from "../core/kinds.js";
+import { LOCAL_QUEUE_TYPES } from "../core/plan.js";
+export const PORT = 4566;
+export const ENDPOINT = `http://127.0.0.1:${String(PORT)}`;
+// Stopping the Docker client does not stop its container: it is removed on stop, and a leftover one before starting.
+const RM = 'docker rm -f koppler-queues >/dev/null 2>&1';
+// Run by Stop as well: the shell's own cleanup never happens when it has to be killed.
+export const STOP_EMULATOR = ['docker', 'rm', '-f', 'koppler-queues'];
+export const STOP_BROKER = ['docker', 'rm', '-f', 'koppler-kafka'];
+export const EMULATOR = [
+    'sh',
+    '-c',
+    `${RM}; trap '${RM}; exit 0' TERM INT HUP; docker run --rm --name koppler-queues -p 127.0.0.1:${String(PORT)}:4566 floci/floci:latest & wait`,
+];
+export const KAFKA_PORT = 9092;
+export const KAFKA = `localhost:${String(KAFKA_PORT)}`;
+const RM_KAFKA = 'docker rm -f koppler-kafka >/dev/null 2>&1';
+export const BROKER = [
+    'sh',
+    '-c',
+    `${RM_KAFKA}; trap '${RM_KAFKA}; exit 0' TERM INT HUP; docker run --rm --name koppler-kafka -p 127.0.0.1:${String(KAFKA_PORT)}:9092 apache/kafka:latest & wait`,
+];
+/** How an app uses a queue, as its `publishes` or `reads` records it. */
+const useOf = (stack, app, queue) => ['publishes', 'reads']
+    .map(key => stack.apps[app]?.[key]?.[queue])
+    .find(Boolean);
+/** The local queues of a board and the apps on each; what cannot be local is in `left`. */
+export function localQueues(stack, queues, ids, env) {
+    const out = [];
+    const left = [];
+    for (const [id, where] of Object.entries(queues ?? {})) {
+        const queue = stack.queues?.[id];
+        if (where !== 'local' || !queue)
+            continue;
+        if (!LOCAL_QUEUE_TYPES.includes(queue.type)) {
+            left.push(`${queue.name}: Koppler cannot run a ${queue.type} queue locally yet; it stays the deployed one`);
+            continue;
+        }
+        const apps = ids.flatMap(app => {
+            const use = useOf(stack, app, id);
+            return use ? [{ id: app, env: [use.env ?? []].flat() }] : [];
+        });
+        out.push({ id, name: queue.name, type: queue.type, queue: queue.envs?.[env]?.queue ?? queue.queue ?? id, apps });
+    }
+    return { queues: out, left };
+}
+/** Settings per app for the created queues (`urls` by queue id); apps that take none at start are left for the agent. */
+export function queueEnv(stack, list, urls) {
+    const set = {};
+    const left = [];
+    for (const queue of list)
+        for (const { id, env } of queue.apps) {
+            const app = stack.apps[id];
+            const url = urls[queue.id];
+            if (!app || url === undefined)
+                continue;
+            if (kindOf(app).platforms || app.kind === 'lambda') {
+                left.push(`${app.name}: point it at the local ${queue.name} queue (${url}); Koppler cannot pass it at start`);
+                continue;
+            }
+            // A Kafka app's settings name its brokers; an SQS app's name the queue, with the SDK's endpoint beside them.
+            const kafka = queue.type === 'kafka';
+            Object.assign((set[id] ??= {}), kafka ? {} : { AWS_ENDPOINT_URL_SQS: ENDPOINT }, Object.fromEntries(env.map(name => [name, kafka ? KAFKA : url])));
+        }
+    return { set, left };
+}
+/** Creates the topic on the local broker; returns its name. */
+export function createTopic(name) {
+    const create = ['--bootstrap-server', 'localhost:9092', '--create', '--if-not-exists', '--topic', name];
+    execFileSync('docker', ['exec', 'koppler-kafka', '/opt/kafka/bin/kafka-topics.sh', ...create], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return name;
+}
+/** Creates the queue in the running emulator and returns its local URL. */
+export function createQueue(name) {
+    const attrs = name.endsWith('.fifo') ? ['--attributes', 'FifoQueue=true,ContentBasedDeduplication=true'] : [];
+    const create = ['sqs', 'create-queue', '--queue-name', name, ...attrs, '--query', 'QueueUrl'];
+    return execFileSync('aws', ['--endpoint-url', ENDPOINT, '--region', 'eu-west-1', '--output', 'text', ...create], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        // The emulator takes any key; the user's own profile and session must not reach it.
+        env: {
+            ...process.env,
+            AWS_PROFILE: undefined,
+            AWS_SESSION_TOKEN: undefined,
+            AWS_ACCESS_KEY_ID: 'test',
+            AWS_SECRET_ACCESS_KEY: 'test',
+            AWS_PAGER: '',
+        },
+    }).trim();
+}
+//# sourceMappingURL=queues.js.map

package/dist/engine/queues.js.map

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

package/dist/engine/recipes.js

@@ -0,0 +1,248 @@
+// Remembered code changes ("recipes"): the temporary edit an app needs for a run, kept so it is applied the same way
+// next time instead of worked out again. Shared in stack.json (apps.<id>.localChanges) unless it names something only this
+// Mac has (a home path, a loopback alias, the user name); then it stays in the private config. How each one did here
+// (worked or not, last run) is always private.
+// Usage: koppler recipes [app]
+//        koppler recipes --remember <app> --why "<reason>" [--when always|calls:<app>|env:<env>] [--private] [--any-os]   from the app's last logged edit
+//        koppler recipes --apply <app...> [--env <env>]       apply what matches the latest Send (its environment and cables), logged for Stop
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { flagValue } from "../cli/output.js";
+import { fail } from "../failure.js";
+import { readClones, readStack } from "../data.js";
+import { configDir, tempDir } from "../paths.js";
+import { readActions, updateActions } from "./actions.js";
+import { APPROVE, approved } from "./checks.js";
+import { runs } from "./history.js";
+import { saveStack } from "./stack-file.js";
+import { readJson, writeJson } from "../json-files.js";
+const privateFile = () => path.join(configDir(), 'recipes.json');
+const writePrivate = (mine) => {
+    writeJson(privateFile(), mine);
+};
+export const recipeId = (recipe) => crypto
+    .createHash('sha256')
+    .update(JSON.stringify([recipe.app, recipe.file, recipe.find]))
+    .digest('hex')
+    .slice(0, 12);
+/** Something only this Mac has: a home folder, a drive path, a loopback alias other than 127.0.0.1, or the user name. */
+export const onlyHere = (text, user = os.userInfo().username, home = os.homedir()) => [home, `/Users/${user}`, `/home/${user}`].some(place => text.includes(place)) ||
+    /(^|[\s"'=(])~\//.test(text) ||
+    /\b[A-Z]:\\\\/.test(text) ||
+    /\b127\.0\.0\.(?!1\b)\d+\b/.test(text);
+const whenOf = (given) => {
+    if (given?.startsWith('calls:'))
+        return { calls: given.slice(6) };
+    if (given?.startsWith('env:'))
+        return { env: given.slice(4) };
+    return { always: true };
+};
+/** A recipe is for the operating system it was made on (darwin, linux, win32) unless it was widened to any. */
+export const matches = (recipe, { env, calls = [], platform = process.platform }) => {
+    const { when } = recipe;
+    const here = !recipe.os || recipe.os === 'any' || recipe.os === platform;
+    return here && !!(when?.always || (when?.env && when.env === env) || (when?.calls && calls.includes(when.calls)));
+};
+/** Every recipe for an app: the stack's, then this Mac's, each with how it did here. */
+export function recipesFor(stack, app) {
+    const mine = readJson(privateFile(), {});
+    const shared = (stack?.apps?.[app]?.localChanges ?? []);
+    const own = mine.stacks?.[stack?.source ?? '']?.[app] ?? [];
+    const scoped = [
+        ...shared.map(recipe => ({ ...recipe, app, scope: 'shared' })),
+        ...own.map(recipe => ({ ...recipe, app, scope: 'private' })),
+    ];
+    return scoped.map(recipe => {
+        const id = recipeId(recipe);
+        return { ...recipe, id, here: mine.runs?.[id] ?? null };
+    });
+}
+export function remember({ registry: stack, app, edit, why, whenText, forcePrivate, anyOs, }) {
+    if (!edit)
+        return { error: `no logged edit for ${app} to remember (the agent logs each edit in temp/actions.json first)` };
+    const inRepo = path.isAbsolute(edit.file) && edit.repo ? path.relative(edit.repo, edit.file) : edit.file;
+    const unix = (text) => text.replace(/\r\n/g, '\n');
+    const recipe = {
+        why: (why ?? '').slice(0, 200) || 'needed to run locally',
+        when: whenOf(whenText),
+        os: anyOs ? 'any' : process.platform,
+        file: inRepo.split(path.sep).join('/'),
+        find: unix(edit.before),
+        replace: unix(edit.after),
+    };
+    const id = recipeId({ ...recipe, app });
+    const add = (list) => {
+        if (!list.some(known => recipeId({ ...known, app }) === id))
+            list.push(recipe);
+    };
+    const source = stack?.source;
+    if (forcePrivate || onlyHere(JSON.stringify(recipe)) || !source) {
+        const mine = readJson(privateFile(), {});
+        add((((mine.stacks ??= {})[source ?? 'none'] ??= {})[app] ??= []));
+        writePrivate(mine);
+        return { id, scope: 'private' };
+    }
+    const file = readJson(source, null);
+    const shared = file?.apps?.[app];
+    if (!shared)
+        return { error: `${app} is not in ${source}` };
+    const before = readJson(source, null);
+    add((shared.localChanges ??= []));
+    const refused = saveStack(source, before, file);
+    if (refused)
+        return refused;
+    return { id, scope: 'shared' };
+}
+/**
+ * A remembered change only ever edits a file inside the app's clone, whatever the shared stack says: no absolute path,
+ * no .., and no symlink that leads out. Returns the full path, or null.
+ */
+export function insideClone(repo, rel) {
+    if (typeof rel !== 'string' || !rel || path.isAbsolute(rel) || rel.split(/[\\/]/).includes('..'))
+        return null;
+    let root;
+    try {
+        root = fs.realpathSync(repo);
+    }
+    catch {
+        return null;
+    }
+    let full = path.join(root, rel);
+    try {
+        full = fs.realpathSync(full);
+    }
+    catch {
+        // Not there yet: its own path is as far as it resolves.
+    }
+    return full.startsWith(root + path.sep) ? full : null;
+}
+/** Applies each matching recipe once: the original text must be in the file exactly once, else it is reported, never guessed. */
+export function prepare({ registry: stack, apps, env, calls, repoOf, logFile, }) {
+    const log = readActions(logFile);
+    const out = [];
+    for (const app of apps)
+        for (const recipe of recipesFor(stack, app).filter(one => matches(one, { env, calls: calls[app] ?? [] }))) {
+            const { id, why } = recipe;
+            const say = (state, detail) => out.push({ app, id, state, why, ...(detail && { detail }) });
+            const repo = repoOf(app);
+            const file = repo ? insideClone(repo, recipe.file) : undefined;
+            if (log.some(action => action.kind === 'edit' && action.recipe === id)) {
+                say('already');
+                continue;
+            }
+            if (repo && !file) {
+                say('refused', `${recipe.file} is not a file inside ${app}'s clone`);
+                continue;
+            }
+            let body;
+            try {
+                body = fs.readFileSync(file, 'utf8');
+            }
+            catch {
+                say('missing', `${recipe.file} is not in the clone`);
+                continue;
+            }
+            // Kept with \n line endings; a file with Windows endings is matched in its own.
+            const eol = body.includes('\r\n') ? '\r\n' : '\n';
+            const find = recipe.find.replace(/\n/g, eol);
+            const replace = recipe.replace.replace(/\n/g, eol);
+            const count = body.split(find).length - 1;
+            if (body.includes(replace)) {
+                say('already');
+                continue;
+            }
+            if (count !== 1) {
+                say('moved', `${recipe.file}: the original text is ${count ? 'there more than once' : 'no longer there'}`);
+                continue;
+            }
+            // Logged before the file changes, so a crash part-way still leaves Stop an entry to undo.
+            const entry = { kind: 'edit', app, file: file, before: find, after: replace, recipe: id };
+            updateActions(logFile, list => {
+                list.push(entry);
+            });
+            log.push(entry);
+            fs.writeFileSync(file, body.replace(find, () => replace));
+            out.push({ app, id, state: 'applied', why, scope: recipe.scope });
+        }
+    return out;
+}
+/** After a run: each recipe it applied worked or not on this Mac, and when. */
+export function markRuns(logFile, ok) {
+    const ids = readJson(logFile, []).flatMap(action => (action.recipe ? [action.recipe] : []));
+    if (!ids.length)
+        return;
+    const mine = readJson(privateFile(), {});
+    const at = new Date().toISOString();
+    for (const id of ids)
+        (mine.runs ??= {})[id] = { at, ok };
+    writePrivate(mine);
+}
+const OUTCOME = {
+    applied: 'applied',
+    already: 'already in place',
+    moved: 'NOT applied, the code moved',
+    missing: 'NOT applied, file missing',
+    refused: 'NOT applied, the file is outside the clone',
+};
+const REMEMBER = 'usage: koppler recipes --remember <app> --why "<reason>" [--when always|calls:<app>|env:<env>] [--private]';
+export function recipesCommand(command, args) {
+    const stack = readStack() ?? fail('no stack loaded (koppler init)');
+    const logFile = path.join(tempDir(), 'actions.json');
+    const ids = args.filter((arg, at) => !arg.startsWith('--') && !args[at - 1]?.startsWith('--'));
+    if (command === 'recipes') {
+        for (const app of ids.length ? ids : Object.keys(stack.apps))
+            for (const recipe of recipesFor(stack, app)) {
+                const { here, when } = recipe;
+                const did = here
+                    ? `${here.ok ? 'works on my machine' : 'failed here'}, last run ${here.at.slice(0, 10)}`
+                    : 'not run here yet';
+                const applies = when?.always
+                    ? 'always'
+                    : when?.calls
+                        ? `when it calls local ${when.calls}`
+                        : `on ${String(when?.env)}`;
+                console.log(`${app}  ${recipe.file}  (${recipe.scope}, ${did})\n  ${String(recipe.why)}; ${applies}`);
+            }
+        return;
+    }
+    if (command === 'remember') {
+        const app = ids[0] ?? fail(REMEMBER);
+        const logged = readJson(logFile, []);
+        const edit = logged.findLast((action) => action.kind === 'edit' && action.app === app && !action.recipe);
+        const remembered = remember({
+            registry: stack,
+            app,
+            edit: edit && { ...edit, repo: readClones()[app]?.path },
+            why: flagValue(args, '--why'),
+            whenText: flagValue(args, '--when'),
+            forcePrivate: args.includes('--private'),
+            anyOs: args.includes('--any-os'),
+        });
+        if (remembered.error !== undefined)
+            fail(remembered.error);
+        const where = remembered.scope === 'shared' ? 'in the stack, for the team: commit stack.json' : 'on this Mac only';
+        console.log(`Remembered for ${app} (${where}); id ${remembered.id}`);
+        return;
+    }
+    // The board the user sent: its environment and which local apps each app calls.
+    const run = runs().findLast(one => one.kind === 'run');
+    const env = flagValue(args, '--env') ?? run?.env ?? stack.envs[0] ?? '';
+    const edges = run?.edges ?? [];
+    const calls = Object.fromEntries(ids.map(app => [app, edges.filter(edge => edge.from === app).map(edge => edge.to)]));
+    const clones = readClones();
+    // A code change the stack remembers is the stack's own doing: applied only once the user allowed it.
+    const allowed = approved(stack.source ?? '', stack);
+    const held = allowed ? [] : ids.filter(id => stack.apps[id]?.localChanges?.length);
+    if (held.length)
+        console.log(`${held.join(', ')}: the stack's code changes were not applied; the user has to allow them first, in their own terminal: ${APPROVE}`);
+    const own = Object.fromEntries(Object.entries(stack.apps).map(([id, app]) => [id, { ...app, localChanges: [] }]));
+    const registry = allowed ? stack : { ...stack, apps: own };
+    const results = prepare({ registry, apps: ids, env, calls, repoOf: app => clones[app]?.path, logFile });
+    if (!results.length)
+        console.log('No remembered changes for these apps.');
+    for (const result of results)
+        console.log(`${result.app}: ${OUTCOME[result.state]}: ${String(result.why)}${result.detail ? ` (${result.detail})` : ''}`);
+}
+//# sourceMappingURL=recipes.js.map

package/dist/engine/recipes.js.map

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

package/dist/engine/reload.js

@@ -0,0 +1,32 @@
+// `koppler reload <app> [--restart]`: hot reload a Flutter app Koppler runs, through the signals `flutter run` takes.
+import fs from 'node:fs';
+import { positional } from "../cli/output.js";
+import { fail, Failure } from "../failure.js";
+import { flutterPid } from "./app-start.js";
+import { NAME } from "./processes.js";
+/** Sends hot reload (or with `restart`, hot restart) to the app's `flutter run`; says what it did. */
+export function hotReload(app, restart) {
+    if (!NAME.test(app))
+        throw new Failure(`${app} is not an app`);
+    let pid;
+    try {
+        pid = Number(fs.readFileSync(flutterPid(app), 'utf8').trim());
+    }
+    catch {
+        throw new Failure(`${app} is not a Flutter app Koppler runs: start it with Koppler (Started by Koppler) to reload it`);
+    }
+    try {
+        process.kill(pid, restart ? 'SIGUSR2' : 'SIGUSR1');
+    }
+    catch {
+        throw new Failure(`${app} no longer runs`);
+    }
+    return `${restart ? 'Hot restarted' : 'Hot reloaded'} ${app}`;
+}
+export function reloadCommand(args) {
+    const [app] = positional(args);
+    if (!app)
+        fail('usage: koppler reload <app> [--restart]');
+    console.log(hotReload(app, args.includes('--restart')));
+}
+//# sourceMappingURL=reload.js.map

package/dist/engine/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../src/engine/reload.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,OAAgB;IACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,OAAO,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAC;IAC/D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,OAAO,CACf,GAAG,GAAG,6FAA6F,CACpG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,OAAO,CAAC,GAAG,GAAG,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,IAAI,GAAG,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/engine/repos.js

@@ -0,0 +1,214 @@
+// Finds the git clones on this Mac (any host) and the stacks among them, and which clones could join a stack.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { writeJson } from "../json-files.js";
+import { detectKind } from "./investigate.js";
+import { INDEX, tilde } from "./config.js";
+const SKIP = new Set([
+    'node_modules',
+    'Library',
+    'Applications',
+    'Pictures',
+    'Music',
+    'Movies',
+    '.worktrees',
+    'bin',
+    'obj',
+    'build',
+    'dist',
+    '.dart_tool',
+    'Pods',
+    'vendor',
+    'target',
+]);
+export const DEFAULT_ROOTS = [
+    '~/development',
+    '~/dev',
+    '~/src',
+    '~/code',
+    '~/projects',
+    '~/workspace',
+    '~/repos',
+    '~/git',
+    '~/github',
+];
+export const DEFAULT_DEPTH = 4;
+/** One key per remote, `host/path`, for any git host: git@github.com:a/b.git and https://github.com/a/b give the same key. */
+export function remoteKey(given) {
+    const url = given?.trim();
+    if (!url || /^file:/i.test(url))
+        return null;
+    let host;
+    let repoPath;
+    const scp = /^(?:[^@/]+@)?([^:/]+):(?!\/)(.+)$/.exec(url);
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            return null;
+        }
+        host = parsed.hostname;
+        // A stray % (not an escape) is kept as written.
+        try {
+            repoPath = decodeURIComponent(parsed.pathname);
+        }
+        catch {
+            repoPath = parsed.pathname;
+        }
+    }
+    else if (scp)
+        [, host = '', repoPath = ''] = scp;
+    else
+        return null;
+    host = host.toLowerCase();
+    repoPath = repoPath
+        .replace(/^\/+|\/+$/g, '')
+        .replace(/\.git$/i, '')
+        .toLowerCase();
+    // Azure DevOps spells the same repo three ways.
+    if (host === 'ssh.dev.azure.com') {
+        host = 'dev.azure.com';
+        repoPath = repoPath.replace(/^v3\//, '');
+    }
+    const account = /^([^.]+)\.visualstudio\.com$/.exec(host)?.[1];
+    if (account) {
+        host = 'dev.azure.com';
+        repoPath = `${account}/${repoPath}`;
+    }
+    if (host === 'dev.azure.com')
+        repoPath = repoPath.replace('/_git/', '/');
+    return repoPath.includes('/') ? `${host}/${repoPath}` : null;
+}
+/** A stack slug without a host (`owner/repo`) matches that path on any host; with a host it must match exactly. */
+export function slugMatches(slug, key) {
+    if (!slug)
+        return false;
+    const wanted = slug.toLowerCase().replace(/\.git$/, '');
+    const parts = wanted.split('/');
+    return parts[0]?.includes('.')
+        ? key === wanted
+        : key.endsWith('/' + wanted) && key.split('/').length === parts.length + 1;
+}
+function remotesOf(gitDir) {
+    let config;
+    try {
+        config = fs.readFileSync(path.join(gitDir, 'config'), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    return [...config.matchAll(/^\s*url\s*=\s*(\S+)/gm)].flatMap(match => remoteKey(match[1]) ?? []);
+}
+export function findRepos(dir, maxDepth = DEFAULT_DEPTH, depth = 0, found = []) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return found;
+    }
+    // Only real clones (.git directory); worktrees have a .git file and are skipped on purpose.
+    if (entries.some(entry => entry.name === '.git' && entry.isDirectory())) {
+        const keys = [...new Set(remotesOf(path.join(dir, '.git')))];
+        if (keys.length)
+            found.push({ path: dir, keys });
+    }
+    if (depth < maxDepth)
+        for (const entry of entries)
+            if (entry.isDirectory() && !entry.name.startsWith('.') && !SKIP.has(entry.name))
+                findRepos(path.join(dir, entry.name), maxDepth, depth + 1, found);
+    return found;
+}
+export function findStacks(repos) {
+    const stacks = [];
+    for (const { path: repo } of repos) {
+        if (fs.existsSync(path.join(repo, '.koppler', 'stack.json')))
+            stacks.push(path.join(repo, '.koppler'));
+        let dirs = [];
+        try {
+            dirs = fs.readdirSync(path.join(repo, 'stacks'), { withFileTypes: true });
+        }
+        catch {
+            // No stacks folder in this repo.
+        }
+        for (const dir of dirs)
+            if (dir.isDirectory() && fs.existsSync(path.join(repo, 'stacks', dir.name, 'stack.json')))
+                stacks.push(path.join(repo, 'stacks', dir.name));
+    }
+    return stacks;
+}
+export const git = (cwd, ...args) => execFileSync('git', args, { cwd, encoding: 'utf8' }).trim();
+const MAX_BRANCHES = 300;
+/** Local and remote-tracking branches, most recently committed first, without remote prefixes or duplicates. */
+export function branchList(refs) {
+    const seen = new Set();
+    for (const ref of refs.split('\n')) {
+        const name = ref
+            .trim()
+            .replace(/^refs\/heads\//, '')
+            .replace(/^refs\/remotes\/[^/]+\//, '');
+        if (name && name !== 'HEAD')
+            seen.add(name);
+    }
+    return [...seen].slice(0, MAX_BRANCHES);
+}
+export const branchesOf = (repo) => {
+    try {
+        return branchList(git(repo, 'for-each-ref', '--sort=-committerdate', '--format=%(refname)', 'refs/heads', 'refs/remotes'));
+    }
+    catch {
+        return [];
+    }
+};
+export function scan(roots, depth) {
+    const started = Date.now();
+    const repos = roots.flatMap(root => findRepos(root, depth));
+    const index = { at: new Date().toISOString(), roots, depth, repos };
+    writeJson(INDEX, index);
+    const hosts = {};
+    for (const repo of repos)
+        for (const host of new Set(repo.keys.map(key => key.split('/')[0] ?? '')))
+            hosts[host] = (hosts[host] ?? 0) + 1;
+    const byHost = Object.entries(hosts)
+        .sort((a, b) => b[1] - a[1])
+        .map(([host, count]) => `${host} ${String(count)}`);
+    const took = ((Date.now() - started) / 1000).toFixed(1);
+    console.log(`REPOS ${String(repos.length)} in ${roots.map(tilde).join(', ')} (${byHost.join(', ') || 'no remotes'}) in ${took}s`);
+    return index;
+}
+const slugOfKey = (key) => (key.startsWith('github.com/') ? key.slice('github.com/'.length) : key);
+const WORDS = { api: 'API', ui: 'UI', sdk: 'SDK', db: 'DB', cdr: 'CDR', id: 'ID' };
+export const nameFromRepo = (repo) => repo
+    .split(/[-_.]+/)
+    .filter(Boolean)
+    .map(word => WORDS[word.toLowerCase()] ?? word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+/** Clones that could join the stack, for the picker on the canvas: where each is, what kind it looks like, and whether it is in already. */
+export function candidateRepos(index, stack, stackDir) {
+    const seen = new Set();
+    const stackPath = path.resolve(stackDir ?? '/nowhere');
+    return index.repos
+        .filter(repo => fs.existsSync(repo.path) && !stackPath.startsWith(path.resolve(repo.path) + path.sep))
+        .flatMap((repo) => {
+        const slug = slugOfKey(repo.keys[0] ?? '');
+        if (seen.has(slug))
+            return [];
+        seen.add(slug);
+        const inStack = Object.entries(stack.apps ?? {}).find(([, app]) => repo.keys.some(key => slugMatches(app.slug, key)))?.[0];
+        return [
+            {
+                slug,
+                name: nameFromRepo(slug.split('/').pop() ?? ''),
+                kind: detectKind(repo.path, stack),
+                path: tilde(repo.path),
+                folder: tilde(path.dirname(repo.path)),
+                ...(inStack && { inStack }),
+            },
+        ];
+    })
+        .sort((a, b) => a.folder.localeCompare(b.folder) || a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=repos.js.map