@onepointfour-packs/flaredeck-agent 0.2.37 → 0.2.39

package/dist/picker.js

@@ -0,0 +1,150 @@
+import { Box, Text, render, useApp, useInput } from 'ink';
+import React, { useState } from 'react';
+/**
+ * Tick some of a list.
+ *
+ * This started as the repository picker and is now shared, because the second thing an agent is
+ * scoped by — which boards it works — is the same question with different nouns. The lesson it
+ * carries is worth keeping in one place: this was once a numbered list you typed numbers at, and
+ * the numbers TOGGLED. Everything started ticked, so typing the four you wanted turned those four
+ * off. A prompt whose plainest reading is the opposite of what it does is not fixed by better
+ * wording; it is fixed by not asking people to hold the current state in their head. Move, press
+ * space, see the tick change.
+ */
+const MAX_ROWS = 16;
+function Picker({ title, subtitle, items, initial, onDone, }) {
+    const { exit } = useApp();
+    const [on, setOn] = useState(new Set(initial));
+    const [at, setAt] = useState(0);
+    const done = (picked) => { onDone(picked); exit(); };
+    useInput((input, key) => {
+        if (key.upArrow || input === 'k')
+            setAt((i) => (i - 1 + items.length) % items.length);
+        else if (key.downArrow || input === 'j')
+            setAt((i) => (i + 1) % items.length);
+        else if (input === ' ') {
+            const id = items[at]?.id;
+            if (id)
+                setOn((s) => { const n = new Set(s); if (n.has(id))
+                    n.delete(id);
+                else
+                    n.add(id); return n; });
+        }
+        else if (input === 'a')
+            setOn(new Set(items.map((r) => r.id)));
+        else if (input === 'n')
+            setOn(new Set());
+        else if (key.return)
+            done(items.filter((r) => on.has(r.id)).map((r) => r.id));
+        // Escape leaves the config alone rather than saving an empty choice — a cancelled prompt
+        // should change nothing, and "none of them" is a thing you say with n then enter.
+        else if (key.escape || input === 'q')
+            done(null);
+    });
+    // A window, so a long list does not scroll the question off the screen.
+    const half = Math.floor(MAX_ROWS / 2);
+    const first = Math.max(0, Math.min(at - half, items.length - MAX_ROWS));
+    const shown = items.slice(first, first + MAX_ROWS);
+    const width = Math.max(...items.map((r) => r.label.length));
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, null,
+            React.createElement(Text, { bold: true }, title),
+            React.createElement(Text, { dimColor: true },
+                " \u00B7 ",
+                subtitle)),
+        React.createElement(Box, { height: 1 }),
+        first > 0 ? React.createElement(Text, { dimColor: true },
+            "   \u2191 ",
+            first,
+            " more") : null,
+        shown.map((r, i) => {
+            const here = first + i === at;
+            const ticked = on.has(r.id);
+            return (React.createElement(Text, { key: r.id, color: here ? 'cyan' : undefined },
+                here ? '❯ ' : '  ',
+                React.createElement(Text, { color: ticked ? 'green' : undefined }, ticked ? '◉' : '◯'),
+                ' ',
+                React.createElement(Text, { bold: ticked }, r.label.padEnd(width)),
+                r.note ? React.createElement(Text, { dimColor: true },
+                    "   ",
+                    r.note) : null));
+        }),
+        first + MAX_ROWS < items.length ? React.createElement(Text, { dimColor: true },
+            "   \u2193 ",
+            items.length - first - MAX_ROWS,
+            " more") : null,
+        React.createElement(Box, { height: 1 }),
+        React.createElement(Text, { dimColor: true },
+            "\u2191\u2193 move \u00B7 space tick \u00B7 a all \u00B7 n none \u00B7 enter accept (",
+            on.size,
+            " selected) \u00B7 esc cancel")));
+}
+/** Resolves to the ticked ids, or null when the person backed out without choosing. */
+export function pickMany(title, subtitle, items, initial) {
+    return new Promise((resolve) => {
+        // Resolved from the callback AND from the unmount, whichever happens first, because this sits
+        // in the middle of login: a picker that renders but never returns is a login that hangs with
+        // no way forward. startApprovals settles the same two ways for the same reason.
+        let settled = false;
+        let answer = null;
+        let app = null;
+        /**
+         * Give the terminal back, and only once Ink has finished with it.
+         *
+         * Ink puts stdin in raw mode and pauses it, and its teardown runs on a later tick than
+         * `unmount()` returns — so restoring immediately is undone a moment afterwards. Whatever
+         * asks a question next then waits on a stdin that will never deliver, and a promise that
+         * can never settle is NOT an error: node runs out of work and exits, cleanly, status 0,
+         * with nothing printed. `login` did exactly that at the branch prompt, and node's own
+         * "Detected unsettled top-level await" was the only clue it ever gave.
+         *
+         * So: wait for waitUntilExit, THEN restore, THEN answer the caller.
+         */
+        const done = (picked) => {
+            if (settled)
+                return;
+            settled = true;
+            answer = picked;
+            try {
+                app?.unmount();
+            }
+            catch { /* already gone */ }
+        };
+        /**
+         * Take the terminal out of raw mode.
+         *
+         * Ink puts it there and does not reliably undo it, and readline cannot read a terminal left
+         * raw. That is all this needs to do: measured across the boundary, stdin ends up paused
+         * either way and a fresh readline resumes it perfectly well.
+         *
+         * NOT unref, and NOT resume. Both were tried against the login dying here and both were
+         * wrong: `refd` stayed true throughout, and `resume()` puts the stream into flowing mode
+         * where, with no consumer attached, every keystroke is read and thrown away. The real fault
+         * was a readline left attached across this render — see main.ts, closeReader().
+         */
+        const giveBackStdin = () => {
+            try {
+                // Raw mode off: Ink turns it on and readline cannot read a terminal left raw.
+                if (process.stdin.isTTY && process.stdin.setRawMode)
+                    process.stdin.setRawMode(false);
+                // And REF it. Ink unrefs stdin so its own app can exit, and an unref'd stream does not
+                // hold the event loop open: the next question waits for input that would arrive fine
+                // while node decides it has nothing left to do and leaves — no error, status 0.
+                //
+                // This was removed once, on the evidence of a run where `refd` stayed true. It stayed
+                // true only because a stale readline was still attached and holding the ref — the very
+                // bug fixed alongside this. Fixing that one exposed this one. Measured, after both:
+                //   with a stale reader:  data=1 refd=true  -> dies (the reader never resumes stdin)
+                //   reader closed only:   data=0 refd=false -> dies (nothing holds the loop open)
+                //   both:                 data=0 refd=true  -> answers
+                process.stdin.ref?.();
+            }
+            catch { /* not a terminal: nothing to give back */ }
+        };
+        app = render(React.createElement(Picker, { title: title, subtitle: subtitle, items: items, initial: initial, onDone: done }));
+        app.waitUntilExit()
+            .catch(() => { })
+            .then(() => { giveBackStdin(); resolve(answer); });
+    });
+}
+//# sourceMappingURL=picker.js.map

