roughbook 0.0.0-stage → 0.1.0

package/dist/commands/init.js

@@ -0,0 +1,203 @@
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { confirm } from '../io.js';
+import { changedLines } from '../repo/diff.js';
+import { appRoot, detectFramework } from '../repo/framework.js';
+import { readLocalLink, readRepoLink, writeLocalLink } from '../repo/link.js';
+import { applyPrep, checkRepo, planPrep } from '../repo/prep.js';
+import { gitInit, writeScratch } from '../repo/scratch.js';
+import { openApi } from './context.js';
+/** The lines of an edit shown under it, at most this many. */
+const SHOWN_LINES = 12;
+async function chooseProject(api, io, options, existing) {
+    const editable = (await api.projects()).filter(org => org.role !== 'viewer');
+    if (!editable.length) {
+        throw new Error('You can only view your organizations. Ask an owner to make you an editor.');
+    }
+    const orgs = options.org ? editable.filter(org => org.id === options.org) : editable;
+    if (!orgs.length)
+        throw new Error(`You cannot edit an organization with the id ${options.org}.`);
+    const create = async (org, name) => {
+        const { slug } = await api.createProject(org.id, name);
+        io.out(`Created the project ${name} (${slug}) in ${org.name}.`);
+        return { orgId: org.id, orgName: org.name, slug, name };
+    };
+    const pickOrg = async () => {
+        if (orgs.length === 1)
+            return orgs[0];
+        io.out('Which organization is it for?');
+        orgs.forEach((org, index) => io.out(`  ${index + 1}. ${org.name}`));
+        const answer = await io.ask('Organization: ');
+        const org = answer === null ? undefined : orgs[Number(answer) - 1];
+        if (!org)
+            throw new Error('Pass --org <id> to choose the organization.');
+        return org;
+    };
+    if (options.new)
+        return create(await pickOrg(), options.new);
+    const all = orgs.flatMap(org => org.projects.map(project => ({
+        orgId: org.id,
+        orgName: org.name,
+        slug: project.slug,
+        name: project.name
+    })));
+    if (options.project) {
+        const matches = all.filter(choice => choice.slug === options.project);
+        if (matches.length === 1)
+            return matches[0];
+        if (!matches.length)
+            throw new Error(`No project ${options.project} that you can edit.`);
+        throw new Error(`Several organizations have a project ${options.project}. Add --org with one of: ${matches.map(choice => `${choice.orgId} (${choice.orgName})`).join(', ')}.`);
+    }
+    if (existing && !options.org) {
+        const linked = all.find(choice => choice.orgId === existing.orgId && choice.slug === existing.project);
+        if (linked)
+            return linked;
+        io.err('rough/roughbook.json names a project you cannot edit. Choose another.');
+    }
+    io.out('Which project does this repo work on?');
+    all.forEach((choice, index) => io.out(`  ${index + 1}. ${choice.name} (${choice.slug})${orgs.length > 1 ? ` in ${choice.orgName}` : ''}`));
+    io.out('  n. A new project');
+    const answer = await io.ask('Project: ');
+    if (answer === null) {
+        throw new Error('Pass --project <slug> or --new <name> when nobody can answer questions.');
+    }
+    if (/^n(ew)?$/i.test(answer)) {
+        const name = await io.ask('Name of the new project: ');
+        if (!name)
+            throw new Error('A new project needs a name.');
+        return create(await pickOrg(), name);
+    }
+    const chosen = all[Number(answer) - 1];
+    if (!chosen)
+        throw new Error(`There is no choice ${answer}.`);
+    return chosen;
+}
+function printPlan(io, plan) {
+    if (!plan.changes.length)
+        io.out(`${plan.repo} is ready. Nothing to change.`);
+    else
+        io.out(`Changes in ${plan.repo}:`);
+    for (const change of plan.changes) {
+        io.out(`  ${change.action === 'create' ? '+' : '~'} ${change.file}: ${change.summary}`);
+        if (change.action !== 'edit')
+            continue;
+        const before = plan.before[change.file] ?? '';
+        const { removed, added } = changedLines(before, change.after);
+        const lines = [
+            ...removed.map(line => `      - ${line}`),
+            ...added.map(line => `      + ${line}`)
+        ];
+        for (const line of lines.slice(0, SHOWN_LINES))
+            io.out(line);
+        if (lines.length > SHOWN_LINES)
+            io.out(`      … ${lines.length - SHOWN_LINES} more lines`);
+    }
+    for (const step of plan.manual)
+        io.out(`  ! By hand: ${step}`);
+}
+export const init = {
+    name: 'init',
+    summary: 'Link this repo to a Roughbook project and prepare it, showing every change first',
+    usage: 'init [--project <slug> | --new <name>] [--org <id>] [--commit | --no-commit] [--yes] [--scratch <dir>]',
+    needsRepo: false,
+    async run(args, context) {
+        const { io } = context;
+        const { values } = parseArgs({
+            args,
+            options: {
+                project: { type: 'string' },
+                new: { type: 'string' },
+                org: { type: 'string' },
+                commit: { type: 'boolean' },
+                'no-commit': { type: 'boolean' },
+                yes: { type: 'boolean', short: 'y' },
+                scratch: { type: 'string' }
+            }
+        });
+        if (values.commit && values['no-commit'])
+            throw new Error('Choose --commit or --no-commit.');
+        if (values.project && values.new)
+            throw new Error('Choose --project or --new.');
+        const { api, credentials } = await openApi(context);
+        if (!credentials)
+            throw new Error('Not signed in. Run roughbook login first.');
+        let repo;
+        if (values.scratch) {
+            repo = path.resolve(context.cwd, values.scratch);
+            writeScratch(repo);
+            io.out(`Created a Next.js app in ${repo}. Run npm install there before roughbook start.`);
+            if (await gitInit(repo))
+                io.out('Started a git repository there.');
+            else
+                io.out('git was not found, so no repository was started. rough/ needs git to be kept.');
+        }
+        else {
+            repo = context.repoRoot ?? appRoot(context.cwd);
+        }
+        const problems = checkRepo(repo);
+        if (problems.length) {
+            for (const problem of problems)
+                io.err(problem);
+            return 1;
+        }
+        const existing = await readRepoLink(repo).catch(() => null);
+        const choice = await chooseProject(api, io, values, existing);
+        let committed;
+        if (values.commit || values['no-commit'])
+            committed = Boolean(values.commit);
+        else if (existing)
+            committed = existing.roughCommitted;
+        else if (values.yes)
+            committed = true;
+        else {
+            committed = await confirm(io, 'Commit rough/ to git? It is the only record of your iterations.', true);
+        }
+        if (!committed) {
+            io.out('rough/ will be ignored by git, so nothing backs up its iterations.');
+        }
+        const plan = planPrep(repo, {
+            link: { version: 1, orgId: choice.orgId, project: choice.slug, roughCommitted: committed }
+        });
+        if (plan.problems.length) {
+            for (const problem of plan.problems)
+                io.err(problem);
+            return 1;
+        }
+        printPlan(io, plan);
+        if (plan.changes.length && !values.yes) {
+            const answer = await io.ask(`Apply ${plan.changes.length === 1 ? 'this change' : `these ${plan.changes.length} changes`}? [Y/n] `);
+            if (answer === null || (answer && !/^y(es)?$/i.test(answer))) {
+                io.out('Nothing was written. Run again with --yes to apply these changes.');
+                return answer === null ? 1 : 0;
+            }
+        }
+        const local = await readLocalLink(repo);
+        const sameLink = local?.installId === credentials.installId &&
+            existing?.orgId === choice.orgId &&
+            existing.project === choice.slug &&
+            existing.roughCommitted === committed;
+        let linkId = local?.linkId ?? null;
+        if (!sameLink || !linkId) {
+            const linked = await api.link(choice.orgId, {
+                project: choice.slug,
+                framework: detectFramework(repo),
+                roughCommitted: committed
+            });
+            linkId = linked.linkId;
+        }
+        applyPrep(plan);
+        await writeLocalLink(repo, {
+            linkId,
+            installId: credentials.installId,
+            linkedAt: new Date().toISOString()
+        });
+        io.out(`Linked to ${choice.name} (${choice.slug}) in ${choice.orgName}.`);
+        if (plan.changes.length) {
+            io.out(`Applied ${plan.changes.length} change${plan.changes.length === 1 ? '' : 's'}; review them with git diff.`);
+        }
+        io.out('Next, run roughbook start.');
+        return 0;
+    }
+};
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/login.js

