@warlock.js/core 5.31.0 → 5.33.0

package/esm/tooling/check/request-input.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"request-input.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/request-input.ts"],"sourcesContent":["import ts from \"typescript\";\nimport {\n  isMemberAccess,\n  isValueReference,\n  memberName,\n  resolveInitializer,\n  unwrap,\n  walk,\n} from \"./source-ast\";\n\n/** Identifiers the source checks treat as the incoming request. */\nexport const REQUEST_NAMES: ReadonlySet<string> = new Set([\"request\", \"req\"]);\n\n/**\n * Request members that return client-controlled input. Reading any of them\n * (as a property or a call) yields data the client chose.\n */\nconst REQUEST_INPUT_MEMBERS: ReadonlySet<string> = new Set([\n  \"all\",\n  \"allExceptParams\",\n  \"heavy\",\n  \"heavyExceptParams\",\n  \"only\",\n  \"pluck\",\n  \"except\",\n  \"input\",\n  \"get\",\n  \"email\",\n  \"string\",\n  \"int\",\n  \"bool\",\n  \"float\",\n  \"number\",\n  \"body\",\n  \"bodyInputs\",\n  \"params\",\n  \"query\",\n  \"validated\",\n  \"validatedExcept\",\n  \"idParam\",\n  \"headers\",\n  \"header\",\n  \"cookie\",\n  \"cookies\",\n  \"referer\",\n  \"referrer\",\n]);\n\n/** Request members that return the whole (or most of the) request body. */\nexport const REQUEST_BODY_MEMBERS: ReadonlySet<string> = new Set([\n  \"all\",\n  \"allExceptParams\",\n  \"heavy\",\n  \"heavyExceptParams\",\n  \"body\",\n  \"bodyInputs\",\n  \"validated\",\n  \"validatedExcept\",\n  \"only\",\n  \"except\",\n  \"pluck\",\n  \"headers\",\n  \"cookies\",\n]);\n\n/**\n * When `node` is `<request>.<member>` or `<request>.<member>(…)` (also through\n * `request.query.next`-style chains), the `<member>`.\n */\nexport function requestMemberAccess(node: ts.Node): string | undefined {\n  let current = unwrap(node);\n\n  if (ts.isCallExpression(current)) current = unwrap(current.expression);\n  if (!isMemberAccess(current)) return undefined;\n\n  // Walk down to the member read directly off the request: `request.query.next` → `query`.\n  let member = current;\n\n  for (;;) {\n    const object = unwrap(member.expression);\n\n    if (ts.isIdentifier(object)) {\n      return REQUEST_NAMES.has(object.text) ? memberName(member) : undefined;\n    }\n\n    if (isMemberAccess(object)) {\n      member = object;\n      continue;\n    }\n\n    if (ts.isCallExpression(object)) {\n      const callee = unwrap(object.expression);\n      if (!isMemberAccess(callee)) return undefined;\n      member = callee;\n      continue;\n    }\n\n    return undefined;\n  }\n}\n\n/** Whether `node` reads client-controlled input from the request. */\nexport function isRequestInputExpression(node: ts.Node): boolean {\n  const member = requestMemberAccess(node);\n\n  return member !== undefined && REQUEST_INPUT_MEMBERS.has(member);\n}\n\nexport type TaintOptions = {\n  /** Calls whose result is clean, whatever their arguments (matched by name). */\n  sanitizers?: ReadonlySet<string>;\n  /** Input sources besides the request (client query-string hooks, `location.search`). */\n  isSource?: (node: ts.Node) => boolean;\n};\n\nfunction isSanitizerCall(call: ts.CallExpression, sanitizers: ReadonlySet<string>): boolean {\n  const callee = unwrap(call.expression);\n\n  if (ts.isIdentifier(callee)) return sanitizers.has(callee.text);\n\n  if (isMemberAccess(callee)) {\n    const name = memberName(callee);\n    return name !== undefined && sanitizers.has(name);\n  }\n\n  return false;\n}\n\n/**\n * Whether an expression carries request input: it reads the request directly,\n * or names a local constant initialised from request input. A call to a\n * sanitizer launders its arguments.\n */\nexport function containsRequestInput(\n  node: ts.Node,\n  options: TaintOptions = {},\n  seen: Set<ts.Node> = new Set(),\n): boolean {\n  let found = false;\n  const sanitizers = options.sanitizers ?? new Set<string>();\n\n  walk(node, (child) => {\n    if (found) return false;\n\n    if (ts.isCallExpression(child) && isSanitizerCall(child, sanitizers)) return false;\n\n    if (isMemberAccess(child) || ts.isCallExpression(child)) {\n      if (isRequestInputExpression(child) || options.isSource?.(child) === true) {\n        found = true;\n        return false;\n      }\n    }\n\n    if (ts.isIdentifier(child) && !seen.has(child)) {\n      seen.add(child);\n\n      if (isValueReference(child)) {\n        const initializer = resolveInitializer(child);\n\n        if (initializer && !seen.has(initializer)) {\n          seen.add(initializer);\n\n          if (containsRequestInput(initializer, options, seen)) {\n            found = true;\n            return false;\n          }\n        }\n      }\n    }\n\n    return undefined;\n  });\n\n  return found;\n}\n"],"mappings":";;;;;AAWA,MAAa,gBAAqC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;;;;;AAM5E,MAAM,wBAA6C,IAAI,IAAI;CACzD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAa,uBAA4C,IAAI,IAAI;CAC/D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;AAMD,SAAgB,oBAAoB,MAAmC;CACrE,IAAI,UAAU,OAAO,IAAI;CAEzB,IAAI,GAAG,iBAAiB,OAAO,GAAG,UAAU,OAAO,QAAQ,UAAU;CACrE,IAAI,CAAC,eAAe,OAAO,GAAG,OAAO;CAGrC,IAAI,SAAS;CAEb,SAAS;EACP,MAAM,SAAS,OAAO,OAAO,UAAU;EAEvC,IAAI,GAAG,aAAa,MAAM,GACxB,OAAO,cAAc,IAAI,OAAO,IAAI,IAAI,WAAW,MAAM,IAAI;EAG/D,IAAI,eAAe,MAAM,GAAG;GAC1B,SAAS;GACT;EACF;EAEA,IAAI,GAAG,iBAAiB,MAAM,GAAG;GAC/B,MAAM,SAAS,OAAO,OAAO,UAAU;GACvC,IAAI,CAAC,eAAe,MAAM,GAAG,OAAO;GACpC,SAAS;GACT;EACF;EAEA;CACF;AACF;;AAGA,SAAgB,yBAAyB,MAAwB;CAC/D,MAAM,SAAS,oBAAoB,IAAI;CAEvC,OAAO,WAAW,UAAa,sBAAsB,IAAI,MAAM;AACjE;AASA,SAAS,gBAAgB,MAAyB,YAA0C;CAC1F,MAAM,SAAS,OAAO,KAAK,UAAU;CAErC,IAAI,GAAG,aAAa,MAAM,GAAG,OAAO,WAAW,IAAI,OAAO,IAAI;CAE9D,IAAI,eAAe,MAAM,GAAG;EAC1B,MAAM,OAAO,WAAW,MAAM;EAC9B,OAAO,SAAS,UAAa,WAAW,IAAI,IAAI;CAClD;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,qBACd,MACA,UAAwB,CAAC,GACzB,uBAAqB,IAAI,IAAI,GACpB;CACT,IAAI,QAAQ;CACZ,MAAM,aAAa,QAAQ,8BAAc,IAAI,IAAY;CAEzD,KAAK,OAAO,UAAU;EACpB,IAAI,OAAO,OAAO;EAElB,IAAI,GAAG,iBAAiB,KAAK,KAAK,gBAAgB,OAAO,UAAU,GAAG,OAAO;EAE7E,IAAI,eAAe,KAAK,KAAK,GAAG,iBAAiB,KAAK,GACpD;OAAI,yBAAyB,KAAK,KAAK,QAAQ,WAAW,KAAK,MAAM,MAAM;IACzE,QAAQ;IACR,OAAO;GACT;;EAGF,IAAI,GAAG,aAAa,KAAK,KAAK,CAAC,KAAK,IAAI,KAAK,GAAG;GAC9C,KAAK,IAAI,KAAK;GAEd,IAAI,iBAAiB,KAAK,GAAG;IAC3B,MAAM,cAAc,mBAAmB,KAAK;IAE5C,IAAI,eAAe,CAAC,KAAK,IAAI,WAAW,GAAG;KACzC,KAAK,IAAI,WAAW;KAEpB,IAAI,qBAAqB,aAAa,SAAS,IAAI,GAAG;MACpD,QAAQ;MACR,OAAO;KACT;IACF;GACF;EACF;CAGF,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"request-input.mjs","names":["ast.isCallExpression","ast.expressionOf","ast.isIdentifier","ast.valueText"],"sources":["../../../../../../../../../packages/core/src/tooling/check/request-input.ts"],"sourcesContent":["import * as ast from \"../syntax/ast\";\nimport {\n  isMemberAccess,\n  isValueReference,\n  memberName,\n  resolveInitializer,\n  unwrap,\n  walk,\n} from \"./source-ast\";\n\n/** Identifiers the source checks treat as the incoming request. */\nexport const REQUEST_NAMES: ReadonlySet<string> = new Set([\"request\", \"req\"]);\n\n/**\n * Request members that return client-controlled input. Reading any of them\n * (as a property or a call) yields data the client chose.\n */\nconst REQUEST_INPUT_MEMBERS: ReadonlySet<string> = new Set([\n  \"all\",\n  \"allExceptParams\",\n  \"heavy\",\n  \"heavyExceptParams\",\n  \"only\",\n  \"pluck\",\n  \"except\",\n  \"input\",\n  \"get\",\n  \"email\",\n  \"string\",\n  \"int\",\n  \"bool\",\n  \"float\",\n  \"number\",\n  \"body\",\n  \"bodyInputs\",\n  \"params\",\n  \"query\",\n  \"validated\",\n  \"validatedExcept\",\n  \"idParam\",\n  \"headers\",\n  \"header\",\n  \"cookie\",\n  \"cookies\",\n  \"referer\",\n  \"referrer\",\n]);\n\n/** Request members that return the whole (or most of the) request body. */\nexport const REQUEST_BODY_MEMBERS: ReadonlySet<string> = new Set([\n  \"all\",\n  \"allExceptParams\",\n  \"heavy\",\n  \"heavyExceptParams\",\n  \"body\",\n  \"bodyInputs\",\n  \"validated\",\n  \"validatedExcept\",\n  \"only\",\n  \"except\",\n  \"pluck\",\n  \"headers\",\n  \"cookies\",\n]);\n\n/**\n * When `node` is `<request>.<member>` or `<request>.<member>(…)` (also through\n * `request.query.next`-style chains), the `<member>`.\n */\nexport function requestMemberAccess(node: ast.Node): string | undefined {\n  let current = unwrap(node);\n\n  if (ast.isCallExpression(current)) current = unwrap(ast.expressionOf(current));\n  if (!isMemberAccess(current)) return undefined;\n\n  // Walk down to the member read directly off the request: `request.query.next` → `query`.\n  let member = current;\n\n  for (;;) {\n    const object = unwrap(ast.expressionOf(member));\n\n    if (ast.isIdentifier(object)) {\n      return REQUEST_NAMES.has(ast.valueText(object)) ? memberName(member) : undefined;\n    }\n\n    if (isMemberAccess(object)) {\n      member = object;\n      continue;\n    }\n\n    if (ast.isCallExpression(object)) {\n      const callee = unwrap(ast.expressionOf(object));\n      if (!isMemberAccess(callee)) return undefined;\n      member = callee;\n      continue;\n    }\n\n    return undefined;\n  }\n}\n\n/** Whether `node` reads client-controlled input from the request. */\nexport function isRequestInputExpression(node: ast.Node): boolean {\n  const member = requestMemberAccess(node);\n\n  return member !== undefined && REQUEST_INPUT_MEMBERS.has(member);\n}\n\nexport type TaintOptions = {\n  /** Calls whose result is clean, whatever their arguments (matched by name). */\n  sanitizers?: ReadonlySet<string>;\n  /** Input sources besides the request (client query-string hooks, `location.search`). */\n  isSource?: (node: ast.Node) => boolean;\n};\n\nfunction isSanitizerCall(call: ast.CallExpression, sanitizers: ReadonlySet<string>): boolean {\n  const callee = unwrap(ast.expressionOf(call));\n\n  if (ast.isIdentifier(callee)) return sanitizers.has(ast.valueText(callee));\n\n  if (isMemberAccess(callee)) {\n    const name = memberName(callee);\n    return name !== undefined && sanitizers.has(name);\n  }\n\n  return false;\n}\n\n/**\n * Whether an expression carries request input: it reads the request directly,\n * or names a local constant initialised from request input. A call to a\n * sanitizer launders its arguments.\n */\nexport function containsRequestInput(\n  node: ast.Node,\n  options: TaintOptions = {},\n  seen: Set<ast.Node> = new Set(),\n): boolean {\n  let found = false;\n  const sanitizers = options.sanitizers ?? new Set<string>();\n\n  walk(node, (child) => {\n    if (found) return false;\n\n    if (ast.isCallExpression(child) && isSanitizerCall(child, sanitizers)) return false;\n\n    if (isMemberAccess(child) || ast.isCallExpression(child)) {\n      if (isRequestInputExpression(child) || options.isSource?.(child) === true) {\n        found = true;\n        return false;\n      }\n    }\n\n    if (ast.isIdentifier(child) && !seen.has(child)) {\n      seen.add(child);\n\n      if (isValueReference(child)) {\n        const initializer = resolveInitializer(child);\n\n        if (initializer && !seen.has(initializer)) {\n          seen.add(initializer);\n\n          if (containsRequestInput(initializer, options, seen)) {\n            found = true;\n            return false;\n          }\n        }\n      }\n    }\n\n    return undefined;\n  });\n\n  return found;\n}\n"],"mappings":";;;;;AAWA,MAAa,gCAAqC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;;;;;AAM5E,MAAM,wCAA6C,IAAI,IAAI;CACzD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAa,uCAA4C,IAAI,IAAI;CAC/D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;AAMD,SAAgB,oBAAoB,MAAoC;CACtE,IAAI,UAAU,OAAO,IAAI;CAEzB,IAAIA,iBAAqB,OAAO,GAAG,UAAU,OAAOC,aAAiB,OAAO,CAAC;CAC7E,IAAI,CAAC,eAAe,OAAO,GAAG,OAAO;CAGrC,IAAI,SAAS;CAEb,SAAS;EACP,MAAM,SAAS,OAAOA,aAAiB,MAAM,CAAC;EAE9C,IAAIC,aAAiB,MAAM,GACzB,OAAO,cAAc,IAAIC,UAAc,MAAM,CAAC,IAAI,WAAW,MAAM,IAAI;EAGzE,IAAI,eAAe,MAAM,GAAG;GAC1B,SAAS;GACT;EACF;EAEA,IAAIH,iBAAqB,MAAM,GAAG;GAChC,MAAM,SAAS,OAAOC,aAAiB,MAAM,CAAC;GAC9C,IAAI,CAAC,eAAe,MAAM,GAAG,OAAO;GACpC,SAAS;GACT;EACF;EAEA;CACF;AACF;;AAGA,SAAgB,yBAAyB,MAAyB;CAChE,MAAM,SAAS,oBAAoB,IAAI;CAEvC,OAAO,WAAW,UAAa,sBAAsB,IAAI,MAAM;AACjE;AASA,SAAS,gBAAgB,MAA0B,YAA0C;CAC3F,MAAM,SAAS,OAAOA,aAAiB,IAAI,CAAC;CAE5C,IAAIC,aAAiB,MAAM,GAAG,OAAO,WAAW,IAAIC,UAAc,MAAM,CAAC;CAEzE,IAAI,eAAe,MAAM,GAAG;EAC1B,MAAM,OAAO,WAAW,MAAM;EAC9B,OAAO,SAAS,UAAa,WAAW,IAAI,IAAI;CAClD;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,qBACd,MACA,UAAwB,CAAC,GACzB,uBAAsB,IAAI,IAAI,GACrB;CACT,IAAI,QAAQ;CACZ,MAAM,aAAa,QAAQ,8BAAc,IAAI,IAAY;CAEzD,KAAK,OAAO,UAAU;EACpB,IAAI,OAAO,OAAO;EAElB,IAAIH,iBAAqB,KAAK,KAAK,gBAAgB,OAAO,UAAU,GAAG,OAAO;EAE9E,IAAI,eAAe,KAAK,KAAKA,iBAAqB,KAAK,GACrD;OAAI,yBAAyB,KAAK,KAAK,QAAQ,WAAW,KAAK,MAAM,MAAM;IACzE,QAAQ;IACR,OAAO;GACT;;EAGF,IAAIE,aAAiB,KAAK,KAAK,CAAC,KAAK,IAAI,KAAK,GAAG;GAC/C,KAAK,IAAI,KAAK;GAEd,IAAI,iBAAiB,KAAK,GAAG;IAC3B,MAAM,cAAc,mBAAmB,KAAK;IAE5C,IAAI,eAAe,CAAC,KAAK,IAAI,WAAW,GAAG;KACzC,KAAK,IAAI,WAAW;KAEpB,IAAI,qBAAqB,aAAa,SAAS,IAAI,GAAG;MACpD,QAAQ;MACR,OAAO;KACT;IACF;GACF;EACF;CAGF,CAAC;CAED,OAAO;AACT"}

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

