@marver-design/marver 0.21.0 → 0.22.0

package/dist/{init-C34BY3R4.mjs → init-NJ3xjLVu.mjs}

@@ -1,7 +1,10 @@
 import { r as NAME } from "./cli.mjs";
-import { d as readJson, l as detectAgent, o as writeManifest, r as scanFrames, s as DEFAULTS, u as detectHost } from "./manifest-mMfUhPtL.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 { E as addFolders, J as FOLDER_MODULES, X as KIND_FOLDERS } from "./board-status-CWGHIdo_.mjs";
+import { MANAGED_PREFIX, enumerateInstructionTemplates, hashBody, pkgDir } from "./managed-HwHVNI3h.mjs";
+import { t as writeManaged } from "./managed-write-Bo-oPc-i.mjs";
+import { o as writeManifest, r as scanFrames } from "./manifest-BqBcMJcd.mjs";
+import { a as readJson, i as detectHost, r as detectAgent, t as DEFAULTS } from "./config-DJxMRVD8.mjs";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 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. */
@@ -36,43 +39,15 @@ function init(root, opts) {
 		writeFileSync(file, content);
 		created.push(`design/${rel}`);
 	};
-	const writeManaged = (rel, body) => {
-		const file = join(design, rel);
-		const next = managedFile(body);
-		const latest = join(design, ".local", "latest", rel);
-		if (!existsSync(file)) return write(rel, next);
-		const current = readFileSync(file, "utf8");
-		if (current === next) {
-			rmSync(latest, { force: true });
-			return;
-		}
-		if (current.startsWith("<!-- marver:managed ")) {
-			const recorded = current.slice(MANAGED_PREFIX.length).split(" ")[0];
-			const nl = current.indexOf("\n");
-			const currentBody = nl >= 0 ? current.slice(nl + 1) : "";
-			if (nl >= 0 && hashBody(currentBody) === recorded) {
-				writeFileSync(file, next);
-				rmSync(latest, { force: true });
-				created.push(`design/${rel} (updated)`);
-			} else if (recorded !== hashBody(body)) {
-				mkdirSync(dirname(latest), { recursive: true });
-				writeFileSync(latest, body);
-				if (nl >= 0) {
-					const tmp = file + ".tmp";
-					writeFileSync(tmp, managedFile(body).split("\n")[0] + "\n" + currentBody);
-					renameSync(tmp, file);
-				}
-				console.warn(`  ~ design/${rel}: you customized it and a newer version exists - your edits are untouched. Merge what you want from design/.local/latest/${rel}`);
-			}
-		} else if (current.startsWith("<!-- generated by marver init")) {
-			writeFileSync(file, next);
-			rmSync(latest, { force: true });
-			created.push(`design/${rel} (updated)`);
-		} else if (current !== body) {
-			rmSync(latest, { force: true });
-			console.warn(`  note: design/${rel} exists without a marver marker - left untouched. If you did not author it, delete it and re-run init to restore the managed version.`);
-		}
-	};
+	const writeManaged$1 = (rel, body) => writeManaged({
+		base: design,
+		rel,
+		body,
+		shown: `design/${rel}`,
+		stageDir: join(design, ".local", "latest"),
+		created,
+		rerun: `\`npx ${NAME} init\``
+	});
 	const jamAgent = detectAgent();
 	write("config.ts", configTemplate(opts.mode, jamAgent));
 	if (host.themeCss) {
@@ -80,7 +55,7 @@ function init(root, opts) {
 		write("theme.css", themeWrapper(relCss, host.tailwind === 4));
 	} else console.warn(`[${NAME}] no theme CSS detected - create design/theme.css importing your app's stylesheet when you have one (or set \`theme\` in design/config.ts).`);
 	write("providers.tsx", providersTemplate(host.router, host.toaster, host.routerPkg));
-	writeManaged("AGENTS.md", readFileSync(join(templates, `AGENTS-${opts.mode}.md`), "utf8").replaceAll("{{UI_GUIDANCE}}", uiGuidance(host, noApp(host))).replace(/\{\{NEXT_NOTES\}\}\n?/, host.router === "next" ? NEXT_NOTES : ""));
+	writeManaged$1("AGENTS.md", readFileSync(join(templates, `AGENTS-${opts.mode}.md`), "utf8").replaceAll("{{UI_GUIDANCE}}", uiGuidance(host, noApp(host))).replace(/\{\{NEXT_NOTES\}\}\n?/, host.router === "next" ? NEXT_NOTES : ""));
 	const agentsNow = readFileSync(join(design, "AGENTS.md"), "utf8");
 	if (!agentsNow.startsWith("<!-- marver:managed ") && !agentsNow.startsWith("<!-- generated by marver init") && agentsNow.includes("# Design canvas - agent contract") && !agentsNow.includes("## The method (binding)")) console.warn(`  note: design/AGENTS.md predates managed regeneration - if you never edited it, delete it and re-run init to get the current contract (incl. the design/instructions routing).`);
 	const claudeMd = join(root, "CLAUDE.md");
@@ -107,7 +82,7 @@ function init(root, opts) {
 			created.push("AGENTS.md (updated)");
 		}
 	}