@@ -0,0 +1,93 @@
+import { parseArgs } from 'node:util';
+import { ApiError, OfflineError } from '../api/errors.js';
+import { saveCredentials } from '../config/credentials.js';
+import { currentOs } from '../launch/platform.js';
+import { STUDIO_VERSION } from '../version.js';
+import { openApi } from './context.js';
+/** Consecutive unreachable polls before giving up. */
+const OFFLINE_TRIES = 5;
+export const login = {
+    name: 'login',
+    summary: 'Sign this machine in to Roughbook',
+    usage: 'login [--server <url>] [--no-browser]',
+    needsRepo: false,
+    async run(args, context) {
+        const { io } = context;
+        const { values } = parseArgs({
+            args,
+            options: { server: { type: 'string' }, 'no-browser': { type: 'boolean' } }
+        });
+        const { api, credentials } = await openApi(context, values.server);
+        if (credentials) {
+            try {
+                const me = await api.me();
+                io.out(`Signed in to ${api.server} as ${me.user.email} already.`);
+                io.out('Run roughbook logout first to sign in as someone else.');
+                return 0;
+            }
+            catch (error) {
+                // A token removed on the web: sign in afresh.
+                if (!(error instanceof ApiError && error.status === 401))
+                    throw error;
+            }
+        }
+        const anonymous = api.signedOut();
+        const login = await anonymous.startDeviceLogin({
+            studioVersion: STUDIO_VERSION,
+            os: currentOs()
+        });
+        io.out(`To sign in, open ${login.verificationUri} and enter this code:`);
+        io.out('');
+        io.out(`    ${login.userCode}`);
+        io.out('');
+        if (!values['no-browser'] && (await context.openUrl(login.verificationUriComplete))) {
+            io.out('Your browser should have opened the page.');
+        }
+        io.out('Waiting for you to approve it…');
+        let interval = login.interval * 1000;
+        let offline = 0;
+        const tries = Math.ceil(login.expiresIn / login.interval) + OFFLINE_TRIES;
+        for (let attempt = 0; attempt < tries; attempt++) {
+            await context.sleep(interval);
+            try {
+                const issued = await anonymous.pollDeviceLogin(login.deviceCode);
+                const me = await anonymous.withToken(issued.token).me();
+                await saveCredentials(context.configDir, {
+                    server: api.server,
+                    installId: issued.installId,
+                    token: issued.token,
+                    signedInAs: me.user.email,
+                    savedAt: new Date().toISOString()
+                });
+                io.out(`Signed in to ${api.server} as ${me.user.email}.`);
+                io.out('Next, run roughbook init in the repo you want to design in.');
+                return 0;
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    if (error.code === 'AUTHORIZATION_PENDING')
+                        continue;
+                    if (error.code === 'SLOW_DOWN') {
+                        interval += 5000;
+                        continue;
+                    }
+                    if (error.code === 'ACCESS_DENIED') {
+                        io.err('The sign-in was turned away. Run roughbook login to try again.');
+                        return 1;
+                    }
+                    if (error.code === 'EXPIRED_TOKEN') {
+                        io.err('The code expired before it was approved. Run roughbook login again.');
+                        return 1;
+                    }
+                    throw error;
+                }
+                if (error instanceof OfflineError && ++offline < OFFLINE_TRIES)
+                    continue;
+                throw error;
+            }
+        }
+        io.err('The code expired before it was approved. Run roughbook login again.');
+        return 1;
+    }
+};
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/logout.js