package/dist/picker.js.map

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

package/dist/preflight.d.ts

@@ -60,6 +60,48 @@ export type CheckResult = {
     fixed: boolean;
 };
 export declare function loadChecks(repo: string): Check[];
+/**
+ * Install the project's dependencies if they are missing.
+ *
+ * A fresh worktree has tracked files and nothing else, so the first thing an agent needs is the
+ * one thing it cannot have: node_modules. One asked a person — "can you run npm install on CASE's
+ * and TARS's machines?" — which is a card stopped for hours on something mechanical that any
+ * machine can do for itself.
+ *
+ * It is the harness's job for the same reason the worktree is: it is the same every time, it has
+ * one right answer, and asking a model (or a person) to do it is asking for variety nobody wants.
+ */
+export type ManagerChoice = {
+    manager: PackageManager;
+    /** The evidence it was chosen on, for the step line and for the failure detail. */
+    why: string;
+    /** Set only when the evidence did NOT settle it, and naming the one line that would. */
+    unsettled?: string;
+};
+type PackageManager = 'npm' | 'yarn' | 'pnpm';
+/**
+ * Work out which package manager this project uses, from evidence, in order of authority.
+ *
+ * Running the wrong one does not degrade, it fails: `npm` on a yarn project meets ERESOLVE on
+ * every card, the environment never starts, and the agent correctly reports it cannot work. So
+ * this does not pick a favourite and hope. It reads the signals a repository actually carries:
+ *
+ *   1. `packageManager` in package.json. The people who own the repo wrote it down; nothing
+ *      found lying on disk outranks that.
+ *   2. One lockfile. One lockfile is an answer.
+ *   3. Several lockfiles, but only one of them committed. A tracked lockfile is the project's;
+ *      an untracked one is somebody's afternoon.
+ *   4. Several COMMITTED lockfiles — and that is not a hypothetical. FlareDeck carries a
+ *      package-lock.json and a yarn.lock from the same commit, both fully in step with
+ *      package.json, both 2025-10-28. Nothing on disk can separate them, and the honest thing
+ *      is to say so rather than quietly pick one and let the failure look like the card's
+ *      fault: `unsettled` carries the sentence, and the fix is one line in package.json.
+ *
+ * Then, whatever was chosen, it has to exist on this machine — a repo declaring pnpm on a box
+ * without pnpm is a fact worth saying rather than an `pnpm: command not found` six lines deep
+ * in an install log.
+ */
+export declare function choosePackageManager(repo: string): Promise<ManagerChoice>;
 export declare function preflight(repo: string, onStep: (text: string) => void): Promise<CheckResult[]>;
 /**
  * What the agent is told about the state of its environment.
@@ -69,3 +111,4 @@ export declare function preflight(repo: string, onStep: (text: string) => void):
  * than no answer, because someone believes it.
  */
 export declare function preflightBrief(results: CheckResult[]): string;
