@warlock.js/core 5.29.0 → 5.31.0

package/esm/dev-server/app-module-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-module-registry.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/app-module-registry.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { container } from \"../container\";\nimport type {\n  DevelopmentAppModuleEntry,\n  DevelopmentAppModules,\n} from \"../container/development-app-modules\";\n\n/**\n * The SAME key normalization the loader hook thread uses for its version map\n * (`loader/version-registry.ts`). It is what keeps `generation` equal to the\n * hook's version for a path: both sides count bumps per this key.\n */\nfunction normalizeKey(absolutePath: string): string {\n  return absolutePath.replace(/\\\\/g, \"/\").toLowerCase();\n}\n\n/** Internal writer for the container's read-only development app-module carrier. */\nexport class DevelopmentAppModuleRegistry implements DevelopmentAppModules {\n  private readonly entries = new Map<string, DevelopmentAppModuleEntry>();\n  private readonly listeners = new Set<(entry: DevelopmentAppModuleEntry) => void>();\n\n  public get(absolutePath: string): DevelopmentAppModuleEntry | undefined {\n    return this.entries.get(normalizeKey(absolutePath));\n  }\n\n  public subscribe(listener: (entry: DevelopmentAppModuleEntry) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Record that the hook thread has processed one more bump of this file.\n   * Call only after the hook thread acknowledged it (`flushVersionBumps`).\n   */\n  public bump(absolutePath: string): void {\n    const key = normalizeKey(absolutePath);\n    const entry: DevelopmentAppModuleEntry = {\n      url: pathToFileURL(absolutePath).href,\n      generation: (this.entries.get(key)?.generation ?? 0) + 1,\n    };\n\n    this.entries.set(key, entry);\n\n    for (const listener of this.listeners) {\n      try {\n        listener(entry);\n      } catch {\n        // A subscriber's invalidation failure must never abort the reload batch.\n      }\n    }\n  }\n}\n\nexport function getDevelopmentAppModuleRegistry(): DevelopmentAppModuleRegistry {\n  const existing = container.tryGet(\"development.appModules\");\n\n  if (existing instanceof DevelopmentAppModuleRegistry) return existing;\n\n  const registry = new DevelopmentAppModuleRegistry();\n  container.set(\"development.appModules\", registry);\n  return registry;\n}\n"],"mappings":";;;;;;;;;AAYA,SAAS,aAAa,cAA8B;CAClD,OAAO,aAAa,QAAQ,OAAO,GAAG,CAAC,CAAC,YAAY;AACtD;;AAGA,IAAa,+BAAb,MAA2E;;iCAC9C,IAAI,IAAuC;mCACzC,IAAI,IAAgD;;CAEjF,AAAO,IAAI,cAA6D;EACtE,OAAO,KAAK,QAAQ,IAAI,aAAa,YAAY,CAAC;CACpD;CAEA,AAAO,UAAU,UAAkE;EACjF,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa,KAAK,UAAU,OAAO,QAAQ;CAC7C;;;;;CAMA,AAAO,KAAK,cAA4B;EACtC,MAAM,MAAM,aAAa,YAAY;EACrC,MAAM,QAAmC;GACvC,KAAK,cAAc,YAAY,CAAC,CAAC;GACjC,aAAa,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,cAAc,KAAK;EACzD;EAEA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAE3B,KAAK,MAAM,YAAY,KAAK,WAC1B,IAAI;GACF,SAAS,KAAK;EAChB,QAAQ,CAER;CAEJ;AACF;AAEA,SAAgB,kCAAgE;CAC9E,MAAM,WAAW,UAAU,OAAO,wBAAwB;CAE1D,IAAI,oBAAoB,8BAA8B,OAAO;CAE7D,MAAM,WAAW,IAAI,6BAA6B;CAClD,UAAU,IAAI,0BAA0B,QAAQ;CAChD,OAAO;AACT"}
+{"version":3,"file":"app-module-registry.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/app-module-registry.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { container } from \"../container\";\nimport type {\n  DevelopmentAppModuleEntry,\n  DevelopmentAppModules,\n} from \"../container/development-app-modules\";\n\n/**\n * The SAME key normalization the loader hook thread uses for its version map\n * (`loader/version-registry.ts`). It is what keeps `generation` equal to the\n * hook's version for a path: both sides count bumps per this key.\n */\nfunction normalizeKey(absolutePath: string): string {\n  return absolutePath.replace(/\\\\/g, \"/\").toLowerCase();\n}\n\n/** Internal writer for the container's read-only development app-module carrier. */\nexport class DevelopmentAppModuleRegistry implements DevelopmentAppModules {\n  private readonly entries = new Map<string, DevelopmentAppModuleEntry>();\n  private readonly listeners = new Set<(entry: DevelopmentAppModuleEntry) => void>();\n\n  public get(absolutePath: string): DevelopmentAppModuleEntry | undefined {\n    return this.entries.get(normalizeKey(absolutePath));\n  }\n\n  public subscribe(listener: (entry: DevelopmentAppModuleEntry) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Record that the hook thread has processed one more bump of this file.\n   * Call only after the hook thread acknowledged it (`flushVersionBumps`).\n   */\n  public bump(absolutePath: string): void {\n    const key = normalizeKey(absolutePath);\n    const entry: DevelopmentAppModuleEntry = {\n      url: pathToFileURL(absolutePath).href,\n      generation: (this.entries.get(key)?.generation ?? 0) + 1,\n    };\n\n    this.entries.set(key, entry);\n\n    for (const listener of this.listeners) {\n      try {\n        listener(entry);\n      } catch {\n        // A subscriber's invalidation failure must never abort the reload batch.\n      }\n    }\n  }\n}\n\nexport function getDevelopmentAppModuleRegistry(): DevelopmentAppModuleRegistry {\n  const existing = container.tryGet(\"development.appModules\");\n\n  if (existing instanceof DevelopmentAppModuleRegistry) return existing;\n\n  const registry = new DevelopmentAppModuleRegistry();\n  container.set(\"development.appModules\", registry);\n  return registry;\n}\n"],"mappings":";;;;;;;;;AAYA,SAAS,aAAa,cAA8B;CAClD,OAAO,aAAa,QAAQ,OAAO,GAAG,CAAC,CAAC,YAAY;AACtD;;AAGA,IAAa,+BAAb,MAA2E;;iCAC9C,IAAI,IAAuC;mCACzC,IAAI,IAAgD;;CAEjF,AAAO,IAAI,cAA6D;EACtE,OAAO,KAAK,QAAQ,IAAI,aAAa,YAAY,CAAC;CACpD;CAEA,AAAO,UAAU,UAAkE;EACjF,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa,KAAK,UAAU,OAAO,QAAQ;CAC7C;;;;;CAMA,AAAO,KAAK,cAA4B;EACtC,MAAM,MAAM,aAAa,YAAY;EACrC,MAAM,QAAmC;GACvC,KAAK,cAAc,YAAY,CAAC,CAAC;GACjC,aAAa,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,cAAc,KAAK;EACzD;EAEA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAE3B,KAAK,MAAM,YAAY,KAAK,WAC1B,IAAI;GACF,SAAS,KAAK;EAChB,QAAQ,CAER;CAEJ;AACF;AAEA,SAAgB,kCAAgE;CAC9E,MAAM,WAAW,UAAU,OAAO,wBAAwB;CAE1D,IAAI,oBAAoB,8BAA8B,OAAO;CAE7D,MAAM,WAAW,IAAI,6BAA6B;CAClD,UAAU,IAAI,0BAA0B,QAAQ;CAChD,OAAO;AACT"}

package/esm/dev-server/boot-precondition-error.mjs

@@ -1,6 +1,6 @@
 import { PortInUseError } from "../http/port-preflight.mjs";
 
