@warlock.js/core 5.30.0 → 5.32.0

package/esm/tooling/generate/generator-spec.d.mts

@@ -0,0 +1,57 @@
+//#region ../../packages/core/src/tooling/generate/generator-spec.d.ts
+/**
+ * What a generation request names, and the `warlock` argv it becomes.
+ *
+ * Validated strictly because the request usually comes from an agent over MCP:
+ * only the generators and flags `warlock generate.*` / `warlock add` declare
+ * are accepted, and no value can be read as another flag.
+ */
+/** The `warlock generate.<name>` scaffolders. */
+export declare const MAKE_GENERATORS: readonly ["module", "controller", "service", "use-case", "model", "repository", "resource", "migration"];
+/** One `warlock generate.<name>` scaffolder. */
+export type MakeGenerator = (typeof MAKE_GENERATORS)[number];
+/**
+ * The flags each generator declares (see `cli/commands/generate/generate.command.ts`),
+ * minus `--dry-run`: the sandbox generates for real into a throwaway copy.
+ */
+export declare const MAKE_GENERATOR_FLAGS: Readonly<Record<MakeGenerator, readonly string[]>>;
+/**
+ * A generation request.
+ *
+ * - `make`: `warlock generate.<generator> <name> [--flag…]`; `name` is what the
+ *   command takes (`users`, `users/create-user`, a model path for `migration`).
+ * - `add`: `warlock add <features…>`.
+ */
+export type GeneratorSpec = {
+  type: "make";
+  generator: MakeGenerator;
+  name: string;
+  /** `true` → `--flag`, `false` → `--flag=false`, a string → `--flag=value`. */
+  flags?: Record<string, string | boolean>;
+} | {
+  type: "add";
+  features: string[];
+};
+/** Options of {@link buildGeneratorArgs}. */
+export type GeneratorArgsOptions = {
+  /**
+   * For `add`: install the packages (`false` adds `--no-install`, which still
+   * records them in package.json). Default `false`.
+   */
+  install?: boolean;
+};
+/** Whether a string names a `warlock generate.*` scaffolder. */
+export declare function isMakeGenerator(value: string): value is MakeGenerator;
+/**
+ * The `warlock` arguments (without the `warlock` itself) that run a spec.
+ * Throws on an unknown generator, flag or feature, or an unsafe name or value.
+ *
+ * @example
+ * buildGeneratorArgs({ type: "make", generator: "controller", name: "users/list-users", flags: { "with-validation": true } });
+ * // ["generate.controller", "users/list-users", "--with-validation"]
+ * buildGeneratorArgs({ type: "add", features: ["devtools"] });
+ * // ["add", "devtools", "--no-install"]
+ */
+export declare function buildGeneratorArgs(spec: GeneratorSpec, options?: GeneratorArgsOptions): string[];
+//#endregion
+//# sourceMappingURL=generator-spec.d.mts.map

package/esm/tooling/generate/generator-spec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-spec.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generator-spec.ts"],"mappings":";;;;;;;;;qBASa;;YAYD,wBAAwB;;;;;qBAMvB,sBAAsB,SAAS,OAAO;;;;;;;;YAkBvC;EAEN;EACA,WAAW;EACX;;EAEA,QAAQ;;EAGR;EACA;;;YAIM;;;;;EAKV;;;wBAQc,gBAAgB,gBAAgB,SAAS;;;;;;;;;;;wBA+CzC,mBACd,MAAM,eACN,UAAS"}

package/esm/tooling/generate/generator-spec.mjs

