@warlock.js/core 5.30.0 → 5.31.0

package/esm/cli/commands/board/board-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/board/board-command.action.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { WarlockError } from \"../../../errors/warlock-error\";\nimport {\n  addBoardItem,\n  initBoard,\n  moveBoardItem,\n  nextBoardStates,\n  readBoardItem,\n  readBoardStatus,\n  sendBoardMessage,\n  watchBoard,\n} from \"../../../tooling/board/board\";\nimport {\n  BOARD_STATES,\n  BOARD_VERDICT_LINES,\n  type BoardItem,\n  type BoardMessage,\n  type BoardState,\n  type BoardVerdict,\n  isBoardState,\n  isBoardVerdict,\n} from \"../../../tooling/board/board.types\";\nimport { flushAndExit } from \"../../flush-and-exit\";\n\n/** The exit code of `warlock board watch` when it times out. */\nexport const BOARD_WATCH_TIMEOUT_EXIT_CODE = 3;\n\n/** The sub-commands of `warlock board`. */\nexport const BOARD_ACTIONS = [\"init\", \"add\", \"status\", \"send\", \"watch\"] as const;\n\n/** One parsed `warlock board …` invocation. */\nexport type BoardInvocation =\n  | { type: \"init\" }\n  | {\n      type: \"add\";\n      title: string;\n      assignee: string | null;\n      reviewer: string | null;\n      by: string | null;\n    }\n  | { type: \"overview\" }\n  | { type: \"item\"; id: number }\n  | { type: \"move\"; id: number; state: BoardState; by: string | null; note: string | null }\n  | {\n      type: \"send\";\n      to: string;\n      from: string;\n      subject: string;\n      body: string;\n      item: number | null;\n      verdict: BoardVerdict | null;\n    }\n  | { type: \"watch\"; agent: string; timeoutMs: number; since: number | undefined };\n\ntype Options = CommandActionData[\"options\"];\n\nfunction stringOption(options: Options, key: string): string | undefined {\n  const value = options[key];\n\n  if (typeof value === \"number\") return String(value);\n\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction parseId(value: string | undefined, label: string): number {\n  const id = value === undefined ? Number.NaN : Number(value);\n\n  if (!Number.isInteger(id) || id < 1) {\n    throw new Error(`${label} must be a positive whole number, got ${JSON.stringify(value)}.`);\n  }\n\n  return id;\n}\n\n/** `--body text` as is; `--body @notes.md` reads the file (relative to `cwd`). */\nexport function readBodyOption(value: string | undefined, cwd: string): string {\n  if (value === undefined) return \"\";\n\n  return value.startsWith(\"@\") ? readFileSync(path.resolve(cwd, value.slice(1)), \"utf8\") : value;\n}\n\n/** The current agent: the explicit option, else `WARLOCK_AGENT`, else `null`. */\nfunction agentOf(options: Options, key: string, environment: NodeJS.ProcessEnv): string | null {\n  return stringOption(options, key) ?? environment.WARLOCK_AGENT ?? null;\n}\n\n/**\n * Turn `warlock board <action> [args...]` into a {@link BoardInvocation}.\n * Throws on an unknown action, a missing argument or an invalid value.\n *\n * @param args Positionals after `board`: the action first.\n * @param options Parsed flags.\n * @param cwd Where `--body @file` resolves.\n * @param environment Where `WARLOCK_AGENT` is read.\n */\nexport function parseBoardInvocation(\n  args: readonly string[],\n  options: Options,\n  cwd = process.cwd(),\n  environment: NodeJS.ProcessEnv = process.env,\n): BoardInvocation {\n  const [action, ...rest] = args;\n\n  switch (action) {\n    case \"init\":\n      return { type: \"init\" };\n\n    case \"add\": {\n      const title = rest.join(\" \").trim();\n\n      if (title.length === 0)\n        throw new Error('Usage: warlock board add \"<title>\" [--assignee a --reviewer b]');\n\n      return {\n        type: \"add\",\n        title,\n        assignee: stringOption(options, \"assignee\") ?? null,\n        reviewer: stringOption(options, \"reviewer\") ?? null,\n        by: agentOf(options, \"by\", environment),\n      };\n    }\n\n    case \"status\": {\n      const [idText, state] = rest;\n\n      if (idText === undefined) return { type: \"overview\" };\n\n      const id = parseId(idText, \"The item id\");\n\n      if (state === undefined) return { type: \"item\", id };\n\n      if (!isBoardState(state)) {\n        throw new Error(\n          `Unknown state ${JSON.stringify(state)}. States: ${BOARD_STATES.join(\", \")}.`,\n        );\n      }\n\n      return {\n        type: \"move\",\n        id,\n        state,\n        by: agentOf(options, \"by\", environment),\n        note: stringOption(options, \"note\") ?? null,\n      };\n    }\n\n    case \"send\": {\n      const [to, ...subjectWords] = rest;\n      const subject = subjectWords.join(\" \").trim();\n\n      if (to === undefined || subject.length === 0) {\n        throw new Error(\n          'Usage: warlock board send <agent> \"<subject>\" --from <agent> [--item id --body text|@file --verdict approved|changes-requested]',\n        );\n      }\n\n      const from = agentOf(options, \"from\", environment);\n\n      if (from === null) {\n        throw new Error(\"Name the sender with --from <agent> (or set WARLOCK_AGENT).\");\n      }\n\n      const verdict = stringOption(options, \"verdict\");\n\n      if (verdict !== undefined && !isBoardVerdict(verdict)) {\n        throw new Error(\n          `--verdict must be \"approved\" or \"changes-requested\", got ${JSON.stringify(verdict)}.`,\n        );\n      }\n\n      const item = stringOption(options, \"item\");\n\n      return {\n        type: \"send\",\n        to,\n        from,\n        subject,\n        body: readBodyOption(stringOption(options, \"body\"), cwd),\n        item: item === undefined ? null : parseId(item, \"--item\"),\n        verdict: verdict ?? null,\n      };\n    }\n\n    case \"watch\": {\n      const [agent] = rest;\n\n      if (agent === undefined)\n        throw new Error(\"Usage: warlock board watch <agent> [--timeout seconds --since N]\");\n\n      const timeout = stringOption(options, \"timeout\");\n      const seconds = timeout === undefined ? 600 : Number(timeout);\n\n      if (!Number.isFinite(seconds) || seconds <= 0) {\n        throw new Error(\n          `--timeout must be a positive number of seconds, got ${JSON.stringify(timeout)}.`,\n        );\n      }\n\n      const since = stringOption(options, \"since\");\n      const sinceNumber = since === undefined ? undefined : Number(since);\n\n      if (sinceNumber !== undefined && (!Number.isInteger(sinceNumber) || sinceNumber < 0)) {\n        throw new Error(`--since must be a whole number, got ${JSON.stringify(since)}.`);\n      }\n\n      return { type: \"watch\", agent, timeoutMs: Math.round(seconds * 1000), since: sinceNumber };\n    }\n\n    default:\n      throw new Error(\n        `Unknown board action ${JSON.stringify(action ?? \"\")}. Actions: ${BOARD_ACTIONS.join(\", \")}.`,\n      );\n  }\n}\n\n/** `#3 [in-progress] Add the orders module  (implementer → reviewer)` */\nexport function formatBoardItemLine(item: BoardItem): string {\n  const people =\n    item.assignee || item.reviewer ? `  (${item.assignee ?? \"-\"} → ${item.reviewer ?? \"-\"})` : \"\";\n\n  return `#${item.id} [${item.state}] ${item.title}${people}`;\n}\n\nfunction formatMessage(message: BoardMessage): string[] {\n  const about = message.item === null ? \"\" : ` (item #${message.item})`;\n\n  return [\n    `── ${message.file}`,\n    `From ${message.from}${about}: ${message.subject}`,\n    ...(message.body.length > 0 ? [\"\", message.body] : []),\n    ...(message.verdict ? [\"\", BOARD_VERDICT_LINES[message.verdict]] : []),\n    \"\",\n  ];\n}\n\n/** What one invocation produced: the JSON to print, the human lines, and the exit code. */\nexport type BoardOutcome = { json: unknown; lines: string[]; exitCode: number };\n\n/** Run one parsed invocation against the board in `cwd`. Throws `WarlockError`s with WL74xx codes. */\nexport async function runBoardInvocation(\n  invocation: BoardInvocation,\n  cwd = process.cwd(),\n): Promise<BoardOutcome> {\n  switch (invocation.type) {\n    case \"init\": {\n      const result = initBoard(cwd);\n\n      return {\n        json: { ok: true, ...result },\n        lines: [\n          result.created ? `Created ${result.directory}/` : `${result.directory}/ already exists`,\n          ...(result.gitignoreUpdated ? [`Added ${result.directory}/ to .gitignore`] : []),\n        ],\n        exitCode: 0,\n      };\n    }\n\n    case \"add\": {\n      const item = addBoardItem(\n        {\n          title: invocation.title,\n          assignee: invocation.assignee,\n          reviewer: invocation.reviewer,\n          by: invocation.by,\n        },\n        cwd,\n      );\n\n      return {\n        json: { ok: true, item },\n        lines: [`Added ${formatBoardItemLine(item)}`],\n        exitCode: 0,\n      };\n    }\n\n    case \"overview\": {\n      const status = readBoardStatus(cwd);\n      const lines =\n        status.items.length === 0\n          ? ['No items. Add one with `warlock board add \"<title>\"`.']\n          : status.items.map(formatBoardItemLine);\n\n      if (status.inboxes.length > 0) {\n        lines.push(\"\", \"Inboxes:\");\n\n        for (const inbox of status.inboxes) {\n          lines.push(\n            `  ${inbox.agent.padEnd(16)} ${inbox.messages} message(s), ${inbox.unread} unread`,\n          );\n        }\n      }\n\n      return { json: { ok: true, ...status }, lines, exitCode: 0 };\n    }\n\n    case \"item\": {\n      const item = readBoardItem(invocation.id, cwd);\n      const next = nextBoardStates(item.state);\n\n      return {\n        json: { ok: true, item, next },\n        lines: [\n          formatBoardItemLine(item),\n          `  next: ${next.join(\", \")}`,\n          ...item.history.map(\n            (entry) =>\n              `  ${entry.at}  ${entry.from ?? \"∅\"} → ${entry.to}${entry.by ? ` by ${entry.by}` : \"\"}${entry.note ? ` — ${entry.note}` : \"\"}`,\n          ),\n        ],\n        exitCode: 0,\n      };\n    }\n\n    case \"move\": {\n      const item = moveBoardItem(\n        invocation.id,\n        invocation.state,\n        { by: invocation.by, note: invocation.note },\n        cwd,\n      );\n\n      return {\n        json: { ok: true, item },\n        lines: [`Moved ${formatBoardItemLine(item)}`],\n        exitCode: 0,\n      };\n    }\n\n    case \"send\": {\n      const result = sendBoardMessage(\n        {\n          to: invocation.to,\n          from: invocation.from,\n          subject: invocation.subject,\n          body: invocation.body,\n          item: invocation.item,\n          verdict: invocation.verdict,\n        },\n        cwd,\n      );\n\n      return {\n        json: { ok: true, ...result },\n        lines: [\n          `Wrote ${result.message.file}`,\n          ...(result.item ? [`Moved ${formatBoardItemLine(result.item)}`] : []),\n        ],\n        exitCode: 0,\n      };\n    }\n\n    case \"watch\": {\n      const result = await watchBoard(\n        { agent: invocation.agent, timeoutMs: invocation.timeoutMs, since: invocation.since },\n        cwd,\n      );\n\n      return {\n        json: { ok: true, timedOut: false, ...result },\n        lines: result.messages.flatMap(formatMessage),\n        exitCode: 0,\n      };\n    }\n  }\n}\n\n/**\n * Action behind `warlock board <action> [args...]`.\n *\n * With `--json`, stdout carries exactly one JSON object — `{ ok: true, … }`, or\n * `{ ok: false, code, message }` for a coded failure (`timedOut: true` for a\n * watch timeout). Exit codes: 0 done, 1 refused or invalid, 3 watch timed out.\n *\n * @param data Parsed CLI args: the action and its positionals, and the flags.\n */\nexport async function boardCommandAction({ args, options }: CommandActionData): Promise<void> {\n  const json = options.json === true;\n\n  try {\n    const outcome = await runBoardInvocation(parseBoardInvocation(args, options));\n\n    if (json) {\n      console.log(JSON.stringify(outcome.json, null, 2));\n    } else {\n      for (const line of outcome.lines) console.log(line);\n    }\n\n    if (outcome.exitCode !== 0) await flushAndExit(outcome.exitCode);\n  } catch (error) {\n    const timedOut = error instanceof WarlockError && error.code === \"WL7404\";\n    const exitCode = timedOut ? BOARD_WATCH_TIMEOUT_EXIT_CODE : 1;\n\n    if (!json && !timedOut) throw error;\n\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (json) {\n      console.log(\n        JSON.stringify(\n          {\n            ok: false,\n            code: error instanceof WarlockError ? error.code : null,\n            message,\n            ...(timedOut ? { timedOut: true } : {}),\n          },\n          null,\n          2,\n        ),\n      );\n    } else {\n      console.error(message);\n    }\n\n    await flushAndExit(exitCode);\n  }\n}\n"],"mappings":"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"}