-//#region ../core/src/dev-server/boot-precondition-error.ts
+//#region ../../packages/core/src/dev-server/boot-precondition-error.ts
 /**
 * Marks a startup failure whose cause cannot change because the dev worker
 * tried again — a rejected `Application.onValidateBoot(...)` validator, an
@@ -18,6 +18,7 @@ import { PortInUseError } from "../http/port-preflight.mjs";
 var BootPreconditionError = class extends Error {
 	constructor(message, options) {
 		super(message, options);
+		this.code = "WL2005";
 		this.name = "BootPreconditionError";
 	}
 };

package/esm/dev-server/boot-precondition-error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"boot-precondition-error.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/boot-precondition-error.ts"],"sourcesContent":["import { PortInUseError } from \"../http/port-preflight\";\n\n/**\n * Marks a startup failure whose cause cannot change because the dev worker\n * tried again — a rejected `Application.onValidateBoot(...)` validator, an\n * unusable configured value, or (via {@link isBootPreconditionError})\n * {@link PortInUseError} itself. Distinct from an ordinary code error or a\n * refused database/cache connection, both of which ARE worth restarting for\n * (the underlying service, or the developer's fix, can change on the next\n * attempt).\n *\n * `start-development-server.ts` checks for this type (never an error\n * message) to decide whether the worker exits with\n * `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor\n * treats as terminal — no restart, no crash-budget spend.\n */\nexport class BootPreconditionError extends Error {\n  public constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BootPreconditionError\";\n  }\n}\n\n/**\n * Whether `error` belongs to the boot-precondition class — checked by TYPE,\n * never by message text, so a legitimate error that happens to share\n * wording with a known failure is never misclassified.\n */\nexport function isBootPreconditionError(error: unknown): boolean {\n  return error instanceof BootPreconditionError || error instanceof PortInUseError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,AAAO,YAAY,SAAiB,SAA+B;EACjE,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;;;;;;AAOA,SAAgB,wBAAwB,OAAyB;CAC/D,OAAO,iBAAiB,yBAAyB,iBAAiB;AACpE"}
+{"version":3,"file":"boot-precondition-error.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/boot-precondition-error.ts"],"sourcesContent":["import { PortInUseError } from \"../http/port-preflight\";\n\n/**\n * Marks a startup failure whose cause cannot change because the dev worker\n * tried again — a rejected `Application.onValidateBoot(...)` validator, an\n * unusable configured value, or (via {@link isBootPreconditionError})\n * {@link PortInUseError} itself. Distinct from an ordinary code error or a\n * refused database/cache connection, both of which ARE worth restarting for\n * (the underlying service, or the developer's fix, can change on the next\n * attempt).\n *\n * `start-development-server.ts` checks for this type (never an error\n * message) to decide whether the worker exits with\n * `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor\n * treats as terminal — no restart, no crash-budget spend.\n */\nexport class BootPreconditionError extends Error {\n  /** Stable Warlock error code; `warlock explain WL2005` prints the fix. */\n  public readonly code = \"WL2005\";\n\n  public constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BootPreconditionError\";\n  }\n}\n\n/**\n * Whether `error` belongs to the boot-precondition class — checked by TYPE,\n * never by message text, so a legitimate error that happens to share\n * wording with a known failure is never misclassified.\n */\nexport function isBootPreconditionError(error: unknown): boolean {\n  return error instanceof BootPreconditionError || error instanceof PortInUseError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,wBAAb,cAA2C,MAAM;CAI/C,AAAO,YAAY,SAAiB,SAA+B;EACjE,MAAM,SAAS,OAAO;cAHD;EAIrB,KAAK,OAAO;CACd;AACF;;;;;;AAOA,SAAgB,wBAAwB,OAAyB;CAC/D,OAAO,iBAAiB,yBAAyB,iBAAiB;AACpE"}