@@ -0,0 +1,102 @@
+//#region ../../packages/core/src/tooling/generate/generator-spec.ts
+/**
+* What a generation request names, and the `warlock` argv it becomes.
+*
+* Validated strictly because the request usually comes from an agent over MCP:
+* only the generators and flags `warlock generate.*` / `warlock add` declare
+* are accepted, and no value can be read as another flag.
+*/
+/** The `warlock generate.<name>` scaffolders. */
+const MAKE_GENERATORS = [
+	"module",
+	"controller",
+	"service",
+	"use-case",
+	"model",
+	"repository",
+	"resource",
+	"migration"
+];
+/**
+* The flags each generator declares (see `cli/commands/generate/generate.command.ts`),
+* minus `--dry-run`: the sandbox generates for real into a throwaway copy.
+*/
+const MAKE_GENERATOR_FLAGS = {
+	module: [
+		"minimal",
+		"force",
+		"overwrite"
+	],
+	controller: ["with-validation", "force"],
+	service: ["force"],
+	"use-case": ["force"],
+	model: [
+		"with-resource",
+		"table",
+		"force",
+		"overwrite",
+		"timestamps",
+		"no-timestamps"
+	],
+	repository: ["force"],
+	resource: ["force"],
+	migration: [
+		"force",
+		"add",
+		"drop",
+		"rename",
+		"timestamps",
+		"no-timestamps"
+	]
+};
+const FLAG_NAME = /^[a-z][a-z0-9-]*$/;
+const FEATURE_NAME = /^[a-z0-9][a-z0-9-]*$/i;
+const COMPONENT_NAME = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+/** Whether a string names a `warlock generate.*` scaffolder. */
+function isMakeGenerator(value) {
+	return MAKE_GENERATORS.includes(value);
+}
+function assertComponentName(name) {
+	const segments = name.split("/");
+	if (!COMPONENT_NAME.test(name) || segments.some((segment) => segment === "" || segment === "." || segment === "..")) throw new Error(`Invalid name ${JSON.stringify(name)}: use letters, digits, ".", "_", "-" and "/" between segments (for example users/create-user).`);
+}
+function flagArgument(generator, name, value) {
+	const known = MAKE_GENERATOR_FLAGS[generator];
+	if (!FLAG_NAME.test(name) || !known.includes(name)) throw new Error(`Unknown flag --${name} for generate.${generator}. Known flags: ${known.map((flag) => `--${flag}`).join(", ") || "none"}.`);
+	if (typeof value === "boolean") return value ? `--${name}` : `--${name}=false`;
+	if (value.length === 0 || value.startsWith("-") || /[\0\r\n]/.test(value)) throw new Error(`Invalid value for --${name}: it may not be empty, start with "-" or contain a line break.`);
+	return `--${name}=${value}`;
+}
+/**
+* The `warlock` arguments (without the `warlock` itself) that run a spec.
+* Throws on an unknown generator, flag or feature, or an unsafe name or value.
+*
+* @example
+* buildGeneratorArgs({ type: "make", generator: "controller", name: "users/list-users", flags: { "with-validation": true } });
+* // ["generate.controller", "users/list-users", "--with-validation"]
+* buildGeneratorArgs({ type: "add", features: ["devtools"] });
+* // ["add", "devtools", "--no-install"]
+*/
+function buildGeneratorArgs(spec, options = {}) {
+	if (spec.type === "add") {
+		if (spec.features.length === 0) throw new Error("Name at least one feature to add (warlock add --list shows them).");
+		for (const feature of spec.features) if (!FEATURE_NAME.test(feature)) throw new Error(`Invalid feature name ${JSON.stringify(feature)}.`);
+		return [
+			"add",
+			...spec.features,
+			...options.install === true ? [] : ["--no-install"]
+		];
+	}
+	if (!isMakeGenerator(spec.generator)) throw new Error(`Unknown generator ${JSON.stringify(spec.generator)}. Generators: ${MAKE_GENERATORS.join(", ")}.`);
+	assertComponentName(spec.name);
+	const flags = Object.entries(spec.flags ?? {}).map(([name, value]) => flagArgument(spec.generator, name, value));
+	return [
+		`generate.${spec.generator}`,
+		spec.name,
+		...flags
+	];
+}
+
+//#endregion
+export { MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, buildGeneratorArgs, isMakeGenerator };
+//# sourceMappingURL=generator-spec.mjs.map