package/esm/cli/commands/board.command.mjs

@@ -0,0 +1,78 @@
+import { command } from "../../commands/cli-command.mjs";
+import { boardCommandAction } from "./board/board-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/board.command.ts
+/**
+* `warlock board <action>` — the agent board: work items and append-only
+* messages two coding agents (an implementer and a reviewer) share in the
+* git-ignored `.warlock/board/` folder.
+*
+* Actions: `init`, `add <title>`, `status [id] [state]`, `send <agent>
+* <subject>`, `watch <agent>`. No preload: it reads and writes files only.
+*/
+const boardCommand = command({
+	name: "board <action> [args...]",
+	description: "Agent board: init | add <title> | status [id] [state] | send <agent> <subject> | watch <agent> (items and messages in .warlock/board/)",
+	action: boardCommandAction,
+	options: [
+		{
+			text: "--json, -j",
+			description: "Print one JSON object (stdout carries only the JSON)",
+			type: "boolean"
+		},
+		{
+			text: "--assignee",
+			description: "add: the agent doing the work",
+			type: "string"
+		},
+		{
+			text: "--reviewer",
+			description: "add: the agent reviewing it",
+			type: "string"
+		},
+		{
+			text: "--by",
+			description: "add, status: the agent making the change (default: WARLOCK_AGENT)",
+			type: "string"
+		},
+		{
+			text: "--note",
+			description: "status <id> <state>: why the item moved",
+			type: "string"
+		},
+		{
+			text: "--from",
+			description: "send: the sending agent (default: WARLOCK_AGENT)",
+			type: "string"
+		},
+		{
+			text: "--item",
+			description: "send: the item id the message is about",
+			type: "string"
+		},
+		{
+			text: "--body",
+			description: "send: the message body, or @file to read it from a file",
+			type: "string"
+		},
+		{
+			text: "--verdict",
+			description: "send: approved | changes-requested (also moves --item to that state)",
+			type: "string"
+		},
+		{
+			text: "--timeout",
+			description: "watch: seconds to wait before giving up with exit code 3 (default 600)",
+			type: "string"
+		},
+		{
+			text: "--since",
+			description: "watch: return messages numbered above N (default: the agent's cursor)",
+			type: "string"
+		}
+	]
+});
+
+//#endregion
+export { boardCommand };
+//# sourceMappingURL=board.command.mjs.map

