@warlock.js/core 5.30.0 → 5.31.0

package/esm/tooling/agents-md/write-agents-md.mjs

@@ -0,0 +1,49 @@
+import { AGENTS_MD_FILE, upsertGeneratedSection } from "./agents-md-markers.mjs";
+import { listInstalledSkills } from "./installed-skills.mjs";
+import { listAppModules, renderAgentsMdSection } from "./render-agents-md.mjs";
+import path from "node:path";
+import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+
+//#region ../../packages/core/src/tooling/agents-md/write-agents-md.ts
+/**
+* Render the generated section and put it between the markers of
+* `<cwd>/AGENTS.md`, preserving every byte outside them. Writes only when the
+* content changed (atomically: temp file + rename). Throws `WL7501` on
+* malformed markers, before writing anything.
+*
+* @example
+* const { status } = writeAgentsMd({ report: await inspectApp() });
+*/
+function writeAgentsMd(options) {
+	const cwd = options.cwd ?? process.cwd();
+	const file = path.join(cwd, AGENTS_MD_FILE);
+	const section = renderAgentsMdSection(options.report, {
+		skills: options.skills ?? listInstalledSkills(cwd),
+		modules: options.modules ?? listAppModules(cwd)
+	});
+	const exists = existsSync(file);
+	if (!exists && options.create === false) return {
+		file,
+		status: "skipped",
+		section
+	};
+	const existing = exists ? readFileSync(file, "utf8") : void 0;
+	const next = upsertGeneratedSection(existing, section);
+	if (next === existing) return {
+		file,
+		status: "unchanged",
+		section
+	};
+	const temporary = `${file}.${process.pid}.tmp`;
+	writeFileSync(temporary, next, "utf8");
+	renameSync(temporary, file);
+	return {
+		file,
+		status: exists ? "updated" : "created",
+		section
+	};
+}
+
+//#endregion
+export { writeAgentsMd };
+//# sourceMappingURL=write-agents-md.mjs.map

