@warlock.js/core 5.31.0 → 5.33.0

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

@@ -0,0 +1,140 @@
+import { withConsoleOnStderr } from "../routes/with-console-on-stderr.mjs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { readFile, stat } from "node:fs/promises";
+import { resolve as resolve$1 } from "import-meta-resolve";
+
+//#region ../../packages/core/src/cli/commands/ai/ai-command.action.ts
+/** Resolve from the caller's project, including optional provider packages. */
+async function loadMeasureModule(specifier, cwd = process.cwd()) {
+	const parent = pathToFileURL(path.join(cwd, "package.json")).href;
+	return import(resolve$1(specifier, parent));
+}
+function object(value) {
+	return value !== null && typeof value === "object";
+}
+function isMeasureModule(value) {
+	return typeof value.measure === "function" && typeof value.skills === "function";
+}
+function isModel(value) {
+	return object(value) && typeof value.name === "string" && typeof value.provider === "string" && typeof value.complete === "function" && typeof value.stream === "function" && (value.countTokens === void 0 || typeof value.countTokens === "function") && (value.pricing === void 0 || object(value.pricing) && typeof value.pricing.input === "number" && Number.isFinite(value.pricing.input) && value.pricing.input >= 0 && typeof value.pricing.output === "number" && Number.isFinite(value.pricing.output) && value.pricing.output >= 0);
+}
+function isTool(value) {
+	return object(value) && typeof value.name === "string" && typeof value.description === "string" && typeof value.execute === "function" && (value.input === void 0 || object(value.input) && object(value.input["~standard"]) && typeof value.input["~standard"].validate === "function");
+}
+/** SDK constructor/model signatures verified against the first-party adapter sources. */
+async function resolveMeasureModel(id, modelModule, load = loadMeasureModule, env = process.env) {
+	if (modelModule) {
+		const exported = await load(modelModule);
+		const model = typeof exported.resolveModel === "function" ? await exported.resolveModel(id) : exported.model ?? exported.default;
+		if (!isModel(model)) throw new Error("--model-module must export a model or resolveModel(id) returning a model.");
+		return model;
+	}
+	const separator = id.indexOf(":");
+	const provider = separator < 0 ? "openai" : id.slice(0, separator);
+	const name = separator < 0 ? id : id.slice(separator + 1);
+	const adapters = {
+		openai: {
+			package: "@warlock.js/ai-openai",
+			sdk: "OpenAISDK",
+			key: "OPENAI_API_KEY"
+		},
+		anthropic: {
+			package: "@warlock.js/ai-anthropic",
+			sdk: "AnthropicSDK",
+			key: "ANTHROPIC_API_KEY"
+		},
+		google: {
+			package: "@warlock.js/ai-google",
+			sdk: "GoogleSDK",
+			key: "GEMINI_API_KEY"
+		}
+	};
+	const adapter = Object.hasOwn(adapters, provider) ? adapters[provider] : void 0;
+	if (!adapter || !name) throw new Error("Use a model ID, openai:<id>, anthropic:<id>, google:<id>, or --model-module for a custom provider.");
+	const apiKey = env[adapter.key];
+	if (!apiKey) throw new Error(`Set ${adapter.key}, or supply a configured model with --model-module.`);
+	let exported;
+	try {
+		exported = await load(adapter.package);
+	} catch (cause) {
+		throw new Error(`Cannot load ${adapter.package}. Install it in this project or use --model-module.`, { cause });
+	}
+	const Constructor = exported[adapter.sdk];
+	if (typeof Constructor !== "function") throw new Error(`${adapter.package} does not export ${adapter.sdk}.`);
+	const model = new Constructor({ apiKey }).model({
+		name,
+		...provider === "openai" ? { api: "responses" } : {}
+	});
+	if (!isModel(model)) throw new Error(`${adapter.package} returned an invalid model.`);
+	return model;
+}
+function formatMeasurement(report) {
+	const lines = [`${report.provider}:${report.model} — input per call`, "Part	Tokens	Source	USD"];
+	const row = (name, part) => `${name}\t${part.tokens}\t${part.source}\t${part.costUSD === void 0 ? "unknown" : part.costUSD.toFixed(8)}`;
+	for (const [name, part] of Object.entries(report.parts)) lines.push(row(name, part));
+	lines.push(row("total", report.total));
+	if (report.probe) lines.push("Messages include a user probe: \".\"");
+	lines.push("USD uses uncached input pricing; output, cache adjustments and hosted-tool fees are excluded.");
+	return lines.join("\n");
+}
+async function aiCommandAction({ args, options }, dependencies = {}) {
+	if (args.length !== 1 || args[0] !== "measure") throw new Error("Usage: warlock ai measure --model <id> [--tools <module>] [--system <file>] [--skills <dir>] [--json]");
+	const stringOption = (name, required = false) => {
+		const value = options[name];
+		if (value === void 0 && !required) return void 0;
+		if (typeof value !== "string" || !value.trim()) throw new Error(`--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)} requires a value.`);
+		return value;
+	};
+	const id = stringOption("model", true);
+	if (!id) throw new Error("--model is required.");
+	const modelModule = stringOption("modelModule");
+	const toolsModule = stringOption("tools");
+	const systemFile = stringOption("system");
+	const skillsDir = stringOption("skills");
+	const cwd = dependencies.cwd ?? process.cwd();
+	const load = dependencies.load ?? ((specifier) => loadMeasureModule(specifier, cwd));
+	const calculate = async () => {
+		let exported;
+		try {
+			exported = await load("@warlock.js/ai");
+		} catch (cause) {
+			throw new Error("Cannot load @warlock.js/ai. Install it in this project to use warlock ai measure.", { cause });
+		}
+		if (!isMeasureModule(exported)) throw new Error("warlock ai measure requires @warlock.js/ai 5.33.0 or newer.");
+		const aiPackage = exported;
+		const model = await resolveMeasureModel(id, modelModule, load);
+		let tools = [];
+		if (toolsModule) {
+			const module = await load(toolsModule);
+			const entries = module.tools ?? module.default;
+			if (!Array.isArray(entries) || !entries.every(isTool)) throw new Error("--tools must export an array of tool configs as tools or default.");
+			tools = entries;
+		}
+		const system = systemFile ? await readFile(path.resolve(cwd, systemFile), "utf8") : void 0;
+		let skills;
+		if (skillsDir) {
+			const directory = path.resolve(cwd, skillsDir);
+			if (!(await stat(directory)).isDirectory()) throw new Error("--skills must name a directory.");
+			skills = aiPackage.skills({
+				name: "measured-skills",
+				sources: [{
+					type: "directory",
+					path: directory
+				}]
+			});
+		}
+		return aiPackage.measure({
+			model,
+			tools,
+			system,
+			skills
+		});
+	};
+	const report = options.json === true ? await withConsoleOnStderr(calculate) : await calculate();
+	console.log(options.json === true ? JSON.stringify(report, null, 2) : formatMeasurement(report));
+}
+
+//#endregion
+export { aiCommandAction, formatMeasurement, loadMeasureModule, resolveMeasureModel };
+//# sourceMappingURL=ai-command.action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-command.action.mjs","names":["resolveModule"],"sources":["../../../../../../../../../../packages/core/src/cli/commands/ai/ai-command.action.ts"],"sourcesContent":["import { readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolve as resolveModule } from \"import-meta-resolve\";\nimport type { Measurement, ModelContract, ToolConfig } from \"@warlock.js/ai\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\ntype ModuleExports = Record<string, unknown>;\ntype MeasureModule = Pick<typeof import(\"@warlock.js/ai\"), \"measure\" | \"skills\">;\ntype ModuleLoader = (specifier: string) => Promise<ModuleExports>;\ntype SDKConstructor = new (config: { apiKey: string }) => {\n  model(config: { name: string; api?: \"responses\" }): ModelContract;\n};\n\n/** Resolve from the caller's project, including optional provider packages. */\nexport async function loadMeasureModule(\n  specifier: string,\n  cwd = process.cwd(),\n): Promise<ModuleExports> {\n  const parent = pathToFileURL(path.join(cwd, \"package.json\")).href;\n  return import(resolveModule(specifier, parent));\n}\n\nfunction object(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\";\n}\n\nfunction isMeasureModule(value: ModuleExports): value is ModuleExports & MeasureModule {\n  return typeof value.measure === \"function\" && typeof value.skills === \"function\";\n}\n\nfunction isModel(value: unknown): value is ModelContract {\n  return (\n    object(value) &&\n    typeof value.name === \"string\" &&\n    typeof value.provider === \"string\" &&\n    typeof value.complete === \"function\" &&\n    typeof value.stream === \"function\" &&\n    (value.countTokens === undefined || typeof value.countTokens === \"function\") &&\n    (value.pricing === undefined ||\n      (object(value.pricing) &&\n        typeof value.pricing.input === \"number\" &&\n        Number.isFinite(value.pricing.input) &&\n        value.pricing.input >= 0 &&\n        typeof value.pricing.output === \"number\" &&\n        Number.isFinite(value.pricing.output) &&\n        value.pricing.output >= 0))\n  );\n}\n\nfunction isTool(value: unknown): value is ToolConfig<unknown, unknown> {\n  return (\n    object(value) &&\n    typeof value.name === \"string\" &&\n    typeof value.description === \"string\" &&\n    typeof value.execute === \"function\" &&\n    (value.input === undefined ||\n      (object(value.input) &&\n        object(value.input[\"~standard\"]) &&\n        typeof value.input[\"~standard\"].validate === \"function\"))\n  );\n}\n\n/** SDK constructor/model signatures verified against the first-party adapter sources. */\nexport async function resolveMeasureModel(\n  id: string,\n  modelModule: string | undefined,\n  load: ModuleLoader = loadMeasureModule,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<ModelContract> {\n  if (modelModule) {\n    const exported = await load(modelModule);\n    const model: unknown =\n      typeof exported.resolveModel === \"function\"\n        ? await exported.resolveModel(id)\n        : (exported.model ?? exported.default);\n    if (!isModel(model))\n      throw new Error(\"--model-module must export a model or resolveModel(id) returning a model.\");\n    return model;\n  }\n  const separator = id.indexOf(\":\");\n  const provider = separator < 0 ? \"openai\" : id.slice(0, separator);\n  const name = separator < 0 ? id : id.slice(separator + 1);\n  const adapters: Record<string, { package: string; sdk: string; key: string }> = {\n    openai: { package: \"@warlock.js/ai-openai\", sdk: \"OpenAISDK\", key: \"OPENAI_API_KEY\" },\n    anthropic: {\n      package: \"@warlock.js/ai-anthropic\",\n      sdk: \"AnthropicSDK\",\n      key: \"ANTHROPIC_API_KEY\",\n    },\n    google: { package: \"@warlock.js/ai-google\", sdk: \"GoogleSDK\", key: \"GEMINI_API_KEY\" },\n  };\n  const adapter = Object.hasOwn(adapters, provider) ? adapters[provider] : undefined;\n  if (!adapter || !name)\n    throw new Error(\n      \"Use a model ID, openai:<id>, anthropic:<id>, google:<id>, or --model-module for a custom provider.\",\n    );\n  const apiKey = env[adapter.key];\n  if (!apiKey)\n    throw new Error(`Set ${adapter.key}, or supply a configured model with --model-module.`);\n  let exported: ModuleExports;\n  try {\n    exported = await load(adapter.package);\n  } catch (cause) {\n    throw new Error(\n      `Cannot load ${adapter.package}. Install it in this project or use --model-module.`,\n      { cause },\n    );\n  }\n  const Constructor = exported[adapter.sdk];\n  if (typeof Constructor !== \"function\")\n    throw new Error(`${adapter.package} does not export ${adapter.sdk}.`);\n  const sdk = new (Constructor as SDKConstructor)({ apiKey });\n  // The Responses adapter exposes countTokens; the Chat adapter does not.\n  const model = sdk.model({\n    name,\n    ...(provider === \"openai\" ? { api: \"responses\" as const } : {}),\n  });\n  if (!isModel(model)) throw new Error(`${adapter.package} returned an invalid model.`);\n  return model;\n}\n\nexport function formatMeasurement(report: Measurement): string {\n  const lines = [\n    `${report.provider}:${report.model} — input per call`,\n    \"Part\\tTokens\\tSource\\tUSD\",\n  ];\n  const row = (name: string, part: Measurement[\"total\"]) =>\n    `${name}\\t${part.tokens}\\t${part.source}\\t${part.costUSD === undefined ? \"unknown\" : part.costUSD.toFixed(8)}`;\n  for (const [name, part] of Object.entries(report.parts)) lines.push(row(name, part));\n  lines.push(row(\"total\", report.total));\n  if (report.probe) lines.push('Messages include a user probe: \".\"');\n  lines.push(\n    \"USD uses uncached input pricing; output, cache adjustments and hosted-tool fees are excluded.\",\n  );\n  return lines.join(\"\\n\");\n}\n\nexport async function aiCommandAction(\n  { args, options }: CommandActionData,\n  dependencies: { load?: ModuleLoader; cwd?: string } = {},\n): Promise<void> {\n  if (args.length !== 1 || args[0] !== \"measure\")\n    throw new Error(\n      \"Usage: warlock ai measure --model <id> [--tools <module>] [--system <file>] [--skills <dir>] [--json]\",\n    );\n  const stringOption = (name: string, required = false): string | undefined => {\n    const value = options[name];\n    if (value === undefined && !required) return undefined;\n    if (typeof value !== \"string\" || !value.trim())\n      throw new Error(\n        `--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)} requires a value.`,\n      );\n    return value;\n  };\n  const id = stringOption(\"model\", true);\n  if (!id) throw new Error(\"--model is required.\");\n  const modelModule = stringOption(\"modelModule\");\n  const toolsModule = stringOption(\"tools\");\n  const systemFile = stringOption(\"system\");\n  const skillsDir = stringOption(\"skills\");\n  const cwd = dependencies.cwd ?? process.cwd();\n  const load = dependencies.load ?? ((specifier) => loadMeasureModule(specifier, cwd));\n  const calculate = async (): Promise<Measurement> => {\n    let exported: ModuleExports;\n    try {\n      exported = await load(\"@warlock.js/ai\");\n    } catch (cause) {\n      throw new Error(\n        \"Cannot load @warlock.js/ai. Install it in this project to use warlock ai measure.\",\n        { cause },\n      );\n    }\n    // The optional peer stays behind the action; unrelated CLI commands never import AI.\n    if (!isMeasureModule(exported)) {\n      throw new Error(\"warlock ai measure requires @warlock.js/ai 5.33.0 or newer.\");\n    }\n    const aiPackage = exported;\n    const model = await resolveMeasureModel(id, modelModule, load);\n    let tools: ToolConfig<unknown, unknown>[] = [];\n    if (toolsModule) {\n      const module = await load(toolsModule);\n      const entries: unknown = module.tools ?? module.default;\n      if (!Array.isArray(entries) || !entries.every(isTool))\n        throw new Error(\"--tools must export an array of tool configs as tools or default.\");\n      tools = entries;\n    }\n    const system = systemFile ? await readFile(path.resolve(cwd, systemFile), \"utf8\") : undefined;\n    let skills: ReturnType<typeof aiPackage.skills> | undefined;\n    if (skillsDir) {\n      const directory = path.resolve(cwd, skillsDir);\n      if (!(await stat(directory)).isDirectory())\n        throw new Error(\"--skills must name a directory.\");\n      skills = aiPackage.skills({\n        name: \"measured-skills\",\n        sources: [{ type: \"directory\", path: directory }],\n      });\n    }\n    return aiPackage.measure({ model, tools, system, skills });\n  };\n  const report = options.json === true ? await withConsoleOnStderr(calculate) : await calculate();\n  console.log(options.json === true ? JSON.stringify(report, null, 2) : formatMeasurement(report));\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,50 @@
+import { command } from "../../commands/cli-command.mjs";
+
+//#region ../../packages/core/src/cli/commands/ai.command.ts
+/** Built in so installing AI does not require cli.commands registration. */
+const aiCommand = command({
+	name: "ai <action>",
+	description: "Measure AI input tokens and uncached input USD per call",
+	preload: {},
+	options: [
+		{
+			text: "--model",
+			description: "Model ID (OpenAI), or openai: / anthropic: / google: ID",
+			type: "string",
+			required: true
+		},
+		{
+			text: "--model-module",
+			description: "Module exporting a model or resolveModel(id)",
+			type: "string"
+		},
+		{
+			text: "--tools",
+			description: "Module exporting a tools array (named tools or default)",
+			type: "string"
+		},
+		{
+			text: "--system",
+			description: "UTF-8 system prompt file",
+			type: "string"
+		},
+		{
+			text: "--skills",
+			description: "Directory containing skill folders with SKILL.md files",
+			type: "string"
+		},
+		{
+			text: "--json",
+			description: "Print one JSON report to stdout",
+			type: "boolean"
+		}
+	],
+	action: async (data) => {
+		const { aiCommandAction } = await import("./ai/ai-command.action.mjs");
+		await aiCommandAction(data);
+	}
+});
+
+//#endregion
+export { aiCommand };
+//# sourceMappingURL=ai.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/ai.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\n\n/** Built in so installing AI does not require cli.commands registration. */\nexport const aiCommand = command({\n  name: \"ai <action>\",\n  description: \"Measure AI input tokens and uncached input USD per call\",\n  preload: {},\n  options: [\n    {\n      text: \"--model\",\n      description: \"Model ID (OpenAI), or openai: / anthropic: / google: ID\",\n      type: \"string\",\n      required: true,\n    },\n    {\n      text: \"--model-module\",\n      description: \"Module exporting a model or resolveModel(id)\",\n      type: \"string\",\n    },\n    {\n      text: \"--tools\",\n      description: \"Module exporting a tools array (named tools or default)\",\n      type: \"string\",\n    },\n    { text: \"--system\", description: \"UTF-8 system prompt file\", type: \"string\" },\n    {\n      text: \"--skills\",\n      description: \"Directory containing skill folders with SKILL.md files\",\n      type: \"string\",\n    },\n    { text: \"--json\", description: \"Print one JSON report to stdout\", type: \"boolean\" },\n  ],\n  action: async (data) => {\n    const { aiCommandAction } = await import(\"./ai/ai-command.action\");\n    await aiCommandAction(data);\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,YAAY,QAAQ;CAC/B,MAAM;CACN,aAAa;CACb,SAAS,CAAC;CACV,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACN,UAAU;EACZ;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GAAE,MAAM;GAAY,aAAa;GAA4B,MAAM;EAAS;EAC5E;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GAAE,MAAM;GAAU,aAAa;GAAmC,MAAM;EAAU;CACpF;CACA,QAAQ,OAAO,SAAS;EACtB,MAAM,EAAE,oBAAoB,MAAM,OAAO;EACzC,MAAM,gBAAgB,IAAI;CAC5B;AACF,CAAC"}

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

