@warlock.js/core 5.29.0 → 5.31.0

package/esm/tooling/check/run-check.d.mts

@@ -0,0 +1,35 @@
+import { GitRunner } from "./changed-files.mjs";
+import { CheckReport, CheckStepName } from "./check-report.types.mjs";
+import { TypecheckOptions, TypecheckResult } from "../typecheck/run-typecheck.mjs";
+import { VitestRunner } from "./tests-step.mjs";
+
+//#region ../../packages/core/src/tooling/check/run-check.d.ts
+/** Runs the typecheck step. The CLI swaps in a child process so a heap overflow cannot end `check`. */
+type TypecheckRunner = (options: TypecheckOptions) => Promise<TypecheckResult> | TypecheckResult;
+/** Inputs of {@link runCheck}. */
+type CheckOptions = {
+  /** Project root. Default: `process.cwd()`. */cwd?: string; /** Limit every step to the files changed against `base` (default HEAD) plus untracked files. */
+  changed?: boolean; /** Compare with `git merge-base <base> HEAD` instead of HEAD. Implies `changed`. */
+  base?: string; /** Steps not to run. */
+  skip?: readonly CheckStepName[]; /** tsconfig path, relative to `cwd`. Default: `tsconfig.json`. */
+  project?: string; /** How git is run. */
+  git?: GitRunner; /** How the typecheck runs. Default: in this process. */
+  typecheck?: TypecheckRunner; /** How vitest runs. */
+  vitest?: VitestRunner; /** Where the app's vitest CLI is. Default: resolved from the app root. */
+  vitestBinary?: string | null; /** The Node.js version to check. Default: the running one. */
+  nodeVersion?: string;
+};
+/**
+ * The single verify command: typecheck, lint, the tests affected by the
+ * change, and the framework's convention checks, as one report with one entry
+ * per problem and an exit code that tells "your code" (1) from "this machine"
+ * (2).
+ *
+ * Every step runs even when an earlier one failed, so one run lists every
+ * problem. The only exception: with `changed`, a git failure leaves no file
+ * list, and every step after `environment` is `blocked`.
+ */
+declare function runCheck(options?: CheckOptions): Promise<CheckReport>;
+//#endregion
+export { CheckOptions, TypecheckRunner, runCheck };
+//# sourceMappingURL=run-check.d.mts.map

package/esm/tooling/check/run-check.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-check.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-check.ts"],"mappings":";;;;;;;KA8BY,eAAA,IACV,OAAA,EAAS,gBAAA,KACN,OAAA,CAAQ,eAAA,IAAmB,eAAA;AAFhC;AAAA,KAKY,YAAA;gDAEV,GAAA,WALW;EAOX,OAAA,YAP8B;EAS9B,IAAA,WAT6C;EAW7C,IAAA,YAAgB,aAAA,IAZhB;EAcA,OAAA,WAbW;EAeX,GAAA,GAAM,SAAA,EAfuC;EAiB7C,SAAA,GAAY,eAAA,EAdF;EAgBV,MAAA,GAAS,YAAA;EAET,YAAA,kBANM;EAQN,WAAA;AAAA;;;;;;;;;;;iBA4BoB,QAAA,CAAS,OAAA,GAAS,YAAA,GAAoB,OAAA,CAAQ,WAAA"}

package/esm/tooling/check/run-check.mjs