@@ -2,21 +2,32 @@ 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;
+export 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. */
+export type CheckOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** Oxlint by default; ESLint is deprecated and requires explicit selection. */
+  lint?: "oxlint" | "eslint";
+  /** 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;
 };
 /**
@@ -29,7 +40,6 @@ type CheckOptions = {
  * 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>;
+export 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

@@ -1 +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"}
+{"version":3,"file":"run-check.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-check.ts"],"mappings":";;;;;;YA8BY,mBACV,SAAS,qBACN,QAAQ,mBAAmB;;YAGpB;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA,gBAAgB;;EAEhB;;EAEA,MAAM;;EAEN,YAAY;;EAEZ,SAAS;;EAET;;EAEA;;;;;;;;;;;;wBA4BoB,SAAS,UAAS,eAAoB,QAAQ"}

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

@@ -119,10 +119,10 @@ async function runCheck(options = {}) {
 			detail: "no files to lint",
 			problems: []
 		};
-		const { linters, problems: found } = await runLint(cwd, lintFiles);
+		const { linters, problems: found } = await runLint(cwd, lintFiles, options.lint);
 		if (linters.length === 0) return {
 			status: "skipped",
-			detail: "no ESLint or oxlint config",
+			detail: "no Oxlint config (ESLint requires --lint eslint)",
 			problems: []
 		};
 		return {

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

@@ -1 +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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"}
+{"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  /** Oxlint by default; ESLint is deprecated and requires explicit selection. */\n  lint?: \"oxlint\" | \"eslint\";\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, options.lint);\n\n    if (linters.length === 0) {\n      return {\n        status: \"skipped\",\n        detail: \"no Oxlint config (ESLint requires --lint eslint)\",\n        problems: [],\n      };\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

@@ -2,37 +2,45 @@ 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;
+export 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`. */
+  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. */
+  vitest?: VitestRunner;
+  /** Where the app's vitest CLI is. Default: resolved from the app root. */
   vitestBinary?: string | null;
 };
 /** What {@link runTests} returns. */
-type TestRunReport = {
+export 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). */
+  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. */
+  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[];
+export 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
@@ -42,7 +50,6 @@ declare function testRunArguments(files: readonly string[] | null): string[];
  * 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>;
+export 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

@@ -1 +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"}
+{"version":3,"file":"run-tests.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/run-tests.ts"],"mappings":";;;;;;YAeY;;EAEV;;;;;EAKA;;EAEA;;EAEA;EACA,MAAM;EACN,SAAS;;EAET;;;YAIU;EACV;EACA;;EAEA,UAAU;;EAEV;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA,UAAU;;;wBAMI,iBAAiB;;;;;;;;;;wBA+BX,SAAS,UAAS,kBAAuB,QAAQ"}