@warlock.js/core 5.31.0 → 5.33.0

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

@@ -1,83 +1,96 @@
 import { BoardItem, BoardMessage, BoardState, BoardStatus, BoardVerdict } from "./board.types.mjs";
-
 //#region ../../packages/core/src/tooling/board/board.d.ts
 /** What `initBoard` did. */
-type InitBoardResult = {
-  /** The board directory, relative to the project root. */directory: string; /** `false` when the board already existed. */
-  created: boolean; /** Whether `.warlock/board/` was added to `.gitignore` by this call. */
+export type InitBoardResult = {
+  /** The board directory, relative to the project root. */
+  directory: string;
+  /** `false` when the board already existed. */
+  created: boolean;
+  /** Whether `.warlock/board/` was added to `.gitignore` by this call. */
   gitignoreUpdated: boolean;
 };
 /** Inputs of {@link addBoardItem}. */
-type AddBoardItemInput = {
+export type AddBoardItemInput = {
   title: string;
   assignee?: string | null;
-  reviewer?: string | null; /** The agent creating it, recorded in the history. */
-  by?: string | null; /** Clock, for tests. */
+  reviewer?: string | null;
+  /** The agent creating it, recorded in the history. */
+  by?: string | null;
+  /** Clock, for tests. */
   now?: () => Date;
 };
 /** Inputs of {@link moveBoardItem}. */
-type MoveBoardItemOptions = {
+export type MoveBoardItemOptions = {
   by?: string | null;
   note?: string | null;
   now?: () => Date;
 };
 /** Inputs of {@link sendBoardMessage}. */
-type SendBoardMessageInput = {
+export type SendBoardMessageInput = {
   to: string;
   from: string;
   subject: string;
-  body?: string; /** The item the message is about. */
-  item?: number | null; /** A review verdict; with `item`, also moves the item to that state. */
+  body?: string;
+  /** The item the message is about. */
+  item?: number | null;
+  /** A review verdict; with `item`, also moves the item to that state. */
   verdict?: BoardVerdict | null;
   now?: () => Date;
 };
 /** What {@link sendBoardMessage} wrote. */
-type SendBoardMessageResult = {
-  message: BoardMessage; /** The item after the verdict moved it, when the message carried one. */
+export type SendBoardMessageResult = {
+  message: BoardMessage;
+  /** The item after the verdict moved it, when the message carried one. */
   item: BoardItem | null;
 };
 /** Inputs of {@link watchBoard}. */
-type WatchBoardOptions = {
-  agent: string; /** Return messages numbered above this. Default: the agent's cursor. */
-  since?: number; /** Give up after this long; throws `WL7404`. Default: 10 minutes. */
-  timeoutMs?: number; /** Poll interval. Default: 250 ms. */
-  intervalMs?: number; /** Stop early (resolves with no messages). */
+export type WatchBoardOptions = {
+  agent: string;
+  /** Return messages numbered above this. Default: the agent's cursor. */
+  since?: number;
+  /** Give up after this long; throws `WL7404`. Default: 10 minutes. */
+  timeoutMs?: number;
+  /** Poll interval. Default: 250 ms. */
+  intervalMs?: number;
+  /** Stop early (resolves with no messages). */
   signal?: AbortSignal;
 };
 /** What {@link watchBoard} returned. */
-type WatchBoardResult = {
-  agent: string; /** The new messages, oldest first. */
-  messages: BoardMessage[]; /** The agent's cursor after the call. */
+export type WatchBoardResult = {
+  agent: string;
+  /** The new messages, oldest first. */
+  messages: BoardMessage[];
+  /** The agent's cursor after the call. */
   cursor: number;
 };
 /** A file-name slug: lower-case, dashes, at most 48 characters. */
-declare function boardSlug(value: string, fallback: string): string;
+export declare function boardSlug(value: string, fallback: string): string;
 /** Throw unless `name` is a valid agent name. */
-declare function assertAgentName(name: string, label?: string): void;
+export declare function assertAgentName(name: string, label?: string): void;
 /** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */
-declare function gitignoreCoversBoard(content: string): boolean;
+export declare function gitignoreCoversBoard(content: string): boolean;
 /**
  * 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.
  */
-declare function initBoard(cwd?: string, now?: () => Date): InitBoardResult;
+export declare function initBoard(cwd?: string, now?: () => Date): InitBoardResult;
 /** Every item, by id. Throws `WL7401` when the board does not exist. */
-declare function listBoardItems(cwd?: string): BoardItem[];
+export declare function listBoardItems(cwd?: string): BoardItem[];
 /** One item. Throws `WL7402` for an unknown id. */
-declare function readBoardItem(id: number, cwd?: string): BoardItem;
+export declare function readBoardItem(id: number, cwd?: string): BoardItem;
 /** Add an item in state `todo`, with a fresh id no other writer can take. */
-declare function addBoardItem(input: AddBoardItemInput, cwd?: string): BoardItem;
+export declare function addBoardItem(input: AddBoardItemInput, cwd?: string): BoardItem;
 /** The states an item in `state` may move to. */
-declare function nextBoardStates(state: BoardState): readonly BoardState[];
+export declare function nextBoardStates(state: BoardState): readonly BoardState[];
 /** Throw `WL7403` unless `from → to` is in {@link BOARD_TRANSITIONS}. */
-declare function assertBoardTransition(id: number, from: BoardState, to: BoardState): void;
+export declare function assertBoardTransition(id: number, from: BoardState, to: BoardState): void;
 /**
  * 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.
  */
-declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardItemOptions, cwd?: string): BoardItem;
+export declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardItemOptions, cwd?: string): BoardItem;
 /**
  * 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
@@ -85,17 +98,17 @@ declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardIt
  * `approved` / `changes-requested` — before the message is written, so a
  * refused move (`WL7403`) leaves no message behind.
  */
-declare function sendBoardMessage(input: SendBoardMessageInput, cwd?: string): SendBoardMessageResult;
+export declare function sendBoardMessage(input: SendBoardMessageInput, cwd?: string): SendBoardMessageResult;
 /** The messages in an agent's inbox numbered above `since`, oldest first. */
-declare function listBoardMessages(agent: string, options?: {
+export declare function listBoardMessages(agent: string, options?: {
   since?: number;
 }, cwd?: string): BoardMessage[];
 /** The highest message number `watch` has returned to `agent` (0 when none). */
-declare function readBoardCursor(agent: string, cwd?: string): number;
+export declare function readBoardCursor(agent: string, cwd?: string): number;
 /** Record that `agent` has seen messages up to `number`. Never moves the cursor back. */
-declare function writeBoardCursor(agent: string, number: number, cwd?: string): number;
+export declare function writeBoardCursor(agent: string, number: number, cwd?: string): number;
 /** Every item and every inbox with its message count, cursor and unread count. */
-declare function readBoardStatus(cwd?: string): BoardStatus;
+export declare function readBoardStatus(cwd?: string): BoardStatus;
 /**
  * Block until `agent` has a message numbered above `since` (default: its
  * cursor), then return every such message and advance the cursor past them.
@@ -103,7 +116,6 @@ declare function readBoardStatus(cwd?: string): BoardStatus;
  * Polls the inbox every `intervalMs`; throws `WL7404` when `timeoutMs` passes
  * first. An aborted `signal` resolves with no messages.
  */
-declare function watchBoard(options: WatchBoardOptions, cwd?: string): Promise<WatchBoardResult>;
+export declare function watchBoard(options: WatchBoardOptions, cwd?: string): Promise<WatchBoardResult>;
 //#endregion
-export { AddBoardItemInput, InitBoardResult, MoveBoardItemOptions, SendBoardMessageInput, SendBoardMessageResult, WatchBoardOptions, WatchBoardResult, addBoardItem, assertAgentName, assertBoardTransition, boardSlug, gitignoreCoversBoard, initBoard, listBoardItems, listBoardMessages, moveBoardItem, nextBoardStates, readBoardCursor, readBoardItem, readBoardStatus, sendBoardMessage, watchBoard, writeBoardCursor };
 //# sourceMappingURL=board.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"board.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.ts"],"mappings":";;;;KAiCY,eAAA;EAAA,yDAEV,SAAA;EAEA,OAAA,WAFA;EAIA,gBAAA;AAAA;;KAIU,iBAAA;EACV,KAAA;EACA,QAAA;EACA,QAAA,kBAIgB;EAFhB,EAAA,kBAHA;EAKA,GAAA,SAAY,IAAI;AAAA;;KAIN,oBAAA;EACV,EAAA;EACA,IAAA;EACA,GAAA,SAAY,IAAI;AAAA;;KAIN,qBAAA;EACV,EAAA;EACA,IAAA;EACA,OAAA;EACA,IAAA,WARgB;EAUhB,IAAA,kBANU;EAQV,OAAA,GAAU,YAAA;EACV,GAAA,SAAY,IAAI;AAAA;;KAIN,sBAAA;EACV,OAAA,EAAS,YAAA,EAVT;EAYA,IAAA,EAAM,SAAS;AAAA;;KAIL,iBAAA;EACV,KAAA,UAZgB;EAchB,KAAA,WAVU;EAYV,SAAA;EAEA,UAAA,WAbA;EAeA,MAAA,GAAS,WAAW;AAAA;;KAIV,gBAAA;EACV,KAAA,UAdU;EAgBV,QAAA,EAAU,YAAY;EAEtB,MAAA;AAAA;;iBAgBc,SAAA,CAAU,KAAA,UAAe,QAAgB;;iBAYzC,eAAA,CAAgB,IAAA,UAAc,KAAe;;iBA8E7C,oBAAA,CAAqB,OAAe;AAnH9B;AAItB;;;;AAJsB,iBAyIN,SAAA,CACd,GAAA,WACA,GAAA,SAAW,IAAA,GACV,eAAe;;iBA4FF,cAAA,CAAe,GAAA,YAAsB,SAAS;;iBAe9C,aAAA,CAAc,EAAA,UAAY,GAAA,YAAsB,SAAS;AA9OjE;AAAA,iBA8PQ,YAAA,CAAa,KAAA,EAAO,iBAAA,EAAmB,GAAA,YAAsB,SAAS;;iBAqCtE,eAAA,CAAgB,KAAA,EAAO,UAAA,YAAsB,UAAU;;iBAKvD,qBAAA,CAAsB,EAAA,UAAY,IAAA,EAAM,UAAA,EAAY,EAAA,EAAI,UAAU;AA5QlF;;;;AAA6D;AAA7D,iBA0RgB,aAAA,CACd,EAAA,UACA,EAAA,EAAI,UAAA,EACJ,OAAA,GAAS,oBAAA,EACT,GAAA,YACC,SAAA;;;;AAjNiD;AAsBpD;;;iBA+NgB,gBAAA,CACd,KAAA,EAAO,qBAAA,EACP,GAAA,YACC,sBAAsB;;iBAyDT,iBAAA,CACd,KAAA,UACA,OAAA;EAAW,KAAA;AAAA,GACX,GAAA,YACC,YAAY;;iBA6BC,eAAA,CAAgB,KAAA,UAAe,GAAmB;AA7NlE;AAAA,iBA4OgB,gBAAA,CAAiB,KAAA,UAAe,MAAA,UAAgB,GAAA;;iBAchD,eAAA,CAAgB,GAAA,YAAsB,WAAW;AA1PH;AAe9D;;;;;;AAf8D,iBAyRxC,UAAA,CACpB,OAAA,EAAS,iBAAA,EACT,GAAA,YACC,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"board.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.ts"],"mappings":";;;YAiCY;;EAEV;;EAEA;;EAEA;;;YAIU;EACV;EACA;EACA;;EAEA;;EAEA,YAAY;;;YAIF;EACV;EACA;EACA,YAAY;;;YAIF;EACV;EACA;EACA;EACA;;EAEA;;EAEA,UAAU;EACV,YAAY;;;YAIF;EACV,SAAS;;EAET,MAAM;;;YAII;EACV;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;;YAIC;EACV;;EAEA,UAAU;;EAEV;;;wBAgBc,UAAU,eAAe;;wBAYzB,gBAAgB,cAAc;;wBA8E9B,qBAAqB;;;;;;wBAsBrB,UACd,cACA,YAAW,OACV;;wBA4Fa,eAAe,eAAsB;;wBAerC,cAAc,YAAY,eAAsB;;wBAgBhD,aAAa,OAAO,mBAAmB,eAAsB;;wBAqC7D,gBAAgB,OAAO,sBAAsB;;wBAK7C,sBAAsB,YAAY,MAAM,YAAY,IAAI;;;;;;wBAcxD,cACd,YACA,IAAI,YACJ,UAAS,sBACT,eACC;;;;;;;;wBAoCa,iBACd,OAAO,uBACP,eACC;;wBAyDa,kBACd,eACA;EAAW;GACX,eACC;;wBA6Ba,gBAAgB,eAAe;;wBAe/B,iBAAiB,eAAe,gBAAgB;;wBAchD,gBAAgB,eAAsB;;;;;;;;wBA+BhC,WACpB,SAAS,mBACT,eACC,QAAQ"}

package/esm/tooling/board/board.mjs

@@ -78,7 +78,7 @@ function assertInitialized(cwd) {
 }
 /** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */
 function gitignoreCoversBoard(content) {
-	const covering = new Set([
+	const covering = /* @__PURE__ */ new Set([
 		".warlock",
 		".warlock/",
 		"/.warlock",
@@ -111,7 +111,8 @@ function initBoard(cwd = process.cwd(), now = () => /* @__PURE__ */ new Date())
 	const current = existsSync(gitignore) ? readFileSync(gitignore, "utf8") : "";
 	let gitignoreUpdated = false;
 	if (!gitignoreCoversBoard(current)) {
-		writeFileSync(gitignore, `${current}${current.length === 0 || current.endsWith("\n") ? "" : "\n"}${current.length > 0 ? "\n" : ""}# Agent board (warlock board)\n${BOARD_DIRECTORY}/\n`, "utf8");
+		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 {
@@ -377,7 +378,7 @@ async function watchBoard(options, cwd = process.cwd()) {
 	assertInitialized(cwd);
 	assertAgentName(options.agent);
 	const since = options.since ?? readBoardCursor(options.agent, cwd);
-	const timeoutMs = options.timeoutMs ?? 600 * 1e3;
+	const timeoutMs = options.timeoutMs ?? 6e5;
 	const intervalMs = options.intervalMs ?? 250;
 	const deadline = Date.now() + timeoutMs;
 	for (;;) {

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

@@ -1 +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":";;;;;;;;AAwBA,MAAM,aAAa;;AAGnB,MAAM,0BAA0B;;AAGhC,MAAM,aAAa;AAwEnB,SAAS,UAAU,KAAqB;CACtC,OAAO,KAAK,KAAK,KAAK,eAAe;AACvC;AAEA,SAAS,QAAQ,OAAuB;CACtC,OAAO,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AACvC;AAEA,SAAS,IAAI,OAAuB;CAClC,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG;AACtC;;AAGA,SAAgB,UAAU,OAAe,UAA0B;CACjE,MAAM,OAAO,MACV,YAAY,CAAC,CACb,QAAQ,eAAe,GAAG,CAAC,CAC3B,QAAQ,YAAY,EAAE,CAAC,CACvB,MAAM,GAAG,EAAE,CAAC,CACZ,QAAQ,QAAQ,EAAE;CAErB,OAAO,KAAK,SAAS,IAAI,OAAO;AAClC;;AAGA,SAAgB,gBAAgB,MAAc,QAAQ,SAAe;CACnE,IAAI,CAAC,WAAW,KAAK,IAAI,GACvB,MAAM,IAAI,MACR,WAAW,MAAM,QAAQ,KAAK,UAAU,IAAI,EAAE,+DAChD;AAEJ;AAEA,SAAS,iBAAiB,OAAgD;CACxE,OAAO,iBAAiB,SAAS,UAAU;AAC7C;;AAGA,SAAS,YAAY,MAAc,SAAuB;CACxD,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;CAEvD,cAAc,WAAW,SAAS,MAAM;CACxC,WAAW,WAAW,IAAI;AAC5B;;AAGA,SAAS,gBAAgB,WAAmB,WAAuD;CACjG,IAAI,CAAC,WAAW,SAAS,GAAG,OAAO,CAAC;CAEpC,OAAO,YAAY,SAAS,CAAC,CAC1B,QAAQ,SAAS,CAAC,KAAK,WAAW,GAAG,KAAK,KAAK,SAAS,SAAS,CAAC,CAAC,CACnE,SAAS,SAAS;EACjB,MAAM,QAAQ,UAAU,KAAK,IAAI;EACjC,OAAO,QAAQ,KAAK,CAAC;GAAE,QAAQ,OAAO,SAAS,MAAM,IAAI,EAAE;GAAG;EAAK,CAAC,IAAI,CAAC;CAC3E,CAAC,CAAC,CACD,MAAM,OAAO,WAAW,MAAM,SAAS,OAAO,MAAM;AACzD;;;;;;AAOA,SAAS,cAAc,WAAmB,OAAuB;CAC/D,MAAM,WAAW,KAAK,KAAK,WAAW,MAAM;CAE5C,UAAU,UAAU,EAAE,WAAW,KAAK,CAAC;CAEvC,KAAK,IAAI,SAAS,OAAO,UAAU,GAAG,UAAU,yBAAyB,UAAU,WACjF,IAAI;EACF,cAAc,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,KAAK,CAAC;EAClE,OAAO;CACT,SAAS,OAAO;EACd,IAAI,iBAAiB,KAAK,KAAK,MAAM,SAAS,UAAU;EACxD,MAAM;CACR;CAGF,MAAM,IAAI,MAAM,2CAA2C,UAAU,EAAE;AACzE;AAEA,SAAS,WAAW,WAAmB,WAA2B;CAChE,MAAM,UAAU,gBAAgB,WAAW,SAAS;CAGpD,OAAO,cAAc,YAFL,QAAQ,QAAQ,SAAS,EAAE,EAAE,UAAU,KAEb,CAAC;AAC7C;;AAGA,SAAS,kBAAkB,KAAqB;CAC9C,MAAM,OAAO,UAAU,GAAG;CAE1B,IAAI,CAAC,WAAW,KAAK,KAAK,MAAM,UAAU,CAAC,GACzC,MAAM,IAAI,aACR,UACA,qBAAqB,gBAAgB,kDACvC;CAGF,OAAO;AACT;;AAGA,SAAgB,qBAAqB,SAA0B;CAC7D,MAAM,WAAW,IAAI,IAAI;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO,QAAQ,MAAM,OAAO,CAAC,CAAC,MAAM,SAAS,SAAS,IAAI,KAAK,KAAK,CAAC,CAAC;AACxE;;;;;;AAOA,SAAgB,UACd,MAAM,QAAQ,IAAI,GAClB,4BAAwB,IAAI,KAAK,GAChB;CACjB,MAAM,OAAO,UAAU,GAAG;CAC1B,MAAM,SAAS,KAAK,KAAK,MAAM,UAAU;CACzC,MAAM,UAAU,CAAC,WAAW,MAAM;CAElC,UAAU,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,WAAW,KAAK,CAAC;CACvD,UAAU,KAAK,KAAK,MAAM,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;CAEzD,IAAI,SACF,YACE,QACA,GAAG,KAAK,UAAU;EAAE,eAAe;EAAG,WAAW,IAAI,CAAC,CAAC,YAAY;CAAE,GAAG,MAAM,CAAC,EAAE,GACnF;CAGF,MAAM,YAAY,KAAK,KAAK,KAAK,YAAY;CAC7C,MAAM,UAAU,WAAW,SAAS,IAAI,aAAa,WAAW,MAAM,IAAI;CAC1E,IAAI,mBAAmB;CAEvB,IAAI,CAAC,qBAAqB,OAAO,GAAG;EAGlC,cACE,WACA,GAAG,UAJa,QAAQ,WAAW,KAAK,QAAQ,SAAS,IAAI,IAAI,KAAK,OAI7C,QAAQ,SAAS,IAAI,OAAO,GAAG,iCAAiC,gBAAgB,MACzG,MACF;EACA,mBAAmB;CACrB;CAEA,OAAO;EAAE,WAAW;EAAiB;EAAS;CAAiB;AACjE;AAEA,SAAS,UAAU,OAAuC;CACxD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI;CAClC,MAAM,QAAQ,QAAQ,IAAI,OAAO,OAAO;CACxC,MAAM,QAAQ,QAAQ,IAAI,OAAO,OAAO;CAExC,IAAI,OAAO,OAAO,YAAY,OAAO,UAAU,UAAU,OAAO;CAChE,IAAI,OAAO,UAAU,YAAY,CAAC,aAAa,KAAK,GAAG,OAAO;CAE9D,MAAM,QAAQ,QAA+B;EAC3C,MAAM,QAAQ,QAAQ,IAAI,OAAO,GAAG;EACpC,OAAO,OAAO,UAAU,WAAW,QAAQ;CAC7C;CACA,MAAM,UAAU,QAAQ,IAAI,OAAO,SAAS;CAE5C,OAAO;EACL;EACA;EACA;EACA,UAAU,KAAK,UAAU;EACzB,UAAU,KAAK,UAAU;EACzB,WAAW,KAAK,WAAW,KAAK;EAChC,WAAW,KAAK,WAAW,KAAK;EAChC,SAAS,MAAM,QAAQ,OAAO,IAC1B,QAAQ,SAAS,UAAmB;GAClC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,CAAC;GAEzD,MAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;GACtC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI;GAClC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI;GAClC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI;GAClC,MAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;GAEtC,IAAI,OAAO,OAAO,YAAY,CAAC,aAAa,EAAE,GAAG,OAAO,CAAC;GAEzD,OAAO,CACL;IACE,MAAM,OAAO,SAAS,YAAY,aAAa,IAAI,IAAI,OAAO;IAC9D;IACA,IAAI,OAAO,OAAO,WAAW,KAAK;IAClC,IAAI,OAAO,OAAO,WAAW,KAAK;IAClC,MAAM,OAAO,SAAS,WAAW,OAAO;GAC1C,CACF;EACF,CAAC,IACD,CAAC;CACP;AACF;AAEA,SAAS,SAAS,MAAc,IAAgC;CAC9D,MAAM,QAAQ,gBAAgB,KAAK,KAAK,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,MAC9D,cAAc,UAAU,WAAW,EACtC;CAEA,OAAO,QAAQ,KAAK,KAAK,MAAM,SAAS,MAAM,IAAI,IAAI;AACxD;;AAGA,SAAgB,eAAe,MAAM,QAAQ,IAAI,GAAgB;CAC/D,MAAM,OAAO,kBAAkB,GAAG;CAClC,MAAM,YAAY,KAAK,KAAK,MAAM,OAAO;CAEzC,OAAO,gBAAgB,WAAW,OAAO,CAAC,CAAC,SAAS,EAAE,WAAW;EAC/D,IAAI;GACF,MAAM,OAAO,UAAU,KAAK,MAAM,aAAa,KAAK,KAAK,WAAW,IAAI,GAAG,MAAM,CAAC,CAAC;GACnF,OAAO,OAAO,CAAC,IAAI,IAAI,CAAC;EAC1B,QAAQ;GACN,OAAO,CAAC;EACV;CACF,CAAC;AACH;;AAGA,SAAgB,cAAc,IAAY,MAAM,QAAQ,IAAI,GAAc;CAExE,MAAM,OAAO,SADA,kBAAkB,GACN,GAAG,EAAE;CAC9B,MAAM,OAAO,OAAO,UAAU,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC,CAAC,IAAI;CAExE,IAAI,CAAC,MACH,MAAM,IAAI,aACR,UACA,cAAc,GAAG,iEACnB;CAGF,OAAO;AACT;;AAGA,SAAgB,aAAa,OAA0B,MAAM,QAAQ,IAAI,GAAc;CACrF,MAAM,OAAO,kBAAkB,GAAG;CAClC,MAAM,QAAQ,MAAM,MAAM,QAAQ,YAAY,GAAG,CAAC,CAAC,KAAK;CAExD,IAAI,MAAM,WAAW,GAAG,MAAM,IAAI,MAAM,6BAA6B;CAErE,KAAK,MAAM,CAAC,OAAO,SAAS;EAC1B,CAAC,YAAY,MAAM,QAAQ;EAC3B,CAAC,YAAY,MAAM,QAAQ;EAC3B,CAAC,MAAM,MAAM,EAAE;CACjB,GACE,IAAI,MAAM,gBAAgB,MAAM,KAAK;CAGvC,MAAM,YAAY,KAAK,KAAK,MAAM,OAAO;CACzC,MAAM,KAAK,WAAW,WAAW,OAAO;CACxC,MAAM,MAAM,MAAM,8BAAc,IAAI,KAAK,GAAE,CAAE,CAAC,CAAC,YAAY;CAC3D,MAAM,OAAkB;EACtB;EACA;EACA,OAAO;EACP,UAAU,MAAM,YAAY;EAC5B,UAAU,MAAM,YAAY;EAC5B,WAAW;EACX,WAAW;EACX,SAAS,CAAC;GAAE,MAAM;GAAM,IAAI;GAAQ,IAAI,MAAM,MAAM;GAAM;GAAI,MAAM;EAAK,CAAC;CAC5E;CAEA,YACE,KAAK,KAAK,WAAW,GAAG,IAAI,EAAE,EAAE,GAAG,UAAU,OAAO,MAAM,EAAE,MAAM,GAClE,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,EAAE,GACnC;CAEA,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAA0C;CACxE,OAAO,kBAAkB;AAC3B;;AAGA,SAAgB,sBAAsB,IAAY,MAAkB,IAAsB;CACxF,IAAI,CAAC,kBAAkB,KAAK,CAAC,SAAS,EAAE,GACtC,MAAM,IAAI,aACR,UACA,cAAc,GAAG,OAAO,KAAK,wBAAwB,GAAG,0BAA0B,kBAAkB,KAAK,CAAC,KAAK,IAAI,EAAE,EACvH;AAEJ;;;;;;AAOA,SAAgB,cACd,IACA,IACA,UAAgC,CAAC,GACjC,MAAM,QAAQ,IAAI,GACP;CACX,MAAM,OAAO,kBAAkB,GAAG;CAClC,MAAM,OAAO,cAAc,IAAI,GAAG;CAClC,MAAM,OAAO,SAAS,MAAM,EAAE;CAE9B,IAAI,QAAQ,IAAI,gBAAgB,QAAQ,IAAI,IAAI;CAEhD,sBAAsB,IAAI,KAAK,OAAO,EAAE;CAExC,MAAM,MAAM,QAAQ,8BAAc,IAAI,KAAK,GAAE,CAAE,CAAC,CAAC,YAAY;CAC7D,MAAM,QAAmB;EACvB,GAAG;EACH,OAAO;EACP,WAAW;EACX,SAAS,CACP,GAAG,KAAK,SACR;GAAE,MAAM,KAAK;GAAO;GAAI,IAAI,QAAQ,MAAM;GAAM;GAAI,MAAM,QAAQ,QAAQ;EAAK,CACjF;CACF;CAEA,IAAI,MAAM,YAAY,MAAM,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE,GAAG;CAEjE,OAAO;AACT;AAEA,SAAS,eAAe,MAAc,OAAuB;CAC3D,OAAO,KAAK,KAAK,MAAM,MAAM,OAAO;AACtC;;;;;;;;AASA,SAAgB,iBACd,OACA,MAAM,QAAQ,IAAI,GACM;CACxB,MAAM,OAAO,kBAAkB,GAAG;CAElC,gBAAgB,MAAM,IAAI,WAAW;CACrC,gBAAgB,MAAM,MAAM,QAAQ;CAEpC,MAAM,UAAU,MAAM,QAAQ,QAAQ,YAAY,GAAG,CAAC,CAAC,KAAK;CAE5D,IAAI,QAAQ,WAAW,GAAG,MAAM,IAAI,MAAM,kCAAkC;CAE5E,MAAM,SAAS,MAAM,QAAQ;CAC7B,MAAM,UAAU,MAAM,WAAW;CACjC,MAAM,MAAM,MAAM,8BAAc,IAAI,KAAK;CAEzC,IAAI,WAAW,MAAM,cAAc,QAAQ,GAAG;CAE9C,MAAM,OACJ,WAAW,QAAQ,YAAY,OAC3B,cAAc,QAAQ,SAAS;EAAE,IAAI,MAAM;EAAM,MAAM;EAAS;CAAI,GAAG,GAAG,IAC1E;CAEN,MAAM,YAAY,eAAe,MAAM,MAAM,EAAE;CAE/C,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;CAExC,MAAM,SAAS,WAAW,WAAW,KAAK;CAC1C,MAAM,KAAK,IAAI,CAAC,CAAC,YAAY;CAC7B,MAAM,OAAO,GAAG,IAAI,MAAM,EAAE,GAAG,UAAU,SAAS,SAAS,EAAE;CAC7D,MAAM,OAAO,KAAK,KAAK,WAAW,IAAI;CAEtC,cACE,MACA,mBACE;EAAE,MAAM,MAAM;EAAM,IAAI,MAAM;EAAI,MAAM;EAAQ;EAAS;CAAG,GAC5D,MAAM,QAAQ,IACd,OACF,GACA;EAAE,UAAU;EAAQ,MAAM;CAAK,CACjC;CAEA,OAAO;EACL,SAAS;GACP;GACA,MAAM,QAAQ,KAAK,SAAS,KAAK,IAAI,CAAC;GACtC,MAAM,MAAM;GACZ,IAAI,MAAM;GACV,MAAM;GACN;GACA;GACA,OAAO,MAAM,QAAQ,GAAE,CAAE,QAAQ,QAAQ,EAAE;GAC3C;EACF;EACA;CACF;AACF;;AAGA,SAAgB,kBACd,OACA,UAA8B,CAAC,GAC/B,MAAM,QAAQ,IAAI,GACF;CAChB,MAAM,OAAO,kBAAkB,GAAG;CAElC,gBAAgB,KAAK;CAErB,MAAM,YAAY,eAAe,MAAM,KAAK;CAC5C,MAAM,QAAQ,QAAQ,SAAS;CAE/B,OAAO,gBAAgB,WAAW,KAAK,CAAC,CACrC,QAAQ,UAAU,MAAM,SAAS,KAAK,CAAC,CACvC,KAAK,EAAE,QAAQ,WAAW;EACzB,MAAM,OAAO,KAAK,KAAK,WAAW,IAAI;EACtC,MAAM,SAAS,kBAAkB,aAAa,MAAM,MAAM,CAAC;EAE3D,OAAO;GACL;GACA,MAAM,QAAQ,KAAK,SAAS,KAAK,IAAI,CAAC;GACtC,MAAM,OAAO;GACb,IAAI,OAAO,MAAM;GACjB,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,IAAI,OAAO;GACX,MAAM,OAAO;GACb,SAAS,OAAO;EAClB;CACF,CAAC;AACL;;AAGA,SAAgB,gBAAgB,OAAe,MAAM,QAAQ,IAAI,GAAW;CAC1E,MAAM,OAAO,kBAAkB,GAAG;CAElC,gBAAgB,KAAK;CAErB,MAAM,OAAO,KAAK,KAAK,MAAM,WAAW,KAAK;CAE7C,IAAI,CAAC,WAAW,IAAI,GAAG,OAAO;CAE9B,MAAM,QAAQ,OAAO,SAAS,aAAa,MAAM,MAAM,CAAC,CAAC,KAAK,GAAG,EAAE;CAEnE,OAAO,OAAO,UAAU,KAAK,KAAK,QAAQ,IAAI,QAAQ;AACxD;;AAGA,SAAgB,iBAAiB,OAAe,QAAgB,MAAM,QAAQ,IAAI,GAAW;CAC3F,MAAM,OAAO,kBAAkB,GAAG;CAClC,MAAM,UAAU,gBAAgB,OAAO,GAAG;CAC1C,MAAM,OAAO,KAAK,IAAI,SAAS,MAAM;CAErC,IAAI,SAAS,SAAS;EACpB,UAAU,KAAK,KAAK,MAAM,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;EACzD,YAAY,KAAK,KAAK,MAAM,WAAW,KAAK,GAAG,GAAG,KAAK,GAAG;CAC5D;CAEA,OAAO;AACT;;AAGA,SAAgB,gBAAgB,MAAM,QAAQ,IAAI,GAAgB;CAChE,MAAM,OAAO,kBAAkB,GAAG;CAClC,MAAM,UAAwB,YAAY,MAAM,EAAE,eAAe,KAAK,CAAC,CAAC,CACrE,QAAQ,UAAU,MAAM,YAAY,KAAK,MAAM,KAAK,WAAW,KAAK,CAAC,CAAC,CACtE,KAAK,UAAU,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CACnC,QAAQ,UAAU,uBAAuB,KAAK,KAAK,CAAC,CAAC,CACrD,KAAK,CAAC,CACN,KAAK,UAAU;EACd,MAAM,UAAU,gBAAgB,eAAe,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KACjE,UAAU,MAAM,MACnB;EACA,MAAM,SAAS,gBAAgB,OAAO,GAAG;EAEzC,OAAO;GACL;GACA,UAAU,QAAQ;GAClB;GACA,QAAQ,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC,CAAC;EACtD;CACF,CAAC;CAEH,OAAO;EAAE,eAAe;EAAG,OAAO,eAAe,GAAG;EAAG;CAAQ;AACjE;;;;;;;;AASA,eAAsB,WACpB,SACA,MAAM,QAAQ,IAAI,GACS;CAC3B,kBAAkB,GAAG;CACrB,gBAAgB,QAAQ,KAAK;CAE7B,MAAM,QAAQ,QAAQ,SAAS,gBAAgB,QAAQ,OAAO,GAAG;CACjE,MAAM,YAAY,QAAQ,aAAa,MAAU;CACjD,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,WAAW,KAAK,IAAI,IAAI;CAE9B,SAAS;EACP,MAAM,WAAW,kBAAkB,QAAQ,OAAO,EAAE,MAAM,GAAG,GAAG;EAEhE,IAAI,SAAS,SAAS,GAAG;GACvB,MAAM,SAAS,SAAS,SAAS,SAAS,EAAE,EAAE,UAAU;GAExD,OAAO;IACL,OAAO,QAAQ;IACf;IACA,QAAQ,iBAAiB,QAAQ,OAAO,QAAQ,GAAG;GACrD;EACF;EAEA,IAAI,QAAQ,QAAQ,SAClB,OAAO;GAAE,OAAO,QAAQ;GAAO,UAAU,CAAC;GAAG,QAAQ,gBAAgB,QAAQ,OAAO,GAAG;EAAE;EAG3F,MAAM,YAAY,WAAW,KAAK,IAAI;EAEtC,IAAI,aAAa,GACf,MAAM,IAAI,aACR,UACA,uBAAuB,QAAQ,MAAM,UAAU,KAAK,MAAM,YAAY,GAAI,EAAE,8BAA8B,MAAM,GAClH;EAGF,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,KAAK,IAAI,YAAY,SAAS,CAAC,CAAC;CACrF;AACF"}
+{"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

@@ -5,30 +5,33 @@
  * reviewer — share to track work items and exchange append-only messages.
  */
 /** Where the board lives, under the project root. */
-declare const BOARD_DIRECTORY = ".warlock/board";
+export declare const BOARD_DIRECTORY = ".warlock/board";
 /** Every state an item can be in. */
-declare const BOARD_STATES: readonly ["todo", "in-progress", "ready-for-review", "changes-requested", "approved", "blocked"];
+export declare const BOARD_STATES: readonly ["todo", "in-progress", "ready-for-review", "changes-requested", "approved", "blocked"];
 /** One item state. */
-type BoardState = (typeof BOARD_STATES)[number];
+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`).
  */
-declare const BOARD_TRANSITIONS: Readonly<Record<BoardState, readonly BoardState[]>>;
+export declare const BOARD_TRANSITIONS: Readonly<Record<BoardState, readonly BoardState[]>>;
 /** A review verdict a message can carry. */
-type BoardVerdict = "approved" | "changes-requested";
+export type BoardVerdict = "approved" | "changes-requested";
 /** The exact final line each verdict is written as. */
-declare const BOARD_VERDICT_LINES: Readonly<Record<BoardVerdict, string>>;
+export declare const BOARD_VERDICT_LINES: Readonly<Record<BoardVerdict, string>>;
 /** One recorded state change of an item. */
-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. */
+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`. */
-type BoardItem = {
+export type BoardItem = {
   id: number;
   title: string;
   state: BoardState;
@@ -39,34 +42,40 @@ type BoardItem = {
   history: BoardHistoryEntry[];
 };
 /** One message, stored as `to-<agent>/NNNN-<slug>.md`. */
-type BoardMessage = {
-  /** The per-recipient sequence number (`NNNN`). */number: number; /** Path relative to the project root, POSIX separators. */
+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`. */
+  to: string;
+  /** The item the message is about, or `null`. */
   item: number | null;
-  subject: string; /** ISO time. */
+  subject: string;
+  /** ISO time. */
   at: string;
   body: string;
   verdict: BoardVerdict | null;
 };
 /** One recipient's inbox, as `readBoardStatus` reports it. */
-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. */
+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. */
-type BoardStatus = {
+export type BoardStatus = {
   schemaVersion: 1;
   items: BoardItem[];
   inboxes: BoardInbox[];
 };
 /** Whether a string is a board state. */
-declare function isBoardState(value: string): value is BoardState;
+export declare function isBoardState(value: string): value is BoardState;
 /** Whether a string is a verdict. */
-declare function isBoardVerdict(value: string): value is BoardVerdict;
+export declare function isBoardVerdict(value: string): value is BoardVerdict;
 //#endregion
-export { BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, BoardHistoryEntry, BoardInbox, BoardItem, BoardMessage, BoardState, BoardStatus, BoardVerdict, isBoardState, isBoardVerdict };
 //# sourceMappingURL=board.types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"board.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.types.ts"],"mappings":";;AAOA;;;;AAA4B;AAAA,cAAf,eAAA;;cAGA,YAAA;;KAUD,UAAA,WAAqB,YAAY;AAA7C;;;;AAAA,cAMa,iBAAA,EAAmB,QAAA,CAAS,MAAA,CAAO,UAAA,WAAqB,UAAA;AAArE;AAAA,KAUY,YAAA;;cAGC,mBAAA,EAAqB,QAAA,CAAS,MAAA,CAAO,YAAA;;KAMtC,iBAAA;EAnBoB,qCAqB9B,IAAA,EAAM,UAAA;EACN,EAAA,EAAI,UAAU,EAtBgB;EAwB9B,EAAA,iBAxB8C;EA0B9C,EAAA;EACA,IAAA;AAAA;AAjBF;AAAA,KAqBY,SAAA;EACV,EAAA;EACA,KAAA;EACA,KAAA,EAAO,UAAA;EACP,QAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;EACA,OAAA,EAAS,iBAAiB;AAAA;;KAIhB,YAAA;EA9BsB,kDAgChC,MAAA,UAhCgD;EAkChD,IAAA;EACA,IAAA;EACA,EAAA,UA9B2B;EAgC3B,IAAA;EACA,OAAA,UA/BA;EAiCA,EAAA;EACA,IAAA;EACA,OAAA,EAAS,YAAY;AAAA;;KAIX,UAAA;EACV,KAAA,UAlCI;EAoCJ,QAAA,UAhCmB;EAkCnB,MAAA,UA1B0B;EA4B1B,MAAA;AAAA;;KAIU,WAAA;EACV,aAAA;EACA,KAAA,EAAO,SAAA;EACP,OAAA,EAAS,UAAU;AAAA;;iBAIL,YAAA,CAAa,KAAA,WAAgB,KAAA,IAAS,UAAU;;iBAKhD,cAAA,CAAe,KAAA,WAAgB,KAAA,IAAS,YAAY"}
+{"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/check/changed-files.d.mts

@@ -1,16 +1,15 @@
 import { ToolingProblem } from "../problem.mjs";
-
 //#region ../../packages/core/src/tooling/check/changed-files.d.ts
 /** The result of one git invocation. */
-type GitResult = {
+export type GitResult = {
   code: number;
   stdout: string;
   stderr: string;
 };
 /** Runs `git <args>` in `cwd`. Injectable so tests need no repository. */
-type GitRunner = (args: readonly string[], cwd: string) => Promise<GitResult>;
+export type GitRunner = (args: readonly string[], cwd: string) => Promise<GitResult>;
 /** The default {@link GitRunner}: the `git` on PATH. */
-declare const runGit: GitRunner;
+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.
@@ -19,7 +18,7 @@ declare const runGit: GitRunner;
  * branch is compared with where it left `base` rather than with `base`'s tip.
  * A git failure is a `WL8006` environment problem.
  */
-declare function listChangedFiles(options: {
+export declare function listChangedFiles(options: {
   cwd: string;
   base?: string;
   git?: GitRunner;
@@ -29,5 +28,4 @@ declare function listChangedFiles(options: {
   problem: ToolingProblem;
 }>;
 //#endregion
-export { GitResult, GitRunner, listChangedFiles, runGit };
 //# sourceMappingURL=changed-files.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"changed-files.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/changed-files.ts"],"mappings":";;;;KAMY,SAAA;EAAc,IAAA;EAAc,MAAA;EAAgB,MAAA;AAAA;;KAG5C,SAAA,IAAa,IAAA,qBAAyB,GAAA,aAAgB,OAAO,CAAC,SAAA;;cAG7D,MAAA,EAAQ,SAYjB;AAlB0D;AAG9D;;;;;;;AAH8D,iBA0CxC,gBAAA,CAAiB,OAAA;EACrC,GAAA;EACA,IAAA;EACA,GAAA,GAAM,SAAA;AAAA,IACJ,OAAA;EAAU,KAAA;AAAA;EAAsB,OAAA,EAAS,cAAA;AAAA"}
+{"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"}

package/esm/tooling/check/changed-files.mjs

@@ -10,7 +10,7 @@ const runGit = (args, cwd) => new Promise((resolve) => {
 		cwd,
 		encoding: "utf8",
 		windowsHide: true,
-		maxBuffer: 16 * 1024 * 1024
+		maxBuffer: 16777216
 	}, (error, stdout, stderr) => {
 		resolve({
 			code: error === null ? 0 : typeof error.code === "number" ? error.code : 127,
@@ -65,7 +65,7 @@ async function listChangedFiles(options) {
 		"--exclude-standard"
 	], options.cwd);
 	if (untracked.code !== 0) return { problem: gitProblem(`git ls-files failed: ${untracked.stderr.trim() || `exit ${untracked.code}`}`) };
-	return { files: [...new Set([...lines(diff.stdout), ...lines(untracked.stdout)])].map((file) => file.split(path.sep).join("/")).filter((file) => SOURCE_FILE.test(file) && existsSync(path.join(options.cwd, file))).sort() };
+	return { files: [.../* @__PURE__ */ new Set([...lines(diff.stdout), ...lines(untracked.stdout)])].map((file) => file.split(path.sep).join("/")).filter((file) => SOURCE_FILE.test(file) && existsSync(path.join(options.cwd, file))).sort() };
 }
 
 //#endregion

package/esm/tooling/check/changed-files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"changed-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/changed-files.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\n\n/** The result of one git invocation. */\nexport type GitResult = { code: number; stdout: string; stderr: string };\n\n/** Runs `git <args>` in `cwd`. Injectable so tests need no repository. */\nexport type GitRunner = (args: readonly string[], cwd: string) => Promise<GitResult>;\n\n/** The default {@link GitRunner}: the `git` on PATH. */\nexport const runGit: GitRunner = (args, cwd) =>\n  new Promise((resolve) => {\n    execFile(\n      \"git\",\n      [...args],\n      { cwd, encoding: \"utf8\", windowsHide: true, maxBuffer: 16 * 1024 * 1024 },\n      (error, stdout, stderr) => {\n        const code = error === null ? 0 : typeof error.code === \"number\" ? error.code : 127;\n\n        resolve({ code, stdout, stderr: stderr || (error?.message ?? \"\") });\n      },\n    );\n  });\n\n/** Files `warlock check --changed` considers: JavaScript and TypeScript sources. */\nconst SOURCE_FILE = /\\.(?:[cm]?[jt]sx?)$/i;\n\nfunction lines(output: string): string[] {\n  return output\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n}\n\nfunction gitProblem(message: string): ToolingProblem {\n  return createProblem({ code: \"WL8006\", source: \"environment\", message });\n}\n\n/**\n * The source files changed in the working tree — tracked changes against\n * `base` (or HEAD) plus untracked files — relative to `cwd`, existing only.\n *\n * With `base`, the comparison point is `git merge-base <base> HEAD`, so a\n * branch is compared with where it left `base` rather than with `base`'s tip.\n * A git failure is a `WL8006` environment problem.\n */\nexport async function listChangedFiles(options: {\n  cwd: string;\n  base?: string;\n  git?: GitRunner;\n}): Promise<{ files: string[] } | { problem: ToolingProblem }> {\n  const git = options.git ?? runGit;\n  let ref = \"HEAD\";\n\n  if (options.base) {\n    const mergeBase = await git([\"merge-base\", options.base, \"HEAD\"], options.cwd);\n\n    if (mergeBase.code !== 0) {\n      return {\n        problem: gitProblem(\n          `git merge-base ${options.base} HEAD failed: ${mergeBase.stderr.trim() || `exit ${mergeBase.code}`}`,\n        ),\n      };\n    }\n\n    ref = mergeBase.stdout.trim();\n  }\n\n  // `--relative` makes the paths relative to cwd and limits them to it.\n  const diff = await git(\n    [\"diff\", \"--name-only\", \"--relative\", \"--diff-filter=ACMR\", ref],\n    options.cwd,\n  );\n\n  if (diff.code !== 0) {\n    return {\n      problem: gitProblem(\n        `git diff against ${ref} failed: ${diff.stderr.trim() || `exit ${diff.code}`}`,\n      ),\n    };\n  }\n\n  const untracked = await git([\"ls-files\", \"--others\", \"--exclude-standard\"], options.cwd);\n\n  if (untracked.code !== 0) {\n    return {\n      problem: gitProblem(\n        `git ls-files failed: ${untracked.stderr.trim() || `exit ${untracked.code}`}`,\n      ),\n    };\n  }\n\n  const files = [...new Set([...lines(diff.stdout), ...lines(untracked.stdout)])]\n    .map((file) => file.split(path.sep).join(\"/\"))\n    .filter((file) => SOURCE_FILE.test(file) && existsSync(path.join(options.cwd, file)))\n    .sort();\n\n  return { files };\n}\n"],"mappings":";;;;;;;AAYA,MAAa,UAAqB,MAAM,QACtC,IAAI,SAAS,YAAY;CACvB,SACE,OACA,CAAC,GAAG,IAAI,GACR;EAAE;EAAK,UAAU;EAAQ,aAAa;EAAM,WAAW,KAAK,OAAO;CAAK,IACvE,OAAO,QAAQ,WAAW;EAGzB,QAAQ;GAAE,MAFG,UAAU,OAAO,IAAI,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;GAEhE;GAAQ,QAAQ,WAAW,OAAO,WAAW;EAAI,CAAC;CACpE,CACF;AACF,CAAC;;AAGH,MAAM,cAAc;AAEpB,SAAS,MAAM,QAA0B;CACvC,OAAO,OACJ,MAAM,OAAO,CAAC,CACd,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,CAAC;AACrC;AAEA,SAAS,WAAW,SAAiC;CACnD,OAAO,cAAc;EAAE,MAAM;EAAU,QAAQ;EAAe;CAAQ,CAAC;AACzE;;;;;;;;;AAUA,eAAsB,iBAAiB,SAIwB;CAC7D,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI,MAAM;CAEV,IAAI,QAAQ,MAAM;EAChB,MAAM,YAAY,MAAM,IAAI;GAAC;GAAc,QAAQ;GAAM;EAAM,GAAG,QAAQ,GAAG;EAE7E,IAAI,UAAU,SAAS,GACrB,OAAO,EACL,SAAS,WACP,kBAAkB,QAAQ,KAAK,gBAAgB,UAAU,OAAO,KAAK,KAAK,QAAQ,UAAU,QAC9F,EACF;EAGF,MAAM,UAAU,OAAO,KAAK;CAC9B;CAGA,MAAM,OAAO,MAAM,IACjB;EAAC;EAAQ;EAAe;EAAc;EAAsB;CAAG,GAC/D,QAAQ,GACV;CAEA,IAAI,KAAK,SAAS,GAChB,OAAO,EACL,SAAS,WACP,oBAAoB,IAAI,WAAW,KAAK,OAAO,KAAK,KAAK,QAAQ,KAAK,QACxE,EACF;CAGF,MAAM,YAAY,MAAM,IAAI;EAAC;EAAY;EAAY;CAAoB,GAAG,QAAQ,GAAG;CAEvF,IAAI,UAAU,SAAS,GACrB,OAAO,EACL,SAAS,WACP,wBAAwB,UAAU,OAAO,KAAK,KAAK,QAAQ,UAAU,QACvE,EACF;CAQF,OAAO,EAAE,OALK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,GAAG,GAAG,MAAM,UAAU,MAAM,CAAC,CAAC,CAAC,CAAC,CAC5E,KAAK,SAAS,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAC7C,QAAQ,SAAS,YAAY,KAAK,IAAI,KAAK,WAAW,KAAK,KAAK,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CACpF,KAEU,EAAE;AACjB"}
+{"version":3,"file":"changed-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/changed-files.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\n\n/** The result of one git invocation. */\nexport type GitResult = { code: number; stdout: string; stderr: string };\n\n/** Runs `git <args>` in `cwd`. Injectable so tests need no repository. */\nexport type GitRunner = (args: readonly string[], cwd: string) => Promise<GitResult>;\n\n/** The default {@link GitRunner}: the `git` on PATH. */\nexport const runGit: GitRunner = (args, cwd) =>\n  new Promise((resolve) => {\n    execFile(\n      \"git\",\n      [...args],\n      { cwd, encoding: \"utf8\", windowsHide: true, maxBuffer: 16 * 1024 * 1024 },\n      (error, stdout, stderr) => {\n        const code = error === null ? 0 : typeof error.code === \"number\" ? error.code : 127;\n\n        resolve({ code, stdout, stderr: stderr || (error?.message ?? \"\") });\n      },\n    );\n  });\n\n/** Files `warlock check --changed` considers: JavaScript and TypeScript sources. */\nconst SOURCE_FILE = /\\.(?:[cm]?[jt]sx?)$/i;\n\nfunction lines(output: string): string[] {\n  return output\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n}\n\nfunction gitProblem(message: string): ToolingProblem {\n  return createProblem({ code: \"WL8006\", source: \"environment\", message });\n}\n\n/**\n * The source files changed in the working tree — tracked changes against\n * `base` (or HEAD) plus untracked files — relative to `cwd`, existing only.\n *\n * With `base`, the comparison point is `git merge-base <base> HEAD`, so a\n * branch is compared with where it left `base` rather than with `base`'s tip.\n * A git failure is a `WL8006` environment problem.\n */\nexport async function listChangedFiles(options: {\n  cwd: string;\n  base?: string;\n  git?: GitRunner;\n}): Promise<{ files: string[] } | { problem: ToolingProblem }> {\n  const git = options.git ?? runGit;\n  let ref = \"HEAD\";\n\n  if (options.base) {\n    const mergeBase = await git([\"merge-base\", options.base, \"HEAD\"], options.cwd);\n\n    if (mergeBase.code !== 0) {\n      return {\n        problem: gitProblem(\n          `git merge-base ${options.base} HEAD failed: ${mergeBase.stderr.trim() || `exit ${mergeBase.code}`}`,\n        ),\n      };\n    }\n\n    ref = mergeBase.stdout.trim();\n  }\n\n  // `--relative` makes the paths relative to cwd and limits them to it.\n  const diff = await git(\n    [\"diff\", \"--name-only\", \"--relative\", \"--diff-filter=ACMR\", ref],\n    options.cwd,\n  );\n\n  if (diff.code !== 0) {\n    return {\n      problem: gitProblem(\n        `git diff against ${ref} failed: ${diff.stderr.trim() || `exit ${diff.code}`}`,\n      ),\n    };\n  }\n\n  const untracked = await git([\"ls-files\", \"--others\", \"--exclude-standard\"], options.cwd);\n\n  if (untracked.code !== 0) {\n    return {\n      problem: gitProblem(\n        `git ls-files failed: ${untracked.stderr.trim() || `exit ${untracked.code}`}`,\n      ),\n    };\n  }\n\n  const files = [...new Set([...lines(diff.stdout), ...lines(untracked.stdout)])]\n    .map((file) => file.split(path.sep).join(\"/\"))\n    .filter((file) => SOURCE_FILE.test(file) && existsSync(path.join(options.cwd, file)))\n    .sort();\n\n  return { files };\n}\n"],"mappings":";;;;;;;AAYA,MAAa,UAAqB,MAAM,QACtC,IAAI,SAAS,YAAY;CACvB,SACE,OACA,CAAC,GAAG,IAAI,GACR;EAAE;EAAK,UAAU;EAAQ,aAAa;EAAM,WAAW;CAAiB,IACvE,OAAO,QAAQ,WAAW;EAGzB,QAAQ;GAAE,MAFG,UAAU,OAAO,IAAI,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;GAEhE;GAAQ,QAAQ,WAAW,OAAO,WAAW;EAAI,CAAC;CACpE,CACF;AACF,CAAC;;AAGH,MAAM,cAAc;AAEpB,SAAS,MAAM,QAA0B;CACvC,OAAO,OACJ,MAAM,OAAO,CAAC,CACd,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,CAAC;AACrC;AAEA,SAAS,WAAW,SAAiC;CACnD,OAAO,cAAc;EAAE,MAAM;EAAU,QAAQ;EAAe;CAAQ,CAAC;AACzE;;;;;;;;;AAUA,eAAsB,iBAAiB,SAIwB;CAC7D,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI,MAAM;CAEV,IAAI,QAAQ,MAAM;EAChB,MAAM,YAAY,MAAM,IAAI;GAAC;GAAc,QAAQ;GAAM;EAAM,GAAG,QAAQ,GAAG;EAE7E,IAAI,UAAU,SAAS,GACrB,OAAO,EACL,SAAS,WACP,kBAAkB,QAAQ,KAAK,gBAAgB,UAAU,OAAO,KAAK,KAAK,QAAQ,UAAU,QAC9F,EACF;EAGF,MAAM,UAAU,OAAO,KAAK;CAC9B;CAGA,MAAM,OAAO,MAAM,IACjB;EAAC;EAAQ;EAAe;EAAc;EAAsB;CAAG,GAC/D,QAAQ,GACV;CAEA,IAAI,KAAK,SAAS,GAChB,OAAO,EACL,SAAS,WACP,oBAAoB,IAAI,WAAW,KAAK,OAAO,KAAK,KAAK,QAAQ,KAAK,QACxE,EACF;CAGF,MAAM,YAAY,MAAM,IAAI;EAAC;EAAY;EAAY;CAAoB,GAAG,QAAQ,GAAG;CAEvF,IAAI,UAAU,SAAS,GACrB,OAAO,EACL,SAAS,WACP,wBAAwB,UAAU,OAAO,KAAK,KAAK,QAAQ,UAAU,QACvE,EACF;CAQF,OAAO,EAAE,OALK,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,GAAG,GAAG,MAAM,UAAU,MAAM,CAAC,CAAC,CAAC,CAAC,CAC5E,KAAK,SAAS,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAC7C,QAAQ,SAAS,YAAY,KAAK,IAAI,KAAK,WAAW,KAAK,KAAK,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CACpF,KAEU,EAAE;AACjB"}

package/esm/tooling/check/check-report.types.d.mts

@@ -1,22 +1,22 @@
 import { ToolingProblem } from "../problem.mjs";
-
 //#region ../../packages/core/src/tooling/check/check-report.types.d.ts
 /** The steps `warlock check` runs, in order. */
-declare const CHECK_STEPS: readonly ["environment", "typecheck", "lint", "tests", "conventions"];
+export declare const CHECK_STEPS: readonly ["environment", "typecheck", "lint", "tests", "conventions"];
 /** One step name. */
-type CheckStepName = (typeof CHECK_STEPS)[number];
+export type CheckStepName = (typeof CHECK_STEPS)[number];
 /**
  * - `passed`: ran and found no error.
  * - `failed`: ran and found at least one error-severity problem.
  * - `skipped`: does not apply (no lint config, no tests, nothing changed, `--skip`).
  * - `blocked`: could not run because of this machine; an environment problem says why.
  */
-type CheckStepStatus = "passed" | "failed" | "skipped" | "blocked";
+export type CheckStepStatus = "passed" | "failed" | "skipped" | "blocked";
 /** One step of the report. */
-type CheckStep = {
+export type CheckStep = {
   name: CheckStepName;
   status: CheckStepStatus;
-  durationMs: number; /** One line on what the step did or why it did not run, or `null`. */
+  durationMs: number;
+  /** One line on what the step did or why it did not run, or `null`. */
   detail: string | null;
 };
 /**
@@ -32,31 +32,36 @@ type CheckStep = {
  * 2 wins over 1: when the machine kept a step from running, the run did not
  * check everything, so "only your code is wrong" cannot be claimed.
  */
-declare const CHECK_EXIT_CODES: {
+export declare const CHECK_EXIT_CODES: {
   readonly ok: 0;
   readonly code: 1;
   readonly environment: 2;
 };
 /** One of {@link CHECK_EXIT_CODES}. */
-type CheckExitCode = (typeof CHECK_EXIT_CODES)[keyof typeof CHECK_EXIT_CODES];
+export type CheckExitCode = (typeof CHECK_EXIT_CODES)[keyof typeof CHECK_EXIT_CODES];
 /** The exit code for a set of problems; see {@link CHECK_EXIT_CODES}. */
-declare function checkExitCode(problems: readonly ToolingProblem[]): CheckExitCode;
+export declare function checkExitCode(problems: readonly ToolingProblem[]): CheckExitCode;
 /** What `warlock check --json` prints. */
-type CheckReport = {
-  schemaVersion: 1; /** `true` when the exit code is 0. */
+export type CheckReport = {
+  schemaVersion: 1;
+  /** `true` when the exit code is 0. */
   ok: boolean;
-  exitCode: CheckExitCode; /** Whether the run was limited to changed files. */
-  changed: boolean; /** The changed files the run was limited to (project-relative), or `null` for a full run. */
+  exitCode: CheckExitCode;
+  /** Whether the run was limited to changed files. */
+  changed: boolean;
+  /** The changed files the run was limited to (project-relative), or `null` for a full run. */
   files: string[] | null;
-  steps: CheckStep[]; /** One entry per problem, in step order. */
+  steps: CheckStep[];
+  /** One entry per problem, in step order. */
   problems: ToolingProblem[];
   summary: {
     errors: number;
-    warnings: number; /** Error-severity problems in the code. */
-    code: number; /** Error-severity problems with the machine. */
+    warnings: number;
+    /** Error-severity problems in the code. */
+    code: number;
+    /** Error-severity problems with the machine. */
     environment: number;
   };
 };
 //#endregion
-export { CHECK_EXIT_CODES, CHECK_STEPS, CheckExitCode, CheckReport, CheckStep, CheckStepName, CheckStepStatus, checkExitCode };
 //# sourceMappingURL=check-report.types.d.mts.map