package/esm/tooling/generate/generator-spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-spec.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generator-spec.ts"],"sourcesContent":["/**\n * What a generation request names, and the `warlock` argv it becomes.\n *\n * Validated strictly because the request usually comes from an agent over MCP:\n * only the generators and flags `warlock generate.*` / `warlock add` declare\n * are accepted, and no value can be read as another flag.\n */\n\n/** The `warlock generate.<name>` scaffolders. */\nexport const MAKE_GENERATORS = [\n  \"module\",\n  \"controller\",\n  \"service\",\n  \"use-case\",\n  \"model\",\n  \"repository\",\n  \"resource\",\n  \"migration\",\n] as const;\n\n/** One `warlock generate.<name>` scaffolder. */\nexport type MakeGenerator = (typeof MAKE_GENERATORS)[number];\n\n/**\n * The flags each generator declares (see `cli/commands/generate/generate.command.ts`),\n * minus `--dry-run`: the sandbox generates for real into a throwaway copy.\n */\nexport const MAKE_GENERATOR_FLAGS: Readonly<Record<MakeGenerator, readonly string[]>> = {\n  module: [\"minimal\", \"force\", \"overwrite\"],\n  controller: [\"with-validation\", \"force\"],\n  service: [\"force\"],\n  \"use-case\": [\"force\"],\n  model: [\"with-resource\", \"table\", \"force\", \"overwrite\", \"timestamps\", \"no-timestamps\"],\n  repository: [\"force\"],\n  resource: [\"force\"],\n  migration: [\"force\", \"add\", \"drop\", \"rename\", \"timestamps\", \"no-timestamps\"],\n};\n\n/**\n * A generation request.\n *\n * - `make`: `warlock generate.<generator> <name> [--flag…]`; `name` is what the\n *   command takes (`users`, `users/create-user`, a model path for `migration`).\n * - `add`: `warlock add <features…>`.\n */\nexport type GeneratorSpec =\n  | {\n      type: \"make\";\n      generator: MakeGenerator;\n      name: string;\n      /** `true` → `--flag`, `false` → `--flag=false`, a string → `--flag=value`. */\n      flags?: Record<string, string | boolean>;\n    }\n  | {\n      type: \"add\";\n      features: string[];\n    };\n\n/** Options of {@link buildGeneratorArgs}. */\nexport type GeneratorArgsOptions = {\n  /**\n   * For `add`: install the packages (`false` adds `--no-install`, which still\n   * records them in package.json). Default `false`.\n   */\n  install?: boolean;\n};\n\nconst FLAG_NAME = /^[a-z][a-z0-9-]*$/;\nconst FEATURE_NAME = /^[a-z0-9][a-z0-9-]*$/i;\nconst COMPONENT_NAME = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;\n\n/** Whether a string names a `warlock generate.*` scaffolder. */\nexport function isMakeGenerator(value: string): value is MakeGenerator {\n  return (MAKE_GENERATORS as readonly string[]).includes(value);\n}\n\nfunction assertComponentName(name: string): void {\n  const segments = name.split(\"/\");\n\n  if (\n    !COMPONENT_NAME.test(name) ||\n    segments.some((segment) => segment === \"\" || segment === \".\" || segment === \"..\")\n  ) {\n    throw new Error(\n      `Invalid name ${JSON.stringify(name)}: use letters, digits, \".\", \"_\", \"-\" and \"/\" between segments (for example users/create-user).`,\n    );\n  }\n}\n\nfunction flagArgument(generator: MakeGenerator, name: string, value: string | boolean): string {\n  const known = MAKE_GENERATOR_FLAGS[generator];\n\n  if (!FLAG_NAME.test(name) || !known.includes(name)) {\n    throw new Error(\n      `Unknown flag --${name} for generate.${generator}. Known flags: ${known.map((flag) => `--${flag}`).join(\", \") || \"none\"}.`,\n    );\n  }\n\n  if (typeof value === \"boolean\") return value ? `--${name}` : `--${name}=false`;\n\n  if (value.length === 0 || value.startsWith(\"-\") || /[\\0\\r\\n]/.test(value)) {\n    throw new Error(\n      `Invalid value for --${name}: it may not be empty, start with \"-\" or contain a line break.`,\n    );\n  }\n\n  return `--${name}=${value}`;\n}\n\n/**\n * The `warlock` arguments (without the `warlock` itself) that run a spec.\n * Throws on an unknown generator, flag or feature, or an unsafe name or value.\n *\n * @example\n * buildGeneratorArgs({ type: \"make\", generator: \"controller\", name: \"users/list-users\", flags: { \"with-validation\": true } });\n * // [\"generate.controller\", \"users/list-users\", \"--with-validation\"]\n * buildGeneratorArgs({ type: \"add\", features: [\"devtools\"] });\n * // [\"add\", \"devtools\", \"--no-install\"]\n */\nexport function buildGeneratorArgs(\n  spec: GeneratorSpec,\n  options: GeneratorArgsOptions = {},\n): string[] {\n  if (spec.type === \"add\") {\n    if (spec.features.length === 0) {\n      throw new Error(\"Name at least one feature to add (warlock add --list shows them).\");\n    }\n\n    for (const feature of spec.features) {\n      if (!FEATURE_NAME.test(feature)) {\n        throw new Error(`Invalid feature name ${JSON.stringify(feature)}.`);\n      }\n    }\n\n    return [\"add\", ...spec.features, ...(options.install === true ? [] : [\"--no-install\"])];\n  }\n\n  if (!isMakeGenerator(spec.generator)) {\n    throw new Error(\n      `Unknown generator ${JSON.stringify(spec.generator)}. Generators: ${MAKE_GENERATORS.join(\", \")}.`,\n    );\n  }\n\n  assertComponentName(spec.name);\n\n  const flags = Object.entries(spec.flags ?? {}).map(([name, value]) =>\n    flagArgument(spec.generator, name, value),\n  );\n\n  return [`generate.${spec.generator}`, spec.name, ...flags];\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,kBAAkB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;AASA,MAAa,uBAA2E;CACtF,QAAQ;EAAC;EAAW;EAAS;CAAW;CACxC,YAAY,CAAC,mBAAmB,OAAO;CACvC,SAAS,CAAC,OAAO;CACjB,YAAY,CAAC,OAAO;CACpB,OAAO;EAAC;EAAiB;EAAS;EAAS;EAAa;EAAc;CAAe;CACrF,YAAY,CAAC,OAAO;CACpB,UAAU,CAAC,OAAO;CAClB,WAAW;EAAC;EAAS;EAAO;EAAQ;EAAU;EAAc;CAAe;AAC7E;AA+BA,MAAM,YAAY;AAClB,MAAM,eAAe;AACrB,MAAM,iBAAiB;;AAGvB,SAAgB,gBAAgB,OAAuC;CACrE,OAAQ,gBAAsC,SAAS,KAAK;AAC9D;AAEA,SAAS,oBAAoB,MAAoB;CAC/C,MAAM,WAAW,KAAK,MAAM,GAAG;CAE/B,IACE,CAAC,eAAe,KAAK,IAAI,KACzB,SAAS,MAAM,YAAY,YAAY,MAAM,YAAY,OAAO,YAAY,IAAI,GAEhF,MAAM,IAAI,MACR,gBAAgB,KAAK,UAAU,IAAI,EAAE,+FACvC;AAEJ;AAEA,SAAS,aAAa,WAA0B,MAAc,OAAiC;CAC7F,MAAM,QAAQ,qBAAqB;CAEnC,IAAI,CAAC,UAAU,KAAK,IAAI,KAAK,CAAC,MAAM,SAAS,IAAI,GAC/C,MAAM,IAAI,MACR,kBAAkB,KAAK,gBAAgB,UAAU,iBAAiB,MAAM,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI,KAAK,OAAO,EAC1H;CAGF,IAAI,OAAO,UAAU,WAAW,OAAO,QAAQ,KAAK,SAAS,KAAK,KAAK;CAEvE,IAAI,MAAM,WAAW,KAAK,MAAM,WAAW,GAAG,KAAK,WAAW,KAAK,KAAK,GACtE,MAAM,IAAI,MACR,uBAAuB,KAAK,+DAC9B;CAGF,OAAO,KAAK,KAAK,GAAG;AACtB;;;;;;;;;;;AAYA,SAAgB,mBACd,MACA,UAAgC,CAAC,GACvB;CACV,IAAI,KAAK,SAAS,OAAO;EACvB,IAAI,KAAK,SAAS,WAAW,GAC3B,MAAM,IAAI,MAAM,mEAAmE;EAGrF,KAAK,MAAM,WAAW,KAAK,UACzB,IAAI,CAAC,aAAa,KAAK,OAAO,GAC5B,MAAM,IAAI,MAAM,wBAAwB,KAAK,UAAU,OAAO,EAAE,EAAE;EAItE,OAAO;GAAC;GAAO,GAAG,KAAK;GAAU,GAAI,QAAQ,YAAY,OAAO,CAAC,IAAI,CAAC,cAAc;EAAE;CACxF;CAEA,IAAI,CAAC,gBAAgB,KAAK,SAAS,GACjC,MAAM,IAAI,MACR,qBAAqB,KAAK,UAAU,KAAK,SAAS,EAAE,gBAAgB,gBAAgB,KAAK,IAAI,EAAE,EACjG;CAGF,oBAAoB,KAAK,IAAI;CAE7B,MAAM,QAAQ,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,WACzD,aAAa,KAAK,WAAW,MAAM,KAAK,CAC1C;CAEA,OAAO;EAAC,YAAY,KAAK;EAAa,KAAK;EAAM,GAAG;CAAK;AAC3D"}