package/esm/cli/commands/board.command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/board.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { boardCommandAction } from \"./board/board-command.action\";\n\n/**\n * `warlock board <action>` — the agent board: work items and append-only\n * messages two coding agents (an implementer and a reviewer) share in the\n * git-ignored `.warlock/board/` folder.\n *\n * Actions: `init`, `add <title>`, `status [id] [state]`, `send <agent>\n * <subject>`, `watch <agent>`. No preload: it reads and writes files only.\n */\nexport const boardCommand = command({\n  name: \"board <action> [args...]\",\n  description:\n    \"Agent board: init | add <title> | status [id] [state] | send <agent> <subject> | watch <agent> (items and messages in .warlock/board/)\",\n  action: boardCommandAction,\n  options: [\n    {\n      text: \"--json, -j\",\n      description: \"Print one JSON object (stdout carries only the JSON)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--assignee\",\n      description: \"add: the agent doing the work\",\n      type: \"string\",\n    },\n    {\n      text: \"--reviewer\",\n      description: \"add: the agent reviewing it\",\n      type: \"string\",\n    },\n    {\n      text: \"--by\",\n      description: \"add, status: the agent making the change (default: WARLOCK_AGENT)\",\n      type: \"string\",\n    },\n    {\n      text: \"--note\",\n      description: \"status <id> <state>: why the item moved\",\n      type: \"string\",\n    },\n    {\n      text: \"--from\",\n      description: \"send: the sending agent (default: WARLOCK_AGENT)\",\n      type: \"string\",\n    },\n    {\n      text: \"--item\",\n      description: \"send: the item id the message is about\",\n      type: \"string\",\n    },\n    {\n      text: \"--body\",\n      description: \"send: the message body, or @file to read it from a file\",\n      type: \"string\",\n    },\n    {\n      text: \"--verdict\",\n      description: \"send: approved | changes-requested (also moves --item to that state)\",\n      type: \"string\",\n    },\n    {\n      text: \"--timeout\",\n      description: \"watch: seconds to wait before giving up with exit code 3 (default 600)\",\n      type: \"string\",\n    },\n    {\n      text: \"--since\",\n      description: \"watch: return messages numbered above N (default: the agent's cursor)\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/build.command.mjs

@@ -1,3 +1,4 @@
+import { unverifiedBuildRuntimeNotice } from "../../utils/runtime.mjs";
 import { command } from "../../commands/cli-command.mjs";
 import { buildAppProduction } from "../../production/build-app-production.mjs";
 
@@ -6,7 +7,11 @@ const buildCommand = command({
 	name: "build",
 	description: "Build the project for production",
 	action: buildAppProduction,
-	preload: { warlockConfig: true }
+	preload: { warlockConfig: true },
+	preAction: () => {
+		const notice = unverifiedBuildRuntimeNotice();
+		if (notice !== void 0) console.error(notice);
+	}
 });
 
 //#endregion

package/esm/cli/commands/build.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/build.command.ts"],"sourcesContent":["import { buildAppProduction } from \"../../production/build-app-production\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const buildCommand = command({\n  name: \"build\",\n  description: \"Build the project for production\",\n  action: buildAppProduction,\n  preload: {\n    warlockConfig: true,\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;AACF,CAAC"}
+{"version":3,"file":"build.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/build.command.ts"],"sourcesContent":["import { buildAppProduction } from \"../../production/build-app-production\";\nimport { command } from \"../../commands/cli-command\";\nimport { unverifiedBuildRuntimeNotice } from \"../../utils/runtime\";\n\nexport const buildCommand = command({\n  name: \"build\",\n  description: \"Build the project for production\",\n  action: buildAppProduction,\n  preload: {\n    warlockConfig: true,\n  },\n  preAction: () => {\n    // Bun and Deno can usually run the build, but only the Node build is\n    // verified; say so on stderr without failing the command.\n    const notice = unverifiedBuildRuntimeNotice();\n\n    if (notice !== undefined) {\n      console.error(notice);\n    }\n  },\n});\n"],"mappings":";;;;;AAIA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;CACA,iBAAiB;EAGf,MAAM,SAAS,6BAA6B;EAE5C,IAAI,WAAW,QACb,QAAQ,MAAM,MAAM;CAExB;AACF,CAAC"}

package/esm/cli/commands/check/check-command.action.mjs

@@ -0,0 +1,57 @@
+import { flushAndExit } from "../../flush-and-exit.mjs";
+import { CHECK_STEPS } from "../../../tooling/check/check-report.types.mjs";
+import { runCheck } from "../../../tooling/check/run-check.mjs";
+import { childTypecheckRunner } from "./child-typecheck.mjs";
+import { formatCheckSummary, printProblems } from "./format-problems.mjs";
+
+//#region ../../packages/core/src/cli/commands/check/check-command.action.ts
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function isStepName(value) {
+	return CHECK_STEPS.includes(value);
+}
+/** Parse `--skip typecheck,lint`; throws on an unknown step name. */
+function parseSkippedSteps(value) {
+	if (!value) return [];
+	const names = value.split(",").map((name) => name.trim()).filter((name) => name.length > 0);
+	const unknown = names.filter((name) => !isStepName(name));
+	if (unknown.length > 0) throw new Error(`Unknown check step(s): ${unknown.join(", ")}. Valid steps: ${CHECK_STEPS.join(", ")}.`);
+	return names.filter(isStepName);
+}
+/**
+* Action behind `warlock check`.
+*
+* Runs {@link runCheck} with the typecheck in a child `warlock typecheck`
+* process (so a heap overflow is reported, not fatal), prints the problems and
+* the step summary — or, with `--json`, exactly the report — and exits with
+* the report's code: 0 clean, 1 your code, 2 this machine.
+*
+* @param data Parsed CLI args: `changed`, `base`, `skip`, `project`, `json`.
+*/
+async function checkCommandAction({ options }) {
+	const base = stringOption(options.base);
+	const changed = options.changed === true || base !== void 0;
+	const project = stringOption(options.project);
+	const skip = parseSkippedSteps(stringOption(options.skip));
+	const cliEntry = process.argv[1];
+	const flags = [...changed ? ["--changed"] : [], ...base ? ["--base", base] : []];
+	const report = await runCheck({
+		changed,
+		base,
+		skip,
+		project,
+		...cliEntry ? { typecheck: childTypecheckRunner(cliEntry, flags) } : {}
+	});
+	if (options.json === true) console.log(JSON.stringify(report, null, 2));
+	else {
+		printProblems(report.problems);
+		if (report.problems.length > 0) console.log("");
+		for (const line of formatCheckSummary(report)) console.log(line);
+	}
+	if (report.exitCode !== 0) await flushAndExit(report.exitCode);
+}
+
+//#endregion
+export { checkCommandAction };
+//# sourceMappingURL=check-command.action.mjs.map

