@marver-design/marver 0.15.0 → 0.16.0

package/dist/{dev-BxCmeU_H.mjs → dev-CdcIuhZJ.mjs}

@@ -1,6 +1,6 @@
 import { n as NAME, r as PKG } from "./cli.mjs";
-import { l as detectHost, s as loadConfig } from "./manifest-BzxSMoDB.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-DJyjmQeh.mjs";
+import { c as detectHost, o as loadConfig } from "./manifest-CpbsqQ_v.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-BXyezwfN.mjs";
 import { realpathSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -257,7 +257,7 @@ async function dev(root, portFlag) {
 	console.log(`\n  ${NAME} · ${projectName} → http://localhost:${port}/\n`);
 	try {
 		const { staleManagedInstructions } = await import("./managed-HwHVNI3h.mjs");
-		const { installedVersion } = await import("./plugin-DJyjmQeh.mjs").then((n) => n.i);
+		const { installedVersion } = await import("./plugin-BXyezwfN.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` : "");
@@ -295,7 +295,7 @@ async function dev(root, portFlag) {
 		});
 	}
 	if (config.jam) {
-		const { startJam } = await import("./daemon-DalgvoA9.mjs");
+		const { startJam } = await import("./daemon-Cb4JjpgL.mjs");
 		const jam = startJam(root, config.jam, (m) => console.log(m), (board) => server.ws.send("sh:jam-comment", { board }));
 		if (jam) {
 			const close = server.close.bind(server);

package/dist/{init-QKNi9gvF.mjs → init-BQIpIpIv.mjs}

@@ -1,8 +1,8 @@
 import { n as NAME } from "./cli.mjs";
-import { a as writeManifest, c as detectAgent, l as detectHost, o as DEFAULTS, r as scanFrames, u as readJson } from "./manifest-BzxSMoDB.mjs";
+import { a as DEFAULTS, c as detectHost, i as writeManifest, l as readJson, n as scanFrames, s as detectAgent } from "./manifest-CpbsqQ_v.mjs";
 import { MANAGED_PREFIX, enumerateInstructionTemplates, hashBody, managedFile, pkgDir } from "./managed-HwHVNI3h.mjs";
 import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
+import { basename, dirname, join, relative } from "node:path";
 //#region src/cli/init.ts
 /** Idempotent scaffolder: never overwrites existing files; every host-repo touch prints a diff. */
 function init(root, opts) {
@@ -221,7 +221,7 @@ function init(root, opts) {
 		created.push("design/scenes/demo/ (3 frames)");
 	}
 	if (host.tsconfigSweepsDesign) patchTsconfigExclude(root);
-	writeManifest(root, scanFrames(root));
+	writeManifest(root, scanFrames(root, { name: basename(root) }));
 	console.log(`\n${NAME} initialized (${opts.mode} mode). Created:`);
 	for (const f of created) console.log(`  + ${f}`);
 	if (host.router === "next") console.log(`\n  note: Next.js support is partial - frames render outside Next, so next/font, next/image and Server Components do not exist inside them (details in design/AGENTS.md).`);
@@ -540,6 +540,9 @@ const configTemplate = (mode, jamAgent) => `// ${NAME} config - OPTIONAL. Delete
 // relative imports need extensions, tsconfig paths are ignored here.
 export default {
   mode: ${JSON.stringify(mode)},
+  // One sentence on what this product is and for whom. It lands in design/manifest.json
+  // as the project's description - the first thing a new agent session reads.
+  // description: "Analytics for indie SaaS - the founder's Monday-morning read",
   // Device widths for frames and the Devices view. Rename, retune, or uncomment tv.
   viewports: {
     mobile: { width: 390, height: 844 },

package/dist/{manifest-BzxSMoDB.mjs → manifest-CpbsqQ_v.mjs}

@@ -1,8 +1,8 @@
 import { r as PKG, t as CONTENT_WIDTH } from "./cli.mjs";
+import { d as isBoardName, f as readDescription, i as listBoardFiles, l as buildTree, m as hash, n as checkBoardsDir, o as readRegistry, t as boardFields, u as flatten } from "./boards-BdG1TJwU.mjs";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { delimiter, isAbsolute, join, relative, sep } from "node:path";
 import { pathToFileURL } from "node:url";
-import { createHash } from "node:crypto";
 //#region src/server/detect.ts
 function readJson(file) {
 	try {
@@ -261,6 +261,7 @@ async function loadConfig(root) {
 			themes: Array.isArray(user.themes) && user.themes.length ? user.themes.map(String) : DEFAULTS.themes,
 			port: validPort(user.port) ?? DEFAULTS.port,
 			zoomSpeed: validZoom(user.zoomSpeed) ?? DEFAULTS.zoomSpeed,
+			description: readDescription(user.description),
 			share: {
 				branding: user.share?.branding !== false,
 				name: typeof user.share?.name === "string" ? user.share.name : void 0,
@@ -379,8 +380,8 @@ function extractMeta(src) {
 	if (!m) return {};
 	const body = m[1];
 	const pick = (key) => {
-		const r = new RegExp(`(?:^|[{,])\\s*${key}\\s*:\\s*(['"\`])([^'"\`]*)\\1`).exec(body);
-		return r ? r[2] : void 0;
+		const r = new RegExp(`(?:^|[{,])\\s*${key}\\s*:\\s*(?:'([^'\\n]*)'|"([^"\\n]*)"|\`([^\`\\n]*)\`)\\s*(?=[,}\\n]|$)`).exec(body);
+		return r ? r[1] ?? r[2] ?? r[3] : void 0;
 	};
 	const pickBool = (key) => {
 		const r = new RegExp(`(?:^|[{,])\\s*${key}\\s*:\\s*(true|false)\\b`).exec(body);
@@ -401,6 +402,8 @@ function extractMeta(src) {
 	if (intent) out.intent = intent;
 	const slide = pickBool("slide");
 	if (slide !== void 0) out.slide = slide;
+	const description = readDescription(pick("description"));
+	if (description) out.description = description;
 	return out;
 }
 /** Content-frame detection: LEXICAL by convention - the frame file itself imports
@@ -473,7 +476,63 @@ function walk(dir, out = []) {
 	}
 	return out;
 }
-function scanFrames(root) {
+/** A scene's description is the first non-blank line of its `_brief.md` (a leading `#`
+*  stripped, a YAML front-matter block skipped) - no new file. */
+function sceneBrief(root, scene) {
+	if (!scene) return {};
+	const rel = `design/scenes/${scene}/_brief.md`;
+	const abs = join(root, ...rel.split("/"));
+	if (!existsSync(abs)) return {};
+	let description;
+	try {
+		const lines = readFileSync(abs, "utf8").split(/\r?\n/).map((l) => l.trim());
+		let i = 0;
+		if (lines[0] === "---") {
+			i = lines.indexOf("---", 1) + 1;
+			if (i === 0) i = lines.length;
+		}
+		const line = lines.slice(i).find((l) => l);
+		description = readDescription(line?.replace(/^#+\s*/, ""));
+	} catch {}
+	return {
+		brief: rel,
+		...description ? { description } : {}
+	};
+}
+/** The sidebar as files say it is, for the manifest: folders in root order, boards in
+*  reading order with their folder and description. A boards dir we may not read (symlink)
+*  or a malformed registry yields nothing here - the API and the build say why; the
+*  orientation file must never fail to write. */
+function scanBoards(root) {
+	const dir = join(root, "design", "boards");
+	if (checkBoardsDir(root, dir)) return {};
+	const reg = readRegistry(dir);
+	if (reg.state === "malformed") return {};
+	const rows = listBoardFiles(dir).boards.map((b) => ({
+		name: b.name,
+		...boardFields(b.json, isBoardName)
+	}));
+	const tree = buildTree(rows, reg.folders);
+	const folderOf = /* @__PURE__ */ new Map();
+	for (const it of tree) if (it.kind === "folder") for (const b of it.boards) folderOf.set(b, it.name);
+	const folders = tree.filter((it) => it.kind === "folder").map((it) => ({
+		name: it.name,
+		...it.description ? { description: it.description } : {}
+	}));
+	const boards = flatten(tree).map((name) => {
+		const d = rows.find((r) => r.name === name)?.description;
+		return {
+			name,
+			...folderOf.has(name) ? { folder: folderOf.get(name) } : {},
+			...d ? { description: d } : {}
+		};
+	});
+	return {
+		...folders.length ? { folders } : {},
+		...boards.length ? { boards } : {}
+	};
+}
+function scanFrames(root, project) {
 	const design = join(root, "design");
 	const frames = [];
 	for (const base of ["scenes", "components"]) for (const abs of walk(join(design, base))) {
@@ -502,6 +561,7 @@ function scanFrames(root) {
 			if (meta.of) entry.variantGroup = meta.of;
 			if (meta.variant) entry.variant = meta.variant;
 			if (meta.slide) entry.slide = true;
+			if (meta.description) entry.description = meta.description;
 			const content = contentScan(src);
 			if (content || meta.intent) {
 				entry.intent = meta.intent ?? content.intent;
@@ -527,12 +587,19 @@ function scanFrames(root) {
 	inferVariantGroups(frames);
 	const sceneCounts = /* @__PURE__ */ new Map();
 	for (const f of frames) sceneCounts.set(f.scene, (sceneCounts.get(f.scene) ?? 0) + 1);
+	const scenes = [...sceneCounts.entries()].map(([name, n]) => ({
+		name,
+		frames: n,
+		...sceneBrief(root, name)
+	})).sort((a, b) => a.name.localeCompare(b.name));
 	return {
-		frames,
-		scenes: [...sceneCounts.entries()].map(([name, n]) => ({
-			name,
-			frames: n
-		})).sort((a, b) => a.name.localeCompare(b.name))
+		...project && (project.name || project.description) ? { project: {
+			...project.name ? { name: project.name } : {},
+			...project.description ? { description: project.description } : {}
+		} } : {},
+		...scanBoards(root),
+		scenes,
+		frames
 	};
 }
 /** Variant groups. A group = 2+ frames in one DIRECTORY whose basenames
@@ -614,6 +681,5 @@ function writeManifest(root, manifest) {
 	writeFileSync(file, next);
 	return true;
 }
-const hash = (s) => createHash("sha256").update(s).digest("hex");
 //#endregion
-export { writeManifest as a, detectAgent as c, toFrameId as i, detectHost as l, hash as n, DEFAULTS as o, scanFrames as r, loadConfig as s, affectedFrameIds as t, readJson as u };
+export { DEFAULTS as a, detectHost as c, writeManifest as i, readJson as l, scanFrames as n, loadConfig as o, toFrameId as r, detectAgent as s, affectedFrameIds as t };

package/dist/{plugin-DJyjmQeh.mjs → plugin-BXyezwfN.mjs}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { i as ROUTE, n as NAME, r as PKG } from "./cli.mjs";
+import { a as nodeExists, c as FOLDERS_FILE, f as readDescription, i as listBoardFiles, m as hash, n as checkBoardsDir, o as readRegistry, p as validateWire, r as isRegularFile, s as BOARD_NAME, t as boardFields } from "./boards-BdG1TJwU.mjs";
 import { n as localProfile, t as isConnected } from "./profile-BjAPAJSb.mjs";
-import { a as writeManifest, n as hash, r as scanFrames, t as affectedFrameIds } from "./manifest-BzxSMoDB.mjs";
-import { copyFileSync, existsSync, linkSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
+import { i as writeManifest, n as scanFrames, o as loadConfig, t as affectedFrameIds } from "./manifest-CpbsqQ_v.mjs";
+import { copyFileSync, existsSync, linkSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes } from "node:crypto";
 //#region src/server/api.ts
-const BOARD_NAME = /^[a-z0-9][a-z0-9-]*$/;
 const BODY_LIMIT = 1e6;
 const CSRF_MAX_AGE = 2592e3;
 /** Read one cookie value off the request. */
@@ -85,37 +85,18 @@ function contained(target, base) {
 }
 function apiMiddleware(root, opts = {}) {
 	const boardsDir = join(root, "design", "boards");
+	const foldersPath = join(boardsDir, FOLDERS_FILE);
 	const boardPath = (name) => {
-		if (!BOARD_NAME.test(name)) return null;
+		if (!validName(name)) return null;
+		if (checkBoardsDir(root, boardsDir)) return null;
 		mkdirSync(boardsDir, { recursive: true });
 		const p = resolve(boardsDir, `${name}.json`);
 		return contained(p, boardsDir) ? p : null;
 	};
 	const validName = (n) => typeof n === "string" && n.length >= 1 && n.length <= 64 && BOARD_NAME.test(n);
-	const underRoot = (dir) => {
-		try {
-			const rr = realpathSync(root);
-			const rd = realpathSync(dir);
-			return rd === rr || rd.startsWith(rr + sep);
-		} catch {
-			return false;
-		}
-	};
-	const notSymlink = (p) => {
-		try {
-			return !existsSync(p) || !lstatSync(p).isSymbolicLink();
-		} catch {
-			return false;
-		}
-	};
-	const nodeExists = (p) => {
-		try {
-			lstatSync(p);
-			return true;
-		} catch {
-			return false;
-		}
-	};
+	const dirError = () => checkBoardsDir(root, boardsDir);
+	const notSymlink = (p) => !nodeExists(p) || isRegularFile(p);
+	const nodeExists$1 = nodeExists;
 	try {
 		for (const f of readdirSync(boardsDir)) if (f.endsWith(".tmp")) rmSync(join(boardsDir, f), { force: true });
 	} catch {}
@@ -144,20 +125,24 @@ function apiMiddleware(root, opts = {}) {
 				return json(res, 200, { boards: {} });
 			}
 			if (path === "boards" && req.method === "GET") {
+				const de = dirError();
+				if (de) return json(res, 422, { error: de });
 				mkdirSync(boardsDir, { recursive: true });
-				return json(res, 200, readdirSync(boardsDir).filter((f) => f.endsWith(".json") && !f.endsWith(".tmp")).map((f) => {
-					const content = readFileSync(join(boardsDir, f), "utf8");
-					let order;
-					try {
-						const o = JSON.parse(content)?.order;
-						if (typeof o === "number" && Number.isFinite(o)) order = o;
-					} catch {}
-					return {
-						name: f.replace(/\.json$/, ""),
-						sha256: hash(content),
-						order
-					};
-				}));
+				return json(res, 200, listBoardFiles(boardsDir).boards.map((b) => ({
+					name: b.name,
+					sha256: b.sha256,
+					...boardFields(b.json, validName)
+				})));
+			}
+			if (path === "folders" && req.method === "GET") {
+				const de = dirError();
+				if (de) return json(res, 422, { error: de });
+				const reg = readRegistry(boardsDir);
+				if (reg.state === "malformed") return json(res, 422, { error: reg.error });
+				return json(res, 200, {
+					folders: reg.folders,
+					sha256: reg.sha256
+				});
 			}
 			if (path === "boards/rename" && req.method === "POST") {
 				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
@@ -173,21 +158,24 @@ function apiMiddleware(root, opts = {}) {
 				const { from, to } = parsed;
 				if (!validName(from) || !validName(to)) return json(res, 400, { error: "invalid board name" });
 				if (to === "all-scenes" || from === "all-scenes" || to === from) return json(res, 400, { error: "invalid rename" });
-				if (!underRoot(boardsDir)) return json(res, 400, { error: "boards directory escapes the project" });
+				{
+					const de = dirError();
+					if (de) return json(res, 400, { error: de });
+				}
 				const fromPath = boardPath(from), toPath = boardPath(to);
 				if (!fromPath || !toPath) return json(res, 400, { error: "invalid board name" });
 				if (!existsSync(fromPath)) return json(res, 404, { error: `board "${from}" does not exist` });
 				if (!notSymlink(fromPath)) return json(res, 400, { error: "refusing to rename a symlinked board file" });
 				if (isConnected(root)) return json(res, 409, { error: "disconnect before renaming boards - comment sync is board-keyed" });
 				if (existsSync(join(root, "design", "comments", `${from}.jsonl`))) return json(res, 409, { error: "rename a board before commenting on it - this board has threads" });
-				if (nodeExists(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
+				if (nodeExists$1(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
 				try {
 					linkSync(fromPath, toPath);
 				} catch (err) {
 					const code = err.code;
 					if (code === "EEXIST") return json(res, 409, { error: `a board named "${to}" already exists` });
 					if (code !== "EPERM" && code !== "ENOSYS" && code !== "ENOTSUP" && code !== "EOPNOTSUPP") throw err;
-					if (nodeExists(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
+					if (nodeExists$1(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
 					renameSync(fromPath, toPath);
 					return json(res, 200, { name: to });
 				}
@@ -205,25 +193,104 @@ function apiMiddleware(root, opts = {}) {
 					return json(res, 400, { error: "malformed JSON" });
 				}
 				if (!parsed || typeof parsed !== "object") return json(res, 400, { error: "expected an object" });
-				const order = parsed.order;
-				if (!Array.isArray(order) || order.length < 1 || order.length > 200) return json(res, 400, { error: "invalid order" });
-				if (!order.every(validName) || order.some((n) => n === "all-scenes")) return json(res, 400, { error: "invalid board name in order" });
-				if (new Set(order).size !== order.length) return json(res, 400, { error: "duplicate board in order" });
-				if (!underRoot(boardsDir)) return json(res, 400, { error: "boards directory escapes the project" });
-				for (let i = 0; i < order.length; i++) {
-					const p = boardPath(order[i]);
-					if (!p || !existsSync(p) || !notSymlink(p)) continue;
+				const { tree, base } = parsed;
+				const bad = validateWire(tree);
+				if (bad) return json(res, 400, { error: bad });
+				const b = base;
+				if (!b || typeof b !== "object" || !b.boards || typeof b.boards !== "object" || b.folders !== null && typeof b.folders !== "string") return json(res, 400, { error: "expected base hashes" });
+				{
+					const de = dirError();
+					if (de) return json(res, 400, { error: de });
+				}
+				const reg = readRegistry(boardsDir);
+				if (reg.state === "malformed") return json(res, 422, { error: reg.error });
+				if (reg.sha256 !== b.folders) return json(res, 409, {
+					error: "folders changed on disk",
+					stale: [FOLDERS_FILE]
+				});
+				const unseen = listBoardFiles(boardsDir).boards.map((x) => x.name).filter((n) => !(n in b.boards));
+				if (unseen.length) return json(res, 409, {
+					error: "boards changed on disk",
+					stale: unseen
+				});
+				const plan = [];
+				const stale = [];
+				const consider = (name, order, folder) => {
+					const p = boardPath(name);
+					if (!p || !isRegularFile(p)) {
+						stale.push(name);
+						return null;
+					}
+					const content = readFileSync(p, "utf8");
+					if (b.boards[name] !== hash(content)) {
+						stale.push(name);
+						return null;
+					}
 					let obj;
 					try {
-						obj = JSON.parse(readFileSync(p, "utf8"));
+						obj = JSON.parse(content);
 					} catch {
+						return `board "${name}" is not valid JSON - fix the file`;
+					}
+					if (!obj || typeof obj !== "object" || Array.isArray(obj)) return `board "${name}" is not a JSON object - fix the file`;
+					plan.push({
+						name,
+						path: p,
+						obj,
+						order,
+						folder
+					});
+					return null;
+				};
+				const folders = [];
+				for (const [i, it] of tree.entries()) {
+					if (typeof it === "string") {
+						const e = consider(it, i, null);
+						if (e) return json(res, 422, { error: e });
 						continue;
 					}
-					if (!obj || typeof obj !== "object") continue;
-					obj.order = i;
-					atomicWrite(p, JSON.stringify(obj, null, 2) + "\n");
+					const description = readDescription(it.description);
+					folders.push({
+						name: it.folder,
+						order: i,
+						...description ? { description } : {}
+					});
+					for (const [j, kid] of it.boards.entries()) {
+						const e = consider(kid, j, it.folder);
+						if (e) return json(res, 422, { error: e });
+					}
+				}
+				if (stale.length) return json(res, 409, {
+					error: "boards changed on disk",
+					stale
+				});
+				const sha256 = {};
+				for (const w of plan) {
+					if (w.obj.order === w.order && (w.folder ? w.obj.folder === w.folder : w.obj.folder === void 0)) continue;
+					w.obj.order = w.order;
+					if (w.folder) w.obj.folder = w.folder;
+					else delete w.obj.folder;
+					const next = JSON.stringify(w.obj, null, 2) + "\n";
+					atomicWrite(w.path, next);
+					sha256[w.name] = hash(next);
 				}
-				return json(res, 200, { ok: true });
+				mkdirSync(boardsDir, { recursive: true });
+				let foldersSha = null;
+				if (folders.length) {
+					const next = JSON.stringify({
+						version: 1,
+						folders
+					}, null, 2) + "\n";
+					atomicWrite(foldersPath, next);
+					foldersSha = hash(next);
+				} else rmSync(foldersPath, { force: true });
+				return json(res, 200, {
+					ok: true,
+					sha256: {
+						boards: sha256,
+						folders: foldersSha
+					}
+				});
 			}
 			const boardMatch = /^boards\/([^/]+)$/.exec(path);
 			if (boardMatch) {
@@ -268,9 +335,11 @@ function apiMiddleware(root, opts = {}) {
 					}
 					mkdirSync(boardsDir, { recursive: true });
 					const incoming = body.board;
-					if (incoming && typeof incoming === "object" && incoming.order === void 0 && current) try {
-						const o = JSON.parse(current).order;
-						if (typeof o === "number" && Number.isFinite(o)) incoming.order = o;
+					if (incoming && typeof incoming === "object" && current) try {
+						const disk = JSON.parse(current);
+						if (incoming.order === void 0 && typeof disk.order === "number" && Number.isFinite(disk.order)) incoming.order = disk.order;
+						if (incoming.folder === void 0 && validName(disk.folder)) incoming.folder = disk.folder;
+						if (incoming.description === void 0 && readDescription(disk.description)) incoming.description = disk.description;
 					} catch {}
 					const next2 = JSON.stringify(body.board, null, 2) + "\n";
 					atomicWrite(p, next2);
@@ -294,7 +363,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-BWhoz6cU.mjs");
+				const { shootFrame } = await import("./shot-CwmHO5T4.mjs");
 				const r = await shootFrame({
 					root,
 					viewports: opts.viewports ?? {},
@@ -328,8 +397,8 @@ function apiMiddleware(root, opts = {}) {
 			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-CbpzSzJu.mjs");
-				const { isLocalAssetRef } = await import("./build-DfuTQZlY.mjs");
+				const { ensurePoster, isLocalClip } = await import("./poster-DOY7pax8.mjs");
+				const { isLocalAssetRef } = await import("./build-Ct0iMoSi.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 });
@@ -611,7 +680,12 @@ const VIRTUAL_CONFIG = "virtual:sh-config";
 const VIRTUAL_DATA = "virtual:sh-data";
 function marverPlugin(ctx) {
 	const { root, clientDir, config } = ctx;
-	let manifest = scanFrames(root);
+	let project = {
+		name: config.share.name || basename(root),
+		description: config.description
+	};
+	const projectInfo = () => project;
+	let manifest = scanFrames(root, projectInfo());
 	let devServer = null;
 	const bootId = String(process.hrtime.bigint());
 	let invRev = 0;
@@ -752,9 +826,13 @@ function marverPlugin(ctx) {
 			}));
 			server.middlewares.use(routesMiddleware(server, clientDir));
 			devServer = server;
+			let framesKey = JSON.stringify(manifest.frames);
 			const regen = debounce(() => {
-				manifest = scanFrames(root);
-				if (writeManifest(root, manifest)) server.ws.send("sh:manifest", manifest);
+				manifest = scanFrames(root, projectInfo());
+				const changed = writeManifest(root, manifest);
+				const key = JSON.stringify(manifest.frames);
+				if (changed && key !== framesKey) server.ws.send("sh:manifest", manifest);
+				framesKey = key;
 			}, 150);
 			const watched = [join(root, "design", "scenes"), join(root, "design", "components")];
 			const inScope = (file) => watched.some((w) => file.startsWith(w));
@@ -791,14 +869,31 @@ function marverPlugin(ctx) {
 					rescanTheme();
 				}
 			});
-			server.watcher.on("change", (f) => inScope(f) && /\.(tsx|jsx)$/.test(f) && regen());
-			writeManifest(root, scanFrames(root));
+			server.watcher.on("change", (f) => inScope(f) && (/\.(tsx|jsx)$/.test(f) || f.endsWith("_brief.md")) && regen());
+			const configFile = join(root, "design", "config.ts");
+			server.watcher.on("change", (f) => {
+				if (f !== configFile) return;
+				loadConfig(root).then((c) => {
+					project = {
+						name: c.share.name || basename(root),
+						description: c.description
+					};
+					regen();
+				}).catch(() => {});
+			});
+			writeManifest(root, manifest);
 			const boardsDir = join(root, "design", "boards");
 			try {
 				mkdirSync(boardsDir, { recursive: true });
 				const timers = /* @__PURE__ */ new Map();
+				let listTimer;
 				const watcher = watch(boardsDir, (_event, file) => {
 					if (!file || !file.endsWith(".json")) return;
+					clearTimeout(listTimer);
+					listTimer = setTimeout(() => {
+						server.ws.send("sh:boards", {});
+						regen();
+					}, 150);
 					clearTimeout(timers.get(file));
 					timers.set(file, setTimeout(() => {
 						timers.delete(file);
@@ -849,7 +944,7 @@ function marverPlugin(ctx) {
 								});
 								return;
 							}
-							const { shootFrame } = await import("./shot-BWhoz6cU.mjs");
+							const { shootFrame } = await import("./shot-CwmHO5T4.mjs");
 							write(await shootFrame({
 								root,
 								viewports: config.viewports,

package/dist/{poster-CbpzSzJu.mjs → poster-DOY7pax8.mjs}

@@ -1,4 +1,4 @@
-import { capture, findChrome } from "./shot-BWhoz6cU.mjs";
+import { capture, findChrome } from "./shot-CwmHO5T4.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";

package/dist/{shot-BWhoz6cU.mjs → shot-CwmHO5T4.mjs}

@@ -95,8 +95,8 @@ async function shootFrame(opts) {
 	};
 	const plan = planShot(frame, viewports, size);
 	if (frame.kind !== "html") try {
-		const { scanAssetRefs } = await import("./build-DfuTQZlY.mjs");
-		const { ensurePoster } = await import("./poster-CbpzSzJu.mjs");
+		const { scanAssetRefs } = await import("./build-Ct0iMoSi.mjs");
+		const { ensurePoster } = await import("./poster-DOY7pax8.mjs");
 		const refs = scanAssetRefs(readFileSync(join(root, frame.file), "utf8"), frame.file);
 		for (const r of refs) if (r.endsWith(".poster.png")) await ensurePoster(join(root, "design", "assets"), r.slice(0, -11));
 	} catch {}

package/docs/publish.md

@@ -31,7 +31,10 @@ opens the same view on the published site, as long as its board and frame shippe
 
 **What ships**: the boards you list, the frames they reference, and the host `public/`
 directory in full (the `--boards` filter covers frames, not public assets). A flow you
-publish must have all its `data-goto` targets on a published board.
+publish must have all its `data-goto` targets on a published board. Sidebar folders ship
+only around published boards (a folder with nothing published never reaches the bundle),
+and `description`s ship only for published things - the project's, the published boards',
+their folders', scenes' and frames'.
 
 ## Who can open your canvas
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marver-design/marver",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "The agent-native design canvas. A design/ folder, one command, a canvas of live frames built from your repo's real components - comment @marver and your own coding agent does the work. The tool ships no AI.",
   "type": "module",
   "private": false,