@warlock.js/core 5.30.0 → 5.32.0

package/esm/cli/commands/issue/collect-environment.mjs

@@ -0,0 +1,187 @@
+import path from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { parseSync } from "oxc-parser";
+import { spawnSync } from "node:child_process";
+import os from "node:os";
+
+//#region ../../packages/core/src/cli/commands/issue/collect-environment.ts
+function readJson(file) {
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return;
+	}
+}
+function field(value, key) {
+	return typeof value === "object" && value !== null ? Reflect.get(value, key) : void 0;
+}
+function versionOf(value) {
+	return typeof value === "string" && /^\d+\.\d+\.\d+(?:[-+][\w.+-]+)?$/.test(value) ? value : null;
+}
+function moduleDirectories(cwd) {
+	const directories = [];
+	for (let current = path.resolve(cwd);; current = path.dirname(current)) {
+		directories.push(path.join(current, "node_modules"));
+		if (path.dirname(current) === current) return directories;
+	}
+}
+function installedVersion(directories, name) {
+	for (const directory of directories) {
+		const file = path.join(directory, name, "package.json");
+		if (existsSync(file)) return versionOf(field(readJson(file), "version"));
+	}
+	return null;
+}
+function installedPackages(directories) {
+	const names = /* @__PURE__ */ new Set();
+	for (const directory of directories) try {
+		for (const name of readdirSync(path.join(directory, "@warlock.js"))) if (/^[a-z0-9][a-z0-9-]*$/.test(name)) names.add(`@warlock.js/${name}`);
+	} catch {}
+	const packages = {};
+	for (const name of [...names].sort()) {
+		const version = installedVersion(directories, name);
+		if (version) packages[name] = version;
+	}
+	return packages;
+}
+function packageManager(cwd, userAgent) {
+	const agent = /^(npm|pnpm|yarn|bun)\/(\d+\.\d+\.\d+(?:[-+][\w.+-]+)?)(?:\s|$)/.exec(userAgent ?? "");
+	if (agent?.[1] && agent[2]) return {
+		name: agent[1],
+		version: agent[2]
+	};
+	const declared = field(readJson(path.join(cwd, "package.json")), "packageManager");
+	const detected = (typeof declared === "string" ? /^(npm|pnpm|yarn|bun)@/.exec(declared)?.[1] : void 0) ?? [
+		["pnpm-lock.yaml", "pnpm"],
+		["yarn.lock", "yarn"],
+		["bun.lock", "bun"],
+		["bun.lockb", "bun"],
+		["package-lock.json", "npm"]
+	].find(([file]) => existsSync(path.join(cwd, file)))?.[1];
+	if (!detected) return null;
+	const child = spawnSync(detected, ["--version"], {
+		cwd: path.parse(path.resolve(cwd)).root,
+		encoding: "utf8",
+		timeout: 3e3,
+		maxBuffer: 4096,
+		env: {
+			...process.env,
+			COREPACK_ENABLE_NETWORK: "0",
+			COREPACK_ENABLE_AUTO_PIN: "0"
+		},
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		],
+		windowsHide: true
+	});
+	return {
+		name: detected,
+		version: child.status === 0 ? versionOf(child.stdout.trim()) : null
+	};
+}
+function unwrap(node) {
+	if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression" || node.type === "TSTypeAssertion") return unwrap(node.expression);
+	return node;
+}
+function property(object, name) {
+	for (const item of [...object.properties].reverse()) {
+		if (item.type !== "Property" || item.computed || item.method) continue;
+		if ((item.key.type === "Identifier" ? item.key.name : item.key.type === "Literal" ? item.key.value : void 0) === name) return unwrap(item.value);
+	}
+}
+/** Parse syntax only; never import config, .env, connectors or app modules. */
+function collectIssueConfig(cwd) {
+	const summary = {
+		status: "missing",
+		sections: [],
+		buildFlags: {},
+		connectors: null,
+		customCommands: null,
+		dynamic: false
+	};
+	const file = path.join(cwd, "warlock.config.ts");
+	if (!existsSync(file)) return summary;
+	let source;
+	try {
+		source = readFileSync(file, "utf8");
+	} catch {
+		return {
+			...summary,
+			status: "unreadable"
+		};
+	}
+	try {
+		const parsed = parseSync("warlock.config.ts", source);
+		if (parsed.errors.length) return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+		const exported = parsed.program.body.find((node) => node.type === "ExportDefaultDeclaration");
+		let value = exported ? unwrap(exported.declaration) : void 0;
+		if (value?.type === "CallExpression" && value.callee.type === "Identifier" && value.callee.name === "defineConfig") value = value.arguments[0];
+		if (value) value = unwrap(value);
+		if (value?.type !== "ObjectExpression") return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+		const object = value;
+		summary.status = "static";
+		summary.sections = [
+			"server",
+			"build",
+			"connectors",
+			"cli",
+			"devServer",
+			"database",
+			"testing"
+		].filter((name) => property(object, name) !== void 0);
+		summary.dynamic = object.properties.some((item) => item.type === "SpreadElement" || item.computed);
+		const build = property(object, "build");
+		if (build?.type === "ObjectExpression") for (const key of [
+			"minify",
+			"sourcemap",
+			"singleBundle",
+			"esmShim",
+			"splitting"
+		]) {
+			const flag = property(build, key);
+			if (flag?.type === "Literal" && typeof flag.value === "boolean") summary.buildFlags[key] = flag.value;
+		}
+		const connectors = property(object, "connectors");
+		if (connectors?.type === "ArrayExpression" && !connectors.elements.some((item) => item?.type === "SpreadElement")) summary.connectors = connectors.elements.length;
+		const cli = property(object, "cli");
+		const commands = cli?.type === "ObjectExpression" ? property(cli, "commands") : void 0;
+		if (commands?.type === "ArrayExpression" && !commands.elements.some((item) => item?.type === "SpreadElement")) summary.customCommands = commands.elements.length;
+		return summary;
+	} catch {
+		return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+	}
+}
+/** Collect installed metadata without starting the app or reading private values. */
+function collectIssueEnvironment(cwd = process.cwd(), userAgent = process.env.npm_config_user_agent) {
+	const directories = moduleDirectories(cwd);
+	return {
+		packages: installedPackages(directories),
+		node: process.version,
+		packageManager: packageManager(cwd, userAgent),
+		os: {
+			platform: os.platform(),
+			release: os.release(),
+			arch: os.arch()
+		},
+		typescript: installedVersion(directories, "typescript"),
+		config: collectIssueConfig(cwd)
+	};
+}
+
+//#endregion
+export { collectIssueConfig, collectIssueEnvironment };
+//# sourceMappingURL=collect-environment.mjs.map