+export {};

package/dist/preflight.js

@@ -69,40 +69,154 @@ function run(command, cwd, timeoutMs = TIMEOUT_MS) {
         child.on('error', (e) => { clearTimeout(timer); resolve({ code: 1, out: String(e) }); });
     });
 }
+const LOCKFILES = {
+    npm: 'package-lock.json',
+    yarn: 'yarn.lock',
+    pnpm: 'pnpm-lock.yaml',
+};
+const MANAGERS = Object.keys(LOCKFILES);
 /**
- * Install the project's dependencies if they are missing.
+ * Work out which package manager this project uses, from evidence, in order of authority.
  *
- * A fresh worktree has tracked files and nothing else, so the first thing an agent needs is the
- * one thing it cannot have: node_modules. One asked a person — "can you run npm install on CASE's
- * and TARS's machines?" — which is a card stopped for hours on something mechanical that any
- * machine can do for itself.
+ * Running the wrong one does not degrade, it fails: `npm` on a yarn project meets ERESOLVE on
+ * every card, the environment never starts, and the agent correctly reports it cannot work. So
+ * this does not pick a favourite and hope. It reads the signals a repository actually carries:
  *
- * It is the harness's job for the same reason the worktree is: it is the same every time, it has
- * one right answer, and asking a model (or a person) to do it is asking for variety nobody wants.
+ *   1. `packageManager` in package.json. The people who own the repo wrote it down; nothing
+ *      found lying on disk outranks that.
+ *   2. One lockfile. One lockfile is an answer.
+ *   3. Several lockfiles, but only one of them committed. A tracked lockfile is the project's;
+ *      an untracked one is somebody's afternoon.
+ *   4. Several COMMITTED lockfiles — and that is not a hypothetical. FlareDeck carries a
+ *      package-lock.json and a yarn.lock from the same commit, both fully in step with
+ *      package.json, both 2025-10-28. Nothing on disk can separate them, and the honest thing
+ *      is to say so rather than quietly pick one and let the failure look like the card's
+ *      fault: `unsettled` carries the sentence, and the fix is one line in package.json.
+ *
+ * Then, whatever was chosen, it has to exist on this machine — a repo declaring pnpm on a box
+ * without pnpm is a fact worth saying rather than an `pnpm: command not found` six lines deep
+ * in an install log.
  */