package/esm/cli/commands/check/check-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/check/check-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { CHECK_STEPS, type CheckStepName } from \"../../../tooling/check/check-report.types\";\nimport { runCheck } from \"../../../tooling/check/run-check\";\nimport { flushAndExit } from \"../../flush-and-exit\";\nimport { childTypecheckRunner } from \"./child-typecheck\";\nimport { formatCheckSummary, printProblems } from \"./format-problems\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction isStepName(value: string): value is CheckStepName {\n  return (CHECK_STEPS as readonly string[]).includes(value);\n}\n\n/** Parse `--skip typecheck,lint`; throws on an unknown step name. */\nexport function parseSkippedSteps(value: string | undefined): CheckStepName[] {\n  if (!value) return [];\n\n  const names = value\n    .split(\",\")\n    .map((name) => name.trim())\n    .filter((name) => name.length > 0);\n  const unknown = names.filter((name) => !isStepName(name));\n\n  if (unknown.length > 0) {\n    throw new Error(\n      `Unknown check step(s): ${unknown.join(\", \")}. Valid steps: ${CHECK_STEPS.join(\", \")}.`,\n    );\n  }\n\n  return names.filter(isStepName);\n}\n\n/**\n * Action behind `warlock check`.\n *\n * Runs {@link runCheck} with the typecheck in a child `warlock typecheck`\n * process (so a heap overflow is reported, not fatal), prints the problems and\n * the step summary — or, with `--json`, exactly the report — and exits with\n * the report's code: 0 clean, 1 your code, 2 this machine.\n *\n * @param data Parsed CLI args: `changed`, `base`, `skip`, `project`, `json`.\n */\nexport async function checkCommandAction({ options }: CommandActionData): Promise<void> {\n  const base = stringOption(options.base);\n  const changed = options.changed === true || base !== undefined;\n  const project = stringOption(options.project);\n  const skip = parseSkippedSteps(stringOption(options.skip));\n  const cliEntry = process.argv[1];\n  const flags = [...(changed ? [\"--changed\"] : []), ...(base ? [\"--base\", base] : [])];\n\n  const report = await runCheck({\n    changed,\n    base,\n    skip,\n    project,\n    ...(cliEntry ? { typecheck: childTypecheckRunner(cliEntry, flags) } : {}),\n  });\n\n  if (options.json === true) {\n    console.log(JSON.stringify(report, null, 2));\n  } else {\n    printProblems(report.problems);\n\n    if (report.problems.length > 0) console.log(\"\");\n\n    for (const line of formatCheckSummary(report)) {\n      console.log(line);\n    }\n  }\n\n  if (report.exitCode !== 0) {\n    await flushAndExit(report.exitCode);\n  }\n}\n"],"mappings":";;;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;AAEA,SAAS,WAAW,OAAuC;CACzD,OAAQ,YAAkC,SAAS,KAAK;AAC1D;;AAGA,SAAgB,kBAAkB,OAA4C;CAC5E,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,MAAM,QAAQ,MACX,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,CAAC;CACnC,MAAM,UAAU,MAAM,QAAQ,SAAS,CAAC,WAAW,IAAI,CAAC;CAExD,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MACR,0BAA0B,QAAQ,KAAK,IAAI,EAAE,iBAAiB,YAAY,KAAK,IAAI,EAAE,EACvF;CAGF,OAAO,MAAM,OAAO,UAAU;AAChC;;;;;;;;;;;AAYA,eAAsB,mBAAmB,EAAE,WAA6C;CACtF,MAAM,OAAO,aAAa,QAAQ,IAAI;CACtC,MAAM,UAAU,QAAQ,YAAY,QAAQ,SAAS;CACrD,MAAM,UAAU,aAAa,QAAQ,OAAO;CAC5C,MAAM,OAAO,kBAAkB,aAAa,QAAQ,IAAI,CAAC;CACzD,MAAM,WAAW,QAAQ,KAAK;CAC9B,MAAM,QAAQ,CAAC,GAAI,UAAU,CAAC,WAAW,IAAI,CAAC,GAAI,GAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAE;CAEnF,MAAM,SAAS,MAAM,SAAS;EAC5B;EACA;EACA;EACA;EACA,GAAI,WAAW,EAAE,WAAW,qBAAqB,UAAU,KAAK,EAAE,IAAI,CAAC;CACzE,CAAC;CAED,IAAI,QAAQ,SAAS,MACnB,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;MACtC;EACL,cAAc,OAAO,QAAQ;EAE7B,IAAI,OAAO,SAAS,SAAS,GAAG,QAAQ,IAAI,EAAE;EAE9C,KAAK,MAAM,QAAQ,mBAAmB,MAAM,GAC1C,QAAQ,IAAI,IAAI;CAEpB;CAEA,IAAI,OAAO,aAAa,GACtB,MAAM,aAAa,OAAO,QAAQ;AAEtC"}

package/esm/cli/commands/check/child-typecheck.mjs

@@ -0,0 +1,66 @@
+import { createProblem } from "../../../tooling/problem.mjs";
+import { execFile } from "node:child_process";
+
+//#region ../../packages/core/src/cli/commands/check/child-typecheck.ts
+function isTypecheckResult(value) {
+	return typeof value === "object" && value !== null && Array.isArray(Reflect.get(value, "problems")) && typeof Reflect.get(value, "checkedFiles") === "number";
+}
+/**
+* Run the typecheck step as `warlock typecheck --json` in a child process.
+*
+* The compiler is the one step that can exhaust the heap on a large app. In
+* its own process an overflow ends only that process, and `warlock check`
+* still prints its report — with a `WL8007` environment problem instead of
+* dying without output.
+*
+* @param cliEntry The warlock CLI script (`process.argv[1]` of `warlock check`).
+* @param flags The `--changed` / `--base` flags of the parent run, so the child
+*   lists the same changed files.
+*/
+function childTypecheckRunner(cliEntry, flags) {
+	return (options) => new Promise((resolve) => {
+		const args = [
+			cliEntry,
+			"typecheck",
+			"--json",
+			...flags
+		];
+		if (options.project) args.push("--project", options.project);
+		execFile(process.execPath, args, {
+			cwd: options.cwd ?? process.cwd(),
+			encoding: "utf8",
+			windowsHide: true,
+			maxBuffer: 64 * 1024 * 1024
+		}, (error, stdout, stderr) => {
+			let parsed;
+			try {
+				parsed = JSON.parse(stdout);
+			} catch {
+				parsed = void 0;
+			}
+			if (isTypecheckResult(parsed)) {
+				resolve(parsed);
+				return;
+			}
+			const outOfMemory = /heap out of memory|ERR_WORKER_OUT_OF_MEMORY/i.test(stderr);
+			const how = error?.signal ? `was killed (${error.signal})` : `exited with ${String(error?.code ?? 0)}`;
+			resolve({
+				ok: false,
+				mode: options.files ? "files" : "program",
+				files: null,
+				checkedFiles: 0,
+				durationMs: 0,
+				buildInfoFile: null,
+				problems: [createProblem({
+					code: "WL8007",
+					source: "environment",
+					message: `The typecheck ${outOfMemory ? "ran out of memory" : how}: ${stderr.trim().split("\n").slice(-3).join(" ") || "no output"}`
+				})]
+			});
+		});
+	});
+}
+
+//#endregion
+export { childTypecheckRunner };
+//# sourceMappingURL=child-typecheck.mjs.map

