@warlock.js/core 5.30.0 → 5.32.0

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: 67108864
+		}, (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;EACb,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, formatProblemLines, 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,16 +20,19 @@ const devServerCommand = command({
 		connectors: true
 	},
 	preAction: async () => {
+		assertNodeOnlyCommand("dev");
 		assertEsbuildBinaryIsLinked();
 		if (!isDevWorker()) return superviseDevServer();
 		await displayStartupBanner({ environment: "development" });
 	},
 	action: async (data) => {
-		checkForFrameworkUpdate(await startDevelopmentServer({
+		const devServer = 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
+		});
+		checkForFrameworkUpdate(devServer);
 	},
 	options: [
 		{
@@ -45,6 +49,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,MAAM,YAAY,MAAM,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;EAMD,AAAK,wBAAwB,SAAS;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);

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

@@ -1 +1 @@
-{"version":3,"file":"boot-for-diagnostics.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/doctor/boot-for-diagnostics.ts"],"sourcesContent":["import { config } from \"../../../config/config-getter\";\nimport { connectorsManager } from \"../../../connectors/connectors-manager\";\nimport { registerConfiguredConnectors } from \"../../../connectors/register-configured-connectors\";\nimport { ConnectorLifecyclePhase } from \"../../../connectors/types\";\nimport { container } from \"../../../container\";\nimport { filesOrchestrator } from \"../../../dev-server/files-orchestrator\";\nimport { ModuleLoadError } from \"../../../dev-server/module-loader\";\nimport { router } from \"../../../router/router\";\nimport type { DoctorBootContext, ModuleFailure } from \"./check.types\";\n\n/**\n * @fileoverview The boot pass `warlock doctor` runs before its checks.\n *\n * THE RULE: **doctor boots, it never starts.**\n *\n * The connector contract already splits the two things doctor needs to keep\n * apart. `boot()` is where a connector REGISTERS — the HTTP connector builds a\n * Fastify instance and adds `/health` + `/ready` to it, the web connector\n * installs one route per page on the app router — and `start()` is where it\n * CONNECTS: opens the database, dials the cache, binds the port. Doctor runs\n * every `boot()` and no `start()`, so it sees the exact surface a served app\n * would have while opening no connection and binding no port.\n *\n * That seam is what makes the checks true. Before it existed here, doctor\n * preloaded config and framework bootstrap only: no app module was ever\n * imported, so no route module ever ran, so `routes` reported `0` on an app\n * `warlock dev` served 14 routes for — while `health` reported the endpoints as\n * \"registered\" from a config flag alone. Two checks, one app, contradictory\n * answers, and the wrong one was the one users acted on.\n *\n * ORDERING mirrors `DevelopmentServer.start()` exactly, because the route\n * surface is order-dependent: early connectors boot, then models (decorator\n * registries the route modules resolve against), then locales/events/mains/\n * routes, then late connectors — which is where `web` turns pages into routes.\n * Get the order wrong and the count is wrong, which is the defect this replaces.\n *\n * NOT read-only in one narrow sense: it imports the app's own modules, so\n * whatever a module does at import time happens. That is unavoidable — routes\n * only exist as the side effect of importing the file that declares them — and\n * it is the same import the dev server performs. It also refreshes\n * `.warlock/manifest.json`, the framework's own file cache. Nothing in the\n * app's data, and no network, is touched.\n */\n\n/**\n * The one connector whose `boot()` can bind a port. See {@link shouldSkipBoot}.\n */\nconst SOCKET_CONNECTOR = \"socket\";\n\n/**\n * Normalize anything thrown into a one-line message.\n */\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Whether doctor must refuse to boot this connector, and why.\n *\n * Exactly one case, and it is not a taste call: `SocketConnector.boot()` shares\n * the HTTP connector's raw server when there is one, and CREATES its own —\n * `server.listen(socketConfig.port)` — when there is not. The HTTP connector\n * boots first (lower priority number), so the shared path is what normally\n * happens; an app that configures `socket` without `http` is the exception, and\n * for that app booting socket would make a diagnostic command open a listening\n * port. Detected by asking the container what HTTP actually left behind rather\n * than by re-deriving the condition from config.\n */\nfunction shouldSkipBoot(name: string): string | undefined {\n  if (name === SOCKET_CONNECTOR && !container.has(\"http.server\")) {\n    return \"no http connector to share a server with — booting it would bind a port\";\n  }\n\n  return undefined;\n}\n\n/**\n * Boot every registered connector in one lifecycle phase, isolating failures.\n *\n * A connector that throws on boot is recorded and the loop continues: one bad\n * connector must not hide the rest of the report, and \"which connector failed\n * to boot\" is itself a finding worth printing.\n */\nasync function bootPhase(\n  phase: ConnectorLifecyclePhase,\n  connectors: DoctorBootContext[\"connectors\"],\n): Promise<void> {\n  for (const connector of connectorsManager.list()) {\n    if (connector.lifecyclePhase !== phase) continue;\n\n    const skipReason = shouldSkipBoot(connector.name);\n\n    if (skipReason) {\n      connectors.skipped.push({ name: connector.name, reason: skipReason });\n      continue;\n    }\n\n    try {\n      await connector.boot();\n      connectors.booted.push(connector.name);\n    } catch (error) {\n      connectors.failures.push({ name: connector.name, message: messageOf(error) });\n    }\n  }\n}\n\n/**\n * Import every app module the dev server imports at boot, collecting failures\n * instead of letting the first one abort the pass.\n *\n * `loadAll()` is deliberately reused rather than reimplemented: it owns the\n * canonical order (locale → event → main → route) and the `withSourceFile`\n * scoping that gives each route its origin file. It aggregates its failures and\n * throws them at the end, which is exactly the shape needed here — every module\n * is attempted, and one broken route file cannot mask another.\n */\nasync function loadAppModules(): Promise<ModuleFailure[]> {\n  try {\n    await filesOrchestrator.moduleLoader.loadAll();\n    return [];\n  } catch (error) {\n    if (error instanceof AggregateError) {\n      return (error.errors as unknown[]).map((failure) => {\n        return failure instanceof ModuleLoadError\n          ? { file: failure.file.relativePath, message: messageOf(failure.cause) }\n          : { file: \"unknown\", message: messageOf(failure) };\n      });\n    }\n\n    return [{ file: \"unknown\", message: messageOf(error) }];\n  }\n}\n\n/**\n * Eagerly import model files so the decorator-driven registries the route\n * modules resolve names against are populated first — the same reason\n * `DevelopmentServer.autoDiscoverFiles()` exists, and it must keep the same\n * position in the sequence.\n */\nasync function discoverModels(): Promise<ModuleFailure[]> {\n  const failures: ModuleFailure[] = [];\n\n  for (const file of filesOrchestrator.files.values()) {\n    if (file.type !== \"model\") continue;\n\n    try {\n      await filesOrchestrator.moduleLoader.loadModule(file, \"model\");\n    } catch (error) {\n      failures.push({\n        file: file.relativePath,\n        message: error instanceof ModuleLoadError ? messageOf(error.cause) : messageOf(error),\n      });\n    }\n  }\n\n  return failures;\n}\n\n/**\n * Run the boot pass and report what it found.\n *\n * Never throws. Every failure mode — a connector array the config manager\n * refuses, a connector that throws on boot, a route module that fails to\n * import — becomes a field on the returned context, which the checks turn into\n * a printed verdict. A diagnostic command that crashes while diagnosing tells\n * the user nothing.\n */\nexport async function bootForDiagnostics(): Promise<DoctorBootContext> {\n  const connectors: DoctorBootContext[\"connectors\"] = {\n    registered: [],\n    configured: [],\n    booted: [],\n    skipped: [],\n    failures: [],\n  };\n\n  const context: DoctorBootContext = {\n    booted: false,\n    routeModules: 0,\n    appRoutes: 0,\n    totalRoutes: 0,\n    moduleFailures: [],\n    connectors,\n  };\n\n  try {\n    // `init()` is idempotent and the preloader already ran it; calling it again\n    // costs nothing and keeps this function honest on its own.\n    await filesOrchestrator.init();\n    await filesOrchestrator.initializeAll();\n\n    filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n    context.routeModules = filesOrchestrator.specialFilesCollector.getFilesByType(\"route\").length;\n  } catch (error) {\n    context.moduleFailures.push({ file: \"src/\", message: messageOf(error) });\n\n    return context;\n  }\n\n  // The app's own connectors (`warlock.config.ts > connectors`) must be\n  // registered before any phase boots, exactly as the dev preloader does it —\n  // otherwise doctor would report on the eleven built-ins alone and miss the\n  // connector the app actually configured. This is also the call that refuses a\n  // duplicate or reserved connector name, so a config that would crash the next\n  // real boot is caught here instead.\n  try {\n    registerConfiguredConnectors();\n  } catch (error) {\n    connectors.registrationError = messageOf(error);\n  }\n\n  connectors.registered = connectorsManager.list().map((connector) => connector.name);\n  connectors.configured = connectors.registered.filter((name) => {\n    return !connectorsManager.isBuiltInName(name);\n  });\n\n  await bootPhase(ConnectorLifecyclePhase.Early, connectors);\n\n  context.moduleFailures.push(...(await discoverModels()));\n  context.moduleFailures.push(...(await loadAppModules()));\n\n  // Snapshot BEFORE the late phase: everything the app's own route modules\n  // registered. The difference between this and the total is what connectors\n  // contributed (pages, for `web`), and reporting the two separately is what\n  // lets a user reconcile doctor's number with the dev server's.\n  context.appRoutes = router.routeCount();\n\n  await bootPhase(ConnectorLifecyclePhase.Late, connectors);\n\n  context.totalRoutes = router.routeCount();\n\n  context.booted = true;\n\n  return context;\n}\n\n/**\n * Whether the app declares an HTTP surface at all. Checks that only make sense\n * for a served app use this to opt out instead of inventing a verdict.\n */\nexport function hasHttpConfig(): boolean {\n  return Boolean(config.get(\"http\"));\n}\n"],"mappings":"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"}
+{"version":3,"file":"boot-for-diagnostics.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/doctor/boot-for-diagnostics.ts"],"sourcesContent":["import { config } from \"../../../config/config-getter\";\nimport { connectorsManager } from \"../../../connectors/connectors-manager\";\nimport { registerConfiguredConnectors } from \"../../../connectors/register-configured-connectors\";\nimport { ConnectorLifecyclePhase } from \"../../../connectors/types\";\nimport { container } from \"../../../container\";\nimport { filesOrchestrator } from \"../../../dev-server/files-orchestrator\";\nimport { ModuleLoadError } from \"../../../dev-server/module-loader\";\nimport { router } from \"../../../router/router\";\nimport type { DoctorBootContext, ModelModule, ModuleFailure } from \"./check.types\";\n\n/**\n * @fileoverview The boot pass `warlock doctor` runs before its checks.\n *\n * THE RULE: **doctor boots, it never starts.**\n *\n * The connector contract already splits the two things doctor needs to keep\n * apart. `boot()` is where a connector REGISTERS — the HTTP connector builds a\n * Fastify instance and adds `/health` + `/ready` to it, the web connector\n * installs one route per page on the app router — and `start()` is where it\n * CONNECTS: opens the database, dials the cache, binds the port. Doctor runs\n * every `boot()` and no `start()`, so it sees the exact surface a served app\n * would have while opening no connection and binding no port.\n *\n * That seam is what makes the checks true. Before it existed here, doctor\n * preloaded config and framework bootstrap only: no app module was ever\n * imported, so no route module ever ran, so `routes` reported `0` on an app\n * `warlock dev` served 14 routes for — while `health` reported the endpoints as\n * \"registered\" from a config flag alone. Two checks, one app, contradictory\n * answers, and the wrong one was the one users acted on.\n *\n * ORDERING mirrors `DevelopmentServer.start()` exactly, because the route\n * surface is order-dependent: early connectors boot, then models (decorator\n * registries the route modules resolve against), then locales/events/mains/\n * routes, then late connectors — which is where `web` turns pages into routes.\n * Get the order wrong and the count is wrong, which is the defect this replaces.\n *\n * NOT read-only in one narrow sense: it imports the app's own modules, so\n * whatever a module does at import time happens. That is unavoidable — routes\n * only exist as the side effect of importing the file that declares them — and\n * it is the same import the dev server performs. It also refreshes\n * `.warlock/manifest.json`, the framework's own file cache. Nothing in the\n * app's data, and no network, is touched.\n */\n\n/**\n * The one connector whose `boot()` can bind a port. See {@link shouldSkipBoot}.\n */\nconst SOCKET_CONNECTOR = \"socket\";\n\n/**\n * Normalize anything thrown into a one-line message.\n */\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Whether doctor must refuse to boot this connector, and why.\n *\n * Exactly one case, and it is not a taste call: `SocketConnector.boot()` shares\n * the HTTP connector's raw server when there is one, and CREATES its own —\n * `server.listen(socketConfig.port)` — when there is not. The HTTP connector\n * boots first (lower priority number), so the shared path is what normally\n * happens; an app that configures `socket` without `http` is the exception, and\n * for that app booting socket would make a diagnostic command open a listening\n * port. Detected by asking the container what HTTP actually left behind rather\n * than by re-deriving the condition from config.\n */\nfunction shouldSkipBoot(name: string): string | undefined {\n  if (name === SOCKET_CONNECTOR && !container.has(\"http.server\")) {\n    return \"no http connector to share a server with — booting it would bind a port\";\n  }\n\n  return undefined;\n}\n\n/**\n * Boot every registered connector in one lifecycle phase, isolating failures.\n *\n * A connector that throws on boot is recorded and the loop continues: one bad\n * connector must not hide the rest of the report, and \"which connector failed\n * to boot\" is itself a finding worth printing.\n */\nasync function bootPhase(\n  phase: ConnectorLifecyclePhase,\n  connectors: DoctorBootContext[\"connectors\"],\n): Promise<void> {\n  for (const connector of connectorsManager.list()) {\n    if (connector.lifecyclePhase !== phase) continue;\n\n    const skipReason = shouldSkipBoot(connector.name);\n\n    if (skipReason) {\n      connectors.skipped.push({ name: connector.name, reason: skipReason });\n      continue;\n    }\n\n    try {\n      await connector.boot();\n      connectors.booted.push(connector.name);\n    } catch (error) {\n      connectors.failures.push({ name: connector.name, message: messageOf(error) });\n    }\n  }\n}\n\n/**\n * Import every app module the dev server imports at boot, collecting failures\n * instead of letting the first one abort the pass.\n *\n * `loadAll()` is deliberately reused rather than reimplemented: it owns the\n * canonical order (locale → event → main → route) and the `withSourceFile`\n * scoping that gives each route its origin file. It aggregates its failures and\n * throws them at the end, which is exactly the shape needed here — every module\n * is attempted, and one broken route file cannot mask another.\n */\nasync function loadAppModules(): Promise<ModuleFailure[]> {\n  try {\n    await filesOrchestrator.moduleLoader.loadAll();\n    return [];\n  } catch (error) {\n    if (error instanceof AggregateError) {\n      return (error.errors as unknown[]).map((failure) => {\n        return failure instanceof ModuleLoadError\n          ? { file: failure.file.relativePath, message: messageOf(failure.cause) }\n          : { file: \"unknown\", message: messageOf(failure) };\n      });\n    }\n\n    return [{ file: \"unknown\", message: messageOf(error) }];\n  }\n}\n\n/**\n * Eagerly import model files so the decorator-driven registries the route\n * modules resolve names against are populated first — the same reason\n * `DevelopmentServer.autoDiscoverFiles()` exists, and it must keep the same\n * position in the sequence.\n */\nasync function discoverModels(modules: ModelModule[]): Promise<ModuleFailure[]> {\n  const failures: ModuleFailure[] = [];\n\n  for (const file of filesOrchestrator.files.values()) {\n    if (file.type !== \"model\") continue;\n\n    try {\n      const exports = await filesOrchestrator.moduleLoader.loadModule<unknown>(file, \"model\");\n\n      if (typeof exports === \"object\" && exports !== null) {\n        modules.push({ file: file.relativePath, exports: { ...exports } });\n      }\n    } catch (error) {\n      failures.push({\n        file: file.relativePath,\n        message: error instanceof ModuleLoadError ? messageOf(error.cause) : messageOf(error),\n      });\n    }\n  }\n\n  return failures;\n}\n\n/**\n * Run the boot pass and report what it found.\n *\n * Never throws. Every failure mode — a connector array the config manager\n * refuses, a connector that throws on boot, a route module that fails to\n * import — becomes a field on the returned context, which the checks turn into\n * a printed verdict. A diagnostic command that crashes while diagnosing tells\n * the user nothing.\n */\nexport async function bootForDiagnostics(): Promise<DoctorBootContext> {\n  const connectors: DoctorBootContext[\"connectors\"] = {\n    registered: [],\n    configured: [],\n    booted: [],\n    skipped: [],\n    failures: [],\n  };\n\n  const context: DoctorBootContext = {\n    booted: false,\n    routeModules: 0,\n    appRoutes: 0,\n    totalRoutes: 0,\n    moduleFailures: [],\n    modelModules: [],\n    connectors,\n  };\n\n  try {\n    // `init()` is idempotent and the preloader already ran it; calling it again\n    // costs nothing and keeps this function honest on its own.\n    await filesOrchestrator.init();\n    await filesOrchestrator.initializeAll();\n\n    filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n    context.routeModules = filesOrchestrator.specialFilesCollector.getFilesByType(\"route\").length;\n  } catch (error) {\n    context.moduleFailures.push({ file: \"src/\", message: messageOf(error) });\n\n    return context;\n  }\n\n  // The app's own connectors (`warlock.config.ts > connectors`) must be\n  // registered before any phase boots, exactly as the dev preloader does it —\n  // otherwise doctor would report on the eleven built-ins alone and miss the\n  // connector the app actually configured. This is also the call that refuses a\n  // duplicate or reserved connector name, so a config that would crash the next\n  // real boot is caught here instead.\n  try {\n    registerConfiguredConnectors();\n  } catch (error) {\n    connectors.registrationError = messageOf(error);\n  }\n\n  connectors.registered = connectorsManager.list().map((connector) => connector.name);\n  connectors.configured = connectors.registered.filter((name) => {\n    return !connectorsManager.isBuiltInName(name);\n  });\n\n  await bootPhase(ConnectorLifecyclePhase.Early, connectors);\n\n  context.moduleFailures.push(...(await discoverModels(context.modelModules)));\n  context.moduleFailures.push(...(await loadAppModules()));\n\n  // Snapshot BEFORE the late phase: everything the app's own route modules\n  // registered. The difference between this and the total is what connectors\n  // contributed (pages, for `web`), and reporting the two separately is what\n  // lets a user reconcile doctor's number with the dev server's.\n  context.appRoutes = router.routeCount();\n\n  await bootPhase(ConnectorLifecyclePhase.Late, connectors);\n\n  context.totalRoutes = router.routeCount();\n\n  context.booted = true;\n\n  return context;\n}\n\n/**\n * Whether the app declares an HTTP surface at all. Checks that only make sense\n * for a served app use this to opt out instead of inventing a verdict.\n */\nexport function hasHttpConfig(): boolean {\n  return Boolean(config.get(\"http\"));\n}\n"],"mappings":"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"}

package/esm/cli/commands/doctor/check.types.d.mts

@@ -0,0 +1,89 @@
+//#region ../../packages/core/src/cli/commands/doctor/check.types.d.ts
+/**
+ * @fileoverview Shared types for the `warlock doctor` diagnostics command.
+ * @description A doctor check is a self-contained probe of one facet of the
+ * application. Each check is handed the {@link DoctorBootContext} produced by
+ * the boot pass (see `boot-for-diagnostics.ts`) and resolves to a
+ * {@link CheckResult} — or to `undefined`, meaning the check does not apply to
+ * this project and must not appear in the report at all. The runner aggregates
+ * the results into a {@link DoctorReport} and derives an exit code. Checks must
+ * never throw out — a thrown check is caught by the runner and recorded as a
+ * `fail` so `doctor` itself can never crash.
+ *
+ * THE STANDARD EVERY CHECK IS HELD TO: a warning that a healthy project
+ * triggers is a bug, not a nuance. Doctor's only asset is being believed, and
+ * every false positive is spent from the same budget the one true finding will
+ * need. If a check cannot say something that is both true and actionable about
+ * a given project, it returns `undefined` and stays silent.
+ */
+/**
+ * A module the boot pass could not import, and why.
+ */
+export type ModuleFailure = {
+  /** Project-relative path of the file that failed. */
+  file: string;
+  /** The underlying error message (the cause, not the wrapper). */
+  message: string;
+};
+/**
+ * A model module the boot pass imported, with its exports — what `warlock
+ * inspect` reads the app's model classes from.
+ */
+export type ModelModule = {
+  /** Project-relative path of the model file. */
+  file: string;
+  /** The module's exports (a shallow copy of its namespace). */
+  exports: Record<string, unknown>;
+};
+/**
+ * What the boot pass observed. Handed to every check so no check has to boot
+ * anything itself — and so the report cannot contain two checks that booted the
+ * app differently and disagreed about it.
+ */
+export type DoctorBootContext = {
+  /**
+   * Whether the pass completed. `false` means app discovery itself failed and
+   * every app-dependent check must say so rather than report a zero.
+   */
+  booted: boolean;
+  /** Number of `src/app/<module>/routes.ts` files found on disk. */
+  routeModules: number;
+  /** Routes registered by app modules alone, before late connectors booted. */
+  appRoutes: number;
+  /** Routes on the app router once every connector had booted. */
+  totalRoutes: number;
+  /** Every app module that failed to import, in load order. */
+  moduleFailures: ModuleFailure[];
+  /** The model modules that imported, with their exports, in load order. */
+  modelModules: ModelModule[];
+  /** What happened to the connectors. */
+  connectors: {
+    /** Names of every registered connector (built-ins + the app's own). */
+    registered: string[];
+    /**
+     * The connectors the APP configured, i.e. registered names that are not
+     * framework built-ins. This is the part of the list that varies between
+     * projects — the built-in count is a constant and diagnoses nothing.
+     */
+    configured: string[];
+    /** Names that booted without throwing. */
+    booted: string[];
+    /** Connectors doctor deliberately did not boot, with the reason. */
+    skipped: {
+      name: string;
+      reason: string;
+    }[];
+    /** Connectors whose `boot()` threw, with the message. */
+    failures: {
+      name: string;
+      message: string;
+    }[];
+    /**
+     * Set when `warlock.config.ts > connectors` was itself refused (duplicate
+     * or reserved name) — a config that would crash the next real boot.
+     */
+    registrationError?: string;
+  };
+};
+//#endregion
+//# sourceMappingURL=check.types.d.mts.map

package/esm/cli/commands/doctor/check.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.types.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/doctor/check.types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;YAuBY;;EAEV;;EAGA;;;;;;YAOU;;EAEV;;EAGA,SAAS;;;;;;;YAQC;;;;;EAKV;;EAGA;;EAGA;;EAGA;;EAGA,gBAAgB;;EAGhB,cAAc;;EAGd;;IAEE;;;;;;IAOA;;IAGA;;IAGA;MAAW;MAAc;;;IAGzB;MAAY;MAAc;;;;;;IAM1B"}

package/esm/cli/commands/doctor/checks/config.check.mjs

@@ -30,6 +30,7 @@ const configCheck = {
 		if (missing.length > 0) return {
 			name: "config",
 			status: "fail",
+			code: "WL1001",
 			detail: `missing required config section(s): ${missing.join(", ")}`
 		};
 		return {

package/esm/cli/commands/doctor/checks/config.check.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/config.check.ts"],"sourcesContent":["import { config } from \"../../../../config/config-getter\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Config sections that a typical Warlock HTTP application is expected to\n * register. A missing section here is release/runtime-blocking, so absence is\n * a `fail` rather than a warning.\n */\nconst REQUIRED_CONFIG_SECTIONS = [\"app\", \"http\"] as const;\n\n/**\n * `@mongez/config` returns `null` (not `undefined`) for an unregistered key,\n * so treat both nullish values as \"missing\".\n */\nfunction isPresent(value: unknown): boolean {\n  return value !== null && value !== undefined;\n}\n\n/**\n * Verifies that the required top-level config sections are present.\n *\n * NEEDS NO BOOTED APP — config files are loaded by the command's preloaders,\n * before the boot pass. Reads each section via `config.get` only; never mutates\n * configuration.\n */\nexport const configCheck: DoctorCheck = {\n  name: \"config\",\n  run: () => {\n    const missing = REQUIRED_CONFIG_SECTIONS.filter((section) => {\n      return !isPresent(config.get(section));\n    });\n\n    if (missing.length > 0) {\n      return {\n        name: \"config\",\n        status: \"fail\",\n        detail: `missing required config section(s): ${missing.join(\", \")}`,\n      };\n    }\n\n    return {\n      name: \"config\",\n      status: \"ok\",\n      detail: `required sections present (${REQUIRED_CONFIG_SECTIONS.join(\", \")})`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;AAQA,MAAM,2BAA2B,CAAC,OAAO,MAAM;;;;;AAM/C,SAAS,UAAU,OAAyB;CAC1C,OAAO,UAAU,QAAQ,UAAU;AACrC;;;;;;;;AASA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,UAAU,yBAAyB,QAAQ,YAAY;GAC3D,OAAO,CAAC,UAAU,OAAO,IAAI,OAAO,CAAC;EACvC,CAAC;EAED,IAAI,QAAQ,SAAS,GACnB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,uCAAuC,QAAQ,KAAK,IAAI;EAClE;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,8BAA8B,yBAAyB,KAAK,IAAI,EAAE;EAC5E;CACF;AACF"}
+{"version":3,"file":"config.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/config.check.ts"],"sourcesContent":["import { config } from \"../../../../config/config-getter\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Config sections that a typical Warlock HTTP application is expected to\n * register. A missing section here is release/runtime-blocking, so absence is\n * a `fail` rather than a warning.\n */\nconst REQUIRED_CONFIG_SECTIONS = [\"app\", \"http\"] as const;\n\n/**\n * `@mongez/config` returns `null` (not `undefined`) for an unregistered key,\n * so treat both nullish values as \"missing\".\n */\nfunction isPresent(value: unknown): boolean {\n  return value !== null && value !== undefined;\n}\n\n/**\n * Verifies that the required top-level config sections are present.\n *\n * NEEDS NO BOOTED APP — config files are loaded by the command's preloaders,\n * before the boot pass. Reads each section via `config.get` only; never mutates\n * configuration.\n */\nexport const configCheck: DoctorCheck = {\n  name: \"config\",\n  run: () => {\n    const missing = REQUIRED_CONFIG_SECTIONS.filter((section) => {\n      return !isPresent(config.get(section));\n    });\n\n    if (missing.length > 0) {\n      return {\n        name: \"config\",\n        status: \"fail\",\n        code: \"WL1001\",\n        detail: `missing required config section(s): ${missing.join(\", \")}`,\n      };\n    }\n\n    return {\n      name: \"config\",\n      status: \"ok\",\n      detail: `required sections present (${REQUIRED_CONFIG_SECTIONS.join(\", \")})`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;AAQA,MAAM,2BAA2B,CAAC,OAAO,MAAM;;;;;AAM/C,SAAS,UAAU,OAAyB;CAC1C,OAAO,UAAU,QAAQ,UAAU;AACrC;;;;;;;;AASA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,UAAU,yBAAyB,QAAQ,YAAY;GAC3D,OAAO,CAAC,UAAU,OAAO,IAAI,OAAO,CAAC;EACvC,CAAC;EAED,IAAI,QAAQ,SAAS,GACnB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,MAAM;GACN,QAAQ,uCAAuC,QAAQ,KAAK,IAAI;EAClE;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,8BAA8B,yBAAyB,KAAK,IAAI,EAAE;EAC5E;CACF;AACF"}

package/esm/cli/commands/doctor/checks/connectors.check.mjs

@@ -32,11 +32,13 @@ const connectorsCheck = {
 		if (connectors.registrationError) return {
 			name: "connectors",
 			status: "fail",
+			code: "WL1009",
 			detail: `warlock.config.ts > connectors was refused: ${connectors.registrationError}`
 		};
 		if (connectors.failures.length > 0) return {
 			name: "connectors",
 			status: "fail",
+			code: "WL2003",
 			detail: `${connectors.failures.length} connector(s) failed to boot:\n` + connectors.failures.map((failure) => `  - ${failure.name}: ${failure.message}`).join("\n")
 		};
 		if (!context.booted) return;

package/esm/cli/commands/doctor/checks/connectors.check.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connectors.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/connectors.check.ts"],"sourcesContent":["import type { DoctorCheck } from \"../check.types\";\n\n/**\n * Reports whether the app's connectors survive boot.\n *\n * NEEDS A BOOTED APP: the boot pass runs every connector's `boot()` and no\n * `start()`, and this check reads the outcome.\n *\n * WHAT THIS REPLACED, AND WHY: the previous version printed\n * `11 registered, none active`. Both halves were tautologies. Eleven is the\n * number of built-in connectors the manager constructs when its module is\n * imported — it is the same on every project that has ever existed and says\n * nothing about the app. And \"none active\" was guaranteed, because `active` is\n * set by `start()` and doctor deliberately never starts anything: the warning\n * could not be absent from a healthy app, so it could not mean anything on a\n * broken one.\n *\n * What is reported instead is a fact that varies with the project and can be\n * wrong: the connectors the app itself configured, and whether each of them\n * boots. A connector that throws on boot is a boot-time crash the user has not\n * hit yet.\n *\n * Verdicts:\n * - `warlock.config.ts > connectors` refused (duplicate or reserved name) →\n *   `fail`. The next real boot would throw the same error;\n * - a connector's `boot()` threw → `fail`, named, with the message;\n * - otherwise → `ok`, listing what booted.\n */\nexport const connectorsCheck: DoctorCheck = {\n  name: \"connectors\",\n  run: (context) => {\n    const { connectors } = context;\n\n    if (connectors.registrationError) {\n      return {\n        name: \"connectors\",\n        status: \"fail\",\n        detail: `warlock.config.ts > connectors was refused: ${connectors.registrationError}`,\n      };\n    }\n\n    if (connectors.failures.length > 0) {\n      return {\n        name: \"connectors\",\n        status: \"fail\",\n        detail:\n          `${connectors.failures.length} connector(s) failed to boot:\\n` +\n          connectors.failures\n            .map((failure) => `  - ${failure.name}: ${failure.message}`)\n            .join(\"\\n\"),\n      };\n    }\n\n    if (!context.booted) {\n      return undefined;\n    }\n\n    const skipped = connectors.skipped\n      .map((entry) => `; skipped ${entry.name} (${entry.reason})`)\n      .join(\"\");\n\n    const configured =\n      connectors.configured.length > 0\n        ? `${connectors.configured.join(\", \")} from warlock.config.ts + ` +\n          `${connectors.registered.length - connectors.configured.length} built-in`\n        : `${connectors.registered.length} built-in, none configured in warlock.config.ts`;\n\n    return {\n      name: \"connectors\",\n      status: \"ok\",\n      detail: `all booted without error (${configured})${skipped}`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,kBAA+B;CAC1C,MAAM;CACN,MAAM,YAAY;EAChB,MAAM,EAAE,eAAe;EAEvB,IAAI,WAAW,mBACb,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,+CAA+C,WAAW;EACpE;EAGF,IAAI,WAAW,SAAS,SAAS,GAC/B,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QACE,GAAG,WAAW,SAAS,OAAO,mCAC9B,WAAW,SACR,KAAK,YAAY,OAAO,QAAQ,KAAK,IAAI,QAAQ,SAAS,CAAC,CAC3D,KAAK,IAAI;EAChB;EAGF,IAAI,CAAC,QAAQ,QACX;EAGF,MAAM,UAAU,WAAW,QACxB,KAAK,UAAU,aAAa,MAAM,KAAK,IAAI,MAAM,OAAO,EAAE,CAAC,CAC3D,KAAK,EAAE;EAQV,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,6BARR,WAAW,WAAW,SAAS,IAC3B,GAAG,WAAW,WAAW,KAAK,IAAI,EAAE,4BACjC,WAAW,WAAW,SAAS,WAAW,WAAW,OAAO,aAC/D,GAAG,WAAW,WAAW,OAAO,iDAKY,GAAG;EACrD;CACF;AACF"}
+{"version":3,"file":"connectors.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/connectors.check.ts"],"sourcesContent":["import type { DoctorCheck } from \"../check.types\";\n\n/**\n * Reports whether the app's connectors survive boot.\n *\n * NEEDS A BOOTED APP: the boot pass runs every connector's `boot()` and no\n * `start()`, and this check reads the outcome.\n *\n * WHAT THIS REPLACED, AND WHY: the previous version printed\n * `11 registered, none active`. Both halves were tautologies. Eleven is the\n * number of built-in connectors the manager constructs when its module is\n * imported — it is the same on every project that has ever existed and says\n * nothing about the app. And \"none active\" was guaranteed, because `active` is\n * set by `start()` and doctor deliberately never starts anything: the warning\n * could not be absent from a healthy app, so it could not mean anything on a\n * broken one.\n *\n * What is reported instead is a fact that varies with the project and can be\n * wrong: the connectors the app itself configured, and whether each of them\n * boots. A connector that throws on boot is a boot-time crash the user has not\n * hit yet.\n *\n * Verdicts:\n * - `warlock.config.ts > connectors` refused (duplicate or reserved name) →\n *   `fail`. The next real boot would throw the same error;\n * - a connector's `boot()` threw → `fail`, named, with the message;\n * - otherwise → `ok`, listing what booted.\n */\nexport const connectorsCheck: DoctorCheck = {\n  name: \"connectors\",\n  run: (context) => {\n    const { connectors } = context;\n\n    if (connectors.registrationError) {\n      return {\n        name: \"connectors\",\n        status: \"fail\",\n        code: \"WL1009\",\n        detail: `warlock.config.ts > connectors was refused: ${connectors.registrationError}`,\n      };\n    }\n\n    if (connectors.failures.length > 0) {\n      return {\n        name: \"connectors\",\n        status: \"fail\",\n        code: \"WL2003\",\n        detail:\n          `${connectors.failures.length} connector(s) failed to boot:\\n` +\n          connectors.failures\n            .map((failure) => `  - ${failure.name}: ${failure.message}`)\n            .join(\"\\n\"),\n      };\n    }\n\n    if (!context.booted) {\n      return undefined;\n    }\n\n    const skipped = connectors.skipped\n      .map((entry) => `; skipped ${entry.name} (${entry.reason})`)\n      .join(\"\");\n\n    const configured =\n      connectors.configured.length > 0\n        ? `${connectors.configured.join(\", \")} from warlock.config.ts + ` +\n          `${connectors.registered.length - connectors.configured.length} built-in`\n        : `${connectors.registered.length} built-in, none configured in warlock.config.ts`;\n\n    return {\n      name: \"connectors\",\n      status: \"ok\",\n      detail: `all booted without error (${configured})${skipped}`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,kBAA+B;CAC1C,MAAM;CACN,MAAM,YAAY;EAChB,MAAM,EAAE,eAAe;EAEvB,IAAI,WAAW,mBACb,OAAO;GACL,MAAM;GACN,QAAQ;GACR,MAAM;GACN,QAAQ,+CAA+C,WAAW;EACpE;EAGF,IAAI,WAAW,SAAS,SAAS,GAC/B,OAAO;GACL,MAAM;GACN,QAAQ;GACR,MAAM;GACN,QACE,GAAG,WAAW,SAAS,OAAO,mCAC9B,WAAW,SACR,KAAK,YAAY,OAAO,QAAQ,KAAK,IAAI,QAAQ,SAAS,CAAC,CAC3D,KAAK,IAAI;EAChB;EAGF,IAAI,CAAC,QAAQ,QACX;EAGF,MAAM,UAAU,WAAW,QACxB,KAAK,UAAU,aAAa,MAAM,KAAK,IAAI,MAAM,OAAO,EAAE,CAAC,CAC3D,KAAK,EAAE;EAQV,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,6BARR,WAAW,WAAW,SAAS,IAC3B,GAAG,WAAW,WAAW,KAAK,IAAI,EAAE,4BACjC,WAAW,WAAW,SAAS,WAAW,WAAW,OAAO,aAC/D,GAAG,WAAW,WAAW,OAAO,iDAKY,GAAG;EACrD;CACF;AACF"}

package/esm/cli/commands/doctor/checks/handler-signature.check.mjs

@@ -34,6 +34,7 @@ const handlerSignatureCheck = {
 		return {
 			name: "handler-signature",
 			status: "warn",
+			code: "WL3006",
 			detail: `${suspects.length === 1 ? "1 handler looks like the v4 positional signature" : `${suspects.length} handlers look like the v4 positional signature`}:\n` + suspects.map((suspect) => `  - ${describePositionalHandlerSuspect(suspect)}`).join("\n")
 		};
 	}

package/esm/cli/commands/doctor/checks/handler-signature.check.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"handler-signature.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/handler-signature.check.ts"],"sourcesContent":["import {\n  describePositionalHandlerSuspect,\n  listPositionalHandlerSuspects,\n} from \"../../../../router/positional-handler-diagnostics\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Surfaces route handlers still written against the v4 positional signature,\n * `(request, response)`. v5 calls a handler with a single context object, so\n * the second parameter is always `undefined` and the route fails on its first\n * request with a `TypeError` that names nothing.\n *\n * Verdicts:\n * - one or more suspects → `warn`;\n * - otherwise → `ok`.\n *\n * `warn`, never `fail`: the detection is a heuristic on the handler's declared\n * parameters, so a false positive is possible and must not break a build.\n *\n * NEEDS A BOOTED APP: the router collects suspects as routes register, so this\n * reads a list the boot pass filled. Before that pass existed the list was\n * always empty and this check always passed — it was green because it had\n * nothing to look at, which is indistinguishable from green because the app is\n * fine. It stays silent when there are no routes for the same reason: a check\n * with no input reports nothing rather than a clean bill of health.\n */\nexport const handlerSignatureCheck: DoctorCheck = {\n  name: \"handler-signature\",\n  run: (context) => {\n    if (context.totalRoutes === 0) {\n      return undefined;\n    }\n\n    const suspects = listPositionalHandlerSuspects();\n\n    if (suspects.length === 0) {\n      return {\n        name: \"handler-signature\",\n        status: \"ok\",\n        detail: \"no handlers look like the v4 positional signature\",\n      };\n    }\n\n    const headline =\n      suspects.length === 1\n        ? \"1 handler looks like the v4 positional signature\"\n        : `${suspects.length} handlers look like the v4 positional signature`;\n\n    return {\n      name: \"handler-signature\",\n      status: \"warn\",\n      detail:\n        `${headline}:\\n` +\n        suspects.map((suspect) => `  - ${describePositionalHandlerSuspect(suspect)}`).join(\"\\n\"),\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,wBAAqC;CAChD,MAAM;CACN,MAAM,YAAY;EAChB,IAAI,QAAQ,gBAAgB,GAC1B;EAGF,MAAM,WAAW,8BAA8B;EAE/C,IAAI,SAAS,WAAW,GACtB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAQF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QACE,GARF,SAAS,WAAW,IAChB,qDACA,GAAG,SAAS,OAAO,iDAMT,OACZ,SAAS,KAAK,YAAY,OAAO,iCAAiC,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI;EAC3F;CACF;AACF"}
+{"version":3,"file":"handler-signature.check.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/doctor/checks/handler-signature.check.ts"],"sourcesContent":["import {\n  describePositionalHandlerSuspect,\n  listPositionalHandlerSuspects,\n} from \"../../../../router/positional-handler-diagnostics\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Surfaces route handlers still written against the v4 positional signature,\n * `(request, response)`. v5 calls a handler with a single context object, so\n * the second parameter is always `undefined` and the route fails on its first\n * request with a `TypeError` that names nothing.\n *\n * Verdicts:\n * - one or more suspects → `warn`;\n * - otherwise → `ok`.\n *\n * `warn`, never `fail`: the detection is a heuristic on the handler's declared\n * parameters, so a false positive is possible and must not break a build.\n *\n * NEEDS A BOOTED APP: the router collects suspects as routes register, so this\n * reads a list the boot pass filled. Before that pass existed the list was\n * always empty and this check always passed — it was green because it had\n * nothing to look at, which is indistinguishable from green because the app is\n * fine. It stays silent when there are no routes for the same reason: a check\n * with no input reports nothing rather than a clean bill of health.\n */\nexport const handlerSignatureCheck: DoctorCheck = {\n  name: \"handler-signature\",\n  run: (context) => {\n    if (context.totalRoutes === 0) {\n      return undefined;\n    }\n\n    const suspects = listPositionalHandlerSuspects();\n\n    if (suspects.length === 0) {\n      return {\n        name: \"handler-signature\",\n        status: \"ok\",\n        detail: \"no handlers look like the v4 positional signature\",\n      };\n    }\n\n    const headline =\n      suspects.length === 1\n        ? \"1 handler looks like the v4 positional signature\"\n        : `${suspects.length} handlers look like the v4 positional signature`;\n\n    return {\n      name: \"handler-signature\",\n      status: \"warn\",\n      code: \"WL3006\",\n      detail:\n        `${headline}:\\n` +\n        suspects.map((suspect) => `  - ${describePositionalHandlerSuspect(suspect)}`).join(\"\\n\"),\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,wBAAqC;CAChD,MAAM;CACN,MAAM,YAAY;EAChB,IAAI,QAAQ,gBAAgB,GAC1B;EAGF,MAAM,WAAW,8BAA8B;EAE/C,IAAI,SAAS,WAAW,GACtB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAQF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,MAAM;GACN,QACE,GATF,SAAS,WAAW,IAChB,qDACA,GAAG,SAAS,OAAO,iDAOT,OACZ,SAAS,KAAK,YAAY,OAAO,iCAAiC,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI;EAC3F;CACF;AACF"}

package/esm/cli/commands/doctor/checks/health.check.mjs

@@ -73,6 +73,7 @@ const healthCheck = {
 		if (collisions.length > 0) return {
 			name: "health",
 			status: "fail",
+			code: "WL5002",
 			detail: `an app route already claims ${collisions.join(" and ")} — Fastify refuses the duplicate registration and the server will not start. Move the app route, or rename the probe via http.health.path / http.health.readinessPath`
 		};
 		if (!context.connectors.booted.includes("http")) return;
@@ -80,12 +81,14 @@ const healthCheck = {
 		if (registered.some((answer) => answer === void 0)) return {
 			name: "health",
 			status: "warn",
+			code: "WL5003",
 			detail: `could not read the http server's route table — ${livenessPath} + ${readinessPath} unverified`
 		};
 		const missing = [livenessPath, readinessPath].filter((_path, index) => !registered[index]);
 		if (missing.length > 0) return {
 			name: "health",
 			status: "fail",
+			code: "WL5003",
 			detail: `enabled in config but not registered on the http server: ${missing.join(", ")}`
 		};
 		return {