videoclaw 3.0.0-alpha.1

package/dist/video/storyboard-grid.js

@@ -0,0 +1,231 @@
+import sharp from 'sharp';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, sep } from 'node:path';
+import { artifactPathFor, writeArtifact } from './artifact-store.js';
+import { VclawError } from './errors.js';
+import { resolveProjectWorkspace } from './workspace.js';
+const DEFAULT_WIDTH = 1920;
+const DEFAULT_HEIGHT = 1080;
+const FONT_FAMILY = "'Arial', 'Helvetica', sans-serif";
+export async function renderStoryboardGrid(options) {
+    const root = options.root ?? process.cwd();
+    const workspace = resolveProjectWorkspace(options.projectSlug, root);
+    const artifactPath = artifactPathFor(workspace, 'filmmaking-prompts');
+    if (!existsSync(artifactPath)) {
+        throw new VclawError('asset_not_found', `storyboard-grid requires artifacts/filmmaking-prompts.json. Run vclaw video filmmaking-prompts --project ${options.projectSlug} --write first.`, { artifactPath });
+    }
+    const width = options.width ?? DEFAULT_WIDTH;
+    const height = options.height ?? DEFAULT_HEIGHT;
+    if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+        throw new VclawError('invalid_video_format', `Storyboard-grid dimensions must be positive integers (got ${width}x${height}).`, { width, height });
+    }
+    const artifact = JSON.parse(await readFile(artifactPath, 'utf-8'));
+    const gridPrompt = artifact.storyboardGridPrompt;
+    const panels = gridPrompt?.panels ?? [];
+    if (panels.length === 0) {
+        throw new VclawError('asset_not_found', `storyboard-grid requires a storyboardGridPrompt with panels in artifacts/filmmaking-prompts.json (found ${panels.length}). Run vclaw video filmmaking-prompts --project ${options.projectSlug} --write first.`, { artifactPath, panelCount: panels.length });
+    }
+    // Layout from the artifact when present (variable panel counts), else derive a
+    // near-square grid so older 9-panel artifacts still render as 3×3.
+    const cols = gridPrompt?.cols ?? Math.ceil(Math.sqrt(panels.length));
+    const rows = gridPrompt?.rows ?? Math.ceil(panels.length / cols);
+    const outputPath = resolveOutputPath(workspace.projectDir, options.output);
+    const artifactReferencePath = artifactPathForOutput(workspace.projectDir, outputPath);
+    if (!options.dryRun) {
+        const panelImages = await loadPanelImages(workspace.projectDir, options.images, panels.length);
+        const png = await renderGridPng({
+            panels,
+            panelImages,
+            title: artifact.projectSlug,
+            width,
+            height,
+            rows,
+            cols,
+        });
+        await mkdir(dirname(outputPath), { recursive: true });
+        await sharp(png).png().toFile(outputPath);
+        await writeArtifact(workspace, 'filmmaking-prompts', markGridReady(artifact, artifactReferencePath));
+    }
+    return {
+        projectSlug: options.projectSlug,
+        outputPath,
+        artifactReferencePath,
+        artifactPath,
+        width,
+        height,
+        panelCount: panels.length,
+        dryRun: !!options.dryRun,
+    };
+}
+const IMAGE_MIME = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+/**
+ * Resolve up to `count` panel stills (panel order) to base64 `data:` URIs the
+ * SVG `<image>` cells embed directly. Missing/unreadable entries → `undefined`
+ * (that cell stays an empty placeholder). Re-encodes through sharp to a PNG so
+ * any odd source format renders reliably in the SVG rasterizer.
+ */
+async function loadPanelImages(projectDir, images, count) {
+    if (!images || images.length === 0)
+        return [];
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        const entry = images[i];
+        if (!entry) {
+            out.push(undefined);
+            continue;
+        }
+        const path = isAbsolute(entry) ? entry : join(projectDir, entry);
+        if (!existsSync(path)) {
+            out.push(undefined);
+            continue;
+        }
+        try {
+            const png = await sharp(await readFile(path)).png().toBuffer();
+            out.push(`data:image/png;base64,${png.toString('base64')}`);
+        }
+        catch {
+            out.push(undefined);
+        }
+    }
+    return out;
+}
+function resolveOutputPath(projectDir, output) {
+    if (!output)
+        return join(projectDir, 'assets', 'storyboard-grid.png');
+    return isAbsolute(output) ? output : join(projectDir, output);
+}
+function artifactPathForOutput(projectDir, outputPath) {
+    const rel = relative(projectDir, outputPath);
+    if (rel && !rel.startsWith('..') && !isAbsolute(rel)) {
+        return rel.split(sep).join('/');
+    }
+    return outputPath;
+}
+function markGridReady(artifact, gridPath) {
+    const gridSlot = ensureGridSlot(artifact.referenceMap, gridPath);
+    const issues = artifact.issues.filter((issue) => (issue.code !== 'storyboard-grid-pending'
+        && !(issue.code === 'reference-slot-pending' && issue.message.includes(gridSlot.slot))));
+    return {
+        ...artifact,
+        generatedAt: new Date().toISOString(),
+        referenceMap: artifact.referenceMap.map((slot) => (slot.slot === gridSlot.slot ? { ...slot, path: gridPath, status: 'ready' } : slot)),
+        seedancePackets: artifact.seedancePackets.map((packet) => ({
+            ...packet,
+            references: packet.references.map((reference) => (reference.slot === gridSlot.slot ? { ...reference, path: gridPath, status: 'ready' } : reference)),
+            warnings: packet.warnings.filter((warning) => !warning.includes(gridSlot.slot)),
+        })),
+        issues,
+    };
+}
+function ensureGridSlot(referenceMap, gridPath) {
+    const existing = referenceMap.find((slot) => slot.role === 'storyboard-grid');
+    if (existing)
+        return existing;
+    const slot = `@image${referenceMap.length + 1}`;
+    const created = {
+        slot,
+        role: 'storyboard-grid',
+        label: '9-panel storyboard grid',
+        path: gridPath,
+        status: 'ready',
+    };
+    referenceMap.push(created);
+    return created;
+}
+async function renderGridPng(input) {
+    const { rows, cols } = input;
+    const margin = Math.round(input.width * 0.028);
+    const gap = Math.round(input.width * 0.01);
+    const headerHeight = Math.round(input.height * 0.085);
+    const footerHeight = Math.round(input.height * 0.025);
+    const gridWidth = input.width - margin * 2;
+    const gridHeight = input.height - headerHeight - footerHeight - margin;
+    const cellWidth = Math.floor((gridWidth - gap * (cols - 1)) / cols);
+    const cellHeight = Math.floor((gridHeight - gap * (rows - 1)) / rows);
+    const panelNodes = input.panels.map((panel, index) => {
+        const col = index % cols;
+        const row = Math.floor(index / cols);
+        const x = margin + col * (cellWidth + gap);
+        const y = headerHeight + row * (cellHeight + gap);
+        return renderPanel(panel, x, y, cellWidth, cellHeight, index, input.panelImages?.[index]);
+    }).join('\n');
+    const title = escapeXml(input.title.replaceAll('-', ' ').toUpperCase());
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${input.width}" height="${input.height}">
+  <rect width="100%" height="100%" fill="#111317"/>
+  <rect x="0" y="0" width="${input.width}" height="${headerHeight}" fill="#f2efe6"/>
+  <text x="${margin}" y="${Math.round(headerHeight * 0.62)}" font-family="${FONT_FAMILY}" font-size="${Math.round(headerHeight * 0.32)}" font-weight="700" fill="#111317">${title}</text>
+  <text x="${input.width - margin}" y="${Math.round(headerHeight * 0.62)}" text-anchor="end" font-family="${FONT_FAMILY}" font-size="${Math.round(headerHeight * 0.22)}" font-weight="700" fill="#3d4a57">${input.panels.length}-PANEL STORYBOARD GRID</text>
+  ${panelNodes}
+</svg>`;
+    return sharp(Buffer.from(svg)).png().toBuffer();
+}
+function renderPanel(panel, x, y, width, height, index = 0, imageDataUri) {
+    const stripHeight = Math.round(height * 0.28);
+    const imageHeight = height - stripHeight;
+    const pad = Math.round(width * 0.045);
+    const titleSize = Math.max(18, Math.round(width * 0.045));
+    const bodySize = Math.max(16, Math.round(width * 0.034));
+    const noteSize = Math.max(13, Math.round(width * 0.026));
+    const lines = wrapWords(panel.beat, 46, 3);
+    const lineNodes = lines.map((line, index) => (`<text x="${x + pad}" y="${y + pad + titleSize + 28 + index * (bodySize + 7)}" font-family="${FONT_FAMILY}" font-size="${bodySize}" fill="#f6f3ea">${escapeXml(line)}</text>`)).join('\n');
+    const noteY = y + imageHeight + Math.round(stripHeight * 0.32);
+    // Image cell: embed the still (cover-fit, clipped to the rounded top) when one
+    // was provided for this panel, else the empty placeholder rect. When a still
+    // is present the beat text moves into a translucent caption band at the top so
+    // it stays legible over the image instead of overprinting it.
+    const hasImage = typeof imageDataUri === 'string' && imageDataUri.length > 0;
+    const clipId = `imgclip${index}`;
+    const imageCell = hasImage
+        ? `<clipPath id="${clipId}"><rect x="${x}" y="${y}" width="${width}" height="${imageHeight}" rx="10"/></clipPath>
+  <image clip-path="url(#${clipId})" x="${x}" y="${y}" width="${width}" height="${imageHeight}" preserveAspectRatio="xMidYMid slice" href="${imageDataUri}"/>
+  <rect clip-path="url(#${clipId})" x="${x}" y="${y}" width="${width}" height="${Math.round(titleSize * 2.4 + lines.length * (bodySize + 7))}" fill="#0b0d10" fill-opacity="0.55"/>`
+        : `<rect x="${x}" y="${y}" width="${width}" height="${imageHeight}" rx="10" fill="#242b33"/>`;
+    return `<g>
+  <rect x="${x}" y="${y}" width="${width}" height="${height}" rx="10" fill="#20252b" stroke="#f2efe6" stroke-width="3"/>
+  ${imageCell}
+  <rect x="${x}" y="${y + imageHeight}" width="${width}" height="${stripHeight}" fill="#f2efe6"/>
+  <text x="${x + pad}" y="${y + pad + titleSize}" font-family="${FONT_FAMILY}" font-size="${titleSize}" font-weight="800" fill="#f2efe6">PANEL ${panel.panel} ${escapeXml((panel.timecode ?? '').toUpperCase())}</text>
+  ${lineNodes}
+  <text x="${x + pad}" y="${noteY}" font-family="${FONT_FAMILY}" font-size="${noteSize}" font-weight="800" fill="#111317">CAM: ${escapeXml(panel.cam.toUpperCase())}</text>
+  <text x="${x + pad}" y="${noteY + noteSize + 7}" font-family="${FONT_FAMILY}" font-size="${noteSize}" font-weight="800" fill="#111317">MOVE: ${escapeXml(panel.move.toUpperCase())}</text>
+  <text x="${x + pad}" y="${noteY + (noteSize + 7) * 2}" font-family="${FONT_FAMILY}" font-size="${noteSize}" font-weight="800" fill="#111317">MOOD: ${escapeXml(panel.mood.toUpperCase())}</text>
+</g>`;
+}
+function wrapWords(value, maxChars, maxLines) {
+    const words = value.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = '';
+    for (const word of words) {
+        const next = current ? `${current} ${word}` : word;
+        if (next.length > maxChars && current) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = next;
+        }
+        if (lines.length === maxLines)
+            break;
+    }
+    if (current && lines.length < maxLines)
+        lines.push(current);
+    if (lines.length === maxLines && words.join(' ').length > lines.join(' ').length) {
+        lines[lines.length - 1] = `${lines[lines.length - 1].replace(/\s+\S+$/, '')}...`;
+    }
+    return lines;
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=storyboard-grid.js.map

package/dist/video/storyboard-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-grid.js","sourceRoot":"","sources":["../../src/video/storyboard-grid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AA8BzD,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CAClB,iBAAiB,EACjB,4GAA4G,OAAO,CAAC,WAAW,iBAAiB,EAChJ,EAAE,YAAY,EAAE,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,UAAU,CAClB,sBAAsB,EACtB,6DAA6D,KAAK,IAAI,MAAM,IAAI,EAChF,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAA8B,CAAC;IAChG,MAAM,UAAU,GAAG,QAAQ,CAAC,oBAAoB,CAAC;IACjD,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,iBAAiB,EACjB,2GAA2G,MAAM,CAAC,MAAM,mDAAmD,OAAO,CAAC,WAAW,iBAAiB,EAC/M,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAC5C,CAAC;IACJ,CAAC;IACD,+EAA+E;IAC/E,mEAAmE;IACnE,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEjE,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAEtF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/F,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC;YAC9B,MAAM;YACN,WAAW;YACX,KAAK,EAAE,QAAQ,CAAC,WAAW;YAC3B,KAAK;YACL,MAAM;YACN,IAAI;YACJ,IAAI;SACL,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,aAAa,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;QACV,qBAAqB;QACrB,YAAY;QACZ,KAAK;QACL,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAA2B;IACzC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,UAAkB,EAClB,MAA0C,EAC1C,KAAa;IAEb,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAkB,EAAE,MAA0B;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACtE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAkB,EAAE,UAAkB;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,aAAa,CACpB,QAAmC,EACnC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC/C,KAAK,CAAC,IAAI,KAAK,yBAAyB;WACrC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,wBAAwB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACvF,CAAC,CAAC;IACH,OAAO;QACL,GAAG,QAAQ;QACX,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAChD,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAClF,CAAC;QACF,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzD,GAAG,MAAM;YACT,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAC/C,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CACjG,CAAC;YACF,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SAChF,CAAC,CAAC;QACH,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,YAAuC,EACvC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAC9E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,IAAI,GAAG,SAAS,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAChD,MAAM,OAAO,GAA4B;QACvC,IAAI;QACJ,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,OAAO;KAChB,CAAC;IACF,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAQ5B;IACC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEtE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,YAAY,GAAG,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;QAClD,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,kDAAkD,KAAK,CAAC,KAAK,aAAa,KAAK,CAAC,MAAM;;6BAEvE,KAAK,CAAC,KAAK,aAAa,YAAY;aACpD,MAAM,QAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,kBAAkB,WAAW,gBAAgB,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,sCAAsC,KAAK;aACpK,KAAK,CAAC,KAAK,GAAG,MAAM,QAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,oCAAoC,WAAW,gBAAgB,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,sCAAsC,KAAK,CAAC,MAAM,CAAC,MAAM;IAC3N,UAAU;OACP,CAAC;IAEN,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAClB,KAAgC,EAChC,CAAS,EACT,CAAS,EACT,KAAa,EACb,MAAc,EACd,KAAK,GAAG,CAAC,EACT,YAAqB;IAErB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC3C,YAAY,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,GAAG,GAAG,SAAS,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,kBAAkB,WAAW,gBAAgB,QAAQ,oBAAoB,SAAS,CAAC,IAAI,CAAC,SAAS,CAC9K,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE/D,+EAA+E;IAC/E,6EAA6E;IAC7E,+EAA+E;IAC/E,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,UAAU,KAAK,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,QAAQ;QACxB,CAAC,CAAC,iBAAiB,MAAM,cAAc,CAAC,QAAQ,CAAC,YAAY,KAAK,aAAa,WAAW;2BACnE,MAAM,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,aAAa,WAAW,gDAAgD,YAAY;0BAC/H,MAAM,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,aAAa,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,wCAAwC;QAChL,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,KAAK,aAAa,WAAW,4BAA4B,CAAC;IAEhG,OAAO;aACI,CAAC,QAAQ,CAAC,YAAY,KAAK,aAAa,MAAM;IACvD,SAAS;aACA,CAAC,QAAQ,CAAC,GAAG,WAAW,YAAY,KAAK,aAAa,WAAW;aACjE,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,GAAG,GAAG,SAAS,kBAAkB,WAAW,gBAAgB,SAAS,4CAA4C,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3M,SAAS;aACA,CAAC,GAAG,GAAG,QAAQ,KAAK,kBAAkB,WAAW,gBAAgB,QAAQ,2CAA2C,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;aACtJ,CAAC,GAAG,GAAG,QAAQ,KAAK,GAAG,QAAQ,GAAG,CAAC,kBAAkB,WAAW,gBAAgB,QAAQ,4CAA4C,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;aACvK,CAAC,GAAG,GAAG,QAAQ,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,WAAW,gBAAgB,QAAQ,4CAA4C,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;KACrL,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,QAAgB,EAAE,QAAgB;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,MAAM;IACvC,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACjF,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/video/storyboard-markdown.d.ts

@@ -0,0 +1,62 @@
+import { type CharacterProfile } from './characters.js';
+import type { VideoCostEstimate } from './cost-estimate.js';
+import type { DirectorPreflightResult } from './director-preflight.js';
+import type { ReferenceSheetsArtifact, SceneCandidatesArtifact, SceneSelectionArtifact, VideoExecutionPlan } from './types.js';
+interface BriefArtifactForMarkdown {
+    title: string;
+    intent: string;
+    productionMode: 'storyboard' | 'director';
+    metadata?: {
+        targetRuntimeSeconds?: number;
+        genre?: string;
+        platform?: string;
+        style?: string;
+        colorGrading?: string;
+    };
+}
+interface StoryboardArtifactForMarkdown {
+    projectSlug: string;
+    productionMode: 'storyboard' | 'director';
+    scenes: Array<{
+        sceneIndex: number;
+        description: string;
+        scenePrompt?: {
+            imagePrompt?: string;
+            animationPrompt?: string;
+            cameraMove?: 'push-in' | 'pull-out' | 'tracking' | 'crane' | 'orbit' | 'static';
+            styleFooter?: string;
+        };
+        characters?: string[];
+        dialogue?: string;
+        durationSeconds?: number;
+    }>;
+}
+export declare function storyboardMarkdownPathFor(projectSlug: string, root?: string): string;
+export declare function isStoryboardApproved(env?: NodeJS.ProcessEnv): boolean;
+export declare function buildStoryboardMarkdown(input: {
+    projectSlug: string;
+    root?: string;
+    brief: BriefArtifactForMarkdown;
+    storyboard: StoryboardArtifactForMarkdown;
+    characterProfiles?: CharacterProfile[];
+    executionPlan: Pick<VideoExecutionPlan, 'executionProfile' | 'promptGuidance' | 'recommendedRouteId'>;
+    costEstimate?: VideoCostEstimate;
+    preflight?: DirectorPreflightResult;
+    referenceSheets?: ReferenceSheetsArtifact;
+    sceneCandidates?: SceneCandidatesArtifact;
+    sceneSelection?: SceneSelectionArtifact;
+    generatedAt?: string;
+}): string;
+export declare function writeStoryboardMarkdownReview(input: {
+    projectSlug: string;
+    root?: string;
+    executionPlan: Pick<VideoExecutionPlan, 'executionProfile' | 'promptGuidance' | 'recommendedRouteId'>;
+    costEstimate?: VideoCostEstimate;
+    preflight?: DirectorPreflightResult;
+    generatedAt?: string;
+}): Promise<{
+    markdownPath: string;
+    markdown: string;
+}>;
+export {};
+//# sourceMappingURL=storyboard-markdown.d.ts.map

package/dist/video/storyboard-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-markdown.d.ts","sourceRoot":"","sources":["../../src/video/storyboard-markdown.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,YAAY,GAAG,UAAU,CAAC;IAC1C,QAAQ,CAAC,EAAE;QACT,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,UAAU,6BAA6B;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,YAAY,GAAG,UAAU,CAAC;IAC1C,MAAM,EAAE,KAAK,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE;YACZ,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;YAChF,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AA0HD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,SAAgB,GAAG,MAAM,CAG3F;AAED,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGlF;AA6CD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,CAAC;IAChC,UAAU,EAAE,6BAA6B,CAAC;IAC1C,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,aAAa,EAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC,CAAC;IACtG,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAiKT;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC,CAAC;IACtG,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BtD"}

package/dist/video/storyboard-markdown.js

@@ -0,0 +1,332 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { artifactPathFor } from './artifact-store.js';
+import { listCharacterProfiles } from './characters.js';
+import { readReferenceSheetsArtifact } from './reference-sheet-store.js';
+import { sheetsCoveringScene } from './reference-sheets.js';
+import { readSceneCandidatesArtifact } from './scene-candidate-store.js';
+import { readSceneSelectionArtifact } from './scene-selection-store.js';
+import { resolveProjectWorkspace } from './workspace.js';
+function collectReferencedCharacters(storyboard) {
+    return [
+        ...new Set(storyboard.scenes
+            .flatMap((scene) => scene.characters ?? [])
+            .map((value) => value.trim())
+            .filter(Boolean)),
+    ];
+}
+function buildReferenceSheetsSectionLines(storyboard, artifact) {
+    if (!artifact || artifact.sheets.length === 0) {
+        return [];
+    }
+    const lines = [];
+    lines.push('## Reference sheets');
+    lines.push('');
+    lines.push('| Scene | Sheet | Type | Role(s) | Character |');
+    lines.push('|---|---|---|---|---|');
+    for (const [i, scene] of storyboard.scenes.entries()) {
+        const sceneIndex = typeof scene.sceneIndex === 'number' ? scene.sceneIndex : i;
+        const covering = sheetsCoveringScene(artifact, sceneIndex);
+        for (const sheet of covering) {
+            const roles = Array.from(new Set(sheet.references.map((ref) => ref.role))).join(', ') || '(none)';
+            const character = sheet.characterName ?? '(none)';
+            const sheetLabel = sheet.name
+                ? `${sheet.name} (${sheet.id})`
+                : sheet.id;
+            const refDetails = sheet.references
+                .map((ref) => ('gbRef' in ref ? `gb:${ref.gbRef.kind}:${ref.gbRef.id}` : ref.path))
+                .join(', ');
+            const sheetCell = refDetails ? `${sheetLabel} — ${refDetails}` : sheetLabel;
+            lines.push(`| ${sceneIndex + 1} | ${sheetCell} | ${sheet.type} | ${roles} | ${character} |`);
+        }
+    }
+    lines.push('');
+    return lines;
+}
+function buildCandidatesSectionLines(storyboard, candidates, selection) {
+    if (!candidates || candidates.scenes.length === 0)
+        return [];
+    const selectionByScene = new Map();
+    if (selection) {
+        for (const entry of selection.scenes) {
+            selectionByScene.set(entry.sceneIndex, entry);
+        }
+    }
+    const lines = [];
+    let sectionEmitted = false;
+    for (const [i, scene] of storyboard.scenes.entries()) {
+        const sceneIndex = typeof scene.sceneIndex === 'number' ? scene.sceneIndex : i;
+        const entry = candidates.scenes.find((s) => s.sceneIndex === sceneIndex);
+        if (!entry || entry.candidates.length === 0)
+            continue;
+        const sel = selectionByScene.get(sceneIndex);
+        const selectedId = sel?.selectedCandidateId ?? null;
+        const chain = sel?.chainFromPrev ?? false;
+        const reroll = sel?.rerollRequested ?? false;
+        if (!sectionEmitted) {
+            lines.push('## Candidates & selection');
+            lines.push('');
+            sectionEmitted = true;
+        }
+        lines.push(`### Scene ${sceneIndex} — candidates`);
+        lines.push('');
+        lines.push('| Take | Round | Status | Selected? |');
+        lines.push('|---|---|---|---|');
+        for (const candidate of entry.candidates) {
+            const marker = candidate.id === selectedId ? '✅' : '—';
+            lines.push(`| ${candidate.id} | ${candidate.generationRound} | ${candidate.status} | ${marker} |`);
+        }
+        lines.push('');
+        lines.push(`Chain from prev: ${chain ? 'yes' : 'no'}`);
+        lines.push(`Reroll requested: ${reroll ? 'yes' : 'no'}`);
+        lines.push('');
+    }
+    return lines;
+}
+function buildCharacterBindingLines(storyboard, profiles = []) {
+    const referenced = collectReferencedCharacters(storyboard);
+    if (referenced.length === 0) {
+        return [];
+    }
+    const profileMap = new Map();
+    for (const profile of profiles) {
+        profileMap.set(profile.id.toLowerCase(), profile);
+        profileMap.set(profile.name.toLowerCase(), profile);
+    }
+    const lines = [];
+    lines.push('## Character Bindings');
+    lines.push('');
+    lines.push('| Character | Go Bananas ID | Reference Assets |');
+    lines.push('|---|---:|---|');
+    for (const name of referenced) {
+        const profile = profileMap.get(name.toLowerCase());
+        const referenceAssets = profile?.referenceAssets?.length
+            ? profile.referenceAssets.join(', ')
+            : '(none)';
+        lines.push(`| ${name} | ${profile?.goBananasId ?? '—'} | ${referenceAssets} |`);
+    }
+    lines.push('');
+    return lines;
+}
+export function storyboardMarkdownPathFor(projectSlug, root = process.cwd()) {
+    const workspace = resolveProjectWorkspace(projectSlug, root);
+    return join(workspace.projectDir, 'storyboard.md');
+}
+export function isStoryboardApproved(env = process.env) {
+    const value = env.VIDEOCLAW_APPROVE_STORYBOARD?.trim().toLowerCase();
+    return value === '1' || value === 'true' || value === 'yes';
+}
+function shellQuote(value) {
+    return JSON.stringify(value);
+}
+function buildStoryboardReviewCommand(projectSlug, root) {
+    return [
+        'vclaw',
+        'video',
+        'storyboard-review',
+        '--project',
+        shellQuote(projectSlug),
+        '--root',
+        shellQuote(root),
+        '--mode',
+        'director',
+    ].join(' ');
+}
+function buildStoryboardApprovalCommand(projectSlug, root) {
+    return [
+        'VIDEOCLAW_APPROVE_STORYBOARD=1',
+        'vclaw',
+        'video',
+        'execute',
+        '--project',
+        shellQuote(projectSlug),
+        '--root',
+        shellQuote(root),
+        '--mode',
+        'director',
+    ].join(' ');
+}
+function buildVerifyEnvCommand(root) {
+    return [
+        'vclaw',
+        'video',
+        'verify-env',
+        '--root',
+        shellQuote(root),
+    ].join(' ');
+}
+export function buildStoryboardMarkdown(input) {
+    const generatedAt = input.generatedAt ?? new Date().toISOString();
+    const root = input.root ?? process.cwd();
+    const lines = [];
+    const runtimeSeconds = input.storyboard.scenes.reduce((sum, scene) => sum + (scene.durationSeconds ?? 0), 0);
+    lines.push(`# Storyboard Review - ${input.brief.title}`);
+    lines.push('');
+    lines.push(`Project: \`${input.projectSlug}\``);
+    lines.push(`Generated: ${generatedAt}`);
+    lines.push('');
+    lines.push('Review this storyboard before running director-mode execution.');
+    lines.push('');
+    lines.push('## Intent');
+    lines.push('');
+    lines.push('```');
+    lines.push(input.brief.intent);
+    lines.push('```');
+    lines.push('');
+    lines.push('## Production Settings');
+    lines.push('');
+    lines.push('| Field | Value |');
+    lines.push('|---|---|');
+    lines.push(`| Production mode | \`${input.storyboard.productionMode}\` |`);
+    lines.push(`| Genre | ${input.brief.metadata?.genre ?? '(none)'} |`);
+    lines.push(`| Platform | ${input.brief.metadata?.platform ?? '(none)'} |`);
+    lines.push(`| Style | ${input.brief.metadata?.style ?? '(none)'} |`);
+    lines.push(`| Color grading | ${input.brief.metadata?.colorGrading ?? '(none)'} |`);
+    lines.push(`| Recommended route | ${input.executionPlan.recommendedRouteId ?? '(none)'} |`);
+    lines.push(`| Aspect ratio | ${input.executionPlan.executionProfile.aspectRatio} |`);
+    lines.push(`| Quality | ${input.executionPlan.executionProfile.quality} |`);
+    lines.push(`| Resolution | ${input.executionPlan.executionProfile.resolution} |`);
+    lines.push(`| Audio | ${input.executionPlan.executionProfile.generateAudio ? 'on' : 'off'} |`);
+    lines.push(`| Outputs | ${input.executionPlan.executionProfile.outputCount} |`);
+    lines.push(`| Target runtime | ${input.brief.metadata?.targetRuntimeSeconds ? `${input.brief.metadata.targetRuntimeSeconds}s` : '(none)'} |`);
+    lines.push(`| Runtime | ${runtimeSeconds > 0 ? `${runtimeSeconds}s` : 'unspecified'} |`);
+    lines.push('');
+    if (input.costEstimate) {
+        lines.push('## Cost Estimate');
+        lines.push('');
+        lines.push('| Field | Value |');
+        lines.push('|---|---|');
+        lines.push(`| Scenes | ${input.costEstimate.sceneCount} |`);
+        lines.push(`| Clip duration | ${input.costEstimate.clipDurationSeconds}s |`);
+        lines.push(`| New characters | ${input.costEstimate.newCharacterCount} |`);
+        lines.push(`| Narration | ${input.costEstimate.narrationEnabled ? 'on' : 'off'} |`);
+        lines.push(`| Seedance | $${input.costEstimate.seedancePerSceneUsd.toFixed(2)} x ${input.costEstimate.sceneCount} = $${input.costEstimate.seedanceTotalUsd.toFixed(2)} |`);
+        lines.push(`| Gemini | $${input.costEstimate.geminiTotalUsd.toFixed(2)} |`);
+        lines.push(`| Go Bananas | $${input.costEstimate.goBananasTotalUsd.toFixed(2)} |`);
+        lines.push(`| ElevenLabs | $${input.costEstimate.elevenLabsTotalUsd.toFixed(2)} |`);
+        lines.push(`| Total | $${input.costEstimate.totalUsd.toFixed(2)} |`);
+        lines.push(`| Estimated wall time | ~${input.costEstimate.wallTimeMinutes} min |`);
+        lines.push('');
+    }
+    lines.push(...buildCharacterBindingLines(input.storyboard, input.characterProfiles));
+    lines.push(...buildReferenceSheetsSectionLines(input.storyboard, input.referenceSheets));
+    lines.push(...buildCandidatesSectionLines(input.storyboard, input.sceneCandidates, input.sceneSelection));
+    lines.push('## Scenes');
+    lines.push('');
+    for (const scene of input.storyboard.scenes) {
+        lines.push(`### Scene ${scene.sceneIndex + 1}`);
+        lines.push('');
+        lines.push(scene.description);
+        lines.push('');
+        if (scene.scenePrompt) {
+            lines.push('Prompt split:');
+            lines.push('');
+            if (scene.scenePrompt.imagePrompt) {
+                lines.push(`- Image prompt: ${scene.scenePrompt.imagePrompt}`);
+            }
+            if (scene.scenePrompt.animationPrompt) {
+                lines.push(`- Animation prompt: ${scene.scenePrompt.animationPrompt}`);
+            }
+            if (scene.scenePrompt.cameraMove) {
+                lines.push(`- Camera move: ${scene.scenePrompt.cameraMove}`);
+            }
+            if (scene.scenePrompt.styleFooter) {
+                lines.push(`- Style footer: ${scene.scenePrompt.styleFooter}`);
+            }
+            lines.push('');
+        }
+        if (scene.characters && scene.characters.length > 0) {
+            lines.push(`Characters: ${scene.characters.join(', ')}`);
+            lines.push('');
+        }
+        if (scene.dialogue) {
+            lines.push(`Dialogue: ${scene.dialogue}`);
+            lines.push('');
+        }
+        if (scene.durationSeconds !== undefined) {
+            lines.push(`Duration: ${scene.durationSeconds}s`);
+            lines.push('');
+        }
+    }
+    if (input.executionPlan.promptGuidance.length > 0) {
+        lines.push('## Prompt Guidance');
+        lines.push('');
+        for (const entry of input.executionPlan.promptGuidance) {
+            lines.push(`- ${entry.name}: ${entry.reason}`);
+        }
+        lines.push('');
+    }
+    if (input.preflight) {
+        lines.push('## Preflight');
+        lines.push('');
+        lines.push(`Pass: ${input.preflight.pass ? 'yes' : 'no'}`);
+        lines.push('');
+        if (input.preflight.errors.length > 0) {
+            lines.push('### Errors');
+            lines.push('');
+            for (const issue of input.preflight.errors) {
+                lines.push(`- [${issue.code}] ${issue.message}${issue.suggestion ? ` Suggestion: ${issue.suggestion}` : ''}`);
+            }
+            lines.push('');
+        }
+        if (input.preflight.warnings.length > 0) {
+            lines.push('### Warnings');
+            lines.push('');
+            for (const issue of input.preflight.warnings) {
+                lines.push(`- [${issue.code}] ${issue.message}${issue.suggestion ? ` Suggestion: ${issue.suggestion}` : ''}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push('## Approval');
+    lines.push('');
+    lines.push('Before approval, optionally sanity-check the runtime lane:');
+    lines.push('');
+    lines.push('```bash');
+    lines.push(buildVerifyEnvCommand(root));
+    lines.push('```');
+    lines.push('');
+    lines.push('If this storyboard is correct, run the approval command below:');
+    lines.push('');
+    lines.push('```bash');
+    lines.push(buildStoryboardApprovalCommand(input.projectSlug, root));
+    lines.push('```');
+    lines.push('');
+    lines.push('If the storyboard needs changes, refresh the review after adjusting the brief/storyboard artifacts:');
+    lines.push('');
+    lines.push('```bash');
+    lines.push(buildStoryboardReviewCommand(input.projectSlug, root));
+    lines.push('```');
+    lines.push('');
+    return lines.join('\n');
+}
+export async function writeStoryboardMarkdownReview(input) {
+    const root = input.root ?? process.cwd();
+    const workspace = resolveProjectWorkspace(input.projectSlug, root);
+    const briefPath = artifactPathFor(workspace, 'brief');
+    const storyboardPath = artifactPathFor(workspace, 'storyboard');
+    const brief = JSON.parse(await readFile(briefPath, 'utf-8'));
+    const storyboard = JSON.parse(await readFile(storyboardPath, 'utf-8'));
+    const characterProfiles = await listCharacterProfiles(workspace);
+    const referenceSheets = await readReferenceSheetsArtifact(workspace.root, input.projectSlug);
+    const sceneCandidates = await readSceneCandidatesArtifact(workspace.root, input.projectSlug);
+    const sceneSelection = await readSceneSelectionArtifact(workspace.root, input.projectSlug);
+    const markdown = buildStoryboardMarkdown({
+        projectSlug: input.projectSlug,
+        root,
+        brief,
+        storyboard,
+        characterProfiles,
+        executionPlan: input.executionPlan,
+        costEstimate: input.costEstimate,
+        preflight: input.preflight,
+        referenceSheets,
+        sceneCandidates,
+        sceneSelection,
+        generatedAt: input.generatedAt,
+    });
+    const markdownPath = storyboardMarkdownPathFor(input.projectSlug, root);
+    await writeFile(markdownPath, `${markdown}\n`);
+    return { markdownPath, markdown };
+}
+//# sourceMappingURL=storyboard-markdown.js.map