roughbook 0.0.0-stage → 0.1.0

package/dist/fs/lock.js

@@ -0,0 +1,38 @@
+import { mkdir, open, rm, stat } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Runs `work` while holding `<file>.lock`, so the CLI and the local server never write the same
+ * state file at once. Creating the lock with `wx` is atomic on every OS.
+ */
+export async function withLock(file, work, { staleMs = 60_000, waitMs = 60_000 } = {}) {
+    const lock = `${file}.lock`;
+    await mkdir(path.dirname(lock), { recursive: true });
+    const started = Date.now();
+    for (;;) {
+        try {
+            const handle = await open(lock, 'wx');
+            await handle.writeFile(String(process.pid));
+            await handle.close();
+            break;
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            const held = await stat(lock).catch(() => null);
+            if (held && Date.now() - held.mtimeMs > staleMs) {
+                await rm(lock, { force: true });
+                continue;
+            }
+            if (Date.now() - started > waitMs)
+                throw new Error(`Another Roughbook process holds ${lock}.`);
+            await new Promise(resolve => setTimeout(resolve, 25));
+        }
+    }
+    try {
+        return await work();
+    }
+    finally {
+        await rm(lock, { force: true });
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/fs/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/fs/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAAsB,EACtB,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,KAAkB,EAAE;IAEvD,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC;IAC5B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;gBAChD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,MAAM;gBAC/B,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,GAAG,CAAC,CAAC;YAC9D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/io.js

@@ -0,0 +1,26 @@
+import { createInterface } from 'node:readline/promises';
+export function terminalIo() {
+    return {
+        out: line => void process.stdout.write(`${line}\n`),
+        err: line => void process.stderr.write(`${line}\n`),
+        async ask(question) {
+            if (!process.stdin.isTTY)
+                return null;
+            const readline = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                return (await readline.question(question)).trim();
+            }
+            finally {
+                readline.close();
+            }
+        }
+    };
+}
+/** Asks a yes or no question; `fallback` when the answer is empty or nobody can answer. */
+export async function confirm(io, question, fallback) {
+    const answer = await io.ask(`${question} ${fallback ? '[Y/n]' : '[y/N]'} `);
+    if (!answer)
+        return fallback;
+    return /^y(es)?$/i.test(answer);
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAUzD,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QACnD,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QACnD,KAAK,CAAC,GAAG,CAAC,QAAQ;YAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpD,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAM,EAAE,QAAgB,EAAE,QAAiB;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/launch/open.js

@@ -0,0 +1,48 @@
+import { spawn } from 'node:child_process';
+/**
+ * How each OS opens a URL in the default browser, as an argument array: no shell, so nothing in
+ * the URL is ever interpreted. Null where the studio knows no opener.
+ */
+export function openerFor(url, platform = process.platform) {
+    if (platform === 'win32')
+        return { command: 'rundll32', args: ['url.dll,FileProtocolHandler', url] };
+    if (platform === 'darwin')
+        return { command: 'open', args: [url] };
+    if (platform === 'linux' || platform === 'freebsd' || platform === 'openbsd') {
+        return { command: 'xdg-open', args: [url] };
+    }
+    return null;
+}
+/** Opens an http(s) URL in the default browser. Resolves false when it could not. */
+export function openUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return Promise.resolve(false);
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:')
+        return Promise.resolve(false);
+    const opener = openerFor(parsed.href);
+    if (!opener)
+        return Promise.resolve(false);
+    return new Promise(resolve => {
+        try {
+            const child = spawn(opener.command, opener.args, {
+                detached: true,
+                stdio: 'ignore',
+                windowsHide: true
+            });
+            child.once('error', () => resolve(false));
+            child.once('spawn', () => {
+                child.unref();
+                resolve(true);
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+//# sourceMappingURL=open.js.map

package/dist/launch/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/launch/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,OAAO;QACtB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,6BAA6B,EAAE,GAAG,CAAC,EAAE,CAAC;IAC7E,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;gBAC/C,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/launch/platform.js

@@ -0,0 +1,38 @@
+import fs from 'node:fs';
+export function currentOs(platform = process.platform) {
+    if (platform === 'win32')
+        return 'windows';
+    if (platform === 'darwin')
+        return 'macos';
+    if (platform === 'linux')
+        return 'linux';
+    return 'other';
+}
+/** This machine's platform, for code outside launch/ and screenshot/ that takes one as input. */
+export function hostPlatform() {
+    return process.platform;
+}
+export const diskProbe = {
+    exists(file) {
+        try {
+            // lstat: Windows app execution aliases (wt.exe) are links that existsSync cannot follow.
+            fs.lstatSync(file);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    dirs(dir) {
+        try {
+            return fs
+                .readdirSync(dir, { withFileTypes: true })
+                .filter(entry => entry.isDirectory())
+                .map(entry => entry.name);
+        }
+        catch {
+            return [];
+        }
+    }
+};
+//# sourceMappingURL=platform.js.map

package/dist/launch/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/launch/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAKzB,MAAM,UAAU,SAAS,CAAC,WAA4B,OAAO,CAAC,QAAQ;IACpE,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC;AASD,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,MAAM,CAAC,IAAI;QACT,IAAI,CAAC;YACH,yFAAyF;YACzF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG;QACN,IAAI,CAAC;YACH,OAAO,EAAE;iBACN,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBACzC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;iBACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/launch/pty.js

@@ -0,0 +1,61 @@
+// The built-in terminal's pseudo-terminal: node-pty, an optional dependency with binaries for
+// Windows, macOS and glibc Linux (S1 step 5). Where it is missing, does not load, or would crash
+// Node (musl Linux), the studio opens the designer's own terminal instead.
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+/** The glibc version Node runs on, or null on musl and every other platform. */
+function glibcVersion() {
+    const report = process.report?.getReport();
+    return report?.header?.glibcVersionRuntime ?? null;
+}
+/** Starts and ends one terminal in a separate Node, so a crash there cannot take this one down. */
+function survivesProbe(modulePath) {
+    const script = `
+const pty = require(${JSON.stringify(modulePath)});
+const child = pty.spawn(process.execPath, ['-e', ''], { name: 'xterm-256color', cols: 80, rows: 24, cwd: process.cwd(), env: process.env });
+child.onExit(({ exitCode }) => process.exit(exitCode === 0 ? 0 : 1));
+setTimeout(() => process.exit(2), 8000);
+`;
+    const result = spawnSync(process.execPath, ['-e', script], { stdio: 'ignore', timeout: 10_000 });
+    return result.status === 0;
+}
+let cached = null;
+/**
+ * Whether the built-in terminal can run here, and the module when it can. Checked once per
+ * process. `ROUGHBOOK_TERMINAL=external` turns it off.
+ */
+export function loadPty(env) {
+    if (env.ROUGHBOOK_TERMINAL === 'external') {
+        return { ok: false, reason: 'ROUGHBOOK_TERMINAL=external chooses your own terminal.' };
+    }
+    if (cached)
+        return cached;
+    cached = probe();
+    return cached;
+}
+function probe() {
+    if (process.platform === 'linux' && !glibcVersion()) {
+        return {
+            ok: false,
+            reason: 'The built-in terminal needs glibc; on musl Linux (Alpine) it would crash Node.'
+        };
+    }
+    let modulePath;
+    let pty;
+    try {
+        modulePath = require.resolve('node-pty');
+        pty = require(modulePath);
+    }
+    catch {
+        return {
+            ok: false,
+            reason: 'node-pty is not installed here, so runs open in your own terminal.'
+        };
+    }
+    if (process.platform === 'linux' && !survivesProbe(modulePath)) {
+        return { ok: false, reason: 'node-pty did not start a terminal here.' };
+    }
+    return { ok: true, pty };
+}
+//# sourceMappingURL=pty.js.map

package/dist/launch/pty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.js","sourceRoot":"","sources":["../../src/launch/pty.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,iGAAiG;AACjG,2EAA2E;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2B5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,gFAAgF;AAChF,SAAS,YAAY;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAmD,CAAC;IAC5F,OAAO,MAAM,EAAE,MAAM,EAAE,mBAAmB,IAAI,IAAI,CAAC;AACrD,CAAC;AAED,mGAAmG;AACnG,SAAS,aAAa,CAAC,UAAkB;IACvC,MAAM,MAAM,GAAG;sBACK,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;;;;CAI/C,CAAC;IACA,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,IAAI,MAAM,GAAsB,IAAI,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAsB;IAC5C,IAAI,GAAG,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wDAAwD,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,KAAK,EAAE,CAAC;IACjB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK;IACZ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,gFAAgF;SACzF,CAAC;IACJ,CAAC;IACD,IAAI,UAAkB,CAAC;IACvB,IAAI,GAAc,CAAC;IACnB,IAAI,CAAC;QACH,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,GAAG,GAAG,OAAO,CAAC,UAAU,CAAc,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,oEAAoE;SAC7E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yCAAyC,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/dist/launch/terminal.js

@@ -0,0 +1,194 @@
+// Opens a terminal in the repo running an agent with its one-line instruction: a terminal
+// session the designer watches and steers. Windows uses Windows Terminal (one tab per session)
+// or a console window; macOS opens Terminal, or iTerm when ROUGHBOOK_TERMINAL=iterm; Linux tries
+// $TERMINAL, then x-terminal-emulator, GNOME Terminal, Konsole and xterm. Where none can be
+// opened, the plan says so and gives the command to paste. Planning is pure; launching is the
+// only side effect. Ported and extended from roughbook runner/terminal.ts (v2-local), which was
+// Windows only.
+import { spawn } from 'node:child_process';
+import { chmod, mkdtemp, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { diskProbe } from './platform.js';
+import { findOnPath } from './which.js';
+/** What may appear in a title or argument. Prompt paths are slugs and ids, so nothing real is refused. */
+const SAFE_TEXT = /^[A-Za-z0-9 ./_:,()=@+-]+$/;
+/** What may appear in a path handed to a terminal: no quotes, no shell or cmd metacharacters. */
+const SAFE_PATH = /^[^"'`$%^&|<>;\r\n]+$/;
+export const MAX_SESSIONS = 6;
+/** A title from free text: only characters a launch can pass through safely. */
+export function sessionTitle(text) {
+    return (text
+        .replace(/[^A-Za-z0-9 ./_:,()-]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 60) || 'Roughbook');
+}
+/** The same session as a command to paste, for when no terminal can be opened. */
+export function manualCommand(platform, repoRoot, session) {
+    if (platform === 'win32') {
+        return `cd /d "${repoRoot}" && ${[session.command, ...session.args].map(part => `"${part}"`).join(' ')}`;
+    }
+    return `cd '${repoRoot}' && ${[session.command, ...session.args].map(part => `'${part}'`).join(' ')}`;
+}
+function problem(repoRoot, sessions) {
+    if (!sessions.length)
+        return 'Nothing to run.';
+    if (sessions.length > MAX_SESSIONS)
+        return `At most ${MAX_SESSIONS} sessions at once.`;
+    if (!SAFE_PATH.test(repoRoot)) {
+        return "The repo's path has characters that cannot be passed to a terminal safely.";
+    }
+    for (const session of sessions) {
+        if (!SAFE_PATH.test(session.command)) {
+            return "The agent's path has characters that cannot be passed to a terminal safely.";
+        }
+        if (!SAFE_TEXT.test(session.title) || !session.args.every(arg => SAFE_PATH.test(arg))) {
+            return 'A session has characters that cannot be passed to a terminal safely.';
+        }
+    }
+    return null;
+}
+/** Windows Terminal, when installed. Its launcher is an app alias, found by lstat. */
+export function findWindowsTerminal(env, probe = diskProbe) {
+    const candidates = [
+        env.LOCALAPPDATA ? path.win32.join(env.LOCALAPPDATA, 'Microsoft', 'WindowsApps', 'wt.exe') : '',
+        ...(env.PATH ?? env.Path ?? '')
+            .split(';')
+            .filter(Boolean)
+            .map(dir => path.win32.join(dir, 'wt.exe'))
+    ].filter(Boolean);
+    return candidates.find(candidate => probe.exists(candidate)) ?? null;
+}
+/** How each Linux terminal is told the folder and the program; most take xterm's -e. */
+function linuxArgs(terminal, repoRoot, session) {
+    const program = [session.command, ...session.args];
+    switch (path.posix.basename(terminal)) {
+        case 'gnome-terminal':
+            return ['--title', session.title, '--working-directory', repoRoot, '--', ...program];
+        case 'konsole':
+            return ['--workdir', repoRoot, '-e', ...program];
+        case 'kitty':
+            return ['--title', session.title, '--directory', repoRoot, ...program];
+        case 'alacritty':
+            return ['--title', session.title, '--working-directory', repoRoot, '-e', ...program];
+        case 'wezterm':
+            return ['start', '--cwd', repoRoot, '--', ...program];
+        default:
+            return ['-T', session.title, '-e', ...program];
+    }
+}
+const LINUX_TERMINALS = ['x-terminal-emulator', 'gnome-terminal', 'konsole', 'xterm'];
+/** A POSIX shell script that runs one session; every part was checked by SAFE_PATH. */
+export function sessionScript(repoRoot, session) {
+    const quoted = [session.command, ...session.args].map(part => `'${part}'`).join(' ');
+    return `#!/bin/sh\n# ${session.title}\ncd '${repoRoot}' || exit 1\nexec ${quoted}\n`;
+}
+export function planTerminal({ platform, env, repoRoot, sessions, probe = diskProbe }) {
+    const refused = problem(repoRoot, sessions);
+    if (refused)
+        return { kind: 'manual', reason: refused };
+    if (platform === 'win32') {
+        const wt = findWindowsTerminal(env, probe);
+        if (wt) {
+            // One new window, one tab per session. ";" separates Windows Terminal's own subcommands.
+            const args = ['-w', 'new'];
+            sessions.forEach((session, index) => {
+                if (index > 0)
+                    args.push(';');
+                args.push('new-tab', '--title', session.title, '-d', repoRoot, session.command, ...session.args);
+            });
+            return {
+                kind: 'spawn',
+                terminal: 'Windows Terminal',
+                launches: [{ command: wt, args, cwd: repoRoot }]
+            };
+        }
+        // One console window per session. `start` takes the title as its first quoted argument.
+        return {
+            kind: 'spawn',
+            terminal: 'a console window',
+            launches: sessions.map(session => ({
+                command: 'cmd.exe',
+                args: [
+                    `/d /s /c "start "${session.title}" /D "${repoRoot}" ${[session.command, ...session.args]
+                        .map(part => `"${part}"`)
+                        .join(' ')}"`
+                ],
+                cwd: repoRoot,
+                verbatim: true
+            }))
+        };
+    }
+    if (platform === 'darwin') {
+        const iterm = env.ROUGHBOOK_TERMINAL?.toLowerCase() === 'iterm';
+        return {
+            kind: 'scripts',
+            terminal: iterm ? 'iTerm' : 'Terminal',
+            app: iterm ? 'iTerm' : 'Terminal',
+            scripts: sessions.map(session => sessionScript(repoRoot, session))
+        };
+    }
+    if (platform === 'linux' || platform === 'freebsd' || platform === 'openbsd') {
+        const lookup = { env, platform, home: '', node: '', probe };
+        const chosen = env.TERMINAL?.trim();
+        const terminal = (chosen &&
+            (path.posix.isAbsolute(chosen)
+                ? probe.exists(chosen)
+                    ? chosen
+                    : null
+                : findOnPath(chosen, lookup))) ||
+            LINUX_TERMINALS.map(name => findOnPath(name, lookup)).find(Boolean) ||
+            null;
+        if (!terminal) {
+            return {
+                kind: 'manual',
+                reason: 'No terminal was found. Set TERMINAL, or run the command below yourself.'
+            };
+        }
+        return {
+            kind: 'spawn',
+            terminal: path.posix.basename(terminal),
+            launches: sessions.map(session => ({
+                command: terminal,
+                args: linuxArgs(terminal, repoRoot, session),
+                cwd: repoRoot
+            }))
+        };
+    }
+    return { kind: 'manual', reason: 'Opening a terminal is not supported on this system.' };
+}
+/** Resolves once the process has started; rejects if it could not. */
+function start(launch) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(launch.command, launch.args, {
+            cwd: launch.cwd,
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: false,
+            windowsVerbatimArguments: launch.verbatim ?? false
+        });
+        child.once('error', reject);
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+/** Starts the plan; the terminals belong to the designer from here. */
+export async function launchTerminal(plan) {
+    if (plan.kind === 'spawn') {
+        for (const launch of plan.launches)
+            await start(launch);
+    }
+    else if (plan.kind === 'scripts') {
+        const dir = await mkdtemp(path.join(os.tmpdir(), 'roughbook-launch-'));
+        for (const [index, script] of plan.scripts.entries()) {
+            const file = path.join(dir, `session-${index + 1}.command`);
+            await writeFile(file, script);
+            await chmod(file, 0o755);
+            await start({ command: 'open', args: ['-a', plan.app, file], cwd: dir });
+        }
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/launch/terminal.js.map

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

package/dist/launch/which.js

@@ -0,0 +1,59 @@
+import path from 'node:path';
+import { diskProbe } from './platform.js';
+function pathApi(platform) {
+    return platform === 'win32' ? path.win32 : path.posix;
+}
+/** The folders on PATH, in order. */
+export function pathDirs(env, platform) {
+    return (env.PATH ?? env.Path ?? '').split(platform === 'win32' ? ';' : ':').filter(Boolean);
+}
+/** A program on PATH by name, as an executable file (with .exe or .com on Windows). */
+export function findOnPath(name, lookup) {
+    const p = pathApi(lookup.platform);
+    const probe = lookup.probe ?? diskProbe;
+    const names = lookup.platform === 'win32' ? [`${name}.exe`, `${name}.com`] : [name];
+    for (const dir of pathDirs(lookup.env, lookup.platform)) {
+        for (const candidate of names) {
+            const file = p.join(dir, candidate);
+            if (probe.exists(file))
+                return file;
+        }
+    }
+    return null;
+}
+/**
+ * An npm-installed command: on Windows, the `.cmd` shim's package script run with Node; elsewhere
+ * the shim on PATH is itself executable, so findOnPath already found it.
+ */
+export function findNpmScript(name, npmPackage, script, lookup) {
+    if (lookup.platform !== 'win32')
+        return null;
+    const p = path.win32;
+    const probe = lookup.probe ?? diskProbe;
+    for (const dir of pathDirs(lookup.env, lookup.platform)) {
+        const target = p.join(dir, 'node_modules', ...npmPackage.split('/'), ...script.split('/'));
+        if (probe.exists(p.join(dir, `${name}.cmd`)) && probe.exists(target)) {
+            return { command: lookup.node, prefixArgs: [target], source: 'npm' };
+        }
+    }
+    return null;
+}
+/** `ROUGHBOOK_<NAME>_BIN`, when it names a file that exists. */
+export function fromEnv(variable, lookup) {
+    const explicit = lookup.env[variable]?.trim();
+    if (!explicit || !(lookup.probe ?? diskProbe).exists(explicit))
+        return null;
+    return { command: explicit, prefixArgs: [], source: variable };
+}
+/** Compares dotted version strings numerically: 2.1.286 > 2.1.9. */
+export function compareVersions(a, b) {
+    const left = a.split('.').map(part => Number.parseInt(part, 10) || 0);
+    const right = b.split('.').map(part => Number.parseInt(part, 10) || 0);
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const difference = (left[index] ?? 0) - (right[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+//# sourceMappingURL=which.js.map

package/dist/launch/which.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.js","sourceRoot":"","sources":["../../src/launch/which.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAkBtD,SAAS,OAAO,CAAC,QAAyB;IACxC,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;AACxD,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,QAAQ,CAAC,GAAsB,EAAE,QAAyB;IACxE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9F,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,UAAkB,EAClB,MAAc,EACd,MAAc;IAEd,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3F,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,MAAc;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACjE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/repo/diff.js

@@ -0,0 +1,26 @@
+/**
+ * The lines an edit takes out and puts in, in order, for showing a planned change. Not a minimal
+ * diff: lines are matched from both ends, and what lies between is shown as replaced.
+ */
+export function changedLines(before, after) {
+    const a = lines(before);
+    const b = lines(after);
+    let start = 0;
+    while (start < a.length && start < b.length && a[start] === b[start])
+        start++;
+    let endA = a.length;
+    let endB = b.length;
+    while (endA > start && endB > start && a[endA - 1] === b[endB - 1]) {
+        endA--;
+        endB--;
+    }
+    return { removed: a.slice(start, endA), added: b.slice(start, endB) };
+}
+/** A text's lines, without the empty one after a final newline. */
+function lines(text) {
+    const all = text.split(/\r?\n/);
+    if (all[all.length - 1] === '')
+        all.pop();
+    return all;
+}
+//# sourceMappingURL=diff.js.map

package/dist/repo/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/repo/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,KAAa;IAEb,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,CAAC,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,CAAC;IAC9E,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IACpB,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;QACnE,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;IACT,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,mEAAmE;AACnE,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/repo/framework.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { searchUp } from './root.js';
+/** Checked in this order, since a Next.js or Astro app may also list Vite. */
+const FRAMEWORKS = [
+    ['next', 'next'],
+    ['astro', 'astro'],
+    ['nuxt', 'nuxt'],
+    ['@sveltejs/kit', 'sveltekit'],
+    ['@remix-run/react', 'remix'],
+    ['react-router', 'react-router'],
+    ['vite', 'vite']
+];
+/**
+ * The app's framework and major version from package.json, such as `next-16`: what the link
+ * records, so ratings can be compared by setup. Null when none is recognized.
+ */
+export function detectFramework(repo) {
+    let pkg;
+    try {
+        pkg = JSON.parse(fs.readFileSync(path.join(repo, 'package.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    const deps = { ...pkg.devDependencies, ...pkg.dependencies };
+    const found = FRAMEWORKS.find(([dependency]) => typeof deps[dependency] === 'string');
+    if (!found)
+        return null;
+    const major = /(\d+)/.exec(deps[found[0]])?.[1];
+    return major ? `${found[1]}-${major}` : found[1];
+}
+/**
+ * The app `init` run from `start` means: the nearest folder upwards with a package.json, within
+ * the same git repo. `start` itself when there is none, for checkRepo to refuse.
+ */
+export function appRoot(start, home) {
+    return (searchUp(start, dir => fs.existsSync(path.join(dir, 'package.json')), home) ??
+        path.resolve(start));
+}
+//# sourceMappingURL=framework.js.map

package/dist/repo/framework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.js","sourceRoot":"","sources":["../../src/repo/framework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,8EAA8E;AAC9E,MAAM,UAAU,GAAyC;IACvD,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,eAAe,EAAE,WAAW,CAAC;IAC9B,CAAC,kBAAkB,EAAE,OAAO,CAAC;IAC7B,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,MAAM,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,GAAwF,CAAC;IAC7F,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,IAAa;IAClD,OAAO,CACL,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC;QAC3E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CACpB,CAAC;AACJ,CAAC"}

package/dist/repo/link.js

@@ -0,0 +1,28 @@
+import { readJson, writeJsonAtomic } from '../fs/json.js';
+import { LINK_FILE, roughPath, statePath } from './root.js';
+export async function readRepoLink(repoRoot) {
+    const link = await readJson(roughPath(repoRoot, LINK_FILE));
+    if (!link)
+        return null;
+    if (link.version !== 1 || !link.orgId || !link.project) {
+        throw new Error(`rough/${LINK_FILE} is not one this studio can read. Run roughbook init again.`);
+    }
+    return link;
+}
+/** Ensures the linked repo's link file reads, for commands that need its project. */
+export async function requireRepoLink(repoRoot) {
+    const link = await readRepoLink(repoRoot);
+    if (!link)
+        throw new Error('This repo is not linked. Run roughbook init.');
+    return link;
+}
+export function renderRepoLink(link) {
+    return `${JSON.stringify(link, null, 2)}\n`;
+}
+export async function readLocalLink(repoRoot) {
+    return readJson(statePath(repoRoot, 'link.json'));
+}
+export async function writeLocalLink(repoRoot, link) {
+    await writeJsonAtomic(statePath(repoRoot, 'link.json'), link);
+}
+//# sourceMappingURL=link.js.map

package/dist/repo/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/repo/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAmB5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAW,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,SAAS,SAAS,6DAA6D,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,OAAO,QAAQ,CAAY,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAe;IACpE,MAAM,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;AAChE,CAAC"}