@@ -0,0 +1,34 @@
+import { parseArgs } from 'node:util';
+import { ApiError, OfflineError } from '../api/errors.js';
+import { clearCredentials } from '../config/credentials.js';
+import { openApi } from './context.js';
+export const logout = {
+    name: 'logout',
+    summary: 'Sign this machine out',
+    usage: 'logout',
+    needsRepo: false,
+    async run(args, context) {
+        const { io } = context;
+        parseArgs({ args, options: {} });
+        const { api, credentials } = await openApi(context);
+        if (!credentials) {
+            io.out('Not signed in.');
+            return 0;
+        }
+        try {
+            await api.logout();
+        }
+        catch (error) {
+            if (error instanceof OfflineError) {
+                io.err(`Could not reach ${api.server}. This machine has forgotten its sign-in, but the token works until you remove this studio in the web's settings.`);
+            }
+            else if (!(error instanceof ApiError && error.status === 401)) {
+                throw error;
+            }
+        }
+        await clearCredentials(context.configDir);
+        io.out('Signed out.');
+        return 0;
+    }
+};
+//# sourceMappingURL=logout.js.map

package/dist/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,uBAAuB;IAChC,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,KAAK;IAChB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO;QACrB,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;QACvB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,EAAE,CAAC,GAAG,CACJ,mBAAmB,GAAG,CAAC,MAAM,mHAAmH,CACjJ,CAAC;YACJ,CAAC;iBAAM,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1C,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;CACF,CAAC"}