@@ -0,0 +1,192 @@
+import { CHECK_STEPS, checkExitCode } from "./check-report.types.mjs";
+import { createProblem } from "../problem.mjs";
+import { runTypecheck } from "../typecheck/run-typecheck.mjs";
+import { listChangedFiles } from "./changed-files.mjs";
+import { runConventions } from "./conventions-step.mjs";
+import { checkNodeVersion } from "./environment-step.mjs";
+import { runLint } from "./lint-step.mjs";
+import { listSourceFiles, listTestFiles } from "./source-files.mjs";
+import { findVitest, parseVitestReport, runVitest, vitestArguments, vitestRunFailure } from "./tests-step.mjs";
+import path from "node:path";
+
+//#region ../../packages/core/src/tooling/check/run-check.ts
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function statusOf(problems) {
+	const errors = problems.filter((problem) => problem.severity === "error");
+	if (errors.some((problem) => problem.category === "environment")) return "blocked";
+	return errors.length > 0 ? "failed" : "passed";
+}
+/**
+* The single verify command: typecheck, lint, the tests affected by the
+* change, and the framework's convention checks, as one report with one entry
+* per problem and an exit code that tells "your code" (1) from "this machine"
+* (2).
+*
+* Every step runs even when an earlier one failed, so one run lists every
+* problem. The only exception: with `changed`, a git failure leaves no file
+* list, and every step after `environment` is `blocked`.
+*/
+async function runCheck(options = {}) {
+	const cwd = path.resolve(options.cwd ?? process.cwd());
+	const changed = options.changed === true || options.base !== void 0;
+	const skip = new Set(options.skip ?? []);
+	const steps = [];
+	const problems = [];
+	let files = null;
+	let filesBlocked = false;
+	const run = async (name, body) => {
+		const startedAt = Date.now();
+		if (skip.has(name)) {
+			steps.push({
+				name,
+				status: "skipped",
+				durationMs: 0,
+				detail: "skipped with --skip"
+			});
+			return;
+		}
+		if (filesBlocked && name !== "environment") {
+			steps.push({
+				name,
+				status: "blocked",
+				durationMs: 0,
+				detail: "the changed files could not be listed"
+			});
+			return;
+		}
+		let outcome;
+		try {
+			outcome = await body();
+		} catch (error) {
+			outcome = {
+				detail: null,
+				problems: [createProblem({
+					code: "WL8007",
+					source: "environment",
+					message: `The ${name} step crashed: ${errorMessage(error)}`
+				})]
+			};
+		}
+		problems.push(...outcome.problems);
+		steps.push({
+			name,
+			status: outcome.status ?? statusOf(outcome.problems),
+			durationMs: Date.now() - startedAt,
+			detail: outcome.detail
+		});
+	};
+	await run("environment", async () => {
+		const found = checkNodeVersion(cwd, options.nodeVersion);
+		if (changed) {
+			const listed = await listChangedFiles({
+				cwd,
+				base: options.base,
+				git: options.git
+			});
+			if ("problem" in listed) {
+				filesBlocked = true;
+				found.push(listed.problem);
+			} else files = listed.files;
+		}
+		return {
+			detail: `Node ${options.nodeVersion ?? process.versions.node}${files ? `, ${files.length} changed file(s)` : ""}`,
+			problems: found
+		};
+	});
+	const targets = async () => files ?? await listSourceFiles(cwd);
+	await run("typecheck", async () => {
+		if (files !== null && files.length === 0) return {
+			status: "skipped",
+			detail: "no changed files",
+			problems: []
+		};
+		const result = await (options.typecheck ?? runTypecheck)({
+			cwd,
+			project: options.project,
+			...files !== null ? { files } : {}
+		});
+		return {
+			detail: `${result.checkedFiles} file(s) checked in ${result.durationMs}ms`,
+			problems: result.problems
+		};
+	});
+	await run("lint", async () => {
+		const lintFiles = await targets();
+		if (lintFiles.length === 0) return {
+			status: "skipped",
+			detail: "no files to lint",
+			problems: []
+		};
+		const { linters, problems: found } = await runLint(cwd, lintFiles);
+		if (linters.length === 0) return {
+			status: "skipped",
+			detail: "no ESLint or oxlint config",
+			problems: []
+		};
+		return {
+			detail: `${linters.join(" + ")} over ${lintFiles.length} file(s)`,
+			problems: found
+		};
+	});
+	await run("tests", async () => {
+		if (files !== null && files.length === 0) return {
+			status: "skipped",
+			detail: "no changed files",
+			problems: []
+		};
+		const binary = options.vitestBinary === void 0 ? findVitest(cwd) : options.vitestBinary;
+		if (!binary) {
+			if ((await listTestFiles(cwd)).length === 0) return {
+				status: "skipped",
+				detail: "no test files",
+				problems: []
+			};
+			return {
+				detail: null,
+				problems: [createProblem({
+					code: "WL8002",
+					source: "environment",
+					message: "The project has test files but vitest is not installed in the app."
+				})]
+			};
+		}
+		const outcome = await (options.vitest ?? runVitest)(binary, vitestArguments(files), cwd);
+		const found = outcome.report === void 0 ? vitestRunFailure(outcome) : parseVitestReport(outcome.report, cwd);
+		const total = typeof outcome.report === "object" && outcome.report !== null ? Reflect.get(outcome.report, "numTotalTests") : void 0;
+		return {
+			detail: typeof total === "number" ? `${total} test(s) ran` : null,
+			problems: found
+		};
+	});
+	await run("conventions", async () => {
+		const conventionFiles = await targets();
+		return {
+			detail: `${conventionFiles.length} file(s) checked`,
+			problems: runConventions(cwd, conventionFiles, options.project)
+		};
+	});
+	steps.sort((first, second) => CHECK_STEPS.indexOf(first.name) - CHECK_STEPS.indexOf(second.name));
+	const exitCode = checkExitCode(problems);
+	const errors = problems.filter((problem) => problem.severity === "error");
+	return {
+		schemaVersion: 1,
+		ok: exitCode === 0,
+		exitCode,
+		changed,
+		files,
+		steps,
+		problems,
+		summary: {
+			errors: errors.length,
+			warnings: problems.length - errors.length,
+			code: errors.filter((problem) => problem.category === "code").length,
+			environment: errors.filter((problem) => problem.category === "environment").length
+		}
+	};
+}
+
+//#endregion
+export { runCheck };
+//# sourceMappingURL=run-check.mjs.map

