@warlock.js/core 5.0.1 → 5.1.0

package/esm/cli/commands/doctor/checks/routes.check.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routes.check.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/doctor/checks/routes.check.ts"],"sourcesContent":["import { router } from \"../../../../router/router\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Reports the number of registered routes. A booted app with zero routes\n * almost always means a route module failed to register silently, so this\n * warns (rather than passing) when the route table is empty.\n *\n * Read-only: introspects the router via `routeCount()` only.\n */\nexport const routesCheck: DoctorCheck = {\n  name: \"routes\",\n  run: () => {\n    const count = router.routeCount();\n\n    if (count === 0) {\n      return {\n        name: \"routes\",\n        status: \"warn\",\n        detail: \"0 routes registered — did a route module fail to load?\",\n      };\n    }\n\n    return {\n      name: \"routes\",\n      status: \"ok\",\n      detail: `${count} registered`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,QAAQ,OAAO,WAAW;EAEhC,IAAI,UAAU,GACZ,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,GAAG,MAAM;EACnB;CACF;AACF"}
+{"version":3,"file":"routes.check.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/doctor/checks/routes.check.ts"],"sourcesContent":["import type { DoctorBootContext, DoctorCheck } from \"../check.types\";\n\n/**\n * Describe the failed modules as an indented block, one per line, cause first.\n * The file that failed is the only thing that makes this actionable, so it is\n * never summarised away.\n */\nfunction describeFailures(context: DoctorBootContext): string {\n  return context.moduleFailures\n    .map((failure) => `  - ${failure.file}: ${failure.message}`)\n    .join(\"\\n\");\n}\n\n/**\n * Reports the route surface the app will actually serve.\n *\n * NEEDS A BOOTED APP — and now gets one. Routes exist only as the side effect of\n * importing the module that declares them, so a doctor that did not import app\n * code reported `0 routes` for an app the dev server served fourteen routes\n * for. The boot pass imports the same modules, in the same order, and boots\n * (never starts) the same connectors, so the number printed here is the number\n * `warlock dev` prints for the same project — the two are read off the same\n * router after the same registrations.\n *\n * Verdicts:\n * - a module failed to import → `fail`, naming every file and its cause. This\n *   is the finding doctor exists for: a route file that throws on import is\n *   invisible at runtime, it just 404s;\n * - route modules on disk but nothing registered → `fail` (they loaded and\n *   registered nothing, which is not a state a working app is in);\n * - no route modules at all → `ok`, stated plainly. A worker or CLI-only app is\n *   a legitimate shape and must not be nagged;\n * - otherwise → `ok` with the count, split into what app code registered and\n *   what connectors added.\n */\nexport const routesCheck: DoctorCheck = {\n  name: \"routes\",\n  run: (context) => {\n    if (context.moduleFailures.length > 0) {\n      const count = context.moduleFailures.length;\n\n      return {\n        name: \"routes\",\n        status: \"fail\",\n        detail:\n          `${count} app module(s) failed to load — the routes they declare will 404:\\n` +\n          describeFailures(context),\n      };\n    }\n\n    if (!context.booted) {\n      return {\n        name: \"routes\",\n        status: \"fail\",\n        detail: \"app modules could not be discovered — nothing to report on\",\n      };\n    }\n\n    if (context.totalRoutes === 0) {\n      if (context.routeModules === 0) {\n        return {\n          name: \"routes\",\n          status: \"ok\",\n          detail: \"no route modules found (src/app/*/routes.ts) — this app serves no HTTP routes\",\n        };\n      }\n\n      return {\n        name: \"routes\",\n        status: \"fail\",\n        detail:\n          `${context.routeModules} route module(s) loaded without error but registered 0 routes — ` +\n          \"every request will 404\",\n      };\n    }\n\n    const fromConnectors = context.totalRoutes - context.appRoutes;\n    const breakdown =\n      fromConnectors > 0\n        ? `${context.appRoutes} from ${context.routeModules} route module(s), ` +\n          `${fromConnectors} from connectors`\n        : `from ${context.routeModules} route module(s)`;\n\n    return {\n      name: \"routes\",\n      status: \"ok\",\n      detail: `${context.totalRoutes} registered (${breakdown})`,\n    };\n  },\n};\n"],"mappings":";;;;;;AAOA,SAAS,iBAAiB,SAAoC;CAC5D,OAAO,QAAQ,eACZ,KAAK,YAAY,OAAO,QAAQ,KAAK,IAAI,QAAQ,SAAS,CAAC,CAC3D,KAAK,IAAI;AACd;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,cAA2B;CACtC,MAAM;CACN,MAAM,YAAY;EAChB,IAAI,QAAQ,eAAe,SAAS,GAGlC,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QACE,GANU,QAAQ,eAAe,OAMxB,uEACT,iBAAiB,OAAO;EAC5B;EAGF,IAAI,CAAC,QAAQ,QACX,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAGF,IAAI,QAAQ,gBAAgB,GAAG;GAC7B,IAAI,QAAQ,iBAAiB,GAC3B,OAAO;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;GACV;GAGF,OAAO;IACL,MAAM;IACN,QAAQ;IACR,QACE,GAAG,QAAQ,aAAa;GAE5B;EACF;EAEA,MAAM,iBAAiB,QAAQ,cAAc,QAAQ;EACrD,MAAM,YACJ,iBAAiB,IACb,GAAG,QAAQ,UAAU,QAAQ,QAAQ,aAAa,oBAC/C,eAAe,oBAClB,QAAQ,QAAQ,aAAa;EAEnC,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,GAAG,QAAQ,YAAY,eAAe,UAAU;EAC1D;CACF;AACF"}

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

@@ -1,24 +1,34 @@
+import { bootForDiagnostics } from "./boot-for-diagnostics.mjs";
 import { defaultDoctorChecks } from "./checks/index.mjs";
 import { printReport } from "./format-report.mjs";
 import { runChecks } from "./run-checks.mjs";
 
 //#region ../core/src/cli/commands/doctor/doctor-command.action.ts
 /**
-* Action behind `warlock doctor`. Runs the default read-only diagnostic
-* checks, prints the grouped pass/warn/fail report, and — when any check
-* failed — exits the process with a non-zero code so the command signals
-* failure to scripts/CI.
+* Action behind `warlock doctor`.
+*
+* Two steps, in this order and for a reason: ONE boot pass, then every check
+* against what that pass observed. The checks never boot anything themselves,
+* so the report cannot contain two lines that inspected the app at different
+* moments and contradicted each other — which is exactly what it used to
+* contain (`routes: 0 registered` beside `health: /health + /ready
+* registered`, in the same run, on an app serving fourteen routes).
+*
+* The pass boots every connector and starts none, so no database, cache or
+* socket connection is opened and no port is bound. See
+* `boot-for-diagnostics.ts`.
 *
 * A failing check is REPORTED (a line in the report + a non-zero exit), never
 * thrown: the runner converts any thrown check into a `fail` result first.
 *
 * On success this simply returns; the CLI manager then prints its own success
-* banner and exits zero.
+* banner and exits zero — which also disposes of the handles the boot pass
+* left open (a Fastify instance, a Vite dev server for `web` apps).
 *
 * @param _data Parsed CLI args (unused — doctor takes no positional args).
 */
 async function doctorCommandAction(_data) {
-	const report = await runChecks(defaultDoctorChecks);
+	const report = await runChecks(defaultDoctorChecks, await bootForDiagnostics());
 	printReport(report);
 	if (report.hasFailures) process.exit(report.exitCode);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"doctor-command.action.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/doctor/doctor-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\r\nimport { defaultDoctorChecks } from \"./checks\";\r\nimport { printReport } from \"./format-report\";\r\nimport { runChecks } from \"./run-checks\";\r\n\r\n/**\r\n * Action behind `warlock doctor`. Runs the default read-only diagnostic\r\n * checks, prints the grouped pass/warn/fail report, and — when any check\r\n * failed — exits the process with a non-zero code so the command signals\r\n * failure to scripts/CI.\r\n *\r\n * A failing check is REPORTED (a line in the report + a non-zero exit), never\r\n * thrown: the runner converts any thrown check into a `fail` result first.\r\n *\r\n * On success this simply returns; the CLI manager then prints its own success\r\n * banner and exits zero.\r\n *\r\n * @param _data Parsed CLI args (unused — doctor takes no positional args).\r\n */\r\nexport async function doctorCommandAction(_data: CommandActionData): Promise<void> {\r\n  const report = await runChecks(defaultDoctorChecks);\r\n\r\n  printReport(report);\r\n\r\n  if (report.hasFailures) {\r\n    process.exit(report.exitCode);\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,oBAAoB,OAAyC;CACjF,MAAM,SAAS,MAAM,UAAU,mBAAmB;CAElD,YAAY,MAAM;CAElB,IAAI,OAAO,aACT,QAAQ,KAAK,OAAO,QAAQ;AAEhC"}
