@marver-design/marver 0.16.1 → 0.17.0

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
 
+## 0.17.0 - 2026-09-04
+
+### Added
+
+- **Shots in batch.** `npx marver shot a b c`, `--scene <name>` or `--all` render many
+  frames as ONE operation: one headless browser, several frames at a time inside it
+  (`MARVER_SHOT_CONCURRENCY`, default up to 6 sized to the machine). `POST /api/shots`
+  and the jam inbox (`{"scene":...}`, `{"frames":[...]}`, `{"all":true}`) take the same
+  ask; every frame answers for itself (`results[]`, in the order asked). Measured on a
+  31-frame canvas: 65 s of one-at-a-time calls becomes 8 s; a 5-frame scene, 10 s
+  becomes 2 s; a single shot, 2.1 s becomes 1.05 s.
+- A capture that ran out of settle budget says so: `unsettled: true` and a note, instead
+  of a silently half-drawn PNG.
+
+### Fixed
+
+- **A shot's Chrome could outlive the server** - Ctrl-C, a closed terminal or `kill -9`
+  mid-shot left a headless copy of the user's own Chrome running for ever, and on macOS
+  such a ghost can swallow every link the machine opens. The browser is now driven over
+  Chrome's debugging pipe, so it dies with the server however the server dies, and none
+  exists between shots. The first `marver dev` after upgrading kills the ghosts and
+  removes the profiles earlier versions left in the temp dir.
+- Chrome starts and opens tabs several times faster: a stale `--disable-gpu` flag was
+  costing ~0.5 s per start and per tab.
+
 ## 0.16.1 - 2026-09-03
 
 ### Added

package/README.md

@@ -84,7 +84,7 @@ The trust boundary is hard: only comments written on the owner's machine trigger
 
 ## Working state
 
-The same glow, driven from the terminal. When your agent takes a request, it creates the frame files first, pins them on a board, and runs `npx marver work start <scene/frame ...>` - you see the work land on the canvas in seconds, watch it shimmer while subagents build in parallel, and see it settle on `work done`. Marks self-expire, so a crashed agent never leaves a frame glowing. And `npx marver shot <scene/frame> [--scale 4]` renders one frame headless to a PNG, so the agent can look at what it built before it says it is done - the same picture you get from the canvas's copy-as-image.
+The same glow, driven from the terminal. When your agent takes a request, it creates the frame files first, pins them on a board, and runs `npx marver work start <scene/frame ...>` - you see the work land on the canvas in seconds, watch it shimmer while subagents build in parallel, and see it settle on `work done`. Marks self-expire, so a crashed agent never leaves a frame glowing. And `npx marver shot --scene <scene>` (or `<scene/frame ...>`, `--all`; `[--scale 4]`) renders frames headless to PNGs - a whole scene in one browser, several frames at a time - so the agent can look at what it built before it says it is done - the same picture you get from the canvas's copy-as-image.
 
 ## Commands
 
@@ -97,7 +97,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
 | `npx marver share …` | The roster (owner): `add <who> [--role]` · `remove` · `block` / `unblock` · `general <mode>` · `list` · `requests` · `explain <who>` · `who` |
 | `npx marver comments …` | The agent's queue: `connect <url>` · `sync` · `list` · `reply` · `resolve` · `invite <email>` · `revoke <email>` |
 | `npx marver work …` | Working glow from the terminal: `start <scene/frame …>` · `done … \| --all` · `list` |
-| `npx marver shot <frame> [--scale 1-4]` | Render one frame headless and print the PNG path (needs `dev` running); 2x by default |
+| `npx marver shot <frame ...> \| --scene <name> \| --all [--scale 1-4] [--json]` | Render frames headless and print the PNG paths (needs `dev` running); a scene is one browser, several frames at a time; 2x by default |
 | `npx marver boards [--json]` | The sidebar as the files say it is: folders, boards in reading order with their title, `order` and description, the landing board |
 
 ## Shortcuts

package/dist/{build-B4yPgFNF.mjs → build-D_g53Bp2.mjs}