package/esm/tooling/generate/index.mjs

@@ -0,0 +1,6 @@
+import { MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, buildGeneratorArgs, isMakeGenerator } from "./generator-spec.mjs";
+import { DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli } from "./run-cli.mjs";
+import { DIFF_CONTEXT_LINES, unifiedDiff } from "./unified-diff.mjs";
+import { MAX_FILE_DIFF_BYTES, applyGeneration, sandboxBackend } from "./generation.mjs";
+
+export { DEFAULT_GENERATION_TIMEOUT_MS, DIFF_CONTEXT_LINES, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MAX_FILE_DIFF_BYTES, applyGeneration, buildGeneratorArgs, describeRun, isMakeGenerator, resolveCliEntry, sandboxBackend, spawnCli, unifiedDiff };

package/esm/tooling/generate/project-files.mjs

@@ -0,0 +1,121 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, symlinkSync } from "node:fs";
+
+//#region ../../packages/core/src/tooling/generate/project-files.ts
+/**
+* Which project files a generation can see and change, and how they are
+* copied, hashed and compared.
+*
+* THE SCOPE: the files at the project root plus the `src/` tree. That is where
+* every generator writes (`src/app/**`, `src/config/**`, `package.json`,
+* `warlock.config.ts`, `tsconfig.json`). `.env` files are never copied, hashed
+* or diffed: they hold secrets, and a diff is text an agent will read.
+*/
+/** Directory names never entered anywhere. */
+const SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
+/** Root directories outside the scope that a sandbox still never copies (listed for the walk of a sandbox). */
+const SKIPPED_ROOT_DIRECTORIES = /* @__PURE__ */ new Set([
+	".git",
+	"node_modules",
+	".warlock",
+	"dist",
+	"storage",
+	"public",
+	"coverage"
+]);
+/** Whether a file name is an env file (`.env`, `.env.local`, `.env.production`…). */
+function isEnvFile(name) {
+	return name === ".env" || name.startsWith(".env.");
+}
+function toPosix(relative) {
+	return relative.split(path.sep).join("/");
+}
+function hashFile(file) {
+	return createHash("sha256").update(readFileSync(file)).digest("hex");
+}
+function walk(root, directory, visit) {
+	for (const entry of readdirSync(directory, { withFileTypes: true })) {
+		if (entry.isSymbolicLink()) continue;
+		const absolute = path.join(directory, entry.name);
+		if (entry.isDirectory()) {
+			if (!SKIPPED_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);
+			continue;
+		}
+		if (entry.isFile() && !isEnvFile(entry.name)) visit(absolute, toPosix(path.relative(root, absolute)));
+	}
+}
+/**
+* Visit every file in the generation scope of `root`: root-level files and the
+* `src/` tree, skipping env files, symlinks, `node_modules` and `.git`.
+*/
+function forEachScopedFile(root, visit) {
+	for (const entry of readdirSync(root, { withFileTypes: true })) if (entry.isFile() && !isEnvFile(entry.name)) visit(path.join(root, entry.name), entry.name);
+	const source = path.join(root, "src");
+	if (existsSync(source)) walk(root, source, visit);
+}
+/**
+* Visit every file under `root` except env files, symlinks and the
+* {@link SKIPPED_ROOT_DIRECTORIES} — how a sandbox is read after a generator
+* ran, so a file written outside `src/` is still seen.
+*/
+function forEachSandboxFile(root, visit) {
+	for (const entry of readdirSync(root, { withFileTypes: true })) {
+		if (entry.isSymbolicLink()) continue;
+		const absolute = path.join(root, entry.name);
+		if (entry.isDirectory()) {
+			if (!SKIPPED_ROOT_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);
+		} else if (entry.isFile() && !isEnvFile(entry.name)) visit(absolute, entry.name);
+	}
+}
+/** Hash every file the walker visits. */
+function snapshotFiles(root, walker) {
+	const snapshot = /* @__PURE__ */ new Map();
+	walker(root, (absolute, relative) => {
+		snapshot.set(relative, hashFile(absolute));
+	});
+	return snapshot;
+}
+/**
+* Copy the generation scope of `projectRoot` into `sandboxRoot` and link the
+* project's `node_modules` into it, so `warlock.config.ts` and every package
+* resolve exactly as they do in the project. Nothing is copied from
+* `node_modules`; the link is removed with the sandbox, never followed.
+*/
+function copyProjectScope(projectRoot, sandboxRoot) {
+	forEachScopedFile(projectRoot, (absolute, relative) => {
+		const target = path.join(sandboxRoot, relative);
+		mkdirSync(path.dirname(target), { recursive: true });
+		copyFileSync(absolute, target);
+	});
+	const modules = path.join(projectRoot, "node_modules");
+	if (existsSync(modules)) symlinkSync(modules, path.join(sandboxRoot, "node_modules"), "junction");
+}
+/** The files created, modified or deleted between two snapshots, sorted by path. */
+function compareSnapshots(before, after) {
+	const changes = [];
+	for (const [file, hash] of after) {
+		const previous = before.get(file);
+		if (previous === void 0) changes.push({
+			path: file,
+			status: "created"
+		});
+		else if (previous !== hash) changes.push({
+			path: file,
+			status: "modified"
+		});
+	}
+	for (const file of before.keys()) if (!after.has(file)) changes.push({
+		path: file,
+		status: "deleted"
+	});
+	return changes.sort((first, second) => first.path.localeCompare(second.path));
+}
+/** Whether bytes look binary: a NUL in the first 8000 bytes, as git decides. */
+function isBinary(content) {
+	return content.subarray(0, 8e3).includes(0);
+}
+
+//#endregion
+export { compareSnapshots, copyProjectScope, forEachSandboxFile, forEachScopedFile, isBinary, isEnvFile, snapshotFiles };
+//# sourceMappingURL=project-files.mjs.map