+{"version":3,"file":"doctor-command.action.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/doctor/doctor-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { bootForDiagnostics } from \"./boot-for-diagnostics\";\nimport { defaultDoctorChecks } from \"./checks\";\nimport { printReport } from \"./format-report\";\nimport { runChecks } from \"./run-checks\";\n\n/**\n * Action behind `warlock doctor`.\n *\n * Two steps, in this order and for a reason: ONE boot pass, then every check\n * against what that pass observed. The checks never boot anything themselves,\n * so the report cannot contain two lines that inspected the app at different\n * moments and contradicted each other — which is exactly what it used to\n * contain (`routes: 0 registered` beside `health: /health + /ready\n * registered`, in the same run, on an app serving fourteen routes).\n *\n * The pass boots every connector and starts none, so no database, cache or\n * socket connection is opened and no port is bound. See\n * `boot-for-diagnostics.ts`.\n *\n * A failing check is REPORTED (a line in the report + a non-zero exit), never\n * thrown: the runner converts any thrown check into a `fail` result first.\n *\n * On success this simply returns; the CLI manager then prints its own success\n * banner and exits zero — which also disposes of the handles the boot pass\n * left open (a Fastify instance, a Vite dev server for `web` apps).\n *\n * @param _data Parsed CLI args (unused — doctor takes no positional args).\n */\nexport async function doctorCommandAction(_data: CommandActionData): Promise<void> {\n  const context = await bootForDiagnostics();\n\n  const report = await runChecks(defaultDoctorChecks, context);\n\n  printReport(report);\n\n  if (report.hasFailures) {\n    process.exit(report.exitCode);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,eAAsB,oBAAoB,OAAyC;CAGjF,MAAM,SAAS,MAAM,UAAU,qBAAqB,MAF9B,mBAAmB,CAEkB;CAE3D,YAAY,MAAM;CAElB,IAAI,OAAO,aACT,QAAQ,KAAK,OAAO,QAAQ;AAEhC"}

package/esm/cli/commands/doctor/run-checks.mjs

@@ -4,10 +4,13 @@
 * `fail` carrying the error message, never re-thrown. This is what keeps
 * `doctor` itself crash-proof — a broken probe degrades to a failed check
 * instead of taking the whole command down.
+*
+* A check that returns `undefined` does not apply to this project; the caller
+* drops it from the report rather than printing a line about nothing.
 */
