@warlock.js/core 5.1.0 → 5.2.0

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

@@ -0,0 +1,84 @@
+import { matchesDerivedRouteName } from "../../../router/route-name-method-suffix.mjs";
+
+//#region core/src/cli/commands/routes/diff-page-routes.ts
+/**
+* The comparison half of `warlock routes:diff`, kept free of the filesystem,
+* the boot and the console so it can be exercised directly.
+*
+* WHAT THE TWO SIDES ACTUALLY ARE
+*
+* `expected` comes from `page-routes.manifest.json`, which `warlock build`
+* writes from a pure FILESYSTEM SCAN of the page graph. No application module
+* is imported, no connector boots, no route is registered.
+*
+* `live` comes from the running router, after real registration.
+*
+* Every difference between the two that is NOT drift has to be removed on the
+* producing side, so this comparison can stay a strict string equality — see
+* `normalizeRoutePath` for the path half. Exactly one property survives that
+* rule and is handled here instead, because it is genuinely unknowable at
+* build time: the route-name method suffix (below).
+*/
+/** Stable ordering for printed output: by path, then by name. */
+function comparePageRoutes(left, right) {
+	return left.path.localeCompare(right.path) || left.name.localeCompare(right.name);
+}
+/**
+* Whether a live route is the same route the build recorded.
+*
+* Method and path must match EXACTLY. The name is compared derived-to-derived:
+* the router appends `.<method>` to a name already claimed by a route of
+* another method (`Router.add`), and which routes get that suffix depends on
+* the registration order across the whole route set — pages and API routes
+* alike. `warlock build` never boots connectors, so the manifest cannot see the
+* API routes that cause the collision and can never record the suffix.
+*
+* Ignoring it here is therefore not leniency, it is reading the manifest for
+* what it is: a record of what each page's name was DERIVED as, not of what it
+* was REGISTERED as. `matchesDerivedRouteName` accepts only the one suffix the
+* router itself could have appended; any other name difference is still drift.
+*
+* THE LIMIT THIS BUYS: a clean diff does not prove that no page name collided
+* at registration. Use `warlock routes` to see the names as registered.
+*/
+function isSameRoute(expected, live) {
+	return live.method === expected.method && live.path === expected.path && matchesDerivedRouteName(expected.name, live.name, live.method);
+}
+/**
+* Diff the build-time page route surface against the live one.
+*
+* Neither input is mutated and neither has to be pre-sorted; the returned lists
+* are sorted for printing.
+*/
+function diffPageRoutes(expected, live) {
+	const remainingExpected = new Set(expected);
+	const remainingLive = new Set(live);
+	const changes = [];
+	for (const before of expected) {
+		const after = [...remainingLive].find((candidate) => isSameRoute(before, candidate));
+		if (after) {
+			remainingExpected.delete(before);
+			remainingLive.delete(after);
+		}
+	}
+	for (const before of remainingExpected) {
+		const after = [...remainingLive].find((candidate) => candidate.source !== "" && candidate.source === before.source);
+		if (after && !isSameRoute(before, after)) {
+			changes.push({
+				before,
+				after
+			});
+			remainingExpected.delete(before);
+			remainingLive.delete(after);
+		}
+	}
+	return {
+		changes: changes.sort((left, right) => comparePageRoutes(left.before, right.before)),
+		removed: [...remainingExpected].sort(comparePageRoutes),
+		added: [...remainingLive].sort(comparePageRoutes)
+	};
+}
+
+//#endregion
+export { comparePageRoutes, diffPageRoutes };
+//# sourceMappingURL=diff-page-routes.mjs.map

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"routes-command.action.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/routes/routes-command.action.ts"],"sourcesContent":["import { router } from \"../../../router/router\";\r\nimport type { CommandActionData } from \"../../../commands/types\";\r\nimport { printRoutesTable } from \"./format-routes-table\";\r\nimport { filterRouteRows, sortRouteRows, toRouteRow } from \"./route-row\";\r\n\r\n/**\r\n * Read the active option as a trimmed string, or `undefined` when it is absent\r\n * or not a string (a bare boolean flag).\r\n *\r\n * @param value - The parsed option value\r\n * @returns The string value, or `undefined`\r\n */\r\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\r\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\r\n}\r\n\r\n/**\r\n * Action behind `warlock routes`. Reads the registered routes from the router\r\n * singleton (populated by the `bootstrap` preload, with no connectors started),\r\n * applies the `--method` / `--path` / `--name` filters, sorts them, and either\r\n * prints a verb-colored table or — with `--json` — emits the normalized rows as\r\n * JSON for piping into scripts/CI.\r\n *\r\n * Read-only: it never opens a database/cache/socket connection and never\r\n * mutates the router.\r\n *\r\n * @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).\r\n */\r\nexport function routesCommandAction({ options }: CommandActionData): void {\r\n  const rows = sortRouteRows(\r\n    filterRouteRows(router.list().map(toRouteRow), {\r\n      method: stringOption(options.method),\r\n      path: stringOption(options.path),\r\n      name: stringOption(options.name),\r\n    }),\r\n  );\r\n\r\n  if (options.json) {\r\n    console.log(JSON.stringify(rows, null, 2));\r\n    return;\r\n  }\r\n\r\n  printRoutesTable(rows);\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAYA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;;AAcA,SAAgB,oBAAoB,EAAE,WAAoC;CACxE,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG;EAC7C,QAAQ,aAAa,QAAQ,MAAM;EACnC,MAAM,aAAa,QAAQ,IAAI;EAC/B,MAAM,aAAa,QAAQ,IAAI;CACjC,CAAC,CACH;CAEA,IAAI,QAAQ,MAAM;EAChB,QAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,iBAAiB,IAAI;AACvB"}
+{"version":3,"file":"routes-command.action.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/routes/routes-command.action.ts"],"sourcesContent":["import { router } from \"../../../router/router\";\r\nimport type { CommandActionData } from \"../../../commands/types\";\r\nimport { printRoutesTable } from \"./format-routes-table\";\r\nimport { filterRouteRows, sortRouteRows, toRouteRow } from \"./route-row\";\r\n\r\n/**\r\n * Read the active option as a trimmed string, or `undefined` when it is absent\r\n * or not a string (a bare boolean flag).\r\n *\r\n * @param value - The parsed option value\r\n * @returns The string value, or `undefined`\r\n */\r\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\r\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\r\n}\r\n\r\n/**\r\n * Action behind `warlock routes`. Reads the registered routes from the router\r\n * singleton (populated by the `bootstrap` preload, with no connectors started),\r\n * applies the `--method` / `--path` / `--name` filters, sorts them, and either\r\n * prints a verb-colored table or — with `--json` — emits the normalized rows as\r\n * JSON for piping into scripts/CI.\r\n *\r\n * Read-only: it never opens a database/cache/socket connection and never\r\n * mutates the router.\r\n *\r\n * @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).\r\n */\r\nexport function routesCommandAction({ options }: CommandActionData): void {\r\n  const rows = sortRouteRows(\r\n    filterRouteRows(router.list().map(toRouteRow), {\r\n      method: stringOption(options.method),\r\n      path: stringOption(options.path),\r\n      name: stringOption(options.name),\r\n    }),\r\n  );\r\n\r\n  if (options.json) {\r\n    console.log(JSON.stringify(rows, null, 2));\r\n    return;\r\n  }\r\n\r\n  printRoutesTable(rows);\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAYA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;;AAcA,SAAgB,oBAAoB,EAAE,WAAoC;CACxE,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,EAAE,IAAI,UAAU,GAAG;EAC7C,QAAQ,aAAa,QAAQ,MAAM;EACnC,MAAM,aAAa,QAAQ,IAAI;EAC/B,MAAM,aAAa,QAAQ,IAAI;CACjC,CAAC,CACH;CAEA,IAAI,QAAQ,MAAM;EAChB,QAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,iBAAiB,IAAI;AACvB"}

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