package/dist/commands/promote.js

@@ -0,0 +1,105 @@
+import { parseArgs } from 'node:util';
+import { manualCommand, planTerminal, sessionTitle } from '../launch/terminal.js';
+import { requireRepoLink } from '../repo/link.js';
+import { findComponent, iterationToPromote, preparePromotion } from '../runs/promote.js';
+import { handoffLine } from '../runs/slots.js';
+import { requireApi } from './context.js';
+import { chooseAgent, parseComponent } from './shared.js';
+/** The agent's session that writes the real component from the promote prompt. */
+export function promoteSession(adapter, detection, repoRoot, target, prepared, model) {
+    const title = sessionTitle(`Promote ${target.componentName}`);
+    return {
+        title,
+        command: detection.executable.command,
+        args: [
+            ...detection.executable.prefixArgs,
+            ...adapter.interactiveArgs({
+                repoRoot,
+                targetFolder: `rough/${target.page}/${target.component}`,
+                promptFile: prepared.promptFile,
+                instruction: handoffLine(prepared.promptFile),
+                sessionId: prepared.promotionId,
+                model,
+                title
+            })
+        ]
+    };
+}
+export const promote = {
+    name: 'promote',
+    summary: 'Hand the selected iteration to your agent to write the real component',
+    usage: 'promote <page>/<component> [--iteration <id>] [--to <file>] [--public <folder>] [--agent <id>]',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { values, positionals } = parseArgs({
+            args,
+            allowPositionals: true,
+            options: {
+                iteration: { type: 'string' },
+                to: { type: 'string' },
+                public: { type: 'string' },
+                agent: { type: 'string' },
+                model: { type: 'string' }
+            }
+        });
+        const { page, component } = parseComponent(positionals[0]);
+        const repoRoot = context.repoRoot;
+        const link = await requireRepoLink(repoRoot);
+        const api = await requireApi(context);
+        const tree = await api.project(link.orgId, link.project);
+        const record = findComponent(tree, page, component);
+        const iteration = iterationToPromote(record, values.iteration);
+        const prepared = await preparePromotion(repoRoot, api, link, tree, {
+            page,
+            component,
+            iteration,
+            targetFile: values.to,
+            publicDir: values.public
+        });
+        io.out(`Promoting ${page}/${component}/${iteration} to ${prepared.targetFile}.`);
+        for (const file of prepared.copied)
+            io.out(`  Copied ${file}`);
+        if (prepared.wroteCopy)
+            io.out(`  Wrote the approved copy to rough/${page}/${component}/copy.md`);
+        for (const asset of prepared.missing) {
+            io.out(`  ! ${asset.file} is not in the ${asset.scope}; the prompt asks for a placeholder.`);
+        }
+        io.out(`  Prompt: ${prepared.promptFile}`);
+        const instruction = handoffLine(prepared.promptFile);
+        let session = null;
+        try {
+            const { adapter, detection } = await chooseAgent(context, values.agent);
+            session = promoteSession(adapter, detection, repoRoot, { page, component, componentName: record.name }, prepared, values.model ?? null);
+        }
+        catch (error) {
+            io.err(error.message);
+        }
+        if (!session) {
+            io.out(`Give your agent this instruction in the repo: ${instruction}`);
+            return 0;
+        }
+        const plan = planTerminal({
+            platform: context.platform,
+            env: context.env,
+            repoRoot,
+            sessions: [session]
+        });
+        if (plan.kind !== 'manual') {
+            try {
+                await context.launchTerminal(plan);
+                io.out(`Opened ${plan.terminal}. Review the diff when it is done; nothing is committed.`);
+                return 0;
+            }
+            catch (error) {
+                io.err(`${plan.terminal} could not be opened: ${error.message}`);
+            }
+        }
+        else {
+            io.out(plan.reason);
+        }
+        io.out(`Run this in a terminal: ${manualCommand(context.platform, repoRoot, session)}`);
+        return 0;
+    }
+};
+//# sourceMappingURL=promote.js.map