package/esm/tooling/check/run-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-check.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-check.ts"],"sourcesContent":["import path from \"node:path\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\nimport {\n  runTypecheck,\n  type TypecheckOptions,\n  type TypecheckResult,\n} from \"../typecheck/run-typecheck\";\nimport { type GitRunner, listChangedFiles } from \"./changed-files\";\nimport {\n  CHECK_STEPS,\n  type CheckReport,\n  type CheckStep,\n  type CheckStepName,\n  type CheckStepStatus,\n  checkExitCode,\n} from \"./check-report.types\";\nimport { runConventions } from \"./conventions-step\";\nimport { checkNodeVersion } from \"./environment-step\";\nimport { runLint } from \"./lint-step\";\nimport { listSourceFiles, listTestFiles } from \"./source-files\";\nimport {\n  findVitest,\n  parseVitestReport,\n  runVitest,\n  type VitestRunner,\n  vitestArguments,\n  vitestRunFailure,\n} from \"./tests-step\";\n\n/** Runs the typecheck step. The CLI swaps in a child process so a heap overflow cannot end `check`. */\nexport type TypecheckRunner = (\n  options: TypecheckOptions,\n) => Promise<TypecheckResult> | TypecheckResult;\n\n/** Inputs of {@link runCheck}. */\nexport type CheckOptions = {\n  /** Project root. Default: `process.cwd()`. */\n  cwd?: string;\n  /** Limit every step to the files changed against `base` (default HEAD) plus untracked files. */\n  changed?: boolean;\n  /** Compare with `git merge-base <base> HEAD` instead of HEAD. Implies `changed`. */\n  base?: string;\n  /** Steps not to run. */\n  skip?: readonly CheckStepName[];\n  /** tsconfig path, relative to `cwd`. Default: `tsconfig.json`. */\n  project?: string;\n  /** How git is run. */\n  git?: GitRunner;\n  /** How the typecheck runs. Default: in this process. */\n  typecheck?: TypecheckRunner;\n  /** How vitest runs. */\n  vitest?: VitestRunner;\n  /** Where the app's vitest CLI is. Default: resolved from the app root. */\n  vitestBinary?: string | null;\n  /** The Node.js version to check. Default: the running one. */\n  nodeVersion?: string;\n};\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction statusOf(problems: readonly ToolingProblem[]): CheckStepStatus {\n  const errors = problems.filter((problem) => problem.severity === \"error\");\n\n  if (errors.some((problem) => problem.category === \"environment\")) return \"blocked\";\n\n  return errors.length > 0 ? \"failed\" : \"passed\";\n}\n\n/** Bundles one step's timing, status and problems. */\ntype StepOutcome = { status?: CheckStepStatus; detail: string | null; problems: ToolingProblem[] };\n\n/**\n * The single verify command: typecheck, lint, the tests affected by the\n * change, and the framework's convention checks, as one report with one entry\n * per problem and an exit code that tells \"your code\" (1) from \"this machine\"\n * (2).\n *\n * Every step runs even when an earlier one failed, so one run lists every\n * problem. The only exception: with `changed`, a git failure leaves no file\n * list, and every step after `environment` is `blocked`.\n */\nexport async function runCheck(options: CheckOptions = {}): Promise<CheckReport> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const changed = options.changed === true || options.base !== undefined;\n  const skip = new Set(options.skip ?? []);\n  const steps: CheckStep[] = [];\n  const problems: ToolingProblem[] = [];\n  let files: string[] | null = null;\n  let filesBlocked = false;\n\n  const run = async (name: CheckStepName, body: () => Promise<StepOutcome> | StepOutcome) => {\n    const startedAt = Date.now();\n\n    if (skip.has(name)) {\n      steps.push({ name, status: \"skipped\", durationMs: 0, detail: \"skipped with --skip\" });\n      return;\n    }\n\n    if (filesBlocked && name !== \"environment\") {\n      steps.push({\n        name,\n        status: \"blocked\",\n        durationMs: 0,\n        detail: \"the changed files could not be listed\",\n      });\n      return;\n    }\n\n    let outcome: StepOutcome;\n\n    try {\n      outcome = await body();\n    } catch (error) {\n      outcome = {\n        detail: null,\n        problems: [\n          createProblem({\n            code: \"WL8007\",\n            source: \"environment\",\n            message: `The ${name} step crashed: ${errorMessage(error)}`,\n          }),\n        ],\n      };\n    }\n\n    problems.push(...outcome.problems);\n    steps.push({\n      name,\n      status: outcome.status ?? statusOf(outcome.problems),\n      durationMs: Date.now() - startedAt,\n      detail: outcome.detail,\n    });\n  };\n\n  await run(\"environment\", async () => {\n    const found = checkNodeVersion(cwd, options.nodeVersion);\n\n    if (changed) {\n      const listed = await listChangedFiles({ cwd, base: options.base, git: options.git });\n\n      if (\"problem\" in listed) {\n        filesBlocked = true;\n        found.push(listed.problem);\n      } else {\n        files = listed.files;\n      }\n    }\n\n    return {\n      detail: `Node ${options.nodeVersion ?? process.versions.node}${files ? `, ${files.length} changed file(s)` : \"\"}`,\n      problems: found,\n    };\n  });\n\n  const targets = async (): Promise<string[]> => files ?? (await listSourceFiles(cwd));\n\n  await run(\"typecheck\", async () => {\n    if (files !== null && files.length === 0) {\n      return { status: \"skipped\", detail: \"no changed files\", problems: [] };\n    }\n\n    const typecheck = options.typecheck ?? runTypecheck;\n    const result = await typecheck({\n      cwd,\n      project: options.project,\n      ...(files !== null ? { files } : {}),\n    });\n\n    return {\n      detail: `${result.checkedFiles} file(s) checked in ${result.durationMs}ms`,\n      problems: result.problems,\n    };\n  });\n\n  await run(\"lint\", async () => {\n    const lintFiles = await targets();\n\n    if (lintFiles.length === 0) {\n      return { status: \"skipped\", detail: \"no files to lint\", problems: [] };\n    }\n\n    const { linters, problems: found } = await runLint(cwd, lintFiles);\n\n    if (linters.length === 0) {\n      return { status: \"skipped\", detail: \"no ESLint or oxlint config\", problems: [] };\n    }\n\n    return { detail: `${linters.join(\" + \")} over ${lintFiles.length} file(s)`, problems: found };\n  });\n\n  await run(\"tests\", async () => {\n    if (files !== null && files.length === 0) {\n      return { status: \"skipped\", detail: \"no changed files\", problems: [] };\n    }\n\n    const binary = options.vitestBinary === undefined ? findVitest(cwd) : options.vitestBinary;\n\n    if (!binary) {\n      if ((await listTestFiles(cwd)).length === 0) {\n        return { status: \"skipped\", detail: \"no test files\", problems: [] };\n      }\n\n      return {\n        detail: null,\n        problems: [\n          createProblem({\n            code: \"WL8002\",\n            source: \"environment\",\n            message: \"The project has test files but vitest is not installed in the app.\",\n          }),\n        ],\n      };\n    }\n\n    const vitest = options.vitest ?? runVitest;\n    const outcome = await vitest(binary, vitestArguments(files), cwd);\n    const found =\n      outcome.report === undefined\n        ? vitestRunFailure(outcome)\n        : parseVitestReport(outcome.report, cwd);\n    const total =\n      typeof outcome.report === \"object\" && outcome.report !== null\n        ? Reflect.get(outcome.report, \"numTotalTests\")\n        : undefined;\n\n    return {\n      detail: typeof total === \"number\" ? `${total} test(s) ran` : null,\n      problems: found,\n    };\n  });\n\n  await run(\"conventions\", async () => {\n    const conventionFiles = await targets();\n\n    return {\n      detail: `${conventionFiles.length} file(s) checked`,\n      problems: runConventions(cwd, conventionFiles, options.project),\n    };\n  });\n\n  // Keep the declared order even if a future step is added out of sequence.\n  steps.sort((first, second) => CHECK_STEPS.indexOf(first.name) - CHECK_STEPS.indexOf(second.name));\n\n  const exitCode = checkExitCode(problems);\n  const errors = problems.filter((problem) => problem.severity === \"error\");\n\n  return {\n    schemaVersion: 1,\n    ok: exitCode === 0,\n    exitCode,\n    changed,\n    files,\n    steps,\n    problems,\n    summary: {\n      errors: errors.length,\n      warnings: problems.length - errors.length,\n      code: errors.filter((problem) => problem.category === \"code\").length,\n      environment: errors.filter((problem) => problem.category === \"environment\").length,\n    },\n  };\n}\n"],"mappings":"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"}

