@warlock.js/core 5.30.0 → 5.32.0

package/esm/tooling/board/board.mjs

@@ -0,0 +1,407 @@
+import { WarlockError } from "../../errors/warlock-error.mjs";
+import { BOARD_DIRECTORY, BOARD_TRANSITIONS, isBoardState } from "./board.types.mjs";
+import { formatBoardMessage, parseBoardMessage } from "./board-message.mjs";
+import path from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+
+//#region ../../packages/core/src/tooling/board/board.ts
+/** Agent names: lower-case letters, digits and dashes, starting with a letter or digit. */
+const AGENT_NAME = /^[a-z0-9][a-z0-9-]*$/;
+/** How many sequence numbers a writer tries before giving up on a contended slot. */
+const MAX_ALLOCATION_ATTEMPTS = 1e3;
+/** The marker file `init` writes; its presence is what "initialized" means. */
+const BOARD_FILE = "board.json";
+function boardRoot(cwd) {
+	return path.join(cwd, BOARD_DIRECTORY);
+}
+function toPosix(value) {
+	return value.split(path.sep).join("/");
+}
+function pad(value) {
+	return String(value).padStart(4, "0");
+}
+/** A file-name slug: lower-case, dashes, at most 48 characters. */
+function boardSlug(value, fallback) {
+	const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48).replace(/-+$/g, "");
+	return slug.length > 0 ? slug : fallback;
+}
+/** Throw unless `name` is a valid agent name. */
+function assertAgentName(name, label = "agent") {
+	if (!AGENT_NAME.test(name)) throw new Error(`Invalid ${label} name ${JSON.stringify(name)}: use lower-case letters, digits and dashes (e.g. "reviewer").`);
+}
+function isErrnoException(error) {
+	return error instanceof Error && "code" in error;
+}
+/** Write a file through a temp file and a rename, so a reader never sees half of it. */
+function writeAtomic(file, content) {
+	const temporary = `${file}.${process.pid}.${Date.now()}.tmp`;
+	writeFileSync(temporary, content, "utf8");
+	renameSync(temporary, file);
+}
+/** The `NNNN` numbers of the files in a directory named `NNNN-…`. */
+function numberedEntries(directory, extension) {
+	if (!existsSync(directory)) return [];
+	return readdirSync(directory).filter((name) => !name.startsWith(".") && name.endsWith(extension)).flatMap((name) => {
+		const match = /^(\d+)-/.exec(name);
+		return match?.[1] ? [{
+			number: Number.parseInt(match[1], 10),
+			name
+		}] : [];
+	}).sort((first, second) => first.number - second.number);
+}
+/**
+* Reserve the next free sequence number in `directory` by creating
+* `.seq/NNNN` exclusively (`wx`). Two writers racing for the same number:
+* one gets `EEXIST` and moves on to the next, so numbers are never shared.
+*/
+function reserveNumber(directory, start) {
+	const sequence = path.join(directory, ".seq");
+	mkdirSync(sequence, { recursive: true });
+	for (let number = start, attempt = 0; attempt < MAX_ALLOCATION_ATTEMPTS; number++, attempt++) try {
+		writeFileSync(path.join(sequence, pad(number)), "", { flag: "wx" });
+		return number;
+	} catch (error) {
+		if (isErrnoException(error) && error.code === "EEXIST") continue;
+		throw error;
+	}
+	throw new Error(`Could not allocate a sequence number in ${directory}.`);
+}
+function nextNumber(directory, extension) {
+	const entries = numberedEntries(directory, extension);
+	return reserveNumber(directory, (entries[entries.length - 1]?.number ?? 0) + 1);
+}
+/** Throw `WL7401` unless the board exists. */
+function assertInitialized(cwd) {
+	const root = boardRoot(cwd);
+	if (!existsSync(path.join(root, BOARD_FILE))) throw new WarlockError("WL7401", `No agent board in ${BOARD_DIRECTORY}. Run \`warlock board init\` at the project root.`);
+	return root;
+}
+/** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */
+function gitignoreCoversBoard(content) {
+	const covering = /* @__PURE__ */ new Set([
+		".warlock",
+		".warlock/",
+		"/.warlock",
+		"/.warlock/",
+		".warlock/*",
+		"/.warlock/*",
+		".warlock/board",
+		".warlock/board/",
+		"/.warlock/board",
+		"/.warlock/board/"
+	]);
+	return content.split(/\r?\n/).some((line) => covering.has(line.trim()));
+}
+/**
+* Create the board (idempotent): `.warlock/board/` with its `board.json`
+* marker, `items/`, and `.warlock/board/` in `.gitignore` unless the project
+* already ignores it. A `.gitignore` is created when there is none.
+*/
+function initBoard(cwd = process.cwd(), now = () => /* @__PURE__ */ new Date()) {
+	const root = boardRoot(cwd);
+	const marker = path.join(root, BOARD_FILE);
+	const created = !existsSync(marker);
+	mkdirSync(path.join(root, "items"), { recursive: true });
+	mkdirSync(path.join(root, "cursors"), { recursive: true });
+	if (created) writeAtomic(marker, `${JSON.stringify({
+		schemaVersion: 1,
+		createdAt: now().toISOString()
+	}, null, 2)}\n`);
+	const gitignore = path.join(cwd, ".gitignore");
+	const current = existsSync(gitignore) ? readFileSync(gitignore, "utf8") : "";
+	let gitignoreUpdated = false;
+	if (!gitignoreCoversBoard(current)) {
+		const separator = current.length === 0 || current.endsWith("\n") ? "" : "\n";
+		writeFileSync(gitignore, `${current}${separator}${current.length > 0 ? "\n" : ""}# Agent board (warlock board)\n${BOARD_DIRECTORY}/\n`, "utf8");
+		gitignoreUpdated = true;
+	}
+	return {
+		directory: BOARD_DIRECTORY,
+		created,
+		gitignoreUpdated
+	};
+}
+function parseItem(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const id = Reflect.get(value, "id");
+	const title = Reflect.get(value, "title");
+	const state = Reflect.get(value, "state");
+	if (typeof id !== "number" || typeof title !== "string") return void 0;
+	if (typeof state !== "string" || !isBoardState(state)) return void 0;
+	const text = (key) => {
+		const field = Reflect.get(value, key);
+		return typeof field === "string" ? field : null;
+	};
+	const history = Reflect.get(value, "history");
+	return {
+		id,
+		title,
+		state,
+		assignee: text("assignee"),
+		reviewer: text("reviewer"),
+		createdAt: text("createdAt") ?? "",
+		updatedAt: text("updatedAt") ?? "",
+		history: Array.isArray(history) ? history.flatMap((entry) => {
+			if (typeof entry !== "object" || entry === null) return [];
+			const from = Reflect.get(entry, "from");
+			const to = Reflect.get(entry, "to");
+			const by = Reflect.get(entry, "by");
+			const at = Reflect.get(entry, "at");
+			const note = Reflect.get(entry, "note");
+			if (typeof to !== "string" || !isBoardState(to)) return [];
+			return [{
+				from: typeof from === "string" && isBoardState(from) ? from : null,
+				to,
+				by: typeof by === "string" ? by : null,
+				at: typeof at === "string" ? at : "",
+				note: typeof note === "string" ? note : null
+			}];
+		}) : []
+	};
+}
+function itemFile(root, id) {
+	const entry = numberedEntries(path.join(root, "items"), ".json").find((candidate) => candidate.number === id);
+	return entry ? path.join(root, "items", entry.name) : void 0;
+}
+/** Every item, by id. Throws `WL7401` when the board does not exist. */
+function listBoardItems(cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	const directory = path.join(root, "items");
+	return numberedEntries(directory, ".json").flatMap(({ name }) => {
+		try {
+			const item = parseItem(JSON.parse(readFileSync(path.join(directory, name), "utf8")));
+			return item ? [item] : [];
+		} catch {
+			return [];
+		}
+	});
+}
+/** One item. Throws `WL7402` for an unknown id. */
+function readBoardItem(id, cwd = process.cwd()) {
+	const file = itemFile(assertInitialized(cwd), id);
+	const item = file ? parseItem(JSON.parse(readFileSync(file, "utf8"))) : void 0;
+	if (!item) throw new WarlockError("WL7402", `Board item ${id} does not exist. Run \`warlock board status\` to list the items.`);
+	return item;
+}
+/** Add an item in state `todo`, with a fresh id no other writer can take. */
+function addBoardItem(input, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	const title = input.title.replace(/[\r\n]+/g, " ").trim();
+	if (title.length === 0) throw new Error("A board item needs a title.");
+	for (const [label, name] of [
+		["assignee", input.assignee],
+		["reviewer", input.reviewer],
+		["by", input.by]
+	]) if (name) assertAgentName(name, label);
+	const directory = path.join(root, "items");
+	const id = nextNumber(directory, ".json");
+	const at = (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	const item = {
+		id,
+		title,
+		state: "todo",
+		assignee: input.assignee ?? null,
+		reviewer: input.reviewer ?? null,
+		createdAt: at,
+		updatedAt: at,
+		history: [{
+			from: null,
+			to: "todo",
+			by: input.by ?? null,
+			at,
+			note: null
+		}]
+	};
+	writeAtomic(path.join(directory, `${pad(id)}-${boardSlug(title, "item")}.json`), `${JSON.stringify(item, null, 2)}\n`);
+	return item;
+}
+/** The states an item in `state` may move to. */
+function nextBoardStates(state) {
+	return BOARD_TRANSITIONS[state];
+}
+/** Throw `WL7403` unless `from → to` is in {@link BOARD_TRANSITIONS}. */
+function assertBoardTransition(id, from, to) {
+	if (!BOARD_TRANSITIONS[from].includes(to)) throw new WarlockError("WL7403", `Board item ${id} is "${from}" and cannot move to "${to}". Allowed next states: ${BOARD_TRANSITIONS[from].join(", ")}.`);
+}
+/**
+* Move an item to another state, recording who moved it and why. Throws
+* `WL7402` for an unknown id and `WL7403` for a move the state machine does
+* not allow.
+*/
+function moveBoardItem(id, to, options = {}, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	const item = readBoardItem(id, cwd);
+	const file = itemFile(root, id);
+	if (options.by) assertAgentName(options.by, "by");
+	assertBoardTransition(id, item.state, to);
+	const at = (options.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	const moved = {
+		...item,
+		state: to,
+		updatedAt: at,
+		history: [...item.history, {
+			from: item.state,
+			to,
+			by: options.by ?? null,
+			at,
+			note: options.note ?? null
+		}]
+	};
+	if (file) writeAtomic(file, `${JSON.stringify(moved, null, 2)}\n`);
+	return moved;
+}
+function inboxDirectory(root, agent) {
+	return path.join(root, `to-${agent}`);
+}
+/**
+* Write a message to `to-<agent>/NNNN-<slug>.md`. Messages are append-only:
+* the number is reserved exclusively and the file is created with `wx`, so it
+* is never rewritten. A verdict with an `item` also moves the item to
+* `approved` / `changes-requested` — before the message is written, so a
+* refused move (`WL7403`) leaves no message behind.
+*/
+function sendBoardMessage(input, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	assertAgentName(input.to, "recipient");
+	assertAgentName(input.from, "sender");
+	const subject = input.subject.replace(/[\r\n]+/g, " ").trim();
+	if (subject.length === 0) throw new Error("A board message needs a subject.");
+	const itemId = input.item ?? null;
+	const verdict = input.verdict ?? null;
+	const now = input.now ?? (() => /* @__PURE__ */ new Date());
+	if (itemId !== null) readBoardItem(itemId, cwd);
+	const item = itemId !== null && verdict !== null ? moveBoardItem(itemId, verdict, {
+		by: input.from,
+		note: subject,
+		now
+	}, cwd) : null;
+	const directory = inboxDirectory(root, input.to);
+	mkdirSync(directory, { recursive: true });
+	const number = nextNumber(directory, ".md");
+	const at = now().toISOString();
+	const name = `${pad(number)}-${boardSlug(subject, "message")}.md`;
+	const file = path.join(directory, name);
+	writeFileSync(file, formatBoardMessage({
+		from: input.from,
+		to: input.to,
+		item: itemId,
+		subject,
+		at
+	}, input.body ?? "", verdict), {
+		encoding: "utf8",
+		flag: "wx"
+	});
+	return {
+		message: {
+			number,
+			file: toPosix(path.relative(cwd, file)),
+			from: input.from,
+			to: input.to,
+			item: itemId,
+			subject,
+			at,
+			body: (input.body ?? "").replace(/\s+$/, ""),
+			verdict
+		},
+		item
+	};
+}
+/** The messages in an agent's inbox numbered above `since`, oldest first. */
+function listBoardMessages(agent, options = {}, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	assertAgentName(agent);
+	const directory = inboxDirectory(root, agent);
+	const since = options.since ?? 0;
+	return numberedEntries(directory, ".md").filter((entry) => entry.number > since).map(({ number, name }) => {
+		const file = path.join(directory, name);
+		const parsed = parseBoardMessage(readFileSync(file, "utf8"));
+		return {
+			number,
+			file: toPosix(path.relative(cwd, file)),
+			from: parsed.from,
+			to: parsed.to || agent,
+			item: parsed.item,
+			subject: parsed.subject,
+			at: parsed.at,
+			body: parsed.body,
+			verdict: parsed.verdict
+		};
+	});
+}
+/** The highest message number `watch` has returned to `agent` (0 when none). */
+function readBoardCursor(agent, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	assertAgentName(agent);
+	const file = path.join(root, "cursors", agent);
+	if (!existsSync(file)) return 0;
+	const value = Number.parseInt(readFileSync(file, "utf8").trim(), 10);
+	return Number.isInteger(value) && value > 0 ? value : 0;
+}
+/** Record that `agent` has seen messages up to `number`. Never moves the cursor back. */
+function writeBoardCursor(agent, number, cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	const current = readBoardCursor(agent, cwd);
+	const next = Math.max(current, number);
+	if (next !== current) {
+		mkdirSync(path.join(root, "cursors"), { recursive: true });
+		writeAtomic(path.join(root, "cursors", agent), `${next}\n`);
+	}
+	return next;
+}
+/** Every item and every inbox with its message count, cursor and unread count. */
+function readBoardStatus(cwd = process.cwd()) {
+	const root = assertInitialized(cwd);
+	const inboxes = readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.startsWith("to-")).map((entry) => entry.name.slice(3)).filter((agent) => /^[a-z0-9][a-z0-9-]*$/.test(agent)).sort().map((agent) => {
+		const numbers = numberedEntries(inboxDirectory(root, agent), ".md").map((entry) => entry.number);
+		const cursor = readBoardCursor(agent, cwd);
+		return {
+			agent,
+			messages: numbers.length,
+			cursor,
+			unread: numbers.filter((number) => number > cursor).length
+		};
+	});
+	return {
+		schemaVersion: 1,
+		items: listBoardItems(cwd),
+		inboxes
+	};
+}
+/**
+* Block until `agent` has a message numbered above `since` (default: its
+* cursor), then return every such message and advance the cursor past them.
+*
+* Polls the inbox every `intervalMs`; throws `WL7404` when `timeoutMs` passes
+* first. An aborted `signal` resolves with no messages.
+*/
+async function watchBoard(options, cwd = process.cwd()) {
+	assertInitialized(cwd);
+	assertAgentName(options.agent);
+	const since = options.since ?? readBoardCursor(options.agent, cwd);
+	const timeoutMs = options.timeoutMs ?? 6e5;
+	const intervalMs = options.intervalMs ?? 250;
+	const deadline = Date.now() + timeoutMs;
+	for (;;) {
+		const messages = listBoardMessages(options.agent, { since }, cwd);
+		if (messages.length > 0) {
+			const newest = messages[messages.length - 1]?.number ?? since;
+			return {
+				agent: options.agent,
+				messages,
+				cursor: writeBoardCursor(options.agent, newest, cwd)
+			};
+		}
+		if (options.signal?.aborted) return {
+			agent: options.agent,
+			messages: [],
+			cursor: readBoardCursor(options.agent, cwd)
+		};
+		const remaining = deadline - Date.now();
+		if (remaining <= 0) throw new WarlockError("WL7404", `No new message for "${options.agent}" after ${Math.round(timeoutMs / 1e3)}s (watching messages above #${since}).`);
+		await new Promise((resolve) => setTimeout(resolve, Math.min(intervalMs, remaining)));
+	}
+}
+
+//#endregion
+export { addBoardItem, assertAgentName, assertBoardTransition, boardSlug, gitignoreCoversBoard, initBoard, listBoardItems, listBoardMessages, moveBoardItem, nextBoardStates, readBoardCursor, readBoardItem, readBoardStatus, sendBoardMessage, watchBoard, writeBoardCursor };
+//# sourceMappingURL=board.mjs.map

package/esm/tooling/board/board.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  writeFileSync,\n} from \"node:fs\";\nimport path from \"node:path\";\nimport { WarlockError } from \"../../errors/warlock-error\";\nimport { formatBoardMessage, parseBoardMessage } from \"./board-message\";\nimport {\n  BOARD_DIRECTORY,\n  BOARD_TRANSITIONS,\n  type BoardInbox,\n  type BoardItem,\n  type BoardMessage,\n  type BoardState,\n  type BoardStatus,\n  type BoardVerdict,\n  isBoardState,\n} from \"./board.types\";\n\n/** Agent names: lower-case letters, digits and dashes, starting with a letter or digit. */\nconst AGENT_NAME = /^[a-z0-9][a-z0-9-]*$/;\n\n/** How many sequence numbers a writer tries before giving up on a contended slot. */\nconst MAX_ALLOCATION_ATTEMPTS = 1000;\n\n/** The marker file `init` writes; its presence is what \"initialized\" means. */\nconst BOARD_FILE = \"board.json\";\n\n/** What `initBoard` did. */\nexport type InitBoardResult = {\n  /** The board directory, relative to the project root. */\n  directory: string;\n  /** `false` when the board already existed. */\n  created: boolean;\n  /** Whether `.warlock/board/` was added to `.gitignore` by this call. */\n  gitignoreUpdated: boolean;\n};\n\n/** Inputs of {@link addBoardItem}. */\nexport type AddBoardItemInput = {\n  title: string;\n  assignee?: string | null;\n  reviewer?: string | null;\n  /** The agent creating it, recorded in the history. */\n  by?: string | null;\n  /** Clock, for tests. */\n  now?: () => Date;\n};\n\n/** Inputs of {@link moveBoardItem}. */\nexport type MoveBoardItemOptions = {\n  by?: string | null;\n  note?: string | null;\n  now?: () => Date;\n};\n\n/** Inputs of {@link sendBoardMessage}. */\nexport type SendBoardMessageInput = {\n  to: string;\n  from: string;\n  subject: string;\n  body?: string;\n  /** The item the message is about. */\n  item?: number | null;\n  /** A review verdict; with `item`, also moves the item to that state. */\n  verdict?: BoardVerdict | null;\n  now?: () => Date;\n};\n\n/** What {@link sendBoardMessage} wrote. */\nexport type SendBoardMessageResult = {\n  message: BoardMessage;\n  /** The item after the verdict moved it, when the message carried one. */\n  item: BoardItem | null;\n};\n\n/** Inputs of {@link watchBoard}. */\nexport type WatchBoardOptions = {\n  agent: string;\n  /** Return messages numbered above this. Default: the agent's cursor. */\n  since?: number;\n  /** Give up after this long; throws `WL7404`. Default: 10 minutes. */\n  timeoutMs?: number;\n  /** Poll interval. Default: 250 ms. */\n  intervalMs?: number;\n  /** Stop early (resolves with no messages). */\n  signal?: AbortSignal;\n};\n\n/** What {@link watchBoard} returned. */\nexport type WatchBoardResult = {\n  agent: string;\n  /** The new messages, oldest first. */\n  messages: BoardMessage[];\n  /** The agent's cursor after the call. */\n  cursor: number;\n};\n\nfunction boardRoot(cwd: string): string {\n  return path.join(cwd, BOARD_DIRECTORY);\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nfunction pad(value: number): string {\n  return String(value).padStart(4, \"0\");\n}\n\n/** A file-name slug: lower-case, dashes, at most 48 characters. */\nexport function boardSlug(value: string, fallback: string): string {\n  const slug = value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 48)\n    .replace(/-+$/g, \"\");\n\n  return slug.length > 0 ? slug : fallback;\n}\n\n/** Throw unless `name` is a valid agent name. */\nexport function assertAgentName(name: string, label = \"agent\"): void {\n  if (!AGENT_NAME.test(name)) {\n    throw new Error(\n      `Invalid ${label} name ${JSON.stringify(name)}: use lower-case letters, digits and dashes (e.g. \"reviewer\").`,\n    );\n  }\n}\n\nfunction isErrnoException(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && \"code\" in error;\n}\n\n/** Write a file through a temp file and a rename, so a reader never sees half of it. */\nfunction writeAtomic(file: string, content: string): void {\n  const temporary = `${file}.${process.pid}.${Date.now()}.tmp`;\n\n  writeFileSync(temporary, content, \"utf8\");\n  renameSync(temporary, file);\n}\n\n/** The `NNNN` numbers of the files in a directory named `NNNN-…`. */\nfunction numberedEntries(directory: string, extension: string): { number: number; name: string }[] {\n  if (!existsSync(directory)) return [];\n\n  return readdirSync(directory)\n    .filter((name) => !name.startsWith(\".\") && name.endsWith(extension))\n    .flatMap((name) => {\n      const match = /^(\\d+)-/.exec(name);\n      return match?.[1] ? [{ number: Number.parseInt(match[1], 10), name }] : [];\n    })\n    .sort((first, second) => first.number - second.number);\n}\n\n/**\n * Reserve the next free sequence number in `directory` by creating\n * `.seq/NNNN` exclusively (`wx`). Two writers racing for the same number:\n * one gets `EEXIST` and moves on to the next, so numbers are never shared.\n */\nfunction reserveNumber(directory: string, start: number): number {\n  const sequence = path.join(directory, \".seq\");\n\n  mkdirSync(sequence, { recursive: true });\n\n  for (let number = start, attempt = 0; attempt < MAX_ALLOCATION_ATTEMPTS; number++, attempt++) {\n    try {\n      writeFileSync(path.join(sequence, pad(number)), \"\", { flag: \"wx\" });\n      return number;\n    } catch (error) {\n      if (isErrnoException(error) && error.code === \"EEXIST\") continue;\n      throw error;\n    }\n  }\n\n  throw new Error(`Could not allocate a sequence number in ${directory}.`);\n}\n\nfunction nextNumber(directory: string, extension: string): number {\n  const entries = numberedEntries(directory, extension);\n  const highest = entries[entries.length - 1]?.number ?? 0;\n\n  return reserveNumber(directory, highest + 1);\n}\n\n/** Throw `WL7401` unless the board exists. */\nfunction assertInitialized(cwd: string): string {\n  const root = boardRoot(cwd);\n\n  if (!existsSync(path.join(root, BOARD_FILE))) {\n    throw new WarlockError(\n      \"WL7401\",\n      `No agent board in ${BOARD_DIRECTORY}. Run \\`warlock board init\\` at the project root.`,\n    );\n  }\n\n  return root;\n}\n\n/** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */\nexport function gitignoreCoversBoard(content: string): boolean {\n  const covering = new Set([\n    \".warlock\",\n    \".warlock/\",\n    \"/.warlock\",\n    \"/.warlock/\",\n    \".warlock/*\",\n    \"/.warlock/*\",\n    \".warlock/board\",\n    \".warlock/board/\",\n    \"/.warlock/board\",\n    \"/.warlock/board/\",\n  ]);\n\n  return content.split(/\\r?\\n/).some((line) => covering.has(line.trim()));\n}\n\n/**\n * Create the board (idempotent): `.warlock/board/` with its `board.json`\n * marker, `items/`, and `.warlock/board/` in `.gitignore` unless the project\n * already ignores it. A `.gitignore` is created when there is none.\n */\nexport function initBoard(\n  cwd = process.cwd(),\n  now: () => Date = () => new Date(),\n): InitBoardResult {\n  const root = boardRoot(cwd);\n  const marker = path.join(root, BOARD_FILE);\n  const created = !existsSync(marker);\n\n  mkdirSync(path.join(root, \"items\"), { recursive: true });\n  mkdirSync(path.join(root, \"cursors\"), { recursive: true });\n\n  if (created) {\n    writeAtomic(\n      marker,\n      `${JSON.stringify({ schemaVersion: 1, createdAt: now().toISOString() }, null, 2)}\\n`,\n    );\n  }\n\n  const gitignore = path.join(cwd, \".gitignore\");\n  const current = existsSync(gitignore) ? readFileSync(gitignore, \"utf8\") : \"\";\n  let gitignoreUpdated = false;\n\n  if (!gitignoreCoversBoard(current)) {\n    const separator = current.length === 0 || current.endsWith(\"\\n\") ? \"\" : \"\\n\";\n\n    writeFileSync(\n      gitignore,\n      `${current}${separator}${current.length > 0 ? \"\\n\" : \"\"}# Agent board (warlock board)\\n${BOARD_DIRECTORY}/\\n`,\n      \"utf8\",\n    );\n    gitignoreUpdated = true;\n  }\n\n  return { directory: BOARD_DIRECTORY, created, gitignoreUpdated };\n}\n\nfunction parseItem(value: unknown): BoardItem | undefined {\n  if (typeof value !== \"object\" || value === null) return undefined;\n\n  const id = Reflect.get(value, \"id\");\n  const title = Reflect.get(value, \"title\");\n  const state = Reflect.get(value, \"state\");\n\n  if (typeof id !== \"number\" || typeof title !== \"string\") return undefined;\n  if (typeof state !== \"string\" || !isBoardState(state)) return undefined;\n\n  const text = (key: string): string | null => {\n    const field = Reflect.get(value, key);\n    return typeof field === \"string\" ? field : null;\n  };\n  const history = Reflect.get(value, \"history\");\n\n  return {\n    id,\n    title,\n    state,\n    assignee: text(\"assignee\"),\n    reviewer: text(\"reviewer\"),\n    createdAt: text(\"createdAt\") ?? \"\",\n    updatedAt: text(\"updatedAt\") ?? \"\",\n    history: Array.isArray(history)\n      ? history.flatMap((entry: unknown) => {\n          if (typeof entry !== \"object\" || entry === null) return [];\n\n          const from = Reflect.get(entry, \"from\");\n          const to = Reflect.get(entry, \"to\");\n          const by = Reflect.get(entry, \"by\");\n          const at = Reflect.get(entry, \"at\");\n          const note = Reflect.get(entry, \"note\");\n\n          if (typeof to !== \"string\" || !isBoardState(to)) return [];\n\n          return [\n            {\n              from: typeof from === \"string\" && isBoardState(from) ? from : null,\n              to,\n              by: typeof by === \"string\" ? by : null,\n              at: typeof at === \"string\" ? at : \"\",\n              note: typeof note === \"string\" ? note : null,\n            },\n          ];\n        })\n      : [],\n  };\n}\n\nfunction itemFile(root: string, id: number): string | undefined {\n  const entry = numberedEntries(path.join(root, \"items\"), \".json\").find(\n    (candidate) => candidate.number === id,\n  );\n\n  return entry ? path.join(root, \"items\", entry.name) : undefined;\n}\n\n/** Every item, by id. Throws `WL7401` when the board does not exist. */\nexport function listBoardItems(cwd = process.cwd()): BoardItem[] {\n  const root = assertInitialized(cwd);\n  const directory = path.join(root, \"items\");\n\n  return numberedEntries(directory, \".json\").flatMap(({ name }) => {\n    try {\n      const item = parseItem(JSON.parse(readFileSync(path.join(directory, name), \"utf8\")));\n      return item ? [item] : [];\n    } catch {\n      return [];\n    }\n  });\n}\n\n/** One item. Throws `WL7402` for an unknown id. */\nexport function readBoardItem(id: number, cwd = process.cwd()): BoardItem {\n  const root = assertInitialized(cwd);\n  const file = itemFile(root, id);\n  const item = file ? parseItem(JSON.parse(readFileSync(file, \"utf8\"))) : undefined;\n\n  if (!item) {\n    throw new WarlockError(\n      \"WL7402\",\n      `Board item ${id} does not exist. Run \\`warlock board status\\` to list the items.`,\n    );\n  }\n\n  return item;\n}\n\n/** Add an item in state `todo`, with a fresh id no other writer can take. */\nexport function addBoardItem(input: AddBoardItemInput, cwd = process.cwd()): BoardItem {\n  const root = assertInitialized(cwd);\n  const title = input.title.replace(/[\\r\\n]+/g, \" \").trim();\n\n  if (title.length === 0) throw new Error(\"A board item needs a title.\");\n\n  for (const [label, name] of [\n    [\"assignee\", input.assignee],\n    [\"reviewer\", input.reviewer],\n    [\"by\", input.by],\n  ] as const) {\n    if (name) assertAgentName(name, label);\n  }\n\n  const directory = path.join(root, \"items\");\n  const id = nextNumber(directory, \".json\");\n  const at = (input.now ?? (() => new Date()))().toISOString();\n  const item: BoardItem = {\n    id,\n    title,\n    state: \"todo\",\n    assignee: input.assignee ?? null,\n    reviewer: input.reviewer ?? null,\n    createdAt: at,\n    updatedAt: at,\n    history: [{ from: null, to: \"todo\", by: input.by ?? null, at, note: null }],\n  };\n\n  writeAtomic(\n    path.join(directory, `${pad(id)}-${boardSlug(title, \"item\")}.json`),\n    `${JSON.stringify(item, null, 2)}\\n`,\n  );\n\n  return item;\n}\n\n/** The states an item in `state` may move to. */\nexport function nextBoardStates(state: BoardState): readonly BoardState[] {\n  return BOARD_TRANSITIONS[state];\n}\n\n/** Throw `WL7403` unless `from → to` is in {@link BOARD_TRANSITIONS}. */\nexport function assertBoardTransition(id: number, from: BoardState, to: BoardState): void {\n  if (!BOARD_TRANSITIONS[from].includes(to)) {\n    throw new WarlockError(\n      \"WL7403\",\n      `Board item ${id} is \"${from}\" and cannot move to \"${to}\". Allowed next states: ${BOARD_TRANSITIONS[from].join(\", \")}.`,\n    );\n  }\n}\n\n/**\n * Move an item to another state, recording who moved it and why. Throws\n * `WL7402` for an unknown id and `WL7403` for a move the state machine does\n * not allow.\n */\nexport function moveBoardItem(\n  id: number,\n  to: BoardState,\n  options: MoveBoardItemOptions = {},\n  cwd = process.cwd(),\n): BoardItem {\n  const root = assertInitialized(cwd);\n  const item = readBoardItem(id, cwd);\n  const file = itemFile(root, id);\n\n  if (options.by) assertAgentName(options.by, \"by\");\n\n  assertBoardTransition(id, item.state, to);\n\n  const at = (options.now ?? (() => new Date()))().toISOString();\n  const moved: BoardItem = {\n    ...item,\n    state: to,\n    updatedAt: at,\n    history: [\n      ...item.history,\n      { from: item.state, to, by: options.by ?? null, at, note: options.note ?? null },\n    ],\n  };\n\n  if (file) writeAtomic(file, `${JSON.stringify(moved, null, 2)}\\n`);\n\n  return moved;\n}\n\nfunction inboxDirectory(root: string, agent: string): string {\n  return path.join(root, `to-${agent}`);\n}\n\n/**\n * Write a message to `to-<agent>/NNNN-<slug>.md`. Messages are append-only:\n * the number is reserved exclusively and the file is created with `wx`, so it\n * is never rewritten. A verdict with an `item` also moves the item to\n * `approved` / `changes-requested` — before the message is written, so a\n * refused move (`WL7403`) leaves no message behind.\n */\nexport function sendBoardMessage(\n  input: SendBoardMessageInput,\n  cwd = process.cwd(),\n): SendBoardMessageResult {\n  const root = assertInitialized(cwd);\n\n  assertAgentName(input.to, \"recipient\");\n  assertAgentName(input.from, \"sender\");\n\n  const subject = input.subject.replace(/[\\r\\n]+/g, \" \").trim();\n\n  if (subject.length === 0) throw new Error(\"A board message needs a subject.\");\n\n  const itemId = input.item ?? null;\n  const verdict = input.verdict ?? null;\n  const now = input.now ?? (() => new Date());\n\n  if (itemId !== null) readBoardItem(itemId, cwd);\n\n  const item =\n    itemId !== null && verdict !== null\n      ? moveBoardItem(itemId, verdict, { by: input.from, note: subject, now }, cwd)\n      : null;\n\n  const directory = inboxDirectory(root, input.to);\n\n  mkdirSync(directory, { recursive: true });\n\n  const number = nextNumber(directory, \".md\");\n  const at = now().toISOString();\n  const name = `${pad(number)}-${boardSlug(subject, \"message\")}.md`;\n  const file = path.join(directory, name);\n\n  writeFileSync(\n    file,\n    formatBoardMessage(\n      { from: input.from, to: input.to, item: itemId, subject, at },\n      input.body ?? \"\",\n      verdict,\n    ),\n    { encoding: \"utf8\", flag: \"wx\" },\n  );\n\n  return {\n    message: {\n      number,\n      file: toPosix(path.relative(cwd, file)),\n      from: input.from,\n      to: input.to,\n      item: itemId,\n      subject,\n      at,\n      body: (input.body ?? \"\").replace(/\\s+$/, \"\"),\n      verdict,\n    },\n    item,\n  };\n}\n\n/** The messages in an agent's inbox numbered above `since`, oldest first. */\nexport function listBoardMessages(\n  agent: string,\n  options: { since?: number } = {},\n  cwd = process.cwd(),\n): BoardMessage[] {\n  const root = assertInitialized(cwd);\n\n  assertAgentName(agent);\n\n  const directory = inboxDirectory(root, agent);\n  const since = options.since ?? 0;\n\n  return numberedEntries(directory, \".md\")\n    .filter((entry) => entry.number > since)\n    .map(({ number, name }) => {\n      const file = path.join(directory, name);\n      const parsed = parseBoardMessage(readFileSync(file, \"utf8\"));\n\n      return {\n        number,\n        file: toPosix(path.relative(cwd, file)),\n        from: parsed.from,\n        to: parsed.to || agent,\n        item: parsed.item,\n        subject: parsed.subject,\n        at: parsed.at,\n        body: parsed.body,\n        verdict: parsed.verdict,\n      };\n    });\n}\n\n/** The highest message number `watch` has returned to `agent` (0 when none). */\nexport function readBoardCursor(agent: string, cwd = process.cwd()): number {\n  const root = assertInitialized(cwd);\n\n  assertAgentName(agent);\n\n  const file = path.join(root, \"cursors\", agent);\n\n  if (!existsSync(file)) return 0;\n\n  const value = Number.parseInt(readFileSync(file, \"utf8\").trim(), 10);\n\n  return Number.isInteger(value) && value > 0 ? value : 0;\n}\n\n/** Record that `agent` has seen messages up to `number`. Never moves the cursor back. */\nexport function writeBoardCursor(agent: string, number: number, cwd = process.cwd()): number {\n  const root = assertInitialized(cwd);\n  const current = readBoardCursor(agent, cwd);\n  const next = Math.max(current, number);\n\n  if (next !== current) {\n    mkdirSync(path.join(root, \"cursors\"), { recursive: true });\n    writeAtomic(path.join(root, \"cursors\", agent), `${next}\\n`);\n  }\n\n  return next;\n}\n\n/** Every item and every inbox with its message count, cursor and unread count. */\nexport function readBoardStatus(cwd = process.cwd()): BoardStatus {\n  const root = assertInitialized(cwd);\n  const inboxes: BoardInbox[] = readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory() && entry.name.startsWith(\"to-\"))\n    .map((entry) => entry.name.slice(3))\n    .filter((agent) => /^[a-z0-9][a-z0-9-]*$/.test(agent))\n    .sort()\n    .map((agent) => {\n      const numbers = numberedEntries(inboxDirectory(root, agent), \".md\").map(\n        (entry) => entry.number,\n      );\n      const cursor = readBoardCursor(agent, cwd);\n\n      return {\n        agent,\n        messages: numbers.length,\n        cursor,\n        unread: numbers.filter((number) => number > cursor).length,\n      };\n    });\n\n  return { schemaVersion: 1, items: listBoardItems(cwd), inboxes };\n}\n\n/**\n * Block until `agent` has a message numbered above `since` (default: its\n * cursor), then return every such message and advance the cursor past them.\n *\n * Polls the inbox every `intervalMs`; throws `WL7404` when `timeoutMs` passes\n * first. An aborted `signal` resolves with no messages.\n */\nexport async function watchBoard(\n  options: WatchBoardOptions,\n  cwd = process.cwd(),\n): Promise<WatchBoardResult> {\n  assertInitialized(cwd);\n  assertAgentName(options.agent);\n\n  const since = options.since ?? readBoardCursor(options.agent, cwd);\n  const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;\n  const intervalMs = options.intervalMs ?? 250;\n  const deadline = Date.now() + timeoutMs;\n\n  for (;;) {\n    const messages = listBoardMessages(options.agent, { since }, cwd);\n\n    if (messages.length > 0) {\n      const newest = messages[messages.length - 1]?.number ?? since;\n\n      return {\n        agent: options.agent,\n        messages,\n        cursor: writeBoardCursor(options.agent, newest, cwd),\n      };\n    }\n\n    if (options.signal?.aborted) {\n      return { agent: options.agent, messages: [], cursor: readBoardCursor(options.agent, cwd) };\n    }\n\n    const remaining = deadline - Date.now();\n\n    if (remaining <= 0) {\n      throw new WarlockError(\n        \"WL7404\",\n        `No new message for \"${options.agent}\" after ${Math.round(timeoutMs / 1000)}s (watching messages above #${since}).`,\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, Math.min(intervalMs, remaining)));\n  }\n}\n"],"mappings":"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"}

