@warlock.js/core 5.29.0 → 5.31.0

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

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

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

@@ -0,0 +1,72 @@
+//#region ../../packages/core/src/tooling/board/board.types.d.ts
+/**
+ * Types and the state machine of the agent board (`warlock board`): a
+ * git-ignored folder two coding agents — usually an implementer and a
+ * reviewer — share to track work items and exchange append-only messages.
+ */
+/** Where the board lives, under the project root. */
+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"];
+/** One item state. */
+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[]>>;
+/** A review verdict a message can carry. */
+type BoardVerdict = "approved" | "changes-requested";
+/** The exact final line each verdict is written as. */
+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. */
+  at: string;
+  note: string | null;
+};
+/** One work item, stored as `items/NNNN-<slug>.json`. */
+type BoardItem = {
+  id: number;
+  title: string;
+  state: BoardState;
+  assignee: string | null;
+  reviewer: string | null;
+  createdAt: string;
+  updatedAt: string;
+  history: BoardHistoryEntry[];
+};
+/** One message, stored as `to-<agent>/NNNN-<slug>.md`. */
+type BoardMessage = {
+  /** The per-recipient sequence number (`NNNN`). */number: number; /** Path relative to the project root, POSIX separators. */
+  file: string;
+  from: string;
+  to: string; /** The item the message is about, or `null`. */
+  item: number | null;
+  subject: string; /** ISO time. */
+  at: string;
+  body: string;
+  verdict: BoardVerdict | null;
+};
+/** One recipient's inbox, as `readBoardStatus` reports it. */
+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 = {
+  schemaVersion: 1;
+  items: BoardItem[];
+  inboxes: BoardInbox[];
+};
+/** Whether a string is a board state. */
+declare function isBoardState(value: string): value is BoardState;
+/** Whether a string is a verdict. */
+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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"changed-files.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/changed-files.ts"],"mappings":";;;;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"}

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