+export async function choosePackageManager(repo) {
+    const choice = await decideManager(repo);
+    if (await canRun(choice.manager, repo))
+        return choice;
+    for (const alt of MANAGERS) {
+        if (alt === choice.manager)
+            continue;
+        if (!(await canRun(alt, repo)))
+            continue;
+        return {
+            ...choice,
+            manager: alt,
+            why: `${choice.why}, but ${choice.manager} is not installed on this machine, so ${alt} instead`,
+            unsettled: `this project wants ${choice.manager}, which is not installed here — I used ${alt}. Installing ${choice.manager} on this machine is the real fix.`,
+        };
+    }
+    return choice; // Nothing at all is installed; the install itself will say so plainly enough.
+}
+async function decideManager(repo) {
+    const has = (f) => existsSync(join(repo, f));
+    let declared = '';
+    try {
+        const pkg = JSON.parse(readFileSync(join(repo, 'package.json'), 'utf8'));
+        declared = (pkg.packageManager ?? '').split('@')[0]?.trim() ?? '';
+    }
+    catch { /* an unreadable package.json fails the install with a better message than this */ }
+    if (MANAGERS.includes(declared)) {
+        return { manager: declared, why: `package.json declares packageManager: ${declared}` };
+    }
+    const present = MANAGERS.filter((m) => has(LOCKFILES[m]));
+    if (present.length === 0)
+        return { manager: 'npm', why: "no lockfile here, so npm as Node's default" };
+    if (present.length === 1)
+        return { manager: present[0], why: `${LOCKFILES[present[0]]} is the only lockfile` };
+    const tracked = [];
+    for (const m of present) {
+        const { code } = await run(`git ls-files --error-unmatch -- ${LOCKFILES[m]}`, repo, 15_000);
+        if (code === 0)
+            tracked.push(m);
+    }
+    if (tracked.length === 1) {
+        const others = present.filter((m) => m !== tracked[0]).map((m) => LOCKFILES[m]).join(', ');
+        return { manager: tracked[0], why: `${LOCKFILES[tracked[0]]} is committed; ${others} is not` };
+    }
+    const candidates = tracked.length ? tracked : present;
+    const manager = candidates.includes('npm') ? 'npm' : candidates[0];
+    const names = candidates.map((m) => LOCKFILES[m]).join(' and ');
+    const options = candidates.map((m) => `${m}@<version>`).join(' or ');
+    return {
+        manager,
+        why: `${names} are both committed, and nothing here distinguishes them`,
+        unsettled: `this project has ${candidates.length} committed lockfiles (${names}) and no "packageManager" in package.json, ` +
+            `so nothing in the repository says which to install with — I fell back to ${manager}. ` +
+            // Deliberately NOT suggesting the fallback: it was a tiebreak, not a reading of what the
+            // project wants, and printing it as the fix would turn a coin toss into the repo's answer.
+            `Only the project can settle this: add "packageManager": "${options}" to package.json.`,
+    };
+}
+/** Installed and runnable, which is not the same as on PATH — corepack shims can be both. */
+async function canRun(manager, repo) {
+    const { code } = await run(`${manager} --version`, repo, 30_000);
+    return code === 0;
+}
 async function installDeps(repo, onStep) {
     if (!existsSync(join(repo, 'package.json')))
         return null;
     if (existsSync(join(repo, 'node_modules')))
         return null;
-    // `ci` is exact and fast but needs a lockfile that matches; `install` is the fallback.
-    const lock = existsSync(join(repo, 'package-lock.json'));
-    // --include=dev deliberately: the harness sets NODE_ENV=production for its own rendering, and
-    // anything inherited that leaves out devDependencies leaves the agent with no typecheck.
-    const cmd = lock ? 'npm ci --include=dev' : 'npm install --include=dev';
-    onStep('installing dependencies (fresh worktree)');
-    let { code, out } = await run(cmd, repo, INSTALL_TIMEOUT_MS);
-    if (code !== 0 && lock) {
-        // A lockfile out of step with package.json fails `ci` and nothing else. Worth one retry.
-        onStep('npm ci did not fit the lockfile — trying npm install');
-        ({ code, out } = await run('npm install --include=dev', repo, INSTALL_TIMEOUT_MS));
+    /**
+     * The lockfile says which package manager this project uses, and running the wrong one does
+     * not degrade — it fails. This ran `npm` on everything, so a yarn project (Kepler's App) met
+     * ERESOLVE on every card, the environment never started, and the agent correctly reported that
+     * it could not do the work. One repo-shaped assumption, every card in that repo lost.
+     *
+     * --include=dev and its equivalents, deliberately: the harness sets NODE_ENV=production for
+     * its own rendering, and anything inherited that leaves out devDependencies leaves the agent
+     * with no typecheck.
+     */
+    const has = (f) => existsSync(join(repo, f));
+    const chosen = await choosePackageManager(repo);
+    const manager = chosen.manager;
+    // Which one, and on what evidence — so a wrong install is a readable sentence, not a mystery.
+    if (chosen.unsettled)
+        onStep(chosen.unsettled);
+    const [first, fallback] = manager === 'yarn' ? ['yarn install --frozen-lockfile', 'yarn install']
+        : manager === 'pnpm' ? ['pnpm install --frozen-lockfile', 'pnpm install']
+            : has('package-lock.json') ? ['npm ci --include=dev', 'npm install --include=dev']
+                : ['npm install --include=dev', ''];
+    onStep(`installing dependencies (fresh worktree, ${manager} — ${chosen.why})`);
+    let { code, out } = await run(first, repo, INSTALL_TIMEOUT_MS);
+    if (code !== 0 && fallback) {
+        // A lockfile out of step with package.json fails the strict form and nothing else.
+        onStep(`${first.split(' ').slice(0, 2).join(' ')} did not fit the lockfile — trying ${fallback}`);
+        ({ code, out } = await run(fallback, repo, INSTALL_TIMEOUT_MS));
+    }
+    /**
+     * A peer-dependency conflict is the project's, not this card's.
+     *
+     * npm 7 and later REFUSE to install when peers disagree, where npm 6 warned and carried on.
+     * A real project can sit in that state for months — FlareDeck does, @angular/fire against a
+     * newer Angular — and the application builds and runs perfectly well regardless. Without this
+     * the harness stops at ERESOLVE, the agent correctly reports it cannot work, and EVERY card
+     * in that repository stalls on a disagreement nobody is going to resolve today.
+     *
+     * Last, never first: it is the flag that makes npm install something it would otherwise call
+     * unsafe, so it is what you reach for once the honest attempts have failed, and the step says
+     * so out loud rather than papering over it.
+     */
+    if (code !== 0 && manager === 'npm' && /ERESOLVE|peer dep/i.test(out)) {
+        onStep('peer dependencies disagree in this project — retrying with --legacy-peer-deps');
+        ({ code, out } = await run('npm install --include=dev --legacy-peer-deps', repo, INSTALL_TIMEOUT_MS));
     }
     onStep(code === 0 ? 'dependencies installed' : 'dependencies could NOT be installed');
     return {
         name: 'dependencies',
         ok: code === 0,
         fixed: code === 0,
-        detail: code === 0 ? '' : out.trim().split('\n').slice(-6).join('\n').slice(0, 600),
+        // The manager and why it was chosen, first: an install that failed under the wrong one
+        // looks exactly like an install that failed, and whoever reads this needs to tell them apart.
+        detail: code === 0 ? '' : [`${manager}: ${chosen.why}`, out.trim().split('\n').slice(-6).join('\n')].join('\n').slice(0, 700),
     };
 }
 export async function preflight(repo, onStep) {

package/dist/preflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AA0C7B;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;QAC7D,OAAO,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;QAC1D,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YACvC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;YAC9D,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,EAAE,GAAG,MAAM,CAAC;AAEvC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC;aAClD,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACxH,CAAC;IAAC,MAAM,CAAC;QACP,wFAAwF;QACxF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,OAAe,EAAE,GAAW,EAAE,SAAS,GAAG,UAAU;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;YAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,2EAA2E;QAC3E,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1H,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC;AAuBD,MAAM,SAAS,GAAmC;IAChD,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,gBAAgB;CACvB,CAAC;AAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,MAAM,CAAC,OAAO;YAAE,SAAS;QACrC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,SAAS;QACzC,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,GAAG;YACZ,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,OAAO,yCAAyC,GAAG,UAAU;YAC/F,SAAS,EAAE,sBAAsB,MAAM,CAAC,OAAO,0CAA0C,GAAG,gBAAgB,MAAM,CAAC,OAAO,mCAAmC;SAC9J,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,8EAA8E;AAC/F,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAErD,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAgC,CAAC;QACxG,QAAQ,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC,CAAC,kFAAkF,CAAC,CAAC;IAC9F,IAAK,QAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,QAA0B,EAAE,GAAG,EAAE,yCAAyC,QAAQ,EAAE,EAAE,CAAC;IAC3G,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,4CAA4C,EAAE,CAAC;IACvG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,uBAAuB,EAAE,CAAC;IAEjH,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,mCAAmC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5F,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,kBAAkB,MAAM,SAAS,EAAE,CAAC;IACnG,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACtD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,OAAO;QACL,OAAO;QACP,GAAG,EAAE,GAAG,KAAK,0DAA0D;QACvE,SAAS,EACP,oBAAoB,UAAU,CAAC,MAAM,yBAAyB,KAAK,6CAA6C;YAChH,4EAA4E,OAAO,IAAI;YACvF,yFAAyF;YACzF,2FAA2F;YAC3F,4DAA4D,OAAO,oBAAoB;KAC1F,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,MAAM,CAAC,OAAuB,EAAE,IAAY;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,MAA8B;IACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAExD;;;;;;;;;OASG;IACH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,8FAA8F;IAC9F,IAAI,MAAM,CAAC,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE/C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GACrB,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,gCAAgC,EAAE,cAAc,CAAC;QACvE,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,gCAAgC,EAAE,cAAc,CAAC;YACzE,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;gBAClF,CAAC,CAAC,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAEtC,MAAM,CAAC,4CAA4C,OAAO,MAAM,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/E,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC3B,mFAAmF;QACnF,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;QAClG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,+EAA+E,CAAC,CAAC;QACxF,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,8CAA8C,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC;IACtF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,EAAE,EAAE,IAAI,KAAK,CAAC;QACd,KAAK,EAAE,IAAI,KAAK,CAAC;QACjB,uFAAuF;QACvF,8FAA8F;QAC9F,MAAM,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KAC9H,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAA8B;IAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,mFAAmF;IACnF,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YAC5B,yEAAyE;YACzE,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,6BAA6B,CAAC,CAAC;YACnD,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3B,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;YAC7C,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,EAAE,EAAE,IAAI,KAAK,CAAC;YACd,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAChE,KAAK;SACN,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,MAAM;YACjB,CAAC,CAAC,sCAAsC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC;YAClH,CAAC,CAAC,yEAAyE,CAAC;IAChF,CAAC;IAED,OAAO,CACL,wEAAwE;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7E,+FAA+F;QAC/F,gGAAgG;QAChG,4BAA4B,CAC7B,CAAC;AACJ,CAAC"}

package/dist/repopicker.js

@@ -1,84 +1,10 @@
-import { Box, Text, render, useApp, useInput } from 'ink';
-import React, { useState } from 'react';
+import { pickMany } from './picker.js';
 /**
  * Tick the repositories an agent may work in.
  *
- * This was a numbered list you typed numbers at, and the numbers TOGGLED. Everything started
- * ticked, so typing the four you wanted turned those four off — the list said "to toggle" and it
- * still read as "to choose". A prompt whose plainest reading is the opposite of what it does is
- * not a prompt worth keeping, and the fix is not better wording: it is to stop asking people to
- * hold the current state in their head. Move, press space, see the tick change.
+ * The interaction itself now lives in `picker.tsx`, shared with the board picker — the same
+ * question with different nouns, and the note it carries about toggling is worth reading once.
  */
-const MAX_ROWS = 16;
-function Picker({ root, repos, initial, onDone, }) {
-    const { exit } = useApp();
-    const [on, setOn] = useState(new Set(initial));
-    const [at, setAt] = useState(0);
-    const done = (picked) => { onDone(picked); exit(); };
-    useInput((input, key) => {
-        if (key.upArrow || input === 'k')
-            setAt((i) => (i - 1 + repos.length) % repos.length);
-        else if (key.downArrow || input === 'j')
-            setAt((i) => (i + 1) % repos.length);
-        else if (input === ' ') {
-            const name = repos[at]?.name;
-            if (name)
-                setOn((s) => { const n = new Set(s); if (n.has(name))
-                    n.delete(name);
-                else
-                    n.add(name); return n; });
-        }
-        else if (input === 'a')
-            setOn(new Set(repos.map((r) => r.name)));
-        else if (input === 'n')
-            setOn(new Set());
-        else if (key.return)
-            done(repos.filter((r) => on.has(r.name)).map((r) => r.name));
-        // Escape leaves the config alone rather than saving an empty choice — a cancelled prompt
-        // should change nothing, and "none of them" is a thing you say with n then enter.
-        else if (key.escape || input === 'q')
-            done(null);
-    });
-    // A window, so a folder of forty repos does not scroll the question off the screen.
-    const half = Math.floor(MAX_ROWS / 2);
-    const first = Math.max(0, Math.min(at - half, repos.length - MAX_ROWS));
-    const shown = repos.slice(first, first + MAX_ROWS);
-    const width = Math.max(...repos.map((r) => r.name.length));
-    return (React.createElement(Box, { flexDirection: "column" },
-        React.createElement(Text, null,
-            React.createElement(Text, { bold: true }, "Which of these may this agent work in?"),
-            React.createElement(Text, { dimColor: true },
-                " \u00B7 ",
-                repos.length,
-                " found in ",
-                root)),
-        React.createElement(Box, { height: 1 }),
-        first > 0 ? React.createElement(Text, { dimColor: true },
-            "   \u2191 ",
-            first,
-            " more") : null,
-        shown.map((r, i) => {
-            const here = first + i === at;
-            const ticked = on.has(r.name);
-            return (React.createElement(Text, { key: r.path, color: here ? 'cyan' : undefined },
-                here ? '❯ ' : '  ',
-                React.createElement(Text, { color: ticked ? 'green' : undefined }, ticked ? '◉' : '◯'),
-                ' ',
-                React.createElement(Text, { bold: ticked }, r.name.padEnd(width)),
-                React.createElement(Text, { dimColor: true },
-                    "   ",
-                    r.origin ? shortRemote(r.origin) : 'no remote — nothing it pushes can be received')));
-        }),
-        first + MAX_ROWS < repos.length ? React.createElement(Text, { dimColor: true },
-            "   \u2193 ",
-            repos.length - first - MAX_ROWS,
-            " more") : null,
-        React.createElement(Box, { height: 1 }),
-        React.createElement(Text, { dimColor: true },
-            "\u2191\u2193 move \u00B7 space tick \u00B7 a all \u00B7 n none \u00B7 enter accept (",
-            on.size,
-            " selected) \u00B7 esc cancel")));
-}
 const shortRemote = (url) => url.trim().toLowerCase()
     .replace(/^git@([^:]+):/, '$1/')
     .replace(/^[a-z]+:\/\//, '')
@@ -88,24 +14,10 @@ const shortRemote = (url) => url.trim().toLowerCase()
     .join('/');
 /** Resolves to the ticked names, or null when the person backed out without choosing. */
 export function pickRepos(root, repos, initial) {
-    return new Promise((resolve) => {
-        // Resolved from the callback AND from the unmount, whichever happens first, because this sits
-        // in the middle of login: a picker that renders but never returns is a login that hangs with
-        // no way forward. startApprovals settles the same two ways for the same reason.
-        let settled = false;
-        let app = null;
-        const finish = (picked) => {
-            if (settled)
-                return;
-            settled = true;
-            try {
-                app?.unmount();
-            }
-            catch { /* already gone */ }
-            resolve(picked);
-        };
-        app = render(React.createElement(Picker, { root: root, repos: repos, initial: initial, onDone: finish }));
-        void app.waitUntilExit().then(() => finish(null));
-    });
+    return pickMany('Which of these may this agent work in?', `${repos.length} found in ${root}`, repos.map((r) => ({
+        id: r.name,
+        label: r.name,
+        note: r.origin ? shortRemote(r.origin) : 'no remote — nothing it pushes can be received',
+    })), initial);
 }
 //# sourceMappingURL=repopicker.js.map

package/dist/repopicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"repopicker.js","sourceRoot":"","sources":["../src/repopicker.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"repopicker.js","sourceRoot":"","sources":["../src/repopicker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CAC1C,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;KACrB,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC;KAC/B,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;KAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;KACrB,KAAK,CAAC,GAAG,CAAC;KACV,KAAK,CAAC,CAAC,CAAC,CAAC;KACT,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAiB,EAAE,OAAoB;IAC7E,OAAO,QAAQ,CACb,wCAAwC,EACxC,GAAG,KAAK,CAAC,MAAM,aAAa,IAAI,EAAE,EAClC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,EAAE,EAAE,CAAC,CAAC,IAAI;QACV,KAAK,EAAE,CAAC,CAAC,IAAI;QACb,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,+CAA+C;KACzF,CAAC,CAAC,EACH,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/runs.d.ts

@@ -72,17 +72,32 @@ export declare function previewFor(script: string): string | null;
  */
 export declare function resumeApprovedRuns(targets: Record<string, RunTarget>, deck: Flaredeck, cwd: string, log: (text: string) => void): Promise<number>;
 /** What the harness does on the agent's behalf once a person has to be involved. */
+export type Choice = {
+    label: string;
+    detail?: string;
+};
 export type HumanHooks = {
     /** Flag the card and tell whoever the board names. Returns who was told, when it says. */
-    flag: (reason: string, kind: string) => Promise<string | null>;
-    /** The card has been answered, so it is no longer waiting on anybody. */
-    unflag: () => Promise<void>;
+    flag: (reason: string, kind: string, ask?: {
+        question: string;
+        options: Choice[];
+    }) => Promise<string | null>;
+    /** Put a local file on the card. The harness does the upload, so no shell command is judged. */
+    attach?: (card: Current, path: string, comment?: string) => Promise<string>;
+    /** The card has been answered, so it is no longer waiting on anybody. Clear the flag on THIS card — by the time an answer arrives the agent may be on another. */
+    unflag: (card: Current) => Promise<void>;
 };
 export declare function runTools(configured: Record<string, RunTarget>, current: () => Current | null, deck: Flaredeck | null, log: (text: string) => void, human: HumanHooks, 
 /** This agent's lead, when it has one: a script goes there first, and a person is asked only if the lead endorses it. */
 lead?: () => string | null, 
 /** The pane, told when a request is posted and when it is answered. */
-onAsk?: (e: AskEvent) => void): {
+onAsk?: (e: AskEvent) => void, 
+/**
+ * Bring a parked card back with the outcome of its request. When given, a script request does
+ * NOT hold the turn: the card is parked, the agent moves on to its next card, and this card
+ * returns to the front of the queue once a person answers. Without it, the old wait.
+ */
+resume?: (card: Current, text: string) => void): {
     server: unknown;
     toolNames: string[];
 };