package/esm/cli/commands/issue/collect-environment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-environment.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/issue/collect-environment.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { parseSync, type Node, type ObjectExpression } from \"oxc-parser\";\n\nexport type IssueConfigSummary = {\n  status: \"missing\" | \"unreadable\" | \"unparsed\" | \"static\";\n  sections: string[];\n  buildFlags: Record<string, boolean>;\n  connectors: number | null;\n  customCommands: number | null;\n  dynamic: boolean;\n};\n\nexport type IssueEnvironment = {\n  packages: Record<string, string>;\n  node: string;\n  packageManager: { name: string; version: string | null } | null;\n  os: { platform: string; release: string; arch: string };\n  typescript: string | null;\n  config: IssueConfigSummary;\n};\n\nfunction readJson(file: string): unknown {\n  try {\n    return JSON.parse(readFileSync(file, \"utf8\"));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction field(value: unknown, key: string): unknown {\n  return typeof value === \"object\" && value !== null ? Reflect.get(value, key) : undefined;\n}\n\n// Version metadata only: never copy arbitrary manifest strings into a public report.\nfunction versionOf(value: unknown): string | null {\n  return typeof value === \"string\" && /^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.+-]+)?$/.test(value) ? value : null;\n}\n\nfunction moduleDirectories(cwd: string): string[] {\n  const directories: string[] = [];\n  for (let current = path.resolve(cwd); ; current = path.dirname(current)) {\n    directories.push(path.join(current, \"node_modules\"));\n    if (path.dirname(current) === current) return directories;\n  }\n}\n\nfunction installedVersion(directories: string[], name: string): string | null {\n  for (const directory of directories) {\n    const file = path.join(directory, name, \"package.json\");\n    if (existsSync(file)) return versionOf(field(readJson(file), \"version\"));\n  }\n  return null;\n}\n\nfunction installedPackages(directories: string[]): Record<string, string> {\n  const names = new Set<string>();\n  for (const directory of directories) {\n    try {\n      for (const name of readdirSync(path.join(directory, \"@warlock.js\"))) {\n        if (/^[a-z0-9][a-z0-9-]*$/.test(name)) names.add(`@warlock.js/${name}`);\n      }\n    } catch {\n      // Missing node_modules is useful information, not a reason to require a boot.\n    }\n  }\n  const packages: Record<string, string> = {};\n  for (const name of [...names].sort()) {\n    const version = installedVersion(directories, name);\n    if (version) packages[name] = version;\n  }\n  return packages;\n}\n\nfunction packageManager(\n  cwd: string,\n  userAgent: string | undefined,\n): IssueEnvironment[\"packageManager\"] {\n  const agent = /^(npm|pnpm|yarn|bun)\\/(\\d+\\.\\d+\\.\\d+(?:[-+][\\w.+-]+)?)(?:\\s|$)/.exec(\n    userAgent ?? \"\",\n  );\n  if (agent?.[1] && agent[2]) return { name: agent[1], version: agent[2] };\n\n  const declared = field(readJson(path.join(cwd, \"package.json\")), \"packageManager\");\n  const name =\n    typeof declared === \"string\" ? /^(npm|pnpm|yarn|bun)@/.exec(declared)?.[1] : undefined;\n  const detected =\n    name ??\n    (\n      [\n        [\"pnpm-lock.yaml\", \"pnpm\"],\n        [\"yarn.lock\", \"yarn\"],\n        [\"bun.lock\", \"bun\"],\n        [\"bun.lockb\", \"bun\"],\n        [\"package-lock.json\", \"npm\"],\n      ] as const\n    ).find(([file]) => existsSync(path.join(cwd, file)))?.[1];\n  if (!detected) return null;\n\n  // Only a known executable and --version, never app scripts or npm_execpath.\n  // Probe outside the app so manager shims cannot select/install an app-pinned\n  // version or load project plugins. The result records our child's PID;\n  // timeout targets only that child.\n  const child = spawnSync(detected, [\"--version\"], {\n    cwd: path.parse(path.resolve(cwd)).root,\n    encoding: \"utf8\",\n    timeout: 3_000,\n    maxBuffer: 4_096,\n    env: { ...process.env, COREPACK_ENABLE_NETWORK: \"0\", COREPACK_ENABLE_AUTO_PIN: \"0\" },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    windowsHide: true,\n  });\n  return { name: detected, version: child.status === 0 ? versionOf(child.stdout.trim()) : null };\n}\n\nfunction unwrap(node: Node): Node {\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ParenthesizedExpression\" ||\n    node.type === \"TSTypeAssertion\"\n  )\n    return unwrap(node.expression);\n  return node;\n}\n\nfunction property(object: ObjectExpression, name: string): Node | undefined {\n  for (const item of [...object.properties].reverse()) {\n    if (item.type !== \"Property\" || item.computed || item.method) continue;\n    const key =\n      item.key.type === \"Identifier\"\n        ? item.key.name\n        : item.key.type === \"Literal\"\n          ? item.key.value\n          : undefined;\n    if (key === name) return unwrap(item.value);\n  }\n  return undefined;\n}\n\n/** Parse syntax only; never import config, .env, connectors or app modules. */\nexport function collectIssueConfig(cwd: string): IssueConfigSummary {\n  const summary: IssueConfigSummary = {\n    status: \"missing\",\n    sections: [],\n    buildFlags: {},\n    connectors: null,\n    customCommands: null,\n    dynamic: false,\n  };\n  const file = path.join(cwd, \"warlock.config.ts\");\n  if (!existsSync(file)) return summary;\n  let source: string;\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return { ...summary, status: \"unreadable\" };\n  }\n  try {\n    const parsed = parseSync(\"warlock.config.ts\", source);\n    if (parsed.errors.length) return { ...summary, status: \"unparsed\", dynamic: true };\n    const exported = parsed.program.body.find((node) => node.type === \"ExportDefaultDeclaration\");\n    let value: Node | undefined = exported ? unwrap(exported.declaration) : undefined;\n    if (\n      value?.type === \"CallExpression\" &&\n      value.callee.type === \"Identifier\" &&\n      value.callee.name === \"defineConfig\"\n    ) {\n      value = value.arguments[0];\n    }\n    if (value) value = unwrap(value);\n    if (value?.type !== \"ObjectExpression\")\n      return { ...summary, status: \"unparsed\", dynamic: true };\n\n    const object = value;\n    summary.status = \"static\";\n    // Fixed allowlist excludes custom keys, paths, names and all string values.\n    summary.sections = [\n      \"server\",\n      \"build\",\n      \"connectors\",\n      \"cli\",\n      \"devServer\",\n      \"database\",\n      \"testing\",\n    ].filter((name) => property(object, name) !== undefined);\n    summary.dynamic = object.properties.some(\n      (item) => item.type === \"SpreadElement\" || item.computed,\n    );\n    const build = property(object, \"build\");\n    if (build?.type === \"ObjectExpression\") {\n      for (const key of [\"minify\", \"sourcemap\", \"singleBundle\", \"esmShim\", \"splitting\"]) {\n        const flag = property(build, key);\n        if (flag?.type === \"Literal\" && typeof flag.value === \"boolean\")\n          summary.buildFlags[key] = flag.value;\n      }\n    }\n    const connectors = property(object, \"connectors\");\n    if (\n      connectors?.type === \"ArrayExpression\" &&\n      !connectors.elements.some((item) => item?.type === \"SpreadElement\")\n    ) {\n      summary.connectors = connectors.elements.length;\n    }\n    const cli = property(object, \"cli\");\n    const commands = cli?.type === \"ObjectExpression\" ? property(cli, \"commands\") : undefined;\n    if (\n      commands?.type === \"ArrayExpression\" &&\n      !commands.elements.some((item) => item?.type === \"SpreadElement\")\n    ) {\n      summary.customCommands = commands.elements.length;\n    }\n    return summary;\n  } catch {\n    return { ...summary, status: \"unparsed\", dynamic: true };\n  }\n}\n\n/** Collect installed metadata without starting the app or reading private values. */\nexport function collectIssueEnvironment(\n  cwd = process.cwd(),\n  userAgent = process.env.npm_config_user_agent,\n): IssueEnvironment {\n  const directories = moduleDirectories(cwd);\n  return {\n    packages: installedPackages(directories),\n    node: process.version,\n    packageManager: packageManager(cwd, userAgent),\n    os: { platform: os.platform(), release: os.release(), arch: os.arch() },\n    typescript: installedVersion(directories, \"typescript\"),\n    config: collectIssueConfig(cwd),\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+import { collectIssueEnvironment } from "./collect-environment.mjs";
+
+//#region ../../packages/core/src/cli/commands/issue/issue-command.action.ts
+const ISSUE_URL_MAX_LENGTH = 7500;
+const TRUNCATION_NOTE = "\n\n[Truncated for URL length. Paste the remaining reviewed warlock issue output here.]";
+function formatIssueEnvironment(environment) {
+	return JSON.stringify(environment, null, 2);
+}
+/** A draft only: the reporter must replace prompts and review before filing. */
+function frameworkIssueBody(type, environment) {
+	return [
+		type === "bug" ? "### Summary\nDescribe the framework bug." : "### Problem / use case\nDescribe the missing framework capability.",
+		`### Environment / warlock issue output\n\n\`\`\`json\n${formatIssueEnvironment(environment)}\n\`\`\``,
+		"### Minimal reproduction\nProvide public, minimal code and exact steps (a capability example for a feature).",
+		type === "bug" ? "### Expected behavior\nWhat should happen?" : "### Proposed behavior\nWhat should the framework support?",
+		"### Actual / current behavior\nWhat happens today?",
+		...type === "feature" ? ["### Alternatives considered\nDescribe workarounds and their limitations."] : [],
+		"### Sanitized logs / doctor output\nPaste relevant logs and warlock doctor --json output, or explain why unavailable / not applicable.",
+		"### Checks\n- [ ] Searched existing issues and checked installed-version CHANGELOG and skills.\n- [ ] Removed secrets, tokens, .env, customer data, proprietary code and private app names.\n- [ ] User reviewed this complete draft and approved filing."
+	].join("\n\n");
+}
+/** Encode all text, cap the entire ASCII URL and preserve Unicode code points. */
+function createFrameworkIssueUrl(type, title, environment) {
+	const body = Array.from(frameworkIssueBody(type, environment));
+	const environmentText = Array.from(formatIssueEnvironment(environment));
+	const makeUrl = (length) => {
+		const shorten = (text) => text.length > length ? text.slice(0, length).join("") + TRUNCATION_NOTE : text.join("");
+		const url = new URL("https://github.com/warlockjs/framework/issues/new");
+		url.search = new URLSearchParams({
+			template: `${type}.yml`,
+			title: Array.from(title).slice(0, 256).join(""),
+			body: shorten(body),
+			environment: shorten(environmentText)
+		}).toString();
+		return url.href;
+	};
+	let low = 0;
+	let high = Math.max(body.length, environmentText.length);
+	if (makeUrl(high).length <= 7500) return makeUrl(high);
+	while (low < high) {
+		const middle = Math.ceil((low + high) / 2);
+		if (makeUrl(middle).length <= 7500) low = middle;
+		else high = middle - 1;
+	}
+	return makeUrl(low);
+}
+async function issueCommandAction({ options }) {
+	const type = options.type ?? "bug";
+	if (type !== "bug" && type !== "feature") throw new Error("--type must be bug or feature.");
+	if (options.title !== void 0 && typeof options.title !== "string") throw new Error("--title must be a string.");
+	const title = options.title ?? (type === "bug" ? "[Bug] " : "[Feature] ");
+	const environment = collectIssueEnvironment();
+	const report = {
+		schemaVersion: 1,
+		environment,
+		url: createFrameworkIssueUrl(type, title, environment)
+	};
+	if (options.json === true) {
+		console.log(JSON.stringify(report, null, 2));
+		return;
+	}
+	console.log("Environment (review before sharing):");
+	console.log(formatIssueEnvironment(environment));
+	console.log("\nReview the draft, remove private information and ask the user before filing. Nothing has been sent.");
+	console.log(report.url);
+}
+
+//#endregion
+export { ISSUE_URL_MAX_LENGTH, createFrameworkIssueUrl, formatIssueEnvironment, frameworkIssueBody, issueCommandAction };
+//# sourceMappingURL=issue-command.action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issue-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/issue/issue-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { collectIssueEnvironment, type IssueEnvironment } from \"./collect-environment\";\n\nexport type FrameworkIssueType = \"bug\" | \"feature\";\nexport type IssueReport = { schemaVersion: 1; environment: IssueEnvironment; url: string };\n\n// A conservative budget, not a promised GitHub limit. GitHub documents 414\n// responses for oversized URLs, and form prefills use field IDs:\n// https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue\n// https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema\nexport const ISSUE_URL_MAX_LENGTH = 7_500;\nconst TRUNCATION_NOTE =\n  \"\\n\\n[Truncated for URL length. Paste the remaining reviewed warlock issue output here.]\";\n\nexport function formatIssueEnvironment(environment: IssueEnvironment): string {\n  return JSON.stringify(environment, null, 2);\n}\n\n/** A draft only: the reporter must replace prompts and review before filing. */\nexport function frameworkIssueBody(\n  type: FrameworkIssueType,\n  environment: IssueEnvironment,\n): string {\n  return [\n    type === \"bug\"\n      ? \"### Summary\\nDescribe the framework bug.\"\n      : \"### Problem / use case\\nDescribe the missing framework capability.\",\n    `### Environment / warlock issue output\\n\\n\\`\\`\\`json\\n${formatIssueEnvironment(environment)}\\n\\`\\`\\``,\n    \"### Minimal reproduction\\nProvide public, minimal code and exact steps (a capability example for a feature).\",\n    type === \"bug\"\n      ? \"### Expected behavior\\nWhat should happen?\"\n      : \"### Proposed behavior\\nWhat should the framework support?\",\n    \"### Actual / current behavior\\nWhat happens today?\",\n    ...(type === \"feature\"\n      ? [\"### Alternatives considered\\nDescribe workarounds and their limitations.\"]\n      : []),\n    \"### Sanitized logs / doctor output\\nPaste relevant logs and warlock doctor --json output, or explain why unavailable / not applicable.\",\n    \"### Checks\\n- [ ] Searched existing issues and checked installed-version CHANGELOG and skills.\\n- [ ] Removed secrets, tokens, .env, customer data, proprietary code and private app names.\\n- [ ] User reviewed this complete draft and approved filing.\",\n  ].join(\"\\n\\n\");\n}\n\n/** Encode all text, cap the entire ASCII URL and preserve Unicode code points. */\nexport function createFrameworkIssueUrl(\n  type: FrameworkIssueType,\n  title: string,\n  environment: IssueEnvironment,\n): string {\n  const body = Array.from(frameworkIssueBody(type, environment));\n  const environmentText = Array.from(formatIssueEnvironment(environment));\n  const makeUrl = (length: number): string => {\n    const shorten = (text: string[]): string =>\n      text.length > length ? text.slice(0, length).join(\"\") + TRUNCATION_NOTE : text.join(\"\");\n    const url = new URL(\"https://github.com/warlockjs/framework/issues/new\");\n    url.search = new URLSearchParams({\n      template: `${type}.yml`,\n      title: Array.from(title).slice(0, 256).join(\"\"),\n      body: shorten(body),\n      // YAML issue forms prefill by field ID, rather than the Markdown body.\n      environment: shorten(environmentText),\n    }).toString();\n    return url.href;\n  };\n  let low = 0;\n  let high = Math.max(body.length, environmentText.length);\n  if (makeUrl(high).length <= ISSUE_URL_MAX_LENGTH) return makeUrl(high);\n  while (low < high) {\n    const middle = Math.ceil((low + high) / 2);\n    if (makeUrl(middle).length <= ISSUE_URL_MAX_LENGTH) low = middle;\n    else high = middle - 1;\n  }\n  return makeUrl(low);\n}\n\nexport async function issueCommandAction({ options }: CommandActionData): Promise<void> {\n  const type = options.type ?? \"bug\";\n  if (type !== \"bug\" && type !== \"feature\") throw new Error(\"--type must be bug or feature.\");\n  if (options.title !== undefined && typeof options.title !== \"string\")\n    throw new Error(\"--title must be a string.\");\n  const title = options.title ?? (type === \"bug\" ? \"[Bug] \" : \"[Feature] \");\n  const environment = collectIssueEnvironment();\n  const report: IssueReport = {\n    schemaVersion: 1,\n    environment,\n    url: createFrameworkIssueUrl(type, title, environment),\n  };\n  if (options.json === true) {\n    console.log(JSON.stringify(report, null, 2));\n    return;\n  }\n  console.log(\"Environment (review before sharing):\");\n  console.log(formatIssueEnvironment(environment));\n  console.log(\n    \"\\nReview the draft, remove private information and ask the user before filing. Nothing has been sent.\",\n  );\n  console.log(report.url);\n}\n"],"mappings":";;;AAUA,MAAa,uBAAuB;AACpC,MAAM,kBACJ;AAEF,SAAgB,uBAAuB,aAAuC;CAC5E,OAAO,KAAK,UAAU,aAAa,MAAM,CAAC;AAC5C;;AAGA,SAAgB,mBACd,MACA,aACQ;CACR,OAAO;EACL,SAAS,QACL,6CACA;EACJ,yDAAyD,uBAAuB,WAAW,EAAE;EAC7F;EACA,SAAS,QACL,+CACA;EACJ;EACA,GAAI,SAAS,YACT,CAAC,0EAA0E,IAC3E,CAAC;EACL;EACA;CACF,CAAC,CAAC,KAAK,MAAM;AACf;;AAGA,SAAgB,wBACd,MACA,OACA,aACQ;CACR,MAAM,OAAO,MAAM,KAAK,mBAAmB,MAAM,WAAW,CAAC;CAC7D,MAAM,kBAAkB,MAAM,KAAK,uBAAuB,WAAW,CAAC;CACtE,MAAM,WAAW,WAA2B;EAC1C,MAAM,WAAW,SACf,KAAK,SAAS,SAAS,KAAK,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,kBAAkB,KAAK,KAAK,EAAE;EACxF,MAAM,MAAM,IAAI,IAAI,mDAAmD;EACvE,IAAI,SAAS,IAAI,gBAAgB;GAC/B,UAAU,GAAG,KAAK;GAClB,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE;GAC9C,MAAM,QAAQ,IAAI;GAElB,aAAa,QAAQ,eAAe;EACtC,CAAC,CAAC,CAAC,SAAS;EACZ,OAAO,IAAI;CACb;CACA,IAAI,MAAM;CACV,IAAI,OAAO,KAAK,IAAI,KAAK,QAAQ,gBAAgB,MAAM;CACvD,IAAI,QAAQ,IAAI,CAAC,CAAC,gBAAgC,OAAO,QAAQ,IAAI;CACrE,OAAO,MAAM,MAAM;EACjB,MAAM,SAAS,KAAK,MAAM,MAAM,QAAQ,CAAC;EACzC,IAAI,QAAQ,MAAM,CAAC,CAAC,gBAAgC,MAAM;OACrD,OAAO,SAAS;CACvB;CACA,OAAO,QAAQ,GAAG;AACpB;AAEA,eAAsB,mBAAmB,EAAE,WAA6C;CACtF,MAAM,OAAO,QAAQ,QAAQ;CAC7B,IAAI,SAAS,SAAS,SAAS,WAAW,MAAM,IAAI,MAAM,gCAAgC;CAC1F,IAAI,QAAQ,UAAU,UAAa,OAAO,QAAQ,UAAU,UAC1D,MAAM,IAAI,MAAM,2BAA2B;CAC7C,MAAM,QAAQ,QAAQ,UAAU,SAAS,QAAQ,WAAW;CAC5D,MAAM,cAAc,wBAAwB;CAC5C,MAAM,SAAsB;EAC1B,eAAe;EACf;EACA,KAAK,wBAAwB,MAAM,OAAO,WAAW;CACvD;CACA,IAAI,QAAQ,SAAS,MAAM;EACzB,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EAC3C;CACF;CACA,QAAQ,IAAI,sCAAsC;CAClD,QAAQ,IAAI,uBAAuB,WAAW,CAAC;CAC/C,QAAQ,IACN,uGACF;CACA,QAAQ,IAAI,OAAO,GAAG;AACxB"}

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