package/esm/tooling/generate/project-files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/project-files.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  symlinkSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Which project files a generation can see and change, and how they are\n * copied, hashed and compared.\n *\n * THE SCOPE: the files at the project root plus the `src/` tree. That is where\n * every generator writes (`src/app/**`, `src/config/**`, `package.json`,\n * `warlock.config.ts`, `tsconfig.json`). `.env` files are never copied, hashed\n * or diffed: they hold secrets, and a diff is text an agent will read.\n */\n\n/** Directory names never entered anywhere. */\nconst SKIPPED_DIRECTORIES = new Set([\".git\", \"node_modules\"]);\n\n/** Root directories outside the scope that a sandbox still never copies (listed for the walk of a sandbox). */\nconst SKIPPED_ROOT_DIRECTORIES = new Set([\n  \".git\",\n  \"node_modules\",\n  \".warlock\",\n  \"dist\",\n  \"storage\",\n  \"public\",\n  \"coverage\",\n]);\n\n/** Whether a file name is an env file (`.env`, `.env.local`, `.env.production`…). */\nexport function isEnvFile(name: string): boolean {\n  return name === \".env\" || name.startsWith(\".env.\");\n}\n\n/** A file's content hash, keyed by project-relative POSIX path. */\nexport type FileSnapshot = Map<string, string>;\n\nfunction toPosix(relative: string): string {\n  return relative.split(path.sep).join(\"/\");\n}\n\nfunction hashFile(file: string): string {\n  return createHash(\"sha256\").update(readFileSync(file)).digest(\"hex\");\n}\n\nfunction walk(\n  root: string,\n  directory: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(directory, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n      continue;\n    }\n\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, toPosix(path.relative(root, absolute)));\n    }\n  }\n}\n\n/**\n * Visit every file in the generation scope of `root`: root-level files and the\n * `src/` tree, skipping env files, symlinks, `node_modules` and `.git`.\n */\nexport function forEachScopedFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(path.join(root, entry.name), entry.name);\n    }\n  }\n\n  const source = path.join(root, \"src\");\n\n  if (existsSync(source)) walk(root, source, visit);\n}\n\n/**\n * Visit every file under `root` except env files, symlinks and the\n * {@link SKIPPED_ROOT_DIRECTORIES} — how a sandbox is read after a generator\n * ran, so a file written outside `src/` is still seen.\n */\nexport function forEachSandboxFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(root, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_ROOT_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n    } else if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, entry.name);\n    }\n  }\n}\n\n/** Hash every file the walker visits. */\nexport function snapshotFiles(\n  root: string,\n  walker: (root: string, visit: (absolute: string, relative: string) => void) => void,\n): FileSnapshot {\n  const snapshot: FileSnapshot = new Map();\n\n  walker(root, (absolute, relative) => {\n    snapshot.set(relative, hashFile(absolute));\n  });\n\n  return snapshot;\n}\n\n/**\n * Copy the generation scope of `projectRoot` into `sandboxRoot` and link the\n * project's `node_modules` into it, so `warlock.config.ts` and every package\n * resolve exactly as they do in the project. Nothing is copied from\n * `node_modules`; the link is removed with the sandbox, never followed.\n */\nexport function copyProjectScope(projectRoot: string, sandboxRoot: string): void {\n  forEachScopedFile(projectRoot, (absolute, relative) => {\n    const target = path.join(sandboxRoot, relative);\n\n    mkdirSync(path.dirname(target), { recursive: true });\n    copyFileSync(absolute, target);\n  });\n\n  const modules = path.join(projectRoot, \"node_modules\");\n\n  if (existsSync(modules)) {\n    // \"junction\" is ignored off Windows and makes the link work there without admin rights.\n    symlinkSync(modules, path.join(sandboxRoot, \"node_modules\"), \"junction\");\n  }\n}\n\n/** One file that differs between two snapshots. */\nexport type SnapshotChange = { path: string; status: \"created\" | \"modified\" | \"deleted\" };\n\n/** The files created, modified or deleted between two snapshots, sorted by path. */\nexport function compareSnapshots(before: FileSnapshot, after: FileSnapshot): SnapshotChange[] {\n  const changes: SnapshotChange[] = [];\n\n  for (const [file, hash] of after) {\n    const previous = before.get(file);\n\n    if (previous === undefined) changes.push({ path: file, status: \"created\" });\n    else if (previous !== hash) changes.push({ path: file, status: \"modified\" });\n  }\n\n  for (const file of before.keys()) {\n    if (!after.has(file)) changes.push({ path: file, status: \"deleted\" });\n  }\n\n  return changes.sort((first, second) => first.path.localeCompare(second.path));\n}\n\n/** Whether bytes look binary: a NUL in the first 8000 bytes, as git decides. */\nexport function isBinary(content: Buffer): boolean {\n  return content.subarray(0, 8000).includes(0);\n}\n"],"mappings":"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"}