package/esm/tooling/board/board.types.d.mts

@@ -0,0 +1,81 @@
+//#region ../../packages/core/src/tooling/board/board.types.d.ts
+/**
+ * Types and the state machine of the agent board (`warlock board`): a
+ * git-ignored folder two coding agents — usually an implementer and a
+ * reviewer — share to track work items and exchange append-only messages.
+ */
+/** Where the board lives, under the project root. */
+export declare const BOARD_DIRECTORY = ".warlock/board";
+/** Every state an item can be in. */
+export declare const BOARD_STATES: readonly ["todo", "in-progress", "ready-for-review", "changes-requested", "approved", "blocked"];
+/** One item state. */
+export type BoardState = (typeof BOARD_STATES)[number];
+/**
+ * The allowed moves: an item in the key state may move to any listed state,
+ * and nowhere else. `approved` may only be reopened (`in-progress`).
+ */
+export declare const BOARD_TRANSITIONS: Readonly<Record<BoardState, readonly BoardState[]>>;
+/** A review verdict a message can carry. */
+export type BoardVerdict = "approved" | "changes-requested";
+/** The exact final line each verdict is written as. */
+export declare const BOARD_VERDICT_LINES: Readonly<Record<BoardVerdict, string>>;
+/** One recorded state change of an item. */
+export type BoardHistoryEntry = {
+  /** `null` for the creation entry. */
+  from: BoardState | null;
+  to: BoardState;
+  /** The agent that made the move, or `null` when not given. */
+  by: string | null;
+  /** ISO time. */
+  at: string;
+  note: string | null;
+};
+/** One work item, stored as `items/NNNN-<slug>.json`. */
+export type BoardItem = {
+  id: number;
+  title: string;
+  state: BoardState;
+  assignee: string | null;
+  reviewer: string | null;
+  createdAt: string;
+  updatedAt: string;
+  history: BoardHistoryEntry[];
+};
+/** One message, stored as `to-<agent>/NNNN-<slug>.md`. */
+export type BoardMessage = {
+  /** The per-recipient sequence number (`NNNN`). */
+  number: number;
+  /** Path relative to the project root, POSIX separators. */
+  file: string;
+  from: string;
+  to: string;
+  /** The item the message is about, or `null`. */
+  item: number | null;
+  subject: string;
+  /** ISO time. */
+  at: string;
+  body: string;
+  verdict: BoardVerdict | null;
+};
+/** One recipient's inbox, as `readBoardStatus` reports it. */
+export type BoardInbox = {
+  agent: string;
+  /** Messages in the inbox. */
+  messages: number;
+  /** The highest message number `watch` has returned to this agent (0 = none). */
+  cursor: number;
+  /** Messages numbered above the cursor. */
+  unread: number;
+};
+/** What `warlock board status --json` prints without an item id. */
+export type BoardStatus = {
+  schemaVersion: 1;
+  items: BoardItem[];
+  inboxes: BoardInbox[];
+};
+/** Whether a string is a board state. */
+export declare function isBoardState(value: string): value is BoardState;
+/** Whether a string is a verdict. */
+export declare function isBoardVerdict(value: string): value is BoardVerdict;
+//#endregion
+//# sourceMappingURL=board.types.d.mts.map

