kanbo-cli 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to kanbo are documented here. The format follows [Keep a Cha
 
 ## [Unreleased]
 
+## [0.8.0] — 2026-11-07
+
+kanbo 0.8 gives the board page Modular's look, puts sub-tasks inside their parent card, and adds an Analytics view and a List view. No board migration.
+
+### Added
+
+- An **Analytics** view on the board page (`?view=analytics`): a range of 4, 12 or 26 weeks or a sprint, figure cards, finished per week, cumulative flow and time in column drawn in SVG, aging work, agents and people tables. It reads the same numbers as `kanbo stats` and fetches nothing while another view or a hidden tab is showing.
+- `GET /issues/metrics` on `kanbo serve` (`from`, `to` in unix seconds, or `sprint=<id>`; the last 12 ISO weeks to now by default), the metrics `kanbo stats` prints. A read; additive.
+- The board page: a **List view** (Board / List switch, `?view=list`), **column badges** (a count, `n/limit` against a WIP limit in amber at the limit, and a lock whose tooltip lists a column's rules), **keys** (`j`/`k`, arrows, Enter, Space, `x`, `/`, Esc) and **selecting several cards** (a box, `x`, shift- and cmd-click) with a floating bar that sets their column or priority in one `PATCH /issues/bulk`.
+- The board page ships **Geist** (variable woff2 in latin, latin-ext and cyrillic, SIL OFL 1.1) under `/assets/fonts/`; the page's content security policy gains `font-src 'self'`.
+
+### Changed
+
+- The board page takes Modular's look: Geist type, a near-white neutral palette in light and dark, white cards with a hairline ring on quiet column bays, a 28 px toolbar with **Filter** and **Display** menus, status-category and priority icons, and toned label chips. It replaces the strip-board design.
+- **Sub-tasks** (a card with a parent) now live inside the parent's card as rows with a progress bar (`1/3 done`), and a waiting or running sub-task is never hidden (the parent shows a **Sub-task waiting for you** pill). **Display → Show sub-tasks as cards** (`?subtasks=cards`) draws them as cards of their own, marked **Sub-task of …**. The card dialog gets a breadcrumb to the parent, a sibling switcher, a **Sub-tasks** section and a property grid. "Sub-card" is now "sub-task" on the page.
+- The `kanbo init` wizard no longer asks "Add a first card?" or "Write these changes?": it asks where the board lives, the card key, the columns and which agents to connect, then writes and prints what it did. `--first-card <title>` still adds a first card.
+- In a folder with no board of its own, when only `KANBO_DB_PATH` names an app's database that is older than this kanbo or has no project for the folder, kanbo answers "This folder has no kanbo board of its own … run kanbo init here" instead of blaming the app's database. A binding or `--db` naming that database keeps the old sentence.
+
 ## [0.7.0] — 2026-11-07
 
 kanbo 0.7 gives agents one way onto the board: the MCP server. The terminal keeps the person's commands. No board migration.
@@ -247,6 +265,7 @@ First public release.
 - `kanbo serve`: the `/issues` HTTP API and a board page, loopback by default, bearer token, CORS allow-list, 1 MB body limit.
 - Library entry points `kanbo`, `kanbo/sqlite`, `kanbo/sqlite/schema`, `kanbo/postgres` and `kanbo/mcp` (ESM and CJS with types).
 
+[0.8.0]: https://github.com/Krowli/kanbo/releases/tag/v0.8.0
 [0.7.0]: https://github.com/Krowli/kanbo/releases/tag/v0.7.0
 [0.6.0]: https://github.com/Krowli/kanbo/releases/tag/v0.6.0
 [0.5.0]: https://github.com/Krowli/kanbo/releases/tag/v0.5.0

package/README.md

@@ -26,7 +26,7 @@ Then tell your agent: **"take the next card from kanbo."** Watch the board and a
 - **A board in a file, or a shared Postgres database.** `.kanbo/board.db` next to your code for one project on one machine, or an external Postgres (Supabase works) for a team of people and agents. See [storage](docs/storage.md).
 - **Agents work it over MCP.** Seventeen `kanbo_*` tools, and the server explains the rules itself when the client connects — nothing is written into your project's `CLAUDE.md` or `AGENTS.md`. See [MCP reference](docs/mcp.md); the [CLI reference](docs/cli.md) covers the commands you run.
 - **You approve. kanbo enforces it, not just asks.** `approve`, `return` and column changes are a person's; an agent's shell is refused with exit code `4`, and on Postgres the database roles refuse it too. See [agents](docs/agents.md#agents-and-people).
-- **Watch it in a terminal, or in your browser.** `kanbo board` and the interactive home screen, or `kanbo serve` for a board page over HTTP. See [HTTP API](docs/http-api.md).
+- **Watch it in a terminal, or in your browser.** `kanbo board` and the interactive home screen, or `kanbo serve` for a board page over HTTP (sub-tasks inside their parent card, a List view, keys, bulk changes). See [HTTP API](docs/http-api.md).
 
 ## Works with
 

package/dist/cli-main.cjs

@@ -3580,7 +3580,7 @@ new Command();
 * `package.version`. A build carries it as a literal; running from source
 * (tests, `tsx`) reads the package's own `package.json` instead.
 */
-const KANBO_PACKAGE_VERSION = "0.7.0";
+const KANBO_PACKAGE_VERSION = "0.8.0";
 //#endregion
 //#region src/cli/agent-shell.ts
 /**
@@ -25061,11 +25061,28 @@ async function openBoardSession(options, mode, cwd = process.cwd()) {
 		asAgent: options.asAgent,
 		cwd
 	});
-	const session = target.kind === "postgres" ? await openExternalSession(target, options, cwd) : await openFileSession(target, options, mode, cwd);
+	const session = target.kind === "postgres" ? await openExternalSession(target, options, cwd) : await openFileSession(target, options, mode, cwd).catch((error) => {
+		throw describeEnvironmentOnlyFailure(error, target, options, cwd);
+	});
 	const found = findBinding(cwd);
 	if (found) rememberProjectQuietly(found.projectDir);
 	return session;
 }
+/**
+* A folder with no board of its own that only `KANBO_DB_PATH` points at an
+* app's database: when that database is older than this kanbo, or knows no
+* project for the folder, the folder is told it has no board, not that "the
+* app's database" needs updating — the person never chose that database. A
+* flag or a binding that names the database keeps the app-centred sentence.
+*/
+function describeEnvironmentOnlyFailure(error, target, options, cwd) {
+	if (!(target.owner !== "kanbo" && !options.db?.trim() && !options.databaseUrl?.trim() && !process.env.KANBO_DATABASE_URL?.trim() && findBinding(cwd) === null) || !(error instanceof CliError)) return error;
+	let reason;
+	if (error.exitCode === 3 && error.message === "The app's database is older than this kanbo. Let the app it belongs to update it first.") reason = "is older than this kanbo";
+	else if (error.exitCode === 2 && error.message === "Could not tell which project this is. Pass --workspace <name|id>, or run \"kanbo init\" in the project folder.") reason = "has no project for this folder";
+	else return error;
+	return new CliError(error.exitCode, `This folder has no kanbo board of its own. KANBO_DB_PATH points at another app's database (${target.path}), which ${reason}. To give this folder its own board, run kanbo init here.`);
+}
 async function openFileSession(target, options, mode, cwd) {
 	const board = await openBoardDatabase(target.path);
 	try {
@@ -43176,7 +43193,7 @@ function startUpdateCheck(deps = {}) {
 		setTimeout: globalThis.setTimeout,
 		clearTimeout: globalThis.clearTimeout
 	};
-	const current = deps.currentVersion ?? "0.7.0";
+	const current = deps.currentVersion ?? "0.8.0";
 	const controller = new AbortController();
 	let found = null;
 	const timeout = timers.setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
@@ -44430,26 +44447,6 @@ function assertOwnBoardFile(absolutePath) {
 function notABoardFileMessage(absolutePath) {
 	return `${absolutePath} already holds a database of its own. Name another path with --file, or move that file out of the way.`;
 }
-/** The plan as a person reads it before saying yes. */
-function describeInitPlan(plan) {
-	const lines = ["kanbo init will:"];
-	const columns = plan.columns ? `, with the columns ${plan.columns.map((column) => column.name).join(", ")}` : "";
-	if (plan.boardFile) {
-		const what = plan.boardFile.exists ? "the board file of this project, brought up to date" : `a board file of this project's own${columns}`;
-		lines.push(`  ${plan.boardFile.exists ? "update" : "create"}  ${relativeTo(plan, plan.boardFile.path)} (${what})`);
-	}
-	if (plan.target.kind === "postgres" && plan.migrate) lines.push(`  create  the board's tables in ${maskDatabaseUrl(plan.target.url)}${columns}`);
-	lines.push(`  write   ${BINDING_FILE_PATH} (this project uses board ${plan.workspace.name})`);
-	for (const item of plan.connect ? pendingItems(plan.connect) : []) lines.push(item.kind === "claude-cli" ? `  run     ${explainItem(item)}` : `  ${item.kind === "instructions" ? "remove " : "write  "} ${displayPath(plan, itemPath(item))} (${explainItem(item)})`);
-	if (plan.firstCard) lines.push(`  add     a first card to To Do: ${plan.firstCard}`);
-	for (const note of plan.connect?.notes ?? []) lines.push(`Note: ${note}`);
-	lines.push("Nothing else is changed.");
-	return lines.join("\n");
-}
-function relativeTo(plan, path) {
-	const inside = (0, node_path.relative)(plan.projectDir, path);
-	return inside.startsWith("..") ? path : inside;
-}
 /**
 * Carry the plan out: the board first — the file, or the shared database's
 * tables — so a migration that fails leaves no binding pointing at nothing;
@@ -44631,21 +44628,6 @@ async function runInitWizard(context) {
 		}
 	}
 	const plan = await context.plan(projectDir, options);
-	if (options.firstCard === void 0 && canAddCard(plan)) {
-		const title = (await ui.text({
-			message: "Add a first card? (optional — Enter to skip)",
-			placeholder: "e.g. Add a README"
-		})).trim();
-		if (title) {
-			options.firstCard = title;
-			plan.firstCard = title;
-		}
-	}
-	say$1(ui, describeInitPlan(plan));
-	if (!await ui.confirm({
-		message: "Write these changes?",
-		initialValue: true
-	})) throw new CliError(1, "Nothing was written.");
 	return {
 		projectDir,
 		options,
@@ -44891,10 +44873,6 @@ async function askConnect(ui) {
 		}]
 	});
 }
-/** A shared board whose tables were not created here may have none yet, so there is nowhere to put a card. */
-function canAddCard(plan) {
-	return plan.target.kind !== "postgres" || plan.migrate;
-}
 /** (9) What was done, and what to do next. */
 function printInitOutro(ui, result, applied) {
 	const { plan } = result;
@@ -48741,12 +48719,14 @@ const BOARD_PAGE_CSP = [
 	"style-src 'self'",
 	"connect-src 'self'",
 	"img-src 'self' data:",
+	"font-src 'self'",
 	"base-uri 'none'",
 	"form-action 'none'",
 	"frame-ancestors 'none'"
 ].join("; ");
 const SCRIPT_PATH = "/assets/board.js";
 const STYLESHEET_PATH = "/assets/board.css";
+const FONT_PATH = /^\/assets\/fonts\/([a-z0-9-]+\.woff2)$/;
 /** The document itself. No data in it; the `data:` icon keeps the browser from asking for `/favicon.ico`. */
 const BOARD_PAGE_HTML = `<!doctype html>
 <html lang="en">
@@ -48773,19 +48753,23 @@ function resolveBoardPageDirectory() {
 	const candidates = [(0, node_path.join)(here, "page"), (0, node_path.join)(here, "..", "..", "dist", "page")];
 	return candidates.find((directory) => (0, node_fs.existsSync)((0, node_path.join)(directory, "board.js"))) ?? candidates[1];
 }
-/** The page's two files from `directory`, or `null` when the page has not been built there. */
+/** The page's files from `directory`, or `null` when the page has not been built there. */
 function readBoardPageAssets(directory) {
 	const script = (0, node_path.join)(directory, "board.js");
 	const stylesheet = (0, node_path.join)(directory, "board.css");
 	if (!(0, node_fs.existsSync)(script) || !(0, node_fs.existsSync)(stylesheet)) return null;
+	const fontDirectory = (0, node_path.join)(directory, "fonts");
+	const fonts = /* @__PURE__ */ new Map();
+	if ((0, node_fs.existsSync)(fontDirectory)) for (const name of (0, node_fs.readdirSync)(fontDirectory).filter((file) => FONT_PATH.test(`/assets/fonts/${file}`))) fonts.set(name, (0, node_fs.readFileSync)((0, node_path.join)(fontDirectory, name)));
 	return {
 		script: (0, node_fs.readFileSync)(script, "utf8"),
-		stylesheet: (0, node_fs.readFileSync)(stylesheet, "utf8")
+		stylesheet: (0, node_fs.readFileSync)(stylesheet, "utf8"),
+		fonts
 	};
 }
 /** Whether a path is one of the page's own. */
 function isBoardPagePath(pathname) {
-	return pathname === "/" || pathname === SCRIPT_PATH || pathname === STYLESHEET_PATH;
+	return pathname === "/" || pathname === SCRIPT_PATH || pathname === STYLESHEET_PATH || FONT_PATH.test(pathname);
 }
 /**
 * Answer a page path. With no built page, `/` says how to build it rather than
@@ -48804,6 +48788,31 @@ function sendBoardPage(response, pathname, assets) {
 		response.end(body);
 		return;
 	}
+	const fontName = FONT_PATH.exec(pathname)?.[1];
+	if (fontName !== void 0) {
+		const font = assets.fonts.get(fontName);
+		if (!font) {
+			const body = JSON.stringify({
+				code: "not_found",
+				message: "No such font"
+			});
+			response.writeHead(404, {
+				"content-type": "application/json",
+				"content-length": Buffer.byteLength(body)
+			});
+			response.end(body);
+			return;
+		}
+		response.writeHead(200, {
+			"content-type": "font/woff2",
+			"content-length": font.length,
+			"cache-control": "no-cache",
+			"x-content-type-options": "nosniff",
+			"referrer-policy": "no-referrer"
+		});
+		response.end(font);
+		return;
+	}
 	const [contentType, body] = pathname === SCRIPT_PATH ? ["text/javascript; charset=utf-8", assets.script] : pathname === STYLESHEET_PATH ? ["text/css; charset=utf-8", assets.stylesheet] : ["text/html; charset=utf-8", BOARD_PAGE_HTML];
 	response.writeHead(200, {
 		"content-type": contentType,
@@ -49149,6 +49158,113 @@ function splitPath(path) {
 	});
 }
 //#endregion
+//#region src/cli/metrics-view.ts
+/** Every field `kanbo stats --json` may name, in the order the value carries them. */
+const BOARD_METRICS_FIELDS = [
+	"range",
+	"now",
+	"milestoneId",
+	"columns",
+	"cycleTime",
+	"leadTime",
+	"throughput",
+	"wip",
+	"aging",
+	"timeInColumn",
+	"cumulativeFlow",
+	"finished",
+	"returns",
+	"attempts",
+	"canceled",
+	"agents",
+	"people"
+];
+const LABEL_WIDTH = 16;
+/** A duration as the command line prints it: minutes under an hour, hours under a day, then days, to one decimal; a dash for none. */
+function formatDuration(seconds) {
+	if (seconds === null) return "—";
+	if (seconds < 3600) return `${Math.round(seconds / 60)}m`;
+	if (seconds < 86400) return `${Number((seconds / 3600).toFixed(1))}h`;
+	return `${Number((seconds / 86400).toFixed(1))}d`;
+}
+function percent(share) {
+	return share === null ? "—" : `${Math.round(share * 100)}%`;
+}
+function decimal(value) {
+	return value === null ? "—" : String(Number(value.toFixed(1)));
+}
+function count(n, noun) {
+	return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+function day(seconds) {
+	return (/* @__PURE__ */ new Date(seconds * 1e3)).toISOString().slice(0, 10);
+}
+/** A labelled block: the first item beside the label, the rest under it; a dash when there is nothing. */
+function block(label, items) {
+	const [first = "—", ...rest] = items;
+	return [`${label.padEnd(LABEL_WIDTH)}${first}`, ...rest.map((item) => `${" ".repeat(LABEL_WIDTH)}${item}`)];
+}
+/** Items joined on one line, or none at all. */
+function oneLine(items) {
+	return items.length === 0 ? [] : [items.join(" · ")];
+}
+/**
+* The metrics as a person reads them in a terminal: the range, then one block
+* per figure. The cumulative flow is a series per day and has no one-screen
+* form, so the last line says how to get it.
+*/
+function describeMetrics(metrics, sprint) {
+	const column = (slug) => sanitizeTerminalText(metrics.columns.find((candidate) => candidate.slug === slug)?.name ?? slug);
+	const by = metrics.returns.byActorKind;
+	const lines = [`${day(metrics.range.from)} → ${day(metrics.range.to)}`];
+	if (sprint) lines.push(`${sanitizeTerminalText(sprint.title)}: ${sprint.cards.open + sprint.cards.done} planned · ${sprint.cards.done} done`);
+	if (metrics.range.from > metrics.range.to) return [...lines, "Nothing measured yet: the range starts after now."].join("\n");
+	lines.push(...block("Cycle time", [`p50 ${formatDuration(metrics.cycleTime.p50)} · p85 ${formatDuration(metrics.cycleTime.p85)} (${count(metrics.cycleTime.cards, "card")})`]), ...block("Lead time", [`p50 ${formatDuration(metrics.leadTime.p50)} · p85 ${formatDuration(metrics.leadTime.p85)}`]), ...block("Throughput", oneLine(metrics.throughput.map((week) => `${week.week} ${week.finished}`))), ...block("In progress", oneLine(metrics.wip.map((wip) => `${column(wip.slug)} ${wip.cards}${wip.limit === null ? "" : `/${wip.limit}`}`))), ...block("First pass", [`${percent(metrics.returns.firstPassRate)} · attempts ${decimal(metrics.attempts.perFinishedCard)} per card`]), ...block("Returns", [`${metrics.returns.total} (people ${by.user} · agents ${by.agent} · outside ${by.external}) · ${decimal(metrics.returns.perFinishedCard)} per card`]), ...block("Canceled", [String(metrics.canceled)]), ...block("Aging", metrics.aging.map((card) => `${card.issueId} ${column(card.slug)} ${formatDuration(card.ageSeconds)}${card.overCycleP85 ? " (older than p85)" : ""}`)), ...block("Time in column", oneLine(metrics.timeInColumn.filter((time) => time.seconds > 0).map((time) => `${column(time.slug)} ${formatDuration(time.seconds)}`))), ...block("Agents", metrics.agents.map(describeAgent)), ...block("People", metrics.people.map(describePerson)), "Cumulative flow by day: kanbo stats --json cumulativeFlow");
+	return lines.join("\n");
+}
+function describeAgent(agent) {
+	const { runs } = agent;
+	return `${sanitizeTerminalText(agent.agentName)}: ${count(runs.total, "run")} (${runs.finished} finished · ${runs.failed} failed · ${runs.stopped} stopped · ${runs.running} running) · median ${formatDuration(agent.medianRunSeconds)} · ${count(agent.cardsFinished, "card")} finished · ${percent(agent.returnRate)} returned`;
+}
+function describePerson(person) {
+	return `${sanitizeTerminalText(person.id ?? "unnamed")}: ${person.created} created · ${person.approvals} approved · ${person.returns} returned · ${person.moves} moved`;
+}
+const WEEK_SECONDS = 604800;
+/** The Monday that makes the range `DEFAULT_STATS_WEEKS` ISO weeks long, ending with the week of `now`. */
+function defaultStatsFrom(now) {
+	return isoWeekOf(now).start - 11 * WEEK_SECONDS;
+}
+/**
+* `kanbo stats` — how work flows on this board (spec 2026-11-05, Part 4).
+*
+* Reading only, so it is anybody's, an agent's shell included. A sprint sets
+* the range to its own dates and keeps its cards; `--from` and `--to` still
+* win over either end.
+*/
+function registerStatsCommand(program) {
+	withBoardOptions(program.command("stats").description("How work flows on this board: cycle time, throughput, work in progress, returns, agents").option("--from <date>", `first day, YYYY-MM-DD (UTC) or unix seconds (12 weeks back when left out)`, (value) => parseCalendarDay(value, false)).option("--to <date>", "last day, YYYY-MM-DD (UTC, through its end) or unix seconds (now when left out)", (value) => parseCalendarDay(value, true)).option("--sprint <id>", "only the cards of this sprint, over its dates")).action(async (options) => {
+		await runBoardCommand(options, "read", async (session) => {
+			const now = currentUnixSeconds();
+			const sprint = options.sprint === void 0 ? null : (await session.ops.listSprints(session.workspace.id, now)).find((candidate) => candidate.id === options.sprint) ?? null;
+			if (options.sprint !== void 0 && sprint === null) throw new BoardError("issue_milestone_not_found", {
+				milestoneId: options.sprint,
+				workspaceId: session.workspace.id
+			});
+			const metrics = await session.ops.boardMetrics({
+				workspaceIds: [session.workspace.id],
+				from: options.from ?? sprint?.startDate ?? defaultStatsFrom(now),
+				to: options.to ?? sprint?.dueDate ?? now,
+				milestoneId: sprint?.id ?? null
+			}, now);
+			return {
+				value: metrics,
+				text: describeMetrics(metrics, sprint),
+				fields: BOARD_METRICS_FIELDS
+			};
+		});
+	});
+}
+//#endregion
 //#region src/serve/schemas.ts
 /**
 * The request shapes `kanbo serve` takes: the bodies and queries of the
@@ -49490,6 +49606,14 @@ function createActivityResolver(workspace, personWriterId = null) {
 * a server started for one of them must not reach into the rest.
 */
 const OK = { ok: true };
+/** Unix seconds in a query string, where everything arrives as text. */
+const unixSecondsQuery = string().regex(/^\d+$/).transform(Number);
+/** `GET /issues/metrics`: the range as `kanbo stats` takes it, `from` and `to` in unix seconds, or a sprint to read over its own dates. */
+const metricsQuery = object$1({
+	from: unixSecondsQuery.optional(),
+	to: unixSecondsQuery.optional(),
+	sprint: string().min(1).optional()
+});
 /** How many cards a search answers with when the caller names no limit. */
 const DEFAULT_SEARCH_LIMIT = 20;
 /**
@@ -49785,6 +49909,25 @@ function createIssueRoutes(session, options = {}) {
 				return updated;
 			}
 		}),
+		route({
+			method: "GET",
+			path: "/issues/metrics",
+			query: metricsQuery,
+			handle: async ({ query }) => {
+				const now = currentUnixSeconds();
+				const sprint = query.sprint === void 0 ? null : (await ops.listSprints(workspaceId, now)).find((candidate) => candidate.id === query.sprint) ?? null;
+				if (query.sprint !== void 0 && sprint === null) throw new BoardError("issue_milestone_not_found", {
+					milestoneId: query.sprint,
+					workspaceId
+				});
+				return await ops.boardMetrics({
+					workspaceIds: [workspaceId],
+					from: query.from ?? sprint?.startDate ?? defaultStatsFrom(now),
+					to: query.to ?? sprint?.dueDate ?? now,
+					milestoneId: sprint?.id ?? null
+				}, now);
+			}
+		}),
 		route({
 			method: "GET",
 			path: "/issues/workspace",
@@ -50785,113 +50928,6 @@ function registerSprintCommands(program) {
 	});
 }
 //#endregion
-//#region src/cli/metrics-view.ts
-/** Every field `kanbo stats --json` may name, in the order the value carries them. */
-const BOARD_METRICS_FIELDS = [
-	"range",
-	"now",
-	"milestoneId",
-	"columns",
-	"cycleTime",
-	"leadTime",
-	"throughput",
-	"wip",
-	"aging",
-	"timeInColumn",
-	"cumulativeFlow",
-	"finished",
-	"returns",
-	"attempts",
-	"canceled",
-	"agents",
-	"people"
-];
-const LABEL_WIDTH = 16;
-/** A duration as the command line prints it: minutes under an hour, hours under a day, then days, to one decimal; a dash for none. */
-function formatDuration(seconds) {
-	if (seconds === null) return "—";
-	if (seconds < 3600) return `${Math.round(seconds / 60)}m`;
-	if (seconds < 86400) return `${Number((seconds / 3600).toFixed(1))}h`;
-	return `${Number((seconds / 86400).toFixed(1))}d`;
-}
-function percent(share) {
-	return share === null ? "—" : `${Math.round(share * 100)}%`;
-}
-function decimal(value) {
-	return value === null ? "—" : String(Number(value.toFixed(1)));
-}
-function count(n, noun) {
-	return `${n} ${noun}${n === 1 ? "" : "s"}`;
-}
-function day(seconds) {
-	return (/* @__PURE__ */ new Date(seconds * 1e3)).toISOString().slice(0, 10);
-}
-/** A labelled block: the first item beside the label, the rest under it; a dash when there is nothing. */
-function block(label, items) {
-	const [first = "—", ...rest] = items;
-	return [`${label.padEnd(LABEL_WIDTH)}${first}`, ...rest.map((item) => `${" ".repeat(LABEL_WIDTH)}${item}`)];
-}
-/** Items joined on one line, or none at all. */
-function oneLine(items) {
-	return items.length === 0 ? [] : [items.join(" · ")];
-}
-/**
-* The metrics as a person reads them in a terminal: the range, then one block
-* per figure. The cumulative flow is a series per day and has no one-screen
-* form, so the last line says how to get it.
-*/
-function describeMetrics(metrics, sprint) {
-	const column = (slug) => sanitizeTerminalText(metrics.columns.find((candidate) => candidate.slug === slug)?.name ?? slug);
-	const by = metrics.returns.byActorKind;
-	const lines = [`${day(metrics.range.from)} → ${day(metrics.range.to)}`];
-	if (sprint) lines.push(`${sanitizeTerminalText(sprint.title)}: ${sprint.cards.open + sprint.cards.done} planned · ${sprint.cards.done} done`);
-	if (metrics.range.from > metrics.range.to) return [...lines, "Nothing measured yet: the range starts after now."].join("\n");
-	lines.push(...block("Cycle time", [`p50 ${formatDuration(metrics.cycleTime.p50)} · p85 ${formatDuration(metrics.cycleTime.p85)} (${count(metrics.cycleTime.cards, "card")})`]), ...block("Lead time", [`p50 ${formatDuration(metrics.leadTime.p50)} · p85 ${formatDuration(metrics.leadTime.p85)}`]), ...block("Throughput", oneLine(metrics.throughput.map((week) => `${week.week} ${week.finished}`))), ...block("In progress", oneLine(metrics.wip.map((wip) => `${column(wip.slug)} ${wip.cards}${wip.limit === null ? "" : `/${wip.limit}`}`))), ...block("First pass", [`${percent(metrics.returns.firstPassRate)} · attempts ${decimal(metrics.attempts.perFinishedCard)} per card`]), ...block("Returns", [`${metrics.returns.total} (people ${by.user} · agents ${by.agent} · outside ${by.external}) · ${decimal(metrics.returns.perFinishedCard)} per card`]), ...block("Canceled", [String(metrics.canceled)]), ...block("Aging", metrics.aging.map((card) => `${card.issueId} ${column(card.slug)} ${formatDuration(card.ageSeconds)}${card.overCycleP85 ? " (older than p85)" : ""}`)), ...block("Time in column", oneLine(metrics.timeInColumn.filter((time) => time.seconds > 0).map((time) => `${column(time.slug)} ${formatDuration(time.seconds)}`))), ...block("Agents", metrics.agents.map(describeAgent)), ...block("People", metrics.people.map(describePerson)), "Cumulative flow by day: kanbo stats --json cumulativeFlow");
-	return lines.join("\n");
-}
-function describeAgent(agent) {
-	const { runs } = agent;
-	return `${sanitizeTerminalText(agent.agentName)}: ${count(runs.total, "run")} (${runs.finished} finished · ${runs.failed} failed · ${runs.stopped} stopped · ${runs.running} running) · median ${formatDuration(agent.medianRunSeconds)} · ${count(agent.cardsFinished, "card")} finished · ${percent(agent.returnRate)} returned`;
-}
-function describePerson(person) {
-	return `${sanitizeTerminalText(person.id ?? "unnamed")}: ${person.created} created · ${person.approvals} approved · ${person.returns} returned · ${person.moves} moved`;
-}
-const WEEK_SECONDS = 604800;
-/** The Monday that makes the range `DEFAULT_STATS_WEEKS` ISO weeks long, ending with the week of `now`. */
-function defaultStatsFrom(now) {
-	return isoWeekOf(now).start - 11 * WEEK_SECONDS;
-}
-/**
-* `kanbo stats` — how work flows on this board (spec 2026-11-05, Part 4).
-*
-* Reading only, so it is anybody's, an agent's shell included. A sprint sets
-* the range to its own dates and keeps its cards; `--from` and `--to` still
-* win over either end.
-*/
-function registerStatsCommand(program) {
-	withBoardOptions(program.command("stats").description("How work flows on this board: cycle time, throughput, work in progress, returns, agents").option("--from <date>", `first day, YYYY-MM-DD (UTC) or unix seconds (12 weeks back when left out)`, (value) => parseCalendarDay(value, false)).option("--to <date>", "last day, YYYY-MM-DD (UTC, through its end) or unix seconds (now when left out)", (value) => parseCalendarDay(value, true)).option("--sprint <id>", "only the cards of this sprint, over its dates")).action(async (options) => {
-		await runBoardCommand(options, "read", async (session) => {
-			const now = currentUnixSeconds();
-			const sprint = options.sprint === void 0 ? null : (await session.ops.listSprints(session.workspace.id, now)).find((candidate) => candidate.id === options.sprint) ?? null;
-			if (options.sprint !== void 0 && sprint === null) throw new BoardError("issue_milestone_not_found", {
-				milestoneId: options.sprint,
-				workspaceId: session.workspace.id
-			});
-			const metrics = await session.ops.boardMetrics({
-				workspaceIds: [session.workspace.id],
-				from: options.from ?? sprint?.startDate ?? defaultStatsFrom(now),
-				to: options.to ?? sprint?.dueDate ?? now,
-				milestoneId: sprint?.id ?? null
-			}, now);
-			return {
-				value: metrics,
-				text: describeMetrics(metrics, sprint),
-				fields: BOARD_METRICS_FIELDS
-			};
-		});
-	});
-}
-//#endregion
 //#region src/cli/commands/uninstall.ts
 function registerUninstallCommand(program) {
 	program.command("uninstall").description("Disconnect kanbo from your agents; the board stays unless --purge").option("--project", "only this project's files").option("--global", "only your own files, for every project").option("--purge", "also remove this project's board settings, and its board file after you confirm").option("--yes", "do it without asking (never deletes a board file)").option("--json [fields]", "print what was done as JSON; name comma-separated fields to print only those").action(async (options) => {

package/dist/lib/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_names = require("./tool-names-CjIo1rdF.cjs");
+const require_tool_names = require("./tool-names-BOUJas7m.cjs");
 const require_migrations_path = require("./migrations-path-DBCE17dT.cjs");
 exports.BINDING_FILE_PATH = require_tool_names.BINDING_FILE_PATH;
 exports.BOARD_ACTOR = require_tool_names.BOARD_ACTOR;

package/dist/lib/index.mjs

@@ -1,3 +1,3 @@
-import { $ as readChangeSeq, A as suggestCardKey, At as nextIssueIdentity, B as formatExternalSessionRef, Ct as isEmptyActivityValue, D as renderCapabilitiesMarkdown, Dt as normalizeCommentAuthorKind, Et as isOutsideWriter, F as ignoreBoardFile, G as UNMET_ENTRY_RULE_REASONS, H as pullRequestFactKeys, I as readBinding, J as readEntryRules, K as evaluateEntryRules, L as readProjectBinding, M as maskDatabaseUrl, Mt as nextIssueOrder, N as maskDatabaseUrls, Nt as readIssuePrefix, O as CARD_KEY_PATTERN, Ot as toIssueView, P as BINDING_FILE_PATH, Q as COLUMN_TEMPLATE_IDS, R as writeBinding, St as formatPlainActivityValue, Tt as readSystemCommentKind, U as ENTRY_RULES, V as parseExternalSessionRef, W as ENTRY_RULE_DESCRIPTIONS, X as COLUMN_CATALOGUE, Y as serializeEntryRules, Z as COLUMN_TEMPLATES, _t as activityKindOrder, at as computeBoardMetrics, bt as commentAuthorReference, ct as utcDayLabel, dt as DEFAULT_STATUSES, et as runBoardWrite, ft as normalizeStatusName, gt as currentUnixSeconds, ht as BOARD_ACTOR, i as BOARD_ERROR_RESPONSES, it as boardMetricsRuns, j as DEFAULT_BOARD_FILE_PATH, jt as nextIssueNumber, k as isValidCardKey, kt as formatIssueId, lt as FLOW_RULES, n as CAPABILITIES_MANIFEST_VERSION, nt as diffFieldChanges, ot as nearestRank, pt as cardDisplayTitle, q as readChecklist, r as buildCapabilitiesManifest, rt as boardMetricsAgentKey, st as isoWeekOf, t as KANBO_TOOL_NAMES, tt as TRACKED_FIELDS, ut as readFlowRules, vt as activityText, wt as parseActivityStringArray, xt as formatActivityIssueReference, yt as activityToken, z as createBoardOps } from "./tool-names-CGn-8BYp.mjs";
+import { $ as readChangeSeq, A as suggestCardKey, At as nextIssueIdentity, B as formatExternalSessionRef, Ct as isEmptyActivityValue, D as renderCapabilitiesMarkdown, Dt as normalizeCommentAuthorKind, Et as isOutsideWriter, F as ignoreBoardFile, G as UNMET_ENTRY_RULE_REASONS, H as pullRequestFactKeys, I as readBinding, J as readEntryRules, K as evaluateEntryRules, L as readProjectBinding, M as maskDatabaseUrl, Mt as nextIssueOrder, N as maskDatabaseUrls, Nt as readIssuePrefix, O as CARD_KEY_PATTERN, Ot as toIssueView, P as BINDING_FILE_PATH, Q as COLUMN_TEMPLATE_IDS, R as writeBinding, St as formatPlainActivityValue, Tt as readSystemCommentKind, U as ENTRY_RULES, V as parseExternalSessionRef, W as ENTRY_RULE_DESCRIPTIONS, X as COLUMN_CATALOGUE, Y as serializeEntryRules, Z as COLUMN_TEMPLATES, _t as activityKindOrder, at as computeBoardMetrics, bt as commentAuthorReference, ct as utcDayLabel, dt as DEFAULT_STATUSES, et as runBoardWrite, ft as normalizeStatusName, gt as currentUnixSeconds, ht as BOARD_ACTOR, i as BOARD_ERROR_RESPONSES, it as boardMetricsRuns, j as DEFAULT_BOARD_FILE_PATH, jt as nextIssueNumber, k as isValidCardKey, kt as formatIssueId, lt as FLOW_RULES, n as CAPABILITIES_MANIFEST_VERSION, nt as diffFieldChanges, ot as nearestRank, pt as cardDisplayTitle, q as readChecklist, r as buildCapabilitiesManifest, rt as boardMetricsAgentKey, st as isoWeekOf, t as KANBO_TOOL_NAMES, tt as TRACKED_FIELDS, ut as readFlowRules, vt as activityText, wt as parseActivityStringArray, xt as formatActivityIssueReference, yt as activityToken, z as createBoardOps } from "./tool-names-CrvHZ-ON.mjs";
 import { a as BoardError } from "./migrations-path-ClaYRNwk.mjs";
 export { BINDING_FILE_PATH, BOARD_ACTOR, BOARD_ERROR_RESPONSES, BoardError, CAPABILITIES_MANIFEST_VERSION, CARD_KEY_PATTERN, COLUMN_CATALOGUE, COLUMN_TEMPLATES, COLUMN_TEMPLATE_IDS, DEFAULT_BOARD_FILE_PATH, DEFAULT_STATUSES, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, FLOW_RULES, KANBO_TOOL_NAMES, TRACKED_FIELDS, UNMET_ENTRY_RULE_REASONS, activityKindOrder, activityText, activityToken, boardMetricsAgentKey, boardMetricsRuns, buildCapabilitiesManifest, cardDisplayTitle, commentAuthorReference, computeBoardMetrics, createBoardOps, currentUnixSeconds, diffFieldChanges, evaluateEntryRules, formatActivityIssueReference, formatExternalSessionRef, formatIssueId, formatPlainActivityValue, ignoreBoardFile, isEmptyActivityValue, isOutsideWriter, isValidCardKey, isoWeekOf, maskDatabaseUrl, maskDatabaseUrls, nearestRank, nextIssueIdentity, nextIssueNumber, nextIssueOrder, normalizeCommentAuthorKind, normalizeStatusName, parseActivityStringArray, parseExternalSessionRef, pullRequestFactKeys, readBinding, readChangeSeq, readChecklist, readEntryRules, readFlowRules, readIssuePrefix, readProjectBinding, readSystemCommentKind, renderCapabilitiesMarkdown, runBoardWrite, serializeEntryRules, suggestCardKey, toIssueView, utcDayLabel, writeBinding };

package/dist/lib/mcp/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_names = require("../tool-names-CjIo1rdF.cjs");
+const require_tool_names = require("../tool-names-BOUJas7m.cjs");
 const require_migrations_path = require("../migrations-path-DBCE17dT.cjs");
 let zod = require("zod");
 //#region src/mcp/http-transport.ts

package/dist/lib/mcp/index.mjs

@@ -1,4 +1,4 @@
-import { C as KANBO_MCP_INSTRUCTIONS, E as registerKanboCapabilitiesResources, S as projectKanboSubCard, T as KANBO_CAPABILITIES_RESOURCE_URI, _ as projectKanboColumn, a as KANBO_MCP_SERVER_NAME, b as projectKanboRun, c as KANBO_TOOLS, d as DEFAULT_KANBO_COMMENT_LIMIT, f as KANBO_CARD_INCLUDES, ft as normalizeStatusName, g as projectKanboCardComment, h as projectKanboCard, l as buildKanboTools, m as pageOf, mt as previewComment, o as createKanboMcpServer, p as matchesKanboCardQuery, s as registerKanboTools, t as KANBO_TOOL_NAMES, u as DEFAULT_KANBO_CARD_INCLUDES, v as projectKanboFieldChange, w as KANBO_CAPABILITIES_MARKDOWN_RESOURCE_URI, x as projectKanboSprint, y as projectKanboPullRequest } from "../tool-names-CGn-8BYp.mjs";
+import { C as KANBO_MCP_INSTRUCTIONS, E as registerKanboCapabilitiesResources, S as projectKanboSubCard, T as KANBO_CAPABILITIES_RESOURCE_URI, _ as projectKanboColumn, a as KANBO_MCP_SERVER_NAME, b as projectKanboRun, c as KANBO_TOOLS, d as DEFAULT_KANBO_COMMENT_LIMIT, f as KANBO_CARD_INCLUDES, ft as normalizeStatusName, g as projectKanboCardComment, h as projectKanboCard, l as buildKanboTools, m as pageOf, mt as previewComment, o as createKanboMcpServer, p as matchesKanboCardQuery, s as registerKanboTools, t as KANBO_TOOL_NAMES, u as DEFAULT_KANBO_CARD_INCLUDES, v as projectKanboFieldChange, w as KANBO_CAPABILITIES_MARKDOWN_RESOURCE_URI, x as projectKanboSprint, y as projectKanboPullRequest } from "../tool-names-CrvHZ-ON.mjs";
 import { a as BoardError } from "../migrations-path-ClaYRNwk.mjs";
 import { z } from "zod";
 //#region src/mcp/http-transport.ts