package/esm/cli/commands/check/child-typecheck.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-typecheck.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/check/child-typecheck.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport type { TypecheckRunner } from \"../../../tooling/check/run-check\";\nimport { createProblem } from \"../../../tooling/problem\";\nimport type { TypecheckResult } from \"../../../tooling/typecheck/run-typecheck\";\n\nfunction isTypecheckResult(value: unknown): value is TypecheckResult {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    Array.isArray(Reflect.get(value, \"problems\")) &&\n    typeof Reflect.get(value, \"checkedFiles\") === \"number\"\n  );\n}\n\n/**\n * Run the typecheck step as `warlock typecheck --json` in a child process.\n *\n * The compiler is the one step that can exhaust the heap on a large app. In\n * its own process an overflow ends only that process, and `warlock check`\n * still prints its report — with a `WL8007` environment problem instead of\n * dying without output.\n *\n * @param cliEntry The warlock CLI script (`process.argv[1]` of `warlock check`).\n * @param flags The `--changed` / `--base` flags of the parent run, so the child\n *   lists the same changed files.\n */\nexport function childTypecheckRunner(cliEntry: string, flags: readonly string[]): TypecheckRunner {\n  return (options) =>\n    new Promise((resolve) => {\n      const args = [cliEntry, \"typecheck\", \"--json\", ...flags];\n\n      if (options.project) args.push(\"--project\", options.project);\n\n      execFile(\n        process.execPath,\n        args,\n        {\n          cwd: options.cwd ?? process.cwd(),\n          encoding: \"utf8\",\n          windowsHide: true,\n          maxBuffer: 64 * 1024 * 1024,\n        },\n        (error, stdout, stderr) => {\n          let parsed: unknown;\n\n          try {\n            parsed = JSON.parse(stdout);\n          } catch {\n            parsed = undefined;\n          }\n\n          if (isTypecheckResult(parsed)) {\n            resolve(parsed);\n            return;\n          }\n\n          const outOfMemory = /heap out of memory|ERR_WORKER_OUT_OF_MEMORY/i.test(stderr);\n          const how = error?.signal\n            ? `was killed (${error.signal})`\n            : `exited with ${String(error?.code ?? 0)}`;\n\n          resolve({\n            ok: false,\n            mode: options.files ? \"files\" : \"program\",\n            files: null,\n            checkedFiles: 0,\n            durationMs: 0,\n            buildInfoFile: null,\n            problems: [\n              createProblem({\n                code: \"WL8007\",\n                source: \"environment\",\n                message: `The typecheck ${outOfMemory ? \"ran out of memory\" : how}: ${stderr.trim().split(\"\\n\").slice(-3).join(\" \") || \"no output\"}`,\n              }),\n            ],\n          });\n        },\n      );\n    });\n}\n"],"mappings":";;;;AAKA,SAAS,kBAAkB,OAA0C;CACnE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAQ,QAAQ,IAAI,OAAO,UAAU,CAAC,KAC5C,OAAO,QAAQ,IAAI,OAAO,cAAc,MAAM;AAElD;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,UAAkB,OAA2C;CAChG,QAAQ,YACN,IAAI,SAAS,YAAY;EACvB,MAAM,OAAO;GAAC;GAAU;GAAa;GAAU,GAAG;EAAK;EAEvD,IAAI,QAAQ,SAAS,KAAK,KAAK,aAAa,QAAQ,OAAO;EAE3D,SACE,QAAQ,UACR,MACA;GACE,KAAK,QAAQ,OAAO,QAAQ,IAAI;GAChC,UAAU;GACV,aAAa;GACb,WAAW,KAAK,OAAO;EACzB,IACC,OAAO,QAAQ,WAAW;GACzB,IAAI;GAEJ,IAAI;IACF,SAAS,KAAK,MAAM,MAAM;GAC5B,QAAQ;IACN,SAAS;GACX;GAEA,IAAI,kBAAkB,MAAM,GAAG;IAC7B,QAAQ,MAAM;IACd;GACF;GAEA,MAAM,cAAc,+CAA+C,KAAK,MAAM;GAC9E,MAAM,MAAM,OAAO,SACf,eAAe,MAAM,OAAO,KAC5B,eAAe,OAAO,OAAO,QAAQ,CAAC;GAE1C,QAAQ;IACN,IAAI;IACJ,MAAM,QAAQ,QAAQ,UAAU;IAChC,OAAO;IACP,cAAc;IACd,YAAY;IACZ,eAAe;IACf,UAAU,CACR,cAAc;KACZ,MAAM;KACN,QAAQ;KACR,SAAS,iBAAiB,cAAc,sBAAsB,IAAI,IAAI,OAAO,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG,KAAK;IACzH,CAAC,CACH;GACF,CAAC;EACH,CACF;CACF,CAAC;AACL"}

package/esm/cli/commands/check/format-problems.mjs

@@ -0,0 +1,43 @@
+import { colors } from "@mongez/copper";
+
+//#region ../../packages/core/src/cli/commands/check/format-problems.ts
+/** `file:line:col`, as much of it as the problem has. */
+function locationOf(problem) {
+	if (!problem.file) return "(project)";
+	if (problem.line === null) return problem.file;
+	return `${problem.file}:${problem.line}${problem.column === null ? "" : `:${problem.column}`}`;
+}
+/**
+* Two lines per problem: `file:line:col  CODE  message (rule)`, then the fix
+* hint. Uncolored, so it is testable; {@link printProblems} adds color.
+*/
+function formatProblemLines(problems) {
+	return problems.flatMap((problem) => [`${locationOf(problem)}  ${problem.code}  ${problem.message.split("\n")[0]}${problem.rule ? ` (${problem.rule})` : ""}`, `  → ${problem.hint}`]);
+}
+/** Print problems to stdout, errors in red and warnings in yellow. */
+function printProblems(problems) {
+	for (const problem of problems) {
+		const paint = problem.severity === "error" ? colors.red : colors.yellow;
+		const [first, second] = formatProblemLines([problem]);
+		console.log(paint(first ?? ""));
+		console.log(colors.dim(second ?? ""));
+	}
+}
+const STEP_SYMBOL = {
+	passed: "✓",
+	failed: "✗",
+	skipped: "-",
+	blocked: "!"
+};
+/** The step list and the verdict line of a check report, uncolored. */
+function formatCheckSummary(report) {
+	const lines = report.steps.map((step) => `${STEP_SYMBOL[step.status]} ${step.name.padEnd(12)} ${step.status}${step.detail ? ` — ${step.detail}` : ""}`);
+	const { errors, warnings, environment } = report.summary;
+	lines.push("");
+	lines.push(report.exitCode === 0 ? `OK: ${warnings} warning(s)` : report.exitCode === 2 ? `${errors} error(s), ${environment} from this machine — fix the environment first (exit 2)` : `${errors} error(s) in the code (exit 1)`);
+	return lines;
+}
+
+//#endregion
+export { formatCheckSummary, printProblems };
+//# sourceMappingURL=format-problems.mjs.map