@@ -0,0 +1,73 @@
+import { createProblem } from "../problem.mjs";
+import path from "node:path";
+import { existsSync } from "node:fs";
+import { execFile } from "node:child_process";
+
+//#region ../../packages/core/src/tooling/check/changed-files.ts
+/** The default {@link GitRunner}: the `git` on PATH. */
+const runGit = (args, cwd) => new Promise((resolve) => {
+	execFile("git", [...args], {
+		cwd,
+		encoding: "utf8",
+		windowsHide: true,
+		maxBuffer: 16 * 1024 * 1024
+	}, (error, stdout, stderr) => {
+		resolve({
+			code: error === null ? 0 : typeof error.code === "number" ? error.code : 127,
+			stdout,
+			stderr: stderr || (error?.message ?? "")
+		});
+	});
+});
+/** Files `warlock check --changed` considers: JavaScript and TypeScript sources. */
+const SOURCE_FILE = /\.(?:[cm]?[jt]sx?)$/i;
+function lines(output) {
+	return output.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+}
+function gitProblem(message) {
+	return createProblem({
+		code: "WL8006",
+		source: "environment",
+		message
+	});
+}
+/**
+* The source files changed in the working tree — tracked changes against
+* `base` (or HEAD) plus untracked files — relative to `cwd`, existing only.
+*
+* With `base`, the comparison point is `git merge-base <base> HEAD`, so a
+* branch is compared with where it left `base` rather than with `base`'s tip.
+* A git failure is a `WL8006` environment problem.
+*/
+async function listChangedFiles(options) {
+	const git = options.git ?? runGit;
+	let ref = "HEAD";
+	if (options.base) {
+		const mergeBase = await git([
+			"merge-base",
+			options.base,
+			"HEAD"
+		], options.cwd);
+		if (mergeBase.code !== 0) return { problem: gitProblem(`git merge-base ${options.base} HEAD failed: ${mergeBase.stderr.trim() || `exit ${mergeBase.code}`}`) };
+		ref = mergeBase.stdout.trim();
+	}
+	const diff = await git([
+		"diff",
+		"--name-only",
+		"--relative",
+		"--diff-filter=ACMR",
+		ref
+	], options.cwd);
+	if (diff.code !== 0) return { problem: gitProblem(`git diff against ${ref} failed: ${diff.stderr.trim() || `exit ${diff.code}`}`) };
+	const untracked = await git([
+		"ls-files",
+		"--others",
+		"--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() };
+}
+
+//#endregion
+export { listChangedFiles, runGit };
+//# sourceMappingURL=changed-files.mjs.map

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

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

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

@@ -0,0 +1,62 @@
+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"];
+/** One step name. */
+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";
+/** One step of the report. */
+type CheckStep = {
+  name: CheckStepName;
+  status: CheckStepStatus;
+  durationMs: number; /** One line on what the step did or why it did not run, or `null`. */
+  detail: string | null;
+};
+/**
+ * Exit codes of `warlock check` and `warlock typecheck`:
+ *
+ * | Code | Meaning                                                                    |
+ * | ---- | -------------------------------------------------------------------------- |
+ * | 0    | no error-severity problem (warnings are allowed)                           |
+ * | 1    | problems in your code only: type, lint, test or convention errors          |
+ * | 2    | this machine: Node version, missing tool, unreachable service, busy port,  |
+ * |      | git unavailable, a tool that crashed — the run is incomplete               |
+ *
+ * 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: {
+  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];
+/** The exit code for a set of problems; see {@link CHECK_EXIT_CODES}. */
+declare function checkExitCode(problems: readonly ToolingProblem[]): CheckExitCode;
+/** What `warlock check --json` prints. */
+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. */
+  files: string[] | null;
+  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. */
+    environment: number;
+  };
+};
+//#endregion
+export { CHECK_EXIT_CODES, CHECK_STEPS, CheckExitCode, CheckReport, CheckStep, CheckStepName, CheckStepStatus, checkExitCode };
+//# sourceMappingURL=check-report.types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-report.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/check-report.types.ts"],"mappings":";;;;cAGa,WAAA;AAAb;AAAA,KAGY,aAAA,WAAwB,WAAW;;;AAHiD;AAGhG;;;KAQY,eAAA;AARmC;AAAA,KAWnC,SAAA;EACV,IAAA,EAAM,aAAA;EACN,MAAA,EAAQ,eAAe;EACvB,UAAA,UANyB;EAQzB,MAAA;AAAA;;;;;;;;;;AAAM;AAgBR;;;cAAa,gBAAA;EAAA;;;;;KAOD,aAAA,WAAwB,gBAAA,eAA+B,gBAAgB;;iBAGnE,aAAA,CAAc,QAAA,WAAmB,cAAA,KAAmB,aAAa;;KAWrE,WAAA;EACV,aAAA,KAZ2B;EAc3B,EAAA;EACA,QAAA,EAAU,aAAA,EAfqC;EAiB/C,OAAA,WAjBkE;EAmBlE,KAAA;EACA,KAAA,EAAO,SAAA,IATG;EAWV,QAAA,EAAU,cAAA;EACV,OAAA;IACE,MAAA;IACA,QAAA,UAHQ;IAKR,IAAA,UALsB;IAOtB,WAAA;EAAA;AAAA"}

package/esm/tooling/check/check-report.types.mjs

@@ -0,0 +1,37 @@
+//#region ../../packages/core/src/tooling/check/check-report.types.ts
+/** The steps `warlock check` runs, in order. */
+const CHECK_STEPS = [
+	"environment",
+	"typecheck",
+	"lint",
+	"tests",
+	"conventions"
+];
+/**
+* Exit codes of `warlock check` and `warlock typecheck`:
+*
+* | Code | Meaning                                                                    |
+* | ---- | -------------------------------------------------------------------------- |
+* | 0    | no error-severity problem (warnings are allowed)                           |
+* | 1    | problems in your code only: type, lint, test or convention errors          |
+* | 2    | this machine: Node version, missing tool, unreachable service, busy port,  |
+* |      | git unavailable, a tool that crashed — the run is incomplete               |
+*
+* 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.
+*/
+const CHECK_EXIT_CODES = {
+	ok: 0,
+	code: 1,
+	environment: 2
+};
+/** The exit code for a set of problems; see {@link CHECK_EXIT_CODES}. */
+function checkExitCode(problems) {
+	const errors = problems.filter((problem) => problem.severity === "error");
+	if (errors.some((problem) => problem.category === "environment")) return CHECK_EXIT_CODES.environment;
+	return errors.length > 0 ? CHECK_EXIT_CODES.code : CHECK_EXIT_CODES.ok;
+}
+
+//#endregion
+export { CHECK_EXIT_CODES, CHECK_STEPS, checkExitCode };
+//# sourceMappingURL=check-report.types.mjs.map