package/esm/tooling/agents-md/write-agents-md.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-agents-md.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/write-agents-md.ts"],"sourcesContent":["import { existsSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectReport } from \"../inspect/inspect-report.types\";\nimport { AGENTS_MD_FILE, upsertGeneratedSection } from \"./agents-md-markers\";\nimport { type InstalledSkill, listInstalledSkills } from \"./installed-skills\";\nimport { listAppModules, renderAgentsMdSection } from \"./render-agents-md\";\n\n/** What {@link writeAgentsMd} did. */\nexport type AgentsMdWriteStatus = \"created\" | \"updated\" | \"unchanged\" | \"skipped\";\n\n/** Options of {@link writeAgentsMd}. */\nexport type WriteAgentsMdOptions = {\n  /** Project root. Default: `process.cwd()`. */\n  cwd?: string;\n  /** The inspect report to render. */\n  report: InspectReport;\n  /** Create AGENTS.md when it does not exist. Default: `true`; `false` reports `skipped`. */\n  create?: boolean;\n  /** Skills to list. Default: `listInstalledSkills(cwd)`. */\n  skills?: readonly InstalledSkill[];\n  /** Module folders. Default: `listAppModules(cwd)`. */\n  modules?: readonly string[];\n};\n\n/** The result of {@link writeAgentsMd}. */\nexport type WriteAgentsMdResult = {\n  /** Absolute path of AGENTS.md. */\n  file: string;\n  status: AgentsMdWriteStatus;\n  /** The generated section, without markers. */\n  section: string;\n};\n\n/**\n * Render the generated section and put it between the markers of\n * `<cwd>/AGENTS.md`, preserving every byte outside them. Writes only when the\n * content changed (atomically: temp file + rename). Throws `WL7501` on\n * malformed markers, before writing anything.\n *\n * @example\n * const { status } = writeAgentsMd({ report: await inspectApp() });\n */\nexport function writeAgentsMd(options: WriteAgentsMdOptions): WriteAgentsMdResult {\n  const cwd = options.cwd ?? process.cwd();\n  const file = path.join(cwd, AGENTS_MD_FILE);\n  const section = renderAgentsMdSection(options.report, {\n    skills: options.skills ?? listInstalledSkills(cwd),\n    modules: options.modules ?? listAppModules(cwd),\n  });\n  const exists = existsSync(file);\n\n  if (!exists && options.create === false) {\n    return { file, status: \"skipped\", section };\n  }\n\n  const existing = exists ? readFileSync(file, \"utf8\") : undefined;\n  const next = upsertGeneratedSection(existing, section);\n\n  if (next === existing) {\n    return { file, status: \"unchanged\", section };\n  }\n\n  const temporary = `${file}.${process.pid}.tmp`;\n\n  writeFileSync(temporary, next, \"utf8\");\n  renameSync(temporary, file);\n\n  return { file, status: exists ? \"updated\" : \"created\", section };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA0CA,SAAgB,cAAc,SAAoD;CAChF,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,OAAO,KAAK,KAAK,KAAK,cAAc;CAC1C,MAAM,UAAU,sBAAsB,QAAQ,QAAQ;EACpD,QAAQ,QAAQ,UAAU,oBAAoB,GAAG;EACjD,SAAS,QAAQ,WAAW,eAAe,GAAG;CAChD,CAAC;CACD,MAAM,SAAS,WAAW,IAAI;CAE9B,IAAI,CAAC,UAAU,QAAQ,WAAW,OAChC,OAAO;EAAE;EAAM,QAAQ;EAAW;CAAQ;CAG5C,MAAM,WAAW,SAAS,aAAa,MAAM,MAAM,IAAI;CACvD,MAAM,OAAO,uBAAuB,UAAU,OAAO;CAErD,IAAI,SAAS,UACX,OAAO;EAAE;EAAM,QAAQ;EAAa;CAAQ;CAG9C,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,IAAI;CAEzC,cAAc,WAAW,MAAM,MAAM;CACrC,WAAW,WAAW,IAAI;CAE1B,OAAO;EAAE;EAAM,QAAQ,SAAS,YAAY;EAAW;CAAQ;AACjE"}

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

@@ -0,0 +1,31 @@
+import { BoardVerdict } from "./board.types.mjs";
+
+//#region ../../packages/core/src/tooling/board/board-message.d.ts
+/** The fields a message file's front matter carries. */
+type BoardMessageFields = {
+  from: string;
+  to: string;
+  item: number | null;
+  subject: string;
+  at: string;
+};
+/** A message file's contents, parsed. */
+type ParsedBoardMessage = BoardMessageFields & {
+  body: string;
+  verdict: BoardVerdict | null;
+};
+/**
+ * Render a message file: front matter (`from`, `to`, `item`, `subject`, `at`),
+ * a blank line, the body, and — for a verdict — a final line that is exactly
+ * `VERDICT: APPROVED` or `VERDICT: CHANGES REQUESTED`.
+ */
+declare function formatBoardMessage(fields: BoardMessageFields, body: string, verdict?: BoardVerdict | null): string;
+/**
+ * Parse a message file. Tolerates a file without front matter (everything is
+ * the body). The verdict is read from the last non-empty line only, so a
+ * quoted verdict inside the body does not count.
+ */
+declare function parseBoardMessage(text: string): ParsedBoardMessage;
+//#endregion
+export { BoardMessageFields, ParsedBoardMessage, formatBoardMessage, parseBoardMessage };
+//# sourceMappingURL=board-message.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-message.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board-message.ts"],"mappings":";;;;KAGY,kBAAA;EACV,IAAA;EACA,EAAA;EACA,IAAA;EACA,OAAA;EACA,EAAA;AAAA;;KAIU,kBAAA,GAAqB,kBAAA;EAC/B,IAAA;EACA,OAAA,EAAS,YAAY;AAAA;AAFvB;;;;;AAAA,iBAegB,kBAAA,CACd,MAAA,EAAQ,kBAAA,EACR,IAAA,UACA,OAAA,GAAS,YAAY;;;;AAhBA;AAavB;iBA0CgB,iBAAA,CAAkB,IAAA,WAAe,kBAAkB"}

