@marver-design/marver 0.22.0 → 0.22.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
 
+## 0.22.1 - 2026-10-06
+
+### Changed
+
+- **A project without `context/` hears about it.** The AGENTS contract opens with it: in a
+  repository with no `context/`, every reply in which an agent made, specced or changed a feature or
+  project board ends with one line - every feature board reads Backlog, nothing records what shipped,
+  want me to set it up? - until the human answers; a no stands for the session, and nothing is set up
+  unasked. `instructions/boards.md`, `npx marver boards`, `npx marver boards new` (feature, project),
+  `npx marver init` and `marver dev` at boot point at it. In 0.22.0 a routing row merely pointed at
+  the instruction: Claude Code and Codex, asked to spec a feature, both read it and never mentioned
+  it; with the line, both end their reply with it.
+- `npx marver init` on an existing canvas no longer ends with the first-session hand-off - an
+  upgrade is not a first session.
+
+### Docs
+
+- **"Set up our context" is the whole ask.** `instructions/context.md`'s setup is now the full recipe,
+  in order: the kind (`product` or `knowledge`), the draft from evidence, the canvas reading it -
+  typed folders, feature boards named after their capability, a start board - and the check in ci.
+  After upgrading (`npx marver init`), tell your agent: "Set up our context."
+
 ## 0.22.0 - 2026-10-06
 
 ### Added

package/dist/{bake-BSX4XR_U.mjs → bake-CvY8QR3L.mjs}

@@ -1,4 +1,4 @@
-import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-C22Ues04.mjs";
+import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-BAR8hmU9.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from "node:fs";
 import { join, sep } from "node:path";
 import { createHash } from "node:crypto";

package/dist/{boards-BTGNPVMx.mjs → boards-BwKI0qWd.mjs}