package/esm/tooling/generate/run-cli.d.mts

@@ -0,0 +1,43 @@
+//#region ../../packages/core/src/tooling/generate/run-cli.d.ts
+/** How one CLI run ended. */
+export type CliRun = {
+  /** The exit code, or `null` when the process was killed. */
+  exitCode: number | null;
+  /** The signal that ended it, or `null`. */
+  signal: string | null;
+  stdout: string;
+  stderr: string;
+  /** Whether the run hit its timeout and was stopped. */
+  timedOut: boolean;
+};
+/** What a {@link CliRunner} is asked to run: `node <entry> <args>` in `cwd`. */
+export type CliInvocation = {
+  /** The CLI entry script (the `warlock` bin). */
+  entry: string;
+  args: readonly string[];
+  cwd: string;
+  timeoutMs: number;
+};
+/** Runs the CLI. Injectable so tests never spawn the real one. */
+export type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;
+/** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */
+export declare const DEFAULT_GENERATION_TIMEOUT_MS = 120000;
+/**
+ * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as
+ * the project at `cwd` resolves the package, else the script this process
+ * was started with when it is the `warlock` bin.
+ *
+ * @throws When neither is found; pass the entry explicitly then.
+ */
+export declare function resolveCliEntry(cwd?: string): string;
+/**
+ * The default {@link CliRunner}: spawns `node <entry> <args>` with stdin
+ * closed (a prompt reads end-of-input instead of hanging), colors off and
+ * `CI=1`, and stops the child it spawned — that one process, by its own
+ * handle — when the timeout passes.
+ */
+export declare const spawnCli: CliRunner;
+/** Output a plan carries: stdout then stderr, ANSI stripped, capped. */
+export declare function describeRun(run: CliRun, limit?: number): string;
+//#endregion
+//# sourceMappingURL=run-cli.d.mts.map

package/esm/tooling/generate/run-cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"mappings":";;YAKY;;EAEV;;EAEA;EACA;EACA;;EAEA;;;YAIU;;EAEV;EACA;EACA;EACA;;;YAIU,aAAa,YAAY,kBAAkB,QAAQ;;qBAGlD;;;;;;;;wBAYG,gBAAgB;;;;;;;qBA0BnB,UAAU;;wBA+CP,YAAY,KAAK,QAAQ"}

package/esm/tooling/generate/run-cli.mjs