package/esm/tooling/check/check-report.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-report.types.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/check-report.types.ts"],"sourcesContent":["import type { ToolingProblem } from \"../problem\";\n\n/** The steps `warlock check` runs, in order. */\nexport const CHECK_STEPS = [\"environment\", \"typecheck\", \"lint\", \"tests\", \"conventions\"] as const;\n\n/** One step name. */\nexport type CheckStepName = (typeof CHECK_STEPS)[number];\n\n/**\n * - `passed`: ran and found no error.\n * - `failed`: ran and found at least one error-severity problem.\n * - `skipped`: does not apply (no lint config, no tests, nothing changed, `--skip`).\n * - `blocked`: could not run because of this machine; an environment problem says why.\n */\nexport type CheckStepStatus = \"passed\" | \"failed\" | \"skipped\" | \"blocked\";\n\n/** One step of the report. */\nexport type CheckStep = {\n  name: CheckStepName;\n  status: CheckStepStatus;\n  durationMs: number;\n  /** One line on what the step did or why it did not run, or `null`. */\n  detail: string | null;\n};\n\n/**\n * Exit codes of `warlock check` and `warlock typecheck`:\n *\n * | Code | Meaning                                                                    |\n * | ---- | -------------------------------------------------------------------------- |\n * | 0    | no error-severity problem (warnings are allowed)                           |\n * | 1    | problems in your code only: type, lint, test or convention errors          |\n * | 2    | this machine: Node version, missing tool, unreachable service, busy port,  |\n * |      | git unavailable, a tool that crashed — the run is incomplete               |\n *\n * 2 wins over 1: when the machine kept a step from running, the run did not\n * check everything, so \"only your code is wrong\" cannot be claimed.\n */\nexport const CHECK_EXIT_CODES = {\n  ok: 0,\n  code: 1,\n  environment: 2,\n} as const;\n\n/** One of {@link CHECK_EXIT_CODES}. */\nexport type CheckExitCode = (typeof CHECK_EXIT_CODES)[keyof typeof CHECK_EXIT_CODES];\n\n/** The exit code for a set of problems; see {@link CHECK_EXIT_CODES}. */\nexport function checkExitCode(problems: readonly ToolingProblem[]): CheckExitCode {\n  const errors = problems.filter((problem) => problem.severity === \"error\");\n\n  if (errors.some((problem) => problem.category === \"environment\")) {\n    return CHECK_EXIT_CODES.environment;\n  }\n\n  return errors.length > 0 ? CHECK_EXIT_CODES.code : CHECK_EXIT_CODES.ok;\n}\n\n/** What `warlock check --json` prints. */\nexport type CheckReport = {\n  schemaVersion: 1;\n  /** `true` when the exit code is 0. */\n  ok: boolean;\n  exitCode: CheckExitCode;\n  /** Whether the run was limited to changed files. */\n  changed: boolean;\n  /** The changed files the run was limited to (project-relative), or `null` for a full run. */\n  files: string[] | null;\n  steps: CheckStep[];\n  /** One entry per problem, in step order. */\n  problems: ToolingProblem[];\n  summary: {\n    errors: number;\n    warnings: number;\n    /** Error-severity problems in the code. */\n    code: number;\n    /** Error-severity problems with the machine. */\n    environment: number;\n  };\n};\n"],"mappings":";;AAGA,MAAa,cAAc;CAAC;CAAe;CAAa;CAAQ;CAAS;AAAa;;;;;;;;;;;;;;AAmCtF,MAAa,mBAAmB;CAC9B,IAAI;CACJ,MAAM;CACN,aAAa;AACf;;AAMA,SAAgB,cAAc,UAAoD;CAChF,MAAM,SAAS,SAAS,QAAQ,YAAY,QAAQ,aAAa,OAAO;CAExE,IAAI,OAAO,MAAM,YAAY,QAAQ,aAAa,aAAa,GAC7D,OAAO,iBAAiB;CAG1B,OAAO,OAAO,SAAS,IAAI,iBAAiB,OAAO,iBAAiB;AACtE"}

package/esm/tooling/check/code-style-conventions.mjs

