@warlock.js/core 5.31.0 → 5.32.0

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

@@ -68,20 +68,21 @@ async function mcpCommandAction({ options }) {
 	if (transport.type === "stdio") routeConsoleToStderr();
 	const allowWrites = options.allowWrites === true;
 	const inspectOptions = lazyInspectOptions();
-	const server = await startWarlockMcpServer({
-		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 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()
 	});
@@ -99,5 +100,5 @@ async function mcpCommandAction({ options }) {
 }
 
 //#endregion
-export { mcpCommandAction, routeConsoleToStderr };
+export { mcpCommandAction, mcpTransportFromOptions, routeConsoleToStderr };
 //# sourceMappingURL=mcp-command.action.mjs.map

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

@@ -1 +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,SAAS,MAAM,sBAAsB;EACzC,SAdc,iBAAiB;GAC/B;GACA,SAAS,OAAO,aAAa,WAAW;IAAE,GAAI,MAAM,eAAe;IAAI;GAAS,CAAC;GACjF,GAAI,QAAQ,KAAK,KAAK,EAAE,UAAU,QAAQ,KAAK,GAAG,IAAI,CAAC;GACvD,UAAU;IACR,GAAI,aAAa,QAAQ,GAAG,IAAI,EAAE,KAAK,aAAa,QAAQ,GAAG,EAAE,IAAI,CAAC;IACtE,GAAI,aAAa,QAAQ,YAAY,IACjC,EAAE,cAAc,aAAa,QAAQ,YAAY,EAAE,IACnD,CAAC;GACP;GACA,UAAU,OAAO,KAAK,WAAW;EACnC,CAGQ;EACN;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"}
+{"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/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/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/routes/format-routes-table.mjs

@@ -125,5 +125,5 @@ function printRoutesTable(rows) {
 }
 
 //#endregion
-export { printRoutesTable };
+export { printRoutesTable, routesSummary };
 //# sourceMappingURL=format-routes-table.mjs.map

package/esm/cli/commands/routes/route-row.mjs

@@ -88,5 +88,5 @@ function sortRouteRows(rows) {
 }
 
 //#endregion
-export { filterRouteRows, methodRank, sortRouteRows, toRouteRow };
+export { METHOD_ORDER, filterRouteRows, methodRank, sortRouteRows, toRouteRow };
 //# sourceMappingURL=route-row.mjs.map

package/esm/cli/commands/routes/routes-diff.action.mjs

@@ -3,7 +3,7 @@ import { bootForDiagnostics } from "../doctor/boot-for-diagnostics.mjs";
 import { resolveBuildConfig } from "../../../production/resolve-build-config.mjs";
 import { comparePageRoutes, diffPageRoutes } from "./diff-page-routes.mjs";
 import path from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 
 //#region ../../packages/core/src/cli/commands/routes/routes-diff.action.ts
 const SNAPSHOT_FILE = "page-routes.manifest.json";
@@ -26,7 +26,7 @@ function snapshotPath() {
 function readSnapshot(file) {
 	let raw;
 	try {
-		raw = fs.readFileSync(file, "utf-8");
+		raw = fsSync.readFileSync(file, "utf-8");
 	} catch {
 		throw new Error(`Cannot compare page routes: no build snapshot exists at "${file}". Run \`warlock build\` successfully, then run \`warlock routes:diff\` again.`);
 	}

package/esm/cli/commands/routes/routes-diff.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routes-diff.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/routes-diff.action.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { resolveBuildConfig } from \"../../../production/resolve-build-config\";\nimport { router } from \"../../../router/router\";\nimport type { Route } from \"../../../router/types\";\nimport { bootForDiagnostics } from \"../doctor/boot-for-diagnostics\";\nimport { comparePageRoutes, diffPageRoutes, type PageRoute } from \"./diff-page-routes\";\n\ntype PageRoutesSnapshot = {\n  version: 1;\n  routes: PageRoute[];\n};\n\nconst SNAPSHOT_FILE = \"page-routes.manifest.json\";\n\n/**\n * What a clean `warlock routes:diff` does and does NOT prove, printed on a\n * clean run so the guarantee is stated where it is relied on.\n */\nconst CLEAN_RUN_LIMIT =\n  \"Note: page names are compared as DERIVED by the build, so a clean diff does not prove \" +\n  \"that no route name collided at registration (the router appends `.<method>` to a name \" +\n  \"already claimed by another method). Run `warlock routes` to see the registered names.\";\n\nfunction routeFromLive(route: Route): PageRoute {\n  return {\n    method: route.method.toUpperCase() as \"GET\",\n    path: route.path,\n    name: route.name ?? \"\",\n    source: route.sourceFile ?? \"\",\n  };\n}\n\nfunction snapshotPath(): string {\n  return path.join(resolveBuildConfig().outdir, SNAPSHOT_FILE);\n}\n\nfunction readSnapshot(file: string): PageRoutesSnapshot {\n  let raw: string;\n\n  try {\n    raw = fs.readFileSync(file, \"utf-8\");\n  } catch {\n    throw new Error(\n      `Cannot compare page routes: no build snapshot exists at \"${file}\". Run \\`warlock build\\` successfully, then run \\`warlock routes:diff\\` again.`,\n    );\n  }\n\n  try {\n    const parsed: unknown = JSON.parse(raw);\n\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      (parsed as { version?: unknown }).version !== 1 ||\n      !Array.isArray((parsed as { routes?: unknown }).routes) ||\n      !(parsed as { routes: unknown[] }).routes.every(\n        (route) =>\n          typeof route === \"object\" &&\n          route !== null &&\n          (route as PageRoute).method === \"GET\" &&\n          typeof (route as PageRoute).path === \"string\" &&\n          typeof (route as PageRoute).name === \"string\" &&\n          typeof (route as PageRoute).source === \"string\",\n      )\n    ) {\n      throw new Error(\"invalid shape\");\n    }\n\n    return parsed as PageRoutesSnapshot;\n  } catch {\n    throw new Error(\n      `Cannot compare page routes: build snapshot \"${file}\" is malformed. Run \\`warlock build\\` successfully to replace it, then retry.`,\n    );\n  }\n}\n\nfunction printRoute(prefix: string, route: PageRoute): void {\n  const source = route.source ? ` (${route.source})` : \"\";\n  console.log(`${prefix} GET ${route.path}  ${route.name}${source}`);\n}\n\n/**\n * Compare the last successful production page surface with the live dev\n * surface.\n *\n * The comparison itself lives in `diff-page-routes.ts`, which also documents\n * why the route-name method suffix is the one registration-time difference the\n * build-time manifest cannot record — and therefore what a clean run of this\n * command does not prove.\n */\nexport async function routesDiffCommandAction(): Promise<void> {\n  const snapshot = readSnapshot(snapshotPath());\n  const context = await bootForDiagnostics();\n\n  if (\n    !context.booted ||\n    context.moduleFailures.length > 0 ||\n    context.connectors.failures.length > 0 ||\n    context.connectors.registrationError !== undefined\n  ) {\n    const details = [\n      ...context.moduleFailures.map(({ file, message }) => `${file}: ${message}`),\n      ...context.connectors.failures.map(({ name, message }) => `${name}: ${message}`),\n      ...(context.connectors.registrationError ? [context.connectors.registrationError] : []),\n    ];\n    throw new Error(\n      `Cannot compare page routes because diagnostic boot failed.${details.length ? `\\n${details.join(\"\\n\")}` : \"\"}`,\n    );\n  }\n\n  const live = router\n    .list()\n    .filter((route) => route.isPage)\n    .map(routeFromLive)\n    .sort(comparePageRoutes);\n  const expected = [...snapshot.routes].sort(comparePageRoutes);\n  const { changes, removed, added } = diffPageRoutes(expected, live);\n\n  if (changes.length === 0 && removed.length === 0 && added.length === 0) {\n    console.log(`Page routes match (${expected.length} routes).`);\n    console.log(CLEAN_RUN_LIMIT);\n    return;\n  }\n\n  for (const { before, after } of changes) {\n    printRoute(\"changed -\", before);\n    printRoute(\"        +\", after);\n  }\n  for (const route of removed) printRoute(\"removed -\", route);\n  for (const route of added) printRoute(\"added   +\", route);\n\n  throw new Error(\n    `Page route drift: ${changes.length} changed, ${removed.length} removed, ${added.length} added. Run \\`warlock build\\` after reviewing these changes.`,\n  );\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,gBAAgB;;;;;AAMtB,MAAM,kBACJ;AAIF,SAAS,cAAc,OAAyB;CAC9C,OAAO;EACL,QAAQ,MAAM,OAAO,YAAY;EACjC,MAAM,MAAM;EACZ,MAAM,MAAM,QAAQ;EACpB,QAAQ,MAAM,cAAc;CAC9B;AACF;AAEA,SAAS,eAAuB;CAC9B,OAAO,KAAK,KAAK,mBAAmB,CAAC,CAAC,QAAQ,aAAa;AAC7D;AAEA,SAAS,aAAa,MAAkC;CACtD,IAAI;CAEJ,IAAI;EACF,MAAM,GAAG,aAAa,MAAM,OAAO;CACrC,QAAQ;EACN,MAAM,IAAI,MACR,4DAA4D,KAAK,+EACnE;CACF;CAEA,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EAEtC,IACE,OAAO,WAAW,YAClB,WAAW,QACV,OAAiC,YAAY,KAC9C,CAAC,MAAM,QAAS,OAAgC,MAAM,KACtD,CAAE,OAAiC,OAAO,OACvC,UACC,OAAO,UAAU,YACjB,UAAU,QACT,MAAoB,WAAW,SAChC,OAAQ,MAAoB,SAAS,YACrC,OAAQ,MAAoB,SAAS,YACrC,OAAQ,MAAoB,WAAW,QAC3C,GAEA,MAAM,IAAI,MAAM,eAAe;EAGjC,OAAO;CACT,QAAQ;EACN,MAAM,IAAI,MACR,+CAA+C,KAAK,8EACtD;CACF;AACF;AAEA,SAAS,WAAW,QAAgB,OAAwB;CAC1D,MAAM,SAAS,MAAM,SAAS,KAAK,MAAM,OAAO,KAAK;CACrD,QAAQ,IAAI,GAAG,OAAO,OAAO,MAAM,KAAK,IAAI,MAAM,OAAO,QAAQ;AACnE;;;;;;;;;;AAWA,eAAsB,0BAAyC;CAC7D,MAAM,WAAW,aAAa,aAAa,CAAC;CAC5C,MAAM,UAAU,MAAM,mBAAmB;CAEzC,IACE,CAAC,QAAQ,UACT,QAAQ,eAAe,SAAS,KAChC,QAAQ,WAAW,SAAS,SAAS,KACrC,QAAQ,WAAW,sBAAsB,QACzC;EACA,MAAM,UAAU;GACd,GAAG,QAAQ,eAAe,KAAK,EAAE,MAAM,cAAc,GAAG,KAAK,IAAI,SAAS;GAC1E,GAAG,QAAQ,WAAW,SAAS,KAAK,EAAE,MAAM,cAAc,GAAG,KAAK,IAAI,SAAS;GAC/E,GAAI,QAAQ,WAAW,oBAAoB,CAAC,QAAQ,WAAW,iBAAiB,IAAI,CAAC;EACvF;EACA,MAAM,IAAI,MACR,6DAA6D,QAAQ,SAAS,KAAK,QAAQ,KAAK,IAAI,MAAM,IAC5G;CACF;CAEA,MAAM,OAAO,OACV,KAAK,CAAC,CACN,QAAQ,UAAU,MAAM,MAAM,CAAC,CAC/B,IAAI,aAAa,CAAC,CAClB,KAAK,iBAAiB;CACzB,MAAM,WAAW,CAAC,GAAG,SAAS,MAAM,CAAC,CAAC,KAAK,iBAAiB;CAC5D,MAAM,EAAE,SAAS,SAAS,UAAU,eAAe,UAAU,IAAI;CAEjE,IAAI,QAAQ,WAAW,KAAK,QAAQ,WAAW,KAAK,MAAM,WAAW,GAAG;EACtE,QAAQ,IAAI,sBAAsB,SAAS,OAAO,UAAU;EAC5D,QAAQ,IAAI,eAAe;EAC3B;CACF;CAEA,KAAK,MAAM,EAAE,QAAQ,WAAW,SAAS;EACvC,WAAW,aAAa,MAAM;EAC9B,WAAW,aAAa,KAAK;CAC/B;CACA,KAAK,MAAM,SAAS,SAAS,WAAW,aAAa,KAAK;CAC1D,KAAK,MAAM,SAAS,OAAO,WAAW,aAAa,KAAK;CAExD,MAAM,IAAI,MACR,qBAAqB,QAAQ,OAAO,YAAY,QAAQ,OAAO,YAAY,MAAM,OAAO,6DAC1F;AACF"}
+{"version":3,"file":"routes-diff.action.mjs","names":["fs"],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/routes-diff.action.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { resolveBuildConfig } from \"../../../production/resolve-build-config\";\nimport { router } from \"../../../router/router\";\nimport type { Route } from \"../../../router/types\";\nimport { bootForDiagnostics } from \"../doctor/boot-for-diagnostics\";\nimport { comparePageRoutes, diffPageRoutes, type PageRoute } from \"./diff-page-routes\";\n\ntype PageRoutesSnapshot = {\n  version: 1;\n  routes: PageRoute[];\n};\n\nconst SNAPSHOT_FILE = \"page-routes.manifest.json\";\n\n/**\n * What a clean `warlock routes:diff` does and does NOT prove, printed on a\n * clean run so the guarantee is stated where it is relied on.\n */\nconst CLEAN_RUN_LIMIT =\n  \"Note: page names are compared as DERIVED by the build, so a clean diff does not prove \" +\n  \"that no route name collided at registration (the router appends `.<method>` to a name \" +\n  \"already claimed by another method). Run `warlock routes` to see the registered names.\";\n\nfunction routeFromLive(route: Route): PageRoute {\n  return {\n    method: route.method.toUpperCase() as \"GET\",\n    path: route.path,\n    name: route.name ?? \"\",\n    source: route.sourceFile ?? \"\",\n  };\n}\n\nfunction snapshotPath(): string {\n  return path.join(resolveBuildConfig().outdir, SNAPSHOT_FILE);\n}\n\nfunction readSnapshot(file: string): PageRoutesSnapshot {\n  let raw: string;\n\n  try {\n    raw = fs.readFileSync(file, \"utf-8\");\n  } catch {\n    throw new Error(\n      `Cannot compare page routes: no build snapshot exists at \"${file}\". Run \\`warlock build\\` successfully, then run \\`warlock routes:diff\\` again.`,\n    );\n  }\n\n  try {\n    const parsed: unknown = JSON.parse(raw);\n\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      (parsed as { version?: unknown }).version !== 1 ||\n      !Array.isArray((parsed as { routes?: unknown }).routes) ||\n      !(parsed as { routes: unknown[] }).routes.every(\n        (route) =>\n          typeof route === \"object\" &&\n          route !== null &&\n          (route as PageRoute).method === \"GET\" &&\n          typeof (route as PageRoute).path === \"string\" &&\n          typeof (route as PageRoute).name === \"string\" &&\n          typeof (route as PageRoute).source === \"string\",\n      )\n    ) {\n      throw new Error(\"invalid shape\");\n    }\n\n    return parsed as PageRoutesSnapshot;\n  } catch {\n    throw new Error(\n      `Cannot compare page routes: build snapshot \"${file}\" is malformed. Run \\`warlock build\\` successfully to replace it, then retry.`,\n    );\n  }\n}\n\nfunction printRoute(prefix: string, route: PageRoute): void {\n  const source = route.source ? ` (${route.source})` : \"\";\n  console.log(`${prefix} GET ${route.path}  ${route.name}${source}`);\n}\n\n/**\n * Compare the last successful production page surface with the live dev\n * surface.\n *\n * The comparison itself lives in `diff-page-routes.ts`, which also documents\n * why the route-name method suffix is the one registration-time difference the\n * build-time manifest cannot record — and therefore what a clean run of this\n * command does not prove.\n */\nexport async function routesDiffCommandAction(): Promise<void> {\n  const snapshot = readSnapshot(snapshotPath());\n  const context = await bootForDiagnostics();\n\n  if (\n    !context.booted ||\n    context.moduleFailures.length > 0 ||\n    context.connectors.failures.length > 0 ||\n    context.connectors.registrationError !== undefined\n  ) {\n    const details = [\n      ...context.moduleFailures.map(({ file, message }) => `${file}: ${message}`),\n      ...context.connectors.failures.map(({ name, message }) => `${name}: ${message}`),\n      ...(context.connectors.registrationError ? [context.connectors.registrationError] : []),\n    ];\n    throw new Error(\n      `Cannot compare page routes because diagnostic boot failed.${details.length ? `\\n${details.join(\"\\n\")}` : \"\"}`,\n    );\n  }\n\n  const live = router\n    .list()\n    .filter((route) => route.isPage)\n    .map(routeFromLive)\n    .sort(comparePageRoutes);\n  const expected = [...snapshot.routes].sort(comparePageRoutes);\n  const { changes, removed, added } = diffPageRoutes(expected, live);\n\n  if (changes.length === 0 && removed.length === 0 && added.length === 0) {\n    console.log(`Page routes match (${expected.length} routes).`);\n    console.log(CLEAN_RUN_LIMIT);\n    return;\n  }\n\n  for (const { before, after } of changes) {\n    printRoute(\"changed -\", before);\n    printRoute(\"        +\", after);\n  }\n  for (const route of removed) printRoute(\"removed -\", route);\n  for (const route of added) printRoute(\"added   +\", route);\n\n  throw new Error(\n    `Page route drift: ${changes.length} changed, ${removed.length} removed, ${added.length} added. Run \\`warlock build\\` after reviewing these changes.`,\n  );\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,gBAAgB;;;;;AAMtB,MAAM,kBACJ;AAIF,SAAS,cAAc,OAAyB;CAC9C,OAAO;EACL,QAAQ,MAAM,OAAO,YAAY;EACjC,MAAM,MAAM;EACZ,MAAM,MAAM,QAAQ;EACpB,QAAQ,MAAM,cAAc;CAC9B;AACF;AAEA,SAAS,eAAuB;CAC9B,OAAO,KAAK,KAAK,mBAAmB,CAAC,CAAC,QAAQ,aAAa;AAC7D;AAEA,SAAS,aAAa,MAAkC;CACtD,IAAI;CAEJ,IAAI;EACF,MAAMA,OAAG,aAAa,MAAM,OAAO;CACrC,QAAQ;EACN,MAAM,IAAI,MACR,4DAA4D,KAAK,+EACnE;CACF;CAEA,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EAEtC,IACE,OAAO,WAAW,YAClB,WAAW,QACV,OAAiC,YAAY,KAC9C,CAAC,MAAM,QAAS,OAAgC,MAAM,KACtD,CAAE,OAAiC,OAAO,OACvC,UACC,OAAO,UAAU,YACjB,UAAU,QACT,MAAoB,WAAW,SAChC,OAAQ,MAAoB,SAAS,YACrC,OAAQ,MAAoB,SAAS,YACrC,OAAQ,MAAoB,WAAW,QAC3C,GAEA,MAAM,IAAI,MAAM,eAAe;EAGjC,OAAO;CACT,QAAQ;EACN,MAAM,IAAI,MACR,+CAA+C,KAAK,8EACtD;CACF;AACF;AAEA,SAAS,WAAW,QAAgB,OAAwB;CAC1D,MAAM,SAAS,MAAM,SAAS,KAAK,MAAM,OAAO,KAAK;CACrD,QAAQ,IAAI,GAAG,OAAO,OAAO,MAAM,KAAK,IAAI,MAAM,OAAO,QAAQ;AACnE;;;;;;;;;;AAWA,eAAsB,0BAAyC;CAC7D,MAAM,WAAW,aAAa,aAAa,CAAC;CAC5C,MAAM,UAAU,MAAM,mBAAmB;CAEzC,IACE,CAAC,QAAQ,UACT,QAAQ,eAAe,SAAS,KAChC,QAAQ,WAAW,SAAS,SAAS,KACrC,QAAQ,WAAW,sBAAsB,QACzC;EACA,MAAM,UAAU;GACd,GAAG,QAAQ,eAAe,KAAK,EAAE,MAAM,cAAc,GAAG,KAAK,IAAI,SAAS;GAC1E,GAAG,QAAQ,WAAW,SAAS,KAAK,EAAE,MAAM,cAAc,GAAG,KAAK,IAAI,SAAS;GAC/E,GAAI,QAAQ,WAAW,oBAAoB,CAAC,QAAQ,WAAW,iBAAiB,IAAI,CAAC;EACvF;EACA,MAAM,IAAI,MACR,6DAA6D,QAAQ,SAAS,KAAK,QAAQ,KAAK,IAAI,MAAM,IAC5G;CACF;CAEA,MAAM,OAAO,OACV,KAAK,CAAC,CACN,QAAQ,UAAU,MAAM,MAAM,CAAC,CAC/B,IAAI,aAAa,CAAC,CAClB,KAAK,iBAAiB;CACzB,MAAM,WAAW,CAAC,GAAG,SAAS,MAAM,CAAC,CAAC,KAAK,iBAAiB;CAC5D,MAAM,EAAE,SAAS,SAAS,UAAU,eAAe,UAAU,IAAI;CAEjE,IAAI,QAAQ,WAAW,KAAK,QAAQ,WAAW,KAAK,MAAM,WAAW,GAAG;EACtE,QAAQ,IAAI,sBAAsB,SAAS,OAAO,UAAU;EAC5D,QAAQ,IAAI,eAAe;EAC3B;CACF;CAEA,KAAK,MAAM,EAAE,QAAQ,WAAW,SAAS;EACvC,WAAW,aAAa,MAAM;EAC9B,WAAW,aAAa,KAAK;CAC/B;CACA,KAAK,MAAM,SAAS,SAAS,WAAW,aAAa,KAAK;CAC1D,KAAK,MAAM,SAAS,OAAO,WAAW,aAAa,KAAK;CAExD,MAAM,IAAI,MACR,qBAAqB,QAAQ,OAAO,YAAY,QAAQ,OAAO,YAAY,MAAM,OAAO,6DAC1F;AACF"}

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

@@ -127,5 +127,5 @@ const testCommand = command({
 });
 
 //#endregion
-export { testCommand };
+export { buildVitestArguments, readTestCommandOptions, resolveProjectVitest, testCommand };
 //# sourceMappingURL=test.command.mjs.map

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

@@ -141,5 +141,5 @@ async function traceCommandAction({ args, options }) {
 }
 
 //#endregion
-export { traceCommandAction };
+export { collectHeaderValues, formatTraceSummary, parseHeaderValues, parseTraceBody, traceCommandAction, traceFailureExitCode };
 //# sourceMappingURL=trace-command.action.mjs.map

package/esm/cli/commands-loader.mjs

@@ -46,5 +46,5 @@ var CLICommandsLoader = class {
 const cliCommandsLoader = new CLICommandsLoader();
 
 //#endregion
-export { cliCommandsLoader };
+export { CLICommandsLoader, cliCommandsLoader };
 //# sourceMappingURL=commands-loader.mjs.map

package/esm/cli/framework-cli-commands.mjs

@@ -10,6 +10,7 @@ import { dropTablesCommand } from "./commands/drop-tables.command.mjs";
 import { explainCommand } from "./commands/explain.command.mjs";
 import { generateCommand, generateControllerCommand, generateEndpointCommand, generateMigrationCommand, generateModelCommand, generateModuleCommand, generateRepositoryCommand, generateResourceCommand, generateServiceCommand, generateUseCaseCommand, makeCommand } from "./commands/generate/generate.command.mjs";
 import { inspectCommand } from "./commands/inspect.command.mjs";
+import { issueCommand } from "./commands/issue.command.mjs";
 import { mcpCommand } from "./commands/mcp.command.mjs";
 import { migrateCommand } from "./commands/migrate.command.mjs";
 import { openApiGeneratorCommand } from "./commands/openapi-generator.command.mjs";
@@ -37,6 +38,7 @@ const frameworkCommands = [
 	routesDiffCommand,
 	inspectCommand,
 	explainCommand,
+	issueCommand,
 	checkCommand,
 	typecheckCommand,
 	mcpCommand,

package/esm/cli/framework-cli-commands.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\nimport { agentsMdCommand } from \"./commands/agents-md.command\";\nimport { boardCommand } from \"./commands/board.command\";\nimport { buildCommand } from \"./commands/build.command\";\nimport { checkCommand } from \"./commands/check.command\";\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\nimport { devServerCommand } from \"./commands/dev-server.command\";\nimport { doctorCommand } from \"./commands/doctor.command\";\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\nimport { explainCommand } from \"./commands/explain.command\";\nimport {\n  generateCommand,\n  generateControllerCommand,\n  generateEndpointCommand,\n  generateMigrationCommand,\n  generateModelCommand,\n  generateModuleCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  makeCommand,\n} from \"./commands/generate/generate.command\";\nimport { inspectCommand } from \"./commands/inspect.command\";\nimport { mcpCommand } from \"./commands/mcp.command\";\nimport { migrateCommand } from \"./commands/migrate.command\";\nimport { openApiGeneratorCommand } from \"./commands/openapi-generator.command\";\nimport { postmanGeneratorCommand } from \"./commands/postman-generator.command\";\nimport { routesCommand, routesDiffCommand } from \"./commands/routes.command\";\nimport { seedCommand } from \"./commands/seed.command\";\nimport { startProductionCommand } from \"./commands/start-production.command\";\nimport { traceCommand } from \"./commands/trace.command\";\nimport { storagePutCommand } from \"./commands/storage-put.command\";\nimport { typecheckCommand } from \"./commands/typecheck.command\";\nimport { testCommand } from \"./commands/test.command\";\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\nimport { updateCommand } from \"./commands/update.command\";\nimport { upgradeCommand } from \"./commands/upgrade.command\";\n\nexport const frameworkCommands = [\n  // development commands\n  devServerCommand,\n  typingsGeneratorCommand,\n  openApiGeneratorCommand,\n  postmanGeneratorCommand,\n\n  // testing commands\n  testCommand,\n\n  // diagnostics commands\n  doctorCommand,\n  routesCommand,\n  routesDiffCommand,\n  inspectCommand,\n  explainCommand,\n  checkCommand,\n  typecheckCommand,\n\n  // agent tooling commands\n  mcpCommand,\n  traceCommand,\n  agentsMdCommand,\n  boardCommand,\n\n  // production commands\n  buildCommand,\n  startProductionCommand,\n\n  // database commands\n  migrateCommand,\n  seedCommand,\n  createDatabaseCommand,\n  dropTablesCommand,\n\n  // generation/installation commands\n  addCommand,\n  updateCommand,\n  upgradeCommand,\n\n  // scaffolding commands\n  generateCommand,\n  makeCommand,\n  generateEndpointCommand,\n  generateModuleCommand,\n  generateControllerCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  generateModelCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateMigrationCommand,\n\n  // storage commands\n  storagePutCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,oBAAoB;CAE/B;CACA;CACA;CACA;CAGA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}
+{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\nimport { agentsMdCommand } from \"./commands/agents-md.command\";\nimport { boardCommand } from \"./commands/board.command\";\nimport { buildCommand } from \"./commands/build.command\";\nimport { checkCommand } from \"./commands/check.command\";\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\nimport { devServerCommand } from \"./commands/dev-server.command\";\nimport { doctorCommand } from \"./commands/doctor.command\";\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\nimport { explainCommand } from \"./commands/explain.command\";\nimport {\n  generateCommand,\n  generateControllerCommand,\n  generateEndpointCommand,\n  generateMigrationCommand,\n  generateModelCommand,\n  generateModuleCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  makeCommand,\n} from \"./commands/generate/generate.command\";\nimport { inspectCommand } from \"./commands/inspect.command\";\nimport { issueCommand } from \"./commands/issue.command\";\nimport { mcpCommand } from \"./commands/mcp.command\";\nimport { migrateCommand } from \"./commands/migrate.command\";\nimport { openApiGeneratorCommand } from \"./commands/openapi-generator.command\";\nimport { postmanGeneratorCommand } from \"./commands/postman-generator.command\";\nimport { routesCommand, routesDiffCommand } from \"./commands/routes.command\";\nimport { seedCommand } from \"./commands/seed.command\";\nimport { startProductionCommand } from \"./commands/start-production.command\";\nimport { traceCommand } from \"./commands/trace.command\";\nimport { storagePutCommand } from \"./commands/storage-put.command\";\nimport { typecheckCommand } from \"./commands/typecheck.command\";\nimport { testCommand } from \"./commands/test.command\";\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\nimport { updateCommand } from \"./commands/update.command\";\nimport { upgradeCommand } from \"./commands/upgrade.command\";\n\nexport const frameworkCommands = [\n  // development commands\n  devServerCommand,\n  typingsGeneratorCommand,\n  openApiGeneratorCommand,\n  postmanGeneratorCommand,\n\n  // testing commands\n  testCommand,\n\n  // diagnostics commands\n  doctorCommand,\n  routesCommand,\n  routesDiffCommand,\n  inspectCommand,\n  explainCommand,\n  issueCommand,\n  checkCommand,\n  typecheckCommand,\n\n  // agent tooling commands\n  mcpCommand,\n  traceCommand,\n  agentsMdCommand,\n  boardCommand,\n\n  // production commands\n  buildCommand,\n  startProductionCommand,\n\n  // database commands\n  migrateCommand,\n  seedCommand,\n  createDatabaseCommand,\n  dropTablesCommand,\n\n  // generation/installation commands\n  addCommand,\n  updateCommand,\n  upgradeCommand,\n\n  // scaffolding commands\n  generateCommand,\n  makeCommand,\n  generateEndpointCommand,\n  generateModuleCommand,\n  generateControllerCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  generateModelCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateMigrationCommand,\n\n  // storage commands\n  storagePutCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAa,oBAAoB;CAE/B;CACA;CACA;CACA;CAGA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}

package/esm/cli/parse-cli-args.mjs

@@ -18,12 +18,12 @@ var CliOptionValueError = class extends Error {
 		this.name = "CliOptionValueError";
 	}
 };
-const TRUE_VALUES = new Set([
+const TRUE_VALUES = /* @__PURE__ */ new Set([
 	"true",
 	"1",
 	"yes"
 ]);
-const FALSE_VALUES = new Set([
+const FALSE_VALUES = /* @__PURE__ */ new Set([
 	"false",
 	"0",
 	"no"

package/esm/cli/parse-cli-args.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * The slice of a declared command option this parser needs.\n *\n * `CLICommand.commandOptions` (`ResolvedCLICommandOption[]`) satisfies it, but\n * the parser stays independent of the command classes so it can be unit-tested\n * and reused with a hand-written schema.\n */\nexport type CliOptionSchema = {\n  name?: string;\n  alias?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n};\n\n/**\n * Thrown when a declared boolean option is given a value that is neither\n * true-ish nor false-ish.\n *\n * We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`\n * was kept as the truthy string `\"false\"` and dropped every table. An option\n * that gates a destructive action must fail loudly on input it cannot read.\n */\nexport class CliOptionValueError extends Error {\n  /** Stable Warlock error code; `warlock explain WL7001` prints the fix. */\n  public readonly code = \"WL7001\";\n\n  public constructor(\n    public readonly optionToken: string,\n    public readonly value: string,\n  ) {\n    super(\n      `Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. ` +\n        `Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`,\n    );\n\n    this.name = \"CliOptionValueError\";\n  }\n}\n\nconst TRUE_VALUES = new Set([\"true\", \"1\", \"yes\"]);\nconst FALSE_VALUES = new Set([\"false\", \"0\", \"no\"]);\n\n/**\n * Collect the camelCased keys (names AND aliases) of every option the command\n * declared as `type: \"boolean\"`.\n *\n * Both sides are camelCased because declared names keep their raw kebab form\n * (`\"pending-only\"`) while the parser emits camelCase keys (`pendingOnly`).\n */\nfunction collectBooleanKeys(schema: CliOptionSchema[]): Set<string> {\n  const keys = new Set<string>();\n\n  for (const option of schema) {\n    if (option.type !== \"boolean\") continue;\n\n    if (option.name) {\n      keys.add(toCamelCase(option.name));\n    }\n\n    if (option.alias) {\n      keys.add(toCamelCase(option.alias));\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collect the declared aliases longer than one character (`-st`, `-rs`, `-pm`).\n *\n * A cluster equal to one of these is that alias, not a bundle of single-letter\n * flags, so it has to be matched before the bundle split.\n */\nfunction collectMultiCharAliases(schema: CliOptionSchema[]): Set<string> {\n  const aliases = new Set<string>();\n\n  for (const option of schema) {\n    if (option.alias && option.alias.length > 1) {\n      aliases.add(option.alias);\n    }\n  }\n\n  return aliases;\n}\n\n/**\n * Turn the value written after `=` into a real boolean, or throw.\n */\nfunction toBoolean(optionToken: string, value: string): boolean {\n  const normalized = value.toLowerCase();\n\n  if (TRUE_VALUES.has(normalized)) return true;\n  if (FALSE_VALUES.has(normalized)) return false;\n\n  throw new CliOptionValueError(optionToken, value);\n}\n\n/**\n * Parse CLI arguments from process.argv\n *\n * Called with a `schema` (the resolved command's declared options), every\n * option declared `type: \"boolean\"` is resolved as a boolean:\n * `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,\n * and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing\n * it as the flag's value. Anything else throws {@link CliOptionValueError}.\n *\n * Called without a schema — which is how the command name is discovered,\n * before any command object exists — behaviour is unchanged: every value stays\n * a raw string and a bare `--flag` still consumes the following non-dash token.\n * Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed\n * option must survive as the string `\"false\"`.\n *\n * Options the schema does not declare keep the schema-less behaviour.\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * // `rollback` declared as type: \"boolean\" — the file stays a positional\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"], migrateOptions)\n * // Returns: { name: \"migrate\", args: [\"file.ts\"], options: { rollback: true } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[], schema: CliOptionSchema[] = []): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n  const booleanKeys = collectBooleanKeys(schema);\n  const multiCharAliases = collectMultiCharAliases(schema);\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    // `i < argv.length` bounds this, but the compiler does not narrow an index\n    // read from a loop condition. Skipping rather than coercing: this file\n    // already refuses to guess about an operator's input (see\n    // `CliOptionValueError` above), and an `?? \"\"` here would silently push an\n    // empty POSITIONAL onto `args` — which for a command that takes a file or\n    // a table name is a scope the operator never typed.\n    if (arg === undefined) continue;\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key)\n          ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value)\n          : value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // A declared boolean NEVER consumes the next token: `--rollback\n        // users.ts` means \"rollback, and here is a positional\", not \"rollback\n        // the file users.ts\". Swallowing it silently discarded the operator's\n        // only stated scope and rolled back everything.\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          // If next arg exists and doesn't start with -, treat it as value\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const rawKey = flags.slice(0, equalIndex);\n        const key = toCamelCase(rawKey);\n        const value = flags.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;\n      } else if (flags.length === 1 || multiCharAliases.has(flags)) {\n        // Single flag: -f, or a declared multi-character alias: -st\n        const key = toCamelCase(flags);\n        const nextArg = argv[i + 1];\n\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        // A bundle carries no value and never consumes the next token, so a\n        // declared boolean already resolves to `true` here.\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":"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"}
+{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * The slice of a declared command option this parser needs.\n *\n * `CLICommand.commandOptions` (`ResolvedCLICommandOption[]`) satisfies it, but\n * the parser stays independent of the command classes so it can be unit-tested\n * and reused with a hand-written schema.\n */\nexport type CliOptionSchema = {\n  name?: string;\n  alias?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n};\n\n/**\n * Thrown when a declared boolean option is given a value that is neither\n * true-ish nor false-ish.\n *\n * We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`\n * was kept as the truthy string `\"false\"` and dropped every table. An option\n * that gates a destructive action must fail loudly on input it cannot read.\n */\nexport class CliOptionValueError extends Error {\n  /** Stable Warlock error code; `warlock explain WL7001` prints the fix. */\n  public readonly code = \"WL7001\";\n\n  public constructor(\n    public readonly optionToken: string,\n    public readonly value: string,\n  ) {\n    super(\n      `Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. ` +\n        `Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`,\n    );\n\n    this.name = \"CliOptionValueError\";\n  }\n}\n\nconst TRUE_VALUES = new Set([\"true\", \"1\", \"yes\"]);\nconst FALSE_VALUES = new Set([\"false\", \"0\", \"no\"]);\n\n/**\n * Collect the camelCased keys (names AND aliases) of every option the command\n * declared as `type: \"boolean\"`.\n *\n * Both sides are camelCased because declared names keep their raw kebab form\n * (`\"pending-only\"`) while the parser emits camelCase keys (`pendingOnly`).\n */\nfunction collectBooleanKeys(schema: CliOptionSchema[]): Set<string> {\n  const keys = new Set<string>();\n\n  for (const option of schema) {\n    if (option.type !== \"boolean\") continue;\n\n    if (option.name) {\n      keys.add(toCamelCase(option.name));\n    }\n\n    if (option.alias) {\n      keys.add(toCamelCase(option.alias));\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collect the declared aliases longer than one character (`-st`, `-rs`, `-pm`).\n *\n * A cluster equal to one of these is that alias, not a bundle of single-letter\n * flags, so it has to be matched before the bundle split.\n */\nfunction collectMultiCharAliases(schema: CliOptionSchema[]): Set<string> {\n  const aliases = new Set<string>();\n\n  for (const option of schema) {\n    if (option.alias && option.alias.length > 1) {\n      aliases.add(option.alias);\n    }\n  }\n\n  return aliases;\n}\n\n/**\n * Turn the value written after `=` into a real boolean, or throw.\n */\nfunction toBoolean(optionToken: string, value: string): boolean {\n  const normalized = value.toLowerCase();\n\n  if (TRUE_VALUES.has(normalized)) return true;\n  if (FALSE_VALUES.has(normalized)) return false;\n\n  throw new CliOptionValueError(optionToken, value);\n}\n\n/**\n * Parse CLI arguments from process.argv\n *\n * Called with a `schema` (the resolved command's declared options), every\n * option declared `type: \"boolean\"` is resolved as a boolean:\n * `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,\n * and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing\n * it as the flag's value. Anything else throws {@link CliOptionValueError}.\n *\n * Called without a schema — which is how the command name is discovered,\n * before any command object exists — behaviour is unchanged: every value stays\n * a raw string and a bare `--flag` still consumes the following non-dash token.\n * Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed\n * option must survive as the string `\"false\"`.\n *\n * Options the schema does not declare keep the schema-less behaviour.\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * // `rollback` declared as type: \"boolean\" — the file stays a positional\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"], migrateOptions)\n * // Returns: { name: \"migrate\", args: [\"file.ts\"], options: { rollback: true } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[], schema: CliOptionSchema[] = []): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n  const booleanKeys = collectBooleanKeys(schema);\n  const multiCharAliases = collectMultiCharAliases(schema);\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    // `i < argv.length` bounds this, but the compiler does not narrow an index\n    // read from a loop condition. Skipping rather than coercing: this file\n    // already refuses to guess about an operator's input (see\n    // `CliOptionValueError` above), and an `?? \"\"` here would silently push an\n    // empty POSITIONAL onto `args` — which for a command that takes a file or\n    // a table name is a scope the operator never typed.\n    if (arg === undefined) continue;\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key)\n          ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value)\n          : value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // A declared boolean NEVER consumes the next token: `--rollback\n        // users.ts` means \"rollback, and here is a positional\", not \"rollback\n        // the file users.ts\". Swallowing it silently discarded the operator's\n        // only stated scope and rolled back everything.\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          // If next arg exists and doesn't start with -, treat it as value\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const rawKey = flags.slice(0, equalIndex);\n        const key = toCamelCase(rawKey);\n        const value = flags.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;\n      } else if (flags.length === 1 || multiCharAliases.has(flags)) {\n        // Single flag: -f, or a declared multi-character alias: -st\n        const key = toCamelCase(flags);\n        const nextArg = argv[i + 1];\n\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        // A bundle carries no value and never consumes the next token, so a\n        // declared boolean already resolves to `true` here.\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":"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"}

package/esm/cli/start.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/esm/cli/string-similarity.mjs

@@ -61,5 +61,5 @@ function findSimilar(input, candidates, maxDistance = 3, maxResults = 3) {
 }
 
 //#endregion
-export { findSimilar };
+export { findSimilar, levenshteinDistance };
 //# sourceMappingURL=string-similarity.mjs.map

package/esm/commands/cli-command.d.mts

@@ -1,7 +1,6 @@
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
-
 //#region ../../packages/core/src/commands/cli-command.d.ts
-declare class CLICommand {
+export declare class CLICommand {
   name: string;
   /**
    * Command source
@@ -113,7 +112,6 @@ declare class CLICommand {
    */
   execute(data: CommandActionData): Promise<void>;
 }
-declare function command(options: CLICommandOptions): CLICommand;
+export declare function command(options: CLICommandOptions): CLICommand;
 //#endregion
-export { CLICommand, command };
 //# sourceMappingURL=cli-command.d.mts.map

package/esm/commands/cli-command.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/cli-command.ts"],"mappings":";;;cAWa,UAAA;EAqDF,IAAA;EArDE;;;EAIJ,aAAA,GAAgB,gBAAA;EAKA;;;EAAhB,aAAA,GAAgB,gBAAA;EAyDD;;;;EAnDf,gBAAA,GAAmB,gBAAA;EA0HT;;;EArHV,cAAA,GAAiB,iBAAA;EAqOA;;;EAhOjB,kBAAA;EAwOqC;;;EAnOrC,cAAA,EAAgB,wBAAA;EArBhB;;;;;EA4BA,mBAAA;EAZA;;;EAiBA,YAAA;EAAA;;;EAKA,YAAA;EAOL;;;cADO,IAAA,UACP,WAAA;EAoBK;;;EARA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAyBf;;;EAjBA,WAAA,CAAY,WAAA;EAyBL;;;EAjBP,UAAA,CAAW,YAAA;EAkCX;;;;EAzBA,KAAA,CAAM,KAAA;EA0CN;;;EAlCA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAoCpB;;;;EA3BK,SAAA,CAAU,MAAA,EAAQ,gBAAA;EA8Df;;;EAtDH,OAAA,CAAQ,OAAA,EAAS,gBAAA;EA+GhB;;;EAtGD,aAAA,CAAc,YAAA;EAoIR;;;EA5HN,MAAA,CAAO,MAAA,EAAQ,gBAAA;EACf,MAAA,CACL,IAAA,UACA,WAAA,WACA,OAAA,GAAU,IAAA,CAAK,gBAAA;EAwH2B;AAS9C;;;;;;;;EAT8C,UAvFlC,WAAA,CAAY,MAAA,EAAQ,gBAAA,GAAmB,wBAAA;;;;;;;;;UAyDzC,iBAAA;;;;EAsBD,OAAA,CAAQ,OAAA,EAAS,iBAAA;;;;EAQX,OAAA,CAAQ,IAAA,EAAM,iBAAA,GAAiB,OAAA;AAAA;AAAA,iBAS9B,OAAA,CAAQ,OAAA,EAAS,iBAAA,GAAiB,UAAA"}
+{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/cli-command.ts"],"mappings":";;qBAWa;EAqDF;;;;EAjDF,gBAAgB;;;;EAKhB,gBAAgB;;;;;EAMhB,mBAAmB;;;;EAKnB,iBAAiB;;;;EAKjB;;;;EAKA,gBAAgB;;;;;;EAOhB;;;;EAKA;;;;EAKA;;;;EAKP,YACS,cACP;;;;EAYK,OAAO,QAAQ;;;;EAQf,YAAY;;;;EAQZ,WAAW;;;;;EASX,MAAM;;;;EAQN,OAAO,QAAQ;;;;;EASf,UAAU,QAAQ;;;;EAQlB,QAAQ,SAAS;;;;EASjB,cAAc;;;;EAQd,OAAO,QAAQ;EACf,OACL,cACA,sBACA,UAAU,KAAK;;;;;;;;;;YAiCP,YAAY,QAAQ,mBAAmB;;;;;;;;;UAyDzC;;;;EAsBD,QAAQ,SAAS;;;;EAQX,QAAQ,MAAM,oBAAiB;;wBAS9B,QAAQ,SAAS,oBAAiB"}

package/esm/commands/index.d.mts

@@ -1,2 +1,3 @@
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
-import { CLICommand, command } from "./cli-command.mjs";
+import { CLICommand, command } from "./cli-command.mjs";
+export { CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, type CommandActionData, type ResolvedCLICommandOption, command };

package/esm/commands/index.mjs

@@ -1,3 +1,3 @@
 import { CLICommand, command } from "./cli-command.mjs";
 
-export {  };
+export { CLICommand, command };

package/esm/commands/types.d.mts

@@ -1,5 +1,6 @@
 import { RuntimeStrategy } from "../utils/environment.mjs";
 import { ConnectorName } from "../connectors/types.mjs";
+import "../connectors/index.mjs";
 //#region ../../packages/core/src/commands/types.d.ts
 /**
  * Indicates the origin/source of a CLI command.
@@ -8,7 +9,7 @@ import { ConnectorName } from "../connectors/types.mjs";
  * - `"plugin"` - Commands from installed Warlock.js plugins
  * - `"project"` - Custom commands defined in the project's source code
  */
-type CLICommandSource = "framework" | "plugin" | "project";
+export type CLICommandSource = "framework" | "plugin" | "project";
 /**
  * Data passed to command action and preAction functions.
  *
@@ -19,7 +20,7 @@ type CLICommandSource = "framework" | "plugin" | "project";
  *   options: { fresh: true, limit: "10" }
  * }
  */
-type CommandActionData = {
+export type CommandActionData = {
   /**
    * Positional arguments passed after the command name.
    * @example `warlock migrate users posts` → args: ["users", "posts"]
@@ -51,7 +52,7 @@ type CommandActionData = {
  *   connectors: true
  * }
  */
-type CLICommandPreload = {
+export type CLICommandPreload = {
   /**
    * Configuration files to load.
    * - `true` - Load all config files
@@ -119,7 +120,7 @@ type CLICommandPreload = {
  *   required: false
  * }
  */
-type CLICommandOption = {
+export type CLICommandOption = {
   /**
    * The raw option text as it appears in help output.
    * Supports formats: `"--port"`, `"-p"`, `"--port, -p"`, `"-p, --port"`
@@ -154,7 +155,7 @@ type CLICommandOption = {
    */
   required?: boolean;
 };
-type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
+export type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
   name: string;
   alias: string;
 };
@@ -162,7 +163,7 @@ type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
  * Command action function signature.
  * Receives parsed CLI data and can be sync or async.
  */
-type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
+export type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
 /**
  * Configuration object for creating a CLI command using the `command()` factory.
  *
@@ -183,7 +184,7 @@ type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
  *   }
  * })
  */
-type CLICommandOptions = {
+export type CLICommandOptions = {
   /**
    * The command name. Use dot notation for namespaced commands.
    * @example "migrate", "db.seed", "jwt.generate"
@@ -226,5 +227,4 @@ type CLICommandOptions = {
   options?: CLICommandOption[];
 };
 //#endregion
-export { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption };
 //# sourceMappingURL=types.d.mts.map

package/esm/commands/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/types.ts"],"mappings":";;;;;AAgB4B;AAY5B;;;;KAZY,gBAAA;;;;AAwBK;AAsBjB;;;;;;KAlCY,iBAAA;EAuDV;;;;EAlDA,IAAA;EAyFA;;;AAA0B;AAgB5B;EAlGE,OAAA,EAAS,MAAM;AAAA;;;;;;;;;;AAyIP;AAGV;;;;;;;;;KAtHY,iBAAA;EA+HA;;;;;EAzHV,MAAA;EAyHiE;;AAAO;EApHxE,QAAA;EA0I2B;;;EArI3B,aAAA;EA8KQ;;;EAzKR,eAAA,GAAkB,eAAA;EAqIlB;;;;;;;;;;;EAxHA,WAAA;EAkK0B;AAAA;;;;;;;;EAvJ1B,GAAA;;;;;EAMA,SAAA;;;;;;;;EASA,UAAA,GAAa,aAAa;AAAA;;;;;;;;;;;;;;KAgBhB,gBAAA;;;;;EAKV,IAAA;;;;;EAMA,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,IAAA;;;;EAKA,YAAA;;;;;EAMA,QAAA;AAAA;AAAA,KAGU,wBAAA,GAA2B,IAAI,CAAC,gBAAA;EAC1C,IAAA;EACA,KAAA;AAAA;;;;;KAOU,gBAAA,IAAoB,IAAA,EAAM,iBAAA,YAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;KAsB9D,iBAAA;;;;;EAKV,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,OAAA,GAAU,iBAAA;;;;;;EAOV,UAAA;;;;;EAMA,SAAA,GAAY,gBAAA;;;;;EAMZ,MAAA,EAAQ,gBAAA;;;;;EAMR,OAAA,GAAU,gBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/types.ts"],"mappings":";;;;;;;;;;;YAgBY;;;;;;;;;;;YAYA;;;;;EAKV;;;;;;EAOA,SAAS;;;;;;;;;;;;;;;;;;;;;YAsBC;;;;;;EAMV;;;;EAKA;;;;EAKA;;;;EAKA,kBAAkB;;;;;;;;;;;;EAalB;;;;;;;;;;EAWA;;;;;EAMA;;;;;;;;EASA,aAAa;;;;;;;;;;;;;;;YAgBH;;;;;EAKV;;;;;EAMA;;;;;EAMA;;;;EAKA;;;;;EAMA;;;;EAKA;;;;;EAMA;;YAGU,2BAA2B,KAAK;EAC1C;EACA;;;;;;YAOU,oBAAoB,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;YAsBvD;;;;;EAKV;;;;;EAMA;;;;EAKA;;;;;EAMA,UAAU;;;;;;EAOV;;;;;EAMA,YAAY;;;;;EAMZ,QAAQ;;;;;EAMR,UAAU"}

package/esm/config/config-getter.d.mts

@@ -1,5 +1,4 @@
 import { ConfigKey, ConfigRegistry } from "./types.mjs";
-
 //#region ../../packages/core/src/config/config-getter.d.ts
 /**
  * Config accessor interface with typed overloads
@@ -32,7 +31,7 @@ interface ConfigAccessor {
  * const port = config.key<number>("database.port", 27017);
  * ```
  */
-declare const config: ConfigAccessor;
+export declare const config: ConfigAccessor;
 //#endregion
-export { config };
+export {};
 //# sourceMappingURL=config-getter.d.mts.map

package/esm/config/config-getter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config-getter.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"mappings":";;;;;AACyD;UAK/C,cAAA;EAAc;;;EAItB,GAAA,UAAa,GAAA,EAAK,SAAA,kBAA2B,YAAA,GAAe,CAAA,GAAI,CAAA;EAM5C;;;;EAApB,GAAA,iBAAoB,cAAA,EAAgB,IAAA,EAAM,CAAA,EAAG,YAAA,GAAe,cAAA,CAAe,CAAA,IAAK,cAAA,CAAe,CAAA;EAAA;;;EAK/F,GAAA,UAAa,IAAA,UAAc,YAAA,GAAe,CAAA,GAAI,CAAA;AAAA;;;;;;;;;;;;;;cAgBnC,MAAA,EAAQ,cAQpB"}
+{"version":3,"file":"config-getter.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"mappings":";;;;;UAMU;;;;EAIR,IAAI,SAAS,KAAK,2BAA2B,eAAe,IAAI;;;;;EAMhE,IAAI,gBAAgB,gBAAgB,MAAM,GAAG,eAAe,eAAe,KAAK,eAAe;;;;EAK/F,IAAI,SAAS,cAAc,eAAe,IAAI;;;;;;;;;;;;;;;qBAgBnC,QAAQ"}