package/esm/tooling/board/board.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.types.ts"],"mappings":";;;;;;;qBAOa;;qBAGA;;YAUD,qBAAqB;;;;;qBAMpB,mBAAmB,SAAS,OAAO,qBAAqB;;YAUzD;;qBAGC,qBAAqB,SAAS,OAAO;;YAMtC;;EAEV,MAAM;EACN,IAAI;;EAEJ;;EAEA;EACA;;;YAIU;EACV;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;EACA,SAAS;;;YAIC;;EAEV;;EAEA;EACA;EACA;;EAEA;EACA;;EAEA;EACA;EACA,SAAS;;;YAIC;EACV;;EAEA;;EAEA;;EAEA;;;YAIU;EACV;EACA,OAAO;EACP,SAAS;;;wBAIK,aAAa,gBAAgB,SAAS;;wBAKtC,eAAe,gBAAgB,SAAS"}

package/esm/tooling/board/board.types.mjs

@@ -0,0 +1,54 @@
+//#region ../../packages/core/src/tooling/board/board.types.ts
+/**
+* Types and the state machine of the agent board (`warlock board`): a
+* git-ignored folder two coding agents — usually an implementer and a
+* reviewer — share to track work items and exchange append-only messages.
+*/
+/** Where the board lives, under the project root. */
+const BOARD_DIRECTORY = ".warlock/board";
+/** Every state an item can be in. */
+const BOARD_STATES = [
+	"todo",
+	"in-progress",
+	"ready-for-review",
+	"changes-requested",
+	"approved",
+	"blocked"
+];
+/**
+* The allowed moves: an item in the key state may move to any listed state,
+* and nowhere else. `approved` may only be reopened (`in-progress`).
+*/
+const BOARD_TRANSITIONS = {
+	todo: ["in-progress", "blocked"],
+	"in-progress": [
+		"ready-for-review",
+		"blocked",
+		"todo"
+	],
+	"ready-for-review": [
+		"approved",
+		"changes-requested",
+		"in-progress"
+	],
+	"changes-requested": ["in-progress", "blocked"],
+	approved: ["in-progress"],
+	blocked: ["todo", "in-progress"]
+};
+/** The exact final line each verdict is written as. */
+const BOARD_VERDICT_LINES = {
+	approved: "VERDICT: APPROVED",
+	"changes-requested": "VERDICT: CHANGES REQUESTED"
+};
+/** Whether a string is a board state. */
+function isBoardState(value) {
+	return BOARD_STATES.includes(value);
+}
+/** Whether a string is a verdict. */
+function isBoardVerdict(value) {
+	return value === "approved" || value === "changes-requested";
+}
+
+//#endregion
+export { BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, isBoardState, isBoardVerdict };
+//# sourceMappingURL=board.types.mjs.map