package/dist/commands/promote.js.map

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

package/dist/commands/pull.js

@@ -0,0 +1,45 @@
+import { parseArgs } from 'node:util';
+import { localOrigin, readSettings } from '../config/settings.js';
+import { requireRepoLink } from '../repo/link.js';
+import { pullAdvice, pullSketch } from '../runs/pull.js';
+import { requireApi } from './context.js';
+import { parseComponent, parseIteration } from './shared.js';
+export const pull = {
+    name: 'pull',
+    summary: 'Brings a web sketch into rough/ as a new local iteration, or lists what there is',
+    usage: 'pull <page>/<component>[/<sketch>]',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { positionals } = parseArgs({ args, allowPositionals: true, options: {} });
+        const named = positionals[0] ?? '';
+        const repoRoot = context.repoRoot;
+        const link = await requireRepoLink(repoRoot);
+        const api = await requireApi(context);
+        if (named.split('/').length < 3) {
+            const { page, component } = parseComponent(named);
+            const sketches = await api.sketches(link.orgId, link.project, page, component);
+            if (!sketches.length) {
+                io.out(`${page}/${component} has no web sketches to pull.`);
+                return 0;
+            }
+            io.out(`Web sketches of ${page}/${component}, newest first:`);
+            const width = Math.max(...sketches.map(sketch => sketch.id.length));
+            for (const sketch of sketches) {
+                const status = sketch.status === 'exploring' ? '' : ` (${sketch.status})`;
+                io.out(`  ${sketch.id.padEnd(width)}  ${sketch.name}${status}`);
+            }
+            io.out(`Pull one with roughbook pull ${page}/${component}/<sketch>.`);
+            return 0;
+        }
+        const { page, component, iteration } = parseIteration(named);
+        const pulled = await pullSketch(repoRoot, api, link, { page, component, sketch: iteration }, { assetOrigin: localOrigin(await readSettings(context.configDir)) });
+        const count = pulled.files.length;
+        io.out(`${page}/${component}/${pulled.iteration}: ${pulled.folder}, from the web sketch ${pulled.parent} (${count} file${count === 1 ? '' : 's'})`);
+        for (const line of pullAdvice(pulled))
+            io.out(line);
+        io.out(`Review it in roughbook start, or refine it: roughbook run ${page}/${component} --refine ${pulled.iteration} --intent "<what to change>"`);
+        return 0;
+    }
+};
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/revert.js

@@ -0,0 +1,39 @@
+import { parseArgs } from 'node:util';
+import { revertFile } from '../runs/snapshot.js';
+import { listRuns } from '../runs/store.js';
+import { parseIteration } from './shared.js';
+const SAID = {
+    restored: 'Put back as it was before the run.',
+    removed: 'Removed: the run created it.',
+    unchanged: 'Already as it was before the run.',
+    cannot: 'Cannot put it back: the studio kept no copy of it. Restore it from git or your editor.'
+};
+export const revert = {
+    name: 'revert',
+    summary: 'Put back a file a run changed outside its iteration',
+    usage: 'revert <page>/<component>/<iteration> <file>',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { positionals } = parseArgs({ args, allowPositionals: true, options: {} });
+        const target = parseIteration(positionals[0]);
+        const file = (positionals[1] ?? '').replace(/\\/g, '/');
+        if (!file)
+            throw new Error('Name the file to put back, as roughbook done listed it.');
+        const run = (await listRuns(context.repoRoot)).find(item => item.page === target.page &&
+            item.component === target.component &&
+            item.iteration === target.iteration &&
+            item.status === 'finished');
+        if (!run) {
+            throw new Error(`No finished run made ${positionals[0]}. Run roughbook done first.`);
+        }
+        // Only what the run was flagged for: anything else is the designer's own work.
+        if (!run.outOfScope.includes(file)) {
+            throw new Error(`${file} is not among the files ${positionals[0]}'s run changed outside it.`);
+        }
+        const result = await revertFile(context.repoRoot, run.runId, file);
+        io.out(`${file}: ${SAID[result]}`);
+        return result === 'cannot' ? 1 : 0;
+    }
+};
+//# sourceMappingURL=revert.js.map