@@ -0,0 +1,106 @@
+import { isMemberAccess, keyName, memberName, unwrap } from "./source-ast.mjs";
+import ts from "typescript";
+
+//#region ../../packages/core/src/tooling/check/code-style-conventions.ts
+const AWAITED_LOGGER_NAMES = new Set(["log", "logger"]);
+/** Logger methods that return the logger synchronously since 5.30. */
+const SYNC_LOG_METHODS = new Set([
+	"info",
+	"warn",
+	"error",
+	"debug",
+	"success",
+	"fatal",
+	"log",
+	"assert"
+]);
+function checkAwaitLog(node, findings) {
+	if (!ts.isAwaitExpression(node)) return;
+	const argument = unwrap(node.expression);
+	if (!ts.isCallExpression(argument)) return;
+	const callee = unwrap(argument.expression);
+	if (!isMemberAccess(callee)) return;
+	const owner = unwrap(callee.expression);
+	if (!ts.isIdentifier(owner) || !AWAITED_LOGGER_NAMES.has(owner.text)) return;
+	const method = memberName(callee);
+	if (!method || !SYNC_LOG_METHODS.has(method)) return;
+	findings.push({
+		code: "WL9010",
+		severity: "warning",
+		node,
+		message: `\`${owner.text}.${method}()\` returns the logger synchronously; \`await\` does nothing here. Remove it (use \`await log.flush()\` to wait for delivery).`
+	});
+}
+/** Handler type annotations that mark a constant as a controller. */
+const HANDLER_TYPE_PATTERN = /RequestHandler$/;
+const CONTROLLER_NAME_PATTERN = /Controller$/;
+function hasHandlerType(declaration) {
+	const type = declaration.type;
+	return type !== void 0 && ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName) && HANDLER_TYPE_PATTERN.test(type.typeName.text);
+}
+function controllerIdentifiers(statement) {
+	if (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) return statement.name && CONTROLLER_NAME_PATTERN.test(statement.name.text) ? [statement.name] : [];
+	if (!ts.isVariableStatement(statement)) return [];
+	const found = [];
+	for (const declaration of statement.declarationList.declarations) {
+		if (!ts.isIdentifier(declaration.name)) continue;
+		if (CONTROLLER_NAME_PATTERN.test(declaration.name.text) || hasHandlerType(declaration)) found.push(declaration.name);
+	}
+	return found;
+}
+function ordinal(position) {
+	if (position === 2) return "2nd";
+	if (position === 3) return "3rd";
+	return `${position}th`;
+}
+function checkOneControllerPerFile(sourceFile, findings) {
+	const controllers = sourceFile.statements.flatMap(controllerIdentifiers);
+	const first = controllers[0];
+	if (!first) return;
+	controllers.slice(1).forEach((identifier, index) => {
+		findings.push({
+			code: "WL9011",
+			severity: "warning",
+			node: identifier,
+			message: `\`${identifier.text}\` is the ${ordinal(index + 2)} controller in this file (after \`${first.text}\`). Move it to its own \`*.controller.ts\` file.`
+		});
+	});
+}
+/** A string/number literal type, or a union made only of them. */
+function isLiteralType(node) {
+	if (!node) return false;
+	if (ts.isLiteralTypeNode(node)) return true;
+	return ts.isUnionTypeNode(node) && node.types.every((member) => ts.isLiteralTypeNode(member));
+}
+function checkKindDiscriminator(node, findings) {
+	if (!ts.isPropertySignature(node) || ts.isComputedPropertyName(node.name)) return;
+	if (keyName(node.name) !== "kind" || !isLiteralType(node.type)) return;
+	findings.push({
+		code: "WL9012",
+		severity: "warning",
+		node: node.name,
+		message: "Name this discriminator `type`, not `kind` (the framework's convention for tagged unions)."
+	});
+}
+/**
+* The code-style conventions in one parsed file, all reported as warnings:
+*
+* - `WL9010` `await` on a synchronous `log.*()` call;
+* - `WL9011` a second (third, …) controller in one file;
+* - `WL9012` a tagged union whose discriminator is `kind` instead of `type`.
+*/
+function codeStyleFindings(sourceFile) {
+	const findings = [];
+	checkOneControllerPerFile(sourceFile, findings);
+	const visit = (node) => {
+		checkAwaitLog(node, findings);
+		checkKindDiscriminator(node, findings);
+		ts.forEachChild(node, visit);
+	};
+	visit(sourceFile);
+	return findings;
+}
+
+//#endregion
+export { codeStyleFindings };
+//# sourceMappingURL=code-style-conventions.mjs.map