package/esm/tooling/check/run-tests.d.mts

@@ -0,0 +1,48 @@
+import { ToolingProblem } from "../problem.mjs";
+import { GitRunner } from "./changed-files.mjs";
+import { CheckExitCode } from "./check-report.types.mjs";
+import { VitestRunner } from "./tests-step.mjs";
+
+//#region ../../packages/core/src/tooling/check/run-tests.d.ts
+/** Inputs of {@link runTests}. Pass `files`, or `changed`, or neither (the whole suite). */
+type RunTestsOptions = {
+  /** Project root. Default: `process.cwd()`. */cwd?: string;
+  /**
+   * Project-relative files. Test files (`*.spec.ts`, `*.test.ts`) run as they
+   * are; any other file runs the tests that import it (`vitest related`).
+   */
+  files?: readonly string[]; /** Run the tests related to the files changed against `base` (default HEAD) plus untracked files. */
+  changed?: boolean; /** Compare with `git merge-base <base> HEAD`. Implies `changed`. */
+  base?: string;
+  git?: GitRunner;
+  vitest?: VitestRunner; /** Where the app's vitest CLI is. Default: resolved from the app root. */
+  vitestBinary?: string | null;
+};
+/** What {@link runTests} returns. */
+type TestRunReport = {
+  schemaVersion: 1;
+  ok: boolean; /** Same meaning as `warlock check`: 0 passed, 1 your code, 2 this machine. */
+  exitCode: CheckExitCode; /** `files` for explicit files, `changed` for a git-scoped run, `all` for the suite. */
+  mode: "files" | "changed" | "all"; /** The files the run was scoped to (project-relative), or `null` for the whole suite. */
+  files: string[] | null; /** The vitest arguments used (without the reporter flags). */
+  args: string[];
+  total: number;
+  passed: number;
+  failed: number; /** `WL7301` / `WL7302` per failure, or an environment code. */
+  problems: ToolingProblem[];
+};
+/** The vitest arguments for a scoped run: `run <tests>` for test files, `related <files> --run` otherwise. */
+declare function testRunArguments(files: readonly string[] | null): string[];
+/**
+ * Run the app's tests the way `warlock check` runs its tests step, for one
+ * file, a set of files, or the files changed in git — the loop an agent runs
+ * after editing a single file.
+ *
+ * @example
+ * const report = await runTests({ files: ["src/app/posts/services/publish.service.ts"] });
+ * report.problems.filter((problem) => problem.code === "WL7301");
+ */
+declare function runTests(options?: RunTestsOptions): Promise<TestRunReport>;
+//#endregion
+export { RunTestsOptions, TestRunReport, runTests, testRunArguments };
+//# sourceMappingURL=run-tests.d.mts.map

