@warlock.js/core 5.29.0 → 5.31.0

package/esm/cli/commands/routes/with-console-on-stderr.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/cli/commands/routes/with-console-on-stderr.ts
+//#region ../../packages/core/src/cli/commands/routes/with-console-on-stderr.ts
 /**
 * Run `task` with `console.log`/`console.info` redirected to stderr, restoring
 * them afterwards. Machine-readable output (`--json`) owns stdout, so progress

package/esm/cli/commands/routes/with-console-on-stderr.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"with-console-on-stderr.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/with-console-on-stderr.ts"],"sourcesContent":["/**\n * Run `task` with `console.log`/`console.info` redirected to stderr, restoring\n * them afterwards. Machine-readable output (`--json`) owns stdout, so progress\n * lines printed while booting (\"processing 64 files...\") must not share it.\n *\n * @param task - The work whose incidental logging must stay off stdout\n * @returns Whatever `task` resolves to\n */\nexport async function withConsoleOnStderr<T>(task: () => Promise<T>): Promise<T> {\n  const { log, info } = console;\n\n  console.log = (...args: unknown[]) => console.error(...args);\n  console.info = (...args: unknown[]) => console.error(...args);\n\n  try {\n    return await task();\n  } finally {\n    console.log = log;\n    console.info = info;\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,eAAsB,oBAAuB,MAAoC;CAC/E,MAAM,EAAE,KAAK,SAAS;CAEtB,QAAQ,OAAO,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAC3D,QAAQ,QAAQ,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAE5D,IAAI;EACF,OAAO,MAAM,KAAK;CACpB,UAAU;EACR,QAAQ,MAAM;EACd,QAAQ,OAAO;CACjB;AACF"}
+{"version":3,"file":"with-console-on-stderr.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/routes/with-console-on-stderr.ts"],"sourcesContent":["/**\n * Run `task` with `console.log`/`console.info` redirected to stderr, restoring\n * them afterwards. Machine-readable output (`--json`) owns stdout, so progress\n * lines printed while booting (\"processing 64 files...\") must not share it.\n *\n * @param task - The work whose incidental logging must stay off stdout\n * @returns Whatever `task` resolves to\n */\nexport async function withConsoleOnStderr<T>(task: () => Promise<T>): Promise<T> {\n  const { log, info } = console;\n\n  console.log = (...args: unknown[]) => console.error(...args);\n  console.info = (...args: unknown[]) => console.error(...args);\n\n  try {\n    return await task();\n  } finally {\n    console.log = log;\n    console.info = info;\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,eAAsB,oBAAuB,MAAoC;CAC/E,MAAM,EAAE,KAAK,SAAS;CAEtB,QAAQ,OAAO,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAC3D,QAAQ,QAAQ,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAE5D,IAAI;EACF,OAAO,MAAM,KAAK;CACpB,UAAU;EACR,QAAQ,MAAM;EACd,QAAQ,OAAO;CACjB;AACF"}

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

@@ -2,7 +2,7 @@ import { command } from "../../commands/cli-command.mjs";
 import { routesCommandAction } from "./routes/routes-command.action.mjs";
 import { routesDiffCommandAction } from "./routes/routes-diff.action.mjs";
 
-//#region ../core/src/cli/commands/routes.command.ts
+//#region ../../packages/core/src/cli/commands/routes.command.ts
 /**
 * `warlock routes` — list every registered HTTP route as a table (a read-only
 * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,

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

@@ -1 +1 @@
-{"version":3,"file":"routes.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/routes.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { routesCommandAction } from \"./routes/routes-command.action\";\nimport { routesDiffCommandAction } from \"./routes/routes-diff.action\";\n\n/**\n * `warlock routes` — list every registered HTTP route as a table (a read-only\n * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,\n * or emit the normalized rows as JSON with `--json`.\n *\n * The preload is config-only and imports no route modules; the action loads them\n * through `bootForDiagnostics()`, the same loader the server uses at boot. A\n * route file that throws on import is reported on stderr instead of being\n * silently omitted from the table.\n */\nexport const routesCommand = command({\n  name: \"routes\",\n  description:\n    \"List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json\",\n  action: routesCommandAction,\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--method, -m\",\n      description: \"Filter by HTTP method (case-insensitive, e.g. GET, POST)\",\n      type: \"string\",\n    },\n    {\n      text: \"--path, -p\",\n      description: \"Filter by a case-insensitive path substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--name, -n\",\n      description: \"Filter by a case-insensitive route-name substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Output the routes as JSON instead of a table\",\n      type: \"boolean\",\n    },\n  ],\n});\n\n/** Compare live development page routes with the last successful build. */\nexport const routesDiffCommand = command({\n  name: \"routes:diff\",\n  description: \"Compare live page routes with the last successful production build\",\n  action: routesDiffCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    warlockConfig: true,\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;CACb;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;;AAGD,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,eAAe;EACf,QAAQ;EACR,KAAK;EACL,WAAW;CACb;AACF,CAAC"}
+{"version":3,"file":"routes.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/routes.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { routesCommandAction } from \"./routes/routes-command.action\";\nimport { routesDiffCommandAction } from \"./routes/routes-diff.action\";\n\n/**\n * `warlock routes` — list every registered HTTP route as a table (a read-only\n * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,\n * or emit the normalized rows as JSON with `--json`.\n *\n * The preload is config-only and imports no route modules; the action loads them\n * through `bootForDiagnostics()`, the same loader the server uses at boot. A\n * route file that throws on import is reported on stderr instead of being\n * silently omitted from the table.\n */\nexport const routesCommand = command({\n  name: \"routes\",\n  description:\n    \"List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json\",\n  action: routesCommandAction,\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--method, -m\",\n      description: \"Filter by HTTP method (case-insensitive, e.g. GET, POST)\",\n      type: \"string\",\n    },\n    {\n      text: \"--path, -p\",\n      description: \"Filter by a case-insensitive path substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--name, -n\",\n      description: \"Filter by a case-insensitive route-name substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Output the routes as JSON instead of a table\",\n      type: \"boolean\",\n    },\n  ],\n});\n\n/** Compare live development page routes with the last successful build. */\nexport const routesDiffCommand = command({\n  name: \"routes:diff\",\n  description: \"Compare live page routes with the last successful production build\",\n  action: routesDiffCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    warlockConfig: true,\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;CACb;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;;AAGD,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,eAAe;EACf,QAAQ;EACR,KAAK;EACL,WAAW;CACb;AACF,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"seed.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/seed.command.ts"],"sourcesContent":["import { seedCommandAction } from \"../../database/seed-command-action\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const seedCommand = command({\n  action: seedCommandAction,\n  name: \"seed\",\n  description: \"Run database seeds\",\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n    connectors: [\"database\", \"cache\", \"logger\", \"storage\"],\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Drop all tables records and run seeds\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"Display the seeds list in order without execution\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--transaction, -t\",\n      description: \"Run seeds in a transaction\",\n      type: \"boolean\",\n      defaultValue: true,\n    },\n    {\n      text: \"--drop, -d\",\n      description:\n        'Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"',\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,cAAc,QAAQ;CACjC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;EACX,YAAY;GAAC;GAAY;GAAS;GAAU;EAAS;CACvD;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;GACN,cAAc;EAChB;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"seed.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/seed.command.ts"],"sourcesContent":["import { seedCommandAction } from \"../../database/seed-command-action\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const seedCommand = command({\n  action: seedCommandAction,\n  name: \"seed\",\n  description: \"Run database seeds\",\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n    connectors: [\"database\", \"cache\", \"logger\", \"storage\"],\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Drop all tables records and run seeds\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"Display the seeds list in order without execution\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--transaction, -t\",\n      description: \"Run seeds in a transaction\",\n      type: \"boolean\",\n      defaultValue: true,\n    },\n    {\n      text: \"--drop, -d\",\n      description:\n        'Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"',\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,cAAc,QAAQ;CACjC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;EACX,YAAY;GAAC;GAAY;GAAS;GAAU;EAAS;CACvD;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;GACN,cAAc;EAChB;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/start-production.command.mjs

@@ -4,7 +4,7 @@ import { resolveBuildConfig } from "../../production/resolve-build-config.mjs";
 import { checkDistReadyToStartAsync } from "../../production/assert-dist-ready-to-start.mjs";
 import { superviseProductionProcess } from "../../production/production-supervisor.mjs";
 
-//#region ../core/src/cli/commands/start-production.command.ts
+//#region ../../packages/core/src/cli/commands/start-production.command.ts
 const NODE_FLAG_PATTERN = /^--(inspect(-brk|-wait)?(=.*)?|max-old-space-size=.*|enable-source-maps|trace-.*)$/;
 /** `--role`/`--sites`, in both `--role=x` and `--role x` forms — recognised
 * here so they never leak into the child's app argv (they become

package/esm/cli/commands/start-production.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"start-production.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/start-production.command.ts"],"sourcesContent":["import { assertSitesRequireWebRole, parseRoles, parseSites } from \"../../application/roles\";\nimport { checkDistReadyToStartAsync } from \"../../production/assert-dist-ready-to-start\";\nimport { superviseProductionProcess } from \"../../production/production-supervisor\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { command } from \"../../commands/cli-command\";\n\nconst NODE_FLAG_PATTERN =\n  /^--(inspect(-brk|-wait)?(=.*)?|max-old-space-size=.*|enable-source-maps|trace-.*)$/;\n\n/** `--role`/`--sites`, in both `--role=x` and `--role x` forms — recognised\n * here so they never leak into the child's app argv (they become\n * `WARLOCK_ROLES`/`WARLOCK_SITES` env vars instead). */\nconst ROLE_OPTION_PATTERN = /^--(role|sites)(=.*)?$/;\n\nexport const startProductionCommand = command({\n  name: \"start\",\n  description: \"Start production server\",\n  persistent: true,\n  preload: {\n    warlockConfig: true,\n  },\n  action: async (data) => {\n    // Validated BEFORE the dist check and the spawn: an unknown role or a\n    // `--sites` without `web` is an operator mistake, and the sooner it fails\n    // the less it looks like the build (or the child) is at fault.\n    const roleOption = typeof data.options.role === \"string\" ? data.options.role : undefined;\n    const sitesOption = typeof data.options.sites === \"string\" ? data.options.sites : undefined;\n\n    let roles;\n    let sites;\n\n    try {\n      roles = parseRoles(roleOption);\n      sites = parseSites(sitesOption);\n      assertSitesRequireWebRole(roles, sites);\n    } catch (error) {\n      console.error(`✖ ${(error as Error).message}`);\n      process.exit(1);\n      return;\n    }\n\n    const { entryPath, sourcemap, outdir } = resolveBuildConfig();\n\n    // Refuse a `dist` that did not come from a successful `warlock build` —\n    // named explicitly, rather than failing later and incidentally because\n    // some file the server happens to need (the client manifest, say) is\n    // missing. See `assert-dist-ready-to-start.ts`.\n    const readiness = await checkDistReadyToStartAsync(outdir);\n\n    if (!readiness.ready) {\n      console.error(`✖ ${readiness.reason}`);\n      process.exit(1);\n      return;\n    }\n\n    // Build node args\n    const nodeArgs: string[] = [];\n\n    // Enable source maps if configured\n    if (sourcemap !== false) {\n      nodeArgs.push(\"--enable-source-maps\");\n    }\n\n    // Recognised Node flags go BEFORE the entry file; everything else is app argv.\n    // process.argv = [node, cli.ts, start, ...extra]\n    const appArgs: string[] = [];\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\n      const rest = process.argv.slice(startIndex + 1);\n\n      for (let i = 0; i < rest.length; i++) {\n        const arg = rest[i] as string;\n\n        if (NODE_FLAG_PATTERN.test(arg)) {\n          nodeArgs.push(arg);\n          continue;\n        }\n\n        // `--role`/`--sites` are framework plumbing, resolved above into\n        // `WARLOCK_ROLES`/`WARLOCK_SITES` — they must not also reach the\n        // child as app argv.\n        if (ROLE_OPTION_PATTERN.test(arg)) {\n          const next = rest[i + 1];\n\n          // `--role=x` already carries its value; `--role x` consumes the\n          // following token too, unless it looks like another flag.\n          if (!arg.includes(\"=\") && next !== undefined && !next.startsWith(\"-\")) {\n            i++;\n          }\n\n          continue;\n        }\n\n        appArgs.push(arg);\n      }\n    }\n\n    nodeArgs.push(entryPath, ...appArgs);\n\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\n    // outcome. The banner that used to print here, in `preAction`, printed\n    // before the child had even been spawned.\n    console.error(`🚀 Starting production server...\\n`);\n\n    const env: NodeJS.ProcessEnv = { ...process.env, WARLOCK_ROLES: [...roles].join(\",\") };\n\n    if (sites) {\n      env.WARLOCK_SITES = [...sites].join(\",\");\n    }\n\n    const { exitCode } = await superviseProductionProcess({ nodeArgs, env });\n\n    process.exit(exitCode);\n  },\n  options: [\n    {\n      text: \"--role\",\n      description: \"Comma-separated roles to serve: api, web, worker. Defaults to every role.\",\n      type: \"string\",\n    },\n    {\n      text: \"--sites\",\n      description: \"Comma-separated site keys to install pages for. Requires --role=web.\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;AAMA,MAAM,oBACJ;;;;AAKF,MAAM,sBAAsB;AAE5B,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,OAAO,SAAS;EAItB,MAAM,aAAa,OAAO,KAAK,QAAQ,SAAS,WAAW,KAAK,QAAQ,OAAO;EAC/E,MAAM,cAAc,OAAO,KAAK,QAAQ,UAAU,WAAW,KAAK,QAAQ,QAAQ;EAElF,IAAI;EACJ,IAAI;EAEJ,IAAI;GACF,QAAQ,WAAW,UAAU;GAC7B,QAAQ,WAAW,WAAW;GAC9B,0BAA0B,OAAO,KAAK;EACxC,SAAS,OAAO;GACd,QAAQ,MAAM,KAAM,MAAgB,SAAS;GAC7C,QAAQ,KAAK,CAAC;GACd;EACF;EAEA,MAAM,EAAE,WAAW,WAAW,WAAW,mBAAmB;EAM5D,MAAM,YAAY,MAAM,2BAA2B,MAAM;EAEzD,IAAI,CAAC,UAAU,OAAO;GACpB,QAAQ,MAAM,KAAK,UAAU,QAAQ;GACrC,QAAQ,KAAK,CAAC;GACd;EACF;EAGA,MAAM,WAAqB,CAAC;EAG5B,IAAI,cAAc,OAChB,SAAS,KAAK,sBAAsB;EAKtC,MAAM,UAAoB,CAAC;EAC3B,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,OAAO,QAAQ,KAAK,MAAM,aAAa,CAAC;GAE9C,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;IACpC,MAAM,MAAM,KAAK;IAEjB,IAAI,kBAAkB,KAAK,GAAG,GAAG;KAC/B,SAAS,KAAK,GAAG;KACjB;IACF;IAKA,IAAI,oBAAoB,KAAK,GAAG,GAAG;KACjC,MAAM,OAAO,KAAK,IAAI;KAItB,IAAI,CAAC,IAAI,SAAS,GAAG,KAAK,SAAS,UAAa,CAAC,KAAK,WAAW,GAAG,GAClE;KAGF;IACF;IAEA,QAAQ,KAAK,GAAG;GAClB;EACF;EAEA,SAAS,KAAK,WAAW,GAAG,OAAO;EAMnC,QAAQ,MAAM,oCAAoC;EAElD,MAAM,MAAyB;GAAE,GAAG,QAAQ;GAAK,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,GAAG;EAAE;EAErF,IAAI,OACF,IAAI,gBAAgB,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,GAAG;EAGzC,MAAM,EAAE,aAAa,MAAM,2BAA2B;GAAE;GAAU;EAAI,CAAC;EAEvE,QAAQ,KAAK,QAAQ;CACvB;CACA,SAAS,CACP;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,CACF;AACF,CAAC"}
+{"version":3,"file":"start-production.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/start-production.command.ts"],"sourcesContent":["import { assertSitesRequireWebRole, parseRoles, parseSites } from \"../../application/roles\";\nimport { checkDistReadyToStartAsync } from \"../../production/assert-dist-ready-to-start\";\nimport { superviseProductionProcess } from \"../../production/production-supervisor\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { command } from \"../../commands/cli-command\";\n\nconst NODE_FLAG_PATTERN =\n  /^--(inspect(-brk|-wait)?(=.*)?|max-old-space-size=.*|enable-source-maps|trace-.*)$/;\n\n/** `--role`/`--sites`, in both `--role=x` and `--role x` forms — recognised\n * here so they never leak into the child's app argv (they become\n * `WARLOCK_ROLES`/`WARLOCK_SITES` env vars instead). */\nconst ROLE_OPTION_PATTERN = /^--(role|sites)(=.*)?$/;\n\nexport const startProductionCommand = command({\n  name: \"start\",\n  description: \"Start production server\",\n  persistent: true,\n  preload: {\n    warlockConfig: true,\n  },\n  action: async (data) => {\n    // Validated BEFORE the dist check and the spawn: an unknown role or a\n    // `--sites` without `web` is an operator mistake, and the sooner it fails\n    // the less it looks like the build (or the child) is at fault.\n    const roleOption = typeof data.options.role === \"string\" ? data.options.role : undefined;\n    const sitesOption = typeof data.options.sites === \"string\" ? data.options.sites : undefined;\n\n    let roles;\n    let sites;\n\n    try {\n      roles = parseRoles(roleOption);\n      sites = parseSites(sitesOption);\n      assertSitesRequireWebRole(roles, sites);\n    } catch (error) {\n      console.error(`✖ ${(error as Error).message}`);\n      process.exit(1);\n      return;\n    }\n\n    const { entryPath, sourcemap, outdir } = resolveBuildConfig();\n\n    // Refuse a `dist` that did not come from a successful `warlock build` —\n    // named explicitly, rather than failing later and incidentally because\n    // some file the server happens to need (the client manifest, say) is\n    // missing. See `assert-dist-ready-to-start.ts`.\n    const readiness = await checkDistReadyToStartAsync(outdir);\n\n    if (!readiness.ready) {\n      console.error(`✖ ${readiness.reason}`);\n      process.exit(1);\n      return;\n    }\n\n    // Build node args\n    const nodeArgs: string[] = [];\n\n    // Enable source maps if configured\n    if (sourcemap !== false) {\n      nodeArgs.push(\"--enable-source-maps\");\n    }\n\n    // Recognised Node flags go BEFORE the entry file; everything else is app argv.\n    // process.argv = [node, cli.ts, start, ...extra]\n    const appArgs: string[] = [];\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\n      const rest = process.argv.slice(startIndex + 1);\n\n      for (let i = 0; i < rest.length; i++) {\n        const arg = rest[i] as string;\n\n        if (NODE_FLAG_PATTERN.test(arg)) {\n          nodeArgs.push(arg);\n          continue;\n        }\n\n        // `--role`/`--sites` are framework plumbing, resolved above into\n        // `WARLOCK_ROLES`/`WARLOCK_SITES` — they must not also reach the\n        // child as app argv.\n        if (ROLE_OPTION_PATTERN.test(arg)) {\n          const next = rest[i + 1];\n\n          // `--role=x` already carries its value; `--role x` consumes the\n          // following token too, unless it looks like another flag.\n          if (!arg.includes(\"=\") && next !== undefined && !next.startsWith(\"-\")) {\n            i++;\n          }\n\n          continue;\n        }\n\n        appArgs.push(arg);\n      }\n    }\n\n    nodeArgs.push(entryPath, ...appArgs);\n\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\n    // outcome. The banner that used to print here, in `preAction`, printed\n    // before the child had even been spawned.\n    console.error(`🚀 Starting production server...\\n`);\n\n    const env: NodeJS.ProcessEnv = { ...process.env, WARLOCK_ROLES: [...roles].join(\",\") };\n\n    if (sites) {\n      env.WARLOCK_SITES = [...sites].join(\",\");\n    }\n\n    const { exitCode } = await superviseProductionProcess({ nodeArgs, env });\n\n    process.exit(exitCode);\n  },\n  options: [\n    {\n      text: \"--role\",\n      description: \"Comma-separated roles to serve: api, web, worker. Defaults to every role.\",\n      type: \"string\",\n    },\n    {\n      text: \"--sites\",\n      description: \"Comma-separated site keys to install pages for. Requires --role=web.\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;AAMA,MAAM,oBACJ;;;;AAKF,MAAM,sBAAsB;AAE5B,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,OAAO,SAAS;EAItB,MAAM,aAAa,OAAO,KAAK,QAAQ,SAAS,WAAW,KAAK,QAAQ,OAAO;EAC/E,MAAM,cAAc,OAAO,KAAK,QAAQ,UAAU,WAAW,KAAK,QAAQ,QAAQ;EAElF,IAAI;EACJ,IAAI;EAEJ,IAAI;GACF,QAAQ,WAAW,UAAU;GAC7B,QAAQ,WAAW,WAAW;GAC9B,0BAA0B,OAAO,KAAK;EACxC,SAAS,OAAO;GACd,QAAQ,MAAM,KAAM,MAAgB,SAAS;GAC7C,QAAQ,KAAK,CAAC;GACd;EACF;EAEA,MAAM,EAAE,WAAW,WAAW,WAAW,mBAAmB;EAM5D,MAAM,YAAY,MAAM,2BAA2B,MAAM;EAEzD,IAAI,CAAC,UAAU,OAAO;GACpB,QAAQ,MAAM,KAAK,UAAU,QAAQ;GACrC,QAAQ,KAAK,CAAC;GACd;EACF;EAGA,MAAM,WAAqB,CAAC;EAG5B,IAAI,cAAc,OAChB,SAAS,KAAK,sBAAsB;EAKtC,MAAM,UAAoB,CAAC;EAC3B,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,OAAO,QAAQ,KAAK,MAAM,aAAa,CAAC;GAE9C,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;IACpC,MAAM,MAAM,KAAK;IAEjB,IAAI,kBAAkB,KAAK,GAAG,GAAG;KAC/B,SAAS,KAAK,GAAG;KACjB;IACF;IAKA,IAAI,oBAAoB,KAAK,GAAG,GAAG;KACjC,MAAM,OAAO,KAAK,IAAI;KAItB,IAAI,CAAC,IAAI,SAAS,GAAG,KAAK,SAAS,UAAa,CAAC,KAAK,WAAW,GAAG,GAClE;KAGF;IACF;IAEA,QAAQ,KAAK,GAAG;GAClB;EACF;EAEA,SAAS,KAAK,WAAW,GAAG,OAAO;EAMnC,QAAQ,MAAM,oCAAoC;EAElD,MAAM,MAAyB;GAAE,GAAG,QAAQ;GAAK,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,GAAG;EAAE;EAErF,IAAI,OACF,IAAI,gBAAgB,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,GAAG;EAGzC,MAAM,EAAE,aAAa,MAAM,2BAA2B;GAAE;GAAU;EAAI,CAAC;EAEvE,QAAQ,KAAK,QAAQ;CACvB;CACA,SAAS,CACP;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,CACF;AACF,CAAC"}

package/esm/cli/commands/storage-put.action.mjs

@@ -5,7 +5,7 @@ import "../../storage/index.mjs";
 import path from "path";
 import fs from "fs/promises";
 
-//#region ../core/src/cli/commands/storage-put.action.ts
+//#region ../../packages/core/src/cli/commands/storage-put.action.ts
 /**
 * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`
 *

package/esm/cli/commands/storage-put.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-put.action.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.action.ts"],"sourcesContent":["import fs from \"fs/promises\";\nimport path from \"path\";\nimport { config } from \"../../config\";\nimport { storage } from \"../../storage\";\nimport type { CommandActionData } from \"../../commands/types\";\n\n/**\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\n *\n * Uploads a local file or directory into any configured storage driver.\n * Auto-detects whether <localPath> is a file or directory and calls the\n * appropriate storage method.\n *\n * @example\n * # Upload entire uploads directory to R2 (root of bucket)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload to a specific destination prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload with custom concurrency\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\n */\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\n  const [localPath, destination = \"\"] = args;\n\n  if (!localPath) {\n    console.error(\"✖  Missing required argument: <localPath>\");\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\n    process.exit(1);\n  }\n\n  // Resolve to absolute path relative to CWD\n  const absolutePath = path.resolve(process.cwd(), localPath);\n  const driverName = options.driver as string | undefined;\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\n\n  // Verify the local path exists\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\n  try {\n    stat = await fs.stat(absolutePath);\n  } catch {\n    console.error(`✖  Path not found: ${absolutePath}`);\n    process.exit(1);\n  }\n\n  // Select the driver — use named driver or fall back to default\n  const store = driverName ? storage.use(driverName) : storage;\n  const driverLabel = driverName ?? config.get(\"storage.default\");\n\n  console.log(`\\n  Driver    : ${driverLabel}`);\n  console.log(`  Source    : ${absolutePath}`);\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\n\n  if (stat.isDirectory()) {\n    // ── Directory upload ────────────────────────────────────────────────────\n    const result = await store.putDirectory(absolutePath, destination, {\n      concurrency,\n      // Skip hidden files (e.g. .DS_Store) by default\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\n      onProgress: (done, total, file) => {\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\n      },\n    });\n\n    // Clear the progress line and print summary\n    process.stdout.write(\"\\n\");\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\n\n    if (result.failed.length > 0) {\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\n      for (const { localPath: fp, error } of result.failed) {\n        console.warn(`     - ${fp}: ${error.message}`);\n      }\n\n      process.exitCode = 1;\n    }\n  } else {\n    // ── Single file upload ──────────────────────────────────────────────────\n    // Destination is used as the storage path; if empty, fall back to filename\n    const storagePath = destination || path.basename(absolutePath);\n\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\n\n    const file = await store.putFromPath(absolutePath, storagePath);\n\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\n  }\n\n  console.log();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,iBAAiB,EAAE,MAAM,WAA6C;CAC1F,MAAM,CAAC,WAAW,cAAc,MAAM;CAEtC,IAAI,CAAC,WAAW;EACd,QAAQ,MAAM,2CAA2C;EACzD,QAAQ,MAAM,2EAA2E;EACzF,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,eAAe,KAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS;CAC1D,MAAM,aAAa,QAAQ;CAC3B,MAAM,cAAc,QAAQ,cAAc,OAAO,QAAQ,WAAW,IAAI;CAGxE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,YAAY;CACnC,QAAQ;EACN,QAAQ,MAAM,sBAAsB,cAAc;EAClD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAAI;CACrD,MAAM,cAAc,cAAc,OAAO,IAAI,iBAAiB;CAE9D,QAAQ,IAAI,mBAAmB,aAAa;CAC5C,QAAQ,IAAI,iBAAiB,cAAc;CAC3C,QAAQ,IAAI,iBAAiB,eAAe,SAAS,GAAG;CAExD,IAAI,KAAK,YAAY,GAAG;EAEtB,MAAM,SAAS,MAAM,MAAM,aAAa,cAAc,aAAa;GACjE;GAEA,SAAS,GAAG,QAAQ,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,WAAW,GAAG;GACtD,aAAa,MAAM,OAAO,SAAS;IACjC,QAAQ,OAAO,MAAM,mBAAmB,KAAK,GAAG,MAAM,IAAI,KAAK,MAAM;GACvE;EACF,CAAC;EAGD,QAAQ,OAAO,MAAM,IAAI;EACzB,QAAQ,IAAI,UAAU,OAAO,SAAS,OAAO,kBAAkB;EAE/D,IAAI,OAAO,OAAO,SAAS,GAAG;GAC5B,QAAQ,KAAK,UAAU,OAAO,OAAO,OAAO,iBAAiB;GAC7D,KAAK,MAAM,EAAE,WAAW,IAAI,WAAW,OAAO,QAC5C,QAAQ,KAAK,UAAU,GAAG,IAAI,MAAM,SAAS;GAG/C,QAAQ,WAAW;EACrB;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,YAAY,cAAc,WAAW;EAE9D,QAAQ,IAAI,oBAAoB,KAAK,KAAK;CAC5C;CAEA,QAAQ,IAAI;AACd"}
+{"version":3,"file":"storage-put.action.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/storage-put.action.ts"],"sourcesContent":["import fs from \"fs/promises\";\nimport path from \"path\";\nimport { config } from \"../../config\";\nimport { storage } from \"../../storage\";\nimport type { CommandActionData } from \"../../commands/types\";\n\n/**\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\n *\n * Uploads a local file or directory into any configured storage driver.\n * Auto-detects whether <localPath> is a file or directory and calls the\n * appropriate storage method.\n *\n * @example\n * # Upload entire uploads directory to R2 (root of bucket)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload to a specific destination prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload with custom concurrency\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\n */\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\n  const [localPath, destination = \"\"] = args;\n\n  if (!localPath) {\n    console.error(\"✖  Missing required argument: <localPath>\");\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\n    process.exit(1);\n  }\n\n  // Resolve to absolute path relative to CWD\n  const absolutePath = path.resolve(process.cwd(), localPath);\n  const driverName = options.driver as string | undefined;\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\n\n  // Verify the local path exists\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\n  try {\n    stat = await fs.stat(absolutePath);\n  } catch {\n    console.error(`✖  Path not found: ${absolutePath}`);\n    process.exit(1);\n  }\n\n  // Select the driver — use named driver or fall back to default\n  const store = driverName ? storage.use(driverName) : storage;\n  const driverLabel = driverName ?? config.get(\"storage.default\");\n\n  console.log(`\\n  Driver    : ${driverLabel}`);\n  console.log(`  Source    : ${absolutePath}`);\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\n\n  if (stat.isDirectory()) {\n    // ── Directory upload ────────────────────────────────────────────────────\n    const result = await store.putDirectory(absolutePath, destination, {\n      concurrency,\n      // Skip hidden files (e.g. .DS_Store) by default\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\n      onProgress: (done, total, file) => {\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\n      },\n    });\n\n    // Clear the progress line and print summary\n    process.stdout.write(\"\\n\");\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\n\n    if (result.failed.length > 0) {\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\n      for (const { localPath: fp, error } of result.failed) {\n        console.warn(`     - ${fp}: ${error.message}`);\n      }\n\n      process.exitCode = 1;\n    }\n  } else {\n    // ── Single file upload ──────────────────────────────────────────────────\n    // Destination is used as the storage path; if empty, fall back to filename\n    const storagePath = destination || path.basename(absolutePath);\n\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\n\n    const file = await store.putFromPath(absolutePath, storagePath);\n\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\n  }\n\n  console.log();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,iBAAiB,EAAE,MAAM,WAA6C;CAC1F,MAAM,CAAC,WAAW,cAAc,MAAM;CAEtC,IAAI,CAAC,WAAW;EACd,QAAQ,MAAM,2CAA2C;EACzD,QAAQ,MAAM,2EAA2E;EACzF,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,eAAe,KAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS;CAC1D,MAAM,aAAa,QAAQ;CAC3B,MAAM,cAAc,QAAQ,cAAc,OAAO,QAAQ,WAAW,IAAI;CAGxE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,YAAY;CACnC,QAAQ;EACN,QAAQ,MAAM,sBAAsB,cAAc;EAClD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAAI;CACrD,MAAM,cAAc,cAAc,OAAO,IAAI,iBAAiB;CAE9D,QAAQ,IAAI,mBAAmB,aAAa;CAC5C,QAAQ,IAAI,iBAAiB,cAAc;CAC3C,QAAQ,IAAI,iBAAiB,eAAe,SAAS,GAAG;CAExD,IAAI,KAAK,YAAY,GAAG;EAEtB,MAAM,SAAS,MAAM,MAAM,aAAa,cAAc,aAAa;GACjE;GAEA,SAAS,GAAG,QAAQ,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,WAAW,GAAG;GACtD,aAAa,MAAM,OAAO,SAAS;IACjC,QAAQ,OAAO,MAAM,mBAAmB,KAAK,GAAG,MAAM,IAAI,KAAK,MAAM;GACvE;EACF,CAAC;EAGD,QAAQ,OAAO,MAAM,IAAI;EACzB,QAAQ,IAAI,UAAU,OAAO,SAAS,OAAO,kBAAkB;EAE/D,IAAI,OAAO,OAAO,SAAS,GAAG;GAC5B,QAAQ,KAAK,UAAU,OAAO,OAAO,OAAO,iBAAiB;GAC7D,KAAK,MAAM,EAAE,WAAW,IAAI,WAAW,OAAO,QAC5C,QAAQ,KAAK,UAAU,GAAG,IAAI,MAAM,SAAS;GAG/C,QAAQ,WAAW;EACrB;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,YAAY,cAAc,WAAW;EAE9D,QAAQ,IAAI,oBAAoB,KAAK,KAAK;CAC5C;CAEA,QAAQ,IAAI;AACd"}

package/esm/cli/commands/storage-put.command.mjs

@@ -1,7 +1,7 @@
 import { command } from "../../commands/cli-command.mjs";
 import { storagePutAction } from "./storage-put.action.mjs";
 
-//#region ../core/src/cli/commands/storage-put.command.ts
+//#region ../../packages/core/src/cli/commands/storage-put.command.ts
 /**
 * `storage.put` CLI command
 *

package/esm/cli/commands/storage-put.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-put.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { storagePutAction } from \"./storage-put.action\";\n\n/**\n * `storage.put` CLI command\n *\n * Uploads a local file or directory to any configured storage driver.\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\n *\n * @example\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload under a specific prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload to default driver\n * warlock storage.put ./public/logo.png assets/logo.png\n */\nexport const storagePutCommand = command({\n  name: \"storage.put <localPath> [destination]\",\n  alias: \"sput\",\n  action: storagePutAction,\n  description: \"Upload a local file or directory to storage\",\n  preload: {\n    env: true,\n    config: [\"storage\"],\n    connectors: [\"storage\"],\n  },\n  options: [\n    {\n      text: \"--driver, -d\",\n      description:\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\n    },\n    {\n      text: \"--concurrency, -c\",\n      description: \"Number of concurrent uploads when uploading a directory\",\n      type: \"number\",\n      defaultValue: 5,\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,OAAO;CACP,QAAQ;CACR,aAAa;CACb,SAAS;EACP,KAAK;EACL,QAAQ,CAAC,SAAS;EAClB,YAAY,CAAC,SAAS;CACxB;CACA,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;EACN,cAAc;CAChB,CACF;AACF,CAAC"}
+{"version":3,"file":"storage-put.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/storage-put.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { storagePutAction } from \"./storage-put.action\";\n\n/**\n * `storage.put` CLI command\n *\n * Uploads a local file or directory to any configured storage driver.\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\n *\n * @example\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload under a specific prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload to default driver\n * warlock storage.put ./public/logo.png assets/logo.png\n */\nexport const storagePutCommand = command({\n  name: \"storage.put <localPath> [destination]\",\n  alias: \"sput\",\n  action: storagePutAction,\n  description: \"Upload a local file or directory to storage\",\n  preload: {\n    env: true,\n    config: [\"storage\"],\n    connectors: [\"storage\"],\n  },\n  options: [\n    {\n      text: \"--driver, -d\",\n      description:\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\n    },\n    {\n      text: \"--concurrency, -c\",\n      description: \"Number of concurrent uploads when uploading a directory\",\n      type: \"number\",\n      defaultValue: 5,\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,OAAO;CACP,QAAQ;CACR,aAAa;CACb,SAAS;EACP,KAAK;EACL,QAAQ,CAAC,SAAS;EAClB,YAAY,CAAC,SAAS;CACxB;CACA,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;EACN,cAAc;CAChB,CACF;AACF,CAAC"}

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"}

package/esm/cli/commands/typings-generator.command.mjs

@@ -8,7 +8,7 @@ import { resolveBuildConfig } from "../../production/resolve-build-config.mjs";
 import { typeGenerator } from "../../dev-server/type-generator.mjs";
 import { runConnectorTypings } from "../../dev-server/run-connector-typings.mjs";
 
-//#region ../core/src/cli/commands/typings-generator.command.ts
+//#region ../../packages/core/src/cli/commands/typings-generator.command.ts
 /**
 * Standalone `warlock generate.typings`.
 *