-async function runOne(check) {
+async function runOne(check, context) {
 	try {
-		return await check.run();
+		return await check.run(context);
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
 		return {
@@ -20,16 +23,22 @@ async function runOne(check) {
 /**
 * Run every check and aggregate the results into a {@link DoctorReport}.
 *
-* Checks run in registration order. Each is isolated via {@link runOne}, so one
-* throwing check cannot abort the others. The exit code is `1` if any check
+* Checks run in registration order against ONE shared boot context, so the
+* report can never contain two checks that disagree about the app because they
+* inspected it at different moments. Each is isolated via {@link runOne}, so
+* one throwing check cannot abort the others. The exit code is `1` if any check
 * resolved to `fail`, otherwise `0` — warnings never fail the command.
 *
 * @param checks The diagnostic probes to execute.
+* @param context What the boot pass observed.
 * @returns The aggregated report (results + per-status counts + exit code).
 */
-async function runChecks(checks) {
+async function runChecks(checks, context) {
 	const results = [];
-	for (const check of checks) results.push(await runOne(check));
+	for (const check of checks) {
+		const result = await runOne(check, context);
+		if (result) results.push(result);
+	}
 	const summary = {
 		ok: 0,
 		warn: 0,

package/esm/cli/commands/doctor/run-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-checks.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/doctor/run-checks.ts"],"sourcesContent":["import type { CheckResult, CheckStatus, DoctorCheck, DoctorReport } from \"./check.types\";\n\n/**\n * Run one check defensively: a check that throws (or rejects) is recorded as a\n * `fail` carrying the error message, never re-thrown. This is what keeps\n * `doctor` itself crash-proof — a broken probe degrades to a failed check\n * instead of taking the whole command down.\n */\nasync function runOne(check: DoctorCheck): Promise<CheckResult> {\n  try {\n    return await check.run();\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n\n    return {\n      name: check.name,\n      status: \"fail\",\n      detail: `check threw: ${message}`,\n    };\n  }\n}\n\n/**\n * Run every check and aggregate the results into a {@link DoctorReport}.\n *\n * Checks run in registration order. Each is isolated via {@link runOne}, so one\n * throwing check cannot abort the others. The exit code is `1` if any check\n * resolved to `fail`, otherwise `0` — warnings never fail the command.\n *\n * @param checks The diagnostic probes to execute.\n * @returns The aggregated report (results + per-status counts + exit code).\n */\nexport async function runChecks(checks: DoctorCheck[]): Promise<DoctorReport> {\n  const results: CheckResult[] = [];\n\n  for (const check of checks) {\n    results.push(await runOne(check));\n  }\n\n  const summary: Record<CheckStatus, number> = { ok: 0, warn: 0, fail: 0 };\n\n  for (const result of results) {\n    summary[result.status] += 1;\n  }\n\n  const hasFailures = summary.fail > 0;\n\n  return {\n    results,\n    summary,\n    hasFailures,\n    exitCode: hasFailures ? 1 : 0,\n  };\n}\n"],"mappings":";;;;;;;AAQA,eAAe,OAAO,OAA0C;CAC9D,IAAI;EACF,OAAO,MAAM,MAAM,IAAI;CACzB,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAErE,OAAO;GACL,MAAM,MAAM;GACZ,QAAQ;GACR,QAAQ,gBAAgB;EAC1B;CACF;AACF;;;;;;;;;;;AAYA,eAAsB,UAAU,QAA8C;CAC5E,MAAM,UAAyB,CAAC;CAEhC,KAAK,MAAM,SAAS,QAClB,QAAQ,KAAK,MAAM,OAAO,KAAK,CAAC;CAGlC,MAAM,UAAuC;EAAE,IAAI;EAAG,MAAM;EAAG,MAAM;CAAE;CAEvE,KAAK,MAAM,UAAU,SACnB,QAAQ,OAAO,WAAW;CAG5B,MAAM,cAAc,QAAQ,OAAO;CAEnC,OAAO;EACL;EACA;EACA;EACA,UAAU,cAAc,IAAI;CAC9B;AACF"}
+{"version":3,"file":"run-checks.mjs","names":[],"sources":["../../../../../../../../../core/src/cli/commands/doctor/run-checks.ts"],"sourcesContent":["import type {\n  CheckResult,\n  CheckStatus,\n  DoctorBootContext,\n  DoctorCheck,\n  DoctorReport,\n} from \"./check.types\";\n\n/**\n * Run one check defensively: a check that throws (or rejects) is recorded as a\n * `fail` carrying the error message, never re-thrown. This is what keeps\n * `doctor` itself crash-proof — a broken probe degrades to a failed check\n * instead of taking the whole command down.\n *\n * A check that returns `undefined` does not apply to this project; the caller\n * drops it from the report rather than printing a line about nothing.\n */\nasync function runOne(\n  check: DoctorCheck,\n  context: DoctorBootContext,\n): Promise<CheckResult | undefined> {\n  try {\n    return await check.run(context);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n\n    return {\n      name: check.name,\n      status: \"fail\",\n      detail: `check threw: ${message}`,\n    };\n  }\n}\n\n/**\n * Run every check and aggregate the results into a {@link DoctorReport}.\n *\n * Checks run in registration order against ONE shared boot context, so the\n * report can never contain two checks that disagree about the app because they\n * inspected it at different moments. Each is isolated via {@link runOne}, so\n * one throwing check cannot abort the others. The exit code is `1` if any check\n * resolved to `fail`, otherwise `0` — warnings never fail the command.\n *\n * @param checks The diagnostic probes to execute.\n * @param context What the boot pass observed.\n * @returns The aggregated report (results + per-status counts + exit code).\n */\nexport async function runChecks(\n  checks: DoctorCheck[],\n  context: DoctorBootContext,\n): Promise<DoctorReport> {\n  const results: CheckResult[] = [];\n\n  for (const check of checks) {\n    const result = await runOne(check, context);\n\n    // `undefined` is \"not applicable to this project\" — omitted entirely.\n    if (result) {\n      results.push(result);\n    }\n  }\n\n  const summary: Record<CheckStatus, number> = { ok: 0, warn: 0, fail: 0 };\n\n  for (const result of results) {\n    summary[result.status] += 1;\n  }\n\n  const hasFailures = summary.fail > 0;\n\n  return {\n    results,\n    summary,\n    hasFailures,\n    exitCode: hasFailures ? 1 : 0,\n  };\n}\n"],"mappings":";;;;;;;;;;AAiBA,eAAe,OACb,OACA,SACkC;CAClC,IAAI;EACF,OAAO,MAAM,MAAM,IAAI,OAAO;CAChC,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAErE,OAAO;GACL,MAAM,MAAM;GACZ,QAAQ;GACR,QAAQ,gBAAgB;EAC1B;CACF;AACF;;;;;;;;;;;;;;AAeA,eAAsB,UACpB,QACA,SACuB;CACvB,MAAM,UAAyB,CAAC;CAEhC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO;EAG1C,IAAI,QACF,QAAQ,KAAK,MAAM;CAEvB;CAEA,MAAM,UAAuC;EAAE,IAAI;EAAG,MAAM;EAAG,MAAM;CAAE;CAEvE,KAAK,MAAM,UAAU,SACnB,QAAQ,OAAO,WAAW;CAG5B,MAAM,cAAc,QAAQ,OAAO;CAEnC,OAAO;EACL;EACA;EACA;EACA,UAAU,cAAc,IAAI;CAC9B;AACF"}

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

@@ -3,21 +3,29 @@ import { doctorCommandAction } from "./doctor/doctor-command.action.mjs";
 
 //#region ../core/src/cli/commands/doctor.command.ts
 /**
-* `warlock doctor` — run a set of READ-ONLY diagnostic checks (routes, config,
-* connectors, optional peers, health endpoints, release hygiene) and print a
-* grouped pass/warn/fail report. Exits non-zero if any check fails.
+* `warlock doctor` — run a set of diagnostic checks against the real app and
+* print a grouped pass/warn/fail report. Exits non-zero if any check fails.
 *
-* Preload plan: load every config file and bootstrap app code so routes and
-* connectors are registered for introspection, but DELIBERATELY start no
-* connectors — doctor must not open database/cache/socket connections. The
-* connectors check therefore reports the registered set and which (if any) are
-* already active without forcing them up.
+* Preload plan: config + env + framework bootstrap, and NO connectors. The
+* `connectors` preloader would START them (open the database, dial the cache,
+* bind the port); doctor's own boot pass BOOTS them instead — the phase where
+* routes and endpoints register — which is what gives the checks a real app to
+* read without opening a single connection. See
+* `doctor/boot-for-diagnostics.ts` for that seam.
+*
+* `runtimeStrategy: "development"` is declared, not defaulted: connectors branch
+* on it (`web` serves pages from a manifest in production and from Vite in
+* development, `http` picks its router scan the same way), and a diagnostic
+* command that left the strategy unset would take the production branch by
+* accident — refusing to boot a perfectly healthy app because no build manifest
+* exists. Doctor reads a working tree, so it says so.
 */
 const doctorCommand = command({
 	name: "doctor",
-	description: "Run read-only health checks (routes, config, connectors, optional peers, health endpoints, release hygiene) and print a pass/warn/fail report",
+	description: "Boot the app read-only (no connections, no port) and report on its routes, config, connectors, drivers and health endpoints",
 	action: doctorCommandAction,
 	preload: {
+		runtimeStrategy: "development",
 		config: true,
 		env: true,
 		bootstrap: true

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/doctor.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\r\nimport { doctorCommandAction } from \"./doctor/doctor-command.action\";\r\n\r\n/**\r\n * `warlock doctor` — run a set of READ-ONLY diagnostic checks (routes, config,\r\n * connectors, optional peers, health endpoints, release hygiene) and print a\r\n * grouped pass/warn/fail report. Exits non-zero if any check fails.\r\n *\r\n * Preload plan: load every config file and bootstrap app code so routes and\r\n * connectors are registered for introspection, but DELIBERATELY start no\r\n * connectors — doctor must not open database/cache/socket connections. The\r\n * connectors check therefore reports the registered set and which (if any) are\r\n * already active without forcing them up.\r\n */\r\nexport const doctorCommand = command({\r\n  name: \"doctor\",\r\n  description:\r\n    \"Run read-only health checks (routes, config, connectors, optional peers, health endpoints, release hygiene) and print a pass/warn/fail report\",\r\n  action: doctorCommandAction,\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\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;AACF,CAAC"}
+{"version":3,"file":"doctor.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/doctor.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { doctorCommandAction } from \"./doctor/doctor-command.action\";\n\n/**\n * `warlock doctor` — run a set of diagnostic checks against the real app and\n * print a grouped pass/warn/fail report. Exits non-zero if any check fails.\n *\n * Preload plan: config + env + framework bootstrap, and NO connectors. The\n * `connectors` preloader would START them (open the database, dial the cache,\n * bind the port); doctor's own boot pass BOOTS them instead — the phase where\n * routes and endpoints register — which is what gives the checks a real app to\n * read without opening a single connection. See\n * `doctor/boot-for-diagnostics.ts` for that seam.\n *\n * `runtimeStrategy: \"development\"` is declared, not defaulted: connectors branch\n * on it (`web` serves pages from a manifest in production and from Vite in\n * development, `http` picks its router scan the same way), and a diagnostic\n * command that left the strategy unset would take the production branch by\n * accident — refusing to boot a perfectly healthy app because no build manifest\n * exists. Doctor reads a working tree, so it says so.\n */\nexport const doctorCommand = command({\n  name: \"doctor\",\n  description:\n    \"Boot the app read-only (no connections, no port) and report on its routes, config, connectors, drivers and health endpoints\",\n  action: doctorCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,KAAK;EACL,WAAW;CACb;AACF,CAAC"}

package/esm/connectors/describe-server-address.mjs

@@ -27,6 +27,21 @@
 * **loopback on a port nothing is listening on**, because someone will paste it
 * into a browser and conclude the server is broken. A non-loopback base URL is
 * a deployment address, reported plainly and never flagged.
+*
+* ## Why the address bound and the address printed are not the same string
+*
+* `listen()` resolves `localhost` and hands back whichever address it actually
+* bound — on a dual-stack machine that is `http://[::1]:2030`. That literal is
+* correct and useless: most terminals will not linkify a bracketed IPv6 host,
+* and on a first run it reads as broken output. So {@link toDisplayUrl} maps
+* the *loopback and wildcard* spellings onto `localhost`, which resolves back
+* to the very socket that was bound.
+*
+* This is a DISPLAY transform and nothing else — `host` still reaches
+* `listen()` untouched (`http-connector.ts`), so the set of interfaces the
+* server accepts on is byte-for-byte what it was. A genuine routable IPv6
+* address is left exactly as it is: there is no synonym for it, and inventing
+* one would be the same class of lie as printing `app.baseUrl` was.
 */
 /** Hosts that all mean "this machine" for the purpose of comparing addresses. */
 const LOOPBACK_HOSTS = new Set([
@@ -37,6 +52,60 @@ const LOOPBACK_HOSTS = new Set([
 	"0.0.0.0",
 	""
 ]);
+/**
+* Hosts for which `localhost` is a truthful, reachable synonym.
+*
+* The two loopback literals are exact synonyms. The two wildcards (`::`,
+* `0.0.0.0`) are not synonyms — they are strictly wider — but every one of them
+* *includes* loopback, so `localhost` always reaches the server. Callers that
+* need to tell the reader the bind is wider than loopback should say so
+* separately; see `dev-server/ready-block.ts`.
+*
+* The bracketed spellings are the ones that actually occur: WHATWG `hostname`
+* KEEPS the brackets for an IPv6 host (`new URL("http://[::1]:1").hostname ===
+* "[::1]"`). The bare forms are listed too so a caller that hands over a host
+* rather than a URL is not silently missed.
+*/
+const DISPLAY_AS_LOCALHOST = new Set([
+	"127.0.0.1",
+	"[::1]",
+	"::1",
+	"0.0.0.0",
+	"[::]",
+	"::"
+]);
+/** The wildcard spellings — a bind wider than loopback. */
+const WILDCARD_HOSTS = new Set([
+	"0.0.0.0",
+	"[::]",
+	"::"
+]);
+/**
+* Whether the given bound address listens on more than loopback.
+*
+* Used to add "(all interfaces)" next to a URL that has been rewritten to
+* `localhost`, so the rewrite never hides a wider bind than the reader thinks.
+*/
+function isWildcardBind(boundAddress) {
+	const url = parseUrl(boundAddress);
+	if (!url) return false;
+	return WILDCARD_HOSTS.has(url.hostname);
+}
+/**
+* The address as it should be SHOWN to a human. See the module doc above.
+*
+* Anything unparseable is returned untouched: a best-effort prettifier must
+* never be the reason a developer is shown something other than what the
+* server reported.
+*/
+function toDisplayUrl(boundAddress) {
+	if (!boundAddress) return "";
+	const url = parseUrl(boundAddress);
+	if (!url) return boundAddress;
+	if (!DISPLAY_AS_LOCALHOST.has(url.hostname)) return boundAddress;
+	url.hostname = "localhost";
+	return url.href.replace(/\/$/, "");
+}
 function parseUrl(value) {
 	if (typeof value !== "string" || value.length === 0) return void 0;
 	try {
@@ -56,16 +125,30 @@ function effectivePort(url) {
 function describeServerAddress(boundAddress, baseUrl) {
 	const bound = parseUrl(boundAddress);
 	const configured = parseUrl(baseUrl);
-	if (!bound) return { ready: `Server ready at ${configured?.href ?? boundAddress ?? baseUrl}` };
-	const ready = `Server ready at ${boundAddress}`;
-	if (!configured) return { ready };
+	if (!bound) {
+		const fallback = String(configured?.href ?? boundAddress ?? baseUrl ?? "");
+		return {
+			ready: `Server ready at ${fallback}`,
+			url: fallback,
+			boundAddress,
+			wildcardBind: false
+		};
+	}
+	const url = toDisplayUrl(boundAddress);
+	const base = {
+		ready: `Server ready at ${url}`,
+		url,
+		boundAddress,
+		wildcardBind: isWildcardBind(boundAddress)
+	};
+	if (!configured) return base;
 	if (!isLoopback(configured)) return {
-		ready,
+		...base,
 		publicUrl: `Public URL (app.baseUrl): ${baseUrl}`
 	};
-	if (effectivePort(configured) === effectivePort(bound)) return { ready };
+	if (effectivePort(configured) === effectivePort(bound)) return base;
 	return {
-		ready,
+		...base,
 		warning: `app.baseUrl is ${baseUrl}, but the server bound port ${effectivePort(bound)}. Nothing is listening on port ${effectivePort(configured)} — check BASE_URL and PORT, including anything exported in your shell.`
 	};
 }

package/esm/connectors/describe-server-address.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"describe-server-address.mjs","names":[],"sources":["../../../../../../../core/src/connectors/describe-server-address.ts"],"sourcesContent":["/**\n * What to say once the HTTP server has bound.\n *\n * ## Why this is not one template string\n *\n * `http-connector.ts` used to bind `httpConfig.port` and then announce\n * `config.get(\"app.baseUrl\")` — a different value, read from a different\n * environment variable (`PORT` vs `BASE_URL`), with nothing checking the two\n * agreed. On 2026-08-24 a server listening on 3000 printed\n * `Server ready at http://localhost:41900`. **Following the line the server\n * itself printed gave connection refused, on a server that was working.** The\n * reference app carried the rule as a comment in `.env` — \"must agree with the\n * port in BASE_URL above\" — and a rule a comment enforces is not enforced.\n *\n * So the ready line now states the address actually bound. `app.baseUrl` is a\n * separate claim, and it is reported separately.\n *\n * ## Why a disagreement is not fatal\n *\n * A reverse-proxied deployment legitimately binds `0.0.0.0:3000` and publishes\n * `https://example.com`. Refusing to boot on a mismatch would break the correct\n * case, and warning on it would fire on every correct production boot — a\n * warning that always fires is one nobody reads.\n *\n * The mismatch worth a warning is the ACTIONABLE one: a base URL that points at\n * **loopback on a port nothing is listening on**, because someone will paste it\n * into a browser and conclude the server is broken. A non-loopback base URL is\n * a deployment address, reported plainly and never flagged.\n */\n\n/** Hosts that all mean \"this machine\" for the purpose of comparing addresses. */\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"::1\", \"[::1]\", \"0.0.0.0\", \"\"]);\n\nexport type ServerAddressReport = {\n  /** Where the server is genuinely reachable. Always present. */\n  ready: string;\n  /** The configured public address, when it is a deployment URL rather than a local one. */\n  publicUrl?: string;\n  /** Set only when `app.baseUrl` points at loopback on a port nothing bound. */\n  warning?: string;\n};\n\nfunction parseUrl(value: unknown): URL | undefined {\n  if (typeof value !== \"string\" || value.length === 0) return undefined;\n\n  try {\n    return new URL(value);\n  } catch {\n    // An unparseable base URL is a separate problem, and it is NOT evidence of\n    // a port mismatch — reporting one from it would be a guess.\n    return undefined;\n  }\n}\n\nfunction isLoopback(url: URL): boolean {\n  return LOOPBACK_HOSTS.has(url.hostname);\n}\n\n/** `:3000` explicitly, or the protocol's default when the URL omits it. */\nfunction effectivePort(url: URL): string {\n  if (url.port) return url.port;\n\n  return url.protocol === \"https:\" ? \"443\" : \"80\";\n}\n\nexport function describeServerAddress(\n  boundAddress: string | undefined,\n  baseUrl: unknown,\n): ServerAddressReport {\n  const bound = parseUrl(boundAddress);\n  const configured = parseUrl(baseUrl);\n\n  // No bound address to report means the caller could not obtain one; the\n  // configured URL is then the only thing we know, and saying nothing would be\n  // worse than saying the one thing we have.\n  if (!bound) {\n    return { ready: `Server ready at ${configured?.href ?? boundAddress ?? baseUrl}` };\n  }\n\n  const ready = `Server ready at ${boundAddress}`;\n\n  if (!configured) return { ready };\n\n  if (!isLoopback(configured)) {\n    return { ready, publicUrl: `Public URL (app.baseUrl): ${baseUrl}` };\n  }\n\n  if (effectivePort(configured) === effectivePort(bound)) {\n    return { ready };\n  }\n\n  return {\n    ready,\n    warning:\n      `app.baseUrl is ${baseUrl}, but the server bound port ${effectivePort(bound)}. ` +\n      `Nothing is listening on port ${effectivePort(configured)} — ` +\n      `check BASE_URL and PORT, including anything exported in your shell.`,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAO;CAAS;CAAW;AAAE,CAAC;AAWxF,SAAS,SAAS,OAAiC;CACjD,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG,OAAO;CAE5D,IAAI;EACF,OAAO,IAAI,IAAI,KAAK;CACtB,QAAQ;EAGN;CACF;AACF;AAEA,SAAS,WAAW,KAAmB;CACrC,OAAO,eAAe,IAAI,IAAI,QAAQ;AACxC;;AAGA,SAAS,cAAc,KAAkB;CACvC,IAAI,IAAI,MAAM,OAAO,IAAI;CAEzB,OAAO,IAAI,aAAa,WAAW,QAAQ;AAC7C;AAEA,SAAgB,sBACd,cACA,SACqB;CACrB,MAAM,QAAQ,SAAS,YAAY;CACnC,MAAM,aAAa,SAAS,OAAO;CAKnC,IAAI,CAAC,OACH,OAAO,EAAE,OAAO,mBAAmB,YAAY,QAAQ,gBAAgB,UAAU;CAGnF,MAAM,QAAQ,mBAAmB;CAEjC,IAAI,CAAC,YAAY,OAAO,EAAE,MAAM;CAEhC,IAAI,CAAC,WAAW,UAAU,GACxB,OAAO;EAAE;EAAO,WAAW,6BAA6B;CAAU;CAGpE,IAAI,cAAc,UAAU,MAAM,cAAc,KAAK,GACnD,OAAO,EAAE,MAAM;CAGjB,OAAO;EACL;EACA,SACE,kBAAkB,QAAQ,8BAA8B,cAAc,KAAK,EAAE,iCAC7C,cAAc,UAAU,EAAE;CAE9D;AACF"}
+{"version":3,"file":"describe-server-address.mjs","names":[],"sources":["../../../../../../../core/src/connectors/describe-server-address.ts"],"sourcesContent":["/**\n * What to say once the HTTP server has bound.\n *\n * ## Why this is not one template string\n *\n * `http-connector.ts` used to bind `httpConfig.port` and then announce\n * `config.get(\"app.baseUrl\")` — a different value, read from a different\n * environment variable (`PORT` vs `BASE_URL`), with nothing checking the two\n * agreed. On 2026-08-24 a server listening on 3000 printed\n * `Server ready at http://localhost:41900`. **Following the line the server\n * itself printed gave connection refused, on a server that was working.** The\n * reference app carried the rule as a comment in `.env` — \"must agree with the\n * port in BASE_URL above\" — and a rule a comment enforces is not enforced.\n *\n * So the ready line now states the address actually bound. `app.baseUrl` is a\n * separate claim, and it is reported separately.\n *\n * ## Why a disagreement is not fatal\n *\n * A reverse-proxied deployment legitimately binds `0.0.0.0:3000` and publishes\n * `https://example.com`. Refusing to boot on a mismatch would break the correct\n * case, and warning on it would fire on every correct production boot — a\n * warning that always fires is one nobody reads.\n *\n * The mismatch worth a warning is the ACTIONABLE one: a base URL that points at\n * **loopback on a port nothing is listening on**, because someone will paste it\n * into a browser and conclude the server is broken. A non-loopback base URL is\n * a deployment address, reported plainly and never flagged.\n *\n * ## Why the address bound and the address printed are not the same string\n *\n * `listen()` resolves `localhost` and hands back whichever address it actually\n * bound — on a dual-stack machine that is `http://[::1]:2030`. That literal is\n * correct and useless: most terminals will not linkify a bracketed IPv6 host,\n * and on a first run it reads as broken output. So {@link toDisplayUrl} maps\n * the *loopback and wildcard* spellings onto `localhost`, which resolves back\n * to the very socket that was bound.\n *\n * This is a DISPLAY transform and nothing else — `host` still reaches\n * `listen()` untouched (`http-connector.ts`), so the set of interfaces the\n * server accepts on is byte-for-byte what it was. A genuine routable IPv6\n * address is left exactly as it is: there is no synonym for it, and inventing\n * one would be the same class of lie as printing `app.baseUrl` was.\n */\n\n/** Hosts that all mean \"this machine\" for the purpose of comparing addresses. */\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"::1\", \"[::1]\", \"0.0.0.0\", \"\"]);\n\n/**\n * Hosts for which `localhost` is a truthful, reachable synonym.\n *\n * The two loopback literals are exact synonyms. The two wildcards (`::`,\n * `0.0.0.0`) are not synonyms — they are strictly wider — but every one of them\n * *includes* loopback, so `localhost` always reaches the server. Callers that\n * need to tell the reader the bind is wider than loopback should say so\n * separately; see `dev-server/ready-block.ts`.\n *\n * The bracketed spellings are the ones that actually occur: WHATWG `hostname`\n * KEEPS the brackets for an IPv6 host (`new URL(\"http://[::1]:1\").hostname ===\n * \"[::1]\"`). The bare forms are listed too so a caller that hands over a host\n * rather than a URL is not silently missed.\n */\nconst DISPLAY_AS_LOCALHOST = new Set([\"127.0.0.1\", \"[::1]\", \"::1\", \"0.0.0.0\", \"[::]\", \"::\"]);\n\n/** The wildcard spellings — a bind wider than loopback. */\nconst WILDCARD_HOSTS = new Set([\"0.0.0.0\", \"[::]\", \"::\"]);\n\n/**\n * Whether the given bound address listens on more than loopback.\n *\n * Used to add \"(all interfaces)\" next to a URL that has been rewritten to\n * `localhost`, so the rewrite never hides a wider bind than the reader thinks.\n */\nexport function isWildcardBind(boundAddress: string | undefined): boolean {\n  const url = parseUrl(boundAddress);\n\n  if (!url) return false;\n\n  return WILDCARD_HOSTS.has(url.hostname);\n}\n\n/**\n * The address as it should be SHOWN to a human. See the module doc above.\n *\n * Anything unparseable is returned untouched: a best-effort prettifier must\n * never be the reason a developer is shown something other than what the\n * server reported.\n */\nexport function toDisplayUrl(boundAddress: string | undefined): string {\n  if (!boundAddress) return \"\";\n\n  const url = parseUrl(boundAddress);\n\n  if (!url) return boundAddress;\n\n  if (!DISPLAY_AS_LOCALHOST.has(url.hostname)) return boundAddress;\n\n  url.hostname = \"localhost\";\n\n  // `URL.href` re-appends a trailing slash to a bare origin, which is noise in\n  // a status line and is not what `listen()` returned.\n  return url.href.replace(/\\/$/, \"\");\n}\n\nexport type ServerAddressReport = {\n  /** Where the server is genuinely reachable, spelled for a human. Always present. */\n  ready: string;\n  /**\n   * The same address as a bare URL, ready to paste into a browser — the value\n   * `ready` embeds. Callers that render their own layout (the dev ready block)\n   * use this instead of re-deriving it.\n   */\n  url: string;\n  /**\n   * Exactly what `listen()` returned, untransformed. Kept so a caller that\n   * needs to reason about the BIND (which interfaces, which family) reads the\n   * fact rather than the presentation of it.\n   */\n  boundAddress?: string;\n  /** Whether the bind covers more than loopback (`0.0.0.0` / `::`). */\n  wildcardBind: boolean;\n  /** The configured public address, when it is a deployment URL rather than a local one. */\n  publicUrl?: string;\n  /** Set only when `app.baseUrl` points at loopback on a port nothing bound. */\n  warning?: string;\n};\n\nfunction parseUrl(value: unknown): URL | undefined {\n  if (typeof value !== \"string\" || value.length === 0) return undefined;\n\n  try {\n    return new URL(value);\n  } catch {\n    // An unparseable base URL is a separate problem, and it is NOT evidence of\n    // a port mismatch — reporting one from it would be a guess.\n    return undefined;\n  }\n}\n\nfunction isLoopback(url: URL): boolean {\n  return LOOPBACK_HOSTS.has(url.hostname);\n}\n\n/** `:3000` explicitly, or the protocol's default when the URL omits it. */\nfunction effectivePort(url: URL): string {\n  if (url.port) return url.port;\n\n  return url.protocol === \"https:\" ? \"443\" : \"80\";\n}\n\nexport function describeServerAddress(\n  boundAddress: string | undefined,\n  baseUrl: unknown,\n): ServerAddressReport {\n  const bound = parseUrl(boundAddress);\n  const configured = parseUrl(baseUrl);\n\n  // No bound address to report means the caller could not obtain one; the\n  // configured URL is then the only thing we know, and saying nothing would be\n  // worse than saying the one thing we have.\n  if (!bound) {\n    const fallback = String(configured?.href ?? boundAddress ?? baseUrl ?? \"\");\n\n    return {\n      ready: `Server ready at ${fallback}`,\n      url: fallback,\n      boundAddress,\n      wildcardBind: false,\n    };\n  }\n\n  // The URL a human is shown. `boundAddress` (the literal `listen()` returned)\n  // travels on the report untouched — see the module doc on why these differ.\n  const url = toDisplayUrl(boundAddress);\n  const base = {\n    ready: `Server ready at ${url}`,\n    url,\n    boundAddress,\n    wildcardBind: isWildcardBind(boundAddress),\n  };\n\n  if (!configured) return base;\n\n  if (!isLoopback(configured)) {\n    return { ...base, publicUrl: `Public URL (app.baseUrl): ${baseUrl}` };\n  }\n\n  if (effectivePort(configured) === effectivePort(bound)) {\n    return base;\n  }\n\n  return {\n    ...base,\n    warning:\n      `app.baseUrl is ${baseUrl}, but the server bound port ${effectivePort(bound)}. ` +\n      `Nothing is listening on port ${effectivePort(configured)} — ` +\n      `check BASE_URL and PORT, including anything exported in your shell.`,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAO;CAAS;CAAW;AAAE,CAAC;;;;;;;;;;;;;;;AAgBxF,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAa;CAAS;CAAO;CAAW;CAAQ;AAAI,CAAC;;AAG3F,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAW;CAAQ;AAAI,CAAC;;;;;;;AAQxD,SAAgB,eAAe,cAA2C;CACxE,MAAM,MAAM,SAAS,YAAY;CAEjC,IAAI,CAAC,KAAK,OAAO;CAEjB,OAAO,eAAe,IAAI,IAAI,QAAQ;AACxC;;;;;;;;AASA,SAAgB,aAAa,cAA0C;CACrE,IAAI,CAAC,cAAc,OAAO;CAE1B,MAAM,MAAM,SAAS,YAAY;CAEjC,IAAI,CAAC,KAAK,OAAO;CAEjB,IAAI,CAAC,qBAAqB,IAAI,IAAI,QAAQ,GAAG,OAAO;CAEpD,IAAI,WAAW;CAIf,OAAO,IAAI,KAAK,QAAQ,OAAO,EAAE;AACnC;AAyBA,SAAS,SAAS,OAAiC;CACjD,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG,OAAO;CAE5D,IAAI;EACF,OAAO,IAAI,IAAI,KAAK;CACtB,QAAQ;EAGN;CACF;AACF;AAEA,SAAS,WAAW,KAAmB;CACrC,OAAO,eAAe,IAAI,IAAI,QAAQ;AACxC;;AAGA,SAAS,cAAc,KAAkB;CACvC,IAAI,IAAI,MAAM,OAAO,IAAI;CAEzB,OAAO,IAAI,aAAa,WAAW,QAAQ;AAC7C;AAEA,SAAgB,sBACd,cACA,SACqB;CACrB,MAAM,QAAQ,SAAS,YAAY;CACnC,MAAM,aAAa,SAAS,OAAO;CAKnC,IAAI,CAAC,OAAO;EACV,MAAM,WAAW,OAAO,YAAY,QAAQ,gBAAgB,WAAW,EAAE;EAEzE,OAAO;GACL,OAAO,mBAAmB;GAC1B,KAAK;GACL;GACA,cAAc;EAChB;CACF;CAIA,MAAM,MAAM,aAAa,YAAY;CACrC,MAAM,OAAO;EACX,OAAO,mBAAmB;EAC1B;EACA;EACA,cAAc,eAAe,YAAY;CAC3C;CAEA,IAAI,CAAC,YAAY,OAAO;CAExB,IAAI,CAAC,WAAW,UAAU,GACxB,OAAO;EAAE,GAAG;EAAM,WAAW,6BAA6B;CAAU;CAGtE,IAAI,cAAc,UAAU,MAAM,cAAc,KAAK,GACnD,OAAO;CAGT,OAAO;EACL,GAAG;EACH,SACE,kBAAkB,QAAQ,8BAA8B,cAAc,KAAK,EAAE,iCAC7C,cAAc,UAAU,EAAE;CAE9D;AACF"}

package/esm/connectors/http-connector.d.mts

@@ -21,6 +21,24 @@ declare class HttpConnector extends BaseConnector {
    * Fastify Server instance
    */
   protected http?: FastifyInstance;
+  /**
+   * Whether someone downstream will render the combined ready block.
+   *
+   * Only the dev server does (`dev-server/ready-block.ts`), and only it can:
+   * the block reports facts — boot duration, the web surface — that this
+   * connector does not own and must not wait for. When it will, this connector
+   * records and stays quiet; otherwise it narrates as it always has.
+   *
+   * Keyed on the runtime strategy rather than on `NODE_ENV`, because that is
+   * what actually distinguishes "a dev server is driving this boot" from "an
+   * app happens to be running with development config".
+   *
+   * `!isBooted` is the second half and it is not a detail. The block summarises
+   * a BOOT. A `restart()` after boot — an edited `src/config/http.ts` — is an
+   * EVENT, and there is no block coming to carry it, so suppressing the lines
+   * there would rebind the port in total silence.
+   */
+  protected get rendersReadyBlock(): boolean;
   /**
    * Boot the connector — construction only (create Fastify, register
    * plugins, populate container). Route scanning is deferred to

package/esm/connectors/http-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAsCA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAmBb;;;;;EAAA,mBAZE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;EAoBX,IAAA,IAAI,OAAA;EAPP;;;;;;;EAAA,QA0CF,oBAAA;EA2FgB;;;;;EA3DX,KAAA,IAAS,OAAA;EAgGqB;;;;;EArC9B,OAAA,IAAW,OAAA;;;;EASX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}
+{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAuCA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAwCb;;;;;EAAA,mBAjCE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;;;;;;;;;;;;;EAAA,cAgCV,iBAAA;EA6MP;;;AAAoC;;EApM9B,IAAA,IAAI,OAAA;;;;;;;;UAmCT,oBAAA;;;;;;EAgCK,KAAA,IAAS,OAAA;;;;;;EA4FT,OAAA,IAAW,OAAA;;;;EASX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}

package/esm/connectors/http-connector.mjs

@@ -6,6 +6,7 @@ import { registerHttpPlugins } from "../http/plugins.mjs";
 import { closeServerWithTimeout, getHttpServer, startHttpServer } from "../http/server.mjs";
 import "../application/index.mjs";
 import { health } from "../http/health.mjs";
+import { setHttpReadyReport } from "../http/ready-report.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { describeServerAddress } from "./describe-server-address.mjs";
@@ -40,6 +41,26 @@ var HttpConnector = class extends BaseConnector {
 		this.watchedFiles = ["src/config/http.ts", "src/config/http.tsx"];
 	}
 	/**
+	* Whether someone downstream will render the combined ready block.
+	*
+	* Only the dev server does (`dev-server/ready-block.ts`), and only it can:
+	* the block reports facts — boot duration, the web surface — that this
+	* connector does not own and must not wait for. When it will, this connector
+	* records and stays quiet; otherwise it narrates as it always has.
+	*
+	* Keyed on the runtime strategy rather than on `NODE_ENV`, because that is
+	* what actually distinguishes "a dev server is driving this boot" from "an
+	* app happens to be running with development config".
+	*
+	* `!isBooted` is the second half and it is not a detail. The block summarises
+	* a BOOT. A `restart()` after boot — an edited `src/config/http.ts` — is an
+	* EVENT, and there is no block coming to carry it, so suppressing the lines
+	* there would rebind the port in total silence.
+	*/
+	get rendersReadyBlock() {
+		return Application.runtimeStrategy === "development" && !Application.isBooted;
+	}
+	/**
 	* Boot the connector — construction only (create Fastify, register
 	* plugins, populate container). Route scanning is deferred to
 	* `start()` so it reads the router after app code has registered.
@@ -85,10 +106,12 @@ var HttpConnector = class extends BaseConnector {
 	async start() {
 		const httpConfig = config.get("http");
 		if (!httpConfig || !this.http) return;
+		const deferToReadyBlock = this.rendersReadyBlock;
 		if (Application.runtimeStrategy === "development") router.scanDevServer(this.http);
 		else router.scan(this.http);
 		health.addRoutesRegisteredCheck(() => router.routeCount());
-		log.info("http", "routes", `${router.routeCount()} route(s) registered`);
+		const routeCount = router.routeCount();
+		if (!deferToReadyBlock) log.info("http", "routes", `${routeCount} route(s) registered`);
 		try {
 			const boundAddress = await this.http.listen({
 				port: httpConfig.port,
@@ -96,8 +119,18 @@ var HttpConnector = class extends BaseConnector {
 			});
 			Application.setServedPort(httpConfig.port);
 			const address = describeServerAddress(boundAddress, config.get("app.baseUrl"));
-			log.success(`http`, "connection", address.ready);
-			if (address.publicUrl) log.info(`http`, "connection", address.publicUrl);
+			setHttpReadyReport({
+				boundAddress: address.boundAddress,
+				url: address.url,
+				wildcardBind: address.wildcardBind,
+				port: httpConfig.port,
+				routeCount,
+				publicUrl: address.publicUrl
+			});
+			if (!deferToReadyBlock) {
+				log.success(`http`, "connection", address.ready);
+				if (address.publicUrl) log.info(`http`, "connection", address.publicUrl);
+			}
 			if (address.warning) log.warn(`http`, "connection", address.warning);
 		} catch (error) {
 			await log.fatal("http", "connection", error);

package/esm/connectors/http-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { Application } from \"../application\";\r\nimport { health } from \"../http/health\";\r\nimport { registerHttpPlugins } from \"../http/plugins\";\r\nimport { closeServerWithTimeout, FastifyInstance, getHttpServer, startHttpServer } from \"../http/server\";\r\nimport { router } from \"../router/router\";\r\nimport { Environment } from \"../utils\";\r\nimport { setBaseUrl } from \"../utils/urls\";\r\nimport { container } from \"./../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { describeServerAddress } from \"./describe-server-address\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\nfunction environmentColor(environment: Environment) {\r\n  switch (environment) {\r\n    case \"development\":\r\n      return colors.magentaBright(environment);\r\n    case \"test\":\r\n      return colors.yellowBright(environment);\r\n    case \"production\":\r\n      return colors.greenBright(environment);\r\n    default:\r\n      return colors.white(environment);\r\n  }\r\n}\r\n\r\n/**\r\n * Default time to wait for in-flight requests to drain on shutdown before the\r\n * HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.\r\n */\r\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\r\n\r\n/**\r\n * HTTP Connector\r\n * Manages HTTP server (Fastify) lifecycle\r\n */\r\nexport class HttpConnector extends BaseConnector {\r\n  public readonly name = \"http\";\r\n  public readonly priority = ConnectorPriority.HTTP;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\r\n\r\n  /**\r\n   * Files that trigger HTTP server restart\r\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\r\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/http.ts\", \"src/config/http.tsx\"];\r\n\r\n  /**\r\n   * Fastify Server instance\r\n   */\r\n  protected http?: FastifyInstance;\r\n\r\n  /**\r\n   * Boot the connector — construction only (create Fastify, register\r\n   * plugins, populate container). Route scanning is deferred to\r\n   * `start()` so it reads the router after app code has registered.\r\n   */\r\n  public async boot() {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig) return;\r\n\r\n    const port = httpConfig.port;\r\n    log.info(\r\n      `http`,\r\n      \"connection\",\r\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\r\n    );\r\n\r\n    this.http = startHttpServer(httpConfig.serverOptions);\r\n\r\n    container.set(\"http.server\", this.http);\r\n\r\n    await registerHttpPlugins(this.http);\r\n\r\n    const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n    // update base url\r\n    setBaseUrl(baseUrl);\r\n\r\n    // Liveness/readiness endpoints — registered on Fastify before start() scans\r\n    // the app router, so they exist by the time the server listens.\r\n    this.registerHealthRoutes();\r\n  }\r\n\r\n  /**\r\n   * Register the built-in liveness (`/health`) and readiness (`/ready`)\r\n   * endpoints directly on the Fastify instance — infra routes, kept off the app\r\n   * router so they're immune to HMR and never collide with route scanning. Opt\r\n   * out via `http.health.enabled = false`; rename via `http.health.path` /\r\n   * `http.health.readinessPath`.\r\n   */\r\n  private registerHealthRoutes(): void {\r\n    if (!this.http) {\r\n      return;\r\n    }\r\n\r\n    const healthConfig = config.get(\"http.health\");\r\n\r\n    if (healthConfig?.enabled === false) {\r\n      return;\r\n    }\r\n\r\n    const livenessPath = healthConfig?.path ?? \"/health\";\r\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\r\n\r\n    this.http.get(livenessPath, async (_request: any, reply: any) => {\r\n      const result = health.liveness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n\r\n    this.http.get(readinessPath, async (_request: any, reply: any) => {\r\n      const result = await health.readiness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Initialize HTTP server — bind app-registered routes to Fastify\r\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\r\n   * app code without losing routes.\r\n   */\r\n  public async start(): Promise<void> {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig || !this.http) return;\r\n\r\n    if (Application.runtimeStrategy === \"development\") {\r\n      router.scanDevServer(this.http);\r\n    } else {\r\n      router.scan(this.http);\r\n    }\r\n\r\n    // Surface the route table as a readiness signal + a boot log, so an empty\r\n    // or partial route surface (e.g. a route module that failed to register) is\r\n    // detectable instead of silently 404ing. `addRoutesRegisteredCheck` is\r\n    // keyed by name, so re-running on restart is idempotent.\r\n    health.addRoutesRegisteredCheck(() => router.routeCount());\r\n    log.info(\"http\", \"routes\", `${router.routeCount()} route(s) registered`);\r\n\r\n    try {\r\n      // `listen()` RESOLVES with the address it actually bound — which is the\r\n      // only address worth announcing. See `describe-server-address.ts` for why\r\n      // announcing `app.baseUrl` here instead was a defect rather than a\r\n      // shortcut.\r\n      const boundAddress = await this.http.listen({\r\n        port: httpConfig.port,\r\n        host: httpConfig.host || \"localhost\",\r\n      });\r\n\r\n      Application.setServedPort(httpConfig.port);\r\n\r\n      const address = describeServerAddress(boundAddress, config.get(\"app.baseUrl\"));\r\n\r\n      log.success(`http`, \"connection\", address.ready);\r\n\r\n      if (address.publicUrl) {\r\n        log.info(`http`, \"connection\", address.publicUrl);\r\n      }\r\n\r\n      if (address.warning) {\r\n        log.warn(`http`, \"connection\", address.warning);\r\n      }\r\n    } catch (error) {\r\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\r\n      // `log.fatal` reaches Sentry/file; `await log.flush()` drains buffered and\r\n      // async channels before the process exits.\r\n      await log.fatal(\"http\", \"connection\", error);\r\n      await log.flush();\r\n\r\n      process.exit(1); // stop the process, exit with error\r\n    }\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Restart — needs a fresh Fastify instance since `start()` now\r\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\r\n   * register duplicate route handlers.\r\n   */\r\n  public async restart(): Promise<void> {\r\n    await this.shutdown();\r\n    await this.boot();\r\n    await this.start();\r\n  }\r\n\r\n  /**\r\n   * Shutdown HTTP server\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    const server = getHttpServer();\r\n\r\n    if (server) {\r\n      const timeout = config.get(\"http.gracefulShutdown.timeout\", DEFAULT_SHUTDOWN_TIMEOUT);\r\n      const drained = await closeServerWithTimeout(server, timeout);\r\n\r\n      if (!drained) {\r\n        log.warn(\r\n          \"http\",\r\n          \"shutdown\",\r\n          `In-flight requests did not drain within ${timeout}ms; closing anyway`,\r\n        );\r\n      }\r\n    }\r\n\r\n    this.active = false;\r\n  }\r\n\r\n  /**\r\n   * Override shouldRestart to handle routes.ts specially\r\n   * routes.ts changes should NOT restart the server (use HMR instead)\r\n   * Now receives config file paths directly from layer-executor\r\n   */\r\n  public shouldRestart(changedFiles: string[]): boolean {\r\n    // Only restart for config changes, not routes\r\n    return changedFiles.some((file) => {\r\n      const relativePath = file.replace(/\\\\/g, \"/\");\r\n      return this.watchedFiles.includes(relativePath);\r\n    });\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"http-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { Application } from \"../application\";\r\nimport { health } from \"../http/health\";\r\nimport { registerHttpPlugins } from \"../http/plugins\";\r\nimport { setHttpReadyReport } from \"../http/ready-report\";\r\nimport { closeServerWithTimeout, FastifyInstance, getHttpServer, startHttpServer } from \"../http/server\";\r\nimport { router } from \"../router/router\";\r\nimport { Environment } from \"../utils\";\r\nimport { setBaseUrl } from \"../utils/urls\";\r\nimport { container } from \"./../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { describeServerAddress } from \"./describe-server-address\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\nfunction environmentColor(environment: Environment) {\r\n  switch (environment) {\r\n    case \"development\":\r\n      return colors.magentaBright(environment);\r\n    case \"test\":\r\n      return colors.yellowBright(environment);\r\n    case \"production\":\r\n      return colors.greenBright(environment);\r\n    default:\r\n      return colors.white(environment);\r\n  }\r\n}\r\n\r\n/**\r\n * Default time to wait for in-flight requests to drain on shutdown before the\r\n * HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.\r\n */\r\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\r\n\r\n/**\r\n * HTTP Connector\r\n * Manages HTTP server (Fastify) lifecycle\r\n */\r\nexport class HttpConnector extends BaseConnector {\r\n  public readonly name = \"http\";\r\n  public readonly priority = ConnectorPriority.HTTP;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\r\n\r\n  /**\r\n   * Files that trigger HTTP server restart\r\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\r\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/http.ts\", \"src/config/http.tsx\"];\r\n\r\n  /**\r\n   * Fastify Server instance\r\n   */\r\n  protected http?: FastifyInstance;\r\n\r\n  /**\r\n   * Whether someone downstream will render the combined ready block.\r\n   *\r\n   * Only the dev server does (`dev-server/ready-block.ts`), and only it can:\r\n   * the block reports facts — boot duration, the web surface — that this\r\n   * connector does not own and must not wait for. When it will, this connector\r\n   * records and stays quiet; otherwise it narrates as it always has.\r\n   *\r\n   * Keyed on the runtime strategy rather than on `NODE_ENV`, because that is\r\n   * what actually distinguishes \"a dev server is driving this boot\" from \"an\r\n   * app happens to be running with development config\".\r\n   *\r\n   * `!isBooted` is the second half and it is not a detail. The block summarises\r\n   * a BOOT. A `restart()` after boot — an edited `src/config/http.ts` — is an\r\n   * EVENT, and there is no block coming to carry it, so suppressing the lines\r\n   * there would rebind the port in total silence.\r\n   */\r\n  protected get rendersReadyBlock(): boolean {\r\n    return Application.runtimeStrategy === \"development\" && !Application.isBooted;\r\n  }\r\n\r\n  /**\r\n   * Boot the connector — construction only (create Fastify, register\r\n   * plugins, populate container). Route scanning is deferred to\r\n   * `start()` so it reads the router after app code has registered.\r\n   */\r\n  public async boot() {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig) return;\r\n\r\n    const port = httpConfig.port;\r\n    log.info(\r\n      `http`,\r\n      \"connection\",\r\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\r\n    );\r\n\r\n    this.http = startHttpServer(httpConfig.serverOptions);\r\n\r\n    container.set(\"http.server\", this.http);\r\n\r\n    await registerHttpPlugins(this.http);\r\n\r\n    const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n    // update base url\r\n    setBaseUrl(baseUrl);\r\n\r\n    // Liveness/readiness endpoints — registered on Fastify before start() scans\r\n    // the app router, so they exist by the time the server listens.\r\n    this.registerHealthRoutes();\r\n  }\r\n\r\n  /**\r\n   * Register the built-in liveness (`/health`) and readiness (`/ready`)\r\n   * endpoints directly on the Fastify instance — infra routes, kept off the app\r\n   * router so they're immune to HMR and never collide with route scanning. Opt\r\n   * out via `http.health.enabled = false`; rename via `http.health.path` /\r\n   * `http.health.readinessPath`.\r\n   */\r\n  private registerHealthRoutes(): void {\r\n    if (!this.http) {\r\n      return;\r\n    }\r\n\r\n    const healthConfig = config.get(\"http.health\");\r\n\r\n    if (healthConfig?.enabled === false) {\r\n      return;\r\n    }\r\n\r\n    const livenessPath = healthConfig?.path ?? \"/health\";\r\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\r\n\r\n    this.http.get(livenessPath, async (_request: any, reply: any) => {\r\n      const result = health.liveness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n\r\n    this.http.get(readinessPath, async (_request: any, reply: any) => {\r\n      const result = await health.readiness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Initialize HTTP server — bind app-registered routes to Fastify\r\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\r\n   * app code without losing routes.\r\n   */\r\n  public async start(): Promise<void> {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig || !this.http) return;\r\n\r\n    // Read once. `Application.isBooted` flips during the same boot this method\r\n    // belongs to, and a predicate that answered differently before and after\r\n    // `listen()` would print half a report.\r\n    const deferToReadyBlock = this.rendersReadyBlock;\r\n\r\n    if (Application.runtimeStrategy === \"development\") {\r\n      router.scanDevServer(this.http);\r\n    } else {\r\n      router.scan(this.http);\r\n    }\r\n\r\n    // Surface the route table as a readiness signal + a boot log, so an empty\r\n    // or partial route surface (e.g. a route module that failed to register) is\r\n    // detectable instead of silently 404ing. `addRoutesRegisteredCheck` is\r\n    // keyed by name, so re-running on restart is idempotent.\r\n    health.addRoutesRegisteredCheck(() => router.routeCount());\r\n\r\n    const routeCount = router.routeCount();\r\n\r\n    // In development this fact is one line of the single ready block rendered\r\n    // after boot completes (`dev-server/ready-block.ts`); printing it here as\r\n    // well would put the same number on screen twice, in two formats. Outside\r\n    // development the line is load-bearing — a supervisor or CI log greps it —\r\n    // so it stays exactly as it was.\r\n    if (!deferToReadyBlock) {\r\n      log.info(\"http\", \"routes\", `${routeCount} route(s) registered`);\r\n    }\r\n\r\n    try {\r\n      // `listen()` RESOLVES with the address it actually bound — which is the\r\n      // only address worth announcing. See `describe-server-address.ts` for why\r\n      // announcing `app.baseUrl` here instead was a defect rather than a\r\n      // shortcut.\r\n      const boundAddress = await this.http.listen({\r\n        port: httpConfig.port,\r\n        host: httpConfig.host || \"localhost\",\r\n      });\r\n\r\n      Application.setServedPort(httpConfig.port);\r\n\r\n      const address = describeServerAddress(boundAddress, config.get(\"app.baseUrl\"));\r\n\r\n      // Recorded unconditionally: the ready block reads it in development, and\r\n      // in every other mode it is simply the one place that knows what was\r\n      // bound, which is worth having whether or not anything renders it.\r\n      setHttpReadyReport({\r\n        boundAddress: address.boundAddress,\r\n        url: address.url,\r\n        wildcardBind: address.wildcardBind,\r\n        port: httpConfig.port,\r\n        routeCount,\r\n        publicUrl: address.publicUrl,\r\n      });\r\n\r\n      if (!deferToReadyBlock) {\r\n        log.success(`http`, \"connection\", address.ready);\r\n\r\n        if (address.publicUrl) {\r\n          log.info(`http`, \"connection\", address.publicUrl);\r\n        }\r\n      }\r\n\r\n      // NEVER conditional on the block. A base URL pointing at a port nothing\r\n      // is listening on is the single most misleading state this connector can\r\n      // be in, and a warning a status block swallows is a warning nobody reads\r\n      // — so it is logged where it lands ABOVE the block, in both modes.\r\n      if (address.warning) {\r\n        log.warn(`http`, \"connection\", address.warning);\r\n      }\r\n    } catch (error) {\r\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\r\n      // `log.fatal` reaches Sentry/file; `await log.flush()` drains buffered and\r\n      // async channels before the process exits.\r\n      await log.fatal(\"http\", \"connection\", error);\r\n      await log.flush();\r\n\r\n      process.exit(1); // stop the process, exit with error\r\n    }\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Restart — needs a fresh Fastify instance since `start()` now\r\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\r\n   * register duplicate route handlers.\r\n   */\r\n  public async restart(): Promise<void> {\r\n    await this.shutdown();\r\n    await this.boot();\r\n    await this.start();\r\n  }\r\n\r\n  /**\r\n   * Shutdown HTTP server\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    const server = getHttpServer();\r\n\r\n    if (server) {\r\n      const timeout = config.get(\"http.gracefulShutdown.timeout\", DEFAULT_SHUTDOWN_TIMEOUT);\r\n      const drained = await closeServerWithTimeout(server, timeout);\r\n\r\n      if (!drained) {\r\n        log.warn(\r\n          \"http\",\r\n          \"shutdown\",\r\n          `In-flight requests did not drain within ${timeout}ms; closing anyway`,\r\n        );\r\n      }\r\n    }\r\n\r\n    this.active = false;\r\n  }\r\n\r\n  /**\r\n   * Override shouldRestart to handle routes.ts specially\r\n   * routes.ts changes should NOT restart the server (use HMR instead)\r\n   * Now receives config file paths directly from layer-executor\r\n   */\r\n  public shouldRestart(changedFiles: string[]): boolean {\r\n    // Only restart for config changes, not routes\r\n    return changedFiles.some((file) => {\r\n      const relativePath = file.replace(/\\\\/g, \"/\");\r\n      return this.watchedFiles.includes(relativePath);\r\n    });\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAS,iBAAiB,aAA0B;CAClD,QAAQ,aAAR;EACE,KAAK,eACH,OAAO,OAAO,cAAc,WAAW;EACzC,KAAK,QACH,OAAO,OAAO,aAAa,WAAW;EACxC,KAAK,cACH,OAAO,OAAO,YAAY,WAAW;EACvC,SACE,OAAO,OAAO,MAAM,WAAW;CACnC;AACF;;;;;AAMA,MAAM,2BAA2B;;;;;AAMjC,IAAa,gBAAb,cAAmC,cAAc;;;cACxB;;;sBASW,CAAC,sBAAsB,qBAAqB;;;;;;;;;;;;;;;;;;;CAwB9E,IAAc,oBAA6B;EACzC,OAAO,YAAY,oBAAoB,iBAAiB,CAAC,YAAY;CACvE;;;;;;CAOA,MAAa,OAAO;EAClB,MAAM,aAAa,OAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,YAAY;EAEjB,MAAM,OAAO,WAAW;EACxB,IAAI,KACF,QACA,cACA,gCAAgC,KAAK,MAAM,iBAAiB,YAAY,WAAW,EAAE,MACvF;EAEA,KAAK,OAAO,gBAAgB,WAAW,aAAa;EAEpD,UAAU,IAAI,eAAe,KAAK,IAAI;EAEtC,MAAM,oBAAoB,KAAK,IAAI;EAKnC,WAHgB,OAAO,IAAI,aAGV,CAAC;EAIlB,KAAK,qBAAqB;CAC5B;;;;;;;;CASA,AAAQ,uBAA6B;EACnC,IAAI,CAAC,KAAK,MACR;EAGF,MAAM,eAAe,OAAO,IAAI,aAAa;EAE7C,IAAI,cAAc,YAAY,OAC5B;EAGF,MAAM,eAAe,cAAc,QAAQ;EAC3C,MAAM,gBAAgB,cAAc,iBAAiB;EAErD,KAAK,KAAK,IAAI,cAAc,OAAO,UAAe,UAAe;GAC/D,MAAM,SAAS,OAAO,SAAS;GAE/B,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM;EACnE,CAAC;EAED,KAAK,KAAK,IAAI,eAAe,OAAO,UAAe,UAAe;GAChE,MAAM,SAAS,MAAM,OAAO,UAAU;GAEtC,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM;EACnE,CAAC;CACH;;;;;;CAOA,MAAa,QAAuB;EAClC,MAAM,aAAa,OAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM;EAK/B,MAAM,oBAAoB,KAAK;EAE/B,IAAI,YAAY,oBAAoB,eAClC,OAAO,cAAc,KAAK,IAAI;OAE9B,OAAO,KAAK,KAAK,IAAI;EAOvB,OAAO,+BAA+B,OAAO,WAAW,CAAC;EAEzD,MAAM,aAAa,OAAO,WAAW;EAOrC,IAAI,CAAC,mBACH,IAAI,KAAK,QAAQ,UAAU,GAAG,WAAW,qBAAqB;EAGhE,IAAI;GAKF,MAAM,eAAe,MAAM,KAAK,KAAK,OAAO;IAC1C,MAAM,WAAW;IACjB,MAAM,WAAW,QAAQ;GAC3B,CAAC;GAED,YAAY,cAAc,WAAW,IAAI;GAEzC,MAAM,UAAU,sBAAsB,cAAc,OAAO,IAAI,aAAa,CAAC;GAK7E,mBAAmB;IACjB,cAAc,QAAQ;IACtB,KAAK,QAAQ;IACb,cAAc,QAAQ;IACtB,MAAM,WAAW;IACjB;IACA,WAAW,QAAQ;GACrB,CAAC;GAED,IAAI,CAAC,mBAAmB;IACtB,IAAI,QAAQ,QAAQ,cAAc,QAAQ,KAAK;IAE/C,IAAI,QAAQ,WACV,IAAI,KAAK,QAAQ,cAAc,QAAQ,SAAS;GAEpD;GAMA,IAAI,QAAQ,SACV,IAAI,KAAK,QAAQ,cAAc,QAAQ,OAAO;EAElD,SAAS,OAAO;GAId,MAAM,IAAI,MAAM,QAAQ,cAAc,KAAK;GAC3C,MAAM,IAAI,MAAM;GAEhB,QAAQ,KAAK,CAAC;EAChB;EAEA,KAAK,SAAS;CAChB;;;;;;CAOA,MAAa,UAAyB;EACpC,MAAM,KAAK,SAAS;EACpB,MAAM,KAAK,KAAK;EAChB,MAAM,KAAK,MAAM;CACnB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,SAAS,cAAc;EAE7B,IAAI,QAAQ;GACV,MAAM,UAAU,OAAO,IAAI,iCAAiC,wBAAwB;GAGpF,IAAI,CAAC,MAFiB,uBAAuB,QAAQ,OAAO,GAG1D,IAAI,KACF,QACA,YACA,2CAA2C,QAAQ,mBACrD;EAEJ;EAEA,KAAK,SAAS;CAChB;;;;;;CAOA,AAAO,cAAc,cAAiC;EAEpD,OAAO,aAAa,MAAM,SAAS;GACjC,MAAM,eAAe,KAAK,QAAQ,OAAO,GAAG;GAC5C,OAAO,KAAK,aAAa,SAAS,YAAY;EAChD,CAAC;CACH;AACF"}

package/esm/dev-server/dev-logger.mjs

@@ -70,9 +70,6 @@ function devLogHMR(file, dependents) {
 	const depInfo = dependents ? colors.dim(` +${dependents} module${dependents > 1 ? "s" : ""}`) : "";
 	console.log(`${timestamp()} 🔥 ${colors.green("hmr update")} ${colors.dim(relativePath)}${depInfo}`);
 }
-function devLogReady(message) {
-	console.log(`\n${timestamp()}  ${colors.green("➜")}  ${colors.bold(message)}`);
-}
 function devLogSection(title) {
 	console.log(`\n${timestamp()} ${colors.bold(colors.cyan(title))}`);
 }
@@ -106,5 +103,5 @@ function formatModuleNotFoundError(error, suggestions) {
 const devServeLog = devLog;
 
 //#endregion
-export { devLogDim, devLogError, devLogHMR, devLogInfo, devLogReady, devLogSection, devLogSuccess, devLogWarn, devServeLog, formatModuleNotFoundError };
+export { devLogDim, devLogError, devLogHMR, devLogInfo, devLogSection, devLogSuccess, devLogWarn, devServeLog, formatModuleNotFoundError };
 //# sourceMappingURL=dev-logger.mjs.map

package/esm/dev-server/dev-logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map(line => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      const fn = withFn ? withFn[2] : \"\";\n      const file = withFn ? withFn[3] : bare![2];\n      const lineNo = withFn ? withFn[4] : bare![3];\n      const col = withFn ? withFn[5] : bare![4];\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}`,\n  );\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  const [, modulePath, importerPath] = match;\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach(s => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}
+{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map(line => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      const fn = withFn ? withFn[2] : \"\";\n      const file = withFn ? withFn[3] : bare![2];\n      const lineNo = withFn ? withFn[4] : bare![3];\n      const col = withFn ? withFn[5] : bare![4];\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}`,\n  );\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  const [, modulePath, importerPath] = match;\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach(s => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}

package/esm/dev-server/development-server.mjs

@@ -4,12 +4,13 @@ import { ConnectorLifecyclePhase } from "../connectors/types.mjs";
 import { connectorsManager } from "../connectors/connectors-manager.mjs";
 import { warlockConfigManager } from "../warlock-config/warlock-config.manager.mjs";
 import "../warlock-config/index.mjs";
-import { devLogInfo, devLogReady, devLogSection, devLogWarn, devServeLog } from "./dev-logger.mjs";
+import { devLogInfo, devLogSection, devLogWarn, devServeLog } from "./dev-logger.mjs";
 import { MANIFEST_PATH } from "./flags.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { restartDevServer } from "./restart-dev-server.mjs";
 import { devServerShortcuts } from "./shortcuts.mjs";
 import { LayerExecutor } from "./layer-executor.mjs";
+import { printReadyBlock } from "./ready-block.mjs";
 import { typeGenerator } from "./type-generator.mjs";
 import { colors } from "@mongez/copper";
 import events from "@mongez/events";
@@ -46,12 +47,12 @@ var DevelopmentServer = class {
 			this.layerExecutor = new LayerExecutor(filesOrchestrator.getDependencyGraph(), filesOrchestrator.specialFilesCollector, filesOrchestrator.moduleLoader, (absolutePath) => filesOrchestrator.bumpVersion(absolutePath), () => filesOrchestrator.flushVersionBumps());
 			this.running = true;
 			const duration = performance.now() - startedAt;
-			devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);
 			Application.markBooted({
 				environment: Application.environment,
 				runtimeStrategy: Application.runtimeStrategy,
 				bootDurationMs: duration
 			});
+			printReadyBlock(duration);
 			const devServerConfig = await warlockConfigManager.get("devServer");
 			const generateTypings = this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;
 			const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;
@@ -129,11 +130,6 @@ function isEnvPath(path) {
 	const basename = path.split("/").pop() ?? path;
 	return basename === ".env" || basename.startsWith(".env.");
 }
-function parseDuration(ms) {
-	if (ms < 1e3) return `${ms.toFixed(2)}ms`;
-	if (ms > 6e4) return `${(ms / 6e4).toFixed(2)}m`;
-	return `${(ms / 1e3).toFixed(2)}s`;
-}
 
 //#endregion
 export { DevelopmentServer };