@@ -0,0 +1,93 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import { spawn } from "node:child_process";
+
+//#region ../../packages/core/src/tooling/generate/run-cli.ts
+/** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */
+const DEFAULT_GENERATION_TIMEOUT_MS = 12e4;
+/** Output kept per stream; the rest is dropped (the diff is the result, not the log). */
+const MAX_STREAM_BYTES = 262144;
+/**
+* The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as
+* the project at `cwd` resolves the package, else the script this process
+* was started with when it is the `warlock` bin.
+*
+* @throws When neither is found; pass the entry explicitly then.
+*/
+function resolveCliEntry(cwd = process.cwd()) {
+	try {
+		const manifest = createRequire(path.join(cwd, "package.json")).resolve("@warlock.js/core/package.json");
+		return path.join(path.dirname(manifest), "bin", "warlock.js");
+	} catch {}
+	const invoked = process.argv[1];
+	if (invoked && /^warlock(\.js)?$/.test(path.basename(invoked))) return invoked;
+	throw new Error("Could not find the warlock CLI: install @warlock.js/core in the project, or pass cliEntry.");
+}
+/**
+* The default {@link CliRunner}: spawns `node <entry> <args>` with stdin
+* closed (a prompt reads end-of-input instead of hanging), colors off and
+* `CI=1`, and stops the child it spawned — that one process, by its own
+* handle — when the timeout passes.
+*/
+const spawnCli = (invocation) => new Promise((resolve) => {
+	const child = spawn(process.execPath, [invocation.entry, ...invocation.args], {
+		cwd: invocation.cwd,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		],
+		windowsHide: true,
+		env: {
+			...process.env,
+			CI: "1",
+			NO_COLOR: "1",
+			FORCE_COLOR: "0"
+		}
+	});
+	let stdout = "";
+	let stderr = "";
+	let timedOut = false;
+	child.stdout.setEncoding("utf8");
+	child.stderr.setEncoding("utf8");
+	child.stdout.on("data", (chunk) => {
+		if (stdout.length < MAX_STREAM_BYTES) stdout += chunk;
+	});
+	child.stderr.on("data", (chunk) => {
+		if (stderr.length < MAX_STREAM_BYTES) stderr += chunk;
+	});
+	const timer = setTimeout(() => {
+		timedOut = true;
+		child.kill("SIGTERM");
+	}, invocation.timeoutMs);
+	let settled = false;
+	const finish = (exitCode, signal) => {
+		if (settled) return;
+		settled = true;
+		clearTimeout(timer);
+		resolve({
+			exitCode,
+			signal,
+			stdout,
+			stderr,
+			timedOut
+		});
+	};
+	child.on("error", (error) => {
+		stderr += `${error.message}\n`;
+		finish(null, null);
+	});
+	child.on("close", (code, signal) => finish(code, signal));
+});
+/** ANSI color and cursor sequences. */
+const ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;?]*[A-Za-z]`, "g");
+/** Output a plan carries: stdout then stderr, ANSI stripped, capped. */
+function describeRun(run, limit = 16384) {
+	const text = [run.stdout, run.stderr].map((part) => part.replace(ANSI_SEQUENCE, "").trim()).filter((part) => part.length > 0).join("\n");
+	const suffix = run.timedOut ? "\n(stopped: the command timed out)" : "";
+	return text.length > limit ? `${text.slice(0, limit)}\n… (output truncated)${suffix}` : `${text}${suffix}`;
+}
+
+//#endregion
+export { DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli };
+//# sourceMappingURL=run-cli.mjs.map

package/esm/tooling/generate/run-cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\n/** How one CLI run ended. */\nexport type CliRun = {\n  /** The exit code, or `null` when the process was killed. */\n  exitCode: number | null;\n  /** The signal that ended it, or `null`. */\n  signal: string | null;\n  stdout: string;\n  stderr: string;\n  /** Whether the run hit its timeout and was stopped. */\n  timedOut: boolean;\n};\n\n/** What a {@link CliRunner} is asked to run: `node <entry> <args>` in `cwd`. */\nexport type CliInvocation = {\n  /** The CLI entry script (the `warlock` bin). */\n  entry: string;\n  args: readonly string[];\n  cwd: string;\n  timeoutMs: number;\n};\n\n/** Runs the CLI. Injectable so tests never spawn the real one. */\nexport type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;\n\n/** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */\nexport const DEFAULT_GENERATION_TIMEOUT_MS = 120_000;\n\n/** Output kept per stream; the rest is dropped (the diff is the result, not the log). */\nconst MAX_STREAM_BYTES = 256 * 1024;\n\n/**\n * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as\n * the project at `cwd` resolves the package, else the script this process\n * was started with when it is the `warlock` bin.\n *\n * @throws When neither is found; pass the entry explicitly then.\n */\nexport function resolveCliEntry(cwd = process.cwd()): string {\n  try {\n    const manifest = createRequire(path.join(cwd, \"package.json\")).resolve(\n      \"@warlock.js/core/package.json\",\n    );\n\n    return path.join(path.dirname(manifest), \"bin\", \"warlock.js\");\n  } catch {\n    // Not resolvable from the project; try the running script.\n  }\n\n  const invoked = process.argv[1];\n\n  if (invoked && /^warlock(\\.js)?$/.test(path.basename(invoked))) return invoked;\n\n  throw new Error(\n    \"Could not find the warlock CLI: install @warlock.js/core in the project, or pass cliEntry.\",\n  );\n}\n\n/**\n * The default {@link CliRunner}: spawns `node <entry> <args>` with stdin\n * closed (a prompt reads end-of-input instead of hanging), colors off and\n * `CI=1`, and stops the child it spawned — that one process, by its own\n * handle — when the timeout passes.\n */\nexport const spawnCli: CliRunner = (invocation) =>\n  new Promise((resolve) => {\n    const child = spawn(process.execPath, [invocation.entry, ...invocation.args], {\n      cwd: invocation.cwd,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      windowsHide: true,\n      env: { ...process.env, CI: \"1\", NO_COLOR: \"1\", FORCE_COLOR: \"0\" },\n    });\n    let stdout = \"\";\n    let stderr = \"\";\n    let timedOut = false;\n\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => {\n      if (stdout.length < MAX_STREAM_BYTES) stdout += chunk;\n    });\n    child.stderr.on(\"data\", (chunk: string) => {\n      if (stderr.length < MAX_STREAM_BYTES) stderr += chunk;\n    });\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill(\"SIGTERM\");\n    }, invocation.timeoutMs);\n\n    let settled = false;\n\n    const finish = (exitCode: number | null, signal: string | null) => {\n      if (settled) return;\n\n      settled = true;\n      clearTimeout(timer);\n      resolve({ exitCode, signal, stdout, stderr, timedOut });\n    };\n\n    child.on(\"error\", (error) => {\n      stderr += `${error.message}\\n`;\n      finish(null, null);\n    });\n    child.on(\"close\", (code, signal) => finish(code, signal));\n  });\n\n/** ANSI color and cursor sequences. */\nconst ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;?]*[A-Za-z]`, \"g\");\n\n/** Output a plan carries: stdout then stderr, ANSI stripped, capped. */\nexport function describeRun(run: CliRun, limit = 16 * 1024): string {\n  const text = [run.stdout, run.stderr]\n    .map((part) => part.replace(ANSI_SEQUENCE, \"\").trim())\n    .filter((part) => part.length > 0)\n    .join(\"\\n\");\n  const suffix = run.timedOut ? \"\\n(stopped: the command timed out)\" : \"\";\n\n  return text.length > limit\n    ? `${text.slice(0, limit)}\\n… (output truncated)${suffix}`\n    : `${text}${suffix}`;\n}\n"],"mappings":";;;;;;AA6BA,MAAa,gCAAgC;;AAG7C,MAAM,mBAAmB;;;;;;;;AASzB,SAAgB,gBAAgB,MAAM,QAAQ,IAAI,GAAW;CAC3D,IAAI;EACF,MAAM,WAAW,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,QAC7D,+BACF;EAEA,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,OAAO,YAAY;CAC9D,QAAQ,CAER;CAEA,MAAM,UAAU,QAAQ,KAAK;CAE7B,IAAI,WAAW,mBAAmB,KAAK,KAAK,SAAS,OAAO,CAAC,GAAG,OAAO;CAEvE,MAAM,IAAI,MACR,4FACF;AACF;;;;;;;AAQA,MAAa,YAAuB,eAClC,IAAI,SAAS,YAAY;CACvB,MAAM,QAAQ,MAAM,QAAQ,UAAU,CAAC,WAAW,OAAO,GAAG,WAAW,IAAI,GAAG;EAC5E,KAAK,WAAW;EAChB,OAAO;GAAC;GAAU;GAAQ;EAAM;EAChC,aAAa;EACb,KAAK;GAAE,GAAG,QAAQ;GAAK,IAAI;GAAK,UAAU;GAAK,aAAa;EAAI;CAClE,CAAC;CACD,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,WAAW;CAEf,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CACD,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CAED,MAAM,QAAQ,iBAAiB;EAC7B,WAAW;EACX,MAAM,KAAK,SAAS;CACtB,GAAG,WAAW,SAAS;CAEvB,IAAI,UAAU;CAEd,MAAM,UAAU,UAAyB,WAA0B;EACjE,IAAI,SAAS;EAEb,UAAU;EACV,aAAa,KAAK;EAClB,QAAQ;GAAE;GAAU;GAAQ;GAAQ;GAAQ;EAAS,CAAC;CACxD;CAEA,MAAM,GAAG,UAAU,UAAU;EAC3B,UAAU,GAAG,MAAM,QAAQ;EAC3B,OAAO,MAAM,IAAI;CACnB,CAAC;CACD,MAAM,GAAG,UAAU,MAAM,WAAW,OAAO,MAAM,MAAM,CAAC;AAC1D,CAAC;;AAGH,MAAM,gBAAgB,IAAI,OAAO,GAAG,OAAO,aAAa,EAAE,EAAE,sBAAsB,GAAG;;AAGrF,SAAgB,YAAY,KAAa,QAAQ,OAAmB;CAClE,MAAM,OAAO,CAAC,IAAI,QAAQ,IAAI,MAAM,CAAC,CAClC,KAAK,SAAS,KAAK,QAAQ,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CACrD,QAAQ,SAAS,KAAK,SAAS,CAAC,CAAC,CACjC,KAAK,IAAI;CACZ,MAAM,SAAS,IAAI,WAAW,uCAAuC;CAErE,OAAO,KAAK,SAAS,QACjB,GAAG,KAAK,MAAM,GAAG,KAAK,EAAE,wBAAwB,WAChD,GAAG,OAAO;AAChB"}