-	for (const { rel, body } of enumerateInstructionTemplates(templates)) writeManaged(rel, body);
+	for (const { rel, body } of enumerateInstructionTemplates(templates)) writeManaged$1(rel, body);
 	const setupPath = join(design, "instructions", "setup.md");
 	const setupState = () => {
 		if (!existsSync(setupPath)) return "absent";
@@ -123,7 +98,7 @@ function init(root, opts) {
 	const appJustAppeared = !noApp(host) && (setupWas === "ours-pristine" || setupWas === "ours-edited");
 	if (noApp(host)) {
 		if (setupWas === "ours-pristine" && !readFileSync(setupPath, "utf8").startsWith("<!-- marver:managed ")) rmSync(setupPath);
-		if (setupWas !== "foreign") writeManaged("instructions/setup.md", SETUP_MD);
+		if (setupWas !== "foreign") writeManaged$1("instructions/setup.md", SETUP_MD);
 	} else if (setupWas === "ours-pristine") {
 		rmSync(setupPath);
 		console.log(`  - design/instructions/setup.md removed (app detected - setup complete)`);
@@ -143,7 +118,7 @@ function init(root, opts) {
 		refresh("providers.tsx", [providersTemplate(null, null), providersTemplate(null, host.toaster, host.routerPkg)], providersTemplate(host.router, host.toaster, host.routerPkg));
 		refresh("tsconfig.json", [STANDALONE_TSCONFIG], tsconfigNow());
 	}
-	write(".gitignore", ".local/\n.dist/\n.dist-seeds/\nslides-inspiration/\n");
+	write(".gitignore", ".local/\n.dist/\n.dist-seeds/\nslides-inspiration/\nboards/.folders.lock\n");
 	{
 		const gi = join(design, ".gitignore");
 		const cur = readFileSync(gi, "utf8");
@@ -152,6 +127,14 @@ function init(root, opts) {
 			created.push("design/.gitignore (+ slides-inspiration/)");
 		}
 	}
+	{
+		const gi = join(design, ".gitignore");
+		const cur = readFileSync(gi, "utf8");
+		if (!cur.split("\n").some((l) => l.trim() === "boards/.folders.lock")) {
+			writeFileSync(gi, cur + (cur.endsWith("\n") || cur === "" ? "" : "\n") + "boards/.folders.lock\n");
+			created.push("design/.gitignore (+ boards/.folders.lock)");
+		}
+	}
 	write("slides.md", [
 		"# This project's deck look and house habits",
 		"",
@@ -216,6 +199,18 @@ function init(root, opts) {
 		writeFileSync(join(design, "boards", ".gitkeep"), "");
 		created.push("design/boards/");
 	}
+	{
+		const boardsDir = join(design, "boards");
+		const fresh = !existsSync(join(boardsDir, "_folders.json")) && !readdirSync(boardsDir).some((f) => f.endsWith(".json"));
+		if (opts.kind || fresh) {
+			const kind = opts.kind ?? (noApp(host) ? "knowledge" : "product");
+			const { added } = addFolders(root, KIND_FOLDERS[kind].map((m) => FOLDER_MODULES[m]));
+			if (added.length) {
+				created.push(`design/boards/_folders.json (${kind}: ${added.join(", ")})`);
+				if (!opts.kind) console.log(`  folders for ${kind === "product" ? "a product (an app was detected)" : "knowledge work (no app detected)"} - \`npx ${NAME} init --kind ${kind === "product" ? "knowledge" : "product"}\` adds the other set; \`npx ${NAME} folders add decks\` the deck folder`);
+			}
+		}
+	}
 	const sceneDirs = existsSync(join(design, "scenes")) ? readdirSync(join(design, "scenes"), { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith("_")).length : 0;
 	if (opts.demo && sceneDirs === 0 && !existsSync(join(design, "scenes", "demo"))) {
 		cpSync(join(templates, "demo"), join(design, "scenes", "demo"), { recursive: true });

package/dist/managed-write-Bo-oPc-i.mjs

@@ -0,0 +1,71 @@
+import { MANAGED_PREFIX, hashBody, managedFile } from "./managed-HwHVNI3h.mjs";
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/cli/managed-write.ts
+/**
+* Write one managed file - the marker records a HASH of the body Marver generated, which makes
+* three states distinguishable with no other stored state:
+*   pristine  (body matches the hash)      -> updates flow through on upgrade
+*   edited    (body differs from the hash) -> NEVER overwritten; when upstream also moved, the
+*              fresh version is staged under `stageDir` and one line says to merge - an agent
+*              merges semantically, which is why no merge machinery ships here
+*   detached  (marker line deleted)        -> never touched, never mentioned
+*
+* `base` + `rel` is the file; `shown` is how messages name it (`design/AGENTS.md`,
+* `context/playbooks/release/PLAYBOOK.md`). Shared by `init` (design/) and `context init`.
+*/
+function writeManaged(o) {
+	const { base, rel, body, shown, stageDir, created, rerun } = o;
+	const file = join(base, rel);
+	const next = managedFile(body);
+	const latest = join(stageDir, rel);
+	if (!existsSync(file)) {
+		mkdirSync(dirname(file), { recursive: true });
+		try {
+			writeFileSync(file, next, { flag: "wx" });
+			created.push(shown);
+			return;
+		} catch (e) {
+			if (e.code !== "EEXIST") throw e;
+		}
+	}
+	const current = readFileSync(file, "utf8");
+	if (current === next) {
+		rmSync(latest, { force: true });
+		return;
+	}
+	const replace = (content) => {
+		const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+		writeFileSync(tmp, content, { flag: "wx" });
+		if (readFileSync(file, "utf8") !== current) {
+			rmSync(tmp, { force: true });
+			return false;
+		}
+		renameSync(tmp, file);
+		return true;
+	};
+	if (current.startsWith("<!-- marver:managed ")) {
+		const recorded = current.slice(MANAGED_PREFIX.length).split(" ")[0];
+		const nl = current.indexOf("\n");
+		const currentBody = nl >= 0 ? current.slice(nl + 1) : "";
+		if (nl >= 0 && hashBody(currentBody) === recorded) {
+			if (!replace(next)) return;
+			rmSync(latest, { force: true });
+			created.push(`${shown} (updated)`);
+		} else if (recorded !== hashBody(body)) {
+			mkdirSync(dirname(latest), { recursive: true });
+			writeFileSync(latest, body);
+			if (nl >= 0) replace(managedFile(body).split("\n")[0] + "\n" + currentBody);
+			console.warn(`  ~ ${shown}: you customized it and a newer version exists - your edits are untouched. Merge what you want from ${latest.slice(latest.indexOf("design/.local/"))}`);
+		}
+	} else if (current.startsWith("<!-- generated by marver init")) {
+		if (!replace(next)) return;
+		rmSync(latest, { force: true });
+		created.push(`${shown} (updated)`);
+	} else if (current !== body) {
+		rmSync(latest, { force: true });
+		console.warn(`  note: ${shown} exists without a marver marker - left untouched. If you did not author it, delete it and re-run ${rerun} to restore the managed version.`);
+	}
+}
+//#endregion
+export { writeManaged as t };

package/dist/{manifest-mMfUhPtL.mjs → manifest-BqBcMJcd.mjs}

@@ -1,377 +1,8 @@
 import { i as PKG, n as CONTENT_WIDTH } from "./cli.mjs";
-import { a as listBoardFiles, d as flatten, f as folderEntries, h as readTitle, m as readDescription, n as checkBoardsDir, p as isBoardName, r as checkRealDirs, s as readRegistry, t as boardFields, u as buildTree, v as hash } from "./boards-BwiDAmPf.mjs";
-import { accessSync, constants, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { delimiter, isAbsolute, join, relative, sep } from "node:path";
-import { pathToFileURL } from "node:url";
+import { D as boardFields, H as isBoardName, L as buildTree, N as readRegistry, O as checkBoardsDir, R as flatten, U as readDescription, W as readTitle, at as hash, j as listBoardFiles, k as checkRealDirs, t as annotateBoards, z as folderEntries } from "./board-status-CWGHIdo_.mjs";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
 import { randomBytes } from "node:crypto";
-//#region src/server/detect.ts
-function readJson(file) {
-	try {
-		return JSON.parse(stripJsonComments(readFileSync(file, "utf8")));
-	} catch {
-		return null;
-	}
-}
-function stripJsonComments(s) {
-	let out = "", inStr = false, inLine = false, inBlock = false;
-	for (let i = 0; i < s.length; i++) {
-		const c = s[i], n = s[i + 1];
-		if (inLine) {
-			if (c === "\n") {
-				inLine = false;
-				out += c;
-			}
-			continue;
-		}
-		if (inBlock) {
-			if (c === "*" && n === "/") {
-				inBlock = false;
-				i++;
-			}
-			continue;
-		}
-		if (inStr) {
-			out += c;
-			if (c === "\\") {
-				out += n ?? "";
-				i++;
-			} else if (c === "\"") inStr = false;
-			continue;
-		}
-		if (c === "\"") {
-			inStr = true;
-			out += c;
-			continue;
-		}
-		if (c === "/" && n === "/") {
-			inLine = true;
-			i++;
-			continue;
-		}
-		if (c === "/" && n === "*") {
-			inBlock = true;
-			i++;
-			continue;
-		}
-		out += c;
-	}
-	let res = "", inS = false;
-	for (let i = 0; i < out.length; i++) {
-		const c = out[i];
-		if (inS) {
-			res += c;
-			if (c === "\\") {
-				res += out[i + 1] ?? "";
-				i++;
-			} else if (c === "\"") inS = false;
-			continue;
-		}
-		if (c === "\"") {
-			inS = true;
-			res += c;
-			continue;
-		}
-		if (c === ",") {
-			let j = i + 1;
-			while (j < out.length && /\s/.test(out[j])) j++;
-			if (out[j] === "}" || out[j] === "]") continue;
-		}
-		res += c;
-	}
-	return res;
-}
-function detectHost(root) {
-	const pkg = readJson(join(root, "package.json")) ?? {};
-	const deps = {
-		...pkg.dependencies,
-		...pkg.devDependencies
-	};
-	const twRange = deps["tailwindcss"];
-	const tailwind = !twRange ? null : /(^|[^\d])4\./.test(twRange) || twRange.startsWith("^4") || twRange.startsWith("~4") ? 4 : 3;
-	const router = deps["next"] ? "next" : deps["react-router"] || deps["react-router-dom"] ? "react-router" : null;
-	const routerPkg = deps["react-router-dom"] ? "react-router-dom" : "react-router";
-	const toaster = deps["sonner"] ? "sonner" : deps["react-hot-toast"] ? "react-hot-toast" : null;
-	let shadcn = null;
-	const comp = readJson(join(root, "components.json"));
-	if (comp?.tailwind?.css) shadcn = {
-		themeCss: comp.tailwind.css,
-		uiAlias: comp.aliases?.ui ?? "@/components/ui"
-	};
-	const themeCss = shadcn?.themeCss && existsSync(join(root, shadcn.themeCss)) ? shadcn.themeCss : firstExisting(root, [
-		"src/index.css",
-		"src/styles/theme.css",
-		"src/styles/globals.css",
-		"src/app/globals.css",
-		"app/globals.css",
-		"src/globals.css",
-		"src/style.css",
-		"styles/globals.css"
-	]);
-	const ts = readJson(join(root, "tsconfig.json"));
-	const include = ts?.include;
-	const exclude = ts?.exclude ?? [];
-	const sweeps = ts != null && !exclude.some((e) => e === "design" || e.startsWith("design/")) && (!include || include.some((i) => i === "." || i.startsWith("**") || i.startsWith("design")));
-	return {
-		tailwind,
-		router,
-		routerPkg,
-		toaster,
-		shadcn,
-		themeCss,
-		tsconfigSweepsDesign: !!sweeps
-	};
-}
-function firstExisting(root, candidates) {
-	for (const c of candidates) if (existsSync(join(root, c))) return c;
-	return null;
-}
-//#endregion
-//#region src/server/jam/agent.ts
-/**
-* Which coding agent drives this repo.
-*
-* Live Jam is ON by default, so this is the answer to "on by default with WHAT" - asked
-* once by `init` (which writes the answer into design/config.ts, where it is visible and
-* editable) and again at every dev boot, so a workspace that predates the block - or a
-* human who switched tools - still jams without editing anything.
-*
-* The tool RUNNING us wins: `init` is usually run BY the agent, so its env markers are
-* evidence rather than a guess. Whatever wins must still be on PATH - the daemon has to
-* spawn it.
-*/
-/** Ordered by preference when a machine has several installed and none is running us. */
-const AGENTS = [
-	"claude",
-	"codex",
-	"cursor",
-	"droid",
-	"opencode",
-	"grok",
-	"pi"
-];
-/** Env vars each CLI sets in the processes it spawns. Deliberately NOT CODEX_HOME or
-*  ANTHROPIC_API_KEY: those are configuration a human exports by hand, not evidence that
-*  the tool is running right now. (opencode's `AGENT=1` and pi's `AI_AGENT` are skipped
-*  for the same reason in reverse - too generic to prove WHICH tool is running.)
-*  droid and grok set no marker at all in the shells they spawn (verified against the
-*  grok-build source and droid 0.200.0), so they are found by PATH order only. */
-const MARKERS = {
-	claude: ["CLAUDECODE", "CLAUDE_CODE_ENTRYPOINT"],
-	codex: ["CODEX_SANDBOX", "CODEX_THREAD_ID"],
-	cursor: ["CURSOR_AGENT"],
-	droid: [],
-	opencode: ["OPENCODE", "OPENCODE_PID"],
-	grok: [],
-	pi: ["PI_CODING_AGENT", "PI_SESSION_ID"]
-};
-/** The executable each agent name maps to. Only cursor differs: its CLI installs BOTH
-*  `cursor-agent` and a bare `agent` - and grok's installer symlinks `agent` too, so the
-*  short name is a coin flip on a machine with both. The long name is unambiguous. */
-const AGENT_BIN = {
-	claude: "claude",
-	codex: "codex",
-	cursor: "cursor-agent",
-	droid: "droid",
-	opencode: "opencode",
-	grok: "grok",
-	pi: "pi"
-};
-/** The valid `jam.agent` values as an English list - one string, so every surface
-*  (config warning, init note, dev boot line) names the same set and none goes stale. */
-const AGENT_NAMES = `${AGENTS.slice(0, -1).map((a) => `"${a}"`).join(", ")}, or "${AGENTS[AGENTS.length - 1]}"`;
-/** Is `cmd` an executable FILE on PATH? A direct stat per PATH entry - no spawn, no shell,
-*  so this is safe to call on every dev boot. Two deliberate narrowings, both in service of
-*  "found means spawnable", because arming an agent that cannot run is worse than staying off:
-*
-*  - `isFile`, because a directory carries the execute bit too (it means "traversable"), so an
-*    access check alone would call a folder named `claude` an agent.
-*  - the bare name only, no PATHEXT: the daemon spawns without a shell, and Node cannot run a
-*    Windows `.cmd`/`.bat` shim that way. Finding one would arm a job that fails on every run.
-*
-*  Only ABSOLUTE PATH entries count. An empty entry means the current directory on POSIX, and
-*  a relative one (`.`, `bin`) resolves against it too - and the current directory is the repo
-*  that was just opened, so a `claude` binary shipped inside it is precisely what must never
-*  be found and spawned. */
-function onPath(cmd, env = process.env) {
-	for (const dir of (env.PATH ?? "").split(delimiter)) {
-		if (!isAbsolute(dir)) continue;
-		try {
-			const file = join(dir, cmd);
-			if (statSync(file).isFile()) {
-				accessSync(file, constants.X_OK);
-				return true;
-			}
-		} catch {}
-	}
-	return false;
-}
-/** The agent to jam with, or undefined when this machine has none installed.
-*
-*  One knowingly-imperfect case: agents nest, and env is inherited, so a codex run started
-*  FROM Claude Code carries both marker families and this picks claude. Env has no depth to
-*  read, and walking the process tree to find the nearest agent ancestor costs more than the
-*  case is worth - so the answer is made visible instead of clever: `init` prints the agent
-*  it chose and writes it into design/config.ts, and instructions/jam.md has the agent confirm
-*  that line names the tool it actually is. One word to correct, once per repo. */
-function detectAgent(env = process.env) {
-	const running = AGENTS.find((a) => MARKERS[a].some((k) => env[k]));
-	if (running && onPath(AGENT_BIN[running], env)) return running;
-	return AGENTS.find((a) => onPath(AGENT_BIN[a], env));
-}
-//#endregion
-//#region src/server/config.ts
-const DEFAULTS = {
-	mode: "studio",
-	theme: null,
-	viewports: {
-		mobile: {
-			width: 390,
-			height: 844
-		},
-		tablet: {
-			width: 768,
-			height: 1024
-		},
-		laptop: {
-			width: 1280,
-			height: 800
-		},
-		monitor: {
-			width: 1920,
-			height: 1080
-		}
-	},
-	themes: ["light", "dark"],
-	port: 5199,
-	zoomSpeed: 1,
-	share: { branding: true }
-};
-/** Load design/config.ts via native TS import (Node >= 22.18). Missing or broken fields fall back to defaults. */
-async function loadConfig(root) {
-	const file = join(root, "design", "config.ts");
-	if (!existsSync(file)) return {
-		...DEFAULTS,
-		...jamFields(void 0)
-	};
-	try {
-		const user = (await import(`${pathToFileURL(file).href}?t=${Date.now()}`)).default ?? {};
-		return {
-			...DEFAULTS,
-			...user,
-			viewports: validViewports(user.viewports) ?? DEFAULTS.viewports,
-			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,
-				logo: typeof user.share?.logo === "string" ? user.share.logo : void 0,
-				frontDoor: user.share?.frontDoor !== false && user.share?.front_door !== false,
-				notify: user.share?.notify !== false
-			},
-			...jamFields(user.jam)
-		};
-	} catch (err) {
-		console.error(`[marver] design/config.ts failed to load, using defaults and leaving Live Jam OFF:\n  ${err.message}`);
-		return {
-			...DEFAULTS,
-			jamOff: "unreadable"
-		};
-	}
-}
-const validDim = (n) => typeof n === "number" && Number.isFinite(n) && n >= 1 && n <= 2e4;
-function validPort(n) {
-	return typeof n === "number" && Number.isInteger(n) && n > 0 && n < 65536 ? n : null;
-}
-function validZoom(n) {
-	return typeof n === "number" && Number.isFinite(n) && n >= .1 && n <= 10 ? n : null;
-}
-/** Six frames at once is what a jam actually feels like - at 3, half of a multi-frame
-*  ask sat waiting on the other half while the human watched. */
-const DEFAULT_CONCURRENCY = 6;
-/** A config value, printable in a warning. Never throws - a formatter that can crash inside an
-*  error path (JSON.stringify does, on a BigInt) turns a clear message into a mystery. */
-const show = (v) => {
-	try {
-		return JSON.stringify(v) ?? String(v);
-	} catch {
-		return String(v);
-	}
-};
-/** A `{...}` written by hand, not a Date/Map/class instance that merely types as "object". */
-const plainObject = (v) => {
-	if (!v || typeof v !== "object") return false;
-	const proto = Object.getPrototypeOf(v);
-	return proto === Object.prototype || proto === null;
-};
-/** The agent to arm with - or, when the human NAMED one we cannot use, why not (said once,
-*  here, because a bad `jam.agent` is a config-file error like any other).
-*
-*  A named agent is never quietly swapped for another: running a different tool than the one
-*  asked for is worse than not running. Nor is one armed that cannot be spawned - that would
-*  claim every @marver mention, fail it, and never retry. */
-function resolveAgent(named) {
-	if (named === void 0) return detectAgent() ?? "no-agent";
-	if (typeof named !== "string" || !Object.hasOwn(AGENT_BIN, named)) {
-		console.warn(`[marver] design/config.ts: jam.agent ${show(named)} is not an agent marver can spawn - Live Jam is off. Use ${AGENT_NAMES}.`);
-		return "bad-agent";
-	}
-	const agent = named;
-	if (!onPath(AGENT_BIN[agent])) {
-		console.warn(`[marver] design/config.ts names jam.agent "${agent}", but \`${AGENT_BIN[agent]}\` is not on PATH - Live Jam is off until it is installed.`);
-		return "bad-agent";
-	}
-	return agent;
-}
-/** Resolve the jam block. Live Jam is ON by default: an absent or partial `jam` resolves
-*  to whatever agent CLI this machine has, so a fresh workspace jams with nothing
-*  configured and an old one needs no re-init. `jam: false` is the off switch. */
-function resolveJam(v) {
-	if (v === false) return "opted-out";
-	const shape = v === void 0 || v === true ? {} : typeof v === "string" ? { agent: v } : plainObject(v) ? v : null;
-	if (!shape) {
-		console.warn(`[marver] design/config.ts: jam must be false, an agent name, or an options object - got ${show(v)}. Live Jam is off.`);
-		return "bad-agent";
-	}
-	const j = shape;
-	const agent = resolveAgent(j.agent);
-	if (agent === "no-agent" || agent === "bad-agent") return agent;
-	const c = j.concurrency;
-	return {
-		agent,
-		concurrency: typeof c === "number" && Number.isInteger(c) && c >= 1 && c <= 16 ? c : DEFAULT_CONCURRENCY,
-		subagents: j.subagents !== false,
-		proactive: j.proactive === true
-	};
-}
-/** Exactly one of `jam` (armed) or `jamOff` (why not) - so the dev server can speak up about
-*  the one off-state nothing has reported yet, and stay quiet about the rest. BOTH keys are
-*  always written: these spread over the user's own `jam`, and a raw `jam: false` reaching the
-*  server as config would arm the daemon against a truthy object check. */
-function jamFields(v) {
-	const r = resolveJam(v);
-	return typeof r === "string" ? {
-		jam: void 0,
-		jamOff: r
-	} : {
-		jam: r,
-		jamOff: void 0
-	};
-}
-function validViewports(v) {
-	if (!v || typeof v !== "object") return null;
-	const out = {};
-	for (const [k, val] of Object.entries(v)) {
-		const vp = val;
-		if (validDim(vp?.width) && validDim(vp?.height)) out[k] = {
-			width: Math.round(vp.width),
-			height: Math.round(vp.height)
-		};
-	}
-	return Object.keys(out).length ? out : null;
-}
-//#endregion
 //#region src/server/manifest.ts
 const FRAME_EXT = /\.(tsx|jsx|html)$/;
 const RESERVED_SCENES = /* @__PURE__ */ new Set(["components", "screens"]);
@@ -625,7 +256,8 @@ function scanBoards(root) {
 	if (checkBoardsDir(root, dir)) return {};
 	const reg = readRegistry(dir);
 	if (reg.state === "malformed") return {};
-	const rows = listBoardFiles(dir).boards.map((b) => ({
+	const files = listBoardFiles(dir).boards;
+	const rows = files.map((b) => ({
 		name: b.name,
 		...boardFields(b.json, isBoardName)
 	}));
@@ -637,15 +269,26 @@ function scanBoards(root) {
 		name: it.name,
 		...parent ? { parent } : {},
 		...it.title ? { title: it.title } : {},
-		...it.description ? { description: it.description } : {}
+		...it.description ? { description: it.description } : {},
+		...it.type ? { type: it.type } : {}
 	}));
+	const notes = annotateBoards(root, files, reg.folders, (n) => folderOf.get(n) ?? null);
 	const boards = flatten(tree).map((name) => {
 		const r = rows.find((x) => x.name === name);
+		const n = notes.get(name);
+		const st = n?.status;
 		return {
 			name,
 			...folderOf.has(name) ? { folder: folderOf.get(name) } : {},
 			...r?.title ? { title: r.title } : {},
-			...r?.description ? { description: r.description } : {}
+			...r?.description ? { description: r.description } : {},
+			...n && n.type !== "plain" ? { type: n.type } : {},
+			...st ? { status: {
+				status: st.status,
+				...st.fill ? { fill: st.fill } : {},
+				...st.reason ? { reason: st.reason } : {},
+				audience: st.audience
+			} } : {}
 		};
 	});
 	return {
@@ -809,4 +452,4 @@ function writeManifest(root, manifest) {
 	return true;
 }
 //#endregion
-export { toFrameId as a, loadConfig as c, readJson as d, setSceneTitle as i, detectAgent as l, isNoteFile as n, writeManifest as o, scanFrames as r, DEFAULTS as s, affectedFrameIds as t, detectHost as u };
+export { toFrameId as a, setSceneTitle as i, isNoteFile as n, writeManifest as o, scanFrames as r, affectedFrameIds as t };