@warlock.js/core 5.29.0 → 5.31.0

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

@@ -0,0 +1,39 @@
+import { command } from "../../commands/cli-command.mjs";
+import { inspectCommandAction } from "./inspect/inspect-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/inspect.command.ts
+/**
+* `warlock inspect` — print the app's facts from its booted registries:
+* routes (middleware, guard, rate limit, logging, request/response schemas),
+* models, resources, config keys, event listeners, pages, queue jobs,
+* scheduled tasks and installed `@warlock.js/*` versions. `--json` prints the
+* versioned report (`schemaVersion: 1`); `--section` limits it.
+*
+* Boots like `warlock doctor`: connectors boot (routes register) but none
+* starts, so no database, cache or socket connection opens and no port binds.
+* `runtimeStrategy: "development"` for the same reason doctor declares it.
+*/
+const inspectCommand = command({
+	name: "inspect",
+	description: "Print the app's routes, models, resources, config keys, events, pages, jobs, schedules and package versions (read-only); --json for the versioned report",
+	action: inspectCommandAction,
+	preload: {
+		runtimeStrategy: "development",
+		config: true,
+		env: true,
+		bootstrap: true
+	},
+	options: [{
+		text: "--json, -j",
+		description: "Print the report as JSON (schemaVersion 1)",
+		type: "boolean"
+	}, {
+		text: "--section, -s",
+		description: "Comma-separated sections: routes, models, resources, config, events, pages, jobs, schedules, packages",
+		type: "string"
+	}]
+});
+
+//#endregion
+export { inspectCommand };
+//# sourceMappingURL=inspect.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/inspect.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { inspectCommandAction } from \"./inspect/inspect-command.action\";\n\n/**\n * `warlock inspect` — print the app's facts from its booted registries:\n * routes (middleware, guard, rate limit, logging, request/response schemas),\n * models, resources, config keys, event listeners, pages, queue jobs,\n * scheduled tasks and installed `@warlock.js/*` versions. `--json` prints the\n * versioned report (`schemaVersion: 1`); `--section` limits it.\n *\n * Boots like `warlock doctor`: connectors boot (routes register) but none\n * starts, so no database, cache or socket connection opens and no port binds.\n * `runtimeStrategy: \"development\"` for the same reason doctor declares it.\n */\nexport const inspectCommand = command({\n  name: \"inspect\",\n  description:\n    \"Print the app's routes, models, resources, config keys, events, pages, jobs, schedules and package versions (read-only); --json for the versioned report\",\n  action: inspectCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--json, -j\",\n      description: \"Print the report as JSON (schemaVersion 1)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--section, -s\",\n      description:\n        \"Comma-separated sections: routes, models, resources, config, events, pages, jobs, schedules, packages\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,iBAAiB,QAAQ;CACpC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,SAAS,CACP;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,GACA;EACE,MAAM;EACN,aACE;EACF,MAAM;CACR,CACF;AACF,CAAC"}

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

@@ -0,0 +1,103 @@
+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 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)
+		}),
+		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, 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,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"}

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/migrate.command.mjs

@@ -1,7 +1,7 @@
 import { command } from "../../commands/cli-command.mjs";
 import { migrateAction } from "../../database/migrate-action.mjs";
 