package/esm/tooling/generate/unified-diff.d.mts

@@ -0,0 +1,40 @@
+//#region ../../packages/core/src/tooling/generate/unified-diff.d.ts
+/**
+ * A small, dependency-free unified diff, in the format `git diff` and
+ * `patch -p1` read: `--- a/<path>` / `+++ b/<path>` headers (`/dev/null` for a
+ * created or deleted file), `@@ -l,c +l,c @@` hunks with three lines of
+ * context, and `` markers.
+ *
+ * Lines are matched with a longest-common-subsequence table after the common
+ * prefix and suffix are trimmed. Generated files are small, so that is plenty;
+ * a pair too large for the table falls back to "every line replaced", which is
+ * still a correct (if larger) diff.
+ */
+/** Lines of context around each change. */
+export declare const DIFF_CONTEXT_LINES = 3;
+/** Inputs of {@link unifiedDiff}. */
+export type UnifiedDiffInput = {
+  /** Project-relative POSIX path, used in the headers. */
+  path: string;
+  /** The old content; `null` when the file is created. */
+  before: string | null;
+  /** The new content; `null` when the file is deleted. */
+  after: string | null;
+  /** Lines of context. Default {@link DIFF_CONTEXT_LINES}. */
+  context?: number;
+};
+/**
+ * The unified diff between two versions of one file, or `""` when they are
+ * equal.
+ *
+ * @example
+ * unifiedDiff({ path: "src/app/users/routes.ts", before: "a\n", after: "a\nb\n" });
+ * // --- a/src/app/users/routes.ts
+ * // +++ b/src/app/users/routes.ts
+ * // @@ -1,1 +1,2 @@
+ * //  a
+ * // +b
+ */
+export declare function unifiedDiff(input: UnifiedDiffInput): string;
+//#endregion
+//# sourceMappingURL=unified-diff.d.mts.map

package/esm/tooling/generate/unified-diff.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-diff.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/unified-diff.ts"],"mappings":";;;;;;;;;;;;;qBAaa;;YAuHD;;EAEV;;EAEA;;EAEA;;EAEA;;;;;;;;;;;;;;wBAec,YAAY,OAAO"}