@@ -275,5 +275,5 @@ async function boardCommandAction({ args, options }) {
 }
 
 //#endregion
-export { boardCommandAction };
+export { BOARD_ACTIONS, boardCommandAction, formatBoardItemLine, parseBoardInvocation, readBodyOption, runBoardInvocation };
 //# sourceMappingURL=board-command.action.mjs.map

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

@@ -30,6 +30,8 @@ function parseSkippedSteps(value) {
 * @param data Parsed CLI args: `changed`, `base`, `skip`, `project`, `json`.
 */
 async function checkCommandAction({ options }) {
+	const lint = stringOption(options.lint);
+	if (lint !== void 0 && lint !== "oxlint" && lint !== "eslint") throw new Error("Unknown lint tool. Use --lint oxlint or --lint eslint (deprecated).");
 	const base = stringOption(options.base);
 	const changed = options.changed === true || base !== void 0;
 	const project = stringOption(options.project);
@@ -37,6 +39,7 @@ async function checkCommandAction({ options }) {
 	const cliEntry = process.argv[1];
 	const flags = [...changed ? ["--changed"] : [], ...base ? ["--base", base] : []];
 	const report = await runCheck({
+		lint,
 		changed,
 		base,
 		skip,
@@ -53,5 +56,5 @@ async function checkCommandAction({ options }) {
 }
 
 //#endregion
-export { checkCommandAction };
+export { checkCommandAction, parseSkippedSteps };
 //# sourceMappingURL=check-command.action.mjs.map

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

@@ -1 +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"}
+{"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 lint = stringOption(options.lint);\n  if (lint !== undefined && lint !== \"oxlint\" && lint !== \"eslint\") {\n    throw new Error(\"Unknown lint tool. Use --lint oxlint or --lint eslint (deprecated).\");\n  }\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    lint,\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,IAAI,SAAS,UAAa,SAAS,YAAY,SAAS,UACtD,MAAM,IAAI,MAAM,qEAAqE;CAEvF,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;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

@@ -30,7 +30,7 @@ function childTypecheckRunner(cliEntry, flags) {
 			cwd: options.cwd ?? process.cwd(),
 			encoding: "utf8",
 			windowsHide: true,
-			maxBuffer: 64 * 1024 * 1024
+			maxBuffer: 67108864
 		}, (error, stdout, stderr) => {
 			let parsed;
 			try {

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

@@ -1 +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"}
+{"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

@@ -39,5 +39,5 @@ function formatCheckSummary(report) {
 }
 
 //#endregion
-export { formatCheckSummary, printProblems };
+export { formatCheckSummary, formatProblemLines, printProblems };
 //# sourceMappingURL=format-problems.mjs.map

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

@@ -4,7 +4,7 @@ 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
+* Oxlint config, or explicitly selected deprecated ESLint), 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.
 *
@@ -17,6 +17,11 @@ const checkCommand = command({
 	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: "--lint",
+			description: "Lint tool: oxlint (default) or eslint (deprecated; removed in 5.34.0)",
+			type: "string"
+		},
 		{
 			text: "--changed, -c",
 			description: "Only the files changed against HEAD (plus untracked files) and what they affect",

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

@@ -1 +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"}
+{"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 * Oxlint config, or explicitly selected deprecated ESLint), 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: \"--lint\",\n      description: \"Lint tool: oxlint (default) or eslint (deprecated; removed in 5.34.0)\",\n      type: \"string\",\n    },\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,aAAa;GACb,MAAM;EACR;EACA;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

@@ -26,12 +26,13 @@ const devServerCommand = command({
 		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,
 			mcp: data.options.mcp === true ? true : void 0
-		}));
+		});
+		checkForFrameworkUpdate(devServer);
 	},
 	options: [
 		{

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 { 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"}
+{"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/check.types.d.mts

@@ -19,16 +19,20 @@
 /**
  * A module the boot pass could not import, and why.
  */
-type ModuleFailure = {
-  /** Project-relative path of the file that failed. */file: string; /** The underlying error message (the cause, not the wrapper). */
+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.
  */
-type ModelModule = {
-  /** Project-relative path of the model file. */file: string; /** The module's exports (a shallow copy of its namespace). */
+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>;
 };
 /**
@@ -36,30 +40,40 @@ type ModelModule = {
  * anything itself — and so the report cannot contain two checks that booted the
  * app differently and disagreed about it.
  */
-type DoctorBootContext = {
+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. */
+  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[];
+    /** 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. */
+    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. */
+    }[];
+    /** Connectors whose `boot()` threw, with the message. */
     failures: {
       name: string;
       message: string;
@@ -72,5 +86,4 @@ type DoctorBootContext = {
   };
 };
 //#endregion
-export { DoctorBootContext };
 //# sourceMappingURL=check.types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"check.types.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/doctor/check.types.ts"],"mappings":";AAuBA;;;;AAKS;AAOT;;;;;;;;AAKiB;AAQjB;;;;;;KAzBY,aAAA;EAuCV,qDArCA,IAAA,UAwCgB;EArChB,OAAO;AAAA;;;;;KAOG,WAAA;EAmDG,+CAjDb,IAAA,UAoDE;EAjDF,OAAA,EAAS,MAAM;AAAA;;;AAuDI;;;KA/CT,iBAAA;;;;;EAKV,MAAA;EAGA,YAAA;EAGA,SAAA;EAGA,WAAA;EAGA,cAAA,EAAgB,aAAA;EAGhB,YAAA,EAAc,WAAW;EAGzB,UAAA;2EAEE,UAAA;;;;;;IAOA,UAAA;IAGA,MAAA;IAGA,OAAA;MAAW,IAAA;MAAc,MAAA;IAAA;IAGzB,QAAA;MAAY,IAAA;MAAc,OAAA;IAAA;;;;;IAM1B,iBAAA;EAAA;AAAA"}
+{"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/locales-ts-deprecated.check.mjs

@@ -1,9 +1,10 @@
 import { config } from "../../../../config/config-getter.mjs";
 import { appPath, rootPath } from "../../../../utils/paths.mjs";
 import { parseLocaleDictionary } from "../../../../localization/parse-locale-dictionary.mjs";
+import { isExpressionStatement, isIdentifier, isNumericLiteral, isPropertyAssignment, isStringLiteral, keyName, parseSourceFile, valueText } from "../../../../tooling/syntax/ast.mjs";
 import path from "node:path";
 import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import ts from "typescript";
+import { parseSync } from "oxc-parser";
 
 //#region ../../packages/core/src/cli/commands/doctor/checks/locales-ts-deprecated.check.ts
 function localeSources() {
@@ -14,23 +15,19 @@ function localeSources() {
 		module: entry.name
 	})).filter(({ file }) => existsSync(file));
 }
-function propertyName(property) {
-	if (ts.isIdentifier(property.name) || ts.isStringLiteral(property.name)) return property.name.text;
-}
 function literalObject(node) {
-	if (!ts.isObjectLiteralExpression(node)) return void 0;
+	if (node?.type !== "ObjectExpression") return void 0;
 	const value = Object.create(null);
 	for (const member of node.properties) {
-		if (!ts.isPropertyAssignment(member)) return void 0;
-		const key = propertyName(member);
+		if (!isPropertyAssignment(member)) return void 0;
+		const key = keyName(member.key);
 		if (key === void 0) return void 0;
-		if (ts.isStringLiteral(member.initializer) || ts.isNumericLiteral(member.initializer)) {
-			value[key] = ts.isNumericLiteral(member.initializer) ? Number(member.initializer.text) : member.initializer.text;
-			continue;
+		if (isStringLiteral(member.value) || isNumericLiteral(member.value)) value[key] = member.value.value;
+		else {
+			const nested = literalObject(member.value);
+			if (nested === void 0) return void 0;
+			value[key] = nested;
 		}
-		const nested = literalObject(member.initializer);
-		if (nested === void 0) return void 0;
-		value[key] = nested;
 	}
 	return value;
 }
@@ -46,40 +43,38 @@ function flattenLiteral(value, group, entries) {
 	return Object.entries(value).every(([key, nested]) => flattenLiteral(nested, group === "" ? key : `${group}.${key}`, entries));
 }
 function inspect(source) {
-	if (existsSync(path.join(path.dirname(source.file), "locales.json"))) return {
+	const jsonFile = path.join(path.dirname(source.file), "locales.json");
+	if (existsSync(jsonFile)) return {
 		...source,
 		convertible: false,
 		reason: "locales.json already exists"
 	};
 	const text = readFileSync(source.file, "utf8");
-	const program = ts.createSourceFile(source.file, text, ts.ScriptTarget.Latest, true);
-	const syntaxDiagnostics = ts.transpileModule(text, {
-		fileName: source.file,
-		reportDiagnostics: true
-	}).diagnostics;
-	if (syntaxDiagnostics !== void 0 && syntaxDiagnostics.length > 0) return {
+	const program = parseSourceFile(source.file, text);
+	if (parseSync(source.file, text).errors.length > 0) return {
 		...source,
 		convertible: false,
 		reason: "TypeScript syntax is invalid"
 	};
-	const [importStatement, callStatement] = program.statements;
-	if (!importStatement || !ts.isImportDeclaration(importStatement) || !ts.isStringLiteral(importStatement.moduleSpecifier) || importStatement.moduleSpecifier.text !== "@warlock.js/core" || !importStatement.importClause || importStatement.importClause.isTypeOnly || importStatement.importClause.name || !importStatement.importClause.namedBindings || !ts.isNamedImports(importStatement.importClause.namedBindings) || importStatement.importClause.namedBindings.elements.length !== 1 || importStatement.importClause.namedBindings.elements[0]?.name.text !== "groupedTranslations" || importStatement.importClause.namedBindings.elements[0]?.propertyName) return {
+	const [importStatement, callStatement] = program.body;
+	const binding = importStatement?.type === "ImportDeclaration" ? importStatement.specifiers[0] : void 0;
+	if (importStatement?.type !== "ImportDeclaration" || importStatement.source.value !== "@warlock.js/core" || importStatement.importKind === "type" || importStatement.specifiers.length !== 1 || binding?.type !== "ImportSpecifier" || binding.importKind === "type" || binding.local.name !== "groupedTranslations" || valueText(binding.imported) !== "groupedTranslations") return {
 		...source,
 		convertible: false,
 		reason: "must import only groupedTranslations from @warlock.js/core"
 	};
-	if (program.statements.length !== 2) return {
+	if (program.body.length !== 2) return {
 		...source,
 		convertible: false,
 		reason: "must contain only the groupedTranslations import and one call"
 	};
-	if (!callStatement || !ts.isExpressionStatement(callStatement) || !ts.isCallExpression(callStatement.expression)) return {
+	if (!callStatement || !isExpressionStatement(callStatement) || callStatement.expression.type !== "CallExpression") return {
 		...source,
 		convertible: false,
 		reason: "must contain one top-level groupedTranslations call"
 	};
 	const call = callStatement.expression;
-	if (!ts.isIdentifier(call.expression) || call.expression.text !== "groupedTranslations" || call.arguments.length !== 2 || !ts.isStringLiteral(call.arguments[0])) return {
+	if (!isIdentifier(call.callee) || valueText(call.callee) !== "groupedTranslations" || call.arguments.length !== 2 || !call.arguments[0] || !isStringLiteral(call.arguments[0])) return {
 		...source,
 		convertible: false,
 		reason: "must call groupedTranslations with a string group and object"
@@ -90,7 +85,7 @@ function inspect(source) {
 		convertible: false,
 		reason: "translation object must contain only literal keys, objects, strings, or numbers"
 	};
-	const group = call.arguments[0].text;
+	const group = call.arguments[0].value;
 	const entries = Object.create(null);
 	if (!flattenLiteral(dictionary, group, entries)) return {
 		...source,
@@ -167,5 +162,5 @@ const localesTsDeprecatedCheck = {
 };
 
 //#endregion
-export { fixLocaleSources, localesTsDeprecatedCheck };
+export { fixLocaleSources, inspectLocaleSources, localesTsDeprecatedCheck };
 //# sourceMappingURL=locales-ts-deprecated.check.mjs.map