package/esm/cli/commands/check/format-problems.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-problems.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/check/format-problems.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CheckReport } from \"../../../tooling/check/check-report.types\";\nimport type { ToolingProblem } from \"../../../tooling/problem\";\n\n/** `file:line:col`, as much of it as the problem has. */\nfunction locationOf(problem: ToolingProblem): string {\n  if (!problem.file) return \"(project)\";\n  if (problem.line === null) return problem.file;\n\n  return `${problem.file}:${problem.line}${problem.column === null ? \"\" : `:${problem.column}`}`;\n}\n\n/**\n * Two lines per problem: `file:line:col  CODE  message (rule)`, then the fix\n * hint. Uncolored, so it is testable; {@link printProblems} adds color.\n */\nexport function formatProblemLines(problems: readonly ToolingProblem[]): string[] {\n  return problems.flatMap((problem) => [\n    `${locationOf(problem)}  ${problem.code}  ${problem.message.split(\"\\n\")[0]}${problem.rule ? ` (${problem.rule})` : \"\"}`,\n    `  → ${problem.hint}`,\n  ]);\n}\n\n/** Print problems to stdout, errors in red and warnings in yellow. */\nexport function printProblems(problems: readonly ToolingProblem[]): void {\n  for (const problem of problems) {\n    const paint = problem.severity === \"error\" ? colors.red : colors.yellow;\n    const [first, second] = formatProblemLines([problem]);\n\n    console.log(paint(first ?? \"\"));\n    console.log(colors.dim(second ?? \"\"));\n  }\n}\n\nconst STEP_SYMBOL: Record<CheckReport[\"steps\"][number][\"status\"], string> = {\n  passed: \"✓\",\n  failed: \"✗\",\n  skipped: \"-\",\n  blocked: \"!\",\n};\n\n/** The step list and the verdict line of a check report, uncolored. */\nexport function formatCheckSummary(report: CheckReport): string[] {\n  const lines = report.steps.map(\n    (step) =>\n      `${STEP_SYMBOL[step.status]} ${step.name.padEnd(12)} ${step.status}${step.detail ? ` — ${step.detail}` : \"\"}`,\n  );\n  const { errors, warnings, environment } = report.summary;\n\n  lines.push(\"\");\n  lines.push(\n    report.exitCode === 0\n      ? `OK: ${warnings} warning(s)`\n      : report.exitCode === 2\n        ? `${errors} error(s), ${environment} from this machine — fix the environment first (exit 2)`\n        : `${errors} error(s) in the code (exit 1)`,\n  );\n\n  return lines;\n}\n"],"mappings":";;;;AAKA,SAAS,WAAW,SAAiC;CACnD,IAAI,CAAC,QAAQ,MAAM,OAAO;CAC1B,IAAI,QAAQ,SAAS,MAAM,OAAO,QAAQ;CAE1C,OAAO,GAAG,QAAQ,KAAK,GAAG,QAAQ,OAAO,QAAQ,WAAW,OAAO,KAAK,IAAI,QAAQ;AACtF;;;;;AAMA,SAAgB,mBAAmB,UAA+C;CAChF,OAAO,SAAS,SAAS,YAAY,CACnC,GAAG,WAAW,OAAO,EAAE,IAAI,QAAQ,KAAK,IAAI,QAAQ,QAAQ,MAAM,IAAI,CAAC,CAAC,KAAK,QAAQ,OAAO,KAAK,QAAQ,KAAK,KAAK,MACnH,OAAO,QAAQ,MACjB,CAAC;AACH;;AAGA,SAAgB,cAAc,UAA2C;CACvE,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,QAAQ,QAAQ,aAAa,UAAU,OAAO,MAAM,OAAO;EACjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,OAAO,CAAC;EAEpD,QAAQ,IAAI,MAAM,SAAS,EAAE,CAAC;EAC9B,QAAQ,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;CACtC;AACF;AAEA,MAAM,cAAsE;CAC1E,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,SAAS;AACX;;AAGA,SAAgB,mBAAmB,QAA+B;CAChE,MAAM,QAAQ,OAAO,MAAM,KACxB,SACC,GAAG,YAAY,KAAK,QAAQ,GAAG,KAAK,KAAK,OAAO,EAAE,EAAE,GAAG,KAAK,SAAS,KAAK,SAAS,MAAM,KAAK,WAAW,IAC7G;CACA,MAAM,EAAE,QAAQ,UAAU,gBAAgB,OAAO;CAEjD,MAAM,KAAK,EAAE;CACb,MAAM,KACJ,OAAO,aAAa,IAChB,OAAO,SAAS,eAChB,OAAO,aAAa,IAClB,GAAG,OAAO,aAAa,YAAY,2DACnC,GAAG,OAAO,+BAClB;CAEA,OAAO;AACT"}

package/esm/cli/commands/check/typecheck-command.action.mjs

@@ -0,0 +1,61 @@
+import { flushAndExit } from "../../flush-and-exit.mjs";
+import { checkExitCode } from "../../../tooling/check/check-report.types.mjs";
+import { runTypecheck } from "../../../tooling/typecheck/run-typecheck.mjs";
+import { listChangedFiles } from "../../../tooling/check/changed-files.mjs";
+import { printProblems } from "./format-problems.mjs";
+
+//#region ../../packages/core/src/cli/commands/check/typecheck-command.action.ts
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* Action behind `warlock typecheck`.
+*
+* Typechecks incrementally (state in `.warlock/cache/typecheck.tsbuildinfo`).
+* `--changed` limits diagnostics to the files changed against HEAD (or the
+* merge base with `--base`) and the files importing them. `--json` prints the
+* result alone. Exit codes match `warlock check`: 0 clean, 1 type errors,
+* 2 this machine (git unavailable for `--changed`).
+*
+* @param data Parsed CLI args: `changed`, `base`, `project`, `json`.
+*/
+async function typecheckCommandAction({ options }) {
+	const cwd = process.cwd();
+	const base = stringOption(options.base);
+	const changed = options.changed === true || base !== void 0;
+	const project = stringOption(options.project);
+	let result;
+	if (changed) {
+		const listed = await listChangedFiles({
+			cwd,
+			base
+		});
+		result = "problem" in listed ? {
+			ok: false,
+			mode: "files",
+			files: null,
+			checkedFiles: 0,
+			durationMs: 0,
+			buildInfoFile: null,
+			problems: [listed.problem]
+		} : runTypecheck({
+			cwd,
+			project,
+			files: listed.files
+		});
+	} else result = runTypecheck({
+		cwd,
+		project
+	});
+	const exitCode = checkExitCode(result.problems);
+	if (options.json === true) console.log(JSON.stringify(result, null, 2));
+	else {
+		printProblems(result.problems);
+		console.log(`${result.problems.length === 0 ? "No type errors" : `${result.problems.length} problem(s)`} in ${result.checkedFiles} file(s) (${result.durationMs}ms)`);
+	}
+	if (exitCode !== 0) await flushAndExit(exitCode);
+}
+
+//#endregion
+export { typecheckCommandAction };
+//# sourceMappingURL=typecheck-command.action.mjs.map

package/esm/cli/commands/check/typecheck-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/check/typecheck-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { listChangedFiles } from \"../../../tooling/check/changed-files\";\nimport { checkExitCode } from \"../../../tooling/check/check-report.types\";\nimport { runTypecheck, type TypecheckResult } from \"../../../tooling/typecheck/run-typecheck\";\nimport { flushAndExit } from \"../../flush-and-exit\";\nimport { printProblems } from \"./format-problems\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock typecheck`.\n *\n * Typechecks incrementally (state in `.warlock/cache/typecheck.tsbuildinfo`).\n * `--changed` limits diagnostics to the files changed against HEAD (or the\n * merge base with `--base`) and the files importing them. `--json` prints the\n * result alone. Exit codes match `warlock check`: 0 clean, 1 type errors,\n * 2 this machine (git unavailable for `--changed`).\n *\n * @param data Parsed CLI args: `changed`, `base`, `project`, `json`.\n */\nexport async function typecheckCommandAction({ options }: CommandActionData): Promise<void> {\n  const cwd = process.cwd();\n  const base = stringOption(options.base);\n  const changed = options.changed === true || base !== undefined;\n  const project = stringOption(options.project);\n  let result: TypecheckResult;\n\n  if (changed) {\n    const listed = await listChangedFiles({ cwd, base });\n\n    result =\n      \"problem\" in listed\n        ? {\n            ok: false,\n            mode: \"files\",\n            files: null,\n            checkedFiles: 0,\n            durationMs: 0,\n            buildInfoFile: null,\n            problems: [listed.problem],\n          }\n        : runTypecheck({ cwd, project, files: listed.files });\n  } else {\n    result = runTypecheck({ cwd, project });\n  }\n\n  const exitCode = checkExitCode(result.problems);\n\n  if (options.json === true) {\n    console.log(JSON.stringify(result, null, 2));\n  } else {\n    printProblems(result.problems);\n    console.log(\n      `${result.problems.length === 0 ? \"No type errors\" : `${result.problems.length} problem(s)`} in ${result.checkedFiles} file(s) (${result.durationMs}ms)`,\n    );\n  }\n\n  if (exitCode !== 0) {\n    await flushAndExit(exitCode);\n  }\n}\n"],"mappings":";;;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;AAaA,eAAsB,uBAAuB,EAAE,WAA6C;CAC1F,MAAM,MAAM,QAAQ,IAAI;CACxB,MAAM,OAAO,aAAa,QAAQ,IAAI;CACtC,MAAM,UAAU,QAAQ,YAAY,QAAQ,SAAS;CACrD,MAAM,UAAU,aAAa,QAAQ,OAAO;CAC5C,IAAI;CAEJ,IAAI,SAAS;EACX,MAAM,SAAS,MAAM,iBAAiB;GAAE;GAAK;EAAK,CAAC;EAEnD,SACE,aAAa,SACT;GACE,IAAI;GACJ,MAAM;GACN,OAAO;GACP,cAAc;GACd,YAAY;GACZ,eAAe;GACf,UAAU,CAAC,OAAO,OAAO;EAC3B,IACA,aAAa;GAAE;GAAK;GAAS,OAAO,OAAO;EAAM,CAAC;CAC1D,OACE,SAAS,aAAa;EAAE;EAAK;CAAQ,CAAC;CAGxC,MAAM,WAAW,cAAc,OAAO,QAAQ;CAE9C,IAAI,QAAQ,SAAS,MACnB,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;MACtC;EACL,cAAc,OAAO,QAAQ;EAC7B,QAAQ,IACN,GAAG,OAAO,SAAS,WAAW,IAAI,mBAAmB,GAAG,OAAO,SAAS,OAAO,aAAa,MAAM,OAAO,aAAa,YAAY,OAAO,WAAW,IACtJ;CACF;CAEA,IAAI,aAAa,GACf,MAAM,aAAa,QAAQ;AAE/B"}