package/esm/tooling/board/board.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.types.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.types.ts"],"sourcesContent":["/**\n * Types and the state machine of the agent board (`warlock board`): a\n * git-ignored folder two coding agents — usually an implementer and a\n * reviewer — share to track work items and exchange append-only messages.\n */\n\n/** Where the board lives, under the project root. */\nexport const BOARD_DIRECTORY = \".warlock/board\";\n\n/** Every state an item can be in. */\nexport const BOARD_STATES = [\n  \"todo\",\n  \"in-progress\",\n  \"ready-for-review\",\n  \"changes-requested\",\n  \"approved\",\n  \"blocked\",\n] as const;\n\n/** One item state. */\nexport type BoardState = (typeof BOARD_STATES)[number];\n\n/**\n * The allowed moves: an item in the key state may move to any listed state,\n * and nowhere else. `approved` may only be reopened (`in-progress`).\n */\nexport const BOARD_TRANSITIONS: Readonly<Record<BoardState, readonly BoardState[]>> = {\n  todo: [\"in-progress\", \"blocked\"],\n  \"in-progress\": [\"ready-for-review\", \"blocked\", \"todo\"],\n  \"ready-for-review\": [\"approved\", \"changes-requested\", \"in-progress\"],\n  \"changes-requested\": [\"in-progress\", \"blocked\"],\n  approved: [\"in-progress\"],\n  blocked: [\"todo\", \"in-progress\"],\n};\n\n/** A review verdict a message can carry. */\nexport type BoardVerdict = \"approved\" | \"changes-requested\";\n\n/** The exact final line each verdict is written as. */\nexport const BOARD_VERDICT_LINES: Readonly<Record<BoardVerdict, string>> = {\n  approved: \"VERDICT: APPROVED\",\n  \"changes-requested\": \"VERDICT: CHANGES REQUESTED\",\n};\n\n/** One recorded state change of an item. */\nexport type BoardHistoryEntry = {\n  /** `null` for the creation entry. */\n  from: BoardState | null;\n  to: BoardState;\n  /** The agent that made the move, or `null` when not given. */\n  by: string | null;\n  /** ISO time. */\n  at: string;\n  note: string | null;\n};\n\n/** One work item, stored as `items/NNNN-<slug>.json`. */\nexport type BoardItem = {\n  id: number;\n  title: string;\n  state: BoardState;\n  assignee: string | null;\n  reviewer: string | null;\n  createdAt: string;\n  updatedAt: string;\n  history: BoardHistoryEntry[];\n};\n\n/** One message, stored as `to-<agent>/NNNN-<slug>.md`. */\nexport type BoardMessage = {\n  /** The per-recipient sequence number (`NNNN`). */\n  number: number;\n  /** Path relative to the project root, POSIX separators. */\n  file: string;\n  from: string;\n  to: string;\n  /** The item the message is about, or `null`. */\n  item: number | null;\n  subject: string;\n  /** ISO time. */\n  at: string;\n  body: string;\n  verdict: BoardVerdict | null;\n};\n\n/** One recipient's inbox, as `readBoardStatus` reports it. */\nexport type BoardInbox = {\n  agent: string;\n  /** Messages in the inbox. */\n  messages: number;\n  /** The highest message number `watch` has returned to this agent (0 = none). */\n  cursor: number;\n  /** Messages numbered above the cursor. */\n  unread: number;\n};\n\n/** What `warlock board status --json` prints without an item id. */\nexport type BoardStatus = {\n  schemaVersion: 1;\n  items: BoardItem[];\n  inboxes: BoardInbox[];\n};\n\n/** Whether a string is a board state. */\nexport function isBoardState(value: string): value is BoardState {\n  return (BOARD_STATES as readonly string[]).includes(value);\n}\n\n/** Whether a string is a verdict. */\nexport function isBoardVerdict(value: string): value is BoardVerdict {\n  return value === \"approved\" || value === \"changes-requested\";\n}\n"],"mappings":";;;;;;;AAOA,MAAa,kBAAkB;;AAG/B,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;AACF;;;;;AASA,MAAa,oBAAyE;CACpF,MAAM,CAAC,eAAe,SAAS;CAC/B,eAAe;EAAC;EAAoB;EAAW;CAAM;CACrD,oBAAoB;EAAC;EAAY;EAAqB;CAAa;CACnE,qBAAqB,CAAC,eAAe,SAAS;CAC9C,UAAU,CAAC,aAAa;CACxB,SAAS,CAAC,QAAQ,aAAa;AACjC;;AAMA,MAAa,sBAA8D;CACzE,UAAU;CACV,qBAAqB;AACvB;;AA8DA,SAAgB,aAAa,OAAoC;CAC/D,OAAQ,aAAmC,SAAS,KAAK;AAC3D;;AAGA,SAAgB,eAAe,OAAsC;CACnE,OAAO,UAAU,cAAc,UAAU;AAC3C"}