@@ -0,0 +1,31 @@
+import { command } from "../../commands/cli-command.mjs";
+import { issueCommandAction } from "./issue/issue-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/issue.command.ts
+/** Prepare a public issue locally, even when the app cannot boot. No preload. */
+const issueCommand = command({
+	name: "issue",
+	description: "Collect a safe environment summary and prepare a framework issue URL (never submits)",
+	action: issueCommandAction,
+	options: [
+		{
+			text: "--type",
+			description: "Issue type: bug (default) or feature",
+			type: "string"
+		},
+		{
+			text: "--title",
+			description: "Public issue title",
+			type: "string"
+		},
+		{
+			text: "--json, -j",
+			description: "Print environment and URL as JSON",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { issueCommand };
+//# sourceMappingURL=issue.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issue.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/issue.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { issueCommandAction } from \"./issue/issue-command.action\";\n\n/** Prepare a public issue locally, even when the app cannot boot. No preload. */\nexport const issueCommand = command({\n  name: \"issue\",\n  description:\n    \"Collect a safe environment summary and prepare a framework issue URL (never submits)\",\n  action: issueCommandAction,\n  options: [\n    { text: \"--type\", description: \"Issue type: bug (default) or feature\", type: \"string\" },\n    { text: \"--title\", description: \"Public issue title\", type: \"string\" },\n    { text: \"--json, -j\", description: \"Print environment and URL as JSON\", type: \"boolean\" },\n  ],\n});\n"],"mappings":";;;;;AAIA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP;GAAE,MAAM;GAAU,aAAa;GAAwC,MAAM;EAAS;EACtF;GAAE,MAAM;GAAW,aAAa;GAAsB,MAAM;EAAS;EACrE;GAAE,MAAM;GAAc,aAAa;GAAqC,MAAM;EAAU;CAC1F;AACF,CAAC"}

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

@@ -0,0 +1,104 @@
+import { getWarlockVersion } from "../../../utils/framework-vesion.mjs";
+import { featuresMap } from "../../../generations/features/index.mjs";
+import { bootForInspect, inspectOptionsFromBoot } from "../../../tooling/inspect/boot-for-inspect.mjs";
+import { inspectApp } from "../../../tooling/inspect/inspect-app.mjs";
+import { flushAndExit } from "../../flush-and-exit.mjs";
+import { createMcpContext } from "../../../tooling/mcp/create-mcp-context.mjs";
+import { resolveMcpTransport, startWarlockMcpServer } from "../../../tooling/mcp/start-mcp-server.mjs";
+
+//#region ../../packages/core/src/cli/commands/mcp/mcp-command.action.ts
+function stringOption(value) {
+	if (typeof value === "number") return String(value);
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* The transport `warlock mcp` options describe: stdio by default, HTTP with
+* `--http` (and `--host`, `--port`, `--path`, `--token` / `WARLOCK_MCP_TOKEN`).
+* Throws on a port that is not a number.
+*/
+function mcpTransportFromOptions(options, env = process.env) {
+	if (!(options.http === true || stringOption(options.host) !== void 0 || options.port !== void 0)) return { type: "stdio" };
+	const portText = stringOption(options.port);
+	const port = portText === void 0 ? 0 : Number(portText);
+	if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(`--port must be a number from 0 to 65535, got ${JSON.stringify(portText)}.`);
+	return {
+		type: "http",
+		host: stringOption(options.host) ?? "127.0.0.1",
+		port,
+		path: stringOption(options.path) ?? "/mcp",
+		token: stringOption(options.token) ?? stringOption(env.WARLOCK_MCP_TOKEN)
+	};
+}
+/**
+* Send `console.log` / `console.info` / `console.debug` to stderr for the rest
+* of the process: over stdio, stdout carries only JSON-RPC, so a stray log
+* line from the app (or the framework's logger) would corrupt the stream.
+*/
+function routeConsoleToStderr() {
+	const { log, info, debug } = console;
+	const toStderr = (...args) => console.error(...args);
+	console.log = toStderr;
+	console.info = toStderr;
+	console.debug = toStderr;
+	return () => {
+		console.log = log;
+		console.info = info;
+		console.debug = debug;
+	};
+}
+/** The read-only boot, run once on the first tool call that needs the app. */
+function lazyInspectOptions() {
+	let boot;
+	return () => {
+		boot ??= bootForInspect().then(inspectOptionsFromBoot);
+		return boot;
+	};
+}
+/**
+* Action behind `warlock mcp`.
+*
+* Serves the app's tools over MCP. The app is booted the `warlock inspect`
+* way — connectors booted, none started, no connection, no port — on the
+* first call that needs it, so the server answers `initialize` at once.
+* Runs until stdin closes (stdio) or SIGINT/SIGTERM.
+*/
+async function mcpCommandAction({ options }) {
+	const transport = mcpTransportFromOptions(options);
+	resolveMcpTransport(transport);
+	if (transport.type === "stdio") routeConsoleToStderr();
+	const allowWrites = options.allowWrites === true;
+	const inspectOptions = lazyInspectOptions();
+	const context = createMcpContext({
+		allowWrites,
+		inspect: async (sections) => inspectApp({
+			...await inspectOptions(),
+			sections
+		}),
+		...process.argv[1] ? { cliEntry: process.argv[1] } : {},
+		devtools: {
+			...stringOption(options.url) ? { url: stringOption(options.url) } : {},
+			...stringOption(options.devtoolsPath) ? { devtoolsPath: stringOption(options.devtoolsPath) } : {}
+		},
+		features: Object.keys(featuresMap)
+	});
+	const server = await startWarlockMcpServer({
+		context,
+		transport,
+		version: await getWarlockVersion()
+	});
+	console.error(`warlock mcp: ${server.tools.length} tools on ${server.url ?? "stdio"} (${allowWrites ? "writes allowed" : "read-only"})`);
+	let closing = false;
+	const stop = async () => {
+		if (closing) return;
+		closing = true;
+		await server.close();
+		await flushAndExit(0);
+	};
+	process.once("SIGINT", () => void stop());
+	process.once("SIGTERM", () => void stop());
+	if (transport.type === "stdio") process.stdin.once("end", () => void stop());
+}
+
+//#endregion
+export { mcpCommandAction, mcpTransportFromOptions, routeConsoleToStderr };
+//# sourceMappingURL=mcp-command.action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/mcp/mcp-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { featuresMap } from \"../../../generations/features\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, type InspectOptions } from \"../../../tooling/inspect/inspect-app\";\nimport { createMcpContext } from \"../../../tooling/mcp/create-mcp-context\";\nimport {\n  resolveMcpTransport,\n  startWarlockMcpServer,\n  type WarlockMcpTransport,\n} from \"../../../tooling/mcp/start-mcp-server\";\nimport { getWarlockVersion } from \"../../../utils/framework-vesion\";\nimport { flushAndExit } from \"../../flush-and-exit\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  if (typeof value === \"number\") return String(value);\n\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The transport `warlock mcp` options describe: stdio by default, HTTP with\n * `--http` (and `--host`, `--port`, `--path`, `--token` / `WARLOCK_MCP_TOKEN`).\n * Throws on a port that is not a number.\n */\nexport function mcpTransportFromOptions(\n  options: CommandActionData[\"options\"],\n  env: NodeJS.ProcessEnv = process.env,\n): WarlockMcpTransport {\n  const http =\n    options.http === true || stringOption(options.host) !== undefined || options.port !== undefined;\n\n  if (!http) return { type: \"stdio\" };\n\n  const portText = stringOption(options.port);\n  const port = portText === undefined ? 0 : Number(portText);\n\n  if (!Number.isInteger(port) || port < 0 || port > 65_535) {\n    throw new Error(`--port must be a number from 0 to 65535, got ${JSON.stringify(portText)}.`);\n  }\n\n  return {\n    type: \"http\",\n    host: stringOption(options.host) ?? \"127.0.0.1\",\n    port,\n    path: stringOption(options.path) ?? \"/mcp\",\n    token: stringOption(options.token) ?? stringOption(env.WARLOCK_MCP_TOKEN),\n  };\n}\n\n/**\n * Send `console.log` / `console.info` / `console.debug` to stderr for the rest\n * of the process: over stdio, stdout carries only JSON-RPC, so a stray log\n * line from the app (or the framework's logger) would corrupt the stream.\n */\nexport function routeConsoleToStderr(): () => void {\n  const { log, info, debug } = console;\n  const toStderr = (...args: unknown[]) => console.error(...args);\n\n  console.log = toStderr;\n  console.info = toStderr;\n  console.debug = toStderr;\n\n  return () => {\n    console.log = log;\n    console.info = info;\n    console.debug = debug;\n  };\n}\n\n/** The read-only boot, run once on the first tool call that needs the app. */\nfunction lazyInspectOptions(): () => Promise<InspectOptions> {\n  let boot: Promise<InspectOptions> | undefined;\n\n  return () => {\n    boot ??= bootForInspect().then(inspectOptionsFromBoot);\n\n    return boot;\n  };\n}\n\n/**\n * Action behind `warlock mcp`.\n *\n * Serves the app's tools over MCP. The app is booted the `warlock inspect`\n * way — connectors booted, none started, no connection, no port — on the\n * first call that needs it, so the server answers `initialize` at once.\n * Runs until stdin closes (stdio) or SIGINT/SIGTERM.\n */\nexport async function mcpCommandAction({ options }: CommandActionData): Promise<void> {\n  const transport = mcpTransportFromOptions(options);\n\n  // Refuse an unsafe bind before anything boots.\n  resolveMcpTransport(transport);\n\n  if (transport.type === \"stdio\") routeConsoleToStderr();\n\n  const allowWrites = options.allowWrites === true;\n  const inspectOptions = lazyInspectOptions();\n  const context = createMcpContext({\n    allowWrites,\n    inspect: async (sections) => inspectApp({ ...(await inspectOptions()), sections }),\n    ...(process.argv[1] ? { cliEntry: process.argv[1] } : {}),\n    devtools: {\n      ...(stringOption(options.url) ? { url: stringOption(options.url) } : {}),\n      ...(stringOption(options.devtoolsPath)\n        ? { devtoolsPath: stringOption(options.devtoolsPath) }\n        : {}),\n    },\n    features: Object.keys(featuresMap),\n  });\n\n  const server = await startWarlockMcpServer({\n    context,\n    transport,\n    version: await getWarlockVersion(),\n  });\n\n  console.error(\n    `warlock mcp: ${server.tools.length} tools on ${server.url ?? \"stdio\"} (${allowWrites ? \"writes allowed\" : \"read-only\"})`,\n  );\n\n  let closing = false;\n\n  const stop = async () => {\n    if (closing) return;\n    closing = true;\n    await server.close();\n    await flushAndExit(0);\n  };\n\n  process.once(\"SIGINT\", () => void stop());\n  process.once(\"SIGTERM\", () => void stop());\n\n  if (transport.type === \"stdio\") {\n    process.stdin.once(\"end\", () => void stop());\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAS,aAAa,OAAkE;CACtF,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,KAAK;CAElD,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,wBACd,SACA,MAAyB,QAAQ,KACZ;CAIrB,IAAI,EAFF,QAAQ,SAAS,QAAQ,aAAa,QAAQ,IAAI,MAAM,UAAa,QAAQ,SAAS,SAE7E,OAAO,EAAE,MAAM,QAAQ;CAElC,MAAM,WAAW,aAAa,QAAQ,IAAI;CAC1C,MAAM,OAAO,aAAa,SAAY,IAAI,OAAO,QAAQ;CAEzD,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO,OAChD,MAAM,IAAI,MAAM,gDAAgD,KAAK,UAAU,QAAQ,EAAE,EAAE;CAG7F,OAAO;EACL,MAAM;EACN,MAAM,aAAa,QAAQ,IAAI,KAAK;EACpC;EACA,MAAM,aAAa,QAAQ,IAAI,KAAK;EACpC,OAAO,aAAa,QAAQ,KAAK,KAAK,aAAa,IAAI,iBAAiB;CAC1E;AACF;;;;;;AAOA,SAAgB,uBAAmC;CACjD,MAAM,EAAE,KAAK,MAAM,UAAU;CAC7B,MAAM,YAAY,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAE9D,QAAQ,MAAM;CACd,QAAQ,OAAO;CACf,QAAQ,QAAQ;CAEhB,aAAa;EACX,QAAQ,MAAM;EACd,QAAQ,OAAO;EACf,QAAQ,QAAQ;CAClB;AACF;;AAGA,SAAS,qBAAoD;CAC3D,IAAI;CAEJ,aAAa;EACX,SAAS,eAAe,CAAC,CAAC,KAAK,sBAAsB;EAErD,OAAO;CACT;AACF;;;;;;;;;AAUA,eAAsB,iBAAiB,EAAE,WAA6C;CACpF,MAAM,YAAY,wBAAwB,OAAO;CAGjD,oBAAoB,SAAS;CAE7B,IAAI,UAAU,SAAS,SAAS,qBAAqB;CAErD,MAAM,cAAc,QAAQ,gBAAgB;CAC5C,MAAM,iBAAiB,mBAAmB;CAC1C,MAAM,UAAU,iBAAiB;EAC/B;EACA,SAAS,OAAO,aAAa,WAAW;GAAE,GAAI,MAAM,eAAe;GAAI;EAAS,CAAC;EACjF,GAAI,QAAQ,KAAK,KAAK,EAAE,UAAU,QAAQ,KAAK,GAAG,IAAI,CAAC;EACvD,UAAU;GACR,GAAI,aAAa,QAAQ,GAAG,IAAI,EAAE,KAAK,aAAa,QAAQ,GAAG,EAAE,IAAI,CAAC;GACtE,GAAI,aAAa,QAAQ,YAAY,IACjC,EAAE,cAAc,aAAa,QAAQ,YAAY,EAAE,IACnD,CAAC;EACP;EACA,UAAU,OAAO,KAAK,WAAW;CACnC,CAAC;CAED,MAAM,SAAS,MAAM,sBAAsB;EACzC;EACA;EACA,SAAS,MAAM,kBAAkB;CACnC,CAAC;CAED,QAAQ,MACN,gBAAgB,OAAO,MAAM,OAAO,YAAY,OAAO,OAAO,QAAQ,IAAI,cAAc,mBAAmB,YAAY,EACzH;CAEA,IAAI,UAAU;CAEd,MAAM,OAAO,YAAY;EACvB,IAAI,SAAS;EACb,UAAU;EACV,MAAM,OAAO,MAAM;EACnB,MAAM,aAAa,CAAC;CACtB;CAEA,QAAQ,KAAK,gBAAgB,KAAK,KAAK,CAAC;CACxC,QAAQ,KAAK,iBAAiB,KAAK,KAAK,CAAC;CAEzC,IAAI,UAAU,SAAS,SACrB,QAAQ,MAAM,KAAK,aAAa,KAAK,KAAK,CAAC;AAE/C"}

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

@@ -0,0 +1,76 @@
+import { command } from "../../commands/cli-command.mjs";
+import { mcpCommandAction, routeConsoleToStderr } from "./mcp/mcp-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/mcp.command.ts
+/**
+* `warlock mcp` — serve the app to coding agents over the Model Context
+* Protocol: `inspect_*` (routes, models, config keys, events, pages, jobs…),
+* `db_schema`, `docs_search` / `docs_read` (installed skills and docs only,
+* offline), `explain`, `check_run`, `test_run`, `requests_recent` (from
+* devtools) and `generate_make` / `generate_add` (a diff by default).
+*
+* stdio by default; `--http` serves Streamable HTTP on loopback (a token is
+* required off loopback). Read-only unless `--allow-writes`. Needs
+* `@warlock.js/ai-tools` (optional peer). Boots like `warlock inspect` — no
+* database connection, no port bound for the app — on the first tool call.
+*/
+const mcpCommand = command({
+	name: "mcp",
+	description: "Serve the app to coding agents over MCP (stdio, or --http): inspect, db schema, installed docs, check, tests, devtools requests, generator diffs; read-only unless --allow-writes",
+	action: mcpCommandAction,
+	persistent: true,
+	preAction: async (data) => {
+		if (!(data.options.http === true || data.options.host !== void 0 || data.options.port !== void 0)) routeConsoleToStderr();
+	},
+	preload: {
+		runtimeStrategy: "development",
+		config: true,
+		bootstrap: true
+	},
+	options: [
+		{
+			text: "--http",
+			description: "Serve MCP Streamable HTTP instead of stdio (loopback, a free port unless --port)",
+			type: "boolean"
+		},
+		{
+			text: "--host",
+			description: "HTTP bind address (default 127.0.0.1); anything but loopback requires --token",
+			type: "string"
+		},
+		{
+			text: "--port",
+			description: "HTTP port (default 0: a free port, printed on stderr)",
+			type: "string"
+		},
+		{
+			text: "--path",
+			description: "HTTP endpoint path (default /mcp)",
+			type: "string"
+		},
+		{
+			text: "--token",
+			description: "Bearer token HTTP clients must send (or WARLOCK_MCP_TOKEN)",
+			type: "string"
+		},
+		{
+			text: "--allow-writes",
+			description: "Let generate_make / generate_add write into the project (default: diff only)",
+			type: "boolean"
+		},
+		{
+			text: "--url",
+			description: "The dev server origin for requests_recent (default: read from .warlock/dev-server.json)",
+			type: "string"
+		},
+		{
+			text: "--devtools-path",
+			description: "The devtools mount for requests_recent (default /__warlock)",
+			type: "string"
+		}
+	]
+});
+
+//#endregion
+export { mcpCommand };
+//# sourceMappingURL=mcp.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/mcp.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { mcpCommandAction, routeConsoleToStderr } from \"./mcp/mcp-command.action\";\n\n/**\n * `warlock mcp` — serve the app to coding agents over the Model Context\n * Protocol: `inspect_*` (routes, models, config keys, events, pages, jobs…),\n * `db_schema`, `docs_search` / `docs_read` (installed skills and docs only,\n * offline), `explain`, `check_run`, `test_run`, `requests_recent` (from\n * devtools) and `generate_make` / `generate_add` (a diff by default).\n *\n * stdio by default; `--http` serves Streamable HTTP on loopback (a token is\n * required off loopback). Read-only unless `--allow-writes`. Needs\n * `@warlock.js/ai-tools` (optional peer). Boots like `warlock inspect` — no\n * database connection, no port bound for the app — on the first tool call.\n */\nexport const mcpCommand = command({\n  name: \"mcp\",\n  description:\n    \"Serve the app to coding agents over MCP (stdio, or --http): inspect, db schema, installed docs, check, tests, devtools requests, generator diffs; read-only unless --allow-writes\",\n  action: mcpCommandAction,\n  persistent: true,\n  preAction: async (data) => {\n    // Before the preloaders: over stdio, anything printed while config loads\n    // would corrupt the JSON-RPC stream on stdout.\n    const http =\n      data.options.http === true ||\n      data.options.host !== undefined ||\n      data.options.port !== undefined;\n\n    if (!http) routeConsoleToStderr();\n  },\n  preload: {\n    runtimeStrategy: \"development\",\n    config: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--http\",\n      description:\n        \"Serve MCP Streamable HTTP instead of stdio (loopback, a free port unless --port)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--host\",\n      description: \"HTTP bind address (default 127.0.0.1); anything but loopback requires --token\",\n      type: \"string\",\n    },\n    {\n      text: \"--port\",\n      description: \"HTTP port (default 0: a free port, printed on stderr)\",\n      type: \"string\",\n    },\n    {\n      text: \"--path\",\n      description: \"HTTP endpoint path (default /mcp)\",\n      type: \"string\",\n    },\n    {\n      text: \"--token\",\n      description: \"Bearer token HTTP clients must send (or WARLOCK_MCP_TOKEN)\",\n      type: \"string\",\n    },\n    {\n      text: \"--allow-writes\",\n      description: \"Let generate_make / generate_add write into the project (default: diff only)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--url\",\n      description:\n        \"The dev server origin for requests_recent (default: read from .warlock/dev-server.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--devtools-path\",\n      description: \"The devtools mount for requests_recent (default /__warlock)\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAa,aAAa,QAAQ;CAChC,MAAM;CACN,aACE;CACF,QAAQ;CACR,YAAY;CACZ,WAAW,OAAO,SAAS;EAQzB,IAAI,EAJF,KAAK,QAAQ,SAAS,QACtB,KAAK,QAAQ,SAAS,UACtB,KAAK,QAAQ,SAAS,SAEb,qBAAqB;CAClC;CACA,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,WAAW;CACb;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/openapi-generator.action.mjs

@@ -39,5 +39,5 @@ async function generateOpenApiAction({ options }) {
 }
 
 //#endregion
-export { generateOpenApiAction, stringOption };
+export { DEFAULT_OPENAPI_OUTPUT, generateOpenApiAction, stringOption };
 //# sourceMappingURL=openapi-generator.action.mjs.map

package/esm/cli/commands/openapi-generator.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-generator.action.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/openapi-generator.action.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { collectOpenApiDocument } from \"../../openapi/collect-openapi-document\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { rootPath } from \"../../utils/paths\";\n\n/** Where the document goes unless `--out` says otherwise. */\nexport const DEFAULT_OPENAPI_OUTPUT = \"storage/openapi/openapi.json\";\n\ntype OptionValue = CommandActionData[\"options\"][string];\n\nexport function stringOption(value: OptionValue | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock generate.openapi`.\n *\n * Builds the OpenAPI 3.1 document in a fresh registration child (no connectors are booted),\n * writes it as pretty JSON to `--out` (default `storage/openapi/openapi.json`) and prints the\n * per-route gaps it found as warnings. A child failure is fatal and rejects; gaps never are.\n */\nexport async function generateOpenApiAction({ options }: CommandActionData): Promise<void> {\n  const cwd = rootPath();\n  const output = path.resolve(cwd, stringOption(options.out) ?? DEFAULT_OPENAPI_OUTPUT);\n\n  const { document, warnings } = await collectOpenApiDocument({\n    cwd,\n    timeoutMs: resolveBuildConfig().routeRegistrationTimeoutMs,\n    title: stringOption(options.title),\n    server: stringOption(options.server),\n    includePages: options.includePages === true,\n  });\n\n  await mkdir(path.dirname(output), { recursive: true });\n  await writeFile(output, `${JSON.stringify(document, null, 2)}\\n`, \"utf8\");\n\n  const operations = Object.values(document.paths).reduce(\n    (total, item) => total + Object.keys(item).length,\n    0,\n  );\n\n  console.log(\n    colors.greenBright(\n      `OpenAPI ${document.openapi} written to ${output} (${Object.keys(document.paths).length} paths, ${operations} operations).`,\n    ),\n  );\n\n  if (warnings.length > 0) {\n    console.warn(colors.yellowBright(`\\n${warnings.length} warning${warnings.length === 1 ? \"\" : \"s\"}:`));\n\n    for (const warning of warnings) {\n      console.warn(`  - ${warning}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,yBAAyB;AAItC,SAAgB,aAAa,OAAoD;CAC/E,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;AASA,eAAsB,sBAAsB,EAAE,WAA6C;CACzF,MAAM,MAAM,SAAS;CACrB,MAAM,SAAS,KAAK,QAAQ,KAAK,aAAa,QAAQ,GAAG,mCAA2B;CAEpF,MAAM,EAAE,UAAU,aAAa,MAAM,uBAAuB;EAC1D;EACA,WAAW,mBAAmB,CAAC,CAAC;EAChC,OAAO,aAAa,QAAQ,KAAK;EACjC,QAAQ,aAAa,QAAQ,MAAM;EACnC,cAAc,QAAQ,iBAAiB;CACzC,CAAC;CAED,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;CACrD,MAAM,UAAU,QAAQ,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,KAAK,MAAM;CAExE,MAAM,aAAa,OAAO,OAAO,SAAS,KAAK,CAAC,CAAC,QAC9C,OAAO,SAAS,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,QAC3C,CACF;CAEA,QAAQ,IACN,OAAO,YACL,WAAW,SAAS,QAAQ,cAAc,OAAO,IAAI,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,OAAO,UAAU,WAAW,cAC/G,CACF;CAEA,IAAI,SAAS,SAAS,GAAG;EACvB,QAAQ,KAAK,OAAO,aAAa,KAAK,SAAS,OAAO,UAAU,SAAS,WAAW,IAAI,KAAK,IAAI,EAAE,CAAC;EAEpG,KAAK,MAAM,WAAW,UACpB,QAAQ,KAAK,OAAO,SAAS;CAEjC;AACF"}
+{"version":3,"file":"openapi-generator.action.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/openapi-generator.action.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { collectOpenApiDocument } from \"../../openapi/collect-openapi-document\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { rootPath } from \"../../utils/paths\";\n\n/** Where the document goes unless `--out` says otherwise. */\nexport const DEFAULT_OPENAPI_OUTPUT = \"storage/openapi/openapi.json\";\n\ntype OptionValue = CommandActionData[\"options\"][string];\n\nexport function stringOption(value: OptionValue | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock generate.openapi`.\n *\n * Builds the OpenAPI 3.1 document in a fresh registration child (no connectors are booted),\n * writes it as pretty JSON to `--out` (default `storage/openapi/openapi.json`) and prints the\n * per-route gaps it found as warnings. A child failure is fatal and rejects; gaps never are.\n */\nexport async function generateOpenApiAction({ options }: CommandActionData): Promise<void> {\n  const cwd = rootPath();\n  const output = path.resolve(cwd, stringOption(options.out) ?? DEFAULT_OPENAPI_OUTPUT);\n\n  const { document, warnings } = await collectOpenApiDocument({\n    cwd,\n    timeoutMs: resolveBuildConfig().routeRegistrationTimeoutMs,\n    title: stringOption(options.title),\n    server: stringOption(options.server),\n    includePages: options.includePages === true,\n  });\n\n  await mkdir(path.dirname(output), { recursive: true });\n  await writeFile(output, `${JSON.stringify(document, null, 2)}\\n`, \"utf8\");\n\n  const operations = Object.values(document.paths).reduce(\n    (total, item) => total + Object.keys(item).length,\n    0,\n  );\n\n  console.log(\n    colors.greenBright(\n      `OpenAPI ${document.openapi} written to ${output} (${Object.keys(document.paths).length} paths, ${operations} operations).`,\n    ),\n  );\n\n  if (warnings.length > 0) {\n    console.warn(\n      colors.yellowBright(`\\n${warnings.length} warning${warnings.length === 1 ? \"\" : \"s\"}:`),\n    );\n\n    for (const warning of warnings) {\n      console.warn(`  - ${warning}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,yBAAyB;AAItC,SAAgB,aAAa,OAAoD;CAC/E,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;AASA,eAAsB,sBAAsB,EAAE,WAA6C;CACzF,MAAM,MAAM,SAAS;CACrB,MAAM,SAAS,KAAK,QAAQ,KAAK,aAAa,QAAQ,GAAG,mCAA2B;CAEpF,MAAM,EAAE,UAAU,aAAa,MAAM,uBAAuB;EAC1D;EACA,WAAW,mBAAmB,CAAC,CAAC;EAChC,OAAO,aAAa,QAAQ,KAAK;EACjC,QAAQ,aAAa,QAAQ,MAAM;EACnC,cAAc,QAAQ,iBAAiB;CACzC,CAAC;CAED,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;CACrD,MAAM,UAAU,QAAQ,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,KAAK,MAAM;CAExE,MAAM,aAAa,OAAO,OAAO,SAAS,KAAK,CAAC,CAAC,QAC9C,OAAO,SAAS,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,QAC3C,CACF;CAEA,QAAQ,IACN,OAAO,YACL,WAAW,SAAS,QAAQ,cAAc,OAAO,IAAI,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,OAAO,UAAU,WAAW,cAC/G,CACF;CAEA,IAAI,SAAS,SAAS,GAAG;EACvB,QAAQ,KACN,OAAO,aAAa,KAAK,SAAS,OAAO,UAAU,SAAS,WAAW,IAAI,KAAK,IAAI,EAAE,CACxF;EAEA,KAAK,MAAM,WAAW,UACpB,QAAQ,KAAK,OAAO,SAAS;CAEjC;AACF"}

package/esm/cli/commands/openapi-generator.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-generator.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/openapi-generator.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { generateOpenApiAction } from \"./openapi-generator.action\";\n\n/**\n * `warlock generate.openapi` — write an OpenAPI 3.1 document derived from the registered\n * routes, handler validation, declared `responseSchema` and auth middleware.\n *\n * Named with a dot like `generate.typings`; the `generate` command itself is the scaffolder.\n * Routes are read in the same isolated child process `warlock build` uses, so no connector\n * is started and the app keeps running untouched.\n */\nexport const openApiGeneratorCommand = command({\n  name: \"generate.openapi\",\n  description: \"Generate an OpenAPI 3.1 document (storage/openapi/openapi.json) from the routes\",\n  action: generateOpenApiAction,\n  preload: {\n    warlockConfig: true,\n  },\n  options: [\n    {\n      text: \"--out, -o\",\n      description: \"Output file, relative to the project root (default storage/openapi/openapi.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--title\",\n      description: \"info.title (default: the name in package.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--server\",\n      description: \"servers[0].url (default: built from the http config)\",\n      type: \"string\",\n    },\n    {\n      text: \"--include-pages\",\n      description: \"Also document page (SSR) routes\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"openapi-generator.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/openapi-generator.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { generateOpenApiAction } from \"./openapi-generator.action\";\n\n/**\n * `warlock generate.openapi` — write an OpenAPI 3.1 document derived from the registered\n * routes, handler validation, declared `responseSchema` and auth middleware.\n *\n * Named with a dot like `generate.typings`; the `generate` command itself is the scaffolder.\n * Routes are read in the same isolated child process `warlock build` uses, so no connector\n * is started and the app keeps running untouched.\n */\nexport const openApiGeneratorCommand = command({\n  name: \"generate.openapi\",\n  description: \"Generate an OpenAPI 3.1 document (storage/openapi/openapi.json) from the routes\",\n  action: generateOpenApiAction,\n  preload: {\n    warlockConfig: true,\n  },\n  options: [\n    {\n      text: \"--out, -o\",\n      description:\n        \"Output file, relative to the project root (default storage/openapi/openapi.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--title\",\n      description: \"info.title (default: the name in package.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--server\",\n      description: \"servers[0].url (default: built from the http config)\",\n      type: \"string\",\n    },\n    {\n      text: \"--include-pages\",\n      description: \"Also document page (SSR) routes\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/postman-generator.action.mjs

@@ -43,5 +43,5 @@ async function generatePostmanAction({ options }) {
 }
 
 //#endregion
-export { generatePostmanAction };
+export { DEFAULT_POSTMAN_OUTPUT, generatePostmanAction };
 //# sourceMappingURL=postman-generator.action.mjs.map

package/esm/cli/commands/postman-generator.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"postman-generator.action.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/postman-generator.action.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { collectOpenApiDocument } from \"../../openapi/collect-openapi-document\";\nimport { openApiToPostmanCollection } from \"../../openapi/postman/openapi-to-postman-collection\";\nimport type { PostmanItem } from \"../../openapi/postman/postman-types\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { rootPath } from \"../../utils/paths\";\nimport { stringOption } from \"./openapi-generator.action\";\n\n/** Where the collection goes unless `--out` says otherwise. */\nexport const DEFAULT_POSTMAN_OUTPUT = \"storage/postman/collection.json\";\n\nfunction countRequests(items: readonly PostmanItem[]): number {\n  return items.reduce((total, item) => total + (\"item\" in item ? countRequests(item.item) : 1), 0);\n}\n\n/**\n * Action behind `warlock generate.postman`.\n *\n * Gets the OpenAPI document exactly as `generate.openapi` does (same registration child, same\n * options), converts it to a Postman Collection v2.1.0 in this process and writes it as\n * pretty JSON to `--out` (default `storage/postman/collection.json`). The per-route gaps the\n * document builder found are printed as warnings. A child failure is fatal and rejects.\n */\nexport async function generatePostmanAction({ options }: CommandActionData): Promise<void> {\n  const cwd = rootPath();\n  const output = path.resolve(cwd, stringOption(options.out) ?? DEFAULT_POSTMAN_OUTPUT);\n\n  const { document, warnings } = await collectOpenApiDocument({\n    cwd,\n    timeoutMs: resolveBuildConfig().routeRegistrationTimeoutMs,\n    title: stringOption(options.title),\n    server: stringOption(options.server),\n    includePages: options.includePages === true,\n  });\n\n  const collection = openApiToPostmanCollection(document);\n\n  await mkdir(path.dirname(output), { recursive: true });\n  await writeFile(output, `${JSON.stringify(collection, null, 2)}\\n`, \"utf8\");\n\n  const folders = collection.item.filter((item) => \"item\" in item).length;\n\n  console.log(\n    colors.greenBright(\n      `Postman collection written to ${output} (${folders} folder${folders === 1 ? \"\" : \"s\"}, ${countRequests(collection.item)} requests). Import it in Postman and set the {{token}} variable.`,\n    ),\n  );\n\n  if (warnings.length > 0) {\n    console.warn(colors.yellowBright(`\\n${warnings.length} warning${warnings.length === 1 ? \"\" : \"s\"}:`));\n\n    for (const warning of warnings) {\n      console.warn(`  - ${warning}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,yBAAyB;AAEtC,SAAS,cAAc,OAAuC;CAC5D,OAAO,MAAM,QAAQ,OAAO,SAAS,SAAS,UAAU,OAAO,cAAc,KAAK,IAAI,IAAI,IAAI,CAAC;AACjG;;;;;;;;;AAUA,eAAsB,sBAAsB,EAAE,WAA6C;CACzF,MAAM,MAAM,SAAS;CACrB,MAAM,SAAS,KAAK,QAAQ,KAAK,aAAa,QAAQ,GAAG,sCAA2B;CAEpF,MAAM,EAAE,UAAU,aAAa,MAAM,uBAAuB;EAC1D;EACA,WAAW,mBAAmB,CAAC,CAAC;EAChC,OAAO,aAAa,QAAQ,KAAK;EACjC,QAAQ,aAAa,QAAQ,MAAM;EACnC,cAAc,QAAQ,iBAAiB;CACzC,CAAC;CAED,MAAM,aAAa,2BAA2B,QAAQ;CAEtD,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;CACrD,MAAM,UAAU,QAAQ,GAAG,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,KAAK,MAAM;CAE1E,MAAM,UAAU,WAAW,KAAK,QAAQ,SAAS,UAAU,IAAI,CAAC,CAAC;CAEjE,QAAQ,IACN,OAAO,YACL,iCAAiC,OAAO,IAAI,QAAQ,SAAS,YAAY,IAAI,KAAK,IAAI,IAAI,cAAc,WAAW,IAAI,EAAE,iEAC3H,CACF;CAEA,IAAI,SAAS,SAAS,GAAG;EACvB,QAAQ,KAAK,OAAO,aAAa,KAAK,SAAS,OAAO,UAAU,SAAS,WAAW,IAAI,KAAK,IAAI,EAAE,CAAC;EAEpG,KAAK,MAAM,WAAW,UACpB,QAAQ,KAAK,OAAO,SAAS;CAEjC;AACF"}
+{"version":3,"file":"postman-generator.action.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/postman-generator.action.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { collectOpenApiDocument } from \"../../openapi/collect-openapi-document\";\nimport { openApiToPostmanCollection } from \"../../openapi/postman/openapi-to-postman-collection\";\nimport type { PostmanItem } from \"../../openapi/postman/postman-types\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { rootPath } from \"../../utils/paths\";\nimport { stringOption } from \"./openapi-generator.action\";\n\n/** Where the collection goes unless `--out` says otherwise. */\nexport const DEFAULT_POSTMAN_OUTPUT = \"storage/postman/collection.json\";\n\nfunction countRequests(items: readonly PostmanItem[]): number {\n  return items.reduce((total, item) => total + (\"item\" in item ? countRequests(item.item) : 1), 0);\n}\n\n/**\n * Action behind `warlock generate.postman`.\n *\n * Gets the OpenAPI document exactly as `generate.openapi` does (same registration child, same\n * options), converts it to a Postman Collection v2.1.0 in this process and writes it as\n * pretty JSON to `--out` (default `storage/postman/collection.json`). The per-route gaps the\n * document builder found are printed as warnings. A child failure is fatal and rejects.\n */\nexport async function generatePostmanAction({ options }: CommandActionData): Promise<void> {\n  const cwd = rootPath();\n  const output = path.resolve(cwd, stringOption(options.out) ?? DEFAULT_POSTMAN_OUTPUT);\n\n  const { document, warnings } = await collectOpenApiDocument({\n    cwd,\n    timeoutMs: resolveBuildConfig().routeRegistrationTimeoutMs,\n    title: stringOption(options.title),\n    server: stringOption(options.server),\n    includePages: options.includePages === true,\n  });\n\n  const collection = openApiToPostmanCollection(document);\n\n  await mkdir(path.dirname(output), { recursive: true });\n  await writeFile(output, `${JSON.stringify(collection, null, 2)}\\n`, \"utf8\");\n\n  const folders = collection.item.filter((item) => \"item\" in item).length;\n\n  console.log(\n    colors.greenBright(\n      `Postman collection written to ${output} (${folders} folder${folders === 1 ? \"\" : \"s\"}, ${countRequests(collection.item)} requests). Import it in Postman and set the {{token}} variable.`,\n    ),\n  );\n\n  if (warnings.length > 0) {\n    console.warn(\n      colors.yellowBright(`\\n${warnings.length} warning${warnings.length === 1 ? \"\" : \"s\"}:`),\n    );\n\n    for (const warning of warnings) {\n      console.warn(`  - ${warning}`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,yBAAyB;AAEtC,SAAS,cAAc,OAAuC;CAC5D,OAAO,MAAM,QAAQ,OAAO,SAAS,SAAS,UAAU,OAAO,cAAc,KAAK,IAAI,IAAI,IAAI,CAAC;AACjG;;;;;;;;;AAUA,eAAsB,sBAAsB,EAAE,WAA6C;CACzF,MAAM,MAAM,SAAS;CACrB,MAAM,SAAS,KAAK,QAAQ,KAAK,aAAa,QAAQ,GAAG,sCAA2B;CAEpF,MAAM,EAAE,UAAU,aAAa,MAAM,uBAAuB;EAC1D;EACA,WAAW,mBAAmB,CAAC,CAAC;EAChC,OAAO,aAAa,QAAQ,KAAK;EACjC,QAAQ,aAAa,QAAQ,MAAM;EACnC,cAAc,QAAQ,iBAAiB;CACzC,CAAC;CAED,MAAM,aAAa,2BAA2B,QAAQ;CAEtD,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;CACrD,MAAM,UAAU,QAAQ,GAAG,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,KAAK,MAAM;CAE1E,MAAM,UAAU,WAAW,KAAK,QAAQ,SAAS,UAAU,IAAI,CAAC,CAAC;CAEjE,QAAQ,IACN,OAAO,YACL,iCAAiC,OAAO,IAAI,QAAQ,SAAS,YAAY,IAAI,KAAK,IAAI,IAAI,cAAc,WAAW,IAAI,EAAE,iEAC3H,CACF;CAEA,IAAI,SAAS,SAAS,GAAG;EACvB,QAAQ,KACN,OAAO,aAAa,KAAK,SAAS,OAAO,UAAU,SAAS,WAAW,IAAI,KAAK,IAAI,EAAE,CACxF;EAEA,KAAK,MAAM,WAAW,UACpB,QAAQ,KAAK,OAAO,SAAS;CAEjC;AACF"}

package/esm/cli/commands/postman-generator.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"postman-generator.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/postman-generator.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { generatePostmanAction } from \"./postman-generator.action\";\n\n/**\n * `warlock generate.postman` — write a Postman Collection v2.1.0 derived from the same\n * OpenAPI document `generate.openapi` produces, so the two never disagree.\n *\n * Routes are read in the same isolated child process `warlock build` uses; the conversion\n * itself is pure and runs in the CLI process.\n */\nexport const postmanGeneratorCommand = command({\n  name: \"generate.postman\",\n  description: \"Generate a Postman collection (storage/postman/collection.json) from the routes\",\n  action: generatePostmanAction,\n  preload: {\n    warlockConfig: true,\n  },\n  options: [\n    {\n      text: \"--out, -o\",\n      description: \"Output file, relative to the project root (default storage/postman/collection.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--title\",\n      description: \"Collection name (default: the name in package.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--server\",\n      description: \"Value of {{baseUrl}} (default: built from the http config)\",\n      type: \"string\",\n    },\n    {\n      text: \"--include-pages\",\n      description: \"Also include page (SSR) routes\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"postman-generator.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/postman-generator.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { generatePostmanAction } from \"./postman-generator.action\";\n\n/**\n * `warlock generate.postman` — write a Postman Collection v2.1.0 derived from the same\n * OpenAPI document `generate.openapi` produces, so the two never disagree.\n *\n * Routes are read in the same isolated child process `warlock build` uses; the conversion\n * itself is pure and runs in the CLI process.\n */\nexport const postmanGeneratorCommand = command({\n  name: \"generate.postman\",\n  description: \"Generate a Postman collection (storage/postman/collection.json) from the routes\",\n  action: generatePostmanAction,\n  preload: {\n    warlockConfig: true,\n  },\n  options: [\n    {\n      text: \"--out, -o\",\n      description:\n        \"Output file, relative to the project root (default storage/postman/collection.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--title\",\n      description: \"Collection name (default: the name in package.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--server\",\n      description: \"Value of {{baseUrl}} (default: built from the http config)\",\n      type: \"string\",\n    },\n    {\n      text: \"--include-pages\",\n      description: \"Also include page (SSR) routes\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS,EACP,eAAe,KACjB;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}