roughbook 0.0.0-stage → 0.1.0

package/dist/commands/review.js.map

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

package/dist/commands/run.js

@@ -0,0 +1,147 @@
+import { parseArgs } from 'node:util';
+import { runTarget, terminalSessions } from '../agents/session.js';
+import { outboxFor } from '../api/outbox.js';
+import { manualCommand, planTerminal } from '../launch/terminal.js';
+import { localOrigin, readSettings } from '../config/settings.js';
+import { requireRepoLink } from '../repo/link.js';
+import { startRuns } from '../runs/lifecycle.js';
+import { requireApi } from './context.js';
+import { DEFAULT_DEV_URL, completeRun } from './done.js';
+import { chooseAgent, parseComponent } from './shared.js';
+/** What the designer asked for: new directions, a fork, or a refinement. */
+function runKind(values) {
+    const asked = [values.direction?.length, values.fork, values.refine].filter(Boolean).length;
+    if (asked !== 1) {
+        throw new Error('Say what to run: --direction "<idea>" (up to eight), --fork <iteration>, or --refine <iteration> --intent "<what to change>".');
+    }
+    if (values.direction?.length) {
+        if (values.direction.length > 8)
+            throw new Error('At most eight directions at once.');
+        return {
+            kind: 'generate',
+            directions: values.direction.map(direction => ({
+                direction,
+                ...(values.hypothesis ? { hypothesis: values.hypothesis } : {})
+            }))
+        };
+    }
+    if (values.fork)
+        return { kind: 'fork', parent: values.fork };
+    if (!values.intent)
+        throw new Error('A refinement needs --intent "<what to change>".');
+    return {
+        kind: 'refine',
+        parent: values.refine,
+        preset: values.preset ?? 'custom',
+        intent: values.intent,
+        ...(values.preserve ? { preserve: values.preserve } : {})
+    };
+}
+export const run = {
+    name: 'run',
+    summary: 'Start iterations with a coding agent, in a terminal or unattended',
+    usage: 'run <page>/<component> (--direction <idea>... | --fork <iteration> | --refine <iteration> --intent <text>) [--agent <id>] [--headless]',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { values, positionals } = parseArgs({
+            args,
+            allowPositionals: true,
+            options: {
+                direction: { type: 'string', multiple: true },
+                hypothesis: { type: 'string' },
+                fork: { type: 'string' },
+                refine: { type: 'string' },
+                intent: { type: 'string' },
+                preset: { type: 'string' },
+                preserve: { type: 'string' },
+                agent: { type: 'string' },
+                model: { type: 'string' },
+                headless: { type: 'boolean', default: false },
+                'dev-url': { type: 'string' },
+                'no-screenshots': { type: 'boolean', default: false }
+            }
+        });
+        const { page, component } = parseComponent(positionals[0]);
+        const kind = runKind(values);
+        const repoRoot = context.repoRoot;
+        const link = await requireRepoLink(repoRoot);
+        const { adapter, detection } = await chooseAgent(context, values.agent);
+        const model = values.model ?? null;
+        const executable = detection.executable;
+        if (values.headless && !detection.headless.ready)
+            throw new Error(detection.headless.reason);
+        const api = await requireApi(context);
+        const outbox = outboxFor(repoRoot);
+        // Decisions waiting in the outbox reach the server first, so this prompt remembers them.
+        await outbox.flush(api);
+        const request = {
+            page,
+            component,
+            agent: adapter.id,
+            mode: values.headless ? 'headless' : 'interactive',
+            ...kind
+        };
+        const runs = await startRuns(repoRoot, api, link, request, {
+            assetOrigin: localOrigin(await readSettings(context.configDir))
+        });
+        for (const item of runs) {
+            io.out(`${item.page}/${item.component}/${item.iteration}: ${item.promptFile}`);
+        }
+        if (values.headless) {
+            io.out(`Running ${adapter.name} unattended. Its output is summarized here.`);
+            const devUrl = values['dev-url'] ?? context.env.ROUGHBOOK_DEV_URL ?? DEFAULT_DEV_URL;
+            const finished = await Promise.all(runs.map(async (record) => {
+                const invocation = adapter.headless(runTarget(repoRoot, record, model), executable, context.env);
+                if ('refused' in invocation)
+                    throw new Error(invocation.refused);
+                const result = await context.runHeadless(adapter, invocation, {
+                    env: context.env,
+                    model,
+                    onEvent: event => {
+                        if (event.kind === 'file')
+                            io.out(`  ${record.iteration}: wrote ${event.name}`);
+                    }
+                });
+                if (result.error)
+                    io.err(`  ${record.iteration}: ${result.error}`);
+                return completeRun(context, api, outbox, link, record, {
+                    outcome: result.ok ? undefined : result.cancelled ? 'cancelled' : 'failed',
+                    usage: result.usage,
+                    devUrl,
+                    screenshots: !values['no-screenshots']
+                });
+            }));
+            return finished.every(item => item.outcome !== 'failed') ? 0 : 1;
+        }
+        const sessions = terminalSessions(adapter, executable, repoRoot, runs, model);
+        const plan = planTerminal({
+            platform: context.platform,
+            env: context.env,
+            repoRoot,
+            sessions
+        });
+        let opened = false;
+        if (plan.kind !== 'manual') {
+            try {
+                await context.launchTerminal(plan);
+                opened = true;
+                io.out(`Opened ${runs.length === 1 ? 'a session' : `${runs.length} sessions`} of ${adapter.name} in ${plan.terminal}.`);
+            }
+            catch (error) {
+                io.err(`${plan.terminal} could not be opened: ${error.message}`);
+            }
+        }
+        if (!opened) {
+            if (plan.kind === 'manual')
+                io.out(plan.reason);
+            io.out('Run each of these in a terminal:');
+            for (const session of sessions) {
+                io.out(`  ${manualCommand(context.platform, repoRoot, session)}`);
+            }
+        }
+        io.out('When the agent has finished, run roughbook done.');
+        return 0;
+    }
+};
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/shared.js