package/esm/tooling/board/board-message.mjs

@@ -0,0 +1,86 @@
+import { BOARD_VERDICT_LINES } from "./board.types.mjs";
+
+//#region ../../packages/core/src/tooling/board/board-message.ts
+/** Subjects are one line: newlines would break the front matter. */
+function oneLine(value) {
+	return value.replace(/[\r\n]+/g, " ").trim();
+}
+/**
+* Render a message file: front matter (`from`, `to`, `item`, `subject`, `at`),
+* a blank line, the body, and — for a verdict — a final line that is exactly
+* `VERDICT: APPROVED` or `VERDICT: CHANGES REQUESTED`.
+*/
+function formatBoardMessage(fields, body, verdict = null) {
+	const lines = [
+		"---",
+		`from: ${oneLine(fields.from)}`,
+		`to: ${oneLine(fields.to)}`,
+		`item: ${fields.item ?? ""}`,
+		`subject: ${oneLine(fields.subject)}`,
+		`at: ${fields.at}`,
+		"---",
+		""
+	];
+	const text = body.replace(/\s+$/, "");
+	if (text.length > 0) lines.push(text);
+	if (verdict) {
+		if (text.length > 0) lines.push("");
+		lines.push(BOARD_VERDICT_LINES[verdict]);
+	}
+	return `${lines.join("\n")}\n`;
+}
+/** The verdict a line spells, or `null`. */
+function verdictOf(line) {
+	const trimmed = line.trim();
+	if (trimmed === BOARD_VERDICT_LINES.approved) return "approved";
+	if (trimmed === BOARD_VERDICT_LINES["changes-requested"]) return "changes-requested";
+	return null;
+}
+/**
+* Parse a message file. Tolerates a file without front matter (everything is
+* the body). The verdict is read from the last non-empty line only, so a
+* quoted verdict inside the body does not count.
+*/
+function parseBoardMessage(text) {
+	const fields = {
+		from: "",
+		to: "",
+		item: null,
+		subject: "",
+		at: ""
+	};
+	let rest = text.replace(/\r\n/g, "\n");
+	if (rest.startsWith("---\n")) {
+		const end = rest.indexOf("\n---", 4);
+		if (end !== -1) {
+			const header = rest.slice(4, end);
+			for (const line of header.split("\n")) {
+				const separator = line.indexOf(":");
+				if (separator === -1) continue;
+				const key = line.slice(0, separator).trim();
+				const value = line.slice(separator + 1).trim();
+				if (key === "from") fields.from = value;
+				else if (key === "to") fields.to = value;
+				else if (key === "subject") fields.subject = value;
+				else if (key === "at") fields.at = value;
+				else if (key === "item") {
+					const id = Number.parseInt(value, 10);
+					fields.item = Number.isInteger(id) && id > 0 ? id : null;
+				}
+			}
+			rest = rest.slice(end + 4).replace(/^\n+/, "");
+		}
+	}
+	const lines = rest.replace(/\s+$/, "").split("\n");
+	const verdict = verdictOf(lines[lines.length - 1] ?? "");
+	if (verdict) lines.pop();
+	return {
+		...fields,
+		body: lines.join("\n").replace(/\s+$/, ""),
+		verdict
+	};
+}
+
+//#endregion
+export { formatBoardMessage, parseBoardMessage };
+//# sourceMappingURL=board-message.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-message.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board-message.ts"],"sourcesContent":["import { BOARD_VERDICT_LINES, type BoardVerdict } from \"./board.types\";\n\n/** The fields a message file's front matter carries. */\nexport type BoardMessageFields = {\n  from: string;\n  to: string;\n  item: number | null;\n  subject: string;\n  at: string;\n};\n\n/** A message file's contents, parsed. */\nexport type ParsedBoardMessage = BoardMessageFields & {\n  body: string;\n  verdict: BoardVerdict | null;\n};\n\n/** Subjects are one line: newlines would break the front matter. */\nfunction oneLine(value: string): string {\n  return value.replace(/[\\r\\n]+/g, \" \").trim();\n}\n\n/**\n * Render a message file: front matter (`from`, `to`, `item`, `subject`, `at`),\n * a blank line, the body, and — for a verdict — a final line that is exactly\n * `VERDICT: APPROVED` or `VERDICT: CHANGES REQUESTED`.\n */\nexport function formatBoardMessage(\n  fields: BoardMessageFields,\n  body: string,\n  verdict: BoardVerdict | null = null,\n): string {\n  const lines = [\n    \"---\",\n    `from: ${oneLine(fields.from)}`,\n    `to: ${oneLine(fields.to)}`,\n    `item: ${fields.item ?? \"\"}`,\n    `subject: ${oneLine(fields.subject)}`,\n    `at: ${fields.at}`,\n    \"---\",\n    \"\",\n  ];\n  const text = body.replace(/\\s+$/, \"\");\n\n  if (text.length > 0) lines.push(text);\n\n  if (verdict) {\n    if (text.length > 0) lines.push(\"\");\n    lines.push(BOARD_VERDICT_LINES[verdict]);\n  }\n\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\n/** The verdict a line spells, or `null`. */\nfunction verdictOf(line: string): BoardVerdict | null {\n  const trimmed = line.trim();\n\n  if (trimmed === BOARD_VERDICT_LINES.approved) return \"approved\";\n  if (trimmed === BOARD_VERDICT_LINES[\"changes-requested\"]) return \"changes-requested\";\n\n  return null;\n}\n\n/**\n * Parse a message file. Tolerates a file without front matter (everything is\n * the body). The verdict is read from the last non-empty line only, so a\n * quoted verdict inside the body does not count.\n */\nexport function parseBoardMessage(text: string): ParsedBoardMessage {\n  const fields: BoardMessageFields = { from: \"\", to: \"\", item: null, subject: \"\", at: \"\" };\n  let rest = text.replace(/\\r\\n/g, \"\\n\");\n\n  if (rest.startsWith(\"---\\n\")) {\n    const end = rest.indexOf(\"\\n---\", 4);\n\n    if (end !== -1) {\n      const header = rest.slice(4, end);\n\n      for (const line of header.split(\"\\n\")) {\n        const separator = line.indexOf(\":\");\n\n        if (separator === -1) continue;\n\n        const key = line.slice(0, separator).trim();\n        const value = line.slice(separator + 1).trim();\n\n        if (key === \"from\") fields.from = value;\n        else if (key === \"to\") fields.to = value;\n        else if (key === \"subject\") fields.subject = value;\n        else if (key === \"at\") fields.at = value;\n        else if (key === \"item\") {\n          const id = Number.parseInt(value, 10);\n          fields.item = Number.isInteger(id) && id > 0 ? id : null;\n        }\n      }\n\n      rest = rest.slice(end + 4).replace(/^\\n+/, \"\");\n    }\n  }\n\n  const lines = rest.replace(/\\s+$/, \"\").split(\"\\n\");\n  const last = lines[lines.length - 1] ?? \"\";\n  const verdict = verdictOf(last);\n\n  if (verdict) lines.pop();\n\n  return { ...fields, body: lines.join(\"\\n\").replace(/\\s+$/, \"\"), verdict };\n}\n"],"mappings":";;;;AAkBA,SAAS,QAAQ,OAAuB;CACtC,OAAO,MAAM,QAAQ,YAAY,GAAG,CAAC,CAAC,KAAK;AAC7C;;;;;;AAOA,SAAgB,mBACd,QACA,MACA,UAA+B,MACvB;CACR,MAAM,QAAQ;EACZ;EACA,SAAS,QAAQ,OAAO,IAAI;EAC5B,OAAO,QAAQ,OAAO,EAAE;EACxB,SAAS,OAAO,QAAQ;EACxB,YAAY,QAAQ,OAAO,OAAO;EAClC,OAAO,OAAO;EACd;EACA;CACF;CACA,MAAM,OAAO,KAAK,QAAQ,QAAQ,EAAE;CAEpC,IAAI,KAAK,SAAS,GAAG,MAAM,KAAK,IAAI;CAEpC,IAAI,SAAS;EACX,IAAI,KAAK,SAAS,GAAG,MAAM,KAAK,EAAE;EAClC,MAAM,KAAK,oBAAoB,QAAQ;CACzC;CAEA,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE;AAC7B;;AAGA,SAAS,UAAU,MAAmC;CACpD,MAAM,UAAU,KAAK,KAAK;CAE1B,IAAI,YAAY,oBAAoB,UAAU,OAAO;CACrD,IAAI,YAAY,oBAAoB,sBAAsB,OAAO;CAEjE,OAAO;AACT;;;;;;AAOA,SAAgB,kBAAkB,MAAkC;CAClE,MAAM,SAA6B;EAAE,MAAM;EAAI,IAAI;EAAI,MAAM;EAAM,SAAS;EAAI,IAAI;CAAG;CACvF,IAAI,OAAO,KAAK,QAAQ,SAAS,IAAI;CAErC,IAAI,KAAK,WAAW,OAAO,GAAG;EAC5B,MAAM,MAAM,KAAK,QAAQ,SAAS,CAAC;EAEnC,IAAI,QAAQ,IAAI;GACd,MAAM,SAAS,KAAK,MAAM,GAAG,GAAG;GAEhC,KAAK,MAAM,QAAQ,OAAO,MAAM,IAAI,GAAG;IACrC,MAAM,YAAY,KAAK,QAAQ,GAAG;IAElC,IAAI,cAAc,IAAI;IAEtB,MAAM,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK;IAC1C,MAAM,QAAQ,KAAK,MAAM,YAAY,CAAC,CAAC,CAAC,KAAK;IAE7C,IAAI,QAAQ,QAAQ,OAAO,OAAO;SAC7B,IAAI,QAAQ,MAAM,OAAO,KAAK;SAC9B,IAAI,QAAQ,WAAW,OAAO,UAAU;SACxC,IAAI,QAAQ,MAAM,OAAO,KAAK;SAC9B,IAAI,QAAQ,QAAQ;KACvB,MAAM,KAAK,OAAO,SAAS,OAAO,EAAE;KACpC,OAAO,OAAO,OAAO,UAAU,EAAE,KAAK,KAAK,IAAI,KAAK;IACtD;GACF;GAEA,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,QAAQ,QAAQ,EAAE;EAC/C;CACF;CAEA,MAAM,QAAQ,KAAK,QAAQ,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI;CAEjD,MAAM,UAAU,UADH,MAAM,MAAM,SAAS,MAAM,EACV;CAE9B,IAAI,SAAS,MAAM,IAAI;CAEvB,OAAO;EAAE,GAAG;EAAQ,MAAM,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ,QAAQ,EAAE;EAAG;CAAQ;AAC1E"}

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

@@ -0,0 +1,109 @@
+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. */
+  gitignoreUpdated: boolean;
+};
+/** Inputs of {@link addBoardItem}. */
+type AddBoardItemInput = {
+  title: string;
+  assignee?: string | null;
+  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 = {
+  by?: string | null;
+  note?: string | null;
+  now?: () => Date;
+};
+/** Inputs of {@link sendBoardMessage}. */
+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. */
+  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. */
+  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). */
+  signal?: AbortSignal;
+};
+/** What {@link watchBoard} returned. */
+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;
+/** Throw unless `name` is a valid agent name. */
+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;
+/**
+ * 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;
+/** Every item, by id. Throws `WL7401` when the board does not exist. */
+declare function listBoardItems(cwd?: string): BoardItem[];
+/** One item. Throws `WL7402` for an unknown id. */
+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;
+/** The states an item in `state` may move to. */
+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;
+/**
+ * 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;
+/**
+ * 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.
+ */
+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?: {
+  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;
+/** Record that `agent` has seen messages up to `number`. Never moves the cursor back. */
+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;
+/**
+ * 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.
+ */
+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

@@ -0,0 +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"}