roughbook 0.0.0-stage → 0.1.0

package/dist/runs/promote.js

@@ -0,0 +1,185 @@
+// Promote, the studio's half: a selected local iteration becomes a production component in this
+// repo. The backend renders the prompt from the brief; the studio copies the assets the iteration
+// uses into the app's public folder and the approved copy beside the reference, fills in the
+// paths the server never sees, and hands the prompt to the designer's agent. Ported from roughbook
+// src/lib/delivery/promote.ts (v2-local). The studio never edits the app's code and never commits.
+import fs from 'node:fs';
+import path from 'node:path';
+import { iterationDir } from '../repo/preview.js';
+import { ROUGH_DIR } from '../repo/root.js';
+import { assertTarget } from './slots.js';
+import { assertRunId } from './store.js';
+const ASSET_URL = /\/api\/files\/(project\/([a-z0-9][a-z0-9-]*)|library)\/([A-Za-z0-9._%-]+)/g;
+const TEXT_FILE = /\.(tsx?|jsx?|css|json|md|svg)$/i;
+const FILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/** The project and library asset files an iteration's source refers to, each once. */
+export function referencedAssets(sources, projectSlug) {
+    const seen = new Map();
+    for (const source of sources) {
+        for (const match of source.matchAll(ASSET_URL)) {
+            const scope = match[1] === 'library' ? 'library' : 'project';
+            // Another project's files are not this client's to ship.
+            if (scope === 'project' && match[2] !== projectSlug)
+                continue;
+            let file;
+            try {
+                file = decodeURIComponent(match[3]);
+            }
+            catch {
+                continue;
+            }
+            if (FILE_NAME.test(file))
+                seen.set(`${scope}/${file}`, { scope, file });
+        }
+    }
+    return [...seen.values()];
+}
+export function pascalCase(text) {
+    const name = text
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map(part => part[0].toUpperCase() + part.slice(1))
+        .join('');
+    return /^[A-Za-z]/.test(name) ? name : `Section${name}`;
+}
+export function defaultComponentFile(componentsDir, componentName) {
+    return `${componentsDir}/${pascalCase(componentName)}.tsx`;
+}
+/** A component path inside the repo, outside rough/ and the public folder; the problem, or null. */
+export function checkTargetFile(file, publicDir) {
+    const normalized = file.replace(/\\/g, '/');
+    if (!/^[A-Za-z0-9_@()[\]./-]+\.(tsx|jsx)$/.test(normalized)) {
+        return 'The component file must be a .tsx or .jsx path inside the repo.';
+    }
+    if (normalized.startsWith('/') ||
+        /^[a-z]:/i.test(normalized) ||
+        normalized.split('/').includes('..')) {
+        return 'The component file must be a relative path inside the repo.';
+    }
+    if (normalized.startsWith(`${ROUGH_DIR}/`) || normalized.startsWith(`${publicDir}/`)) {
+        return 'The component cannot live in rough/ or the public folder.';
+    }
+    return null;
+}
+/** A folder inside the repo, relative with forward slashes, or null. */
+function repoFolder(text) {
+    const folder = text.replace(/\\/g, '/').replace(/^\.?\/+|\/+$/g, '');
+    if (!folder || folder.split('/').includes('..') || /^[a-z]:/i.test(folder))
+        return null;
+    return folder;
+}
+/** The server's prompt with this repo's paths in place of its stand-ins. */
+export function fillInPrompt(promotion, targetFile, publicDir) {
+    // Functions, so a "$" in a path is not read as a replacement pattern.
+    return promotion.prompt
+        .replaceAll(promotion.placeholders.targetFile, () => targetFile)
+        .replaceAll(promotion.placeholders.targetDir, () => path.posix.dirname(targetFile))
+        .replaceAll(promotion.placeholders.publicDir, () => publicDir);
+}
+export function promotePromptFile(page, component, promotionId) {
+    return `${ROUGH_DIR}/${page}/${component}/prompts/promote-${assertRunId(promotionId)}.md`;
+}
+function toDisk(repoRoot, relative) {
+    return path.join(repoRoot, ...relative.split('/'));
+}
+function textFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true }).flatMap(entry => {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            return textFiles(full);
+        return TEXT_FILE.test(entry.name) ? [full] : [];
+    });
+}
+export function findComponent(tree, page, component) {
+    const found = tree.pages
+        .find(item => item.slug === page)
+        ?.components.find(item => item.slug === component);
+    if (!found)
+        throw new Error(`${page}/${component} is not a component of ${tree.name}.`);
+    return found;
+}
+/** The iteration to promote: the one named, or the component's selected one. */
+export function iterationToPromote(component, named) {
+    if (named)
+        return named;
+    if (component.selectedIteration === null) {
+        throw new Error(`No iteration of ${component.name} is selected. Select one first, or name it with --iteration.`);
+    }
+    return `iteration-${String(component.selectedIteration).padStart(2, '0')}`;
+}
+/** The app's public folder: given, beside the App Router app's package.json, or the project's. */
+export function publicDirFor(repoRoot, link, tree, given) {
+    if (given !== undefined) {
+        const folder = repoFolder(given);
+        if (!folder)
+            throw new Error('The public folder must be a folder inside the repo.');
+        return folder;
+    }
+    if (link.appDir) {
+        let dir = toDisk(repoRoot, link.appDir);
+        while (dir.startsWith(repoRoot) && !fs.existsSync(path.join(dir, 'package.json'))) {
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+        const relative = path.relative(repoRoot, dir).split(path.sep).join('/');
+        if (!relative.startsWith('..'))
+            return relative ? `${relative}/public` : 'public';
+    }
+    return repoFolder(tree.delivery.publicDir) ?? 'public';
+}
+export async function preparePromotion(repoRoot, api, link, tree, options) {
+    const { page, component, iteration } = options;
+    assertTarget(page, component, iteration);
+    const record = findComponent(tree, page, component);
+    const folder = toDisk(repoRoot, iterationDir(page, component, iteration));
+    if (!fs.existsSync(path.join(folder, 'index.tsx'))) {
+        throw new Error(`${iterationDir(page, component, iteration)} has no index.tsx in this repo.`);
+    }
+    const publicDir = publicDirFor(repoRoot, link, tree, options.publicDir);
+    const targetFile = (options.targetFile ?? defaultComponentFile(tree.delivery.componentsDir, record.name)).replace(/\\/g, '/');
+    const problem = checkTargetFile(targetFile, publicDir);
+    if (problem)
+        throw new Error(problem);
+    if (fs.existsSync(toDisk(repoRoot, targetFile))) {
+        throw new Error(`${targetFile} already exists. Choose another file with --to; Roughbook never overwrites the app's code.`);
+    }
+    const sources = textFiles(folder).map(file => fs.readFileSync(file, 'utf8'));
+    const promotion = await api.promote(link.orgId, link.project, {
+        page,
+        component,
+        iteration,
+        assets: referencedAssets(sources, link.project)
+    });
+    const copied = [];
+    const missing = [...promotion.missingAssets];
+    for (const asset of promotion.assets) {
+        if (!FILE_NAME.test(asset.file))
+            continue;
+        const to = `${publicDir}/rough/${page}/${component}/${asset.file}`;
+        const bytes = await api.file(link.orgId, link.project, asset.scope, asset.file);
+        fs.mkdirSync(path.dirname(toDisk(repoRoot, to)), { recursive: true });
+        fs.writeFileSync(toDisk(repoRoot, to), bytes);
+        copied.push(to);
+    }
+    const workspace = `${ROUGH_DIR}/${page}/${component}`;
+    if (promotion.copyMarkdown !== null) {
+        fs.writeFileSync(toDisk(repoRoot, `${workspace}/copy.md`), promotion.copyMarkdown);
+    }
+    const promptFile = promotePromptFile(page, component, promotion.promotionId);
+    fs.mkdirSync(path.dirname(toDisk(repoRoot, promptFile)), { recursive: true });
+    fs.writeFileSync(toDisk(repoRoot, promptFile), fillInPrompt(promotion, targetFile, publicDir));
+    return {
+        promotionId: promotion.promotionId,
+        promptFile,
+        targetFile,
+        publicDir,
+        copied,
+        missing,
+        wroteCopy: promotion.copyMarkdown !== null
+    };
+}
+//# sourceMappingURL=promote.js.map

package/dist/runs/promote.js.map

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

package/dist/runs/pull.js

@@ -0,0 +1,182 @@
+// Sketch → local (decision 10 of the split plan): a web sketch becomes the starting point of a
+// local iteration, a fork whose parent is the sketch. The backend allocates the iteration and
+// sends the sketch's files; the studio writes them into rough/, points their asset URLs at its
+// own server, and says what the app still needs to render them. Nothing goes back up.
+import fs from 'node:fs';
+import path from 'node:path';
+import { ApiError } from '../api/errors.js';
+import { iterationDir, writePreviewRegistry } from '../repo/preview.js';
+import { assertTarget, iterationExists } from './slots.js';
+import { recordOwnWrites } from './snapshot.js';
+import { listRuns } from './store.js';
+/** A sketch's files as the backend's build allows them: a few folders deep, known types only. */
+const SKETCH_PATH = /^(?:[A-Za-z0-9][A-Za-z0-9._-]*\/){0,3}[A-Za-z0-9][A-Za-z0-9._-]*\.(?:tsx|ts|jsx|js|css|json|svg|png|jpe?g|gif|webp)$/;
+const CODE_FILE = /\.(?:tsx|ts|jsx|js)$/;
+const TEXT_FILE = /\.(?:tsx|ts|jsx|js|css|json|svg)$/;
+/** Far above what the backend allows a sketch, so only a broken answer is refused. */
+const MAX_FILES = 64;
+const MAX_BYTES = 8 * 1024 * 1024;
+/** What the backend's refusals mean here. */
+const REFUSALS = {
+    SKETCH_RUNNING: sketch => `${sketch} is still being made on the web. Pull it when it has finished.`,
+    SKETCH_HAS_NO_SOURCE: sketch => `${sketch} has no files to pull: its run did not finish.`,
+    ITERATION_IS_LOCAL: sketch => `${sketch} is a local iteration, not a web sketch. Fork it with roughbook run --fork.`,
+    ITERATION_NOT_FOUND: sketch => `There is no ${sketch} in this component.`
+};
+/**
+ * The sketch's asset URLs, which load beside the sandbox's page, made absolute on the studio's
+ * server, where local iterations load the project's and library's files.
+ */
+export function localAssetUrls(text, assetOrigin) {
+    return text.replace(/(["'`(])\/api\/files\/(project|library)\//g, (_match, before, scope) => `${before}${assetOrigin}/api/files/${scope}/`);
+}
+/** Every file the backend sent, checked before anything is written. */
+function checkFiles(files) {
+    if (!Array.isArray(files) || !files.length || files.length > MAX_FILES) {
+        throw new Error('The server sent a sketch this studio cannot write.');
+    }
+    let total = 0;
+    const seen = new Set();
+    for (const file of files) {
+        const { path: name, encoding, content } = file ?? {};
+        if (typeof name !== 'string' ||
+            !SKETCH_PATH.test(name) ||
+            seen.has(name.toLowerCase()) ||
+            (encoding !== 'utf8' && encoding !== 'base64') ||
+            typeof content !== 'string') {
+            throw new Error('The server sent a sketch file this studio will not write.');
+        }
+        seen.add(name.toLowerCase());
+        total += content.length;
+        if (total > MAX_BYTES)
+            throw new Error('The server sent a sketch larger than any it makes.');
+    }
+    return files;
+}
+/** The package an import names, or null for a relative or absolute one. */
+function packageOf(specifier) {
+    if (/^[./]/.test(specifier) || specifier.includes(':'))
+        return null;
+    const parts = specifier.split('/');
+    return specifier.startsWith('@') ? parts.slice(0, 2).join('/') : (parts[0] ?? null);
+}
+/** The packages code imports, each once, in the order they appear. */
+export function importedPackages(sources) {
+    const found = new Set();
+    const patterns = [
+        /\bfrom\s*["']([^"']+)["']/g,
+        /\bimport\s*["']([^"']+)["']/g,
+        /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g
+    ];
+    for (const source of sources) {
+        for (const pattern of patterns) {
+            for (const match of source.matchAll(pattern)) {
+                const name = packageOf(match[1]);
+                if (name)
+                    found.add(name);
+            }
+        }
+    }
+    return [...found];
+}
+/** The app's dependencies, or null when its package.json cannot be read. */
+function appDependencies(repoRoot) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8'));
+        return new Set([
+            ...Object.keys(pkg.dependencies ?? {}),
+            ...Object.keys(pkg.devDependencies ?? {})
+        ]);
+    }
+    catch {
+        return null;
+    }
+}
+/** How this app adds packages, from its lockfile. */
+export function installCommand(repoRoot, packages) {
+    if (!packages.length)
+        return null;
+    const has = (file) => fs.existsSync(path.join(repoRoot, file));
+    const tool = has('pnpm-lock.yaml')
+        ? 'pnpm add'
+        : has('yarn.lock')
+            ? 'yarn add'
+            : has('bun.lock') || has('bun.lockb')
+                ? 'bun add'
+                : 'npm install';
+    return `${tool} ${packages.join(' ')}`;
+}
+/** What the designer should do before the pulled iteration renders, in sentences. */
+export function pullAdvice(result) {
+    const lines = [];
+    if (result.missingPackages.length) {
+        const names = result.missingPackages.join(', ');
+        lines.push(`It imports ${names}, which this app does not list. Add ${result.missingPackages.length === 1 ? 'it' : 'them'} with: ${result.installCommand}`);
+    }
+    if (result.needsTailwind) {
+        lines.push('It is styled with Tailwind classes, and this app does not list tailwindcss, so it will render unstyled here.');
+    }
+    return lines;
+}
+/**
+ * Pulls a web sketch into rough/ as the component's next local iteration. Every path the server
+ * sends is checked first; an existing iteration is never written over.
+ */
+export async function pullSketch(repoRoot, api, link, target, options) {
+    const { page, component, sketch } = target;
+    assertTarget(page, component, sketch);
+    let pulled;
+    try {
+        pulled = await api.pullSketch(link.orgId, link.project, page, component, sketch);
+    }
+    catch (error) {
+        const refusal = error instanceof ApiError ? REFUSALS[error.code] : undefined;
+        throw refusal ? new Error(refusal(sketch)) : error;
+    }
+    assertTarget(page, component, pulled.iteration);
+    const files = checkFiles(pulled.files);
+    const folder = iterationDir(page, component, pulled.iteration);
+    if (iterationExists(repoRoot, page, component, pulled.iteration)) {
+        throw new Error(`${folder} already exists. An existing iteration is never written over.`);
+    }
+    const dir = path.join(repoRoot, ...folder.split('/'));
+    try {
+        for (const file of files) {
+            const to = path.join(dir, ...file.path.split('/'));
+            fs.mkdirSync(path.dirname(to), { recursive: true });
+            if (file.encoding === 'base64')
+                fs.writeFileSync(to, Buffer.from(file.content, 'base64'));
+            else {
+                const text = TEXT_FILE.test(file.path)
+                    ? localAssetUrls(file.content, options.assetOrigin)
+                    : file.content;
+                fs.writeFileSync(to, text.replace(/\r\n/g, '\n'));
+            }
+        }
+    }
+    catch (error) {
+        fs.rmSync(dir, { recursive: true, force: true });
+        throw error;
+    }
+    writePreviewRegistry(repoRoot);
+    // Runs going now did not write these, so their Done does not count them.
+    const open = (await listRuns(repoRoot)).filter(run => run.status === 'started');
+    await recordOwnWrites(repoRoot, open.map(run => run.runId), files.map(file => `${folder}/${file.path}`));
+    const code = files.filter(file => CODE_FILE.test(file.path) && file.encoding === 'utf8');
+    const dependencies = appDependencies(repoRoot);
+    const missingPackages = dependencies
+        ? importedPackages(code.map(file => file.content)).filter(name => !dependencies.has(name))
+        : [];
+    return {
+        iteration: pulled.iteration,
+        parent: pulled.parent,
+        folder,
+        files: files.map(file => file.path),
+        missingPackages,
+        installCommand: installCommand(repoRoot, missingPackages),
+        needsTailwind: dependencies !== null &&
+            !dependencies.has('tailwindcss') &&
+            code.some(file => /\bclassName\s*=/.test(file.content))
+    };
+}
+//# sourceMappingURL=pull.js.map

package/dist/runs/pull.js.map

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

package/dist/runs/reviews.js

@@ -0,0 +1,34 @@
+// Review decisions on local iterations: select, reject with a reason, a review with
+// observations, notes, or a status. They go to the backend through the outbox, so they are kept while offline and
+// reach the server before the next run asks for a prompt, which is where rejection memory works.
+import { iterationPath } from '../api/client.js';
+import { assertTarget } from './slots.js';
+function request(decision) {
+    switch (decision.kind) {
+        case 'select':
+            return { route: 'select', body: { reason: decision.reason ?? '' } };
+        case 'reject':
+            return {
+                route: 'reject',
+                body: { reason: decision.reason, ...(decision.why ? { why: decision.why } : {}) }
+            };
+        case 'review': {
+            const { kind: _kind, ...review } = decision;
+            return { route: 'reviews', body: review };
+        }
+        case 'notes': {
+            const { kind: _kind, ...notes } = decision;
+            return { route: 'feedback', body: notes };
+        }
+        case 'status':
+            return { route: 'status', body: { status: decision.status } };
+    }
+}
+/** Sends one decision with the server's answer, or queues it when the server cannot be reached. */
+export async function sendDecision(api, outbox, link, target, decision) {
+    assertTarget(target.page, target.component, target.iteration);
+    const { route, body } = request(decision);
+    const path = `${iterationPath(link.orgId, link.project, target.page, target.component, target.iteration)}/${route}`;
+    return outbox.send(api, path, body);
+}
+//# sourceMappingURL=reviews.js.map

package/dist/runs/reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/runs/reviews.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,kHAAkH;AAClH,iGAAiG;AACjG,OAAO,EAAE,aAAa,EAAoC,MAAM,kBAAkB,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB1C,SAAS,OAAO,CAAC,QAAkB;IACjC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC;QACtE,KAAK,QAAQ;YACX,OAAO;gBACL,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;aAClF,CAAC;QACJ,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC;YAC5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;YAC3C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAc,EACd,MAAc,EACd,IAAc,EACd,MAAoB,EACpB,QAAkB;IAElB,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,EAAE,CAAC;IACpH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/runs/slots.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ITERATION, SLUG, iterationDir } from '../repo/preview.js';
+import { ROUGH_DIR } from '../repo/root.js';
+import { assertRunId } from './store.js';
+/** What a new slot shows until its agent has written it. */
+export const PLACEHOLDER_INDEX = `export default function NotYetGenerated() {
+  return (
+    <div
+      style={{
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        minHeight: "100vh",
+        padding: "2rem",
+        textAlign: "center",
+        fontFamily: "system-ui, sans-serif",
+        color: "#5b6274",
+        background: "#f6f8fa",
+      }}
+    >
+      <p>Not yet generated. Your agent writes this iteration from its prompt in rough/.</p>
+    </div>
+  );
+}
+`;
+/** v2's placeholder, which named Claude Code; a repo it prepared may still have some. */
+const V2_PLACEHOLDER_LINE = 'Not yet generated. Paste the compiled prompt into Claude Code to fill this iteration.';
+export function isPlaceholder(text) {
+    const trimmed = text.trim();
+    return trimmed === PLACEHOLDER_INDEX.trim() || trimmed.includes(V2_PLACEHOLDER_LINE);
+}
+export function assertTarget(page, component, iteration) {
+    if (!SLUG.test(page) || !SLUG.test(component) || !ITERATION.test(iteration)) {
+        throw new Error(`Not an iteration: ${page}/${component}/${iteration}`);
+    }
+}
+/** Where a run's prompt is kept, repo-relative with forward slashes. Committed with rough/. */
+export function promptFile(page, component, runId) {
+    return `${ROUGH_DIR}/${page}/${component}/prompts/${assertRunId(runId)}.md`;
+}
+/** The one line every agent is given, whichever agent it is. */
+export function handoffLine(prompt) {
+    return `Follow the instructions in ${prompt}`;
+}
+function toDisk(repoRoot, relative) {
+    return path.join(repoRoot, ...relative.split('/'));
+}
+function filesIn(dir, base = dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true }).flatMap(entry => {
+        const full = path.join(dir, entry.name);
+        return entry.isDirectory() ? filesIn(full, base) : [path.relative(base, full)];
+    });
+}
+/** Whether an iteration's folder exists in rough/ with any file in it. */
+export function iterationExists(repoRoot, page, component, id) {
+    return filesIn(toDisk(repoRoot, iterationDir(page, component, id))).length > 0;
+}
+/**
+ * Makes a run's folder: the placeholder for a new direction, or a copy of the parent for a fork
+ * or refinement, which the agent then changes. An existing iteration is never written over.
+ */
+export function createSlot(repoRoot, slot) {
+    assertTarget(slot.page, slot.component, slot.iteration);
+    const relative = iterationDir(slot.page, slot.component, slot.iteration);
+    const dir = toDisk(repoRoot, relative);
+    if (filesIn(dir).length) {
+        throw new Error(`${relative} already exists. An existing iteration is never written over.`);
+    }
+    if (slot.parent) {
+        assertTarget(slot.page, slot.component, slot.parent);
+        const from = toDisk(repoRoot, iterationDir(slot.page, slot.component, slot.parent));
+        const files = filesIn(from);
+        if (!files.length) {
+            throw new Error(`${iterationDir(slot.page, slot.component, slot.parent)} is not in this repo, so it cannot be forked here.`);
+        }
+        for (const file of files) {
+            fs.mkdirSync(path.dirname(path.join(dir, file)), { recursive: true });
+            fs.copyFileSync(path.join(from, file), path.join(dir, file));
+        }
+    }
+    else {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'index.tsx'), PLACEHOLDER_INDEX);
+    }
+    return relative;
+}
+/** Writes a run's prompt beside its component, with `\n` line endings. */
+export function writePrompt(repoRoot, file, prompt) {
+    const target = toDisk(repoRoot, file);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, prompt.replace(/\r\n/g, '\n'));
+}
+//# sourceMappingURL=slots.js.map

package/dist/runs/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/runs/slots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;CAmBhC,CAAC;AAEF,yFAAyF;AACzF,MAAM,mBAAmB,GACvB,uFAAuF,CAAC;AAE1F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,KAAK,iBAAiB,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB;IAC7E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAa;IACvE,OAAO,GAAG,SAAS,IAAI,IAAI,IAAI,SAAS,YAAY,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;AAC9E,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,8BAA8B,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,MAAM,CAAC,QAAgB,EAAE,QAAgB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,IAAI,GAAG,GAAG;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY,EAAE,SAAiB,EAAE,EAAU;IAC3F,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,IAAmF;IAEnF,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,+DAA+D,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,oDAAoD,CAC5G,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAY,EAAE,MAAc;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}