@@ -80,6 +80,7 @@ function boardsCommand(root, opts) {
 	if (landing) console.log(`\nlanding board: ${landing}`);
 	console.log(`registry: ${reg.state === "ok" ? "design/boards/_folders.json" : "none (no empty or ranked folders yet)"}`);
 	if (skipped.length) console.log(`skipped (not regular files): ${skipped.join(", ")}`);
+	if ([...notes.values()].filter((n) => n.status).length && !existsSync(join(root, "context"))) console.log(`\nno context/ yet - every feature and project board reads Backlog. Agent: end your reply with the context line in design/AGENTS.md ("Before the method").`);
 }
 /** `marver boards new <name>` - a board in its type's starting layout (spec 20): a feature's three
 *  phase scenes (spec, lo-fi, hi-fi) as three bands, a start board rendering context/INDEX.md and

package/dist/{build-Dd2Qm3OG.mjs → build-B1kavcpc.mjs}

@@ -1,8 +1,8 @@
 import { a as ROUTE, r as NAME } from "./cli.mjs";
 import { D as boardFields, H as isBoardName, L as buildTree, N as readRegistry, O as checkBoardsDir, R as flatten, Z as PROPOSED_PUBLISH, i as PUBLISHABLE, j as listBoardFiles, o as publishableStatus } from "./board-status-CWGHIdo_.mjs";
-import { r as scanFrames } from "./manifest-BqBcMJcd.mjs";
+import { i as scanFrames } from "./manifest-CcdWx7ud.mjs";
 import { i as detectHost, n as loadConfig } from "./config-DJxMRVD8.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-8XntSCx_.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-C5u07Yhv.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";
@@ -754,7 +754,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
 	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-DRZDszTI.mjs");
+		const { ensurePoster } = await import("./poster-BduzQBYz.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})`);
@@ -821,7 +821,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
 	}));
 	let textureLine = "  textures: skipped (--no-textures)";
 	if (textures && bakeGen) {
-		const { bakePublished } = await import("./publish-bakes-CCWRV9iX.mjs");
+		const { bakePublished } = await import("./publish-bakes-b0jUwvM_.mjs");
 		const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
 		const r = await bakePublished({
 			root,

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { cac } from "cac";
-import { readFileSync, realpathSync } from "node:fs";
+import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/client/const.ts
@@ -82,7 +82,7 @@ cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "st
 		console.error(`[${NAME}] --kind ${opts.kind}: use product or knowledge`);
 		process.exit(1);
 	}
-	const { init } = await import("./init-NJ3xjLVu.mjs");
+	const { init } = await import("./init-C_K-cjBQ.mjs");
 	init(resolve$1(opts.root), {
 		mode: opts.mode === "embedded" ? "embedded" : "studio",
 		demo: opts.demo !== false,
@@ -90,7 +90,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-BW7a5kDF.mjs");
+	const { dev } = await import("./dev-Cf4wLGe2.mjs");
 	let port;
 	if (opts.port !== void 0) {
 		const n = Number(opts.port);
@@ -100,7 +100,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("--no-textures", "Skip compiling the glass textures the published frames rest under (needs Chrome; a CI without one skips on its own)").option("--root <dir>", "Host repo root", { default: "." }).action(async (opts) => {
-	const { buildSite } = await import("./build-Dd2Qm3OG.mjs");
+	const { buildSite } = await import("./build-B1kavcpc.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, opts.textures !== false && !process.env.MARVER_NO_TEXTURES);
@@ -146,13 +146,14 @@ cli.command("work <action> [...frames]", "Working state on the canvas: start <sc
 	}
 });
 cli.command("boards [action] [name]", "The sidebar as files: every folder and board in reading order, with types and statuses · new <name>: a board in its type's starting layout").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "The tree as JSON ({ tree, boards, landing, registry })").option("--type <type>", "new: start | feature | surface | project | feedback | context | deck | archive (default: the folder's)").option("--folder <folder>", "new: the folder it sits in").option("--title <title>", "new: what humans see").option("--description <sentence>", "new: what agents read").option("--capability <slug>", "new: the capability it shows, when not its own name").action(async (action, name, opts) => {
-	const { boardsCommand, boardsNew } = await import("./boards-BTGNPVMx.mjs");
+	const { boardsCommand, boardsNew } = await import("./boards-BwKI0qWd.mjs");
 	try {
 		if (action === void 0) boardsCommand(resolve$1(opts.root), opts);
 		else if (action === "new") {
 			if (!name) throw new Error("name the board: `boards new <name>`");
 			const made = boardsNew(resolve$1(opts.root), name, opts);
 			for (const c of made) console.log(`  + ${c}`);
+			if (/\((feature|project)\b/.test(made[0] ?? "") && !existsSync(join(resolve$1(opts.root), "context"))) console.log(`\n  note: no context/ yet - this board's status reads Backlog until there is one. Agent: end your reply with the context line in design/AGENTS.md ("Before the method").`);
 			if (made.some((c) => c.endsWith("/_brief.md")) && !made.some((c) => /\.(tsx|jsx|html)$/.test(c))) console.log(`\n  next: a frame you make in these scenes shows on the board once it is pinned - a node in\n  design/boards/${name}.json (an agent does this as it works: design/AGENTS.md)`);
 		} else throw new Error(`unknown action "${action}" - \`boards\` lists, \`boards new <name>\` creates`);
 	} catch (err) {
@@ -161,7 +162,7 @@ cli.command("boards [action] [name]", "The sidebar as files: every folder and bo
 	}
 });
 cli.command("folders <action> [...modules]", "The shared sidebar's typed folders · add <start|features|surfaces|projects|feedback|context|decks|archive ...>").option("--root <dir>", "Host repo root", { default: "." }).action(async (action, modules, opts) => {
-	const { foldersAdd } = await import("./boards-BTGNPVMx.mjs");
+	const { foldersAdd } = await import("./boards-BwKI0qWd.mjs");
 	try {
 		if (action !== "add") throw new Error(`unknown action "${action}" - \`folders add <module ...>\``);
 		const { added, existing } = foldersAdd(resolve$1(opts.root), modules);
@@ -173,7 +174,7 @@ cli.command("folders <action> [...modules]", "The shared sidebar's typed folders
 	}
 });
 cli.command("context <action>", "The project's context/ (spec 19) · init: create it · check: keep it true (exit 0 pass, 1 fail, 2 cannot determine) · index: regenerate the index's capability table").option("--root <dir>", "Host repo root", { default: "." }).option("--base <ref>", "check: the pull request's base - a change to a contracted capability's code must change its contract or say why (in ci, read from the event)").option("--head <ref>", "check: the pull request's head (default HEAD)").option("--body-file <file>", "check: the pull request's body, for `no-contract-change: <capability> - <why>`").option("--json", "check: the findings as JSON ({ exit, failures, unsure, notes })").option("--kind <kind>", "init: product (a shipped record) or knowledge (a delivered record)", { default: "product" }).action(async (action, opts) => {
-	const ctx = await import("./context-DUAENlJ6.mjs");
+	const ctx = await import("./context-D4t59wDi.mjs");
 	const root = resolve$1(opts.root);
 	try {
 		if (action === "init") {

package/dist/{context-DUAENlJ6.mjs → context-D4t59wDi.mjs}

@@ -2,7 +2,7 @@ import { r as NAME } from "./cli.mjs";
 import { C as tables, S as proseLines, _ as isRecordTable, b as looseTables, c as CITED_FILE, d as LEVEL, f as availableLevels, g as hasGlob, h as globRe, k as checkRealDirs, l as EVIDENCE_COLUMN, m as frontMatter, p as capabilityTable, s as CITATION, tt as readStatusWord, u as GENERATED, v as levelsIn, w as wordCount, x as parseMap, y as lf } from "./board-status-CWGHIdo_.mjs";
 import { pkgDir } from "./managed-HwHVNI3h.mjs";
 import { t as writeManaged } from "./managed-write-Bo-oPc-i.mjs";
-import { r as scanFrames } from "./manifest-BqBcMJcd.mjs";
+import { i as scanFrames } from "./manifest-CcdWx7ud.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, normalize, relative, sep } from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{daemon-BmkwErpC.mjs → daemon-PmNqoOAk.mjs}

@@ -1,7 +1,7 @@
 import { n as replay } from "./events-B3LBn74P.mjs";
 import { i as readLog, r as listBoards, t as appendEvents } from "./comments-DZyobpxG.mjs";
 import { n as localProfile } from "./profile-BjAPAJSb.mjs";
-import { a as toFrameId } from "./manifest-BqBcMJcd.mjs";
+import { o as toFrameId } from "./manifest-CcdWx7ud.mjs";
 import { workActivity } from "./work-CLrmY-vQ.mjs";
 import { r as deviceId, t as has } from "./ledger-Bu0BjqIe.mjs";
 import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, watch, writeFileSync, writeSync } from "node:fs";

package/dist/{dev-BW7a5kDF.mjs → dev-Cf4wLGe2.mjs}

@@ -1,7 +1,7 @@
 import { i as PKG, r as NAME } from "./cli.mjs";
 import { i as detectHost, n as loadConfig } from "./config-DJxMRVD8.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-8XntSCx_.mjs";
-import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-C5u07Yhv.mjs";
+import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createLogger, createServer, parseAst, searchForWorkspaceRoot } from "vite";
@@ -454,12 +454,12 @@ async function dev(root, portFlag) {
 	console.log(`\n  ${NAME} · ${projectName} → http://localhost:${port}/\n`);
 	setTimeout(async () => {
 		try {
-			await (await import("./shot-C22Ues04.mjs")).sweepGhosts((m) => console.log(`  ${m}`));
+			await (await import("./shot-BAR8hmU9.mjs")).sweepGhosts((m) => console.log(`  ${m}`));
 		} catch {}
 	}, 0);
 	try {
 		const { staleManagedInstructions } = await import("./managed-HwHVNI3h.mjs");
-		const { installedVersion } = await import("./plugin-8XntSCx_.mjs").then((n) => n.i);
+		const { installedVersion } = await import("./plugin-C5u07Yhv.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` : "");
@@ -467,6 +467,12 @@ async function dev(root, portFlag) {
 			console.log(`  instructions predate ${v ? NAME + " " + v : "the installed version"} (${shown}) - run: npx ${NAME} init\n`);
 		}
 	} catch {}
+	try {
+		if (!existsSync(join(root, "context"))) {
+			const n = (await import("./manifest-CcdWx7ud.mjs").then((n) => n.r)).statusBoards(root).length;
+			if (n) console.log(`  ${n} feature/project board${n === 1 ? "" : "s"}, no context/ - every status reads Backlog. To start it, tell your agent: "Set up our context."\n`);
+		}
+	} catch {}
 	const { loadCollab, syncOnce } = await import("./sync-BZaCWqK-.mjs").then((n) => n.o);
 	if (loadCollab(root)) console.log(`  comments: syncing with the published canvas\n`);
 	let syncing = false;
@@ -497,7 +503,7 @@ async function dev(root, portFlag) {
 		});
 	}
 	if (config.jam) {
-		const { startJam } = await import("./daemon-BmkwErpC.mjs");
+		const { startJam } = await import("./daemon-PmNqoOAk.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-NJ3xjLVu.mjs → init-C_K-cjBQ.mjs}

@@ -2,7 +2,7 @@ import { r as NAME } from "./cli.mjs";
 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 { i as scanFrames, s as writeManifest } from "./manifest-CcdWx7ud.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";
@@ -234,10 +234,11 @@ function init(root, opts) {
 	console.log(`\n  commit design/ - only .local/ is ignored`);
 	console.log(`  uninstall = delete design/, remove the ${NAME} dependency${host.tsconfigSweepsDesign ? ", revert the \"design\" line in tsconfig exclude" : ""}`);
 	if (!noApp(host) && !existsSync(join(design, "DESIGN.md"))) console.log(`\n  note: design/DESIGN.md (the brand doc) does not exist yet - have your agent create it from the app's tokens (instructions/brand.md, Path A) to reach the idle state.`);
+	if (!existsSync(join(root, "context"))) console.log(`\n  note: no context/ yet - feature and project boards read Backlog until there is one, and nothing records what shipped. To start it, tell your agent: "Set up our context." (design/instructions/context.md)`);
 	if (!jamAgent) console.log(`\n  note: Live Jam found no agent CLI on PATH (claude, codex, cursor, droid, opencode, grok, or pi) - install one and it arms itself on the next \`${NAME} dev\`.`);
 	else if (created.includes("design/config.ts")) console.log(`\n  Live Jam is on (${jamAgent}): tag @${NAME} in a canvas comment and your agent does the work, then replies in the thread.`);
 	console.log(`\n  next: npx ${NAME} dev   (or: npx ${NAME} canvas - same thing; canvas on http://localhost:${DEFAULTS.port} by default)\n`);
-	if (!noApp(host)) console.log(`  then, to your agent: "Read design/AGENTS.md. This is our first session - follow design/instructions/welcome.md."\n`);
+	if (!noApp(host) && created.includes("design/config.ts")) console.log(`  then, to your agent: "Read design/AGENTS.md. This is our first session - follow design/instructions/welcome.md."\n`);
 }
 /** The host's path aliases, re-rooted one level down for design/tsconfig.json.
 *  "./src/*" becomes "../src/*" so `@/` imports resolve from inside design/. */

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