package/esm/dev-server/build-development-openapi-document.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/build-development-openapi-document.ts
+//#region ../../packages/core/src/dev-server/build-development-openapi-document.ts
 const warned = /* @__PURE__ */ new Set();
 /**
 * Build the OpenAPI document from the routes registered in THIS process, for the dev server.

package/esm/dev-server/build-development-openapi-document.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-development-openapi-document.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/build-development-openapi-document.ts"],"sourcesContent":["import type { OpenApiBuildResult } from \"../openapi/types\";\n\nconst warned = new Set<string>();\n\n/**\n * Build the OpenAPI document from the routes registered in THIS process, for the dev server.\n *\n * `warlock dev` has already loaded every route module, so no child process is needed: this\n * runs the same `buildOpenApiForChild` the `generate.openapi` child runs (same resource\n * export map, `package.json` info, `http` server and `validation.response` config), with the\n * dev server's file list. Each distinct warning is logged once per process, not on every\n * request to the docs page.\n *\n * Lives under `dev-server/`, off the production entry: the dev server registers it as the\n * development OpenAPI provider (`registerDevelopmentOpenApiProvider`), and devtools reads it\n * through `getDevelopmentOpenApiDocument()` from the root barrel.\n */\nexport async function buildDevelopmentOpenApiDocument(): Promise<OpenApiBuildResult> {\n  const [{ filesOrchestrator }, { devLogWarn }, { buildOpenApiForChild }] = await Promise.all([\n    import(\"./files-orchestrator\"),\n    import(\"./dev-logger\"),\n    import(\"../openapi/openapi-child-output\"),\n  ]);\n\n  return buildOpenApiForChild({\n    cwd: process.cwd(),\n    files: filesOrchestrator.getFiles().values(),\n    request: { version: 1 },\n    onWarn: (message) => {\n      if (warned.has(message)) return;\n\n      warned.add(message);\n      devLogWarn(message);\n    },\n  });\n}\n"],"mappings":";AAEA,MAAM,yBAAS,IAAI,IAAY;;;;;;;;;;;;;;AAe/B,eAAsB,kCAA+D;CACnF,MAAM,CAAC,EAAE,qBAAqB,EAAE,cAAc,EAAE,0BAA0B,MAAM,QAAQ,IAAI;EAC1F,OAAO;EACP,OAAO;EACP,OAAO;CACT,CAAC;CAED,OAAO,qBAAqB;EAC1B,KAAK,QAAQ,IAAI;EACjB,OAAO,kBAAkB,SAAS,CAAC,CAAC,OAAO;EAC3C,SAAS,EAAE,SAAS,EAAE;EACtB,SAAS,YAAY;GACnB,IAAI,OAAO,IAAI,OAAO,GAAG;GAEzB,OAAO,IAAI,OAAO;GAClB,WAAW,OAAO;EACpB;CACF,CAAC;AACH"}
+{"version":3,"file":"build-development-openapi-document.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/build-development-openapi-document.ts"],"sourcesContent":["import type { OpenApiBuildResult } from \"../openapi/types\";\n\nconst warned = new Set<string>();\n\n/**\n * Build the OpenAPI document from the routes registered in THIS process, for the dev server.\n *\n * `warlock dev` has already loaded every route module, so no child process is needed: this\n * runs the same `buildOpenApiForChild` the `generate.openapi` child runs (same resource\n * export map, `package.json` info, `http` server and `validation.response` config), with the\n * dev server's file list. Each distinct warning is logged once per process, not on every\n * request to the docs page.\n *\n * Lives under `dev-server/`, off the production entry: the dev server registers it as the\n * development OpenAPI provider (`registerDevelopmentOpenApiProvider`), and devtools reads it\n * through `getDevelopmentOpenApiDocument()` from the root barrel.\n */\nexport async function buildDevelopmentOpenApiDocument(): Promise<OpenApiBuildResult> {\n  const [{ filesOrchestrator }, { devLogWarn }, { buildOpenApiForChild }] = await Promise.all([\n    import(\"./files-orchestrator\"),\n    import(\"./dev-logger\"),\n    import(\"../openapi/openapi-child-output\"),\n  ]);\n\n  return buildOpenApiForChild({\n    cwd: process.cwd(),\n    files: filesOrchestrator.getFiles().values(),\n    request: { version: 1 },\n    onWarn: (message) => {\n      if (warned.has(message)) return;\n\n      warned.add(message);\n      devLogWarn(message);\n    },\n  });\n}\n"],"mappings":";AAEA,MAAM,yBAAS,IAAI,IAAY;;;;;;;;;;;;;;AAe/B,eAAsB,kCAA+D;CACnF,MAAM,CAAC,EAAE,qBAAqB,EAAE,cAAc,EAAE,0BAA0B,MAAM,QAAQ,IAAI;EAC1F,OAAO;EACP,OAAO;EACP,OAAO;CACT,CAAC;CAED,OAAO,qBAAqB;EAC1B,KAAK,QAAQ,IAAI;EACjB,OAAO,kBAAkB,SAAS,CAAC,CAAC,OAAO;EAC3C,SAAS,EAAE,SAAS,EAAE;EACtB,SAAS,YAAY;GACnB,IAAI,OAAO,IAAI,OAAO,GAAG;GAEzB,OAAO,IAAI,OAAO;GAClB,WAAW,OAAO;EACpB;CACF,CAAC;AACH"}

package/esm/dev-server/check-for-updates.mjs

@@ -9,7 +9,7 @@ import { devServerShortcuts } from "./shortcuts.mjs";
 import { clearCachedLatestVersion, readCachedLatestVersion, writeCachedLatestVersion } from "./update-check-cache.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/dev-server/check-for-updates.ts
+//#region ../../packages/core/src/dev-server/check-for-updates.ts
 /** The package whose version represents the whole (lockstep) family. */
 const CORE_PACKAGE = "@warlock.js/core";
 /** Where developers can read what changed between releases. */

package/esm/dev-server/check-for-updates.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"check-for-updates.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/check-for-updates.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { updateWarlockPackages } from \"../updater/update-warlock-packages\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport type { DevelopmentServer } from \"./development-server\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport {\n  clearCachedLatestVersion,\n  readCachedLatestVersion,\n  writeCachedLatestVersion,\n} from \"./update-check-cache\";\n\n/** The package whose version represents the whole (lockstep) family. */\nconst CORE_PACKAGE = \"@warlock.js/core\";\n\n/** Where developers can read what changed between releases. */\nconst CHANGELOG_URL = \"https://warlock.js.org/changelog/\";\n\n/** The key that applies the update without leaving the dev server. */\nconst UPDATE_SHORTCUT_KEY = \"u\";\n\n/**\n * Abort budget for the notice's registry lookup. Deliberately much shorter\n * than the `warlock update` command's: nobody is waiting on this answer, and\n * a network that hangs (captive portal, dead VPN, flaky DNS) must not leave a\n * pending request and a live timer sitting around behind a running dev server.\n */\nconst UPDATE_CHECK_TIMEOUT_MS = 5_000;\n\n/**\n * Check npm for a newer `@warlock.js/core` release and, if one exists, print\n * a short non-blocking notice to the terminal. Because the whole family is\n * released in lockstep, core's version stands in for every `@warlock.js/*`\n * package, so a single lookup is enough.\n *\n * When a `devServer` is passed and the terminal is interactive, the notice\n * also arms the `u` shortcut: one keypress updates every `@warlock.js/*`\n * dependency, installs, and restarts the server.\n *\n * Designed to be called fire-and-forget once the dev server is ready: it\n * never throws, never blocks startup, and stays silent unless there is a\n * genuinely newer version to report. Automatically skipped in CI, in\n * non-interactive (non-TTY) shells, and when `devServer.checkForUpdates` is\n * set to `false`.\n */\nexport async function checkForFrameworkUpdate(devServer?: DevelopmentServer): Promise<void> {\n  try {\n    if (!isUpdateCheckEnabled()) {\n      return;\n    }\n\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.checkForUpdates === false) {\n      return;\n    }\n\n    const currentVersion = await getWarlockVersion();\n    const latestVersion = await resolveLatestVersion();\n\n    if (!latestVersion || !isNewerVersion(latestVersion, currentVersion)) {\n      return;\n    }\n\n    printUpdateNotice(currentVersion, latestVersion, offerUpdateShortcut(devServer));\n  } catch {\n    // An update check is a convenience — never let it disrupt the dev server.\n  }\n}\n\n/**\n * The latest published core version, preferring a recent cached answer over a\n * network round-trip. Every `warlock dev` boot would otherwise hit npm, which\n * is a lot of traffic for a question whose answer changes a few times a month.\n */\nasync function resolveLatestVersion(): Promise<string | undefined> {\n  const cached = await readCachedLatestVersion();\n\n  if (cached) {\n    return cached;\n  }\n\n  const latestVersion = await fetchLatestVersion(CORE_PACKAGE, UPDATE_CHECK_TIMEOUT_MS);\n\n  // A failed lookup is deliberately NOT cached as \"no version\" — that would\n  // silence the notice for a day over one flaky moment. Only real answers are\n  // remembered; offline simply re-asks next boot.\n  if (latestVersion) {\n    await writeCachedLatestVersion(latestVersion);\n  }\n\n  return latestVersion;\n}\n\n/**\n * Whether an update check should run at all in the current environment.\n * Mirrors npm's own update-notifier conventions: stay quiet in CI, in\n * non-interactive shells, and when explicitly opted out via env.\n */\nfunction isUpdateCheckEnabled(): boolean {\n  if (process.env.CI) {\n    return false;\n  }\n\n  if (process.env.NO_UPDATE_NOTIFIER) {\n    return false;\n  }\n\n  if (!process.stdout.isTTY) {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Arm the `u` shortcut, if there is a server to restart and a terminal that\n * can deliver keypresses. Returns whether the notice may advertise it.\n */\nfunction offerUpdateShortcut(devServer?: DevelopmentServer): boolean {\n  if (!devServer) {\n    return false;\n  }\n\n  return devServerShortcuts.register({\n    key: UPDATE_SHORTCUT_KEY,\n    description: \"update @warlock.js packages and restart\",\n    handler: () => updateAndRestart(devServer),\n  });\n}\n\n/**\n * The `u` handler: rewrite the `@warlock.js/*` versions, install them, and\n * come back up on the new ones.\n *\n * The shortcut is dropped and the terminal released first, so the package\n * manager child owns stdin (and a second `u` can't stack a parallel install).\n * Releasing has to be explicit: the standing shortcut bar keeps other keys\n * registered, so dropping `u` alone would leave us in raw mode.\n *\n * The terminal is taken back — and `u` re-armed — only for the cases worth\n * retrying: an unreachable registry, or a restart that could not be started.\n */\nasync function updateAndRestart(devServer: DevelopmentServer): Promise<void> {\n  devServerShortcuts.unregister(UPDATE_SHORTCUT_KEY);\n  devServerShortcuts.release();\n\n  console.log();\n\n  const result = await updateWarlockPackages();\n\n  if (result.outcome === \"updated\") {\n    // The remembered answer described the version we just replaced.\n    await clearCachedLatestVersion();\n\n    const restarted = await restartDevServer(devServer);\n\n    if (!restarted) {\n      devServerShortcuts.resume();\n      console.log(`     ${colors.dim(\"Restart the dev server manually to load the new version.\")}`);\n    }\n\n    return;\n  }\n\n  devServerShortcuts.resume();\n\n  if (result.outcome === \"registry-unreachable\") {\n    printShortcutRetryHint();\n    offerUpdateShortcut(devServer);\n    return;\n  }\n\n  // Anything else — a failed install, or a notice that turned out to be stale —\n  // leaves the shortcut off on purpose: package.json is already rewritten, so a\n  // second `u` would just report \"up to date\" and hide the real problem.\n}\n\n/**\n * Print the \"update available\" notice in the dev-logger's visual style.\n *\n * @param canPressKey Whether the `u` shortcut is armed. When it is not (piped\n *                    stdin, CI, a supervisor), fall back to the command the\n *                    developer can run by hand.\n */\nfunction printUpdateNotice(\n  currentVersion: string,\n  latestVersion: string,\n  canPressKey: boolean,\n): void {\n  console.log();\n  console.log(\n    `  ${colors.yellow(\"⚡\")} ${colors.bold(\"A new version of Warlock.js is available\")}  ` +\n      `${colors.dim(currentVersion)} ${colors.dim(\"→\")} ${colors.greenBright(latestVersion)}`,\n  );\n\n  if (canPressKey) {\n    console.log(\n      `     ${colors.dim(\"Press\")} ${colors.bold(colors.cyan(UPDATE_SHORTCUT_KEY))} ` +\n        `${colors.dim(\"to update all @warlock.js packages and restart\")}`,\n    );\n  } else {\n    console.log(\n      `     ${colors.dim(\"Run\")} ${colors.cyan(\"npx warlock update\")} ` +\n        `${colors.dim(\"to update all @warlock.js packages\")}`,\n    );\n  }\n\n  console.log(`     ${colors.dim(\"Changelog\")} ${colors.cyan(CHANGELOG_URL)}`);\n  console.log();\n}\n\n/** Tell the developer the shortcut is still available after a failed try. */\nfunction printShortcutRetryHint(): void {\n  console.log(\n    `     ${colors.dim(\"Press\")} ${colors.bold(colors.cyan(UPDATE_SHORTCUT_KEY))} ` +\n      `${colors.dim(\"to try again once you are back online\")}`,\n  );\n  console.log();\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,eAAe;;AAGrB,MAAM,gBAAgB;;AAGtB,MAAM,sBAAsB;;;;;;;AAQ5B,MAAM,0BAA0B;;;;;;;;;;;;;;;;;AAkBhC,eAAsB,wBAAwB,WAA8C;CAC1F,IAAI;EACF,IAAI,CAAC,qBAAqB,GACxB;EAKF,KAAI,MAF0B,qBAAqB,IAAI,WAAW,EAE/C,EAAE,oBAAoB,OACvC;EAGF,MAAM,iBAAiB,MAAM,kBAAkB;EAC/C,MAAM,gBAAgB,MAAM,qBAAqB;EAEjD,IAAI,CAAC,iBAAiB,CAAC,eAAe,eAAe,cAAc,GACjE;EAGF,kBAAkB,gBAAgB,eAAe,oBAAoB,SAAS,CAAC;CACjF,QAAQ,CAER;AACF;;;;;;AAOA,eAAe,uBAAoD;CACjE,MAAM,SAAS,MAAM,wBAAwB;CAE7C,IAAI,QACF,OAAO;CAGT,MAAM,gBAAgB,MAAM,mBAAmB,cAAc,uBAAuB;CAKpF,IAAI,eACF,MAAM,yBAAyB,aAAa;CAG9C,OAAO;AACT;;;;;;AAOA,SAAS,uBAAgC;CACvC,IAAI,QAAQ,IAAI,IACd,OAAO;CAGT,IAAI,QAAQ,IAAI,oBACd,OAAO;CAGT,IAAI,CAAC,QAAQ,OAAO,OAClB,OAAO;CAGT,OAAO;AACT;;;;;AAMA,SAAS,oBAAoB,WAAwC;CACnE,IAAI,CAAC,WACH,OAAO;CAGT,OAAO,mBAAmB,SAAS;EACjC,KAAK;EACL,aAAa;EACb,eAAe,iBAAiB,SAAS;CAC3C,CAAC;AACH;;;;;;;;;;;;;AAcA,eAAe,iBAAiB,WAA6C;CAC3E,mBAAmB,WAAW,mBAAmB;CACjD,mBAAmB,QAAQ;CAE3B,QAAQ,IAAI;CAEZ,MAAM,SAAS,MAAM,sBAAsB;CAE3C,IAAI,OAAO,YAAY,WAAW;EAEhC,MAAM,yBAAyB;EAI/B,IAAI,CAAC,MAFmB,iBAAiB,SAAS,GAElC;GACd,mBAAmB,OAAO;GAC1B,QAAQ,IAAI,QAAQ,OAAO,IAAI,0DAA0D,GAAG;EAC9F;EAEA;CACF;CAEA,mBAAmB,OAAO;CAE1B,IAAI,OAAO,YAAY,wBAAwB;EAC7C,uBAAuB;EACvB,oBAAoB,SAAS;EAC7B;CACF;AAKF;;;;;;;;AASA,SAAS,kBACP,gBACA,eACA,aACM;CACN,QAAQ,IAAI;CACZ,QAAQ,IACN,KAAK,OAAO,OAAO,GAAG,EAAE,GAAG,OAAO,KAAK,0CAA0C,EAAE,IAC9E,OAAO,IAAI,cAAc,EAAE,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,OAAO,YAAY,aAAa,GACxF;CAEA,IAAI,aACF,QAAQ,IACN,QAAQ,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,KAAK,OAAO,KAAK,mBAAmB,CAAC,EAAE,GACxE,OAAO,IAAI,gDAAgD,GAClE;MAEA,QAAQ,IACN,QAAQ,OAAO,IAAI,KAAK,EAAE,GAAG,OAAO,KAAK,oBAAoB,EAAE,GAC1D,OAAO,IAAI,oCAAoC,GACtD;CAGF,QAAQ,IAAI,QAAQ,OAAO,IAAI,WAAW,EAAE,GAAG,OAAO,KAAK,aAAa,GAAG;CAC3E,QAAQ,IAAI;AACd;;AAGA,SAAS,yBAA+B;CACtC,QAAQ,IACN,QAAQ,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,KAAK,OAAO,KAAK,mBAAmB,CAAC,EAAE,GACxE,OAAO,IAAI,uCAAuC,GACzD;CACA,QAAQ,IAAI;AACd"}
+{"version":3,"file":"check-for-updates.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/check-for-updates.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { updateWarlockPackages } from \"../updater/update-warlock-packages\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport type { DevelopmentServer } from \"./development-server\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport {\n  clearCachedLatestVersion,\n  readCachedLatestVersion,\n  writeCachedLatestVersion,\n} from \"./update-check-cache\";\n\n/** The package whose version represents the whole (lockstep) family. */\nconst CORE_PACKAGE = \"@warlock.js/core\";\n\n/** Where developers can read what changed between releases. */\nconst CHANGELOG_URL = \"https://warlock.js.org/changelog/\";\n\n/** The key that applies the update without leaving the dev server. */\nconst UPDATE_SHORTCUT_KEY = \"u\";\n\n/**\n * Abort budget for the notice's registry lookup. Deliberately much shorter\n * than the `warlock update` command's: nobody is waiting on this answer, and\n * a network that hangs (captive portal, dead VPN, flaky DNS) must not leave a\n * pending request and a live timer sitting around behind a running dev server.\n */\nconst UPDATE_CHECK_TIMEOUT_MS = 5_000;\n\n/**\n * Check npm for a newer `@warlock.js/core` release and, if one exists, print\n * a short non-blocking notice to the terminal. Because the whole family is\n * released in lockstep, core's version stands in for every `@warlock.js/*`\n * package, so a single lookup is enough.\n *\n * When a `devServer` is passed and the terminal is interactive, the notice\n * also arms the `u` shortcut: one keypress updates every `@warlock.js/*`\n * dependency, installs, and restarts the server.\n *\n * Designed to be called fire-and-forget once the dev server is ready: it\n * never throws, never blocks startup, and stays silent unless there is a\n * genuinely newer version to report. Automatically skipped in CI, in\n * non-interactive (non-TTY) shells, and when `devServer.checkForUpdates` is\n * set to `false`.\n */\nexport async function checkForFrameworkUpdate(devServer?: DevelopmentServer): Promise<void> {\n  try {\n    if (!isUpdateCheckEnabled()) {\n      return;\n    }\n\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.checkForUpdates === false) {\n      return;\n    }\n\n    const currentVersion = await getWarlockVersion();\n    const latestVersion = await resolveLatestVersion();\n\n    if (!latestVersion || !isNewerVersion(latestVersion, currentVersion)) {\n      return;\n    }\n\n    printUpdateNotice(currentVersion, latestVersion, offerUpdateShortcut(devServer));\n  } catch {\n    // An update check is a convenience — never let it disrupt the dev server.\n  }\n}\n\n/**\n * The latest published core version, preferring a recent cached answer over a\n * network round-trip. Every `warlock dev` boot would otherwise hit npm, which\n * is a lot of traffic for a question whose answer changes a few times a month.\n */\nasync function resolveLatestVersion(): Promise<string | undefined> {\n  const cached = await readCachedLatestVersion();\n\n  if (cached) {\n    return cached;\n  }\n\n  const latestVersion = await fetchLatestVersion(CORE_PACKAGE, UPDATE_CHECK_TIMEOUT_MS);\n\n  // A failed lookup is deliberately NOT cached as \"no version\" — that would\n  // silence the notice for a day over one flaky moment. Only real answers are\n  // remembered; offline simply re-asks next boot.\n  if (latestVersion) {\n    await writeCachedLatestVersion(latestVersion);\n  }\n\n  return latestVersion;\n}\n\n/**\n * Whether an update check should run at all in the current environment.\n * Mirrors npm's own update-notifier conventions: stay quiet in CI, in\n * non-interactive shells, and when explicitly opted out via env.\n */\nfunction isUpdateCheckEnabled(): boolean {\n  if (process.env.CI) {\n    return false;\n  }\n\n  if (process.env.NO_UPDATE_NOTIFIER) {\n    return false;\n  }\n\n  if (!process.stdout.isTTY) {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Arm the `u` shortcut, if there is a server to restart and a terminal that\n * can deliver keypresses. Returns whether the notice may advertise it.\n */\nfunction offerUpdateShortcut(devServer?: DevelopmentServer): boolean {\n  if (!devServer) {\n    return false;\n  }\n\n  return devServerShortcuts.register({\n    key: UPDATE_SHORTCUT_KEY,\n    description: \"update @warlock.js packages and restart\",\n    handler: () => updateAndRestart(devServer),\n  });\n}\n\n/**\n * The `u` handler: rewrite the `@warlock.js/*` versions, install them, and\n * come back up on the new ones.\n *\n * The shortcut is dropped and the terminal released first, so the package\n * manager child owns stdin (and a second `u` can't stack a parallel install).\n * Releasing has to be explicit: the standing shortcut bar keeps other keys\n * registered, so dropping `u` alone would leave us in raw mode.\n *\n * The terminal is taken back — and `u` re-armed — only for the cases worth\n * retrying: an unreachable registry, or a restart that could not be started.\n */\nasync function updateAndRestart(devServer: DevelopmentServer): Promise<void> {\n  devServerShortcuts.unregister(UPDATE_SHORTCUT_KEY);\n  devServerShortcuts.release();\n\n  console.log();\n\n  const result = await updateWarlockPackages();\n\n  if (result.outcome === \"updated\") {\n    // The remembered answer described the version we just replaced.\n    await clearCachedLatestVersion();\n\n    const restarted = await restartDevServer(devServer);\n\n    if (!restarted) {\n      devServerShortcuts.resume();\n      console.log(`     ${colors.dim(\"Restart the dev server manually to load the new version.\")}`);\n    }\n\n    return;\n  }\n\n  devServerShortcuts.resume();\n\n  if (result.outcome === \"registry-unreachable\") {\n    printShortcutRetryHint();\n    offerUpdateShortcut(devServer);\n    return;\n  }\n\n  // Anything else — a failed install, or a notice that turned out to be stale —\n  // leaves the shortcut off on purpose: package.json is already rewritten, so a\n  // second `u` would just report \"up to date\" and hide the real problem.\n}\n\n/**\n * Print the \"update available\" notice in the dev-logger's visual style.\n *\n * @param canPressKey Whether the `u` shortcut is armed. When it is not (piped\n *                    stdin, CI, a supervisor), fall back to the command the\n *                    developer can run by hand.\n */\nfunction printUpdateNotice(\n  currentVersion: string,\n  latestVersion: string,\n  canPressKey: boolean,\n): void {\n  console.log();\n  console.log(\n    `  ${colors.yellow(\"⚡\")} ${colors.bold(\"A new version of Warlock.js is available\")}  ` +\n      `${colors.dim(currentVersion)} ${colors.dim(\"→\")} ${colors.greenBright(latestVersion)}`,\n  );\n\n  if (canPressKey) {\n    console.log(\n      `     ${colors.dim(\"Press\")} ${colors.bold(colors.cyan(UPDATE_SHORTCUT_KEY))} ` +\n        `${colors.dim(\"to update all @warlock.js packages and restart\")}`,\n    );\n  } else {\n    console.log(\n      `     ${colors.dim(\"Run\")} ${colors.cyan(\"npx warlock update\")} ` +\n        `${colors.dim(\"to update all @warlock.js packages\")}`,\n    );\n  }\n\n  console.log(`     ${colors.dim(\"Changelog\")} ${colors.cyan(CHANGELOG_URL)}`);\n  console.log();\n}\n\n/** Tell the developer the shortcut is still available after a failed try. */\nfunction printShortcutRetryHint(): void {\n  console.log(\n    `     ${colors.dim(\"Press\")} ${colors.bold(colors.cyan(UPDATE_SHORTCUT_KEY))} ` +\n      `${colors.dim(\"to try again once you are back online\")}`,\n  );\n  console.log();\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,eAAe;;AAGrB,MAAM,gBAAgB;;AAGtB,MAAM,sBAAsB;;;;;;;AAQ5B,MAAM,0BAA0B;;;;;;;;;;;;;;;;;AAkBhC,eAAsB,wBAAwB,WAA8C;CAC1F,IAAI;EACF,IAAI,CAAC,qBAAqB,GACxB;EAKF,KAAI,MAF0B,qBAAqB,IAAI,WAAW,EAE/C,EAAE,oBAAoB,OACvC;EAGF,MAAM,iBAAiB,MAAM,kBAAkB;EAC/C,MAAM,gBAAgB,MAAM,qBAAqB;EAEjD,IAAI,CAAC,iBAAiB,CAAC,eAAe,eAAe,cAAc,GACjE;EAGF,kBAAkB,gBAAgB,eAAe,oBAAoB,SAAS,CAAC;CACjF,QAAQ,CAER;AACF;;;;;;AAOA,eAAe,uBAAoD;CACjE,MAAM,SAAS,MAAM,wBAAwB;CAE7C,IAAI,QACF,OAAO;CAGT,MAAM,gBAAgB,MAAM,mBAAmB,cAAc,uBAAuB;CAKpF,IAAI,eACF,MAAM,yBAAyB,aAAa;CAG9C,OAAO;AACT;;;;;;AAOA,SAAS,uBAAgC;CACvC,IAAI,QAAQ,IAAI,IACd,OAAO;CAGT,IAAI,QAAQ,IAAI,oBACd,OAAO;CAGT,IAAI,CAAC,QAAQ,OAAO,OAClB,OAAO;CAGT,OAAO;AACT;;;;;AAMA,SAAS,oBAAoB,WAAwC;CACnE,IAAI,CAAC,WACH,OAAO;CAGT,OAAO,mBAAmB,SAAS;EACjC,KAAK;EACL,aAAa;EACb,eAAe,iBAAiB,SAAS;CAC3C,CAAC;AACH;;;;;;;;;;;;;AAcA,eAAe,iBAAiB,WAA6C;CAC3E,mBAAmB,WAAW,mBAAmB;CACjD,mBAAmB,QAAQ;CAE3B,QAAQ,IAAI;CAEZ,MAAM,SAAS,MAAM,sBAAsB;CAE3C,IAAI,OAAO,YAAY,WAAW;EAEhC,MAAM,yBAAyB;EAI/B,IAAI,CAAC,MAFmB,iBAAiB,SAAS,GAElC;GACd,mBAAmB,OAAO;GAC1B,QAAQ,IAAI,QAAQ,OAAO,IAAI,0DAA0D,GAAG;EAC9F;EAEA;CACF;CAEA,mBAAmB,OAAO;CAE1B,IAAI,OAAO,YAAY,wBAAwB;EAC7C,uBAAuB;EACvB,oBAAoB,SAAS;EAC7B;CACF;AAKF;;;;;;;;AASA,SAAS,kBACP,gBACA,eACA,aACM;CACN,QAAQ,IAAI;CACZ,QAAQ,IACN,KAAK,OAAO,OAAO,GAAG,EAAE,GAAG,OAAO,KAAK,0CAA0C,EAAE,IAC9E,OAAO,IAAI,cAAc,EAAE,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,OAAO,YAAY,aAAa,GACxF;CAEA,IAAI,aACF,QAAQ,IACN,QAAQ,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,KAAK,OAAO,KAAK,mBAAmB,CAAC,EAAE,GACxE,OAAO,IAAI,gDAAgD,GAClE;MAEA,QAAQ,IACN,QAAQ,OAAO,IAAI,KAAK,EAAE,GAAG,OAAO,KAAK,oBAAoB,EAAE,GAC1D,OAAO,IAAI,oCAAoC,GACtD;CAGF,QAAQ,IAAI,QAAQ,OAAO,IAAI,WAAW,EAAE,GAAG,OAAO,KAAK,aAAa,GAAG;CAC3E,QAAQ,IAAI;AACd;;AAGA,SAAS,yBAA+B;CACtC,QAAQ,IACN,QAAQ,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,KAAK,OAAO,KAAK,mBAAmB,CAAC,EAAE,GACxE,OAAO,IAAI,uCAAuC,GACzD;CACA,QAAQ,IAAI;AACd"}