@@ -0,0 +1,81 @@
+import { ADAPTERS, adapterFor } from '../agents/index.js';
+import { readSettings } from '../config/settings.js';
+import { currentOs } from '../launch/platform.js';
+import { ITERATION, SLUG } from '../repo/preview.js';
+import { STUDIO_VERSION } from '../version.js';
+import { openApi } from './context.js';
+function badTarget(what, example) {
+    return new Error(`Name the ${what}, such as ${example}.`);
+}
+/** `<page>/<component>`. */
+export function parseComponent(text) {
+    const [page, component, ...rest] = (text ?? '').split('/');
+    if (!page || !component || rest.length || !SLUG.test(page) || !SLUG.test(component)) {
+        throw badTarget('component as <page>/<component>', 'homepage/hero');
+    }
+    return { page, component };
+}
+/** `<page>/<component>/<iteration>`. */
+export function parseIteration(text) {
+    const parts = (text ?? '').split('/');
+    const iteration = parts.pop() ?? '';
+    if (!ITERATION.test(iteration)) {
+        throw badTarget('iteration as <page>/<component>/iteration-NN', 'homepage/hero/iteration-02');
+    }
+    try {
+        return { ...parseComponent(parts.join('/')), iteration };
+    }
+    catch {
+        throw badTarget('iteration as <page>/<component>/iteration-NN', 'homepage/hero/iteration-02');
+    }
+}
+function isAgent(id) {
+    return ADAPTERS.some(adapter => adapter.id === id);
+}
+/**
+ * The agent to use: the one named, else this install's default, else the first one found. Refused
+ * when it is not installed, with the adapter's own advice.
+ */
+export async function chooseAgent(context, named) {
+    const wanted = named ?? (await readSettings(context.configDir)).defaultAgent ?? undefined;
+    if (wanted !== undefined) {
+        if (!isAgent(wanted)) {
+            throw new Error(`Unknown agent ${wanted}. Choose one of: ${ADAPTERS.map(item => item.id).join(', ')}.`);
+        }
+        const adapter = adapterFor(wanted);
+        const detection = await context.detect(adapter);
+        if (!detection.found)
+            throw new Error(adapter.notFound);
+        return { adapter, detection };
+    }
+    for (const adapter of ADAPTERS) {
+        const detection = await context.detect(adapter);
+        if (detection.found)
+            return { adapter, detection };
+    }
+    throw new Error(`No coding agent was found. ${ADAPTERS.map(adapter => adapter.notFound).join(' ')}`);
+}
+/** Tells the backend this studio's version and agents; quietly does nothing when it cannot. */
+export async function sendHeartbeat(context, detections) {
+    try {
+        const { api } = await openApi(context);
+        if (!api.signedIn)
+            return;
+        await api.heartbeat({
+            studioVersion: STUDIO_VERSION,
+            os: currentOs(context.platform),
+            agents: detections
+                .filter(item => item.found)
+                .map(item => ({
+                id: item.id,
+                version: item.version && /^[0-9A-Za-z.+-]{1,40}$/.test(item.version) ? item.version : null,
+                signedIn: item.signedIn,
+                headless: item.headless.ready
+            }))
+        });
+    }
+    catch {
+        // The heartbeat is a courtesy; the command's own work matters.
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/commands/start.js

@@ -0,0 +1,119 @@
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { DEFAULT_LOCAL_PORT, readSettings, saveSettings } from '../config/settings.js';
+import { loadPty } from '../launch/pty.js';
+import { requireRepoLink } from '../repo/link.js';
+import { createLocalServer } from '../server/app.js';
+import { newToken } from '../server/security.js';
+import { LocalStudio } from '../server/studio.js';
+import { requireApi } from './context.js';
+import { devUrl } from './done.js';
+const REGISTRY_EVERY_MS = 1500;
+const OUTBOX_EVERY_MS = 30_000;
+/** The built UI: beside the compiled commands in the package, or in dist/ when run from source. */
+export function findUiDir() {
+    const candidates = [
+        new URL('../ui/', import.meta.url),
+        new URL('../../dist/ui/', import.meta.url)
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (fs.existsSync(`${dir}index.html`))
+            return dir;
+    }
+    return null;
+}
+function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once('error', error => {
+            if (error.code === 'EADDRINUSE') {
+                reject(new Error(`Port ${port} is in use. Is roughbook start already running here? Choose another with --port.`));
+            }
+            else {
+                reject(error);
+            }
+        });
+        server.listen(port, '127.0.0.1', () => resolve());
+    });
+}
+function parsePort(text) {
+    const port = Number(text);
+    if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+        throw new Error('The port is a number from 1024 to 65535.');
+    }
+    return port;
+}
+export const start = {
+    name: 'start',
+    summary: 'Open the local UI: iterations, review, runs, Done and promote',
+    usage: 'start [--port <port>] [--dev-url <url>] [--no-open]',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { values } = parseArgs({
+            args,
+            options: {
+                port: { type: 'string' },
+                'dev-url': { type: 'string' },
+                'no-open': { type: 'boolean', default: false }
+            }
+        });
+        const repoRoot = context.repoRoot;
+        const link = await requireRepoLink(repoRoot);
+        const api = await requireApi(context);
+        const settings = await readSettings(context.configDir);
+        const saved = settings.localPort ?? DEFAULT_LOCAL_PORT;
+        const port = values.port ? parsePort(values.port) : saved;
+        const dev = devUrl(values['dev-url'], context.env);
+        const pty = loadPty(context.env);
+        const studio = new LocalStudio({
+            context: { ...context, repoRoot },
+            api,
+            link,
+            devUrl: dev,
+            port,
+            pty
+        });
+        const token = newToken();
+        const server = createLocalServer({
+            studio,
+            port,
+            token,
+            uiDir: findUiDir(),
+            devUrl: dev,
+            project: link.project
+        });
+        await listen(server, port);
+        if (port !== saved) {
+            // Iterations load their asset files from this address, so new prompts name it from now on.
+            await saveSettings(context.configDir, { localPort: port });
+            io.out(`New prompts name port ${port} for asset files; iterations made before use ${saved}.`);
+        }
+        const url = `http://127.0.0.1:${port}/#token=${token}`;
+        io.out(`Roughbook is open for ${link.project} at ${url}`);
+        io.out(`Iterations render through ${dev}; start the app's dev server there.`);
+        if (!pty.ok)
+            io.out(`Runs open in your own terminal: ${pty.reason}`);
+        io.out('Press Ctrl+C to stop.');
+        if (!values['no-open'] && !(await context.openUrl(url))) {
+            io.out('Open the address above in a browser.');
+        }
+        studio.keepRegistry();
+        void studio.flushOutbox();
+        void studio.heartbeat();
+        const timers = [
+            setInterval(() => studio.keepRegistry(), REGISTRY_EVERY_MS),
+            setInterval(() => void studio.flushOutbox(), OUTBOX_EVERY_MS)
+        ];
+        await context.waitForStop();
+        for (const timer of timers)
+            clearInterval(timer);
+        studio.close();
+        server.closeAllConnections();
+        await new Promise(resolve => server.close(resolve));
+        io.out('Stopped. Sessions in the built-in terminal were ended.');
+        return 0;
+    }
+};
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/status.js