@@ -1,9 +1,29 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { i as PKG, n as CONTENT_WIDTH } from "./cli.mjs";
 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/manifest.ts
+var manifest_exports = /* @__PURE__ */ __exportAll({
+	NOTE_MAX: () => NOTE_MAX,
+	affectedFrameIds: () => affectedFrameIds,
+	codeOnly: () => codeOnly,
+	contentScan: () => contentScan,
+	contentWidthOf: () => contentWidthOf,
+	extractMeta: () => extractMeta,
+	frontMatter: () => frontMatter,
+	isNoteFile: () => isNoteFile,
+	noteFileFor: () => noteFileFor,
+	readNote: () => readNote,
+	scanFrames: () => scanFrames,
+	sceneBrief: () => sceneBrief,
+	sceneNote: () => sceneNote,
+	setSceneTitle: () => setSceneTitle,
+	statusBoards: () => statusBoards,
+	toFrameId: () => toFrameId,
+	writeManifest: () => writeManifest
+});
 const FRAME_EXT = /\.(tsx|jsx|html)$/;
 const RESERVED_SCENES = /* @__PURE__ */ new Set(["components", "screens"]);
 /** Sticky notes (spec 18): the longest note the manifest carries - a note is an aside, not a spec. */
@@ -296,6 +316,9 @@ function scanBoards(root) {
 		...boards.length ? { boards } : {}
 	};
 }