package/esm/dev-server/collect-development-api-routes.mjs

@@ -2,7 +2,7 @@ import { devLogWarn } from "./dev-logger.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { collectNamedApiRoutesWithResponses } from "../router/named-api-routes-with-responses.mjs";
 
-//#region ../core/src/dev-server/collect-development-api-routes.ts
+//#region ../../packages/core/src/dev-server/collect-development-api-routes.ts
 const warned = /* @__PURE__ */ new Set();
 /**
 * Named API routes for the dev server's in-process route-type publisher. Uses the same

package/esm/dev-server/collect-development-api-routes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-development-api-routes.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/collect-development-api-routes.ts"],"sourcesContent":["import { collectNamedApiRoutesWithResponses } from \"../router/named-api-routes-with-responses\";\nimport type { NamedApiRoute } from \"../router/types\";\nimport { devLogWarn } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\n\nconst warned = new Set<string>();\n\n/**\n * Named API routes for the dev server's in-process route-type publisher. Uses the same\n * serializer as the typings child process, so `response` strings never differ between\n * `warlock dev` and `warlock generate.typings`. Each distinct warning is logged once per\n * process, not on every hot reload.\n */\nexport function collectDevelopmentApiRoutes(): Promise<readonly NamedApiRoute[]> {\n  return collectNamedApiRoutesWithResponses({\n    appRoot: process.cwd(),\n    files: filesOrchestrator.getFiles().values(),\n    onWarn: (message) => {\n      if (warned.has(message)) return;\n\n      warned.add(message);\n      devLogWarn(message);\n    },\n  });\n}\n"],"mappings":";;;;;AAKA,MAAM,yBAAS,IAAI,IAAY;;;;;;;AAQ/B,SAAgB,8BAAiE;CAC/E,OAAO,mCAAmC;EACxC,SAAS,QAAQ,IAAI;EACrB,OAAO,kBAAkB,SAAS,CAAC,CAAC,OAAO;EAC3C,SAAS,YAAY;GACnB,IAAI,OAAO,IAAI,OAAO,GAAG;GAEzB,OAAO,IAAI,OAAO;GAClB,WAAW,OAAO;EACpB;CACF,CAAC;AACH"}
+{"version":3,"file":"collect-development-api-routes.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/collect-development-api-routes.ts"],"sourcesContent":["import { collectNamedApiRoutesWithResponses } from \"../router/named-api-routes-with-responses\";\nimport type { NamedApiRoute } from \"../router/types\";\nimport { devLogWarn } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\n\nconst warned = new Set<string>();\n\n/**\n * Named API routes for the dev server's in-process route-type publisher. Uses the same\n * serializer as the typings child process, so `response` strings never differ between\n * `warlock dev` and `warlock generate.typings`. Each distinct warning is logged once per\n * process, not on every hot reload.\n */\nexport function collectDevelopmentApiRoutes(): Promise<readonly NamedApiRoute[]> {\n  return collectNamedApiRoutesWithResponses({\n    appRoot: process.cwd(),\n    files: filesOrchestrator.getFiles().values(),\n    onWarn: (message) => {\n      if (warned.has(message)) return;\n\n      warned.add(message);\n      devLogWarn(message);\n    },\n  });\n}\n"],"mappings":";;;;;AAKA,MAAM,yBAAS,IAAI,IAAY;;;;;;;AAQ/B,SAAgB,8BAAiE;CAC/E,OAAO,mCAAmC;EACxC,SAAS,QAAQ,IAAI;EACrB,OAAO,kBAAkB,SAAS,CAAC,CAAC,OAAO;EAC3C,SAAS,YAAY;GACnB,IAAI,OAAO,IAAI,OAAO,GAAG;GAEzB,OAAO,IAAI,OAAO;GAClB,WAAW,OAAO;EACpB;CACF,CAAC;AACH"}