package/esm/tooling/check/code-style-conventions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-style-conventions.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/code-style-conventions.ts"],"sourcesContent":["import ts from \"typescript\";\nimport { isMemberAccess, keyName, memberName, type SourceFinding, unwrap } from \"./source-ast\";\n\n// ── WL9010: await on a synchronous log call ─────────────────────────────────\n\nconst AWAITED_LOGGER_NAMES: ReadonlySet<string> = new Set([\"log\", \"logger\"]);\n\n/** Logger methods that return the logger synchronously since 5.30. */\nconst SYNC_LOG_METHODS: ReadonlySet<string> = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\nfunction checkAwaitLog(node: ts.Node, findings: SourceFinding[]): void {\n  if (!ts.isAwaitExpression(node)) return;\n\n  const argument = unwrap(node.expression);\n\n  if (!ts.isCallExpression(argument)) return;\n\n  const callee = unwrap(argument.expression);\n\n  if (!isMemberAccess(callee)) return;\n\n  const owner = unwrap(callee.expression);\n\n  if (!ts.isIdentifier(owner) || !AWAITED_LOGGER_NAMES.has(owner.text)) return;\n\n  const method = memberName(callee);\n\n  if (!method || !SYNC_LOG_METHODS.has(method)) return;\n\n  findings.push({\n    code: \"WL9010\",\n    severity: \"warning\",\n    node,\n    message: `\\`${owner.text}.${method}()\\` returns the logger synchronously; \\`await\\` does nothing here. Remove it (use \\`await log.flush()\\` to wait for delivery).`,\n  });\n}\n\n// ── WL9011: more than one controller in a file ──────────────────────────────\n\n/** Handler type annotations that mark a constant as a controller. */\nconst HANDLER_TYPE_PATTERN = /RequestHandler$/;\n\nconst CONTROLLER_NAME_PATTERN = /Controller$/;\n\nfunction hasHandlerType(declaration: ts.VariableDeclaration): boolean {\n  const type = declaration.type;\n\n  return (\n    type !== undefined &&\n    ts.isTypeReferenceNode(type) &&\n    ts.isIdentifier(type.typeName) &&\n    HANDLER_TYPE_PATTERN.test(type.typeName.text)\n  );\n}\n\nfunction controllerIdentifiers(statement: ts.Statement): ts.Identifier[] {\n  if (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) {\n    return statement.name && CONTROLLER_NAME_PATTERN.test(statement.name.text)\n      ? [statement.name]\n      : [];\n  }\n\n  if (!ts.isVariableStatement(statement)) return [];\n\n  const found: ts.Identifier[] = [];\n\n  for (const declaration of statement.declarationList.declarations) {\n    if (!ts.isIdentifier(declaration.name)) continue;\n\n    if (CONTROLLER_NAME_PATTERN.test(declaration.name.text) || hasHandlerType(declaration)) {\n      found.push(declaration.name);\n    }\n  }\n\n  return found;\n}\n\nfunction ordinal(position: number): string {\n  if (position === 2) return \"2nd\";\n  if (position === 3) return \"3rd\";\n\n  return `${position}th`;\n}\n\nfunction checkOneControllerPerFile(sourceFile: ts.SourceFile, findings: SourceFinding[]): void {\n  const controllers = sourceFile.statements.flatMap(controllerIdentifiers);\n  const first = controllers[0];\n\n  if (!first) return;\n\n  controllers.slice(1).forEach((identifier, index) => {\n    findings.push({\n      code: \"WL9011\",\n      severity: \"warning\",\n      node: identifier,\n      message: `\\`${identifier.text}\\` is the ${ordinal(index + 2)} controller in this file (after \\`${first.text}\\`). Move it to its own \\`*.controller.ts\\` file.`,\n    });\n  });\n}\n\n// ── WL9012: a union discriminator named `kind` ──────────────────────────────\n\n/** A string/number literal type, or a union made only of them. */\nfunction isLiteralType(node: ts.TypeNode | undefined): boolean {\n  if (!node) return false;\n  if (ts.isLiteralTypeNode(node)) return true;\n\n  return ts.isUnionTypeNode(node) && node.types.every((member) => ts.isLiteralTypeNode(member));\n}\n\nfunction checkKindDiscriminator(node: ts.Node, findings: SourceFinding[]): void {\n  if (!ts.isPropertySignature(node) || ts.isComputedPropertyName(node.name)) return;\n  if (keyName(node.name) !== \"kind\" || !isLiteralType(node.type)) return;\n\n  findings.push({\n    code: \"WL9012\",\n    severity: \"warning\",\n    node: node.name,\n    message:\n      \"Name this discriminator `type`, not `kind` (the framework's convention for tagged unions).\",\n  });\n}\n\n/**\n * The code-style conventions in one parsed file, all reported as warnings:\n *\n * - `WL9010` `await` on a synchronous `log.*()` call;\n * - `WL9011` a second (third, …) controller in one file;\n * - `WL9012` a tagged union whose discriminator is `kind` instead of `type`.\n */\nexport function codeStyleFindings(sourceFile: ts.SourceFile): SourceFinding[] {\n  const findings: SourceFinding[] = [];\n\n  checkOneControllerPerFile(sourceFile, findings);\n\n  // Every node, type nodes included: discriminators live in type literals and interfaces.\n  const visit = (node: ts.Node): void => {\n    checkAwaitLog(node, findings);\n    checkKindDiscriminator(node, findings);\n    ts.forEachChild(node, visit);\n  };\n\n  visit(sourceFile);\n\n  return findings;\n}\n"],"mappings":"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"}