@@ -1,7 +1,7 @@
 import { i as ROUTE, n as NAME } from "./cli.mjs";
 import { a as listBoardFiles, d as flatten, f as isBoardName, n as checkBoardsDir, s as readRegistry, t as boardFields, u as buildTree } from "./boards-BmxcT3Lc.mjs";
 import { l as detectHost, n as scanFrames, s as loadConfig } from "./manifest-CaslQIAO.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-BeBGu3gH.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-D2msH1cj.mjs";
 import { cpSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -504,7 +504,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds) {
 	const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
 	for (const r of refs) {
 		if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
-		const { ensurePoster } = await import("./poster-CoyobbGW.mjs");
+		const { ensurePoster } = await import("./poster-BEjUcQP3.mjs");
 		const g = await ensurePoster(assetsDir, r.slice(0, -11));
 		if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
 		console.log(`  poster: rendered design/assets/${r} (${g.width}×${g.height})`);

package/dist/cli.mjs

@@ -71,7 +71,7 @@ cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "st
 	});
 });
 for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot reload, comments, Live Jam)"], ["canvas", "Start the local canvas - same as dev"]]) cli.command(name, desc).option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default 5199)").action(async (opts) => {
-	const { dev } = await import("./dev-DH2W7Ffw.mjs");
+	const { dev } = await import("./dev-LnIISva5.mjs");
 	let port;
 	if (opts.port !== void 0) {
 		const n = Number(opts.port);
@@ -81,7 +81,7 @@ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot
 	await dev(resolve$1(opts.root), port);
 });
 cli.command("build", "Static export → design/.dist (what ships comes from design/publish.json - publishing is default-closed)").option("--boards <names>", "Publish only these boards (comma-separated); overrides the publish policy").option("--all-boards", "Publish every board - the loud override for the default-closed policy").option("--embed-seeds", "Copy comment history INTO the web root (identifying - every event carries its author's email)").option("--root <dir>", "Host repo root", { default: "." }).action(async (opts) => {
-	const { buildSite } = await import("./build-B4yPgFNF.mjs");
+	const { buildSite } = await import("./build-D_g53Bp2.mjs");
 	try {
 		const boards = opts.boards === void 0 ? void 0 : typeof opts.boards === "string" ? opts.boards : "";
 		await buildSite(resolve$1(opts.root), boards, opts.allBoards === true, opts.embedSeeds === true);
@@ -135,10 +135,10 @@ cli.command("boards", "The sidebar as files: every folder and board in reading o
 		process.exit(1);
 	}
 });
-cli.command("shot <frame>", "Render one frame headless and print the PNG path (needs `dev` running)").option("--root <dir>", "Host repo root", { default: "." }).option("--theme <name>", "Theme to render (default: light)").option("--scale <n>", "Device pixels per CSS px, 1-4 (default: 2; 4 for print-quality stills)").action(async (frame, opts) => {
-	const { shotCommand } = await import("./shot-By1AItpD.mjs");
+cli.command("shot [...frames]", "Render frames headless and print the PNG paths (needs `dev` running): ids, --scene <name> or --all").option("--root <dir>", "Host repo root", { default: "." }).option("--scene <name>", "Every frame of one scene").option("--all", "Every frame of the canvas").option("--theme <name>", "Theme to render (default: light)").option("--scale <n>", "Device pixels per CSS px, 1-4 (default: 2; 4 for print-quality stills)").option("--json", "Print the results as JSON ({ results: [...] }) instead of paths").action(async (frames, opts) => {
+	const { shotCommand } = await import("./shot-BzQ0PXKH.mjs");
 	try {
-		await shotCommand(resolve$1(opts.root), frame, opts);
+		await shotCommand(resolve$1(opts.root), frames, opts);
 	} catch (err) {
 		console.error(`[${NAME}] ${err.message}`);
 		process.exit(1);

package/dist/{dev-DH2W7Ffw.mjs → dev-LnIISva5.mjs}

@@ -1,6 +1,6 @@
 import { n as NAME, r as PKG } from "./cli.mjs";
 import { l as detectHost, s as loadConfig } from "./manifest-CaslQIAO.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-BeBGu3gH.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-D2msH1cj.mjs";
 import { realpathSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -255,9 +255,14 @@ async function dev(root, portFlag) {
 	const port = typeof addr === "object" && addr ? addr.port : picked.port;
 	if (picked.fellBack) console.log(`\n  port ${desiredPort} is in use - serving "${projectName}" on ${port} instead`);
 	console.log(`\n  ${NAME} · ${projectName} → http://localhost:${port}/\n`);
+	setTimeout(async () => {
+		try {
+			await (await import("./shot-DlmTO8AF.mjs")).sweepGhosts((m) => console.log(`  ${m}`));
+		} catch {}
+	}, 0);
 	try {
 		const { staleManagedInstructions } = await import("./managed-HwHVNI3h.mjs");
-		const { installedVersion } = await import("./plugin-BeBGu3gH.mjs").then((n) => n.i);
+		const { installedVersion } = await import("./plugin-D2msH1cj.mjs").then((n) => n.i);
 		const stale = staleManagedInstructions(root);
 		if (stale.length) {
 			const shown = stale.slice(0, 4).join(", ") + (stale.length > 4 ? `, +${stale.length - 4} more` : "");

package/dist/{plugin-BeBGu3gH.mjs → plugin-D2msH1cj.mjs}

@@ -422,7 +422,7 @@ function apiMiddleware(root, opts = {}) {
 				};
 				const asPng = url.searchParams.get("format") === "png";
 				const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
-				const { shootFrame } = await import("./shot-z-d-zMzf.mjs");
+				const { shootFrame } = await import("./shot-DlmTO8AF.mjs");
 				const r = await shootFrame({
 					root,
 					viewports: opts.viewports ?? {},
@@ -441,6 +441,7 @@ function apiMiddleware(root, opts = {}) {
 					height: r.height,
 					scale: r.scale,
 					...r.truncated ? { truncated: true } : {},
+					...r.unsettled ? { unsettled: true } : {},
 					...r.note ? { note: r.note } : {}
 				};
 				if (!asPng) return json(res, 200, summary);
@@ -453,11 +454,46 @@ function apiMiddleware(root, opts = {}) {
 				});
 				return res.end(png);
 			}
+			if (path === "shots" && req.method === "POST") {
+				const { readDevInfo } = await import("./work-CLrmY-vQ.mjs");
+				const token = readDevInfo(root)?.token;
+				if (!ownerGated(req) && !(token && req.headers["x-mv-work"] === token)) return json(res, 403, { error: "forbidden" });
+				const raw = await readBody(req);
+				if (raw == null) return json(res, 400, { error: "body too large or unreadable" });
+				let parsed;
+				try {
+					parsed = JSON.parse(raw);
+				} catch {
+					return json(res, 400, { error: "malformed JSON" });
+				}
+				if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return json(res, 400, { error: "expected an object" });
+				const body = parsed;
+				const theme = body.theme === void 0 ? "light" : body.theme;
+				if (typeof theme !== "string" || !/^[a-z0-9-]+$/i.test(theme)) return json(res, 400, { error: "invalid theme" });
+				const scale = body.scale === void 0 ? void 0 : body.scale;
+				if (scale !== void 0 && !(Number.isInteger(scale) && scale >= 1 && scale <= 4)) return json(res, 400, { error: "invalid scale" });
+				const { resolveFrames, shootBatch } = await import("./shot-DlmTO8AF.mjs");
+				const sel = resolveFrames(root, body);
+				if (!sel.ok) return json(res, sel.status, { error: sel.error });
+				const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
+				try {
+					return json(res, 200, { results: await shootBatch({
+						root,
+						viewports: opts.viewports ?? {},
+						frames: sel.frames,
+						theme,
+						origin,
+						scale
+					}) });
+				} catch (err) {
+					return json(res, 503, { error: err.message });
+				}
+			}
 			if (path === "poster" && req.method === "GET") {
 				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
 				const src = url.searchParams.get("src") ?? "";
-				const { ensurePoster, isLocalClip } = await import("./poster-CoyobbGW.mjs");
-				const { isLocalAssetRef } = await import("./build-B4yPgFNF.mjs");
+				const { ensurePoster, isLocalClip } = await import("./poster-BEjUcQP3.mjs");
+				const { isLocalAssetRef } = await import("./build-D_g53Bp2.mjs");
 				if (!isLocalAssetRef(src) || !isLocalClip(src)) return json(res, 400, { error: "src must be a clip under design/assets/" });
 				const r = await ensurePoster(join(root, "design", "assets"), src);
 				if (!r.ok) return json(res, r.error.includes("does not exist") ? 404 : 503, { error: r.error });
@@ -982,23 +1018,68 @@ function marverPlugin(ctx) {
 					if (!existsSync(reqPath)) return;
 					inFlight.add(file);
 					setTimeout(async () => {
+						const base = file.replace(/\.request\.json$/, "");
+						const resultPath = join(inbox, `${base}.result.json`);
+						const claimed = join(inbox, `.${base}.${process.pid}.${Date.now().toString(36)}.claimed`);
+						try {
+							renameSync(reqPath, claimed);
+						} catch {
+							inFlight.delete(file);
+							return;
+						}
 						try {
+							const write = (r) => {
+								const tmp = join(inbox, `.${base}.${process.pid}.tmp`);
+								try {
+									writeFileSync(tmp, JSON.stringify(r, null, 2));
+									renameSync(tmp, resultPath);
+								} catch {
+									try {
+										rmSync(tmp, { force: true });
+									} catch {}
+								}
+							};
 							let spec;
 							try {
-								spec = JSON.parse(readFileSync(reqPath, "utf8"));
-							} catch {
+								spec = JSON.parse(readFileSync(claimed, "utf8"));
+								if (!spec || typeof spec !== "object" || Array.isArray(spec)) throw new Error("expected an object");
+							} catch (err) {
+								write({
+									ok: false,
+									error: `malformed request - ${err.message}`
+								});
+								return;
+							}
+							const theme = spec.theme === void 0 ? "light" : spec.theme;
+							if (typeof theme !== "string" || !/^[a-z0-9-]+$/i.test(theme)) {
+								write({
+									ok: false,
+									error: "invalid theme"
+								});
+								return;
+							}
+							const scale = spec.scale === void 0 ? void 0 : spec.scale;
+							if (scale !== void 0 && !(Number.isInteger(scale) && scale >= 1 && scale <= 4)) {
+								write({
+									ok: false,
+									error: "invalid scale"
+								});
+								return;
+							}
+							const ways = [
+								"frame",
+								"frames",
+								"scene",
+								"all"
+							].filter((k) => spec[k] !== void 0);
+							if (ways.length !== 1) {
+								write({
+									ok: false,
+									error: "name the frames one way: frame (an id), frames (an array of ids), scene (a name) or all (true)"
+								});
 								return;
 							}
-							const base = file.replace(/\.request\.json$/, "");
-							const resultPath = join(inbox, `${base}.result.json`);
-							const frameId = typeof spec.frame === "string" ? spec.frame : "";
-							const theme = typeof spec.theme === "string" ? spec.theme : "light";
 							const o = origin();
-							const write = (r) => {
-								try {
-									writeFileSync(resultPath, JSON.stringify(r, null, 2));
-								} catch {}
-							};
 							if (!o) {
 								write({
 									ok: false,
@@ -1006,18 +1087,55 @@ function marverPlugin(ctx) {
 								});
 								return;
 							}
-							const { shootFrame } = await import("./shot-z-d-zMzf.mjs");
-							write(await shootFrame({
-								root,
-								viewports: config.viewports,
-								frameId,
-								theme,
-								origin: o
-							}));
+							const { shootFrame, shootBatch, resolveFrames } = await import("./shot-DlmTO8AF.mjs");
+							if (ways[0] === "frame") {
+								if (typeof spec.frame !== "string") {
+									write({
+										ok: false,
+										error: "frame must be a frame id"
+									});
+									return;
+								}
+								write(await shootFrame({
+									root,
+									viewports: config.viewports,
+									frameId: spec.frame,
+									theme,
+									origin: o,
+									scale
+								}));
+								return;
+							}
+							const sel = resolveFrames(root, spec);
+							if (!sel.ok) {
+								write({
+									ok: false,
+									error: sel.error
+								});
+								return;
+							}
 							try {
-								rmSync(reqPath, { force: true });
-							} catch {}
+								write({
+									ok: true,
+									results: await shootBatch({
+										root,
+										viewports: config.viewports,
+										frames: sel.frames,
+										theme,
+										origin: o,
+										scale
+									})
+								});
+							} catch (err) {
+								write({
+									ok: false,
+									error: err.message
+								});
+							}
 						} finally {
+							try {
+								rmSync(claimed, { force: true });
+							} catch {}
 							inFlight.delete(file);
 						}
 					}, 60);

package/dist/{poster-CoyobbGW.mjs → poster-BEjUcQP3.mjs}

@@ -1,4 +1,4 @@
-import { capture, findChrome } from "./shot-z-d-zMzf.mjs";
+import { capture, t as findChrome } from "./shot-DlmTO8AF.mjs";
 import { constants, copyFileSync, existsSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, sep } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -52,15 +52,23 @@ html,body{margin:0;background:#000}#root video{display:block}
   setTimeout(function(){ if (!done && v.readyState >= 2) show() }, 4000);
 })();
 <\/script></body></html>`;
-/** Render `<clip>.poster.png` for a clip under design/assets/. Idempotent: an existing
-*  poster (authored or generated) is left alone. */
-async function ensurePoster(assetsDir, src) {
+/** Single-flight by output path: N frames of one batch referencing the same clip ask at the
+*  same moment, and each would otherwise pass the "exists" check and render the same poster. */
+const rendering = /* @__PURE__ */ new Map();
+function ensurePoster(assetsDir, src) {
+	const out = join(assetsDir, posterNameFor(src));
+	const live = rendering.get(out);
+	if (live) return live;
+	const run = ensurePosterNow(assetsDir, src, out).finally(() => rendering.delete(out));
+	rendering.set(out, run);
+	return run;
+}
+async function ensurePosterNow(assetsDir, src, out) {
 	if (!isLocalClip(src)) return {
 		ok: false,
 		error: `not a local clip: ${src}`
 	};
 	const clip = join(assetsDir, src);
-	const out = join(assetsDir, posterNameFor(src));
 	if (existsSync(out)) return {
 		ok: true,
 		path: out,

package/dist/shot-BzQ0PXKH.mjs

@@ -0,0 +1,86 @@
+import { n as NAME } from "./cli.mjs";
+import { readDevInfo } from "./work-CLrmY-vQ.mjs";
+//#region src/cli/shot.ts
+/**
+* `marver shot <scene/frame> [...]`, `--scene <name>`, `--all` - render frames headless and
+* print the PNG paths, one per line, in the order asked.
+*
+* The shell-ful agents' door into the same verify loop jam teaches: build, shoot, LOOK. One
+* frame goes through /api/shot; several, a scene or everything go through /api/shots as ONE
+* operation (one browser, several frames at a time), so shooting a scene costs about what
+* shooting a frame did. shot.ts (server) has the capture story.
+*/
+async function shotCommand(root, frames, opts) {
+	const usage = `${NAME} shot <scene/frame ...> | --scene <name> | --all  [--theme <name>] [--scale 1-4] [--json]`;
+	if ([
+		frames.length > 0,
+		!!opts.scene,
+		!!opts.all
+	].filter(Boolean).length !== 1) throw new Error(`name the frames, one way: ${usage}`);
+	const info = readDevInfo(root);
+	if (!info) throw new Error(`\`${NAME} dev\` is not running in this repo (design/.local/dev.json not found) - start it first.`);
+	const scale = opts.scale != null ? Number(opts.scale) : void 0;
+	const theme = opts.theme;
+	const single = frames.length === 1 && !opts.scene && !opts.all;
+	let res;
+	try {
+		if (single) {
+			const qs = new URLSearchParams({
+				frame: frames[0],
+				...theme ? { theme } : {},
+				...scale != null ? { scale: String(scale) } : {}
+			});
+			res = await fetch(`http://localhost:${info.port}/__mv/api/shot?${qs}`, { headers: { "x-mv-work": info.token } });
+		} else {
+			const sel = opts.all ? { all: true } : opts.scene ? { scene: opts.scene } : { frames };
+			res = await fetch(`http://localhost:${info.port}/__mv/api/shots`, {
+				method: "POST",
+				headers: {
+					"x-mv-work": info.token,
+					"content-type": "application/json"
+				},
+				body: JSON.stringify({
+					...sel,
+					...theme ? { theme } : {},
+					...scale != null ? { scale } : {}
+				})
+			});
+		}
+	} catch {
+		throw new Error(`could not reach \`${NAME} dev\` on port ${info.port} - is it still running?`);
+	}
+	const data = await res.json().catch(() => ({}));
+	if (!res.ok) throw new Error(data.error ?? `shot failed (${res.status})`);
+	const one = data;
+	const results = single ? [one.path ? {
+		frame: frames[0],
+		ok: true,
+		path: one.path,
+		width: one.width,
+		height: one.height,
+		scale: one.scale,
+		...one.truncated ? { truncated: true } : {},
+		...one.unsettled ? { unsettled: true } : {},
+		...one.note ? { note: one.note } : {}
+	} : {
+		frame: frames[0],
+		ok: false,
+		error: one.error ?? "shot failed"
+	}] : data.results ?? [];
+	if (opts.json) {
+		console.log(JSON.stringify({ results }, null, 2));
+		if (results.some((r) => !r.ok)) process.exitCode = 1;
+		return;
+	}
+	let failed = false;
+	for (const r of results) if (r.ok) {
+		console.log(r.path);
+		if (r.note) console.error(`${r.frame}: ${r.note}`);
+	} else {
+		failed = true;
+		console.error(`${r.frame}: ${r.error}`);
+	}
+	if (failed) process.exitCode = 1;
+}
+//#endregion
+export { shotCommand };