package/esm/tooling/check/changed-files.d.mts

@@ -0,0 +1,31 @@
+import { ToolingProblem } from "../problem.mjs";
+//#region ../../packages/core/src/tooling/check/changed-files.d.ts
+/** The result of one git invocation. */
+export type GitResult = {
+  code: number;
+  stdout: string;
+  stderr: string;
+};
+/** Runs `git <args>` in `cwd`. Injectable so tests need no repository. */
+export type GitRunner = (args: readonly string[], cwd: string) => Promise<GitResult>;
+/** The default {@link GitRunner}: the `git` on PATH. */
+export declare const runGit: GitRunner;
+/**
+ * The source files changed in the working tree — tracked changes against
+ * `base` (or HEAD) plus untracked files — relative to `cwd`, existing only.
+ *
+ * With `base`, the comparison point is `git merge-base <base> HEAD`, so a
+ * branch is compared with where it left `base` rather than with `base`'s tip.
+ * A git failure is a `WL8006` environment problem.
+ */
+export declare function listChangedFiles(options: {
+  cwd: string;
+  base?: string;
+  git?: GitRunner;
+}): Promise<{
+  files: string[];
+} | {
+  problem: ToolingProblem;
+}>;
+//#endregion
+//# sourceMappingURL=changed-files.d.mts.map

package/esm/tooling/check/changed-files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-files.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/changed-files.ts"],"mappings":";;;YAMY;EAAc;EAAc;EAAgB;;;YAG5C,aAAa,yBAAyB,gBAAgB,QAAQ;;qBAG7D,QAAQ;;;;;;;;;wBAoCC,iBAAiB;EACrC;EACA;EACA,MAAM;IACJ;EAAU;;EAAsB,SAAS"}