-//#region ../core/src/cli/commands/migrate.command.ts
+//#region ../../packages/core/src/cli/commands/migrate.command.ts
 const migrateCommand = command({
 	action: migrateAction,
 	name: "migrate",

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

@@ -1 +1 @@
-{"version":3,"file":"migrate.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/migrate.command.ts"],"sourcesContent":["import { migrateAction } from \"../../database/migrate-action\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const migrateCommand = command({\n  action: migrateAction,\n  name: \"migrate\",\n  description: \"Run database migrations\",\n  preload: {\n    config: [\"database\", \"log\"],\n    connectors: [\"database\", \"logger\", \"storage\"],\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Drop all tables and re-run migrations\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--rollback, -r\",\n      description: \"Rollback migrations, drop all tables\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--path, -p\",\n      description: \"Migration file path, if not provided, all migrations will be wroking\",\n      type: \"string\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"Show migration state: executed migrations, then what will run next\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--pending\",\n      description:\n        \"List only what will run next, in execution order. Exits 0 if nothing is pending, 1 if something is, 2 if it could not be determined\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--all, -a\",\n      description: \"List all migrations files in the app\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--sql, -s\",\n      description: \"Export all migrations as phase-ordered SQL files instead of executing them\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--pending-only\",\n      description: \"When used with --sql, exports only pending migrations instead of all\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--compact, -c\",\n      description:\n        \"When used with --sql, strips out generated comments and blank lines to reduce file size\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,iBAAiB,QAAQ;CACpC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ,CAAC,YAAY,KAAK;EAC1B,YAAY;GAAC;GAAY;GAAU;EAAS;CAC9C;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;EACA;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,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"migrate.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/migrate.command.ts"],"sourcesContent":["import { migrateAction } from \"../../database/migrate-action\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const migrateCommand = command({\n  action: migrateAction,\n  name: \"migrate\",\n  description: \"Run database migrations\",\n  preload: {\n    config: [\"database\", \"log\"],\n    connectors: [\"database\", \"logger\", \"storage\"],\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Drop all tables and re-run migrations\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--rollback, -r\",\n      description: \"Rollback migrations, drop all tables\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--path, -p\",\n      description: \"Migration file path, if not provided, all migrations will be wroking\",\n      type: \"string\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"Show migration state: executed migrations, then what will run next\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--pending\",\n      description:\n        \"List only what will run next, in execution order. Exits 0 if nothing is pending, 1 if something is, 2 if it could not be determined\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--all, -a\",\n      description: \"List all migrations files in the app\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--sql, -s\",\n      description: \"Export all migrations as phase-ordered SQL files instead of executing them\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--pending-only\",\n      description: \"When used with --sql, exports only pending migrations instead of all\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--compact, -c\",\n      description:\n        \"When used with --sql, strips out generated comments and blank lines to reduce file size\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,iBAAiB,QAAQ;CACpC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ,CAAC,YAAY,KAAK;EAC1B,YAAY;GAAC;GAAY;GAAU;EAAS;CAC9C;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;EACA;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,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

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

@@ -5,7 +5,7 @@ import path from "node:path";
 import { colors } from "@mongez/copper";
 import { mkdir, writeFile } from "node:fs/promises";
 
-//#region ../core/src/cli/commands/openapi-generator.action.ts
+//#region ../../packages/core/src/cli/commands/openapi-generator.action.ts
 /** Where the document goes unless `--out` says otherwise. */
 const DEFAULT_OPENAPI_OUTPUT = "storage/openapi/openapi.json";
 function stringOption(value) {

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

@@ -1 +1 @@
-{"version":3,"file":"openapi-generator.action.mjs","names":[],"sources":["../../../../../../../../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

@@ -1,7 +1,7 @@
 import { command } from "../../commands/cli-command.mjs";
 import { generateOpenApiAction } from "./openapi-generator.action.mjs";
 
-//#region ../core/src/cli/commands/openapi-generator.command.ts
+//#region ../../packages/core/src/cli/commands/openapi-generator.command.ts
 /**
 * `warlock generate.openapi` — write an OpenAPI 3.1 document derived from the registered
 * routes, handler validation, declared `responseSchema` and auth middleware.

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

@@ -1 +1 @@
-{"version":3,"file":"openapi-generator.command.mjs","names":[],"sources":["../../../../../../../../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

@@ -7,7 +7,7 @@ import path from "node:path";
 import { colors } from "@mongez/copper";
 import { mkdir, writeFile } from "node:fs/promises";
 
-//#region ../core/src/cli/commands/postman-generator.action.ts
+//#region ../../packages/core/src/cli/commands/postman-generator.action.ts
 /** Where the collection goes unless `--out` says otherwise. */
 const DEFAULT_POSTMAN_OUTPUT = "storage/postman/collection.json";
 function countRequests(items) {

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

@@ -1 +1 @@
-{"version":3,"file":"postman-generator.action.mjs","names":[],"sources":["../../../../../../../../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

@@ -1,7 +1,7 @@
 import { command } from "../../commands/cli-command.mjs";
 import { generatePostmanAction } from "./postman-generator.action.mjs";
 
-//#region ../core/src/cli/commands/postman-generator.command.ts
+//#region ../../packages/core/src/cli/commands/postman-generator.command.ts
 /**
 * `warlock generate.postman` — write a Postman Collection v2.1.0 derived from the same
 * OpenAPI document `generate.openapi` produces, so the two never disagree.

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

@@ -1 +1 @@
-{"version":3,"file":"postman-generator.command.mjs","names":[],"sources":["../../../../../../../../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"}

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

@@ -1,6 +1,6 @@
 import { matchesDerivedRouteName } from "../../../router/route-name-method-suffix.mjs";
 
-//#region ../core/src/cli/commands/routes/diff-page-routes.ts
+//#region ../../packages/core/src/cli/commands/routes/diff-page-routes.ts
 /**
 * The comparison half of `warlock routes:diff`, kept free of the filesystem,
 * the boot and the console so it can be exercised directly.

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

@@ -1 +1 @@
-{"version":3,"file":"diff-page-routes.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/diff-page-routes.ts"],"sourcesContent":["/**\n * The comparison half of `warlock routes:diff`, kept free of the filesystem,\n * the boot and the console so it can be exercised directly.\n *\n * WHAT THE TWO SIDES ACTUALLY ARE\n *\n * `expected` comes from `page-routes.manifest.json`, which `warlock build`\n * writes from a pure FILESYSTEM SCAN of the page graph. No application module\n * is imported, no connector boots, no route is registered.\n *\n * `live` comes from the running router, after real registration.\n *\n * Every difference between the two that is NOT drift has to be removed on the\n * producing side, so this comparison can stay a strict string equality — see\n * `normalizeRoutePath` for the path half. Exactly one property survives that\n * rule and is handled here instead, because it is genuinely unknowable at\n * build time: the route-name method suffix (below).\n */\nimport { matchesDerivedRouteName } from \"../../../router/route-name-method-suffix\";\n\nexport type PageRoute = {\n  method: \"GET\";\n  path: string;\n  name: string;\n  source: string;\n};\n\nexport type PageRouteChange = {\n  before: PageRoute;\n  after: PageRoute;\n};\n\nexport type PageRoutesDiff = {\n  changes: PageRouteChange[];\n  removed: PageRoute[];\n  added: PageRoute[];\n};\n\n/** Stable ordering for printed output: by path, then by name. */\nexport function comparePageRoutes(left: PageRoute, right: PageRoute): number {\n  return left.path.localeCompare(right.path) || left.name.localeCompare(right.name);\n}\n\n/**\n * Whether a live route is the same route the build recorded.\n *\n * Method and path must match EXACTLY. The name is compared derived-to-derived:\n * the router appends `.<method>` to a name already claimed by a route of\n * another method (`Router.add`), and which routes get that suffix depends on\n * the registration order across the whole route set — pages and API routes\n * alike. `warlock build` never boots connectors, so the manifest cannot see the\n * API routes that cause the collision and can never record the suffix.\n *\n * Ignoring it here is therefore not leniency, it is reading the manifest for\n * what it is: a record of what each page's name was DERIVED as, not of what it\n * was REGISTERED as. `matchesDerivedRouteName` accepts only the one suffix the\n * router itself could have appended; any other name difference is still drift.\n *\n * THE LIMIT THIS BUYS: a clean diff does not prove that no page name collided\n * at registration. Use `warlock routes` to see the names as registered.\n */\nfunction isSameRoute(expected: PageRoute, live: PageRoute): boolean {\n  return (\n    live.method === expected.method &&\n    live.path === expected.path &&\n    matchesDerivedRouteName(expected.name, live.name, live.method)\n  );\n}\n\n/**\n * Diff the build-time page route surface against the live one.\n *\n * Neither input is mutated and neither has to be pre-sorted; the returned lists\n * are sorted for printing.\n */\nexport function diffPageRoutes(expected: PageRoute[], live: PageRoute[]): PageRoutesDiff {\n  const remainingExpected = new Set(expected);\n  const remainingLive = new Set(live);\n  const changes: PageRouteChange[] = [];\n\n  // Route identity is the comparison contract. A differing source is displayed\n  // only as context and must not make an otherwise identical route drift (a\n  // checkout can be relocated without changing its surface).\n  for (const before of expected) {\n    const after = [...remainingLive].find((candidate) => isSameRoute(before, candidate));\n\n    if (after) {\n      remainingExpected.delete(before);\n      remainingLive.delete(after);\n    }\n  }\n\n  // A stable source is diagnostic context, never itself a diff. It only groups\n  // a changed page into one useful line instead of a removal plus an addition.\n  for (const before of remainingExpected) {\n    const after = [...remainingLive].find(\n      (candidate) => candidate.source !== \"\" && candidate.source === before.source,\n    );\n\n    if (after && !isSameRoute(before, after)) {\n      changes.push({ before, after });\n      remainingExpected.delete(before);\n      remainingLive.delete(after);\n    }\n  }\n\n  return {\n    changes: changes.sort((left, right) => comparePageRoutes(left.before, right.before)),\n    removed: [...remainingExpected].sort(comparePageRoutes),\n    added: [...remainingLive].sort(comparePageRoutes),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,kBAAkB,MAAiB,OAA0B;CAC3E,OAAO,KAAK,KAAK,cAAc,MAAM,IAAI,KAAK,KAAK,KAAK,cAAc,MAAM,IAAI;AAClF;;;;;;;;;;;;;;;;;;;AAoBA,SAAS,YAAY,UAAqB,MAA0B;CAClE,OACE,KAAK,WAAW,SAAS,UACzB,KAAK,SAAS,SAAS,QACvB,wBAAwB,SAAS,MAAM,KAAK,MAAM,KAAK,MAAM;AAEjE;;;;;;;AAQA,SAAgB,eAAe,UAAuB,MAAmC;CACvF,MAAM,oBAAoB,IAAI,IAAI,QAAQ;CAC1C,MAAM,gBAAgB,IAAI,IAAI,IAAI;CAClC,MAAM,UAA6B,CAAC;CAKpC,KAAK,MAAM,UAAU,UAAU;EAC7B,MAAM,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,MAAM,cAAc,YAAY,QAAQ,SAAS,CAAC;EAEnF,IAAI,OAAO;GACT,kBAAkB,OAAO,MAAM;GAC/B,cAAc,OAAO,KAAK;EAC5B;CACF;CAIA,KAAK,MAAM,UAAU,mBAAmB;EACtC,MAAM,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,MAC9B,cAAc,UAAU,WAAW,MAAM,UAAU,WAAW,OAAO,MACxE;EAEA,IAAI,SAAS,CAAC,YAAY,QAAQ,KAAK,GAAG;GACxC,QAAQ,KAAK;IAAE;IAAQ;GAAM,CAAC;GAC9B,kBAAkB,OAAO,MAAM;GAC/B,cAAc,OAAO,KAAK;EAC5B;CACF;CAEA,OAAO;EACL,SAAS,QAAQ,MAAM,MAAM,UAAU,kBAAkB,KAAK,QAAQ,MAAM,MAAM,CAAC;EACnF,SAAS,CAAC,GAAG,iBAAiB,CAAC,CAAC,KAAK,iBAAiB;EACtD,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,KAAK,iBAAiB;CAClD;AACF"}
+{"version":3,"file":"diff-page-routes.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/diff-page-routes.ts"],"sourcesContent":["/**\n * The comparison half of `warlock routes:diff`, kept free of the filesystem,\n * the boot and the console so it can be exercised directly.\n *\n * WHAT THE TWO SIDES ACTUALLY ARE\n *\n * `expected` comes from `page-routes.manifest.json`, which `warlock build`\n * writes from a pure FILESYSTEM SCAN of the page graph. No application module\n * is imported, no connector boots, no route is registered.\n *\n * `live` comes from the running router, after real registration.\n *\n * Every difference between the two that is NOT drift has to be removed on the\n * producing side, so this comparison can stay a strict string equality — see\n * `normalizeRoutePath` for the path half. Exactly one property survives that\n * rule and is handled here instead, because it is genuinely unknowable at\n * build time: the route-name method suffix (below).\n */\nimport { matchesDerivedRouteName } from \"../../../router/route-name-method-suffix\";\n\nexport type PageRoute = {\n  method: \"GET\";\n  path: string;\n  name: string;\n  source: string;\n};\n\nexport type PageRouteChange = {\n  before: PageRoute;\n  after: PageRoute;\n};\n\nexport type PageRoutesDiff = {\n  changes: PageRouteChange[];\n  removed: PageRoute[];\n  added: PageRoute[];\n};\n\n/** Stable ordering for printed output: by path, then by name. */\nexport function comparePageRoutes(left: PageRoute, right: PageRoute): number {\n  return left.path.localeCompare(right.path) || left.name.localeCompare(right.name);\n}\n\n/**\n * Whether a live route is the same route the build recorded.\n *\n * Method and path must match EXACTLY. The name is compared derived-to-derived:\n * the router appends `.<method>` to a name already claimed by a route of\n * another method (`Router.add`), and which routes get that suffix depends on\n * the registration order across the whole route set — pages and API routes\n * alike. `warlock build` never boots connectors, so the manifest cannot see the\n * API routes that cause the collision and can never record the suffix.\n *\n * Ignoring it here is therefore not leniency, it is reading the manifest for\n * what it is: a record of what each page's name was DERIVED as, not of what it\n * was REGISTERED as. `matchesDerivedRouteName` accepts only the one suffix the\n * router itself could have appended; any other name difference is still drift.\n *\n * THE LIMIT THIS BUYS: a clean diff does not prove that no page name collided\n * at registration. Use `warlock routes` to see the names as registered.\n */\nfunction isSameRoute(expected: PageRoute, live: PageRoute): boolean {\n  return (\n    live.method === expected.method &&\n    live.path === expected.path &&\n    matchesDerivedRouteName(expected.name, live.name, live.method)\n  );\n}\n\n/**\n * Diff the build-time page route surface against the live one.\n *\n * Neither input is mutated and neither has to be pre-sorted; the returned lists\n * are sorted for printing.\n */\nexport function diffPageRoutes(expected: PageRoute[], live: PageRoute[]): PageRoutesDiff {\n  const remainingExpected = new Set(expected);\n  const remainingLive = new Set(live);\n  const changes: PageRouteChange[] = [];\n\n  // Route identity is the comparison contract. A differing source is displayed\n  // only as context and must not make an otherwise identical route drift (a\n  // checkout can be relocated without changing its surface).\n  for (const before of expected) {\n    const after = [...remainingLive].find((candidate) => isSameRoute(before, candidate));\n\n    if (after) {\n      remainingExpected.delete(before);\n      remainingLive.delete(after);\n    }\n  }\n\n  // A stable source is diagnostic context, never itself a diff. It only groups\n  // a changed page into one useful line instead of a removal plus an addition.\n  for (const before of remainingExpected) {\n    const after = [...remainingLive].find(\n      (candidate) => candidate.source !== \"\" && candidate.source === before.source,\n    );\n\n    if (after && !isSameRoute(before, after)) {\n      changes.push({ before, after });\n      remainingExpected.delete(before);\n      remainingLive.delete(after);\n    }\n  }\n\n  return {\n    changes: changes.sort((left, right) => comparePageRoutes(left.before, right.before)),\n    removed: [...remainingExpected].sort(comparePageRoutes),\n    added: [...remainingLive].sort(comparePageRoutes),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,kBAAkB,MAAiB,OAA0B;CAC3E,OAAO,KAAK,KAAK,cAAc,MAAM,IAAI,KAAK,KAAK,KAAK,cAAc,MAAM,IAAI;AAClF;;;;;;;;;;;;;;;;;;;AAoBA,SAAS,YAAY,UAAqB,MAA0B;CAClE,OACE,KAAK,WAAW,SAAS,UACzB,KAAK,SAAS,SAAS,QACvB,wBAAwB,SAAS,MAAM,KAAK,MAAM,KAAK,MAAM;AAEjE;;;;;;;AAQA,SAAgB,eAAe,UAAuB,MAAmC;CACvF,MAAM,oBAAoB,IAAI,IAAI,QAAQ;CAC1C,MAAM,gBAAgB,IAAI,IAAI,IAAI;CAClC,MAAM,UAA6B,CAAC;CAKpC,KAAK,MAAM,UAAU,UAAU;EAC7B,MAAM,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,MAAM,cAAc,YAAY,QAAQ,SAAS,CAAC;EAEnF,IAAI,OAAO;GACT,kBAAkB,OAAO,MAAM;GAC/B,cAAc,OAAO,KAAK;EAC5B;CACF;CAIA,KAAK,MAAM,UAAU,mBAAmB;EACtC,MAAM,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,MAC9B,cAAc,UAAU,WAAW,MAAM,UAAU,WAAW,OAAO,MACxE;EAEA,IAAI,SAAS,CAAC,YAAY,QAAQ,KAAK,GAAG;GACxC,QAAQ,KAAK;IAAE;IAAQ;GAAM,CAAC;GAC9B,kBAAkB,OAAO,MAAM;GAC/B,cAAc,OAAO,KAAK;EAC5B;CACF;CAEA,OAAO;EACL,SAAS,QAAQ,MAAM,MAAM,UAAU,kBAAkB,KAAK,QAAQ,MAAM,MAAM,CAAC;EACnF,SAAS,CAAC,GAAG,iBAAiB,CAAC,CAAC,KAAK,iBAAiB;EACtD,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,KAAK,iBAAiB;CAClD;AACF"}

package/esm/cli/commands/routes/format-routes-table.mjs

@@ -1,7 +1,7 @@
 import { methodRank } from "./route-row.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/cli/commands/routes/format-routes-table.ts
+//#region ../../packages/core/src/cli/commands/routes/format-routes-table.ts
 /** The columns rendered, in order, with their header labels. */
 const COLUMNS = [
 	{

package/esm/cli/commands/routes/format-routes-table.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"format-routes-table.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/format-routes-table.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { methodRank, type RouteRow } from \"./route-row\";\n\n/** The columns rendered, in order, with their header labels. */\nconst COLUMNS = [\n  { key: \"method\", header: \"METHOD\" },\n  { key: \"path\", header: \"PATH\" },\n  { key: \"name\", header: \"NAME\" },\n  { key: \"action\", header: \"ACTION\" },\n  { key: \"middleware\", header: \"MW\" },\n  { key: \"source\", header: \"SOURCE\" },\n] as const;\n\ntype ColumnKey = (typeof COLUMNS)[number][\"key\"];\n\n/** Two spaces between columns. */\nconst GAP = \"  \";\n\n/** Shown for an empty string cell so the column doesn't read as a gap. */\nconst EMPTY_CELL = \"—\";\n\n/**\n * The plain (uncolored) text of one cell. Numbers render as-is; an empty string\n * renders as {@link EMPTY_CELL}. This is the single source of truth for both\n * the width math and the rendered text, so colored and uncolored output stay\n * aligned.\n *\n * @param row - The row\n * @param key - The column key\n * @returns The cell's printable text\n */\nfunction cellText(row: RouteRow, key: ColumnKey): string {\n  if (key === \"middleware\") return String(row.middleware);\n\n  const value = row[key] as string;\n\n  return value.length > 0 ? value : EMPTY_CELL;\n}\n\n/**\n * Per-column display width: the longest of the header and every cell.\n *\n * @param rows - The rows to measure\n * @returns One width per column, in column order\n */\nfunction columnWidths(rows: RouteRow[]): number[] {\n  return COLUMNS.map((column) =>\n    Math.max(column.header.length, ...rows.map((row) => cellText(row, column.key).length)),\n  );\n}\n\n/**\n * Build a one-line, human-readable summary: the total plus a per-method\n * breakdown ordered by {@link methodRank}, e.g.\n * `42 routes (38 GET · 2 POST · 1 PUT · 1 DELETE)`.\n *\n * @param rows - The rows being summarized\n * @returns The summary line\n */\nexport function routesSummary(rows: RouteRow[]): string {\n  const noun = rows.length === 1 ? \"route\" : \"routes\";\n\n  if (rows.length === 0) return `0 ${noun}`;\n\n  const counts = new Map<string, number>();\n\n  for (const row of rows) {\n    counts.set(row.method, (counts.get(row.method) ?? 0) + 1);\n  }\n\n  const breakdown = [...counts.entries()]\n    .sort(([a], [b]) => methodRank(a) - methodRank(b))\n    .map(([method, count]) => `${count} ${method}`)\n    .join(\" · \");\n\n  return `${rows.length} ${noun} (${breakdown})`;\n}\n\n/**\n * Render the routes table as an ordered list of plain (uncolored) lines:\n * a header row, one row per route, a blank line, then the summary. Returned as\n * strings (not printed) so the layout is unit-testable without ANSI noise.\n *\n * @param rows - The rows to render (already filtered/sorted by the caller)\n * @returns The lines to print, top to bottom\n */\nexport function formatRoutesTableLines(rows: RouteRow[]): string[] {\n  if (rows.length === 0) {\n    return [\"No routes registered.\"];\n  }\n\n  const widths = columnWidths(rows);\n\n  // `widths` is built from these same columns, so every index resolves. `?? 0`\n  // rather than an assertion: 0 is padEnd's no-op, so an unreadable width\n  // produces an UNALIGNED table rather than a crash — this renders `warlock\n  // routes`, and a table that throws tells the operator nothing about routes.\n  const renderRow = (cells: string[]) =>\n    cells\n      .map((text, index) => text.padEnd(widths[index] ?? 0))\n      .join(GAP)\n      .trimEnd();\n\n  const lines = [renderRow(COLUMNS.map((column) => column.header))];\n\n  for (const row of rows) {\n    lines.push(renderRow(COLUMNS.map((column) => cellText(row, column.key))));\n  }\n\n  lines.push(\"\");\n  lines.push(routesSummary(rows));\n\n  return lines;\n}\n\n/** Per-verb color for the METHOD column. Unknown verbs fall back to white. */\nconst METHOD_COLOR: Record<string, (input: string) => string> = {\n  GET: colors.green,\n  POST: colors.blue,\n  PUT: colors.yellow,\n  PATCH: colors.yellow,\n  DELETE: colors.red,\n  OPTIONS: colors.gray,\n  HEAD: colors.gray,\n  ALL: colors.magenta,\n};\n\n/**\n * Colorize the method label, then right-pad with plain spaces so column\n * alignment is computed from the visible width, not the ANSI-coded length.\n *\n * @param method - The uppercased HTTP verb\n * @param width - The METHOD column width\n * @returns The colored, padded cell\n */\nfunction colorizeMethodCell(method: string, width: number): string {\n  const colorize = METHOD_COLOR[method] ?? colors.white;\n\n  return colorize(method) + \" \".repeat(Math.max(0, width - method.length));\n}\n\n/**\n * Print the routes table to stdout with a bold header, verb-colored METHOD\n * column, and a dimmed summary. The empty case prints a single yellow notice\n * (a booted app with zero routes usually means a route module failed to load).\n *\n * Thin presentation wrapper over {@link formatRoutesTableLines} /\n * {@link routesSummary} — those stay the source of truth for layout.\n *\n * @param rows - The rows to print (already filtered/sorted by the caller)\n */\nexport function printRoutesTable(rows: RouteRow[]): void {\n  if (rows.length === 0) {\n    console.log(colors.yellow(\"No routes registered — did a route module fail to load?\"));\n    return;\n  }\n\n  const widths = columnWidths(rows);\n\n  const headerLine = COLUMNS.map((column, index) => column.header.padEnd(widths[index] ?? 0))\n    .join(GAP)\n    .trimEnd();\n\n  console.log(colors.bold(headerLine));\n\n  for (const row of rows) {\n    const cells = COLUMNS.map((column, index) => {\n      if (column.key === \"method\") {\n        return colorizeMethodCell(row.method, widths[index] ?? 0);\n      }\n\n      return cellText(row, column.key).padEnd(widths[index] ?? 0);\n    });\n\n    console.log(cells.join(GAP).trimEnd());\n  }\n\n  console.log(\"\");\n  console.log(colors.gray(routesSummary(rows)));\n}\n"],"mappings":";;;;;AAIA,MAAM,UAAU;CACd;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAc,QAAQ;CAAK;CAClC;EAAE,KAAK;EAAU,QAAQ;CAAS;AACpC;;AAKA,MAAM,MAAM;;AAGZ,MAAM,aAAa;;;;;;;;;;;AAYnB,SAAS,SAAS,KAAe,KAAwB;CACvD,IAAI,QAAQ,cAAc,OAAO,OAAO,IAAI,UAAU;CAEtD,MAAM,QAAQ,IAAI;CAElB,OAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;;;;;;;AAQA,SAAS,aAAa,MAA4B;CAChD,OAAO,QAAQ,KAAK,WAClB,KAAK,IAAI,OAAO,OAAO,QAAQ,GAAG,KAAK,KAAK,QAAQ,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CACvF;AACF;;;;;;;;;AAUA,SAAgB,cAAc,MAA0B;CACtD,MAAM,OAAO,KAAK,WAAW,IAAI,UAAU;CAE3C,IAAI,KAAK,WAAW,GAAG,OAAO,KAAK;CAEnC,MAAM,yBAAS,IAAI,IAAoB;CAEvC,KAAK,MAAM,OAAO,MAChB,OAAO,IAAI,IAAI,SAAS,OAAO,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC;CAG1D,MAAM,YAAY,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CACpC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CACjD,KAAK,CAAC,QAAQ,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,CAC9C,KAAK,KAAK;CAEb,OAAO,GAAG,KAAK,OAAO,GAAG,KAAK,IAAI,UAAU;AAC9C;;AAwCA,MAAM,eAA0D;CAC9D,KAAK,OAAO;CACZ,MAAM,OAAO;CACb,KAAK,OAAO;CACZ,OAAO,OAAO;CACd,QAAQ,OAAO;CACf,SAAS,OAAO;CAChB,MAAM,OAAO;CACb,KAAK,OAAO;AACd;;;;;;;;;AAUA,SAAS,mBAAmB,QAAgB,OAAuB;CAGjE,QAFiB,aAAa,WAAW,OAAO,MAEjC,CAAC,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,MAAM,CAAC;AACzE;;;;;;;;;;;AAYA,SAAgB,iBAAiB,MAAwB;CACvD,IAAI,KAAK,WAAW,GAAG;EACrB,QAAQ,IAAI,OAAO,OAAO,yDAAyD,CAAC;EACpF;CACF;CAEA,MAAM,SAAS,aAAa,IAAI;CAEhC,MAAM,aAAa,QAAQ,KAAK,QAAQ,UAAU,OAAO,OAAO,OAAO,OAAO,UAAU,CAAC,CAAC,CAAC,CACxF,KAAK,GAAG,CAAC,CACT,QAAQ;CAEX,QAAQ,IAAI,OAAO,KAAK,UAAU,CAAC;CAEnC,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,UAAU;GAC3C,IAAI,OAAO,QAAQ,UACjB,OAAO,mBAAmB,IAAI,QAAQ,OAAO,UAAU,CAAC;GAG1D,OAAO,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,OAAO,OAAO,UAAU,CAAC;EAC5D,CAAC;EAED,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC;CACvC;CAEA,QAAQ,IAAI,EAAE;CACd,QAAQ,IAAI,OAAO,KAAK,cAAc,IAAI,CAAC,CAAC;AAC9C"}
+{"version":3,"file":"format-routes-table.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/format-routes-table.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { methodRank, type RouteRow } from \"./route-row\";\n\n/** The columns rendered, in order, with their header labels. */\nconst COLUMNS = [\n  { key: \"method\", header: \"METHOD\" },\n  { key: \"path\", header: \"PATH\" },\n  { key: \"name\", header: \"NAME\" },\n  { key: \"action\", header: \"ACTION\" },\n  { key: \"middleware\", header: \"MW\" },\n  { key: \"source\", header: \"SOURCE\" },\n] as const;\n\ntype ColumnKey = (typeof COLUMNS)[number][\"key\"];\n\n/** Two spaces between columns. */\nconst GAP = \"  \";\n\n/** Shown for an empty string cell so the column doesn't read as a gap. */\nconst EMPTY_CELL = \"—\";\n\n/**\n * The plain (uncolored) text of one cell. Numbers render as-is; an empty string\n * renders as {@link EMPTY_CELL}. This is the single source of truth for both\n * the width math and the rendered text, so colored and uncolored output stay\n * aligned.\n *\n * @param row - The row\n * @param key - The column key\n * @returns The cell's printable text\n */\nfunction cellText(row: RouteRow, key: ColumnKey): string {\n  if (key === \"middleware\") return String(row.middleware);\n\n  const value = row[key] as string;\n\n  return value.length > 0 ? value : EMPTY_CELL;\n}\n\n/**\n * Per-column display width: the longest of the header and every cell.\n *\n * @param rows - The rows to measure\n * @returns One width per column, in column order\n */\nfunction columnWidths(rows: RouteRow[]): number[] {\n  return COLUMNS.map((column) =>\n    Math.max(column.header.length, ...rows.map((row) => cellText(row, column.key).length)),\n  );\n}\n\n/**\n * Build a one-line, human-readable summary: the total plus a per-method\n * breakdown ordered by {@link methodRank}, e.g.\n * `42 routes (38 GET · 2 POST · 1 PUT · 1 DELETE)`.\n *\n * @param rows - The rows being summarized\n * @returns The summary line\n */\nexport function routesSummary(rows: RouteRow[]): string {\n  const noun = rows.length === 1 ? \"route\" : \"routes\";\n\n  if (rows.length === 0) return `0 ${noun}`;\n\n  const counts = new Map<string, number>();\n\n  for (const row of rows) {\n    counts.set(row.method, (counts.get(row.method) ?? 0) + 1);\n  }\n\n  const breakdown = [...counts.entries()]\n    .sort(([a], [b]) => methodRank(a) - methodRank(b))\n    .map(([method, count]) => `${count} ${method}`)\n    .join(\" · \");\n\n  return `${rows.length} ${noun} (${breakdown})`;\n}\n\n/**\n * Render the routes table as an ordered list of plain (uncolored) lines:\n * a header row, one row per route, a blank line, then the summary. Returned as\n * strings (not printed) so the layout is unit-testable without ANSI noise.\n *\n * @param rows - The rows to render (already filtered/sorted by the caller)\n * @returns The lines to print, top to bottom\n */\nexport function formatRoutesTableLines(rows: RouteRow[]): string[] {\n  if (rows.length === 0) {\n    return [\"No routes registered.\"];\n  }\n\n  const widths = columnWidths(rows);\n\n  // `widths` is built from these same columns, so every index resolves. `?? 0`\n  // rather than an assertion: 0 is padEnd's no-op, so an unreadable width\n  // produces an UNALIGNED table rather than a crash — this renders `warlock\n  // routes`, and a table that throws tells the operator nothing about routes.\n  const renderRow = (cells: string[]) =>\n    cells\n      .map((text, index) => text.padEnd(widths[index] ?? 0))\n      .join(GAP)\n      .trimEnd();\n\n  const lines = [renderRow(COLUMNS.map((column) => column.header))];\n\n  for (const row of rows) {\n    lines.push(renderRow(COLUMNS.map((column) => cellText(row, column.key))));\n  }\n\n  lines.push(\"\");\n  lines.push(routesSummary(rows));\n\n  return lines;\n}\n\n/** Per-verb color for the METHOD column. Unknown verbs fall back to white. */\nconst METHOD_COLOR: Record<string, (input: string) => string> = {\n  GET: colors.green,\n  POST: colors.blue,\n  PUT: colors.yellow,\n  PATCH: colors.yellow,\n  DELETE: colors.red,\n  OPTIONS: colors.gray,\n  HEAD: colors.gray,\n  ALL: colors.magenta,\n};\n\n/**\n * Colorize the method label, then right-pad with plain spaces so column\n * alignment is computed from the visible width, not the ANSI-coded length.\n *\n * @param method - The uppercased HTTP verb\n * @param width - The METHOD column width\n * @returns The colored, padded cell\n */\nfunction colorizeMethodCell(method: string, width: number): string {\n  const colorize = METHOD_COLOR[method] ?? colors.white;\n\n  return colorize(method) + \" \".repeat(Math.max(0, width - method.length));\n}\n\n/**\n * Print the routes table to stdout with a bold header, verb-colored METHOD\n * column, and a dimmed summary. The empty case prints a single yellow notice\n * (a booted app with zero routes usually means a route module failed to load).\n *\n * Thin presentation wrapper over {@link formatRoutesTableLines} /\n * {@link routesSummary} — those stay the source of truth for layout.\n *\n * @param rows - The rows to print (already filtered/sorted by the caller)\n */\nexport function printRoutesTable(rows: RouteRow[]): void {\n  if (rows.length === 0) {\n    console.log(colors.yellow(\"No routes registered — did a route module fail to load?\"));\n    return;\n  }\n\n  const widths = columnWidths(rows);\n\n  const headerLine = COLUMNS.map((column, index) => column.header.padEnd(widths[index] ?? 0))\n    .join(GAP)\n    .trimEnd();\n\n  console.log(colors.bold(headerLine));\n\n  for (const row of rows) {\n    const cells = COLUMNS.map((column, index) => {\n      if (column.key === \"method\") {\n        return colorizeMethodCell(row.method, widths[index] ?? 0);\n      }\n\n      return cellText(row, column.key).padEnd(widths[index] ?? 0);\n    });\n\n    console.log(cells.join(GAP).trimEnd());\n  }\n\n  console.log(\"\");\n  console.log(colors.gray(routesSummary(rows)));\n}\n"],"mappings":";;;;;AAIA,MAAM,UAAU;CACd;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAc,QAAQ;CAAK;CAClC;EAAE,KAAK;EAAU,QAAQ;CAAS;AACpC;;AAKA,MAAM,MAAM;;AAGZ,MAAM,aAAa;;;;;;;;;;;AAYnB,SAAS,SAAS,KAAe,KAAwB;CACvD,IAAI,QAAQ,cAAc,OAAO,OAAO,IAAI,UAAU;CAEtD,MAAM,QAAQ,IAAI;CAElB,OAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;;;;;;;AAQA,SAAS,aAAa,MAA4B;CAChD,OAAO,QAAQ,KAAK,WAClB,KAAK,IAAI,OAAO,OAAO,QAAQ,GAAG,KAAK,KAAK,QAAQ,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CACvF;AACF;;;;;;;;;AAUA,SAAgB,cAAc,MAA0B;CACtD,MAAM,OAAO,KAAK,WAAW,IAAI,UAAU;CAE3C,IAAI,KAAK,WAAW,GAAG,OAAO,KAAK;CAEnC,MAAM,yBAAS,IAAI,IAAoB;CAEvC,KAAK,MAAM,OAAO,MAChB,OAAO,IAAI,IAAI,SAAS,OAAO,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC;CAG1D,MAAM,YAAY,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CACpC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CACjD,KAAK,CAAC,QAAQ,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,CAC9C,KAAK,KAAK;CAEb,OAAO,GAAG,KAAK,OAAO,GAAG,KAAK,IAAI,UAAU;AAC9C;;AAwCA,MAAM,eAA0D;CAC9D,KAAK,OAAO;CACZ,MAAM,OAAO;CACb,KAAK,OAAO;CACZ,OAAO,OAAO;CACd,QAAQ,OAAO;CACf,SAAS,OAAO;CAChB,MAAM,OAAO;CACb,KAAK,OAAO;AACd;;;;;;;;;AAUA,SAAS,mBAAmB,QAAgB,OAAuB;CAGjE,QAFiB,aAAa,WAAW,OAAO,MAEjC,CAAC,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,MAAM,CAAC;AACzE;;;;;;;;;;;AAYA,SAAgB,iBAAiB,MAAwB;CACvD,IAAI,KAAK,WAAW,GAAG;EACrB,QAAQ,IAAI,OAAO,OAAO,yDAAyD,CAAC;EACpF;CACF;CAEA,MAAM,SAAS,aAAa,IAAI;CAEhC,MAAM,aAAa,QAAQ,KAAK,QAAQ,UAAU,OAAO,OAAO,OAAO,OAAO,UAAU,CAAC,CAAC,CAAC,CACxF,KAAK,GAAG,CAAC,CACT,QAAQ;CAEX,QAAQ,IAAI,OAAO,KAAK,UAAU,CAAC;CAEnC,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,UAAU;GAC3C,IAAI,OAAO,QAAQ,UACjB,OAAO,mBAAmB,IAAI,QAAQ,OAAO,UAAU,CAAC;GAG1D,OAAO,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,OAAO,OAAO,UAAU,CAAC;EAC5D,CAAC;EAED,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC;CACvC;CAEA,QAAQ,IAAI,EAAE;CACd,QAAQ,IAAI,OAAO,KAAK,cAAc,IAAI,CAAC,CAAC;AAC9C"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/cli/commands/routes/route-row.ts
+//#region ../../packages/core/src/cli/commands/routes/route-row.ts
 /**
 * Display order of HTTP methods — used to rank rows within a path and to order
 * the per-method breakdown in the summary line.

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

@@ -1 +1 @@
-{"version":3,"file":"route-row.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/route-row.ts"],"sourcesContent":["import type { Route } from \"../../../router/types\";\n\n/**\n * A single registered route, normalized to the flat, display-ready shape the\n * `warlock routes` table (and its `--json` output) render. Kept separate from\n * the live {@link Route} so the formatter and filters never touch the handler\n * function, validation object, or Fastify server options — only printable\n * scalars.\n */\nexport type RouteRow = {\n  /** Uppercased HTTP verb (`\"all\"` → `\"ALL\"`). */\n  method: string;\n\n  /** Full request path (prefix already folded in by the router). */\n  path: string;\n\n  /** Route name, or `\"\"` when the route was registered without one. */\n  name: string;\n\n  /** Handler/controller-action label — the handler function name, or `\"anonymous\"`. */\n  action: string;\n\n  /** Number of middleware attached to the route. */\n  middleware: number;\n\n  /** Relative source file the route was registered from, or `\"\"`. */\n  source: string;\n};\n\n/** Filters accepted by `warlock routes`, each optional and additive (AND-ed). */\nexport type RouteFilter = {\n  /** Exact HTTP method (case-insensitive). */\n  method?: string;\n\n  /** Case-insensitive substring matched against the path. */\n  path?: string;\n\n  /** Case-insensitive substring matched against the route name. */\n  name?: string;\n};\n\n/**\n * Display order of HTTP methods — used to rank rows within a path and to order\n * the per-method breakdown in the summary line.\n */\nexport const METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"OPTIONS\", \"HEAD\", \"ALL\"];\n\n/**\n * Rank of a method for sorting. Unknown methods sort last (stable among\n * themselves).\n *\n * @param method - Uppercased HTTP verb\n * @returns The sort index\n */\nexport function methodRank(method: string): number {\n  const index = METHOD_ORDER.indexOf(method);\n  return index === -1 ? METHOD_ORDER.length : index;\n}\n\n/**\n * Derive the handler/controller-action label for a route. Uses the handler\n * function's name, stripping the `bound ` prefix that `Function.prototype.bind`\n * prepends, and falls back to `\"anonymous\"` for an unnamed handler.\n *\n * @param route - The route to label\n * @returns A printable action label\n */\nfunction routeAction(route: Route): string {\n  const handler = route.handler as unknown;\n\n  if (typeof handler !== \"function\") return \"anonymous\";\n\n  const name = handler.name?.replace(/^bound /, \"\").trim();\n\n  return name ? name : \"anonymous\";\n}\n\n/**\n * Normalize a live {@link Route} into a printable {@link RouteRow}.\n *\n * @param route - The registered route\n * @returns The display-ready row\n */\nexport function toRouteRow(route: Route): RouteRow {\n  return {\n    method: route.method.toUpperCase(),\n    path: route.path,\n    name: route.name ?? \"\",\n    action: routeAction(route),\n    middleware: route.middleware?.length ?? 0,\n    source: route.sourceFile ?? \"\",\n  };\n}\n\n/**\n * Apply the `--method` / `--path` / `--name` filters to a set of rows. An\n * omitted filter matches everything; provided filters are AND-ed.\n *\n * @param rows - The rows to filter\n * @param filter - The active filters\n * @returns The matching rows (a new array)\n */\nexport function filterRouteRows(rows: RouteRow[], filter: RouteFilter): RouteRow[] {\n  const method = filter.method?.toUpperCase();\n  const path = filter.path?.toLowerCase();\n  const name = filter.name?.toLowerCase();\n\n  return rows.filter((row) => {\n    if (method && row.method !== method) return false;\n    if (path && !row.path.toLowerCase().includes(path)) return false;\n    if (name && !row.name.toLowerCase().includes(name)) return false;\n    return true;\n  });\n}\n\n/**\n * Sort rows by path (ascending), then by HTTP-method order within a path, so\n * every verb of one resource lists together in a predictable sequence.\n *\n * @param rows - The rows to sort\n * @returns A new, sorted array\n */\nexport function sortRouteRows(rows: RouteRow[]): RouteRow[] {\n  return [...rows].sort((a, b) => {\n    if (a.path !== b.path) return a.path < b.path ? -1 : 1;\n    return methodRank(a.method) - methodRank(b.method);\n  });\n}\n"],"mappings":";;;;;AA6CA,MAAa,eAAe;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;CAAQ;AAAK;;;;;;;;AAS9F,SAAgB,WAAW,QAAwB;CACjD,MAAM,QAAQ,aAAa,QAAQ,MAAM;CACzC,OAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;;;;;;;;;AAUA,SAAS,YAAY,OAAsB;CACzC,MAAM,UAAU,MAAM;CAEtB,IAAI,OAAO,YAAY,YAAY,OAAO;CAE1C,MAAM,OAAO,QAAQ,MAAM,QAAQ,WAAW,EAAE,CAAC,CAAC,KAAK;CAEvD,OAAO,OAAO,OAAO;AACvB;;;;;;;AAQA,SAAgB,WAAW,OAAwB;CACjD,OAAO;EACL,QAAQ,MAAM,OAAO,YAAY;EACjC,MAAM,MAAM;EACZ,MAAM,MAAM,QAAQ;EACpB,QAAQ,YAAY,KAAK;EACzB,YAAY,MAAM,YAAY,UAAU;EACxC,QAAQ,MAAM,cAAc;CAC9B;AACF;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAkB,QAAiC;CACjF,MAAM,SAAS,OAAO,QAAQ,YAAY;CAC1C,MAAM,OAAO,OAAO,MAAM,YAAY;CACtC,MAAM,OAAO,OAAO,MAAM,YAAY;CAEtC,OAAO,KAAK,QAAQ,QAAQ;EAC1B,IAAI,UAAU,IAAI,WAAW,QAAQ,OAAO;EAC5C,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,OAAO;CACT,CAAC;AACH;;;;;;;;AASA,SAAgB,cAAc,MAA8B;CAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;EAC9B,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK;EACrD,OAAO,WAAW,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM;CACnD,CAAC;AACH"}
+{"version":3,"file":"route-row.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/route-row.ts"],"sourcesContent":["import type { Route } from \"../../../router/types\";\n\n/**\n * A single registered route, normalized to the flat, display-ready shape the\n * `warlock routes` table (and its `--json` output) render. Kept separate from\n * the live {@link Route} so the formatter and filters never touch the handler\n * function, validation object, or Fastify server options — only printable\n * scalars.\n */\nexport type RouteRow = {\n  /** Uppercased HTTP verb (`\"all\"` → `\"ALL\"`). */\n  method: string;\n\n  /** Full request path (prefix already folded in by the router). */\n  path: string;\n\n  /** Route name, or `\"\"` when the route was registered without one. */\n  name: string;\n\n  /** Handler/controller-action label — the handler function name, or `\"anonymous\"`. */\n  action: string;\n\n  /** Number of middleware attached to the route. */\n  middleware: number;\n\n  /** Relative source file the route was registered from, or `\"\"`. */\n  source: string;\n};\n\n/** Filters accepted by `warlock routes`, each optional and additive (AND-ed). */\nexport type RouteFilter = {\n  /** Exact HTTP method (case-insensitive). */\n  method?: string;\n\n  /** Case-insensitive substring matched against the path. */\n  path?: string;\n\n  /** Case-insensitive substring matched against the route name. */\n  name?: string;\n};\n\n/**\n * Display order of HTTP methods — used to rank rows within a path and to order\n * the per-method breakdown in the summary line.\n */\nexport const METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"OPTIONS\", \"HEAD\", \"ALL\"];\n\n/**\n * Rank of a method for sorting. Unknown methods sort last (stable among\n * themselves).\n *\n * @param method - Uppercased HTTP verb\n * @returns The sort index\n */\nexport function methodRank(method: string): number {\n  const index = METHOD_ORDER.indexOf(method);\n  return index === -1 ? METHOD_ORDER.length : index;\n}\n\n/**\n * Derive the handler/controller-action label for a route. Uses the handler\n * function's name, stripping the `bound ` prefix that `Function.prototype.bind`\n * prepends, and falls back to `\"anonymous\"` for an unnamed handler.\n *\n * @param route - The route to label\n * @returns A printable action label\n */\nfunction routeAction(route: Route): string {\n  const handler = route.handler as unknown;\n\n  if (typeof handler !== \"function\") return \"anonymous\";\n\n  const name = handler.name?.replace(/^bound /, \"\").trim();\n\n  return name ? name : \"anonymous\";\n}\n\n/**\n * Normalize a live {@link Route} into a printable {@link RouteRow}.\n *\n * @param route - The registered route\n * @returns The display-ready row\n */\nexport function toRouteRow(route: Route): RouteRow {\n  return {\n    method: route.method.toUpperCase(),\n    path: route.path,\n    name: route.name ?? \"\",\n    action: routeAction(route),\n    middleware: route.middleware?.length ?? 0,\n    source: route.sourceFile ?? \"\",\n  };\n}\n\n/**\n * Apply the `--method` / `--path` / `--name` filters to a set of rows. An\n * omitted filter matches everything; provided filters are AND-ed.\n *\n * @param rows - The rows to filter\n * @param filter - The active filters\n * @returns The matching rows (a new array)\n */\nexport function filterRouteRows(rows: RouteRow[], filter: RouteFilter): RouteRow[] {\n  const method = filter.method?.toUpperCase();\n  const path = filter.path?.toLowerCase();\n  const name = filter.name?.toLowerCase();\n\n  return rows.filter((row) => {\n    if (method && row.method !== method) return false;\n    if (path && !row.path.toLowerCase().includes(path)) return false;\n    if (name && !row.name.toLowerCase().includes(name)) return false;\n    return true;\n  });\n}\n\n/**\n * Sort rows by path (ascending), then by HTTP-method order within a path, so\n * every verb of one resource lists together in a predictable sequence.\n *\n * @param rows - The rows to sort\n * @returns A new, sorted array\n */\nexport function sortRouteRows(rows: RouteRow[]): RouteRow[] {\n  return [...rows].sort((a, b) => {\n    if (a.path !== b.path) return a.path < b.path ? -1 : 1;\n    return methodRank(a.method) - methodRank(b.method);\n  });\n}\n"],"mappings":";;;;;AA6CA,MAAa,eAAe;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;CAAQ;AAAK;;;;;;;;AAS9F,SAAgB,WAAW,QAAwB;CACjD,MAAM,QAAQ,aAAa,QAAQ,MAAM;CACzC,OAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;;;;;;;;;AAUA,SAAS,YAAY,OAAsB;CACzC,MAAM,UAAU,MAAM;CAEtB,IAAI,OAAO,YAAY,YAAY,OAAO;CAE1C,MAAM,OAAO,QAAQ,MAAM,QAAQ,WAAW,EAAE,CAAC,CAAC,KAAK;CAEvD,OAAO,OAAO,OAAO;AACvB;;;;;;;AAQA,SAAgB,WAAW,OAAwB;CACjD,OAAO;EACL,QAAQ,MAAM,OAAO,YAAY;EACjC,MAAM,MAAM;EACZ,MAAM,MAAM,QAAQ;EACpB,QAAQ,YAAY,KAAK;EACzB,YAAY,MAAM,YAAY,UAAU;EACxC,QAAQ,MAAM,cAAc;CAC9B;AACF;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAkB,QAAiC;CACjF,MAAM,SAAS,OAAO,QAAQ,YAAY;CAC1C,MAAM,OAAO,OAAO,MAAM,YAAY;CACtC,MAAM,OAAO,OAAO,MAAM,YAAY;CAEtC,OAAO,KAAK,QAAQ,QAAQ;EAC1B,IAAI,UAAU,IAAI,WAAW,QAAQ,OAAO;EAC5C,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,OAAO;CACT,CAAC;AACH;;;;;;;;AASA,SAAgB,cAAc,MAA8B;CAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;EAC9B,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK;EACrD,OAAO,WAAW,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM;CACnD,CAAC;AACH"}

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

@@ -4,7 +4,7 @@ import { withConsoleOnStderr } from "./with-console-on-stderr.mjs";
 import { filterRouteRows, sortRouteRows, toRouteRow } from "./route-row.mjs";
 import { printRoutesTable } from "./format-routes-table.mjs";
 
-//#region ../core/src/cli/commands/routes/routes-command.action.ts
+//#region ../../packages/core/src/cli/commands/routes/routes-command.action.ts
 /**
 * Read the active option as a trimmed string, or `undefined` when it is absent
 * or not a string (a bare boolean flag).

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

@@ -1 +1 @@
-{"version":3,"file":"routes-command.action.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/routes-command.action.ts"],"sourcesContent":["import { router } from \"../../../router/router\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForDiagnostics } from \"../doctor/boot-for-diagnostics\";\nimport { withConsoleOnStderr } from \"./with-console-on-stderr\";\nimport { printRoutesTable } from \"./format-routes-table\";\nimport { filterRouteRows, sortRouteRows, toRouteRow } from \"./route-row\";\n\n/**\n * Read the active option as a trimmed string, or `undefined` when it is absent\n * or not a string (a bare boolean flag).\n *\n * @param value - The parsed option value\n * @returns The string value, or `undefined`\n */\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock routes`. Reads the registered routes from the router\n * singleton (populated by the `bootstrap` preload, with no connectors started),\n * applies the `--method` / `--path` / `--name` filters, sorts them, and either\n * prints a verb-colored table or — with `--json` — emits the normalized rows as\n * JSON for piping into scripts/CI.\n *\n * Read-only: it never opens a database/cache/socket connection and never\n * mutates the router.\n *\n * @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).\n */\nexport async function routesCommandAction({ options }: CommandActionData): Promise<void> {\n  // The preload is config-only and imports no route modules; load them the same\n  // way the server does at boot. With `--json`, stdout carries only the JSON, so\n  // the boot's progress lines go to stderr.\n  const context = options.json\n    ? await withConsoleOnStderr(bootForDiagnostics)\n    : await bootForDiagnostics();\n\n  for (const failure of context.moduleFailures) {\n    console.error(`Failed to load ${failure.file}: ${failure.message}`);\n  }\n\n  const rows = sortRouteRows(\n    filterRouteRows(router.list().map(toRouteRow), {\n      method: stringOption(options.method),\n      path: stringOption(options.path),\n      name: stringOption(options.name),\n    }),\n  );\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n    return;\n  }\n\n  printRoutesTable(rows);\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;;AAcA,eAAsB,oBAAoB,EAAE,WAA6C;CAIvF,MAAM,UAAU,QAAQ,OACpB,MAAM,oBAAoB,kBAAkB,IAC5C,MAAM,mBAAmB;CAE7B,KAAK,MAAM,WAAW,QAAQ,gBAC5B,QAAQ,MAAM,kBAAkB,QAAQ,KAAK,IAAI,QAAQ,SAAS;CAGpE,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG;EAC7C,QAAQ,aAAa,QAAQ,MAAM;EACnC,MAAM,aAAa,QAAQ,IAAI;EAC/B,MAAM,aAAa,QAAQ,IAAI;CACjC,CAAC,CACH;CAEA,IAAI,QAAQ,MAAM;EAChB,QAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,iBAAiB,IAAI;AACvB"}
+{"version":3,"file":"routes-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/routes-command.action.ts"],"sourcesContent":["import { router } from \"../../../router/router\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForDiagnostics } from \"../doctor/boot-for-diagnostics\";\nimport { withConsoleOnStderr } from \"./with-console-on-stderr\";\nimport { printRoutesTable } from \"./format-routes-table\";\nimport { filterRouteRows, sortRouteRows, toRouteRow } from \"./route-row\";\n\n/**\n * Read the active option as a trimmed string, or `undefined` when it is absent\n * or not a string (a bare boolean flag).\n *\n * @param value - The parsed option value\n * @returns The string value, or `undefined`\n */\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock routes`. Reads the registered routes from the router\n * singleton (populated by the `bootstrap` preload, with no connectors started),\n * applies the `--method` / `--path` / `--name` filters, sorts them, and either\n * prints a verb-colored table or — with `--json` — emits the normalized rows as\n * JSON for piping into scripts/CI.\n *\n * Read-only: it never opens a database/cache/socket connection and never\n * mutates the router.\n *\n * @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).\n */\nexport async function routesCommandAction({ options }: CommandActionData): Promise<void> {\n  // The preload is config-only and imports no route modules; load them the same\n  // way the server does at boot. With `--json`, stdout carries only the JSON, so\n  // the boot's progress lines go to stderr.\n  const context = options.json\n    ? await withConsoleOnStderr(bootForDiagnostics)\n    : await bootForDiagnostics();\n\n  for (const failure of context.moduleFailures) {\n    console.error(`Failed to load ${failure.file}: ${failure.message}`);\n  }\n\n  const rows = sortRouteRows(\n    filterRouteRows(router.list().map(toRouteRow), {\n      method: stringOption(options.method),\n      path: stringOption(options.path),\n      name: stringOption(options.name),\n    }),\n  );\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n    return;\n  }\n\n  printRoutesTable(rows);\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;;AAcA,eAAsB,oBAAoB,EAAE,WAA6C;CAIvF,MAAM,UAAU,QAAQ,OACpB,MAAM,oBAAoB,kBAAkB,IAC5C,MAAM,mBAAmB;CAE7B,KAAK,MAAM,WAAW,QAAQ,gBAC5B,QAAQ,MAAM,kBAAkB,QAAQ,KAAK,IAAI,QAAQ,SAAS;CAGpE,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG;EAC7C,QAAQ,aAAa,QAAQ,MAAM;EACnC,MAAM,aAAa,QAAQ,IAAI;EAC/B,MAAM,aAAa,QAAQ,IAAI;CACjC,CAAC,CACH;CAEA,IAAI,QAAQ,MAAM;EAChB,QAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,iBAAiB,IAAI;AACvB"}

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

@@ -1,11 +1,11 @@
 import { router } from "../../../router/router.mjs";
-import { resolveBuildConfig } from "../../../production/resolve-build-config.mjs";
 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";
 
-//#region ../core/src/cli/commands/routes/routes-diff.action.ts
+//#region ../../packages/core/src/cli/commands/routes/routes-diff.action.ts
 const SNAPSHOT_FILE = "page-routes.manifest.json";
 /**
 * What a clean `warlock routes:diff` does and does NOT prove, printed on a

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

@@ -1 +1 @@
-{"version":3,"file":"routes-diff.action.mjs","names":[],"sources":["../../../../../../../../../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":[],"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"}