package/esm/dev-server/create-worker.mjs

@@ -1,14 +1,17 @@
+import { createRequire } from "node:module";
 import path from "node:path";
-import { fileURLToPath } from "url";
+import { pathToFileURL } from "node:url";
+import { fileURLToPath as fileURLToPath$1 } from "url";
 import { Worker } from "worker_threads";
 
-//#region ../core/src/dev-server/create-worker.ts
+//#region ../../packages/core/src/dev-server/create-worker.ts
 /**
 * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.
 *
 * The worker shares the CALLING module's extension: `.ts` when core runs from
 * source (loaded via tsx), `.mjs` when core is published. Source workers are
-* run through the tsx loader; published `.mjs` workers run as-is.
+* loaded through tsx's `tsImport` API from a JavaScript bootstrap; published
+* `.mjs` workers run as-is.
 *
 * @param workerPath - Relative path to worker file WITHOUT extension (e.g., "./workers/ts-health.worker")
 * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)
@@ -26,15 +29,18 @@ import { Worker } from "worker_threads";
 * ```
 */
 function createWorker(workerPath, baseUrl, options) {
-	const callerExtension = path.extname(fileURLToPath(baseUrl));
+	const callerExtension = path.extname(fileURLToPath$1(baseUrl));
 	const isSource = callerExtension === ".ts" || callerExtension === ".tsx";
-	const workerFilePath = fileURLToPath(new URL(`${workerPath}${callerExtension}`, baseUrl));
+	const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);
+	const workerFilePath = fileURLToPath$1(workerUrl);
 	const workerOptions = { ...options };