@@ -0,0 +1,84 @@
+import { router } from "../../../router/router.mjs";
+import { resolveBuildConfig } from "../../../production/resolve-build-config.mjs";
+import { bootForDiagnostics } from "../doctor/boot-for-diagnostics.mjs";
+import { comparePageRoutes, diffPageRoutes } from "./diff-page-routes.mjs";
+import path from "node:path";
+import fs from "node:fs";
+
+//#region core/src/cli/commands/routes/routes-diff.action.ts
+const SNAPSHOT_FILE = "page-routes.manifest.json";
+/**
+* What a clean `warlock routes:diff` does and does NOT prove, printed on a
+* clean run so the guarantee is stated where it is relied on.
+*/
+const CLEAN_RUN_LIMIT = "Note: page names are compared as DERIVED by the build, so a clean diff does not prove that no route name collided at registration (the router appends `.<method>` to a name already claimed by another method). Run `warlock routes` to see the registered names.";
+function routeFromLive(route) {
+	return {
+		method: route.method.toUpperCase(),
+		path: route.path,
+		name: route.name ?? "",
+		source: route.sourceFile ?? ""
+	};
+}
+function snapshotPath() {
+	return path.join(resolveBuildConfig().outdir, SNAPSHOT_FILE);
+}
+function readSnapshot(file) {
+	let raw;
+	try {
+		raw = fs.readFileSync(file, "utf-8");
+	} catch {
+		throw new Error(`Cannot compare page routes: no build snapshot exists at "${file}". Run \`warlock build\` successfully, then run \`warlock routes:diff\` again.`);
+	}
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed !== "object" || parsed === null || parsed.version !== 1 || !Array.isArray(parsed.routes) || !parsed.routes.every((route) => typeof route === "object" && route !== null && route.method === "GET" && typeof route.path === "string" && typeof route.name === "string" && typeof route.source === "string")) throw new Error("invalid shape");
+		return parsed;
+	} catch {
+		throw new Error(`Cannot compare page routes: build snapshot "${file}" is malformed. Run \`warlock build\` successfully to replace it, then retry.`);
+	}
+}
+function printRoute(prefix, route) {
+	const source = route.source ? ` (${route.source})` : "";
+	console.log(`${prefix} GET ${route.path}  ${route.name}${source}`);
+}
+/**
+* Compare the last successful production page surface with the live dev
+* surface.
+*
+* The comparison itself lives in `diff-page-routes.ts`, which also documents
+* why the route-name method suffix is the one registration-time difference the
+* build-time manifest cannot record — and therefore what a clean run of this
+* command does not prove.
+*/
+async function routesDiffCommandAction() {
+	const snapshot = readSnapshot(snapshotPath());
+	const context = await bootForDiagnostics();
+	if (!context.booted || context.moduleFailures.length > 0 || context.connectors.failures.length > 0 || context.connectors.registrationError !== void 0) {
+		const details = [
+			...context.moduleFailures.map(({ file, message }) => `${file}: ${message}`),
+			...context.connectors.failures.map(({ name, message }) => `${name}: ${message}`),
+			...context.connectors.registrationError ? [context.connectors.registrationError] : []
+		];
+		throw new Error(`Cannot compare page routes because diagnostic boot failed.${details.length ? `\n${details.join("\n")}` : ""}`);
+	}
+	const live = router.list().filter((route) => route.isPage).map(routeFromLive).sort(comparePageRoutes);
+	const expected = [...snapshot.routes].sort(comparePageRoutes);
+	const { changes, removed, added } = diffPageRoutes(expected, live);
+	if (changes.length === 0 && removed.length === 0 && added.length === 0) {
+		console.log(`Page routes match (${expected.length} routes).`);
+		console.log(CLEAN_RUN_LIMIT);
+		return;
+	}
+	for (const { before, after } of changes) {
+		printRoute("changed -", before);
+		printRoute("        +", after);
+	}
+	for (const route of removed) printRoute("removed -", route);
+	for (const route of added) printRoute("added   +", route);
+	throw new Error(`Page route drift: ${changes.length} changed, ${removed.length} removed, ${added.length} added. Run \`warlock build\` after reviewing these changes.`);
+}
+
+//#endregion
+export { routesDiffCommandAction };
+//# sourceMappingURL=routes-diff.action.mjs.map

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

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

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