+/** The boards that wear a status (feature and project, by their resolved type) - for the dev
+*  server's word at boot when there is no context/ to read it from. */
+const statusBoards = (root) => (scanBoards(root).boards ?? []).filter((b) => b.type === "feature" || b.type === "project").map((b) => b.name);
 function scanFrames(root, project) {
 	const design = join(root, "design");
 	const frames = [];
@@ -452,4 +475,4 @@ function writeManifest(root, manifest) {
 	return true;
 }
 //#endregion
-export { toFrameId as a, setSceneTitle as i, isNoteFile as n, writeManifest as o, scanFrames as r, affectedFrameIds as t };
+export { setSceneTitle as a, scanFrames as i, isNoteFile as n, toFrameId as o, manifest_exports as r, writeManifest as s, affectedFrameIds as t };

package/dist/{plugin-8XntSCx_.mjs → plugin-C5u07Yhv.mjs}

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { a as ROUTE, i as PKG, r as NAME } from "./cli.mjs";
 import { A as isRegularFile, B as folderMap, D as boardFields, F as BOARD_NAME, G as validateWire, I as FOLDERS_FILE, K as wireKids, L as buildTree, M as nodeExists, N as readRegistry, O as checkBoardsDir, P as withRegistryLock, T as AUTHOR_FIELDS, U as readDescription, W as readTitle, Y as HAS_STATUS, at as hash, et as readReason, it as settableStatuses, j as listBoardFiles, n as readContextFacts, nt as readType, rt as resolveType, t as annotateBoards, tt as readStatusWord } from "./board-status-CWGHIdo_.mjs";
 import { n as localProfile, t as isConnected } from "./profile-BjAPAJSb.mjs";
-import { i as setSceneTitle, n as isNoteFile, o as writeManifest, r as scanFrames, t as affectedFrameIds } from "./manifest-BqBcMJcd.mjs";
+import { a as setSceneTitle, i as scanFrames, n as isNoteFile, s as writeManifest, t as affectedFrameIds } from "./manifest-CcdWx7ud.mjs";
 import { n as loadConfig } from "./config-DJxMRVD8.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";
@@ -546,7 +546,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-C22Ues04.mjs");
+				const { shootFrame } = await import("./shot-BAR8hmU9.mjs");
 				const r = await shootFrame({
 					root,
 					viewports: opts.viewports ?? {},
@@ -596,7 +596,7 @@ function apiMiddleware(root, opts = {}) {
 				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-C22Ues04.mjs");
+				const { resolveFrames, shootBatch } = await import("./shot-BAR8hmU9.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"}`;
@@ -624,7 +624,7 @@ function apiMiddleware(root, opts = {}) {
 					return json(res, 400, { error: "malformed JSON" });
 				}
 				if (!body || typeof body !== "object" || !Array.isArray(body.asks) || !body.asks.length || body.asks.length > 200) return json(res, 400, { error: "asks must list 1-200 frames" });
-				const { bakeBatch, ASK_MAX } = await import("./bake-BSX4XR_U.mjs");
+				const { bakeBatch, ASK_MAX } = await import("./bake-CvY8QR3L.mjs");
 				let manifest = {};
 				try {
 					manifest = JSON.parse(readFileSync(join(root, "design", "manifest.json"), "utf8"));
@@ -668,8 +668,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-DRZDszTI.mjs");
-				const { isLocalAssetRef } = await import("./build-Dd2Qm3OG.mjs");
+				const { ensurePoster, isLocalClip } = await import("./poster-BduzQBYz.mjs");
+				const { isLocalAssetRef } = await import("./build-B1kavcpc.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 });
@@ -1151,7 +1151,7 @@ function marverPlugin(ctx) {
 			};
 			const prune = () => setTimeout(async () => {
 				try {
-					(await import("./bake-BSX4XR_U.mjs")).pruneBakes(root, bakeGen);
+					(await import("./bake-CvY8QR3L.mjs")).pruneBakes(root, bakeGen);
 				} catch {}
 			}, 500);
 			prune();
@@ -1303,7 +1303,7 @@ function marverPlugin(ctx) {
 								});
 								return;
 							}
-							const { shootFrame, shootBatch, resolveFrames } = await import("./shot-C22Ues04.mjs");
+							const { shootFrame, shootBatch, resolveFrames } = await import("./shot-BAR8hmU9.mjs");
 							if (ways[0] === "frame") {
 								if (typeof spec.frame !== "string") {
 									write({

package/dist/{poster-DRZDszTI.mjs → poster-BduzQBYz.mjs}

@@ -1,4 +1,4 @@
-import { capture, t as findChrome } from "./shot-C22Ues04.mjs";
+import { capture, t as findChrome } from "./shot-BAR8hmU9.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/{publish-bakes-CCWRV9iX.mjs → publish-bakes-b0jUwvM_.mjs}

@@ -1,6 +1,6 @@
 import { o as slideSize } from "./cli.mjs";
-import { planShot, t as findChrome } from "./shot-C22Ues04.mjs";
-import { ASK_MAX, bakeBatch } from "./bake-BSX4XR_U.mjs";
+import { planShot, t as findChrome } from "./shot-BAR8hmU9.mjs";
+import { ASK_MAX, bakeBatch } from "./bake-CvY8QR3L.mjs";
 import { MIME } from "./serve-z5qtj_wJ.mjs";
 import { copyFileSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { extname, isAbsolute, join, relative, resolve } from "node:path";

package/dist/{shot-C22Ues04.mjs → shot-BAR8hmU9.mjs}

@@ -337,8 +337,8 @@ async function shootFrame(opts) {
 	};
 	const plan = planShot(frame, viewports, size);
 	if (frame.kind !== "html") try {
-		const { scanAssetRefs } = await import("./build-Dd2Qm3OG.mjs");
-		const { ensurePoster } = await import("./poster-DRZDszTI.mjs");
+		const { scanAssetRefs } = await import("./build-B1kavcpc.mjs");
+		const { ensurePoster } = await import("./poster-BduzQBYz.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marver-design/marver",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "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,

package/templates/AGENTS-embedded.md

@@ -5,6 +5,17 @@ Never drive or automate the canvas UI; read and write files only. (Starting
 `npx marver dev` so the human has a live canvas - first session, or on request -
 is the one allowed touch.)
 
+## Before the method: a project with no `context/`
+
+This repository has no `context/` directory? Then **every reply in which you made, specced or changed
+a feature or project board ends with this line**, word for word, until the human answers it:
+
+> This project has no `context/` yet, so every feature board reads Backlog and nothing records what
+> shipped. Want me to set it up? A few questions, then a draft from the code and the deploy history.
+
+A yes: instructions/context.md, "Setting up". A no stands for the session - stop asking. Never set
+it up unasked.
+
 ## The method (binding)
 
 Design work moves through phases. BEFORE working in a phase, read its instruction

package/templates/AGENTS-studio.md

@@ -5,6 +5,17 @@ Never drive or automate the canvas UI; read and write files only. (Starting
 `npx marver dev` so the human has a live canvas - first session, or on request -
 is the one allowed touch.)
 
+## Before the method: a project with no `context/`
+
+This repository has no `context/` directory? Then **every reply in which you made, specced or changed
+a feature or project board ends with this line**, word for word, until the human answers it:
+
+> This project has no `context/` yet, so every feature board reads Backlog and nothing records what
+> shipped. Want me to set it up? A few questions, then a draft from the code and the deploy history.
+
+A yes: instructions/context.md, "Setting up". A no stands for the session - stop asking. Never set
+it up unasked.
+
 ## The method (binding)
 
 Design work moves through phases. BEFORE working in a phase, read its instruction

package/templates/instructions/boards.md

@@ -176,7 +176,9 @@ boards fall back to the parent folder's type). Moving a board changes an inherit
   capability is the board's name, or `"capability": "<slug>"`. You may decide only three things on
   the board: `"status": "archived"`, `"paused"`, or `"blocked"` with `"reason": "<one sentence>"`.
   **Never write `"status": "done"`** - Done comes from `context/shipped.md`, and the check fails it.
-  Without `context/` a board may also say `"todo"`, `"backlog"` or `"in-progress"` by hand.
+  **No `context/`? Your reply ends with the context line** from design/AGENTS.md ("Before the method")
+  - every feature board reads Backlog until there is one. Only when the human declines may a board
+  say `"todo"`, `"backlog"` or `"in-progress"` by hand.
   A person sets the same from the sidebar (right-click, Change status…) - it rewrites only `status`
   and `reason`, so re-read a board before you edit it.
 - In progress fills by phase: the phase scenes above, or `phase: spec | lofi | hifi` in a scene's

package/templates/instructions/context.md

@@ -98,11 +98,20 @@ Context starts with people. Ask, in one message:
 3. What is private, and who may see what?
 4. How is this project named in shared spaces - keywords, tags?
 
-Then `npx marver context init`, record the answers in `context/people.md`, and draft from evidence:
-the shipped record from deploy runs and the changelog (`unknown` where nothing proves it), a map from
-the code, contracts for the capabilities that matter now. **Context that exists but is scattered**
-- specs out of date, nobody sure what is live - is a job for
-`context/playbooks/reorganize-context/PLAYBOOK.md`, not for a rewrite.
+Then, in order - this is the whole recipe; "set up our context" asks for all of it:
+1. `npx marver context init --kind product` - or `--kind knowledge` when the work is deliverables
+   for clients rather than a product people use. Record the answers in `context/people.md`.
+2. Draft from evidence: the shipped record from deploy runs and the changelog (`unknown` where
+   nothing proves it), a map from the code, contracts for the capabilities that matter now.
+3. Let the canvas read it: `npx marver init --kind <the same kind>` adds the typed folders (it never
+   moves a board); put each feature board in Features (a project in Projects), named after its
+   capability or saying `"capability": "<slug>"`; then `npx marver boards new home --type start
+   --folder start-here`.
+4. Put the check in ci - a step running `npx marver context check` on a full-history checkout
+   (`fetch-depth: 0`) - and make it pass before you hand over.
+
+**Context that exists but is scattered** - specs out of date, nobody sure what is live - is a job
+for `context/playbooks/reorganize-context/PLAYBOOK.md`, not for a rewrite.
 
 ## The check