kanbo-cli 0.7.0 → 0.8.0

package/dist/lib/{tool-names-CGn-8BYp.mjs → tool-names-CrvHZ-ON.mjs}

@@ -6,7 +6,7 @@ import { z } from "zod";
 import { homedir, hostname, userInfo } from "node:os";
 import { createHash, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
 import { sql } from "drizzle-orm";
-import { accessSync, chmodSync, constants, existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { accessSync, chmodSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { drizzle } from "drizzle-orm/postgres-js";
 import { migrate } from "drizzle-orm/postgres-js/migrator";
@@ -5455,11 +5455,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 {
@@ -6824,7 +6841,7 @@ dirname(fileURLToPath(import.meta.url));
 * `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/setup/paths.ts
 /** Where Codex keeps its global files: `$CODEX_HOME`, else `~/.codex`. */
@@ -8162,7 +8179,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);
@@ -9331,26 +9348,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 = 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;
@@ -9532,21 +9529,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(ui, describeInitPlan(plan));
-	if (!await ui.confirm({
-		message: "Write these changes?",
-		initialValue: true
-	})) throw new CliError(1, "Nothing was written.");
 	return {
 		projectDir,
 		options,
@@ -9792,10 +9774,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;
@@ -12000,12 +11978,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">
@@ -12032,19 +12012,23 @@ function resolveBoardPageDirectory() {
 	const candidates = [join(here, "page"), join(here, "..", "..", "dist", "page")];
 	return candidates.find((directory) => existsSync(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 = join(directory, "board.js");
 	const stylesheet = join(directory, "board.css");
 	if (!existsSync(script) || !existsSync(stylesheet)) return null;
+	const fontDirectory = join(directory, "fonts");
+	const fonts = /* @__PURE__ */ new Map();
+	if (existsSync(fontDirectory)) for (const name of readdirSync(fontDirectory).filter((file) => FONT_PATH.test(`/assets/fonts/${file}`))) fonts.set(name, readFileSync(join(fontDirectory, name)));
 	return {
 		script: readFileSync(script, "utf8"),
-		stylesheet: readFileSync(stylesheet, "utf8")
+		stylesheet: 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
@@ -12063,6 +12047,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,
@@ -12408,6 +12417,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
@@ -12749,6 +12865,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 = z.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 = z.object({
+	from: unixSecondsQuery.optional(),
+	to: unixSecondsQuery.optional(),
+	sprint: z.string().min(1).optional()
+});
 /** How many cards a search answers with when the caller names no limit. */
 const DEFAULT_SEARCH_LIMIT = 20;
 /**
@@ -13044,6 +13168,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",
@@ -14037,113 +14180,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) => {