@@ -1,7 +1,8 @@
 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 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`,
@@ -45,7 +46,20 @@ const routesCommand = command({
 		}
 	]
 });
+/** Compare live development page routes with the last successful build. */
+const routesDiffCommand = command({
+	name: "routes:diff",
+	description: "Compare live page routes with the last successful production build",
+	action: routesDiffCommandAction,
+	preload: {
+		runtimeStrategy: "development",
+		warlockConfig: true,
+		config: true,
+		env: true,
+		bootstrap: true
+	}
+});
 
 //#endregion
-export { routesCommand };
+export { routesCommand, routesDiffCommand };
 //# sourceMappingURL=routes.command.mjs.map

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\";\r\nimport { routesCommandAction } from \"./routes/routes-command.action\";\r\n\r\n/**\r\n * `warlock routes` — list every registered HTTP route as a table (a read-only\r\n * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,\r\n * or emit the normalized rows as JSON with `--json`.\r\n *\r\n * Preload plan: load config + bootstrap app code so route modules register on\r\n * the router singleton, but start NO connectors — listing routes must never\r\n * open a database/cache/socket connection. Because the route-module loader is\r\n * fail-loud, a route file that throws on import surfaces here instead of being\r\n * silently omitted from the table.\r\n */\r\nexport const routesCommand = command({\r\n  name: \"routes\",\r\n  description:\r\n    \"List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json\",\r\n  action: routesCommandAction,\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--method, -m\",\r\n      description: \"Filter by HTTP method (case-insensitive, e.g. GET, POST)\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--path, -p\",\r\n      description: \"Filter by a case-insensitive path substring\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--name, -n\",\r\n      description: \"Filter by a case-insensitive route-name substring\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--json, -j\",\r\n      description: \"Output the routes as JSON instead of a table\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\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"}
+{"version":3,"file":"routes.command.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/routes.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\r\nimport { routesCommandAction } from \"./routes/routes-command.action\";\nimport { routesDiffCommandAction } from \"./routes/routes-diff.action\";\n\r\n/**\r\n * `warlock routes` — list every registered HTTP route as a table (a read-only\r\n * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,\r\n * or emit the normalized rows as JSON with `--json`.\r\n *\r\n * Preload plan: load config + bootstrap app code so route modules register on\r\n * the router singleton, but start NO connectors — listing routes must never\r\n * open a database/cache/socket connection. Because the route-module loader is\r\n * fail-loud, a route file that throws on import surfaces here instead of being\r\n * silently omitted from the table.\r\n */\r\nexport const routesCommand = command({\n  name: \"routes\",\r\n  description:\r\n    \"List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json\",\r\n  action: routesCommandAction,\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--method, -m\",\r\n      description: \"Filter by HTTP method (case-insensitive, e.g. GET, POST)\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--path, -p\",\r\n      description: \"Filter by a case-insensitive path substring\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--name, -n\",\r\n      description: \"Filter by a case-insensitive route-name substring\",\r\n      type: \"string\",\r\n    },\r\n    {\r\n      text: \"--json, -j\",\r\n      description: \"Output the routes as JSON instead of a table\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\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":";;;;;;;;;;;;;;;;AAeA,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 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\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const seedCommand = command({\r\n  action: seedCommandAction,\r\n  name: \"seed\",\r\n  description: \"Run database seeds\",\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\r\n    connectors: [\"database\", \"cache\", \"logger\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Drop all tables records and run seeds\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--list, -l\",\r\n      description: \"Display the seeds list in order without execution\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--transaction, -t\",\r\n      description: \"Run seeds in a transaction\",\r\n      type: \"boolean\",\r\n      defaultValue: true,\r\n    },\r\n    {\r\n      text: \"--drop, -d\",\r\n      description:\r\n        'Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"',\r\n      type: \"string\",\r\n    },\r\n  ],\r\n});\r\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;EAAQ;CAC5C;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":["C:/Work/Warlock.js/core/src/cli/commands/seed.command.ts"],"sourcesContent":["import { seedCommandAction } from \"../../database/seed-command-action\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const seedCommand = command({\r\n  action: seedCommandAction,\r\n  name: \"seed\",\r\n  description: \"Run database seeds\",\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\r\n    connectors: [\"database\", \"cache\", \"logger\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Drop all tables records and run seeds\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--list, -l\",\r\n      description: \"Display the seeds list in order without execution\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--transaction, -t\",\r\n      description: \"Run seeds in a transaction\",\r\n      type: \"boolean\",\r\n      defaultValue: true,\r\n    },\r\n    {\r\n      text: \"--drop, -d\",\r\n      description:\r\n        'Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"',\r\n      type: \"string\",\r\n    },\r\n  ],\r\n});\r\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;EAAQ;CAC5C;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

@@ -1,15 +1,22 @@
 import { command } from "../../commands/cli-command.mjs";
 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 core/src/cli/commands/start-production.command.ts
 const startProductionCommand = command({
 	name: "start",
 	description: "Start production server",
 	persistent: true,
 	preload: { warlockConfig: true },
 	action: async () => {
-		const { entryPath, sourcemap } = resolveBuildConfig();
+		const { entryPath, sourcemap, outdir } = resolveBuildConfig();
+		const readiness = await checkDistReadyToStartAsync(outdir);
+		if (!readiness.ready) {
+			console.error(`✖ ${readiness.reason}`);
+			process.exit(1);
+			return;
+		}
 		const nodeArgs = [];
 		if (sourcemap !== false) nodeArgs.push("--enable-source-maps");
 		nodeArgs.push(entryPath);

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 { superviseProductionProcess } from \"../../production/production-supervisor\";\r\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const startProductionCommand = command({\r\n  name: \"start\",\r\n  description: \"Start production server\",\r\n  persistent: true,\r\n  preload: {\r\n    warlockConfig: true,\r\n  },\r\n  action: async () => {\r\n    const { entryPath, sourcemap } = resolveBuildConfig();\r\n\r\n    // Build node args\r\n    const nodeArgs: string[] = [];\r\n\r\n    // Enable source maps if configured\r\n    if (sourcemap !== false) {\r\n      nodeArgs.push(\"--enable-source-maps\");\r\n    }\r\n\r\n    // Add entry file\r\n    nodeArgs.push(entryPath);\r\n\r\n    // Pass through any additional flags after \"start\" command\r\n    // process.argv = [node, cli.ts, start, ...extra]\r\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\r\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\r\n      const extraArgs = process.argv.slice(startIndex + 1);\r\n      nodeArgs.push(...extraArgs);\r\n    }\r\n\r\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\r\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\r\n    // outcome. The banner that used to print here, in `preAction`, printed\r\n    // before the child had even been spawned.\r\n    console.error(`🚀 Starting production server...\\n`);\r\n\r\n    const { exitCode } = await superviseProductionProcess({ nodeArgs });\r\n\r\n    process.exit(exitCode);\r\n  },\r\n});\r\n"],"mappings":";;;;;AAIA,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,YAAY;EAClB,MAAM,EAAE,WAAW,cAAc,mBAAmB;EAGpD,MAAM,WAAqB,CAAC;EAG5B,IAAI,cAAc,OAChB,SAAS,KAAK,sBAAsB;EAItC,SAAS,KAAK,SAAS;EAIvB,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,YAAY,QAAQ,KAAK,MAAM,aAAa,CAAC;GACnD,SAAS,KAAK,GAAG,SAAS;EAC5B;EAMA,QAAQ,MAAM,oCAAoC;EAElD,MAAM,EAAE,aAAa,MAAM,2BAA2B,EAAE,SAAS,CAAC;EAElE,QAAQ,KAAK,QAAQ;CACvB;AACF,CAAC"}
+{"version":3,"file":"start-production.command.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/start-production.command.ts"],"sourcesContent":["import { checkDistReadyToStartAsync } from \"../../production/assert-dist-ready-to-start\";\r\nimport { superviseProductionProcess } from \"../../production/production-supervisor\";\r\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const startProductionCommand = command({\r\n  name: \"start\",\r\n  description: \"Start production server\",\r\n  persistent: true,\r\n  preload: {\r\n    warlockConfig: true,\r\n  },\r\n  action: async () => {\r\n    const { entryPath, sourcemap, outdir } = resolveBuildConfig();\r\n\r\n    // Refuse a `dist` that did not come from a successful `warlock build` —\r\n    // named explicitly, rather than failing later and incidentally because\r\n    // some file the server happens to need (the client manifest, say) is\r\n    // missing. See `assert-dist-ready-to-start.ts`.\r\n    const readiness = await checkDistReadyToStartAsync(outdir);\r\n\r\n    if (!readiness.ready) {\r\n      console.error(`✖ ${readiness.reason}`);\r\n      process.exit(1);\r\n      return;\r\n    }\r\n\r\n    // Build node args\r\n    const nodeArgs: string[] = [];\r\n\r\n    // Enable source maps if configured\r\n    if (sourcemap !== false) {\r\n      nodeArgs.push(\"--enable-source-maps\");\r\n    }\r\n\r\n    // Add entry file\r\n    nodeArgs.push(entryPath);\r\n\r\n    // Pass through any additional flags after \"start\" command\r\n    // process.argv = [node, cli.ts, start, ...extra]\r\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\r\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\r\n      const extraArgs = process.argv.slice(startIndex + 1);\r\n      nodeArgs.push(...extraArgs);\r\n    }\r\n\r\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\r\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\r\n    // outcome. The banner that used to print here, in `preAction`, printed\r\n    // before the child had even been spawned.\r\n    console.error(`🚀 Starting production server...\\n`);\r\n\r\n    const { exitCode } = await superviseProductionProcess({ nodeArgs });\r\n\r\n    process.exit(exitCode);\r\n  },\r\n});\r\n"],"mappings":";;;;;;AAKA,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,YAAY;EAClB,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;EAItC,SAAS,KAAK,SAAS;EAIvB,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,YAAY,QAAQ,KAAK,MAAM,aAAa,CAAC;GACnD,SAAS,KAAK,GAAG,SAAS;EAC5B;EAMA,QAAQ,MAAM,oCAAoC;EAElD,MAAM,EAAE,aAAa,MAAM,2BAA2B,EAAE,SAAS,CAAC;EAElE,QAAQ,KAAK,QAAQ;CACvB;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 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\";\r\nimport path from \"path\";\r\nimport { config } from \"../../config\";\r\nimport { storage } from \"../../storage\";\r\nimport type { CommandActionData } from \"../../commands/types\";\r\n\r\n/**\r\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\r\n *\r\n * Uploads a local file or directory into any configured storage driver.\r\n * Auto-detects whether <localPath> is a file or directory and calls the\r\n * appropriate storage method.\r\n *\r\n * @example\r\n * # Upload entire uploads directory to R2 (root of bucket)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload to a specific destination prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload with custom concurrency\r\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\r\n */\r\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\r\n  const [localPath, destination = \"\"] = args;\r\n\r\n  if (!localPath) {\r\n    console.error(\"✖  Missing required argument: <localPath>\");\r\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\r\n    process.exit(1);\r\n  }\r\n\r\n  // Resolve to absolute path relative to CWD\r\n  const absolutePath = path.resolve(process.cwd(), localPath);\r\n  const driverName = options.driver as string | undefined;\r\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\r\n\r\n  // Verify the local path exists\r\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\r\n  try {\r\n    stat = await fs.stat(absolutePath);\r\n  } catch {\r\n    console.error(`✖  Path not found: ${absolutePath}`);\r\n    process.exit(1);\r\n  }\r\n\r\n  // Select the driver — use named driver or fall back to default\r\n  const store = driverName ? storage.use(driverName) : storage;\r\n  const driverLabel = driverName ?? config.get(\"storage.default\");\r\n\r\n  console.log(`\\n  Driver    : ${driverLabel}`);\r\n  console.log(`  Source    : ${absolutePath}`);\r\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\r\n\r\n  if (stat.isDirectory()) {\r\n    // ── Directory upload ────────────────────────────────────────────────────\r\n    const result = await store.putDirectory(absolutePath, destination, {\r\n      concurrency,\r\n      // Skip hidden files (e.g. .DS_Store) by default\r\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\r\n      onProgress: (done, total, file) => {\r\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\r\n      },\r\n    });\r\n\r\n    // Clear the progress line and print summary\r\n    process.stdout.write(\"\\n\");\r\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\r\n\r\n    if (result.failed.length > 0) {\r\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\r\n      for (const { localPath: fp, error } of result.failed) {\r\n        console.warn(`     - ${fp}: ${error.message}`);\r\n      }\r\n    }\r\n  } else {\r\n    // ── Single file upload ──────────────────────────────────────────────────\r\n    // Destination is used as the storage path; if empty, fall back to filename\r\n    const storagePath = destination || path.basename(absolutePath);\r\n\r\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\r\n\r\n    const file = await store.put(absolutePath, storagePath);\r\n\r\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\r\n  }\r\n\r\n  console.log();\r\n}\r\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;EAEjD;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,IAAI,cAAc,WAAW;EAEtD,QAAQ,IAAI,oBAAoB,KAAK,KAAK;CAC5C;CAEA,QAAQ,IAAI;AACd"}
+{"version":3,"file":"storage-put.action.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/storage-put.action.ts"],"sourcesContent":["import fs from \"fs/promises\";\r\nimport path from \"path\";\r\nimport { config } from \"../../config\";\r\nimport { storage } from \"../../storage\";\r\nimport type { CommandActionData } from \"../../commands/types\";\r\n\r\n/**\r\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\r\n *\r\n * Uploads a local file or directory into any configured storage driver.\r\n * Auto-detects whether <localPath> is a file or directory and calls the\r\n * appropriate storage method.\r\n *\r\n * @example\r\n * # Upload entire uploads directory to R2 (root of bucket)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload to a specific destination prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload with custom concurrency\r\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\r\n */\r\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\r\n  const [localPath, destination = \"\"] = args;\r\n\r\n  if (!localPath) {\r\n    console.error(\"✖  Missing required argument: <localPath>\");\r\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\r\n    process.exit(1);\r\n  }\r\n\r\n  // Resolve to absolute path relative to CWD\r\n  const absolutePath = path.resolve(process.cwd(), localPath);\r\n  const driverName = options.driver as string | undefined;\r\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\r\n\r\n  // Verify the local path exists\r\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\r\n  try {\r\n    stat = await fs.stat(absolutePath);\r\n  } catch {\r\n    console.error(`✖  Path not found: ${absolutePath}`);\r\n    process.exit(1);\r\n  }\r\n\r\n  // Select the driver — use named driver or fall back to default\r\n  const store = driverName ? storage.use(driverName) : storage;\r\n  const driverLabel = driverName ?? config.get(\"storage.default\");\r\n\r\n  console.log(`\\n  Driver    : ${driverLabel}`);\r\n  console.log(`  Source    : ${absolutePath}`);\r\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\r\n\r\n  if (stat.isDirectory()) {\r\n    // ── Directory upload ────────────────────────────────────────────────────\r\n    const result = await store.putDirectory(absolutePath, destination, {\r\n      concurrency,\r\n      // Skip hidden files (e.g. .DS_Store) by default\r\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\r\n      onProgress: (done, total, file) => {\r\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\r\n      },\r\n    });\r\n\r\n    // Clear the progress line and print summary\r\n    process.stdout.write(\"\\n\");\r\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\r\n\r\n    if (result.failed.length > 0) {\r\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\r\n      for (const { localPath: fp, error } of result.failed) {\r\n        console.warn(`     - ${fp}: ${error.message}`);\r\n      }\r\n    }\r\n  } else {\r\n    // ── Single file upload ──────────────────────────────────────────────────\r\n    // Destination is used as the storage path; if empty, fall back to filename\r\n    const storagePath = destination || path.basename(absolutePath);\r\n\r\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\r\n\r\n    const file = await store.put(absolutePath, storagePath);\r\n\r\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\r\n  }\r\n\r\n  console.log();\r\n}\r\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,EAAE,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;EAEjD;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,IAAI,cAAc,WAAW;EAEtD,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 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\";\r\nimport { storagePutAction } from \"./storage-put.action\";\r\n\r\n/**\r\n * `storage.put` CLI command\r\n *\r\n * Uploads a local file or directory to any configured storage driver.\r\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\r\n *\r\n * @example\r\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload under a specific prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload to default driver\r\n * warlock storage.put ./public/logo.png assets/logo.png\r\n */\r\nexport const storagePutCommand = command({\r\n  name: \"storage.put <localPath> [destination]\",\r\n  alias: \"sput\",\r\n  action: storagePutAction,\r\n  description: \"Upload a local file or directory to storage\",\r\n  preload: {\r\n    env: true,\r\n    config: [\"storage\"],\r\n    connectors: [\"storage\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--driver, -d\",\r\n      description:\r\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\r\n    },\r\n    {\r\n      text: \"--concurrency, -c\",\r\n      description: \"Number of concurrent uploads when uploading a directory\",\r\n      type: \"number\",\r\n      defaultValue: 5,\r\n    },\r\n  ],\r\n});\r\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":["C:/Work/Warlock.js/core/src/cli/commands/storage-put.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\r\nimport { storagePutAction } from \"./storage-put.action\";\r\n\r\n/**\r\n * `storage.put` CLI command\r\n *\r\n * Uploads a local file or directory to any configured storage driver.\r\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\r\n *\r\n * @example\r\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload under a specific prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload to default driver\r\n * warlock storage.put ./public/logo.png assets/logo.png\r\n */\r\nexport const storagePutCommand = command({\r\n  name: \"storage.put <localPath> [destination]\",\r\n  alias: \"sput\",\r\n  action: storagePutAction,\r\n  description: \"Upload a local file or directory to storage\",\r\n  preload: {\r\n    env: true,\r\n    config: [\"storage\"],\r\n    connectors: [\"storage\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--driver, -d\",\r\n      description:\r\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\r\n    },\r\n    {\r\n      text: \"--concurrency, -c\",\r\n      description: \"Number of concurrent uploads when uploading a directory\",\r\n      type: \"number\",\r\n      defaultValue: 5,\r\n    },\r\n  ],\r\n});\r\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/typings-generator.command.mjs

@@ -6,7 +6,7 @@ import { getFilesFromDirectory } from "../../dev-server/utils.mjs";
 import { filesOrchestrator } from "../../dev-server/files-orchestrator.mjs";
 import { typeGenerator } from "../../dev-server/type-generator.mjs";
 
-//#region ../core/src/cli/commands/typings-generator.command.ts
+//#region core/src/cli/commands/typings-generator.command.ts
 const typingsGeneratorCommand = command({
 	name: "generate.typings",
 	description: "Generate type definitions for the project",

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

@@ -1 +1 @@
-{"version":3,"file":"typings-generator.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/typings-generator.command.ts"],"sourcesContent":["import { filesOrchestrator } from \"../../dev-server/files-orchestrator\";\r\nimport { Path } from \"../../utils/normalized-path\";\r\nimport { typeGenerator } from \"../../dev-server/type-generator\";\r\nimport { getFilesFromDirectory } from \"../../dev-server/utils\";\r\nimport { srcPath } from \"../../utils\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const typingsGeneratorCommand = command({\r\n  name: \"generate.typings\",\r\n  description: \"Generate type definitions for the project\",\r\n  options: [\r\n    {\r\n      text: \"--files, -f\",\r\n      description:\r\n        \"Files to generate typings for, if not passed, it will generate typings for all files\",\r\n    },\r\n  ],\r\n  action: async ({ options }) => {\r\n    const configFilesPaths: string[] = [];\r\n    if (options.files) {\r\n      const files = String(options.files)\r\n        .split(\",\")\r\n        .map((file) => {\r\n          if (file.startsWith(\"./\")) {\r\n            return Path.toAbsolute(file);\r\n          }\r\n\r\n          return file;\r\n        });\r\n\r\n      if (files?.length) {\r\n        configFilesPaths.push(...files);\r\n      }\r\n    }\r\n\r\n    if (configFilesPaths.length === 0) {\r\n      // grab all config files\r\n      const configFiles = await getFilesFromDirectory(srcPath(\"config\"));\r\n      configFilesPaths.push(...configFiles);\r\n    }\r\n\r\n    const results = await Promise.allSettled(\r\n      configFilesPaths.map((path) => filesOrchestrator.add(Path.toRelative(path))),\r\n    );\r\n\r\n    const failed = results.filter((r) => r.status === \"rejected\");\r\n\r\n    if (failed.length) {\r\n      console.warn(`Failed to process ${failed.length} files`);\r\n    }\r\n\r\n    await typeGenerator.generateAll();\r\n  },\r\n});\r\n"],"mappings":";;;;;;;;;AAOA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,CACF;CACA,QAAQ,OAAO,EAAE,cAAc;EAC7B,MAAM,mBAA6B,CAAC;EACpC,IAAI,QAAQ,OAAO;GACjB,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,MAAM,GAAG,CAAC,CACV,KAAK,SAAS;IACb,IAAI,KAAK,WAAW,IAAI,GACtB,OAAO,KAAK,WAAW,IAAI;IAG7B,OAAO;GACT,CAAC;GAEH,IAAI,OAAO,QACT,iBAAiB,KAAK,GAAG,KAAK;EAElC;EAEA,IAAI,iBAAiB,WAAW,GAAG;GAEjC,MAAM,cAAc,MAAM,sBAAsB,QAAQ,QAAQ,CAAC;GACjE,iBAAiB,KAAK,GAAG,WAAW;EACtC;EAMA,MAAM,UAAS,MAJO,QAAQ,WAC5B,iBAAiB,KAAK,SAAS,kBAAkB,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAC7E,EAEsB,CAAC,QAAQ,MAAM,EAAE,WAAW,UAAU;EAE5D,IAAI,OAAO,QACT,QAAQ,KAAK,qBAAqB,OAAO,OAAO,OAAO;EAGzD,MAAM,cAAc,YAAY;CAClC;AACF,CAAC"}
+{"version":3,"file":"typings-generator.command.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/typings-generator.command.ts"],"sourcesContent":["import { filesOrchestrator } from \"../../dev-server/files-orchestrator\";\r\nimport { Path } from \"../../utils/normalized-path\";\r\nimport { typeGenerator } from \"../../dev-server/type-generator\";\r\nimport { getFilesFromDirectory } from \"../../dev-server/utils\";\r\nimport { srcPath } from \"../../utils\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const typingsGeneratorCommand = command({\r\n  name: \"generate.typings\",\r\n  description: \"Generate type definitions for the project\",\r\n  options: [\r\n    {\r\n      text: \"--files, -f\",\r\n      description:\r\n        \"Files to generate typings for, if not passed, it will generate typings for all files\",\r\n    },\r\n  ],\r\n  action: async ({ options }) => {\r\n    const configFilesPaths: string[] = [];\r\n    if (options.files) {\r\n      const files = String(options.files)\r\n        .split(\",\")\r\n        .map((file) => {\r\n          if (file.startsWith(\"./\")) {\r\n            return Path.toAbsolute(file);\r\n          }\r\n\r\n          return file;\r\n        });\r\n\r\n      if (files?.length) {\r\n        configFilesPaths.push(...files);\r\n      }\r\n    }\r\n\r\n    if (configFilesPaths.length === 0) {\r\n      // grab all config files\r\n      const configFiles = await getFilesFromDirectory(srcPath(\"config\"));\r\n      configFilesPaths.push(...configFiles);\r\n    }\r\n\r\n    const results = await Promise.allSettled(\r\n      configFilesPaths.map((path) => filesOrchestrator.add(Path.toRelative(path))),\r\n    );\r\n\r\n    const failed = results.filter((r) => r.status === \"rejected\");\r\n\r\n    if (failed.length) {\r\n      console.warn(`Failed to process ${failed.length} files`);\r\n    }\r\n\r\n    await typeGenerator.generateAll();\r\n  },\r\n});\r\n"],"mappings":";;;;;;;;;AAOA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,CACF;CACA,QAAQ,OAAO,EAAE,cAAc;EAC7B,MAAM,mBAA6B,CAAC;EACpC,IAAI,QAAQ,OAAO;GACjB,MAAM,QAAQ,OAAO,QAAQ,KAAK,EAC/B,MAAM,GAAG,EACT,KAAK,SAAS;IACb,IAAI,KAAK,WAAW,IAAI,GACtB,OAAO,KAAK,WAAW,IAAI;IAG7B,OAAO;GACT,CAAC;GAEH,IAAI,OAAO,QACT,iBAAiB,KAAK,GAAG,KAAK;EAElC;EAEA,IAAI,iBAAiB,WAAW,GAAG;GAEjC,MAAM,cAAc,MAAM,sBAAsB,QAAQ,QAAQ,CAAC;GACjE,iBAAiB,KAAK,GAAG,WAAW;EACtC;EAMA,MAAM,UAAS,MAJO,QAAQ,WAC5B,iBAAiB,KAAK,SAAS,kBAAkB,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAC7E,GAEuB,QAAQ,MAAM,EAAE,WAAW,UAAU;EAE5D,IAAI,OAAO,QACT,QAAQ,KAAK,qBAAqB,OAAO,OAAO,OAAO;EAGzD,MAAM,cAAc,YAAY;CAClC;AACF,CAAC"}

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

@@ -2,7 +2,7 @@ import { command } from "../../commands/cli-command.mjs";
 import { updateWarlockPackages } from "../../updater/update-warlock-packages.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/cli/commands/update.command.ts
+//#region core/src/cli/commands/update.command.ts
 const updateCommand = command({
 	name: "update",
 	description: "Update all @warlock.js packages in this project to their latest version",

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

@@ -1 +1 @@
-{"version":3,"file":"update.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/update.command.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { updateWarlockPackages } from \"../../updater/update-warlock-packages\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const updateCommand = command({\r\n  name: \"update\",\r\n  description: \"Update all @warlock.js packages in this project to their latest version\",\r\n  action: async (data) => {\r\n    // `parseCliArgs` camelCases every flag, so `--no-install` arrives as\r\n    // `options.noInstall` (not `options[\"no-install\"]`).\r\n    const check = Boolean(data.options.check);\r\n    const dryRun = check || Boolean(data.options.dryRun);\r\n\r\n    const result = await updateWarlockPackages({\r\n      install: !data.options.noInstall,\r\n      dryRun,\r\n    });\r\n\r\n    // `updateWarlockPackages` resolves on a failed install so the dev-server\r\n    // shortcut can survive it; a one-shot CLI run must still exit non-zero.\r\n    if (result.outcome === \"install-failed\") {\r\n      throw result.error ?? new Error(\"Package manager install failed.\");\r\n    }\r\n\r\n    // `--check` is a gate, so its exit code carries the answer: 0 current,\r\n    // 1 behind. `--dry-run` only reports, and always succeeds.\r\n    if (check && result.outcome === \"outdated\") {\r\n      console.log(\r\n        colors.dim(\"Run \") +\r\n          colors.cyan(\"warlock update\") +\r\n          colors.dim(\" to apply these, or --dry-run to preview without a gate.\"),\r\n      );\r\n      process.exit(1);\r\n    }\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--no-install\",\r\n      description:\r\n        \"Rewrite the @warlock.js versions in package.json without running the package manager install\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--dry-run\",\r\n      description: \"Show which packages would be updated without changing package.json\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--check\",\r\n      description:\r\n        \"Like --dry-run, but exits 1 when any package is behind — a CI gate for staying current\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,OAAO,SAAS;EAGtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,QAAQ,KAAK,QAAQ,MAAM;EAEnD,MAAM,SAAS,MAAM,sBAAsB;GACzC,SAAS,CAAC,KAAK,QAAQ;GACvB;EACF,CAAC;EAID,IAAI,OAAO,YAAY,kBACrB,MAAM,OAAO,yBAAS,IAAI,MAAM,iCAAiC;EAKnE,IAAI,SAAS,OAAO,YAAY,YAAY;GAC1C,QAAQ,IACN,OAAO,IAAI,MAAM,IACf,OAAO,KAAK,gBAAgB,IAC5B,OAAO,IAAI,0DAA0D,CACzE;GACA,QAAQ,KAAK,CAAC;EAChB;CACF;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"update.command.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands/update.command.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { updateWarlockPackages } from \"../../updater/update-warlock-packages\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const updateCommand = command({\r\n  name: \"update\",\r\n  description: \"Update all @warlock.js packages in this project to their latest version\",\r\n  action: async (data) => {\r\n    // `parseCliArgs` camelCases every flag, so `--no-install` arrives as\r\n    // `options.noInstall` (not `options[\"no-install\"]`).\r\n    const check = Boolean(data.options.check);\r\n    const dryRun = check || Boolean(data.options.dryRun);\r\n\r\n    const result = await updateWarlockPackages({\r\n      install: !data.options.noInstall,\r\n      dryRun,\r\n    });\r\n\r\n    // `updateWarlockPackages` resolves on a failed install so the dev-server\r\n    // shortcut can survive it; a one-shot CLI run must still exit non-zero.\r\n    if (result.outcome === \"install-failed\") {\r\n      throw result.error ?? new Error(\"Package manager install failed.\");\r\n    }\r\n\r\n    // `--check` is a gate, so its exit code carries the answer: 0 current,\r\n    // 1 behind. `--dry-run` only reports, and always succeeds.\r\n    if (check && result.outcome === \"outdated\") {\r\n      console.log(\r\n        colors.dim(\"Run \") +\r\n          colors.cyan(\"warlock update\") +\r\n          colors.dim(\" to apply these, or --dry-run to preview without a gate.\"),\r\n      );\r\n      process.exit(1);\r\n    }\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--no-install\",\r\n      description:\r\n        \"Rewrite the @warlock.js versions in package.json without running the package manager install\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--dry-run\",\r\n      description: \"Show which packages would be updated without changing package.json\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--check\",\r\n      description:\r\n        \"Like --dry-run, but exits 1 when any package is behind — a CI gate for staying current\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,OAAO,SAAS;EAGtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,QAAQ,KAAK,QAAQ,MAAM;EAEnD,MAAM,SAAS,MAAM,sBAAsB;GACzC,SAAS,CAAC,KAAK,QAAQ;GACvB;EACF,CAAC;EAID,IAAI,OAAO,YAAY,kBACrB,MAAM,OAAO,yBAAS,IAAI,MAAM,iCAAiC;EAKnE,IAAI,SAAS,OAAO,YAAY,YAAY;GAC1C,QAAQ,IACN,OAAO,IAAI,MAAM,IACf,OAAO,KAAK,gBAAgB,IAC5B,OAAO,IAAI,0DAA0D,CACzE;GACA,QAAQ,KAAK,CAAC;EAChB;CACF;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands-loader.mjs

@@ -5,7 +5,7 @@ import { getFilesFromDirectory } from "../dev-server/utils.mjs";
 import { filesOrchestrator } from "../dev-server/files-orchestrator.mjs";
 import { isMatchingCommandName } from "./cli-commands.utils.mjs";
 
-//#region ../core/src/cli/commands-loader.ts
+//#region core/src/cli/commands-loader.ts
 var CLICommandsLoader = class {
 	/**
 	* Locate command by name

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

@@ -1 +1 @@
-{"version":3,"file":"commands-loader.mjs","names":[],"sources":["../../../../../../../core/src/cli/commands-loader.ts"],"sourcesContent":["import { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport { CLICommand } from \"../commands/cli-command\";\r\nimport { isMatchingCommandName } from \"./cli-commands.utils\";\r\n\r\nexport class CLICommandsLoader {\r\n  /**\r\n   * Locate command by name\r\n   */\r\n  public async locate(commandName: string): Promise<CLICommand | undefined> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    // now convert them into relative paths\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        if (isMatchingCommandName(command.name, commandName)) {\r\n          return command;\r\n        }\r\n      }\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  /**\r\n   * Scan all project commands and return them\r\n   * Used for warm cache functionality\r\n   */\r\n  public async scanAll(): Promise<CLICommand[]> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n    const commands: CLICommand[] = [];\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        commands.push(command);\r\n      }\r\n    }\r\n\r\n    return commands;\r\n  }\r\n\r\n  /**\r\n   * Load command from a relative path\r\n   */\r\n  public async load(relativePath: string): Promise<CLICommand | undefined> {\r\n    const output = await filesOrchestrator.load<{ default: CLICommand }>(relativePath);\r\n\r\n    return output?.default;\r\n  }\r\n}\r\n\r\nexport const cliCommandsLoader = new CLICommandsLoader();\r\n"],"mappings":";;;;;;;;AAOA,IAAa,oBAAb,MAA+B;;;;CAI7B,MAAa,OAAO,aAAsD;EAGxE,MAAM,iBAAgB,MAFF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EAEvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAE/D,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,IAAI,sBAAsB,QAAQ,MAAM,WAAW,GACjD,OAAO;GAEX;EACF;CAGF;;;;;CAMA,MAAa,UAAiC;EAE5C,MAAM,iBAAgB,MADF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EACvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAC/D,MAAM,WAAyB,CAAC;EAEhC,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,SAAS,KAAK,OAAO;GACvB;EACF;EAEA,OAAO;CACT;;;;CAKA,MAAa,KAAK,cAAuD;EAGvE,QAAO,MAFc,kBAAkB,KAA8B,YAAY,EAEpE,EAAE;CACjB;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}
+{"version":3,"file":"commands-loader.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/cli/commands-loader.ts"],"sourcesContent":["import { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport { CLICommand } from \"../commands/cli-command\";\r\nimport { isMatchingCommandName } from \"./cli-commands.utils\";\r\n\r\nexport class CLICommandsLoader {\r\n  /**\r\n   * Locate command by name\r\n   */\r\n  public async locate(commandName: string): Promise<CLICommand | undefined> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    // now convert them into relative paths\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        if (isMatchingCommandName(command.name, commandName)) {\r\n          return command;\r\n        }\r\n      }\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  /**\r\n   * Scan all project commands and return them\r\n   * Used for warm cache functionality\r\n   */\r\n  public async scanAll(): Promise<CLICommand[]> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n    const commands: CLICommand[] = [];\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        commands.push(command);\r\n      }\r\n    }\r\n\r\n    return commands;\r\n  }\r\n\r\n  /**\r\n   * Load command from a relative path\r\n   */\r\n  public async load(relativePath: string): Promise<CLICommand | undefined> {\r\n    const output = await filesOrchestrator.load<{ default: CLICommand }>(relativePath);\r\n\r\n    return output?.default;\r\n  }\r\n}\r\n\r\nexport const cliCommandsLoader = new CLICommandsLoader();\r\n"],"mappings":";;;;;;;;AAOA,IAAa,oBAAb,MAA+B;;;;CAI7B,MAAa,OAAO,aAAsD;EAGxE,MAAM,iBAAgB,MAFF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,GAEtD,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAE/D,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,IAAI,sBAAsB,QAAQ,MAAM,WAAW,GACjD,OAAO;GAEX;EACF;CAGF;;;;;CAMA,MAAa,UAAiC;EAE5C,MAAM,iBAAgB,MADF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,GACtD,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAC/D,MAAM,WAAyB,CAAC;EAEhC,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,SAAS,KAAK,OAAO;GACvB;EACF;EAEA,OAAO;CACT;;;;CAKA,MAAa,KAAK,cAAuD;EAGvE,QAAO,MAFc,kBAAkB,KAA8B,YAAY,IAElE;CACjB;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}

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

@@ -6,19 +6,20 @@ import { doctorCommand } from "./commands/doctor.command.mjs";
 import { dropTablesCommand } from "./commands/drop-tables.command.mjs";
 import { generateCommand, generateControllerCommand, generateMigrationCommand, generateModelCommand, generateModuleCommand, generateRepositoryCommand, generateResourceCommand, generateServiceCommand } from "./commands/generate/generate.command.mjs";
 import { migrateCommand } from "./commands/migrate.command.mjs";
-import { routesCommand } from "./commands/routes.command.mjs";
+import { routesCommand, routesDiffCommand } from "./commands/routes.command.mjs";
 import { seedCommand } from "./commands/seed.command.mjs";
 import { startProductionCommand } from "./commands/start-production.command.mjs";
 import { storagePutCommand } from "./commands/storage-put.command.mjs";
 import { typingsGeneratorCommand } from "./commands/typings-generator.command.mjs";
 import { updateCommand } from "./commands/update.command.mjs";
 
-//#region ../core/src/cli/framework-cli-commands.ts
+//#region core/src/cli/framework-cli-commands.ts
 const frameworkCommands = [
 	devServerCommand,
 	typingsGeneratorCommand,
 	doctorCommand,
 	routesCommand,
+	routesDiffCommand,
 	buildCommand,
 	startProductionCommand,
 	migrateCommand,