@warlock.js/core 5.30.0 → 5.31.0

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,6 +1,6 @@
 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";

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

@@ -0,0 +1,131 @@
+import { command } from "../../commands/cli-command.mjs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+
+//#region ../../packages/core/src/cli/commands/test.command.ts
+/**
+* Translate `warlock test` options into Vitest arguments. Pure, so the mapping
+* is pinned by a test rather than discovered in CI.
+*
+* Flags used (verified against `vitest --help`, Vitest 4.1):
+* `run`, `related [...filters]`, `--changed [since]`, `--passWithNoTests`,
+* `--reporter <name>`, `--testNamePattern <pattern>`.
+*/
+function buildVitestArguments(options) {
+	const related = options.related ?? [];
+	const args = [];
+	if (related.length > 0) {
+		args.push("related", ...related, ...options.filters);
+		if (!options.watch) args.push("--run");
+	} else {
+		if (!options.watch) args.push("run");
+		args.push(...options.filters);
+	}
+	if (options.changed || options.since) {
+		args.push("--changed");
+		if (options.since) args.push(options.since);
+	}
+	if (related.length > 0 || options.changed || options.since) args.push("--passWithNoTests");
+	if (options.testNamePattern) args.push("--testNamePattern", options.testNamePattern);
+	if (options.json) args.push("--reporter=json");
+	return args;
+}
+/** Read `warlock test`'s parsed CLI input into {@link TestCommandOptions}. */
+function readTestCommandOptions(data) {
+	const text = (value) => typeof value === "string" && value.trim() !== "" ? value.trim() : void 0;
+	const relatedOption = text(data.options.related);
+	return {
+		filters: data.args,
+		changed: data.options.changed === true,
+		since: text(data.options.since),
+		related: relatedOption ? relatedOption.split(",").map((file) => file.trim()).filter(Boolean) : void 0,
+		watch: data.options.watch === true,
+		json: data.options.json === true,
+		testNamePattern: text(data.options.testNamePattern) ?? text(data.options.t)
+	};
+}
+/**
+* The project's own Vitest entry (`vitest.mjs`), resolved from the project
+* root — never a global or an `npx` download.
+*/
+function resolveProjectVitest(projectRoot, resolve = createRequire(path.join(projectRoot, "package.json")).resolve) {
+	let manifestPath;
+	try {
+		manifestPath = resolve("vitest/package.json");
+	} catch {
+		throw new Error(`Vitest is not installed in ${projectRoot}. Run \`warlock add test\` (or install vitest as a dev dependency) first.`);
+	}
+	const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+	const bin = typeof manifest.bin === "string" ? manifest.bin : manifest.bin?.vitest;
+	const entry = path.join(path.dirname(manifestPath), bin ?? "vitest.mjs");
+	if (!existsSync(entry)) throw new Error(`Vitest's entry point was not found at ${entry}. Reinstall vitest.`);
+	return entry;
+}
+async function testCommandAction(data) {
+	const options = readTestCommandOptions(data);
+	const vitest = resolveProjectVitest(process.cwd());
+	const args = buildVitestArguments(options);
+	const exitCode = await new Promise((resolve, reject) => {
+		const child = spawn(process.execPath, [vitest, ...args], {
+			cwd: process.cwd(),
+			env: {
+				...process.env,
+				NODE_ENV: "test"
+			},
+			stdio: "inherit"
+		});
+		child.once("error", reject);
+		child.once("exit", (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+	});
+	if (exitCode !== 0) process.exit(exitCode);
+}
+/**
+* `warlock test` — run the project's tests through its own Vitest.
+*
+* @example
+* warlock test                                  # everything, once
+* warlock test --changed                        # tests affected by uncommitted changes
+* warlock test --changed --since main           # ... by changes since main
+* warlock test --related src/app/posts/services/create-post.service.ts
+* warlock test src/app/posts --json             # one folder, JSON report on stdout
+*/
+const testCommand = command({
+	name: "test [filters...]",
+	description: "Run the project's tests with Vitest; --changed / --related run only the tests your change affects",
+	action: testCommandAction,
+	options: [
+		{
+			text: "--changed",
+			description: "Only run tests affected by uncommitted changes (git)",
+			type: "boolean"
+		},
+		{
+			text: "--since <ref>",
+			description: "With --changed: tests affected by changes since this git ref (e.g. main)"
+		},
+		{
+			text: "--related <files>",
+			description: "Comma-separated source files: only run the tests that import them"
+		},
+		{
+			text: "--watch, -w",
+			description: "Re-run on change instead of running once",
+			type: "boolean"
+		},
+		{
+			text: "--test-name-pattern, -t",
+			description: "Only run tests whose name matches this pattern"
+		},
+		{
+			text: "--json",
+			description: "Print Vitest's JSON report on stdout",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { testCommand };
+//# sourceMappingURL=test.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/test.command.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { command } from \"../../commands/cli-command\";\nimport type { CommandActionData } from \"../../commands/types\";\n\n/** What `warlock test` was asked for. */\nexport type TestCommandOptions = {\n  /** Positional filters: file paths or name fragments, passed to Vitest. */\n  filters: string[];\n  /** Only the tests affected by uncommitted changes (or by changes since `since`). */\n  changed?: boolean;\n  /** A git ref for `changed`: tests affected by changes since this commit or branch. */\n  since?: string;\n  /** Only the tests that import these source files, directly or not. */\n  related?: string[];\n  /** Keep running and re-run on change instead of running once. */\n  watch?: boolean;\n  /** Print Vitest's JSON report on stdout. */\n  json?: boolean;\n  /** Only tests whose name matches this pattern. */\n  testNamePattern?: string;\n};\n\n/**\n * Translate `warlock test` options into Vitest arguments. Pure, so the mapping\n * is pinned by a test rather than discovered in CI.\n *\n * Flags used (verified against `vitest --help`, Vitest 4.1):\n * `run`, `related [...filters]`, `--changed [since]`, `--passWithNoTests`,\n * `--reporter <name>`, `--testNamePattern <pattern>`.\n */\nexport function buildVitestArguments(options: TestCommandOptions): string[] {\n  const related = options.related ?? [];\n  const args: string[] = [];\n\n  if (related.length > 0) {\n    // `vitest related` watches by default; `--run` makes it run once.\n    args.push(\"related\", ...related, ...options.filters);\n\n    if (!options.watch) args.push(\"--run\");\n  } else {\n    if (!options.watch) args.push(\"run\");\n\n    args.push(...options.filters);\n  }\n\n  if (options.changed || options.since) {\n    args.push(\"--changed\");\n\n    if (options.since) args.push(options.since);\n  }\n\n  // \"Run what my change affects\" finding nothing to run is a pass, not an error.\n  if (related.length > 0 || options.changed || options.since) args.push(\"--passWithNoTests\");\n\n  if (options.testNamePattern) args.push(\"--testNamePattern\", options.testNamePattern);\n\n  if (options.json) args.push(\"--reporter=json\");\n\n  return args;\n}\n\n/** Read `warlock test`'s parsed CLI input into {@link TestCommandOptions}. */\nexport function readTestCommandOptions(data: CommandActionData): TestCommandOptions {\n  const text = (value: unknown): string | undefined =>\n    typeof value === \"string\" && value.trim() !== \"\" ? value.trim() : undefined;\n  const relatedOption = text(data.options.related);\n\n  return {\n    filters: data.args,\n    changed: data.options.changed === true,\n    since: text(data.options.since),\n    related: relatedOption\n      ? relatedOption\n          .split(\",\")\n          .map((file) => file.trim())\n          .filter(Boolean)\n      : undefined,\n    watch: data.options.watch === true,\n    json: data.options.json === true,\n    testNamePattern: text(data.options.testNamePattern) ?? text(data.options.t),\n  };\n}\n\n/**\n * The project's own Vitest entry (`vitest.mjs`), resolved from the project\n * root — never a global or an `npx` download.\n */\nexport function resolveProjectVitest(\n  projectRoot: string,\n  resolve: (specifier: string) => string = createRequire(path.join(projectRoot, \"package.json\"))\n    .resolve,\n): string {\n  let manifestPath: string;\n\n  try {\n    manifestPath = resolve(\"vitest/package.json\");\n  } catch {\n    throw new Error(\n      `Vitest is not installed in ${projectRoot}. Run \\`warlock add test\\` (or install vitest as a dev dependency) first.`,\n    );\n  }\n\n  const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as {\n    bin?: string | Record<string, string>;\n  };\n  const bin = typeof manifest.bin === \"string\" ? manifest.bin : manifest.bin?.vitest;\n  const entry = path.join(path.dirname(manifestPath), bin ?? \"vitest.mjs\");\n\n  if (!existsSync(entry)) {\n    throw new Error(`Vitest's entry point was not found at ${entry}. Reinstall vitest.`);\n  }\n\n  return entry;\n}\n\nasync function testCommandAction(data: CommandActionData): Promise<void> {\n  const options = readTestCommandOptions(data);\n  const vitest = resolveProjectVitest(process.cwd());\n  const args = buildVitestArguments(options);\n\n  const exitCode = await new Promise<number>((resolve, reject) => {\n    const child = spawn(process.execPath, [vitest, ...args], {\n      cwd: process.cwd(),\n      // Vitest only defaults NODE_ENV to \"test\" when it is unset; an exported\n      // NODE_ENV=production would otherwise reach the test server and be refused.\n      env: { ...process.env, NODE_ENV: \"test\" },\n      stdio: \"inherit\",\n    });\n\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code, signal) => resolve(code ?? (signal ? 1 : 0)));\n  });\n\n  if (exitCode !== 0) process.exit(exitCode);\n}\n\n/**\n * `warlock test` — run the project's tests through its own Vitest.\n *\n * @example\n * warlock test                                  # everything, once\n * warlock test --changed                        # tests affected by uncommitted changes\n * warlock test --changed --since main           # ... by changes since main\n * warlock test --related src/app/posts/services/create-post.service.ts\n * warlock test src/app/posts --json             # one folder, JSON report on stdout\n */\nexport const testCommand = command({\n  name: \"test [filters...]\",\n  description:\n    \"Run the project's tests with Vitest; --changed / --related run only the tests your change affects\",\n  action: testCommandAction,\n  options: [\n    {\n      text: \"--changed\",\n      description: \"Only run tests affected by uncommitted changes (git)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--since <ref>\",\n      description: \"With --changed: tests affected by changes since this git ref (e.g. main)\",\n    },\n    {\n      text: \"--related <files>\",\n      description: \"Comma-separated source files: only run the tests that import them\",\n    },\n    {\n      text: \"--watch, -w\",\n      description: \"Re-run on change instead of running once\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--test-name-pattern, -t\",\n      description: \"Only run tests whose name matches this pattern\",\n    },\n    {\n      text: \"--json\",\n      description: \"Print Vitest's JSON report on stdout\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,145 @@
+import { ERROR_CODES, errorCodeOf } from "../../../errors/error-codes.mjs";
+import { flushAndExit } from "../../flush-and-exit.mjs";
+import { traceRequest } from "../../../tooling/trace/trace-request.mjs";
+import path from "node:path";
+import { readFileSync } from "node:fs";
+import { colors } from "@mongez/copper";
+
+//#region ../../packages/core/src/cli/commands/trace/trace-command.action.ts
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* Every `--header` / `-H` value in `argv`, in order. The CLI parser keeps only
+* the last value of a repeated option, so headers are read from argv directly.
+* Accepts `--header k:v`, `--header=k:v`, `-H k:v` and `-H=k:v`.
+*/
+function collectHeaderValues(argv) {
+	const values = [];
+	for (let index = 0; index < argv.length; index++) {
+		const token = argv[index];
+		if (token === void 0) continue;
+		const inline = /^(?:--header|-H)=(.*)$/s.exec(token);
+		if (inline) {
+			values.push(inline[1] ?? "");
+			continue;
+		}
+		if (token === "--header" || token === "-H") {
+			const next = argv[index + 1];
+			if (next !== void 0) {
+				values.push(next);
+				index++;
+			}
+		}
+	}
+	return values;
+}
+/**
+* Turn `name:value` strings into a header object. The first colon splits; both
+* sides are trimmed. Throws on a value without a colon or with an empty name.
+*/
+function parseHeaderValues(values) {
+	const headers = {};
+	for (const value of values) {
+		const colon = value.indexOf(":");
+		const name = colon === -1 ? "" : value.slice(0, colon).trim();
+		if (name.length === 0) throw new Error(`Invalid --header ${JSON.stringify(value)}: expected name:value.`);
+		headers[name] = value.slice(colon + 1).trim();
+	}
+	return headers;
+}
+/**
+* The request body for `--body`: `@path` reads the file (relative to `cwd`);
+* text that parses as JSON becomes that value (sent as JSON); anything else is
+* sent as the text itself. `undefined` without `--body`.
+*/
+function parseTraceBody(value, cwd = process.cwd(), readFile = (file) => readFileSync(file, "utf8")) {
+	if (value === void 0) return void 0;
+	const text = value.startsWith("@") ? readFile(path.resolve(cwd, value.slice(1))) : value;
+	try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+}
+function ms(value) {
+	return value === null ? "-" : `${value.toFixed(1)}ms`;
+}
+/** The human summary `warlock trace` prints without `--json`. Uncolored, so it is testable. */
+function formatTraceSummary(report) {
+	const { timeline } = report;
+	const lines = [`${report.request.method} ${report.request.url} → ${report.response.status}  (${report.route ?? "no route"}, id ${report.requestId})`, `  total ${ms(report.timings.totalMs)} server, ${ms(report.timings.clientMs)} round trip`];
+	if (timeline.routeMatch) lines.push(`  route.match  ${ms(timeline.routeMatch.durationMs)}`);
+	for (const middleware of timeline.middleware) lines.push(`  middleware   ${middleware.name ?? "(anonymous)"}  ${ms(middleware.durationMs)}`);
+	if (timeline.validation.ran) {
+		const verdict = timeline.validation.passed ? "passed" : "failed";
+		lines.push(`  validation   ${verdict}  ${ms(timeline.validation.durationMs)}`);
+	}
+	if (timeline.handler) lines.push(`  handler      ${ms(timeline.handler.durationMs)}`);
+	const nPlusOne = report.queries.filter((query) => query.nPlusOne).length;
+	lines.push(`  queries ${report.queries.length}${nPlusOne > 0 ? ` (${nPlusOne} N+1)` : ""} · logs ${report.logs.length} · cache ${report.cache.length} · mails ${report.mails.length}`);
+	for (const warning of report.warnings) if (typeof warning.message === "string") lines.push(`  ! ${warning.message}`);
+	if (report.error) lines.push(`  error: ${report.error}`);
+	lines.push("", "Run with --json for the full timeline.");
+	return lines;
+}
+/** The exit code for a failed trace: 2 for this machine (WL8xxx), 1 otherwise. */
+function traceFailureExitCode(error) {
+	const code = errorCodeOf(error);
+	return code !== void 0 && ERROR_CODES[code].category === "environment" ? 2 : 1;
+}
+/**
+* Action behind `warlock trace <method> <url>`.
+*
+* Sends the request to the running dev server and prints its devtools
+* timeline; with `--json`, stdout carries exactly the report. A failure
+* (no dev server, no devtools, no record) prints the coded error — as
+* `{ ok: false, code, message }` with `--json` — and exits 2 for this machine
+* or 1 otherwise.
+*
+* @param data Parsed CLI args: `[method, url]`, `body`, `url`, `devtoolsPath`, `idHeader`, `timeout`, `json`.
+*/
+async function traceCommandAction({ args, options }) {
+	const json = options.json === true;
+	const [method, url] = args;
+	try {
+		if (!method || !url) throw new Error("Usage: warlock trace <method> <url> [--body json|@file] [--header k:v]");
+		const timeout = stringOption(options.timeout);
+		const timeoutMs = timeout === void 0 ? void 0 : Number(timeout);
+		if (timeoutMs !== void 0 && (!Number.isFinite(timeoutMs) || timeoutMs < 0)) throw new Error(`Invalid --timeout ${JSON.stringify(timeout)}: expected milliseconds.`);
+		const report = await traceRequest({
+			method,
+			url,
+			body: parseTraceBody(stringOption(options.body)),
+			headers: parseHeaderValues(collectHeaderValues(process.argv)),
+			serverUrl: stringOption(options.url),
+			devtoolsPath: stringOption(options.devtoolsPath),
+			requestIdHeader: stringOption(options.idHeader),
+			timeoutMs
+		});
+		if (json) {
+			console.log(JSON.stringify(report, null, 2));
+			return;
+		}
+		const [heading, ...rest] = formatTraceSummary(report);
+		console.log(colors.bold(heading ?? ""));
+		for (const line of rest) console.log(line);
+	} catch (error) {
+		const code = errorCodeOf(error) ?? null;
+		const message = error instanceof Error ? error.message : String(error);
+		if (json) console.log(JSON.stringify({
+			ok: false,
+			code,
+			message
+		}, null, 2));
+		else {
+			console.error(colors.red(`${code ? `${code} ` : ""}${message}`));
+			if (code) console.error(`  → ${ERROR_CODES[code].fix}`);
+		}
+		await flushAndExit(traceFailureExitCode(error));
+	}
+}
+
+//#endregion
+export { traceCommandAction };
+//# sourceMappingURL=trace-command.action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/trace/trace-command.action.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { ERROR_CODES, errorCodeOf } from \"../../../errors/error-codes\";\nimport type { TraceReport } from \"../../../tooling/trace/trace-report.types\";\nimport { traceRequest } from \"../../../tooling/trace/trace-request\";\nimport { flushAndExit } from \"../../flush-and-exit\";\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 * Every `--header` / `-H` value in `argv`, in order. The CLI parser keeps only\n * the last value of a repeated option, so headers are read from argv directly.\n * Accepts `--header k:v`, `--header=k:v`, `-H k:v` and `-H=k:v`.\n */\nexport function collectHeaderValues(argv: readonly string[]): string[] {\n  const values: string[] = [];\n\n  for (let index = 0; index < argv.length; index++) {\n    const token = argv[index];\n\n    if (token === undefined) continue;\n\n    const inline = /^(?:--header|-H)=(.*)$/s.exec(token);\n\n    if (inline) {\n      values.push(inline[1] ?? \"\");\n      continue;\n    }\n\n    if (token === \"--header\" || token === \"-H\") {\n      const next = argv[index + 1];\n\n      if (next !== undefined) {\n        values.push(next);\n        index++;\n      }\n    }\n  }\n\n  return values;\n}\n\n/**\n * Turn `name:value` strings into a header object. The first colon splits; both\n * sides are trimmed. Throws on a value without a colon or with an empty name.\n */\nexport function parseHeaderValues(values: readonly string[]): Record<string, string> {\n  const headers: Record<string, string> = {};\n\n  for (const value of values) {\n    const colon = value.indexOf(\":\");\n    const name = colon === -1 ? \"\" : value.slice(0, colon).trim();\n\n    if (name.length === 0) {\n      throw new Error(`Invalid --header ${JSON.stringify(value)}: expected name:value.`);\n    }\n\n    headers[name] = value.slice(colon + 1).trim();\n  }\n\n  return headers;\n}\n\n/**\n * The request body for `--body`: `@path` reads the file (relative to `cwd`);\n * text that parses as JSON becomes that value (sent as JSON); anything else is\n * sent as the text itself. `undefined` without `--body`.\n */\nexport function parseTraceBody(\n  value: string | undefined,\n  cwd = process.cwd(),\n  readFile: (file: string) => string = (file) => readFileSync(file, \"utf8\"),\n): unknown {\n  if (value === undefined) return undefined;\n\n  const text = value.startsWith(\"@\") ? readFile(path.resolve(cwd, value.slice(1))) : value;\n\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction ms(value: number | null): string {\n  return value === null ? \"-\" : `${value.toFixed(1)}ms`;\n}\n\n/** The human summary `warlock trace` prints without `--json`. Uncolored, so it is testable. */\nexport function formatTraceSummary(report: TraceReport): string[] {\n  const { timeline } = report;\n  const lines = [\n    `${report.request.method} ${report.request.url} → ${report.response.status}  (${report.route ?? \"no route\"}, id ${report.requestId})`,\n    `  total ${ms(report.timings.totalMs)} server, ${ms(report.timings.clientMs)} round trip`,\n  ];\n\n  if (timeline.routeMatch) lines.push(`  route.match  ${ms(timeline.routeMatch.durationMs)}`);\n\n  for (const middleware of timeline.middleware) {\n    lines.push(`  middleware   ${middleware.name ?? \"(anonymous)\"}  ${ms(middleware.durationMs)}`);\n  }\n\n  if (timeline.validation.ran) {\n    const verdict = timeline.validation.passed ? \"passed\" : \"failed\";\n\n    lines.push(`  validation   ${verdict}  ${ms(timeline.validation.durationMs)}`);\n  }\n\n  if (timeline.handler) lines.push(`  handler      ${ms(timeline.handler.durationMs)}`);\n\n  const nPlusOne = report.queries.filter((query) => query.nPlusOne).length;\n\n  lines.push(\n    `  queries ${report.queries.length}${nPlusOne > 0 ? ` (${nPlusOne} N+1)` : \"\"} · logs ${report.logs.length} · cache ${report.cache.length} · mails ${report.mails.length}`,\n  );\n\n  for (const warning of report.warnings) {\n    if (typeof warning.message === \"string\") lines.push(`  ! ${warning.message}`);\n  }\n\n  if (report.error) lines.push(`  error: ${report.error}`);\n\n  lines.push(\"\", \"Run with --json for the full timeline.\");\n\n  return lines;\n}\n\n/** The exit code for a failed trace: 2 for this machine (WL8xxx), 1 otherwise. */\nexport function traceFailureExitCode(error: unknown): 1 | 2 {\n  const code = errorCodeOf(error);\n\n  return code !== undefined && ERROR_CODES[code].category === \"environment\" ? 2 : 1;\n}\n\n/**\n * Action behind `warlock trace <method> <url>`.\n *\n * Sends the request to the running dev server and prints its devtools\n * timeline; with `--json`, stdout carries exactly the report. A failure\n * (no dev server, no devtools, no record) prints the coded error — as\n * `{ ok: false, code, message }` with `--json` — and exits 2 for this machine\n * or 1 otherwise.\n *\n * @param data Parsed CLI args: `[method, url]`, `body`, `url`, `devtoolsPath`, `idHeader`, `timeout`, `json`.\n */\nexport async function traceCommandAction({ args, options }: CommandActionData): Promise<void> {\n  const json = options.json === true;\n  const [method, url] = args;\n\n  try {\n    if (!method || !url) {\n      throw new Error(\"Usage: warlock trace <method> <url> [--body json|@file] [--header k:v]\");\n    }\n\n    const timeout = stringOption(options.timeout);\n    const timeoutMs = timeout === undefined ? undefined : Number(timeout);\n\n    if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs < 0)) {\n      throw new Error(`Invalid --timeout ${JSON.stringify(timeout)}: expected milliseconds.`);\n    }\n\n    const report = await traceRequest({\n      method,\n      url,\n      body: parseTraceBody(stringOption(options.body)),\n      headers: parseHeaderValues(collectHeaderValues(process.argv)),\n      serverUrl: stringOption(options.url),\n      devtoolsPath: stringOption(options.devtoolsPath),\n      requestIdHeader: stringOption(options.idHeader),\n      timeoutMs,\n    });\n\n    if (json) {\n      console.log(JSON.stringify(report, null, 2));\n      return;\n    }\n\n    const [heading, ...rest] = formatTraceSummary(report);\n\n    console.log(colors.bold(heading ?? \"\"));\n\n    for (const line of rest) {\n      console.log(line);\n    }\n  } catch (error) {\n    const code = errorCodeOf(error) ?? null;\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (json) {\n      console.log(JSON.stringify({ ok: false, code, message }, null, 2));\n    } else {\n      console.error(colors.red(`${code ? `${code} ` : \"\"}${message}`));\n\n      if (code) console.error(`  → ${ERROR_CODES[code].fix}`);\n    }\n\n    await flushAndExit(traceFailureExitCode(error));\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,60 @@
+import { command } from "../../commands/cli-command.mjs";
+import { traceCommandAction } from "./trace/trace-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/trace.command.ts
+/**
+* `warlock trace <method> <url>` — send one request to the running dev server
+* and print its devtools timeline: middleware, validation result, handler,
+* queries with N+1 flags, logs, cache operations, the response and timings.
+* `--json` prints the versioned report (`schemaVersion: 1`).
+*
+* No preload: nothing boots here. The dev server (`warlock dev` with
+* `@warlock.js/devtools` installed) does the work; this command finds it
+* through `.warlock/dev-server.json` or `--url`.
+*/
+const traceCommand = command({
+	name: "trace <method> <url>",
+	description: "Send a request to the running dev server and print its devtools timeline (middleware, validation, queries, logs, response, timings); --json for the report",
+	action: traceCommandAction,
+	options: [
+		{
+			text: "--body, -b",
+			description: "Request body: JSON text, plain text, or @file to read it from a file",
+			type: "string"
+		},
+		{
+			text: "--header, -H",
+			description: "A request header as name:value (repeatable)",
+			type: "string"
+		},
+		{
+			text: "--url, -u",
+			description: "Dev server origin (default: read from .warlock/dev-server.json)",
+			type: "string"
+		},
+		{
+			text: "--devtools-path",
+			description: "Devtools mount path (default /__warlock)",
+			type: "string"
+		},
+		{
+			text: "--id-header",
+			description: "The app's request id header (http.requestId.header; default x-request-id)",
+			type: "string"
+		},
+		{
+			text: "--timeout, -t",
+			description: "How long to wait for the devtools record, in ms (default 5000)",
+			type: "string"
+		},
+		{
+			text: "--json, -j",
+			description: "Print the trace report as JSON (schemaVersion 1)",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { traceCommand };
+//# sourceMappingURL=trace.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/trace.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { traceCommandAction } from \"./trace/trace-command.action\";\n\n/**\n * `warlock trace <method> <url>` — send one request to the running dev server\n * and print its devtools timeline: middleware, validation result, handler,\n * queries with N+1 flags, logs, cache operations, the response and timings.\n * `--json` prints the versioned report (`schemaVersion: 1`).\n *\n * No preload: nothing boots here. The dev server (`warlock dev` with\n * `@warlock.js/devtools` installed) does the work; this command finds it\n * through `.warlock/dev-server.json` or `--url`.\n */\nexport const traceCommand = command({\n  name: \"trace <method> <url>\",\n  description:\n    \"Send a request to the running dev server and print its devtools timeline (middleware, validation, queries, logs, response, timings); --json for the report\",\n  action: traceCommandAction,\n  options: [\n    {\n      text: \"--body, -b\",\n      description: \"Request body: JSON text, plain text, or @file to read it from a file\",\n      type: \"string\",\n    },\n    {\n      text: \"--header, -H\",\n      description: \"A request header as name:value (repeatable)\",\n      type: \"string\",\n    },\n    {\n      text: \"--url, -u\",\n      description: \"Dev server origin (default: read from .warlock/dev-server.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--devtools-path\",\n      description: \"Devtools mount path (default /__warlock)\",\n      type: \"string\",\n    },\n    {\n      text: \"--id-header\",\n      description: \"The app's request id header (http.requestId.header; default x-request-id)\",\n      type: \"string\",\n    },\n    {\n      text: \"--timeout, -t\",\n      description: \"How long to wait for the devtools record, in ms (default 5000)\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Print the trace report as JSON (schemaVersion 1)\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,aACE;CACF,QAAQ;CACR,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,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/typecheck.command.mjs

@@ -0,0 +1,40 @@
+import { command } from "../../commands/cli-command.mjs";
+import { typecheckCommandAction } from "./check/typecheck-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/typecheck.command.ts
+/**
+* `warlock typecheck` — incremental TypeScript check through the compiler
+* API, with `--changed` to limit it to the changed files and their importers.
+* The same problem shape and exit codes as `warlock check`. No preload.
+*/
+const typecheckCommand = command({
+	name: "typecheck",
+	description: "Typecheck the project incrementally; --changed limits it to changed files and the files importing them",
+	action: typecheckCommandAction,
+	options: [
+		{
+			text: "--changed, -c",
+			description: "Only the files changed against HEAD (plus untracked files) and their importers",
+			type: "boolean"
+		},
+		{
+			text: "--base, -b",
+			description: "Compare with the merge base of this ref instead of HEAD (implies --changed)",
+			type: "string"
+		},
+		{
+			text: "--project, -p",
+			description: "tsconfig path (default tsconfig.json)",
+			type: "string"
+		},
+		{
+			text: "--json, -j",
+			description: "Print the result as JSON",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { typecheckCommand };
+//# sourceMappingURL=typecheck.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/typecheck.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { typecheckCommandAction } from \"./check/typecheck-command.action\";\n\n/**\n * `warlock typecheck` — incremental TypeScript check through the compiler\n * API, with `--changed` to limit it to the changed files and their importers.\n * The same problem shape and exit codes as `warlock check`. No preload.\n */\nexport const typecheckCommand = command({\n  name: \"typecheck\",\n  description:\n    \"Typecheck the project incrementally; --changed limits it to changed files and the files importing them\",\n  action: typecheckCommandAction,\n  options: [\n    {\n      text: \"--changed, -c\",\n      description: \"Only the files changed against HEAD (plus untracked files) and their importers\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--base, -b\",\n      description: \"Compare with the merge base of this ref instead of HEAD (implies --changed)\",\n      type: \"string\",\n    },\n    {\n      text: \"--project, -p\",\n      description: \"tsconfig path (default tsconfig.json)\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Print the result as JSON\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;AAQA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aACE;CACF,QAAQ;CACR,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"}