package/esm/tooling/check/run-tests.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-tests.ts"],"mappings":";;;;;;;KAeY,eAAA;EAAA,8CAEV,GAAA;;;;;EAKA,KAAA,sBAIA;EAFA,OAAA,YAGM;EADN,IAAA;EACA,GAAA,GAAM,SAAA;EACN,MAAA,GAAS,YAAY,EAET;EAAZ,YAAA;AAAA;;KAIU,aAAA;EACV,aAAA;EACA,EAAA;EAEA,QAAA,EAAU,aAAA,EAAA;EAEV,IAAA,+BAEA;EAAA,KAAA,mBAGA;EADA,IAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA,UAEwB;EAAxB,QAAA,EAAU,cAAc;AAAA;;iBAMV,gBAAA,CAAiB,KAA+B;;AAAA;AA+BhE;;;;;;;iBAAsB,QAAA,CAAS,OAAA,GAAS,eAAA,GAAuB,OAAA,CAAQ,aAAA"}

package/esm/tooling/check/run-tests.mjs

@@ -0,0 +1,93 @@
+import { checkExitCode } from "./check-report.types.mjs";
+import { createProblem } from "../problem.mjs";
+import { listChangedFiles } from "./changed-files.mjs";
+import { listTestFiles } from "./source-files.mjs";
+import { findVitest, parseVitestReport, runVitest, vitestArguments, vitestRunFailure } from "./tests-step.mjs";
+import path from "node:path";
+
+//#region ../../packages/core/src/tooling/check/run-tests.ts
+const TEST_FILE = /\.(spec|test)\.[cm]?[jt]sx?$/;
+/** The vitest arguments for a scoped run: `run <tests>` for test files, `related <files> --run` otherwise. */
+function testRunArguments(files) {
+	if (files !== null && files.length > 0 && files.every((file) => TEST_FILE.test(file))) return [
+		"run",
+		...files,
+		"--passWithNoTests"
+	];
+	return vitestArguments(files);
+}
+function count(report, key) {
+	if (typeof report !== "object" || report === null) return 0;
+	const value = Reflect.get(report, key);
+	return typeof value === "number" ? value : 0;
+}
+function normalize(cwd, file) {
+	return (path.isAbsolute(file) ? path.relative(cwd, file) : file).split(path.sep).join("/");
+}
+/**
+* Run the app's tests the way `warlock check` runs its tests step, for one
+* file, a set of files, or the files changed in git — the loop an agent runs
+* after editing a single file.
+*
+* @example
+* const report = await runTests({ files: ["src/app/posts/services/publish.service.ts"] });
+* report.problems.filter((problem) => problem.code === "WL7301");
+*/
+async function runTests(options = {}) {
+	const cwd = path.resolve(options.cwd ?? process.cwd());
+	const changed = options.changed === true || options.base !== void 0;
+	let mode = "all";
+	let files = null;
+	const finish = (fields) => {
+		const exitCode = checkExitCode(fields.problems);
+		return {
+			schemaVersion: 1,
+			ok: exitCode === 0,
+			exitCode,
+			mode,
+			files,
+			args: [],
+			total: 0,
+			passed: 0,
+			failed: 0,
+			...fields
+		};
+	};
+	if (options.files && options.files.length > 0) {
+		mode = "files";
+		files = options.files.map((file) => normalize(cwd, file));
+	} else if (changed) {
+		mode = "changed";
+		const listed = await listChangedFiles({
+			cwd,
+			base: options.base,
+			git: options.git
+		});
+		if ("problem" in listed) return finish({ problems: [listed.problem] });
+		files = listed.files;
+		if (files.length === 0) return finish({ problems: [] });
+	}
+	const binary = options.vitestBinary === void 0 ? findVitest(cwd) : options.vitestBinary;
+	if (!binary) {
+		if ((await listTestFiles(cwd)).length === 0) return finish({ problems: [] });
+		return finish({ problems: [createProblem({
+			code: "WL8002",
+			source: "environment",
+			message: "The project has test files but vitest is not installed in the app."
+		})] });
+	}
+	const args = testRunArguments(files);
+	const outcome = await (options.vitest ?? runVitest)(binary, args, cwd);
+	const problems = outcome.report === void 0 ? vitestRunFailure(outcome) : parseVitestReport(outcome.report, cwd);
+	return finish({
+		args,
+		total: count(outcome.report, "numTotalTests"),
+		passed: count(outcome.report, "numPassedTests"),
+		failed: count(outcome.report, "numFailedTests"),
+		problems
+	});
+}
+
+//#endregion
+export { runTests, testRunArguments };
+//# sourceMappingURL=run-tests.mjs.map