package/dist/commands/revert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert.js","sourceRoot":"","sources":["../../src/commands/revert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,IAAI,GAAG;IACX,QAAQ,EAAE,oCAAoC;IAC9C,OAAO,EAAE,8BAA8B;IACvC,SAAS,EAAE,mCAAmC;IAC9C,MAAM,EAAE,wFAAwF;CACxF,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,qDAAqD;IAC9D,KAAK,EAAE,8CAA8C;IACrD,SAAS,EAAE,IAAI;IACf,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO;QACrB,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;QACvB,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAEtF,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAS,CAAC,CAAC,CAAC,IAAI,CAClD,IAAI,CAAC,EAAE,CACL,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;YACzB,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;YACnC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;YACnC,IAAI,CAAC,MAAM,KAAK,UAAU,CAC7B,CAAC;QACF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;QACvF,CAAC;QACD,+EAA+E;QAC/E,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2BAA2B,WAAW,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,QAAS,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;CACF,CAAC"}

package/dist/commands/review.js

@@ -0,0 +1,73 @@
+import { parseArgs } from 'node:util';
+import { outboxFor } from '../api/outbox.js';
+import { requireRepoLink } from '../repo/link.js';
+import { sendDecision } from '../runs/reviews.js';
+import { requireApi } from './context.js';
+import { parseIteration } from './shared.js';
+const DECISIONS = ['explore', 'refine', 'select', 'reject'];
+export const review = {
+    name: 'review',
+    summary: 'Select, reject or note observations on a local iteration',
+    usage: 'review <page>/<component>/<iteration> (--select [--reason <text>] | --reject <reason> [--why <text>] | --note <observation>...)',
+    needsRepo: true,
+    async run(args, context) {
+        const { io } = context;
+        const { values, positionals } = parseArgs({
+            args,
+            allowPositionals: true,
+            options: {
+                select: { type: 'boolean', default: false },
+                reason: { type: 'string' },
+                reject: { type: 'string' },
+                why: { type: 'string' },
+                note: { type: 'string', multiple: true },
+                decision: { type: 'string' }
+            }
+        });
+        const target = parseIteration(positionals[0]);
+        const asked = [values.select, values.reject !== undefined, Boolean(values.note?.length)];
+        if (asked.filter(Boolean).length !== 1) {
+            throw new Error('Choose one: --select, --reject "<reason>", or --note "<observation>".');
+        }
+        let decision;
+        if (values.select) {
+            decision = { kind: 'select', reason: values.reason };
+        }
+        else if (values.reject !== undefined) {
+            if (!values.reject.trim())
+                throw new Error('A rejection needs a reason; it teaches the next prompt.');
+            decision = { kind: 'reject', reason: values.reject, why: values.why };
+        }
+        else {
+            const wanted = values.decision;
+            if (wanted !== undefined && !DECISIONS.includes(wanted)) {
+                throw new Error(`--decision is one of ${DECISIONS.join(', ')}.`);
+            }
+            decision = {
+                kind: 'review',
+                observations: values.note,
+                ...(wanted ? { decision: wanted } : {}),
+                ...(values.reason ? { reason: values.reason } : {})
+            };
+        }
+        const repoRoot = context.repoRoot;
+        const result = await sendDecision(await requireApi(context), outboxFor(repoRoot), await requireRepoLink(repoRoot), target, decision);
+        if (result.status === 'queued') {
+            io.out('Saved in the outbox; it goes to the server when it can be reached.');
+            return 0;
+        }
+        if (decision.kind === 'select') {
+            // Selecting the selected iteration clears the selection, as on the web.
+            const iterations = Array.isArray(result.data)
+                ? result.data
+                : [];
+            const now = iterations.find(item => item.id === target.iteration)?.status;
+            io.out(now === 'selected' ? `${target.iteration} is selected.` : 'The selection is cleared.');
+        }
+        else {
+            io.out(decision.kind === 'reject' ? `${target.iteration} is rejected.` : 'Review saved.');
+        }
+        return 0;
+    }
+};
+//# sourceMappingURL=review.js.map