package/esm/tooling/check/conventions-step.d.mts

@@ -0,0 +1,34 @@
+import { ToolingProblem } from "../problem.mjs";
+
+//#region ../../packages/core/src/tooling/check/conventions-step.d.ts
+/** Matches a project-relative path of a file the framework loads by itself. */
+declare function isAutoLoadedFile(relativePath: string): boolean;
+/**
+ * The convention problems in one source file, in source order:
+ *
+ * - `WL9001` an import of a file the framework loads by itself (`routes.ts`,
+ *   `main.ts`, `worker.ts`, `events/*`) — importing it registers it twice;
+ * - `WL9002` a relative import ending in `.js`;
+ * - `WL9003` a relative import from one `src/app/<module>` into another, which
+ *   should use the `app/<module>/...` alias;
+ * - `WL9005`–`WL9009` the security conventions (see `securityFindings`):
+ *   `request.all()` into a query or service, a mutating route with no guard
+ *   and no `public: true`, a redirect target from request input, sensitive
+ *   values in logs, unbounded regexes on request input;
+ * - `WL9010`–`WL9012` warnings: `await log.*()`, a second controller in one
+ *   file, a `kind` discriminator.
+ *
+ * A `// warlock-check-ignore WL9006` comment on the problem's line or the line
+ * above silences that code there; without codes it silences every one.
+ */
+declare function checkFileConventions(relativePath: string, source: string, cwd: string): ToolingProblem[];
+/** `WL9004` when the project tsconfig turns on legacy decorators. */
+declare function checkTsconfigConventions(cwd: string, project?: string): ToolingProblem[];
+/**
+ * Run every convention check over `files` (project-relative) plus the
+ * project tsconfig.
+ */
+declare function runConventions(cwd: string, files: readonly string[], project?: string): ToolingProblem[];
+//#endregion
+export { checkFileConventions, checkTsconfigConventions, isAutoLoadedFile, runConventions };
+//# sourceMappingURL=conventions-step.d.mts.map

package/esm/tooling/check/conventions-step.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions-step.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/conventions-step.ts"],"mappings":";;;;iBAegB,gBAAA,CAAiB,YAAoB;AAArD;;;;AAAqD;AAwLrD;;;;;;;;;AAIiB;AAmBjB;;;AA/MA,iBAwLgB,oBAAA,CACd,YAAA,UACA,MAAA,UACA,GAAA,WACC,cAAc;;iBAmBD,wBAAA,CAAyB,GAAA,UAAa,OAAA,YAA4B,cAAc;;;AAAA;AAyChG;iBAAgB,cAAA,CACd,GAAA,UACA,KAAA,qBACA,OAAA,YACC,cAAc"}