-	if (isSource) workerOptions.execArgv = [
-		...options?.execArgv || [],
-		"--import",
-		"tsx/esm"
-	];
+	if (isSource) {
+		const tsxApi = pathToFileURL(createRequire(import.meta.url).resolve("tsx/esm/api")).href;
+		return new Worker(`import(${JSON.stringify(tsxApi)}).then(({ tsImport }) => tsImport(${JSON.stringify(workerUrl.href)}, ${JSON.stringify(baseUrl)}));`, {
+			...workerOptions,
+			eval: true
+		});
+	}
 	return new Worker(workerFilePath, workerOptions);
 }
 

package/esm/dev-server/create-worker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-worker.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * run through the tsx loader; published `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  // Source workers are TypeScript — run them through the tsx loader.\n  if (isSource) {\n    workerOptions.execArgv = [...(options?.execArgv || []), \"--import\", \"tsx/esm\"];\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQ,cAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAElE,MAAM,iBAAiB,cAAc,IADf,IAAI,GAAG,aAAa,mBAAmB,OAChB,CAAC;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAGA,IAAI,UACF,cAAc,WAAW;EAAC,GAAI,SAAS,YAAY,CAAC;EAAI;EAAY;CAAS;CAG/E,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}
+{"version":3,"file":"create-worker.mjs","names":["fileURLToPath"],"sources":["../../../../../../../../packages/core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport { pathToFileURL } from \"node:url\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * loaded through tsx's `tsImport` API from a JavaScript bootstrap; published\n * `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  if (isSource) {\n    // Node 22.15 resolves a worker's entry before tsx's --import hook can\n    // handle its .ts extension. Bootstrap JS, then load the entry through\n    // tsx's supported API instead. Resolve from core, even when the app does\n    // not depend on tsx directly.\n    const require = createRequire(import.meta.url);\n    const tsxApi = pathToFileURL(require.resolve(\"tsx/esm/api\")).href;\n    const bootstrap = `import(${JSON.stringify(tsxApi)}).then(({ tsImport }) => tsImport(${JSON.stringify(workerUrl.href)}, ${JSON.stringify(baseUrl)}));`;\n    return new Worker(bootstrap, { ...workerOptions, eval: true });\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQA,gBAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAClE,MAAM,YAAY,IAAI,IAAI,GAAG,aAAa,mBAAmB,OAAO;CACpE,MAAM,iBAAiBA,gBAAc,SAAS;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAEA,IAAI,UAAU;EAMZ,MAAM,SAAS,cADC,cAAc,OAAO,KAAK,GACP,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,CAAC;EAE7D,OAAO,IAAI,OAAO,UADU,KAAK,UAAU,MAAM,EAAE,oCAAoC,KAAK,UAAU,UAAU,IAAI,EAAE,IAAI,KAAK,UAAU,OAAO,EAAE,MACrH;GAAE,GAAG;GAAe,MAAM;EAAK,CAAC;CAC/D;CAEA,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}

package/esm/dev-server/dependency-graph.d.mts

@@ -1,6 +1,6 @@
 import { FileManager } from "./file-manager.mjs";
 
-//#region ../core/src/dev-server/dependency-graph.d.ts
+//#region ../../packages/core/src/dev-server/dependency-graph.d.ts
 /**
  * Dependency Graph
  * Tracks bidirectional relationships between files:

package/esm/dev-server/dependency-graph.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-graph.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/dependency-graph.ts"],"mappings":";;;;;AAYA;;;;;;;;cAAa,eAAA;EA0L4B;;;;;EAAA,QApL/B,YAAA;EAkBY;;;;;EAAA,QAXZ,UAAA;EAiD+C;;;;EAAA,QA3C/C,KAAA;EA8EU;;;EAzEX,KAAA,CAAM,KAAA,EAAO,GAAA,SAAY,WAAA;EA2G9B;;;;;;;;;EArEK,aAAA,CAAc,IAAA,UAAc,UAAA,UAAoB,UAAA;EA4HlC;;;;;EAlGd,gBAAA,CAAiB,IAAA,UAAc,UAAA;EA+M9B;;;;EAtMD,UAAA,CAAW,IAAA;;;;;;;;;;;;EAgCX,UAAA,CACL,IAAA,UACA,eAAA,EAAiB,GAAA,UACjB,oBAAA,GAAsB,GAAA;;;;;;EA+BjB,eAAA,CAAgB,IAAA,WAAe,GAAA;;;;;EAc/B,cAAA,CAAe,IAAA,UAAc,UAAA;;;;;;EAS7B,aAAA,CAAc,IAAA,WAAe,GAAA;;;;;;;;EAW7B,oBAAA,CAAqB,IAAA;;;;;;;;;;;;;EA+BrB,0BAAA;;;;;;;UA2CC,cAAA;;;;;UAwBA,iCAAA;;;;EAwGD,QAAA"}
+{"version":3,"file":"dependency-graph.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"mappings":";;;;;AAYA;;;;;;;;cAAa,eAAA;EA0L4B;;;;;EAAA,QApL/B,YAAA;EAkBY;;;;;EAAA,QAXZ,UAAA;EAiD+C;;;;EAAA,QA3C/C,KAAA;EA8EU;;;EAzEX,KAAA,CAAM,KAAA,EAAO,GAAA,SAAY,WAAA;EA2G9B;;;;;;;;;EArEK,aAAA,CAAc,IAAA,UAAc,UAAA,UAAoB,UAAA;EA4HlC;;;;;EAlGd,gBAAA,CAAiB,IAAA,UAAc,UAAA;EA+M9B;;;;EAtMD,UAAA,CAAW,IAAA;;;;;;;;;;;;EAgCX,UAAA,CACL,IAAA,UACA,eAAA,EAAiB,GAAA,UACjB,oBAAA,GAAsB,GAAA;;;;;;EA+BjB,eAAA,CAAgB,IAAA,WAAe,GAAA;;;;;EAc/B,cAAA,CAAe,IAAA,UAAc,UAAA;;;;;;EAS7B,aAAA,CAAc,IAAA,WAAe,GAAA;;;;;;;;EAW7B,oBAAA,CAAqB,IAAA;;;;;;;;;;;;;EA+BrB,0BAAA;;;;;;;UA2CC,cAAA;;;;;UAwBA,iCAAA;;;;EAwGD,QAAA"}

package/esm/dev-server/dependency-graph.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/dependency-graph.ts
+//#region ../../packages/core/src/dev-server/dependency-graph.ts
 /**
 * Dependency Graph
 * Tracks bidirectional relationships between files:

package/esm/dev-server/dependency-graph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}

package/esm/dev-server/dev-agent-tooling.mjs

@@ -0,0 +1,135 @@
+import { getHttpReadyReport } from "../http/ready-report.mjs";
+import { connectorsManager } from "../connectors/connectors-manager.mjs";
+import { devLogInfo, devLogWarn } from "./dev-logger.mjs";
+import { removeDevServerState, writeDevServerState } from "../tooling/dev-state/dev-server-state.mjs";
+import { DEFAULT_DEVTOOLS_PATH } from "../tooling/devtools/devtools-client.mjs";
+
+//#region ../../packages/core/src/dev-server/dev-agent-tooling.ts
+/** Resolve `devServer.mcp` and the `--mcp` flag (the flag turns it on with the config's options). */
+function resolveDevMcpOptions(flag, config) {
+	if (!flag && !config) return false;
+	const settings = typeof config === "object" ? config : {};
+	return {
+		port: settings.port ?? 0,
+		...settings.token ? { token: settings.token } : {},
+		allowWrites: settings.allowWrites === true
+	};
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* The agent-facing side of `warlock dev`, all best-effort — none of it may
+* stop the app from serving:
+*
+* - records the server's address in `.warlock/dev-server.json` (read by
+*   `warlock trace` and `warlock mcp`), removed on shutdown;
+* - keeps the generated section of `AGENTS.md` fresh (unless
+*   `devServer.agentsMd: false`), on boot and after each reload, debounced;
+* - with `--mcp` / `devServer.mcp`, serves `warlock mcp` over HTTP on
+*   loopback from this process, so `inspect_*` reads the live registries.
+*
+* The tooling modules are imported lazily: they pull in the TypeScript
+* compiler and the generators, which a dev boot without them never needs.
+*/
+var DevAgentTooling = class {
+	/** @param cwd Project root. Default: `process.cwd()`. */
+	constructor(cwd = process.cwd()) {
+		this.cwd = cwd;
+		this.stateWritten = false;
+	}
+	async start(options) {
+		const http = getHttpReadyReport();
+		const devtoolsActive = connectorsManager.list().some((connector) => connector.name === "devtools" && connector.isActive());
+		if (options.mcp) await this.startMcp(options.mcp, http?.url);
+		if (http) try {
+			writeDevServerState({
+				schemaVersion: 1,
+				pid: process.pid,
+				url: http.url,
+				startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				devtools: devtoolsActive ? { path: DEFAULT_DEVTOOLS_PATH } : null,
+				mcp: this.mcp?.url ? { url: this.mcp.url } : null
+			}, this.cwd);
+			this.stateWritten = true;
+		} catch (error) {
+			devLogWarn(`Could not record the dev server address: ${errorMessage(error)}`);
+		}
+		if (options.agentsMd) await this.startAgentsMd();
+	}
+	/** Called after every hot reload: routes or modules may have changed. */
+	afterReload() {
+		this.refresher?.schedule();
+	}
+	async shutdown() {
+		this.refresher?.dispose();
+		this.refresher = void 0;
+		if (this.mcp) {
+			const server = this.mcp;
+			this.mcp = void 0;
+			try {
+				await server.close();
+			} catch (error) {
+				devLogWarn(`MCP server did not close cleanly: ${errorMessage(error)}`);
+			}
+		}
+		if (this.stateWritten) {
+			this.stateWritten = false;
+			removeDevServerState(process.pid, this.cwd);
+		}
+	}
+	async startAgentsMd() {
+		try {
+			const [{ createAgentsMdRefresher }, { inspectApp }] = await Promise.all([import("../tooling/agents-md/index.mjs"), import("../tooling/inspect/inspect-app.mjs")]);
+			this.refresher = createAgentsMdRefresher({
+				cwd: this.cwd,
+				collect: () => inspectApp({ sections: [
+					"routes",
+					"models",
+					"packages"
+				] }),
+				onWrite: (result) => {
+					if (result.status === "created" || result.status === "updated") devLogInfo(`AGENTS.md generated section ${result.status}`);
+				},
+				onError: (error) => devLogWarn(`AGENTS.md not refreshed: ${errorMessage(error)}`)
+			});
+			this.refresher.schedule();
+		} catch (error) {
+			devLogWarn(`AGENTS.md refresh is off: ${errorMessage(error)}`);
+		}
+	}
+	async startMcp(options, serverUrl) {
+		try {
+			const [{ createMcpContext }, { startWarlockMcpServer }, { inspectApp }, { featuresMap }] = await Promise.all([
+				import("../tooling/mcp/create-mcp-context.mjs"),
+				import("../tooling/mcp/start-mcp-server.mjs"),
+				import("../tooling/inspect/inspect-app.mjs"),
+				import("../generations/features/index.mjs")
+			]);
+			const context = createMcpContext({
+				cwd: this.cwd,
+				allowWrites: options.allowWrites,
+				inspect: (sections) => inspectApp({ sections }),
+				...process.argv[1] ? { cliEntry: process.argv[1] } : {},
+				devtools: serverUrl ? { url: serverUrl } : {},
+				features: Object.keys(featuresMap)
+			});
+			this.mcp = await startWarlockMcpServer({
+				context,
+				transport: {
+					type: "http",
+					host: "127.0.0.1",
+					port: options.port,
+					...options.token ? { token: options.token } : {}
+				}
+			});
+			devLogInfo(`MCP server at ${this.mcp.url ?? "?"} (${options.allowWrites ? "writes allowed" : "read-only"}${options.token ? ", token required" : ""})`);
+		} catch (error) {
+			devLogWarn(`MCP server not started: ${errorMessage(error)}`);
+		}
+	}
+};
+
+//#endregion
+export { DevAgentTooling, resolveDevMcpOptions };
+//# sourceMappingURL=dev-agent-tooling.mjs.map

package/esm/dev-server/dev-agent-tooling.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-agent-tooling.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dev-agent-tooling.ts"],"sourcesContent":["import { connectorsManager } from \"../connectors/connectors-manager\";\nimport { getHttpReadyReport } from \"../http/ready-report\";\nimport { removeDevServerState, writeDevServerState } from \"../tooling/dev-state/dev-server-state\";\nimport { DEFAULT_DEVTOOLS_PATH } from \"../tooling/devtools/devtools-client\";\nimport { devLogInfo, devLogWarn } from \"./dev-logger\";\n\n/** `devServer.mcp` (or `--mcp`) resolved: off, or the HTTP options. */\nexport type DevMcpOptions = false | { port: number; token?: string; allowWrites: boolean };\n\n/** Resolve `devServer.mcp` and the `--mcp` flag (the flag turns it on with the config's options). */\nexport function resolveDevMcpOptions(\n  flag: boolean | undefined,\n  config: boolean | { port?: number; token?: string; allowWrites?: boolean } | undefined,\n): DevMcpOptions {\n  if (!flag && !config) return false;\n\n  const settings = typeof config === \"object\" ? config : {};\n\n  return {\n    port: settings.port ?? 0,\n    ...(settings.token ? { token: settings.token } : {}),\n    allowWrites: settings.allowWrites === true,\n  };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * The agent-facing side of `warlock dev`, all best-effort — none of it may\n * stop the app from serving:\n *\n * - records the server's address in `.warlock/dev-server.json` (read by\n *   `warlock trace` and `warlock mcp`), removed on shutdown;\n * - keeps the generated section of `AGENTS.md` fresh (unless\n *   `devServer.agentsMd: false`), on boot and after each reload, debounced;\n * - with `--mcp` / `devServer.mcp`, serves `warlock mcp` over HTTP on\n *   loopback from this process, so `inspect_*` reads the live registries.\n *\n * The tooling modules are imported lazily: they pull in the TypeScript\n * compiler and the generators, which a dev boot without them never needs.\n */\nexport class DevAgentTooling {\n  private refresher?: { schedule(): void; dispose(): void };\n  private mcp?: { url?: string; close(): Promise<void> };\n  private stateWritten = false;\n\n  /** @param cwd Project root. Default: `process.cwd()`. */\n  public constructor(private readonly cwd: string = process.cwd()) {}\n\n  public async start(options: { agentsMd: boolean; mcp: DevMcpOptions }): Promise<void> {\n    const http = getHttpReadyReport();\n    const devtoolsActive = connectorsManager\n      .list()\n      .some((connector) => connector.name === \"devtools\" && connector.isActive());\n\n    if (options.mcp) {\n      await this.startMcp(options.mcp, http?.url);\n    }\n\n    if (http) {\n      try {\n        writeDevServerState(\n          {\n            schemaVersion: 1,\n            pid: process.pid,\n            url: http.url,\n            startedAt: new Date().toISOString(),\n            devtools: devtoolsActive ? { path: DEFAULT_DEVTOOLS_PATH } : null,\n            mcp: this.mcp?.url ? { url: this.mcp.url } : null,\n          },\n          this.cwd,\n        );\n        this.stateWritten = true;\n      } catch (error) {\n        devLogWarn(`Could not record the dev server address: ${errorMessage(error)}`);\n      }\n    }\n\n    if (options.agentsMd) {\n      await this.startAgentsMd();\n    }\n  }\n\n  /** Called after every hot reload: routes or modules may have changed. */\n  public afterReload(): void {\n    this.refresher?.schedule();\n  }\n\n  public async shutdown(): Promise<void> {\n    this.refresher?.dispose();\n    this.refresher = undefined;\n\n    if (this.mcp) {\n      const server = this.mcp;\n      this.mcp = undefined;\n\n      try {\n        await server.close();\n      } catch (error) {\n        devLogWarn(`MCP server did not close cleanly: ${errorMessage(error)}`);\n      }\n    }\n\n    if (this.stateWritten) {\n      this.stateWritten = false;\n      removeDevServerState(process.pid, this.cwd);\n    }\n  }\n\n  private async startAgentsMd(): Promise<void> {\n    try {\n      const [{ createAgentsMdRefresher }, { inspectApp }] = await Promise.all([\n        import(\"../tooling/agents-md\"),\n        import(\"../tooling/inspect/inspect-app\"),\n      ]);\n\n      this.refresher = createAgentsMdRefresher({\n        cwd: this.cwd,\n        collect: () => inspectApp({ sections: [\"routes\", \"models\", \"packages\"] }),\n        onWrite: (result) => {\n          if (result.status === \"created\" || result.status === \"updated\") {\n            devLogInfo(`AGENTS.md generated section ${result.status}`);\n          }\n        },\n        onError: (error) => devLogWarn(`AGENTS.md not refreshed: ${errorMessage(error)}`),\n      });\n      this.refresher.schedule();\n    } catch (error) {\n      devLogWarn(`AGENTS.md refresh is off: ${errorMessage(error)}`);\n    }\n  }\n\n  private async startMcp(\n    options: Exclude<DevMcpOptions, false>,\n    serverUrl?: string,\n  ): Promise<void> {\n    try {\n      const [{ createMcpContext }, { startWarlockMcpServer }, { inspectApp }, { featuresMap }] =\n        await Promise.all([\n          import(\"../tooling/mcp/create-mcp-context\"),\n          import(\"../tooling/mcp/start-mcp-server\"),\n          import(\"../tooling/inspect/inspect-app\"),\n          import(\"../generations/features\"),\n        ]);\n      const context = createMcpContext({\n        cwd: this.cwd,\n        allowWrites: options.allowWrites,\n        inspect: (sections) => inspectApp({ sections }),\n        ...(process.argv[1] ? { cliEntry: process.argv[1] } : {}),\n        devtools: serverUrl ? { url: serverUrl } : {},\n        features: Object.keys(featuresMap),\n      });\n\n      this.mcp = await startWarlockMcpServer({\n        context,\n        transport: {\n          type: \"http\",\n          host: \"127.0.0.1\",\n          port: options.port,\n          ...(options.token ? { token: options.token } : {}),\n        },\n      });\n\n      devLogInfo(\n        `MCP server at ${this.mcp.url ?? \"?\"} (${options.allowWrites ? \"writes allowed\" : \"read-only\"}${options.token ? \", token required\" : \"\"})`,\n      );\n    } catch (error) {\n      devLogWarn(`MCP server not started: ${errorMessage(error)}`);\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -2,7 +2,7 @@ import { Path } from "../utils/normalized-path.mjs";
 import { colors } from "@mongez/copper";
 import dayjs from "dayjs";
 
-//#region ../core/src/dev-server/dev-logger.ts
+//#region ../../packages/core/src/dev-server/dev-logger.ts
 /**
 * Dev server logger — Vite-style formatting helpers.
 */

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      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\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, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) => `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\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  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\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":["../../../../../../../../packages/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      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\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, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) =>\n    `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\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  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\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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"}