package/esm/tooling/check/run-tests.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-tests.ts"],"sourcesContent":["import path from \"node:path\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\nimport { type GitRunner, listChangedFiles } from \"./changed-files\";\nimport { type CheckExitCode, checkExitCode } from \"./check-report.types\";\nimport { listTestFiles } from \"./source-files\";\nimport {\n  findVitest,\n  parseVitestReport,\n  runVitest,\n  type VitestRunner,\n  vitestArguments,\n  vitestRunFailure,\n} from \"./tests-step\";\n\n/** Inputs of {@link runTests}. Pass `files`, or `changed`, or neither (the whole suite). */\nexport type RunTestsOptions = {\n  /** Project root. Default: `process.cwd()`. */\n  cwd?: string;\n  /**\n   * Project-relative files. Test files (`*.spec.ts`, `*.test.ts`) run as they\n   * are; any other file runs the tests that import it (`vitest related`).\n   */\n  files?: readonly string[];\n  /** Run the tests related to the files changed against `base` (default HEAD) plus untracked files. */\n  changed?: boolean;\n  /** Compare with `git merge-base <base> HEAD`. Implies `changed`. */\n  base?: string;\n  git?: GitRunner;\n  vitest?: VitestRunner;\n  /** Where the app's vitest CLI is. Default: resolved from the app root. */\n  vitestBinary?: string | null;\n};\n\n/** What {@link runTests} returns. */\nexport type TestRunReport = {\n  schemaVersion: 1;\n  ok: boolean;\n  /** Same meaning as `warlock check`: 0 passed, 1 your code, 2 this machine. */\n  exitCode: CheckExitCode;\n  /** `files` for explicit files, `changed` for a git-scoped run, `all` for the suite. */\n  mode: \"files\" | \"changed\" | \"all\";\n  /** The files the run was scoped to (project-relative), or `null` for the whole suite. */\n  files: string[] | null;\n  /** The vitest arguments used (without the reporter flags). */\n  args: string[];\n  total: number;\n  passed: number;\n  failed: number;\n  /** `WL7301` / `WL7302` per failure, or an environment code. */\n  problems: ToolingProblem[];\n};\n\nconst TEST_FILE = /\\.(spec|test)\\.[cm]?[jt]sx?$/;\n\n/** The vitest arguments for a scoped run: `run <tests>` for test files, `related <files> --run` otherwise. */\nexport function testRunArguments(files: readonly string[] | null): string[] {\n  if (files !== null && files.length > 0 && files.every((file) => TEST_FILE.test(file))) {\n    return [\"run\", ...files, \"--passWithNoTests\"];\n  }\n\n  return vitestArguments(files);\n}\n\nfunction count(report: unknown, key: string): number {\n  if (typeof report !== \"object\" || report === null) return 0;\n\n  const value = Reflect.get(report, key);\n\n  return typeof value === \"number\" ? value : 0;\n}\n\nfunction normalize(cwd: string, file: string): string {\n  const relative = path.isAbsolute(file) ? path.relative(cwd, file) : file;\n\n  return relative.split(path.sep).join(\"/\");\n}\n\n/**\n * Run the app's tests the way `warlock check` runs its tests step, for one\n * file, a set of files, or the files changed in git — the loop an agent runs\n * after editing a single file.\n *\n * @example\n * const report = await runTests({ files: [\"src/app/posts/services/publish.service.ts\"] });\n * report.problems.filter((problem) => problem.code === \"WL7301\");\n */\nexport async function runTests(options: RunTestsOptions = {}): Promise<TestRunReport> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const changed = options.changed === true || options.base !== undefined;\n  let mode: TestRunReport[\"mode\"] = \"all\";\n  let files: string[] | null = null;\n\n  const finish = (\n    fields: Partial<TestRunReport> & { problems: ToolingProblem[] },\n  ): TestRunReport => {\n    const exitCode = checkExitCode(fields.problems);\n\n    return {\n      schemaVersion: 1,\n      ok: exitCode === 0,\n      exitCode,\n      mode,\n      files,\n      args: [],\n      total: 0,\n      passed: 0,\n      failed: 0,\n      ...fields,\n    };\n  };\n\n  if (options.files && options.files.length > 0) {\n    mode = \"files\";\n    files = options.files.map((file) => normalize(cwd, file));\n  } else if (changed) {\n    mode = \"changed\";\n\n    const listed = await listChangedFiles({ cwd, base: options.base, git: options.git });\n\n    if (\"problem\" in listed) return finish({ problems: [listed.problem] });\n\n    files = listed.files;\n\n    if (files.length === 0) return finish({ problems: [] });\n  }\n\n  const binary = options.vitestBinary === undefined ? findVitest(cwd) : options.vitestBinary;\n\n  if (!binary) {\n    if ((await listTestFiles(cwd)).length === 0) return finish({ problems: [] });\n\n    return finish({\n      problems: [\n        createProblem({\n          code: \"WL8002\",\n          source: \"environment\",\n          message: \"The project has test files but vitest is not installed in the app.\",\n        }),\n      ],\n    });\n  }\n\n  const args = testRunArguments(files);\n  const outcome = await (options.vitest ?? runVitest)(binary, args, cwd);\n  const problems =\n    outcome.report === undefined\n      ? vitestRunFailure(outcome)\n      : parseVitestReport(outcome.report, cwd);\n\n  return finish({\n    args,\n    total: count(outcome.report, \"numTotalTests\"),\n    passed: count(outcome.report, \"numPassedTests\"),\n    failed: count(outcome.report, \"numFailedTests\"),\n    problems,\n  });\n}\n"],"mappings":";;;;;;;;AAoDA,MAAM,YAAY;;AAGlB,SAAgB,iBAAiB,OAA2C;CAC1E,IAAI,UAAU,QAAQ,MAAM,SAAS,KAAK,MAAM,OAAO,SAAS,UAAU,KAAK,IAAI,CAAC,GAClF,OAAO;EAAC;EAAO,GAAG;EAAO;CAAmB;CAG9C,OAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,MAAM,QAAiB,KAAqB;CACnD,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAE1D,MAAM,QAAQ,QAAQ,IAAI,QAAQ,GAAG;CAErC,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAS,UAAU,KAAa,MAAsB;CAGpD,QAFiB,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,KAAK,IAAI,IAAI,KAErD,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;;;;;;;;;;AAWA,eAAsB,SAAS,UAA2B,CAAC,GAA2B;CACpF,MAAM,MAAM,KAAK,QAAQ,QAAQ,OAAO,QAAQ,IAAI,CAAC;CACrD,MAAM,UAAU,QAAQ,YAAY,QAAQ,QAAQ,SAAS;CAC7D,IAAI,OAA8B;CAClC,IAAI,QAAyB;CAE7B,MAAM,UACJ,WACkB;EAClB,MAAM,WAAW,cAAc,OAAO,QAAQ;EAE9C,OAAO;GACL,eAAe;GACf,IAAI,aAAa;GACjB;GACA;GACA;GACA,MAAM,CAAC;GACP,OAAO;GACP,QAAQ;GACR,QAAQ;GACR,GAAG;EACL;CACF;CAEA,IAAI,QAAQ,SAAS,QAAQ,MAAM,SAAS,GAAG;EAC7C,OAAO;EACP,QAAQ,QAAQ,MAAM,KAAK,SAAS,UAAU,KAAK,IAAI,CAAC;CAC1D,OAAO,IAAI,SAAS;EAClB,OAAO;EAEP,MAAM,SAAS,MAAM,iBAAiB;GAAE;GAAK,MAAM,QAAQ;GAAM,KAAK,QAAQ;EAAI,CAAC;EAEnF,IAAI,aAAa,QAAQ,OAAO,OAAO,EAAE,UAAU,CAAC,OAAO,OAAO,EAAE,CAAC;EAErE,QAAQ,OAAO;EAEf,IAAI,MAAM,WAAW,GAAG,OAAO,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;CACxD;CAEA,MAAM,SAAS,QAAQ,iBAAiB,SAAY,WAAW,GAAG,IAAI,QAAQ;CAE9E,IAAI,CAAC,QAAQ;EACX,KAAK,MAAM,cAAc,GAAG,EAAC,CAAE,WAAW,GAAG,OAAO,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;EAE3E,OAAO,OAAO,EACZ,UAAU,CACR,cAAc;GACZ,MAAM;GACN,QAAQ;GACR,SAAS;EACX,CAAC,CACH,EACF,CAAC;CACH;CAEA,MAAM,OAAO,iBAAiB,KAAK;CACnC,MAAM,UAAU,OAAO,QAAQ,UAAU,UAAS,CAAE,QAAQ,MAAM,GAAG;CACrE,MAAM,WACJ,QAAQ,WAAW,SACf,iBAAiB,OAAO,IACxB,kBAAkB,QAAQ,QAAQ,GAAG;CAE3C,OAAO,OAAO;EACZ;EACA,OAAO,MAAM,QAAQ,QAAQ,eAAe;EAC5C,QAAQ,MAAM,QAAQ,QAAQ,gBAAgB;EAC9C,QAAQ,MAAM,QAAQ,QAAQ,gBAAgB;EAC9C;CACF,CAAC;AACH"}