@@ -0,0 +1,62 @@
+import { parseArgs } from 'node:util';
+import { ApiError, OfflineError } from '../api/errors.js';
+import { outboxFor } from '../api/outbox.js';
+import { readLocalLink, readRepoLink } from '../repo/link.js';
+import { openApi } from './context.js';
+export const status = {
+    name: 'status',
+    summary: 'Show the sign-in, the linked project and what is waiting to be sent',
+    usage: 'status',
+    needsRepo: false,
+    async run(args, context) {
+        const { io } = context;
+        parseArgs({ args, options: {} });
+        const { api, credentials } = await openApi(context);
+        io.out(`Server:     ${api.server}`);
+        let projects = null;
+        if (!credentials) {
+            io.out('Signed in:  no (run roughbook login)');
+        }
+        else {
+            try {
+                const me = await api.me();
+                io.out(`Signed in:  ${me.user.email}`);
+                projects = await api.projects();
+            }
+            catch (error) {
+                if (error instanceof OfflineError) {
+                    io.out(`Signed in:  ${credentials.signedInAs ?? 'yes'} (the server cannot be reached)`);
+                }
+                else if (error instanceof ApiError && error.status === 401) {
+                    io.out('Signed in:  no longer (run roughbook login)');
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        if (!context.repoRoot) {
+            io.out('Repo:       not in a linked repo');
+            return 0;
+        }
+        io.out(`Repo:       ${context.repoRoot}`);
+        const link = await readRepoLink(context.repoRoot);
+        if (link) {
+            const org = projects?.find(item => item.id === link.orgId);
+            const project = org?.projects.find(item => item.slug === link.project);
+            io.out(`Project:    ${project ? `${project.name} (${link.project})` : link.project}${org ? ` in ${org.name}` : ''}`);
+            io.out(`rough/:     ${link.roughCommitted ? 'committed to git' : 'not committed'}`);
+            if (!(await readLocalLink(context.repoRoot))) {
+                io.out('            not linked on this machine yet (run roughbook init)');
+            }
+        }
+        const outbox = outboxFor(context.repoRoot);
+        const pending = await outbox.pending();
+        const dropped = await outbox.dropped();
+        io.out(`Waiting:    ${pending.length ? `${pending.length} to send` : 'nothing to send'}`);
+        if (dropped.length)
+            io.out(`Refused:    ${dropped.length} the server would not accept`);
+        return 0;
+    }
+};
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/config/credentials.js

@@ -0,0 +1,17 @@
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
+import { readJson, writeJsonAtomic } from '../fs/json.js';
+export function credentialsFile(configDir) {
+    return path.join(configDir, 'credentials.json');
+}
+export async function readCredentials(configDir) {
+    return readJson(credentialsFile(configDir));
+}
+/** Readable by this user only, where the OS has file modes. */
+export async function saveCredentials(configDir, credentials) {
+    await writeJsonAtomic(credentialsFile(configDir), credentials, { mode: 0o600 });
+}
+export async function clearCredentials(configDir) {
+    await rm(credentialsFile(configDir), { force: true });
+}
+//# sourceMappingURL=credentials.js.map

package/dist/config/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/config/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAY1D,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,OAAO,QAAQ,CAAc,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,WAAwB;IAC/E,MAAM,eAAe,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,MAAM,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/config/server.js

@@ -0,0 +1,29 @@
+/**
+ * The backend the studio talks to until hosting is decided (the split plan's open question 1).
+ * `ROUGHBOOK_SERVER` or `roughbook login --server` chooses another.
+ */
+export const DEFAULT_SERVER = 'http://localhost:4000';
+const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
+/**
+ * A server's origin, checked: https, or plain http only to this machine, since every request
+ * carries the install token.
+ */
+export function normalizeServer(input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw new Error(`Not a server address: ${input}`);
+    }
+    const local = LOCAL_HOSTS.has(url.hostname) || url.hostname.endsWith('.localhost');
+    if (url.protocol !== 'https:' && !(url.protocol === 'http:' && local)) {
+        throw new Error(`Use https for ${url.host}; plain http is only for this machine.`);
+    }
+    return url.origin;
+}
+/** The first of the flag, the environment and the saved sign-in, else the default. */
+export function resolveServer(flag, env, saved) {
+    return normalizeServer(flag || env.ROUGHBOOK_SERVER || saved || DEFAULT_SERVER);
+}
+//# sourceMappingURL=server.js.map

package/dist/config/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/config/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACnF,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,IAAI,wCAAwC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAC3B,IAAwB,EACxB,GAAsB,EACtB,KAAyB;IAEzB,OAAO,eAAe,CAAC,IAAI,IAAI,GAAG,CAAC,gBAAgB,IAAI,KAAK,IAAI,cAAc,CAAC,CAAC;AAClF,CAAC"}

package/dist/config/settings.js

@@ -0,0 +1,21 @@
+import path from 'node:path';
+import { readJson, writeJsonAtomic } from '../fs/json.js';
+/** Where `roughbook start` serves the local UI when no port was chosen. */
+export const DEFAULT_LOCAL_PORT = 4848;
+const DEFAULTS = { defaultAgent: null, localPort: null };
+/** The local server's address, which prompts give agents for the asset files. */
+export function localOrigin(settings) {
+    return `http://127.0.0.1:${settings.localPort ?? DEFAULT_LOCAL_PORT}`;
+}
+export function settingsFile(configDir) {
+    return path.join(configDir, 'settings.json');
+}
+export async function readSettings(configDir) {
+    return { ...DEFAULTS, ...(await readJson(settingsFile(configDir))) };
+}
+export async function saveSettings(configDir, patch) {
+    const settings = { ...(await readSettings(configDir)), ...patch };
+    await writeJsonAtomic(settingsFile(configDir), settings);
+    return settings;
+}
+//# sourceMappingURL=settings.js.map

package/dist/config/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/config/settings.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG1D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAavC,MAAM,QAAQ,GAAa,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAEnE,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAAC,QAAqC;IAC/D,OAAO,oBAAoB,QAAQ,CAAC,SAAS,IAAI,kBAAkB,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAoB,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,KAAwB;IAC5E,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IAClE,MAAM,eAAe,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/config/userDir.js

@@ -0,0 +1,18 @@
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * Where the studio keeps the install token: the place each OS sets aside for an application's
+ * settings, outside every repo. `ROUGHBOOK_CONFIG_DIR` overrides it.
+ */
+export function userConfigDir(env = process.env, platform = process.platform, home = os.homedir()) {
+    if (env.ROUGHBOOK_CONFIG_DIR)
+        return path.resolve(env.ROUGHBOOK_CONFIG_DIR);
+    if (platform === 'win32') {
+        return path.win32.join(env.APPDATA || path.win32.join(home, 'AppData', 'Roaming'), 'Roughbook');
+    }
+    if (platform === 'darwin') {
+        return path.posix.join(home, 'Library', 'Application Support', 'Roughbook');
+    }
+    return path.posix.join(env.XDG_CONFIG_HOME || path.posix.join(home, '.config'), 'roughbook');
+}
+//# sourceMappingURL=userDir.js.map

package/dist/config/userDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userDir.js","sourceRoot":"","sources":["../../src/config/userDir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAAe,EAAE,CAAC,OAAO,EAAE;IAE3B,IAAI,GAAG,CAAC,oBAAoB;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC5E,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;AAC/F,CAAC"}

package/dist/fs/json.js

@@ -0,0 +1,44 @@
+import { randomBytes } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+/** A JSON file's value, or null when the file does not exist. */
+export async function readJson(file) {
+    let text;
+    try {
+        text = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    return JSON.parse(text);
+}
+/** Two-space JSON with `\n` line endings and a final newline, the same on every OS. */
+export function formatJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+const BUSY = new Set(['EPERM', 'EBUSY', 'EACCES']);
+/**
+ * Writes beside the file and renames over it, so a reader never sees half a file. Windows refuses
+ * the rename while another process has the file open, so it is retried for a moment.
+ */
+export async function writeJsonAtomic(file, value, options = {}) {
+    await mkdir(path.dirname(file), { recursive: true });
+    const temp = `${file}.${randomBytes(6).toString('hex')}.tmp`;
+    await writeFile(temp, formatJson(value), { mode: options.mode });
+    for (let attempt = 0;; attempt++) {
+        try {
+            await rename(temp, file);
+            return;
+        }
+        catch (error) {
+            if (attempt >= 10 || !BUSY.has(error.code ?? '')) {
+                await rm(temp, { force: true });
+                throw error;
+            }
+            await new Promise(resolve => setTimeout(resolve, 20 * (attempt + 1)));
+        }
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/fs/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/fs/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY;IAC5C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACpE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,KAAc,EACd,UAA6B,EAAE;IAE/B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,KAA+B,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC5E,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;AACH,CAAC"}