package/esm/cli/commands/check.command.mjs

@@ -0,0 +1,50 @@
+import { command } from "../../commands/cli-command.mjs";
+import { checkCommandAction } from "./check/check-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/check.command.ts
+/**
+* `warlock check` — the single verify command: typecheck, lint (the app's
+* ESLint / oxlint config), the tests affected by the change, and framework
+* convention checks, reported as one problem list. Exit 0 clean, 1 problems
+* in the code, 2 problems with this machine.
+*
+* No preload: the steps read files and run tools; nothing boots, connects or
+* binds a port, so `check` behaves the same with or without a database or
+* Redis running.
+*/
+const checkCommand = command({
+	name: "check",
+	description: "Typecheck, lint, run the affected tests and check conventions; one problem list, exit 1 for your code and 2 for this machine",
+	action: checkCommandAction,
+	options: [
+		{
+			text: "--changed, -c",
+			description: "Only the files changed against HEAD (plus untracked files) and what they affect",
+			type: "boolean"
+		},
+		{
+			text: "--base, -b",
+			description: "Compare with the merge base of this ref instead of HEAD (implies --changed)",
+			type: "string"
+		},
+		{
+			text: "--skip, -s",
+			description: "Comma-separated steps to skip: environment, typecheck, lint, tests, conventions",
+			type: "string"
+		},
+		{
+			text: "--project, -p",
+			description: "tsconfig path (default tsconfig.json)",
+			type: "string"
+		},
+		{
+			text: "--json, -j",
+			description: "Print the report as JSON",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { checkCommand };
+//# sourceMappingURL=check.command.mjs.map

package/esm/cli/commands/check.command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/check.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { checkCommandAction } from \"./check/check-command.action\";\n\n/**\n * `warlock check` — the single verify command: typecheck, lint (the app's\n * ESLint / oxlint config), the tests affected by the change, and framework\n * convention checks, reported as one problem list. Exit 0 clean, 1 problems\n * in the code, 2 problems with this machine.\n *\n * No preload: the steps read files and run tools; nothing boots, connects or\n * binds a port, so `check` behaves the same with or without a database or\n * Redis running.\n */\nexport const checkCommand = command({\n  name: \"check\",\n  description:\n    \"Typecheck, lint, run the affected tests and check conventions; one problem list, exit 1 for your code and 2 for this machine\",\n  action: checkCommandAction,\n  options: [\n    {\n      text: \"--changed, -c\",\n      description:\n        \"Only the files changed against HEAD (plus untracked files) and what they affect\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--base, -b\",\n      description: \"Compare with the merge base of this ref instead of HEAD (implies --changed)\",\n      type: \"string\",\n    },\n    {\n      text: \"--skip, -s\",\n      description:\n        \"Comma-separated steps to skip: environment, typecheck, lint, tests, conventions\",\n      type: \"string\",\n    },\n    {\n      text: \"--project, -p\",\n      description: \"tsconfig path (default tsconfig.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Print the report as JSON\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/dev-server.command.mjs

@@ -1,3 +1,4 @@
+import { assertNodeOnlyCommand } from "../../utils/runtime.mjs";
 import { command } from "../../commands/cli-command.mjs";
 import { isDevWorker, superviseDevServer } from "../../dev-server/supervisor.mjs";
 import { displayStartupBanner } from "../cli-commands.utils.mjs";
@@ -19,6 +20,7 @@ const devServerCommand = command({
 		connectors: true
 	},
 	preAction: async () => {
+		assertNodeOnlyCommand("dev");
 		assertEsbuildBinaryIsLinked();
 		if (!isDevWorker()) return superviseDevServer();
 		await displayStartupBanner({ environment: "development" });
@@ -27,7 +29,8 @@ const devServerCommand = command({
 		checkForFrameworkUpdate(await startDevelopmentServer({
 			fresh: Boolean(data.options.fresh),
 			generateTypings: data.options.skipTypings ? false : void 0,
-			healthCheckers: data.options.skipHealth ? false : void 0
+			healthCheckers: data.options.skipHealth ? false : void 0,
+			mcp: data.options.mcp === true ? true : void 0
 		}));
 	},
 	options: [
@@ -45,6 +48,11 @@ const devServerCommand = command({
 			text: "--skip-health, -sh",
 			description: "Skip file health checkers for this run",
 			type: "boolean"
+		},
+		{
+			text: "--mcp",
+			description: "Also serve `warlock mcp` over HTTP on loopback from the dev server (live registries; needs @warlock.js/ai-tools)",
+			type: "boolean"
 		}
 	]
 });

package/esm/cli/commands/dev-server.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\nimport { isDevWorker, superviseDevServer } from \"../../dev-server/supervisor\";\nimport { assertEsbuildBinaryIsLinked } from \"../../production/esbuild-preflight\";\nimport { command } from \"../../commands/cli-command\";\nimport { displayStartupBanner } from \"../cli-commands.utils\";\n\nexport const devServerCommand = command({\n  name: \"dev\",\n  description: \"Start development server (HMR, type-gen, health checks)\",\n  persistent: true,\n  preload: {\n    runtimeStrategy: \"development\",\n    // Overrides whatever NODE_ENV the shell exported. A shell with\n    // NODE_ENV=production made Vite's dep optimiser pre-bundle the PRODUCTION\n    // build of React, which silently suppresses hydration-mismatch warnings —\n    // the dev server was hiding the exact class of bug it exists to surface.\n    // Set here, in preload, because preloaders run before the action, and the\n    // action is what eventually reaches Vite's `createServer`.\n    environment: \"development\",\n    config: true, // load all config\n    bootstrap: true,\n    prestart: true, // load prestart file (if exists)\n    // Only the Early lifecycle phase starts here; the Late phase\n    // (http, socket) starts after app modules load — see\n    // development-server.ts STEP 8.5.\n    connectors: true,\n  },\n  preAction: async () => {\n    // Fail before either role (supervisor or worker) does any other work —\n    // a missing/unlinked esbuild binary would otherwise surface much later\n    // as an opaque low-level error from deep inside the transpile path.\n    assertEsbuildBinaryIsLinked();\n\n    // Two roles share this command. The first `warlock dev` becomes a thin\n    // supervisor that owns the terminal and (re)spawns the real server; the\n    // process it spawns carries WARLOCK_DEV_WORKER and falls through to the\n    // server itself. See supervisor.ts for why the split exists.\n    //\n    // This branch has to sit in `preAction`, which runs BEFORE the command's\n    // preloaders: the supervisor must never load config or start connectors,\n    // or it would hold a second database connection open for the whole\n    // session. `superviseDevServer()` never resolves, so nothing below it —\n    // preload included — runs in the supervisor.\n    if (!isDevWorker()) {\n      return superviseDevServer();\n    }\n\n    await displayStartupBanner({ environment: \"development\" });\n  },\n  action: async (data) => {\n    const devServer = await startDevelopmentServer({\n      fresh: Boolean(data.options.fresh),\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\n      // lets `warlock.config.ts > devServer.*` defaults apply.\n      generateTypings: data.options.skipTypings ? false : undefined,\n      healthCheckers: data.options.skipHealth ? false : undefined,\n    });\n\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\n    // a newer @warlock.js/core has been published, and arm the `u` shortcut\n    // that updates + restarts. Fully self-guarded — it never blocks startup\n    // nor breaks dev if the registry is unreachable.\n    void checkForFrameworkUpdate(devServer);\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--skip-typings, -st\",\n      description: \"Skip background type generation for this run\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--skip-health, -sh\",\n      description: \"Skip file health checkers for this run\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;AAOA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EAOjB,aAAa;EACb,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EAIrB,4BAA4B;EAY5B,IAAI,CAAC,YAAY,GACf,OAAO,mBAAmB;EAG5B,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EAatB,AAAK,wBAAwB,MAZL,uBAAuB;GAC7C,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;EACpD,CAAC,CAMqC;CACxC;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\nimport { isDevWorker, superviseDevServer } from \"../../dev-server/supervisor\";\nimport { assertEsbuildBinaryIsLinked } from \"../../production/esbuild-preflight\";\nimport { command } from \"../../commands/cli-command\";\nimport { assertNodeOnlyCommand } from \"../../utils/runtime\";\nimport { displayStartupBanner } from \"../cli-commands.utils\";\n\nexport const devServerCommand = command({\n  name: \"dev\",\n  description: \"Start development server (HMR, type-gen, health checks)\",\n  persistent: true,\n  preload: {\n    runtimeStrategy: \"development\",\n    // Overrides whatever NODE_ENV the shell exported. A shell with\n    // NODE_ENV=production made Vite's dep optimiser pre-bundle the PRODUCTION\n    // build of React, which silently suppresses hydration-mismatch warnings —\n    // the dev server was hiding the exact class of bug it exists to surface.\n    // Set here, in preload, because preloaders run before the action, and the\n    // action is what eventually reaches Vite's `createServer`.\n    environment: \"development\",\n    config: true, // load all config\n    bootstrap: true,\n    prestart: true, // load prestart file (if exists)\n    // Only the Early lifecycle phase starts here; the Late phase\n    // (http, socket) starts after app modules load — see\n    // development-server.ts STEP 8.5.\n    connectors: true,\n  },\n  preAction: async () => {\n    // Node only. The dev server compiles TypeScript and hot-reloads modules\n    // through Node's module loader hooks; Bun and Deno run the production\n    // build instead. Checked first so neither role starts anything on them.\n    assertNodeOnlyCommand(\"dev\");\n\n    // Fail before either role (supervisor or worker) does any other work —\n    // a missing/unlinked esbuild binary would otherwise surface much later\n    // as an opaque low-level error from deep inside the transpile path.\n    assertEsbuildBinaryIsLinked();\n\n    // Two roles share this command. The first `warlock dev` becomes a thin\n    // supervisor that owns the terminal and (re)spawns the real server; the\n    // process it spawns carries WARLOCK_DEV_WORKER and falls through to the\n    // server itself. See supervisor.ts for why the split exists.\n    //\n    // This branch has to sit in `preAction`, which runs BEFORE the command's\n    // preloaders: the supervisor must never load config or start connectors,\n    // or it would hold a second database connection open for the whole\n    // session. `superviseDevServer()` never resolves, so nothing below it —\n    // preload included — runs in the supervisor.\n    if (!isDevWorker()) {\n      return superviseDevServer();\n    }\n\n    await displayStartupBanner({ environment: \"development\" });\n  },\n  action: async (data) => {\n    const devServer = await startDevelopmentServer({\n      fresh: Boolean(data.options.fresh),\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\n      // lets `warlock.config.ts > devServer.*` defaults apply.\n      generateTypings: data.options.skipTypings ? false : undefined,\n      healthCheckers: data.options.skipHealth ? false : undefined,\n      mcp: data.options.mcp === true ? true : undefined,\n    });\n\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\n    // a newer @warlock.js/core has been published, and arm the `u` shortcut\n    // that updates + restarts. Fully self-guarded — it never blocks startup\n    // nor breaks dev if the registry is unreachable.\n    void checkForFrameworkUpdate(devServer);\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--skip-typings, -st\",\n      description: \"Skip background type generation for this run\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--skip-health, -sh\",\n      description: \"Skip file health checkers for this run\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--mcp\",\n      description:\n        \"Also serve `warlock mcp` over HTTP on loopback from the dev server (live registries; needs @warlock.js/ai-tools)\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;AAQA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EAOjB,aAAa;EACb,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EAIrB,sBAAsB,KAAK;EAK3B,4BAA4B;EAY5B,IAAI,CAAC,YAAY,GACf,OAAO,mBAAmB;EAG5B,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EActB,AAAK,wBAAwB,MAbL,uBAAuB;GAC7C,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;GAClD,KAAK,KAAK,QAAQ,QAAQ,OAAO,OAAO;EAC1C,CAAC,CAMqC;CACxC;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/doctor/boot-for-diagnostics.mjs

@@ -131,12 +131,16 @@ async function loadAppModules() {
 * `DevelopmentServer.autoDiscoverFiles()` exists, and it must keep the same
 * position in the sequence.
 */
-async function discoverModels() {
+async function discoverModels(modules) {
 	const failures = [];
 	for (const file of filesOrchestrator.files.values()) {
 		if (file.type !== "model") continue;
 		try {
-			await filesOrchestrator.moduleLoader.loadModule(file, "model");
+			const exports = await filesOrchestrator.moduleLoader.loadModule(file, "model");
+			if (typeof exports === "object" && exports !== null) modules.push({
+				file: file.relativePath,
+				exports: { ...exports }
+			});
 		} catch (error) {
 			failures.push({
 				file: file.relativePath,
@@ -169,6 +173,7 @@ async function bootForDiagnostics() {
 		appRoutes: 0,
 		totalRoutes: 0,
 		moduleFailures: [],
+		modelModules: [],
 		connectors
 	};
 	try {
@@ -193,7 +198,7 @@ async function bootForDiagnostics() {
 		return !connectorsManager.isBuiltInName(name);
 	});
 	await bootPhase("early", connectors);
-	context.moduleFailures.push(...await discoverModels());
+	context.moduleFailures.push(...await discoverModels(context.modelModules));
 	context.moduleFailures.push(...await loadAppModules());
 	context.appRoutes = router.routeCount();
 	await bootPhase("late", connectors);