@warlock.js/core 5.29.0 → 5.31.0

package/esm/bootstrap/setup.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setup.mjs","names":[],"sources":["../../../../../../../core/src/bootstrap/setup.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { environment } from \"../utils\";\n\nexport function displayEnvironmentMode() {\n  const env = environment();\n\n  const envColor = (env: string) => {\n    switch (env) {\n      case \"development\":\n        return colors.yellow(env);\n      case \"production\":\n        return colors.green(env);\n      case \"test\":\n        return colors.magentaBright(env);\n    }\n  };\n\n  console.log(\n    colors.blueBright(\"ℹ\"),\n    colors.yellow(`(${new Date().toISOString()})`),\n    colors.orange(\"[warlock]\"),\n    colors.magenta(`bootstrap`),\n    colors.blueBright(`Starting application in ${envColor(env)} mode`),\n  );\n}\n"],"mappings":";;;;;AAGA,SAAgB,yBAAyB;CACvC,MAAM,MAAM,YAAY;CAExB,MAAM,YAAY,QAAgB;EAChC,QAAQ,KAAR;GACE,KAAK,eACH,OAAO,OAAO,OAAO,GAAG;GAC1B,KAAK,cACH,OAAO,OAAO,MAAM,GAAG;GACzB,KAAK,QACH,OAAO,OAAO,cAAc,GAAG;EACnC;CACF;CAEA,QAAQ,IACN,OAAO,WAAW,GAAG,GACrB,OAAO,OAAO,qBAAI,IAAI,KAAK,EAAC,CAAC,YAAY,EAAE,EAAE,GAC7C,OAAO,OAAO,WAAW,GACzB,OAAO,QAAQ,WAAW,GAC1B,OAAO,WAAW,2BAA2B,SAAS,GAAG,EAAE,MAAM,CACnE;AACF"}
+{"version":3,"file":"setup.mjs","names":[],"sources":["../../../../../../../../packages/core/src/bootstrap/setup.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { environment } from \"../utils\";\n\nexport function displayEnvironmentMode() {\n  const env = environment();\n\n  const envColor = (env: string) => {\n    switch (env) {\n      case \"development\":\n        return colors.yellow(env);\n      case \"production\":\n        return colors.green(env);\n      case \"test\":\n        return colors.magentaBright(env);\n    }\n  };\n\n  console.log(\n    colors.blueBright(\"ℹ\"),\n    colors.yellow(`(${new Date().toISOString()})`),\n    colors.orange(\"[warlock]\"),\n    colors.magenta(`bootstrap`),\n    colors.blueBright(`Starting application in ${envColor(env)} mode`),\n  );\n}\n"],"mappings":";;;;;AAGA,SAAgB,yBAAyB;CACvC,MAAM,MAAM,YAAY;CAExB,MAAM,YAAY,QAAgB;EAChC,QAAQ,KAAR;GACE,KAAK,eACH,OAAO,OAAO,OAAO,GAAG;GAC1B,KAAK,cACH,OAAO,OAAO,MAAM,GAAG;GACzB,KAAK,QACH,OAAO,OAAO,cAAc,GAAG;EACnC;CACF;CAEA,QAAQ,IACN,OAAO,WAAW,GAAG,GACrB,OAAO,OAAO,qBAAI,IAAI,KAAK,EAAC,CAAC,YAAY,EAAE,EAAE,GAC7C,OAAO,OAAO,WAAW,GACzB,OAAO,QAAQ,WAAW,GAC1B,OAAO,WAAW,2BAA2B,SAAS,GAAG,EAAE,MAAM,CACnE;AACF"}

package/esm/bootstrap.d.mts

@@ -1,4 +1,4 @@
-//#region ../core/src/bootstrap.d.ts
+//#region ../../packages/core/src/bootstrap.d.ts
 declare function bootstrap(): Promise<void>;
 //#endregion
 export { bootstrap };

package/esm/bootstrap.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.mts","names":[],"sources":["../../../../../../core/src/bootstrap.ts"],"mappings":";iBAOsB,SAAA,IAAS,OAAA"}
+{"version":3,"file":"bootstrap.d.mts","names":[],"sources":["../../../../../../../packages/core/src/bootstrap.ts"],"mappings":";iBAOsB,SAAA,IAAS,OAAA"}

package/esm/bootstrap.mjs

@@ -4,7 +4,7 @@ import { loadEnvironmentFiles } from "./utils/load-environment.mjs";
 import { captureAnyUnhandledRejection } from "@warlock.js/logger";
 import { initializeDayjs } from "@mongez/time-wizard";
 
-//#region ../core/src/bootstrap.ts
+//#region ../../packages/core/src/bootstrap.ts
 let unhandledCaptureInstalled = false;
 async function bootstrap() {
 	await loadEnvironmentFiles();

package/esm/bootstrap.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.mjs","names":[],"sources":["../../../../../../core/src/bootstrap.ts"],"sourcesContent":["import { initializeDayjs } from \"@mongez/time-wizard\";\nimport { captureAnyUnhandledRejection } from \"@warlock.js/logger\";\nimport { Application } from \"./application\";\nimport { loadEnvironmentFiles } from \"./utils/load-environment\";\n\nlet unhandledCaptureInstalled = false;\n\nexport async function bootstrap() {\n  // Guarded: a project with no `.env` is legitimate, and a raw `loadEnv()`\n  // throws on one. See `loadEnvironmentFiles`.\n  await loadEnvironmentFiles();\n\n  initializeDayjs();\n\n  // In production a fatal `uncaughtException` must take the process down loudly\n  // (Node's own default) so supervisors restart and `warlock start` surfaces\n  // the failure instead of exiting 0 in silence. In development the dev server\n  // intentionally survives runtime errors so HMR can recover, so we only log.\n  // Install the process listeners once: `bootstrap()` runs once per test file\n  // in the same worker, and each call would otherwise stack duplicate handlers.\n  if (unhandledCaptureInstalled) return;\n\n  unhandledCaptureInstalled = true;\n\n  captureAnyUnhandledRejection({ exitOnUncaughtException: Application.isProduction });\n}\n"],"mappings":";;;;;;;AAKA,IAAI,4BAA4B;AAEhC,eAAsB,YAAY;CAGhC,MAAM,qBAAqB;CAE3B,gBAAgB;CAQhB,IAAI,2BAA2B;CAE/B,4BAA4B;CAE5B,6BAA6B,EAAE,yBAAyB,YAAY,aAAa,CAAC;AACpF"}
+{"version":3,"file":"bootstrap.mjs","names":[],"sources":["../../../../../../../packages/core/src/bootstrap.ts"],"sourcesContent":["import { initializeDayjs } from \"@mongez/time-wizard\";\nimport { captureAnyUnhandledRejection } from \"@warlock.js/logger\";\nimport { Application } from \"./application\";\nimport { loadEnvironmentFiles } from \"./utils/load-environment\";\n\nlet unhandledCaptureInstalled = false;\n\nexport async function bootstrap() {\n  // Guarded: a project with no `.env` is legitimate, and a raw `loadEnv()`\n  // throws on one. See `loadEnvironmentFiles`.\n  await loadEnvironmentFiles();\n\n  initializeDayjs();\n\n  // In production a fatal `uncaughtException` must take the process down loudly\n  // (Node's own default) so supervisors restart and `warlock start` surfaces\n  // the failure instead of exiting 0 in silence. In development the dev server\n  // intentionally survives runtime errors so HMR can recover, so we only log.\n  // Install the process listeners once: `bootstrap()` runs once per test file\n  // in the same worker, and each call would otherwise stack duplicate handlers.\n  if (unhandledCaptureInstalled) return;\n\n  unhandledCaptureInstalled = true;\n\n  captureAnyUnhandledRejection({ exitOnUncaughtException: Application.isProduction });\n}\n"],"mappings":";;;;;;;AAKA,IAAI,4BAA4B;AAEhC,eAAsB,YAAY;CAGhC,MAAM,qBAAqB;CAE3B,gBAAgB;CAQhB,IAAI,2BAA2B;CAE/B,4BAA4B;CAE5B,6BAA6B,EAAE,yBAAyB,YAAY,aAAa,CAAC;AACpF"}

package/esm/cache/database-cache-driver.d.mts

@@ -1,7 +1,7 @@
 import { Model } from "@warlock.js/cascade";
 import { BaseCacheDriver, CacheDriver, CacheKey, CacheSetOptions, CacheTtl } from "@warlock.js/cache";
 
-//#region ../core/src/cache/database-cache-driver.d.ts
+//#region ../../packages/core/src/cache/database-cache-driver.d.ts
 type DatabaseCacheOptions = {
   /**
    * Database model class

package/esm/cache/database-cache-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-cache-driver.d.mts","names":[],"sources":["../../../../../../../core/src/cache/database-cache-driver.ts"],"mappings":";;;;KAUY,oBAAA;;AAAZ;;EAIE,KAAA,UAAe,UAAU;EAAA;;;EAIzB,YAAA;EAMA;;AAAG;AAGL;;EAHE,GAAA;AAAA;AAAA,cAGW,UAAA,SAAmB,KAAK;EAAA,OACrB,KAAK;AAAA;AAAA,cAGR,mBAAA,SACH,eAAA,CAAgB,mBAAA,EAAqB,oBAAA,aAClC,WAAA,CAAY,mBAAA,EAAqB,oBAAA;EADpB;;;EAMjB,IAAA;EAKe;;;EAAf,KAAA,SAAe,UAAA;EAiCqC;;;EA5BpD,UAAA,CAAW,OAAA,EAAS,oBAAA;EAuEG;;;EA5DjB,eAAA,CAAgB,SAAA,WAAiB,OAAA;EA3BtC;;;EA4CK,GAAA,CAAI,GAAA,EAAK,QAAA,EAAU,KAAA,OAAY,YAAA,GAAe,QAAA,GAAW,eAAA,GAAe,OAAA;EA5C7E;;;EAuFK,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EAtFP;;;EAgHV,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EAtGX;;;EAqHT,KAAA,IAAK,OAAA;AAAA"}
+{"version":3,"file":"database-cache-driver.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/cache/database-cache-driver.ts"],"mappings":";;;;KAUY,oBAAA;;AAAZ;;EAIE,KAAA,UAAe,UAAU;EAAA;;;EAIzB,YAAA;EAMA;;AAAG;AAGL;;EAHE,GAAA;AAAA;AAAA,cAGW,UAAA,SAAmB,KAAK;EAAA,OACrB,KAAK;AAAA;AAAA,cAGR,mBAAA,SACH,eAAA,CAAgB,mBAAA,EAAqB,oBAAA,aAClC,WAAA,CAAY,mBAAA,EAAqB,oBAAA;EADpB;;;EAMjB,IAAA;EAKe;;;EAAf,KAAA,SAAe,UAAA;EAiCqC;;;EA5BpD,UAAA,CAAW,OAAA,EAAS,oBAAA;EAuEG;;;EA5DjB,eAAA,CAAgB,SAAA,WAAiB,OAAA;EA3BtC;;;EA4CK,GAAA,CAAI,GAAA,EAAK,QAAA,EAAU,KAAA,OAAY,YAAA,GAAe,QAAA,GAAW,eAAA,GAAe,OAAA;EA5C7E;;;EAuFK,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EAtFP;;;EAgHV,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EAtGX;;;EAqHT,KAAA,IAAK,OAAA;AAAA"}

package/esm/cache/database-cache-driver.mjs

@@ -1,7 +1,7 @@
 import { Model } from "@warlock.js/cascade";
 import { BaseCacheDriver } from "@warlock.js/cache";
 
-//#region ../core/src/cache/database-cache-driver.ts
+//#region ../../packages/core/src/cache/database-cache-driver.ts
 var CacheModel = class extends Model {
 	static {
 		this.table = "cache";

package/esm/cache/database-cache-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-cache-driver.mjs","names":[],"sources":["../../../../../../../core/src/cache/database-cache-driver.ts"],"sourcesContent":["import {\n  BaseCacheDriver,\n  type CacheData,\n  type CacheDriver,\n  type CacheKey,\n  type CacheSetOptions,\n  type CacheTtl,\n} from \"@warlock.js/cache\";\nimport { Model } from \"@warlock.js/cascade\";\n\nexport type DatabaseCacheOptions = {\n  /**\n   * Database model class\n   */\n  model?: typeof CacheModel;\n  /**\n   * Global prefix for the cache key\n   */\n  globalPrefix?: string | (() => string);\n  /**\n   * The default TTL for the cache in seconds\n   *\n   * @default Infinity\n   */\n  ttl?: number;\n};\n\nexport class CacheModel extends Model {\n  public static table = \"cache\";\n}\n\nexport class DatabaseCacheDriver\n  extends BaseCacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n  implements CacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n{\n  /**\n   * {@inheritdoc}\n   */\n  public name = \"database\";\n\n  /**\n   * Database model class\n   */\n  public model!: typeof CacheModel;\n\n  /**\n   * {@inheritdoc}\n   */\n  public setOptions(options: DatabaseCacheOptions) {\n    super.setOptions(options);\n\n    this.model = options.model ?? CacheModel;\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async removeNamespace(namespace: string) {\n    this.log(\"clearing\", namespace);\n\n    namespace = this.parseKey(namespace);\n\n    await this.model.delete({\n      namespace,\n    });\n\n    this.log(\"cleared\", namespace);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async set(key: CacheKey, value: any, ttlOrOptions?: CacheTtl | CacheSetOptions) {\n    const parsedKey = this.parseKey(key);\n    const { ttl, tags } = this.resolveSetOptions(ttlOrOptions);\n\n    this.log(\"caching\", parsedKey);\n\n    // Extract namespace: all parts except the last (e.g., \"users.id.1\" -> \"users.id\")\n    const keyParts = parsedKey.split(\".\");\n    const namespace = keyParts.slice(0, -1).join(\".\") || parsedKey;\n\n    // Find existing cache entry or create new one (upsert pattern)\n    let cacheEntry = await this.model.first({ key: parsedKey });\n\n    if (cacheEntry) {\n      // Update existing entry\n      cacheEntry.set(\"namespace\", namespace);\n      cacheEntry.set(\"data\", value);\n      cacheEntry.set(\"ttl\", ttl);\n      cacheEntry.set(\"expiresAt\", this.getExpiresAt(ttl) || null);\n      await cacheEntry.save();\n    } else {\n      // Create new entry\n      await this.model.create({\n        key: parsedKey,\n        namespace,\n        data: value,\n        ttl,\n        expiresAt: this.getExpiresAt(ttl) || null,\n      });\n    }\n\n    if (tags && tags.length > 0) {\n      await this.applyTags(key, tags);\n    }\n\n    this.log(\"cached\", parsedKey);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async get(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"fetching\", parsedKey);\n\n    const model = await this.model.first({\n      key: parsedKey,\n    });\n\n    if (!model) {\n      this.log(\"notFound\", parsedKey);\n      return null;\n    }\n\n    const data: CacheData = {\n      data: model.get(\"data\"),\n      expiresAt: model.get(\"expiresAt\") as number | undefined,\n      ttl: model.get(\"ttl\") as number | undefined,\n    };\n\n    return this.parseCachedData(parsedKey, data);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async remove(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"removing\", parsedKey);\n\n    await this.model.delete({\n      key: parsedKey,\n    });\n\n    this.log(\"removed\", parsedKey);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async flush() {\n    this.log(\"flushing\");\n    if (this.options.globalPrefix) {\n      this.removeNamespace(\"\");\n    } else {\n      await this.model.delete();\n    }\n\n    this.log(\"flushed\");\n  }\n}\n"],"mappings":";;;;AA2BA,IAAa,aAAb,cAAgC,MAAM;;eACd;;AACxB;AAEA,IAAa,sBAAb,cACU,gBAEV;;;cAIgB;;;;;CAUd,AAAO,WAAW,SAA+B;EAC/C,MAAM,WAAW,OAAO;EAExB,KAAK,QAAQ,QAAQ,SAAS;EAE9B,OAAO;CACT;;;;CAKA,MAAa,gBAAgB,WAAmB;EAC9C,KAAK,IAAI,YAAY,SAAS;EAE9B,YAAY,KAAK,SAAS,SAAS;EAEnC,MAAM,KAAK,MAAM,OAAO,EACtB,UACF,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;EAE7B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe,OAAY,cAA2C;EACrF,MAAM,YAAY,KAAK,SAAS,GAAG;EACnC,MAAM,EAAE,KAAK,SAAS,KAAK,kBAAkB,YAAY;EAEzD,KAAK,IAAI,WAAW,SAAS;EAI7B,MAAM,YADW,UAAU,MAAM,GACR,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,KAAK;EAGrD,IAAI,aAAa,MAAM,KAAK,MAAM,MAAM,EAAE,KAAK,UAAU,CAAC;EAE1D,IAAI,YAAY;GAEd,WAAW,IAAI,aAAa,SAAS;GACrC,WAAW,IAAI,QAAQ,KAAK;GAC5B,WAAW,IAAI,OAAO,GAAG;GACzB,WAAW,IAAI,aAAa,KAAK,aAAa,GAAG,KAAK,IAAI;GAC1D,MAAM,WAAW,KAAK;EACxB,OAEE,MAAM,KAAK,MAAM,OAAO;GACtB,KAAK;GACL;GACA,MAAM;GACN;GACA,WAAW,KAAK,aAAa,GAAG,KAAK;EACvC,CAAC;EAGH,IAAI,QAAQ,KAAK,SAAS,GACxB,MAAM,KAAK,UAAU,KAAK,IAAI;EAGhC,KAAK,IAAI,UAAU,SAAS;EAE5B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe;EAC9B,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,QAAQ,MAAM,KAAK,MAAM,MAAM,EACnC,KAAK,UACP,CAAC;EAED,IAAI,CAAC,OAAO;GACV,KAAK,IAAI,YAAY,SAAS;GAC9B,OAAO;EACT;EAEA,MAAM,OAAkB;GACtB,MAAM,MAAM,IAAI,MAAM;GACtB,WAAW,MAAM,IAAI,WAAW;GAChC,KAAK,MAAM,IAAI,KAAK;EACtB;EAEA,OAAO,KAAK,gBAAgB,WAAW,IAAI;CAC7C;;;;CAKA,MAAa,OAAO,KAAe;EACjC,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,KAAK,MAAM,OAAO,EACtB,KAAK,UACP,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;CAC/B;;;;CAKA,MAAa,QAAQ;EACnB,KAAK,IAAI,UAAU;EACnB,IAAI,KAAK,QAAQ,cACf,KAAK,gBAAgB,EAAE;OAEvB,MAAM,KAAK,MAAM,OAAO;EAG1B,KAAK,IAAI,SAAS;CACpB;AACF"}
+{"version":3,"file":"database-cache-driver.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cache/database-cache-driver.ts"],"sourcesContent":["import {\n  BaseCacheDriver,\n  type CacheData,\n  type CacheDriver,\n  type CacheKey,\n  type CacheSetOptions,\n  type CacheTtl,\n} from \"@warlock.js/cache\";\nimport { Model } from \"@warlock.js/cascade\";\n\nexport type DatabaseCacheOptions = {\n  /**\n   * Database model class\n   */\n  model?: typeof CacheModel;\n  /**\n   * Global prefix for the cache key\n   */\n  globalPrefix?: string | (() => string);\n  /**\n   * The default TTL for the cache in seconds\n   *\n   * @default Infinity\n   */\n  ttl?: number;\n};\n\nexport class CacheModel extends Model {\n  public static table = \"cache\";\n}\n\nexport class DatabaseCacheDriver\n  extends BaseCacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n  implements CacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n{\n  /**\n   * {@inheritdoc}\n   */\n  public name = \"database\";\n\n  /**\n   * Database model class\n   */\n  public model!: typeof CacheModel;\n\n  /**\n   * {@inheritdoc}\n   */\n  public setOptions(options: DatabaseCacheOptions) {\n    super.setOptions(options);\n\n    this.model = options.model ?? CacheModel;\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async removeNamespace(namespace: string) {\n    this.log(\"clearing\", namespace);\n\n    namespace = this.parseKey(namespace);\n\n    await this.model.delete({\n      namespace,\n    });\n\n    this.log(\"cleared\", namespace);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async set(key: CacheKey, value: any, ttlOrOptions?: CacheTtl | CacheSetOptions) {\n    const parsedKey = this.parseKey(key);\n    const { ttl, tags } = this.resolveSetOptions(ttlOrOptions);\n\n    this.log(\"caching\", parsedKey);\n\n    // Extract namespace: all parts except the last (e.g., \"users.id.1\" -> \"users.id\")\n    const keyParts = parsedKey.split(\".\");\n    const namespace = keyParts.slice(0, -1).join(\".\") || parsedKey;\n\n    // Find existing cache entry or create new one (upsert pattern)\n    let cacheEntry = await this.model.first({ key: parsedKey });\n\n    if (cacheEntry) {\n      // Update existing entry\n      cacheEntry.set(\"namespace\", namespace);\n      cacheEntry.set(\"data\", value);\n      cacheEntry.set(\"ttl\", ttl);\n      cacheEntry.set(\"expiresAt\", this.getExpiresAt(ttl) || null);\n      await cacheEntry.save();\n    } else {\n      // Create new entry\n      await this.model.create({\n        key: parsedKey,\n        namespace,\n        data: value,\n        ttl,\n        expiresAt: this.getExpiresAt(ttl) || null,\n      });\n    }\n\n    if (tags && tags.length > 0) {\n      await this.applyTags(key, tags);\n    }\n\n    this.log(\"cached\", parsedKey);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async get(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"fetching\", parsedKey);\n\n    const model = await this.model.first({\n      key: parsedKey,\n    });\n\n    if (!model) {\n      this.log(\"notFound\", parsedKey);\n      return null;\n    }\n\n    const data: CacheData = {\n      data: model.get(\"data\"),\n      expiresAt: model.get(\"expiresAt\") as number | undefined,\n      ttl: model.get(\"ttl\") as number | undefined,\n    };\n\n    return this.parseCachedData(parsedKey, data);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async remove(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"removing\", parsedKey);\n\n    await this.model.delete({\n      key: parsedKey,\n    });\n\n    this.log(\"removed\", parsedKey);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async flush() {\n    this.log(\"flushing\");\n    if (this.options.globalPrefix) {\n      this.removeNamespace(\"\");\n    } else {\n      await this.model.delete();\n    }\n\n    this.log(\"flushed\");\n  }\n}\n"],"mappings":";;;;AA2BA,IAAa,aAAb,cAAgC,MAAM;;eACd;;AACxB;AAEA,IAAa,sBAAb,cACU,gBAEV;;;cAIgB;;;;;CAUd,AAAO,WAAW,SAA+B;EAC/C,MAAM,WAAW,OAAO;EAExB,KAAK,QAAQ,QAAQ,SAAS;EAE9B,OAAO;CACT;;;;CAKA,MAAa,gBAAgB,WAAmB;EAC9C,KAAK,IAAI,YAAY,SAAS;EAE9B,YAAY,KAAK,SAAS,SAAS;EAEnC,MAAM,KAAK,MAAM,OAAO,EACtB,UACF,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;EAE7B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe,OAAY,cAA2C;EACrF,MAAM,YAAY,KAAK,SAAS,GAAG;EACnC,MAAM,EAAE,KAAK,SAAS,KAAK,kBAAkB,YAAY;EAEzD,KAAK,IAAI,WAAW,SAAS;EAI7B,MAAM,YADW,UAAU,MAAM,GACR,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,KAAK;EAGrD,IAAI,aAAa,MAAM,KAAK,MAAM,MAAM,EAAE,KAAK,UAAU,CAAC;EAE1D,IAAI,YAAY;GAEd,WAAW,IAAI,aAAa,SAAS;GACrC,WAAW,IAAI,QAAQ,KAAK;GAC5B,WAAW,IAAI,OAAO,GAAG;GACzB,WAAW,IAAI,aAAa,KAAK,aAAa,GAAG,KAAK,IAAI;GAC1D,MAAM,WAAW,KAAK;EACxB,OAEE,MAAM,KAAK,MAAM,OAAO;GACtB,KAAK;GACL;GACA,MAAM;GACN;GACA,WAAW,KAAK,aAAa,GAAG,KAAK;EACvC,CAAC;EAGH,IAAI,QAAQ,KAAK,SAAS,GACxB,MAAM,KAAK,UAAU,KAAK,IAAI;EAGhC,KAAK,IAAI,UAAU,SAAS;EAE5B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe;EAC9B,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,QAAQ,MAAM,KAAK,MAAM,MAAM,EACnC,KAAK,UACP,CAAC;EAED,IAAI,CAAC,OAAO;GACV,KAAK,IAAI,YAAY,SAAS;GAC9B,OAAO;EACT;EAEA,MAAM,OAAkB;GACtB,MAAM,MAAM,IAAI,MAAM;GACtB,WAAW,MAAM,IAAI,WAAW;GAChC,KAAK,MAAM,IAAI,KAAK;EACtB;EAEA,OAAO,KAAK,gBAAgB,WAAW,IAAI;CAC7C;;;;CAKA,MAAa,OAAO,KAAe;EACjC,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,KAAK,MAAM,OAAO,EACtB,KAAK,UACP,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;CAC/B;;;;CAKA,MAAa,QAAQ;EACnB,KAAK,IAAI,UAAU;EACnB,IAAI,KAAK,QAAQ,cACf,KAAK,gBAAgB,EAAE;OAEvB,MAAM,KAAK,MAAM,OAAO;EAG1B,KAAK,IAAI,SAAS;CACpB;AACF"}

package/esm/cache/index.mjs

@@ -1,7 +1,7 @@
 import { DatabaseCacheDriver } from "./database-cache-driver.mjs";
 import { cache } from "@warlock.js/cache";
 
-//#region ../core/src/cache/index.ts
+//#region ../../packages/core/src/cache/index.ts
 cache.registerDriver("database", DatabaseCacheDriver);
 
 //#endregion

package/esm/cache/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../core/src/cache/index.ts"],"sourcesContent":["export { DatabaseCacheDriver } from \"./database-cache-driver\";\nexport type { DatabaseCacheOptions } from \"./database-cache-driver\";\n\n// Auto-register database cache driver\nimport { cache } from \"@warlock.js/cache\";\nimport { DatabaseCacheDriver } from \"./database-cache-driver\";\n\ncache.registerDriver(\"database\", DatabaseCacheDriver);\n"],"mappings":";;;;AAOA,MAAM,eAAe,YAAY,mBAAmB"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cache/index.ts"],"sourcesContent":["export { DatabaseCacheDriver } from \"./database-cache-driver\";\nexport type { DatabaseCacheOptions } from \"./database-cache-driver\";\n\n// Auto-register database cache driver\nimport { cache } from \"@warlock.js/cache\";\nimport { DatabaseCacheDriver } from \"./database-cache-driver\";\n\ncache.registerDriver(\"database\", DatabaseCacheDriver);\n"],"mappings":";;;;AAOA,MAAM,eAAe,YAAY,mBAAmB"}

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

@@ -22,7 +22,7 @@ import { toCamelCase } from "@mongez/reinforcements";
 import { colors } from "@mongez/copper";
 import { fileExistsAsync } from "@warlock.js/fs";
 
-//#region ../core/src/cli/cli-commands.manager.ts
+//#region ../../packages/core/src/cli/cli-commands.manager.ts
 /**
 * Best-effort budget (ms) for draining stdout/stderr before a forced exit.
 * Bounded so a stuck stream can never hang the CLI.

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

@@ -1 +1 @@
-{"version":3,"file":"cli-commands.manager.mjs","names":[],"sources":["../../../../../../../core/src/cli/cli-commands.manager.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\nimport { colors } from \"@mongez/copper\";\nimport { fileExistsAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { registerConfiguredConnectors } from \"../connectors/register-configured-connectors\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { isDevWorker } from \"../dev-server/supervisor\";\nimport { preflightConfiguredHttpPort, shouldPreflightHttpPort } from \"../http/boot-port-preflight\";\nimport { manifestManager } from \"../manifest/manifest-manager\";\nimport { appPath } from \"../utils\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { CLICommand } from \"../commands/cli-command\";\nimport {\n  displayBootError,\n  displayCommandError,\n  displayCommandHelp,\n  displayCommandNotFound,\n  displayCommandSuccess,\n  displayExecutingCommand,\n  displayHelp,\n  displayMissingCommand,\n  displayMissingOptions,\n  displayWarlockVersionInTerminal,\n  type HelpCommandInfo,\n  isMatchingCommandName,\n} from \"./cli-commands.utils\";\nimport { cliCommandsLoader } from \"./commands-loader\";\nimport { frameworkCommands } from \"./framework-cli-commands\";\nimport { CliOptionValueError, type ParsedCliArgs, parseCliArgs } from \"./parse-cli-args\";\nimport { findSimilar } from \"./string-similarity\";\nimport type { CommandActionData, ResolvedCLICommandOption } from \"../commands/types\";\n\n/**\n * Best-effort budget (ms) for draining stdout/stderr before a forced exit.\n * Bounded so a stuck stream can never hang the CLI.\n */\nconst EXIT_FLUSH_BUDGET = 500;\n\n/**\n * Exit with `code` once stdout/stderr have drained.\n *\n * `process.exit()` truncates writes still queued on a non-TTY stdout — a pipe,\n * a CI log — which is how the *reason* for a failure gets lost even when the\n * exit code is right. `exitCode` is set up front so that a natural exit (should\n * the drain outlive the process's remaining work) is non-zero too.\n */\nfunction exitAfterFlush(code: number) {\n  process.exitCode = code;\n\n  const timer = setTimeout(() => process.exit(code), EXIT_FLUSH_BUDGET);\n  timer.unref?.();\n\n  let pending = 2;\n  const drained = () => {\n    if (--pending > 0) return;\n\n    clearTimeout(timer);\n    process.exit(code);\n  };\n\n  // A zero-length write's callback fires once everything queued ahead of it has\n  // been handed to the OS.\n  process.stdout.write(\"\", drained);\n  process.stderr.write(\"\", drained);\n}\n\n/**\n * How a command run ended, from the process's point of view.\n *\n * - `succeeded` — finished, nothing rejected afterwards; the CLI may exit 0.\n * - `failed` — reported an error; the exit code is owned by whoever reported it.\n * - `running` — a persistent command (dev/start) now owns the process.\n *\n * `execute` returns this instead of exiting on success itself. A method that\n * terminates the process out from under its caller cannot be awaited honestly:\n * the exit it schedules outlives the call, so the success it represents is\n * still unsettled when `execute` resolves — which is exactly how a green check\n * ends up printed next to the failure that contradicts it.\n */\nexport type CommandRunVerdict = \"succeeded\" | \"failed\" | \"running\";\n\n/**\n * Whether this process is the CHILD half of a supervised command.\n *\n * ## The finding this encodes\n *\n * `warlock dev` printing `› Running dev...` twice was NOT a double boot, and\n * the distinction is the whole point of this function existing rather than the\n * line simply being deleted. The sequence, in file order:\n *\n * 1. `execute()` prints the header (below) — BEFORE `commandPreAction`.\n * 2. `cli/commands/dev-server.command.ts` `preAction` calls\n *    `superviseDevServer()` when `!isDevWorker()`.\n * 3. `dev-server/supervisor.ts` `spawnWorker()` re-spawns `process.argv` with\n *    `WARLOCK_DEV_WORKER=1`, so the child runs `warlock dev` again and prints\n *    the header too.\n * 4. `superviseDevServer()` returns a promise that never settles, so the\n *    supervisor's `await commandPreAction(...)` never resolves — `loadPreloaders`\n *    and `command.execute` are unreachable in the supervisor.\n *\n * Step 4 is why only ONE process ever loads config, connectors, app modules or\n * a scheduler. Verified by running it: one `APP-CODE-LOADED`, one\n * `Application.markBooted`, one `⚡ Warlock.js` banner, one route registration,\n * two processes. The `2 job(s) registered` in the original report is two jobs\n * in one scheduler, not two schedulers — a genuine double boot would have\n * printed that warning twice.\n *\n * So the defect is exactly one duplicated line, and this is the guard that\n * keeps it one. `tests/unit/cli/dev-command-single-boot.test.ts` fails if the\n * supervisor ever starts running preloaders — i.e. if the double boot the\n * duplicated line looked like ever becomes real.\n */\nfunction isRespawnedWorker(): boolean {\n  return isDevWorker();\n}\n\nexport class CLICommandsManager {\n  /**\n   * List of commands\n   */\n  public commands: CLICommand[] = [];\n\n  /**\n   * Commands map (name -> command)\n   */\n  public commandsMap: Map<string, CLICommand> = new Map();\n\n  /**\n   * Alias map (alias -> command name)\n   */\n  public aliasMap: Map<string, string> = new Map();\n\n  /**\n   * Register the given commands\n   */\n  public register(...commands: CLICommand[]): this {\n    this.commands.push(...commands);\n\n    commands.forEach((command) => {\n      // `split` always yields a first element, so this holds. Falling back to\n      // the whole name rather than asserting keeps the map keyed by a REAL\n      // command name — a key of `undefined` would register the command under\n      // the literal string \"undefined\" and make it unreachable by its own name.\n      const commandKey = command.name.split(\" \")[0] ?? command.name;\n\n      manifestManager.addCommandToList(command.name, {\n        relativePath: command.commandRelativePath,\n        source: command.commandSource || \"project\",\n        description: command.commandDescription,\n        alias: command.commandAlias,\n        options: command.commandOptions.length > 0 ? command.commandOptions : undefined,\n      });\n\n      this.commandsMap.set(commandKey, command);\n\n      // Register alias if exists\n      if (command.commandAlias) {\n        this.aliasMap.set(command.commandAlias, commandKey);\n      }\n    });\n\n    return this;\n  }\n\n  /**\n   * Get command by name or alias\n   */\n  public getCommand(name: string): CLICommand | undefined {\n    // First try direct lookup\n    let command = this.commandsMap.get(name);\n    if (command) return command;\n\n    // Try alias lookup\n    const realName = this.aliasMap.get(name);\n    if (realName) {\n      return this.commandsMap.get(realName);\n    }\n\n    return;\n  }\n\n  /**\n   * Get all command names and aliases\n   * Used for fuzzy matching suggestions\n   */\n  public getAllCommandNames(): string[] {\n    const names: string[] = [];\n\n    // Add all command names\n    for (const name of this.commandsMap.keys()) {\n      names.push(name);\n    }\n\n    // Add all aliases\n    for (const alias of this.aliasMap.keys()) {\n      names.push(alias);\n    }\n\n    // Also include cached commands from manifest\n    const manifestCommands = manifestManager.commandsJson?.commands || {};\n    // `Object.entries` rather than keys + index: the index read is\n    // `T | undefined` under the strictness contract even for a key that came\n    // from the object itself, and these names feed the CLI's \"did you mean?\"\n    // suggestions — a literal \"undefined\" in that list is a suggestion no\n    // operator can act on.\n    for (const [name, meta] of Object.entries(manifestCommands)) {\n      const baseName = name.split(\" \")[0] ?? name;\n\n      if (!names.includes(baseName)) {\n        names.push(baseName);\n      }\n\n      const alias = meta?.alias;\n\n      if (alias && !names.includes(alias)) {\n        names.push(alias);\n      }\n    }\n\n    return names;\n  }\n\n  /**\n   * Start the cli manager\n   */\n  public async start() {\n    // Schema-less first pass: it exists to discover the command name and the\n    // command-independent flags (--help, --version, --no-cache). Values here are\n    // raw strings; the typed pass below is the one whose options reach a command.\n    const { name, options } = parseCliArgs(process.argv);\n\n    if (options.noCache) {\n      manifestManager.clearCommandsCache();\n      // remove the commands.json file as wel\n      await manifestManager.removeCommandsFile();\n    }\n\n    // `-v` is only the version flag when no command was given: after a command\n    // name it is that command's own short flag (`--with-validation`).\n    if (options.version || (options.v && !name)) {\n      await displayWarlockVersionInTerminal();\n      process.exit(0);\n    }\n\n    // Try to load from manifest first (fastest path)\n    await manifestManager.loadCommands();\n\n    // Register framework commands first (needed for help)\n    this.register(\n      ...frameworkCommands.map((command) => {\n        if (!command.commandSource) {\n          command.commandSource = \"framework\";\n        }\n        return command;\n      }),\n    );\n\n    const isHelpCommand = options.help || options.h;\n\n    // Handle global help (no command)\n    if (!name && isHelpCommand) {\n      await this.showGlobalHelp();\n      process.exit(0);\n    }\n\n    // Handle warm cache\n    if (options.warmCache) {\n      await this.warmCache();\n      process.exit(0);\n    }\n\n    if (!name) {\n      displayMissingCommand();\n      process.exit(1);\n    }\n\n    const command = await this.lazyGetCommand(name);\n\n    if (manifestManager.hasChanges) {\n      await manifestManager.saveCommands();\n    }\n\n    if (!command) {\n      // Find similar commands for suggestions\n      const allCommandNames = this.getAllCommandNames();\n      const suggestions = findSimilar(name, allCommandNames).map((s) => s.value);\n\n      displayCommandNotFound(name, suggestions);\n      process.exit(1);\n    }\n\n    // Handle command-specific help\n    if (isHelpCommand) {\n      displayCommandHelp({\n        name: command.name,\n        alias: command.commandAlias,\n        description: command.commandDescription,\n        options: command.commandOptions,\n      });\n      process.exit(0);\n    }\n\n    // The first parse above had no command to consult, so every value in it is\n    // a raw string. Now that the command is resolved, re-read argv against its\n    // declared options so a `type: \"boolean\"` option arrives as a boolean.\n    const resolved = this.resolveCommandArgs(command);\n\n    const verdict = await this.execute(command, {\n      options: resolved.options,\n      args: resolved.args,\n    });\n\n    // The process-level exit belongs to the entrypoint, not to `execute`.\n    // A one-shot command can leave a handle open (a db connection, a watcher a\n    // plugin forgot to close), so the CLI exits explicitly rather than waiting\n    // for the loop to drain — but only on a verdict of `succeeded`. `failed`\n    // already exited non-zero through whoever reported it, and `running` means\n    // a persistent command owns the process now.\n    if (verdict === \"succeeded\") {\n      exitAfterFlush(0);\n    }\n  }\n\n  /**\n   * Re-parse argv against the resolved command's declared options.\n   *\n   * parseCliArgs runs twice on purpose. The first run produces the command\n   * name, and there is no schema to consult yet; the second one, here, can be\n   * type-aware. Re-reading argv (rather than post-processing the first result)\n   * is what makes `--rollback users.ts` recoverable: by the time the first pass\n   * returns, the swallowed positional is indistinguishable from a value.\n   */\n  protected resolveCommandArgs(command: CLICommand, argv: string[] = process.argv): ParsedCliArgs {\n    try {\n      return parseCliArgs(argv, command.commandOptions);\n    } catch (error) {\n      if (error instanceof CliOptionValueError) {\n        console.log();\n        console.log(`  ${colors.redBright(\"Error:\")} ${error.message}`);\n        console.log();\n        process.exit(1);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Show global help with all commands\n   * Uses manifest if available for fast display\n   */\n  protected async showGlobalHelp() {\n    // Always rescan rather than trusting `.warlock/commands.json`: the manifest\n    // has no invalidation, so a newly added project command stayed invisible\n    // and a removed one lingered in help until `--warm-cache`.\n    await this.loadPluginsCommands();\n\n    const projectCommands = await cliCommandsLoader.scanAll();\n\n    this.register(...projectCommands);\n\n    await manifestManager.saveCommands();\n\n    // Build help info from registered commands\n    const helpCommands: HelpCommandInfo[] = this.commands.map((cmd) => ({\n      name: cmd.name,\n      alias: cmd.commandAlias,\n      description: cmd.commandDescription,\n      source: cmd.commandSource || \"project\",\n    }));\n\n    await displayHelp(helpCommands);\n  }\n\n  /**\n   * Warm cache - scan all project commands and save to manifest\n   */\n  protected async warmCache() {\n    console.log();\n    console.log(`  ${colors.cyan(\"›\")} Scanning project commands...`);\n\n    const projectCommands = await cliCommandsLoader.scanAll();\n\n    this.register(...projectCommands);\n\n    await manifestManager.saveCommands();\n\n    console.log(\n      `  ${colors.green(\"✔\")} Cached ${colors.bold(String(projectCommands.length))} project commands`,\n    );\n    console.log();\n  }\n\n  /**\n   * Load plugins commands\n   */\n  protected async loadPluginsCommands() {\n    await warlockConfigManager.load();\n\n    if (warlockConfigManager.isLoaded) {\n      this.register(\n        ...(warlockConfigManager.get(\"cli\")?.commands || []).map((command) => {\n          if (!command.commandSource) {\n            command.commandSource = \"plugin\";\n          }\n          return command;\n        }),\n      );\n    }\n  }\n\n  /**\n   * Try to find the command based on the given command name or alias\n   */\n  protected async lazyGetCommand(name: string) {\n    // first step, try to find it directly through current commands\n    let command = this.getCommand(name);\n    if (command) {\n      return command;\n    }\n\n    // second step, try to find it through warlock config commands\n    await this.loadPluginsCommands();\n\n    command = this.getCommand(name);\n\n    if (command) {\n      return command;\n    }\n\n    // third step, try to find it through project commands\n    await this.loadProjectCommands(name);\n\n    command = this.getCommand(name);\n    if (command) {\n      return command;\n    }\n\n    return null;\n  }\n\n  /**\n   * Load project commands\n   */\n  protected async loadProjectCommands(name: string) {\n    // first get the commands.json contents as an object\n    const jsonCommandsFile = await manifestManager.loadCommands();\n\n    if (jsonCommandsFile) {\n      // Check by name or alias\n      // `Object.entries` hands the metadata over already narrowed; a `for...in`\n      // index read is `T | undefined` and every field below is read off it.\n      for (const [fullCommandName, cmdMeta] of Object.entries(jsonCommandsFile.commands)) {\n        if (cmdMeta === undefined) continue;\n\n        // Match by name or alias\n        if (isMatchingCommandName(fullCommandName, name) || cmdMeta.alias === name) {\n          const commandPath = cmdMeta.relativePath;\n          if (commandPath) {\n            const executedCommand = await cliCommandsLoader.load(commandPath);\n\n            if (executedCommand) {\n              executedCommand.$relativePath(commandPath);\n              this.register(executedCommand);\n              return;\n            }\n          }\n        }\n      }\n    }\n\n    const command = await cliCommandsLoader.locate(name);\n\n    if (command) {\n      this.register(command);\n      return;\n    }\n  }\n\n  /**\n   * Validate required options\n   */\n  protected validateOptions(\n    command: CLICommand,\n    options: Record<string, string | boolean | number>,\n  ): ResolvedCLICommandOption[] {\n    const missing: ResolvedCLICommandOption[] = [];\n\n    command.commandOptions.forEach((opt) => {\n      if (opt.required) {\n        // Check if option is provided by name or alias\n        const name = toCamelCase(opt.name);\n        const alias = opt.alias ? toCamelCase(opt.alias) : \"\";\n        const hasOption =\n          options[name] !== undefined ||\n          options[opt.name] !== undefined ||\n          (alias && options[alias] !== undefined);\n        if (!hasOption) {\n          missing.push(opt);\n        }\n      }\n    });\n\n    return missing;\n  }\n\n  /**\n   * Apply default values to options\n   */\n  protected applyDefaultOptions(\n    command: CLICommand,\n    options: Record<string, string | boolean | number>,\n  ): Record<string, string | boolean | number> {\n    const result = { ...options };\n\n    command.commandOptions.forEach((declared) => {\n      // Parsed keys are camelCase; normalise so commands built with raw kebab\n      // names still resolve, and mirror the value to the kebab key.\n      const camelName = toCamelCase(declared.name);\n      const opt = {\n        ...declared,\n        name: camelName,\n        alias: declared.alias ? toCamelCase(declared.alias) : declared.alias,\n      };\n\n      const declaredValue = result[declared.name];\n      if (result[camelName] === undefined && declaredValue !== undefined) {\n        result[camelName] = declaredValue;\n      }\n\n      if (opt.defaultValue !== undefined) {\n        const hasOption =\n          result[opt.name] !== undefined || (opt.alias && result[opt.alias] !== undefined);\n        if (!hasOption) {\n          result[opt.name] = opt.defaultValue;\n        }\n      }\n\n      // `!== undefined`, not truthiness: `-r=false` now resolves to the boolean\n      // `false`, and a truthiness test would drop it before it ever reached the\n      // canonical name — leaving `rollback` undefined instead of explicitly off.\n      if (\n        opt.alias !== undefined &&\n        result[opt.alias] !== undefined &&\n        result[opt.name] === undefined\n      ) {\n        // The `!== undefined` guard on the line above already proves this read\n        // is defined, but the compiler does not carry a guard on one index\n        // expression to a second, textually identical one. Reading it into a\n        // local makes the narrowing survive, WITHOUT weakening the check — an\n        // `?? ` fallback here would resurrect exactly the bug the comment above\n        // describes, turning an explicit `-r=false` into a default.\n        const aliasValue = result[opt.alias];\n\n        if (aliasValue !== undefined) {\n          result[opt.name] = aliasValue;\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Execute the given command and report how it ended.\n   *\n   * Returning the verdict — rather than exiting on success from in here — is\n   * what makes the awaited result trustworthy: see {@link CommandRunVerdict}.\n   */\n  public async execute(command: CLICommand, data: CommandActionData): Promise<CommandRunVerdict> {\n    const startTime = Date.now();\n\n    // Validate required options\n    const missingOptions = this.validateOptions(command, data.options);\n    if (missingOptions.length > 0) {\n      displayMissingOptions(missingOptions);\n      process.exit(1);\n    }\n\n    // Apply default values\n    data.options = this.applyDefaultOptions(command, data.options);\n\n    // ONE header per `warlock <command>` the user typed — not one per process.\n    //\n    // `warlock dev` is TWO processes by design: the invocation the user typed\n    // becomes a thin supervisor (`dev-server/supervisor.ts`) that re-spawns\n    // `process.argv` with `WARLOCK_DEV_WORKER=1`, and the child is the actual\n    // server. Both are `warlock dev`, so both reached this line and the user saw\n    //\n    //     › Running dev...\n    //     › Running dev...\n    //\n    // which reads exactly like the application booting twice. It is not — see\n    // the block comment on `isRespawnedWorker` — but the line was still wrong,\n    // and it re-printed on every crash-restart on top of the supervisor's own\n    // \"restarting\" notice.\n    //\n    // The SUPERVISOR keeps the header, not the worker: it prints immediately\n    // (so a slow boot is not silent), it prints once for the whole session\n    // (restarts are already announced as restarts), and it is the process the\n    // user actually started.\n    if (!isRespawnedWorker()) {\n      displayExecutingCommand(command.name);\n    }\n\n    if (command.commandPreAction) {\n      await command.commandPreAction(data);\n    }\n\n    // load preloaders\n    if (command.commandPreload) {\n      try {\n        await this.loadPreloaders(command);\n      } catch (error) {\n        // A preload failure (a bad import in a config file, a connector that\n        // throws on boot, a missing module export) happens BEFORE the command's\n        // action runs — there is no run loop to recover into, so it is ALWAYS\n        // fatal, persistent command (dev/start) or not. Surface the real cause\n        // and the offending file, then exit. This MUST stay outside the\n        // command-execute try/catch below: letting a preload rejection escape\n        // turned `warlock dev` into a silent hang — the unhandled rejection slid\n        // past while the already-started loader worker thread kept the process\n        // alive, freezing just after the banner with no error printed.\n        displayBootError(command.name, error as Error);\n        process.exit(1);\n      }\n    }\n\n    this.captureFatalAsyncErrors(command);\n\n    try {\n      await command.execute(data);\n\n      // Persistent commands (dev/start) hand control to their run loop here.\n      // There is no success banner to print and nothing to exit for.\n      if (command.isPersistent) return \"running\";\n\n      // Yield one full event-loop turn before declaring success, and AWAIT that\n      // yield. Node flags an unhandled rejection only after the current turn's\n      // microtasks drain, so reporting success synchronously here fired FIRST\n      // and erased the failure — a `build` whose async work rejected exited 0\n      // having emitted nothing.\n      //\n      // The await is the load-bearing part, not the yield. Scheduling this as a\n      // bare `setImmediate` let `execute()` RESOLVE while the verdict was still\n      // pending: the callback outlived the call it belonged to, so the green\n      // check could surface after the caller had already moved on — in a later\n      // command, or after a rejection reported in the interim, which the guard\n      // below cannot see because by then it reads the state of a run that has\n      // already ended. Awaiting binds the banner to THIS invocation: `execute`\n      // does not resolve until the verdict it is about to report has settled.\n      //\n      // `setImmediate` runs in the same loop iteration's check phase, so this\n      // cannot hang on a lingering handle the way dropping the exit would; it\n      // only lets `captureFatalAsyncErrors` win the race when there is one.\n      await new Promise<void>((resolve) => setImmediate(resolve));\n\n      // The yield is what gives a floating rejection the chance to be reported;\n      // this is what acts on it. A green check printed after that error would\n      // contradict it, and the exit that follows would reset `process.exitCode`\n      // to 0 — re-erasing the very failure this whole path exists to surface.\n      if (this.fatalAsyncErrorReported) return \"failed\";\n\n      displayCommandSuccess(command.name, Date.now() - startTime);\n\n      return \"succeeded\";\n    } catch (error) {\n      displayCommandError(command.name, error as Error);\n      // Persistent commands (dev/start) own their startup-failure exits;\n      // by the time an error reaches here they've already entered their\n      // run loop, so it's a runtime error we log but don't crash on —\n      // HMR or process supervisors can recover. Non-persistent\n      // one-shot commands always exit on failure.\n      if (!command.isPersistent) {\n        process.exit(1);\n      }\n\n      return \"failed\";\n    }\n  }\n\n  /**\n   * Fail loudly on async errors that escape the command's own promise.\n   *\n   * `execute` awaits `command.execute(data)`, but work the command merely\n   * *started* settles outside that await — `@mongez/events` `trigger` /\n   * `triggerAll` are synchronous and do not await their listeners, so an async\n   * listener that throws leaves a floating rejection behind. Node reports it at\n   * the end of the turn, by which point the CLI had already exited 0: the\n   * failure was erased and the command looked green.\n   *\n   * Persistent commands (dev/start) are exempt from the exit for the same\n   * reason as the catch block in `execute`: by the time they reach this point\n   * they own a run loop that is expected to survive runtime errors so HMR or a\n   * supervisor can recover. They still print — silence is what made this class\n   * of failure invisible in the first place.\n   */\n  protected fatalAsyncErrorReported = false;\n\n  protected captureFatalAsyncErrors(command: CLICommand) {\n    const onFatalAsyncError = (reason: unknown) => {\n      // A rejection reason is not necessarily an Error (`Promise.reject(\"x\")`),\n      // and a crash handler must never itself throw.\n      const error = reason instanceof Error ? reason : new Error(String(reason));\n\n      // Set before printing, so the deferred success banner is suppressed even\n      // if displaying the error yields.\n      this.fatalAsyncErrorReported = true;\n\n      displayCommandError(command.name, error);\n\n      if (!command.isPersistent) {\n        exitAfterFlush(1);\n      }\n    };\n\n    process.on(\"unhandledRejection\", onFatalAsyncError);\n    process.on(\"uncaughtException\", onFatalAsyncError);\n  }\n\n  /**\n   * Load preloaders\n   */\n  protected async loadPreloaders(command: CLICommand) {\n    const preloaders = command.commandPreload || {};\n\n    if (preloaders.runtimeStrategy) {\n      Application.setRuntimeStrategy(preloaders.runtimeStrategy);\n    }\n\n    // Override, not a default: a command that declares an environment gets it\n    // regardless of what the shell exported. Then read it back — `process.env`\n    // is process-global and anything may have written to it, so a value that\n    // did not take must fail here, loudly, rather than surface later as a\n    // production React bundle under `warlock dev`.\n    if (preloaders.environment) {\n      Application.setEnvironment(preloaders.environment);\n\n      if (process.env.NODE_ENV !== preloaders.environment) {\n        throw new Error(\n          `Command \"${command.name}\" set NODE_ENV to \"${preloaders.environment}\", but it read back as ` +\n            `\"${process.env.NODE_ENV}\". The environment did not take, and every decision made ` +\n            `downstream of it — env file selection, bundler dep optimisation — would be wrong.`,\n        );\n      }\n    }\n\n    // Env BEFORE config, unconditionally, for every command.\n    //\n    // `warlock.config.ts` is a module whose body runs on import, and projects\n    // legitimately call `env(\"BUILD_OUT\", \"dist\")` in it. Loading config first\n    // evaluated that body against an empty env store, so every such call\n    // silently returned its default — under `build` and `start`, which never\n    // loaded env at all, and under `dev` too, because config was loaded first\n    // regardless. The ordering is load-bearing in the other direction as well:\n    // `loadEnv()` reads `process.env.NODE_ENV` at call time to choose\n    // `.env.<NODE_ENV>` over `.env`, so it must follow `setEnvironment` above.\n    await loadEnvironmentFiles();\n\n    await warlockConfigManager.load();\n\n    if (preloaders.config || preloaders.bootstrap || preloaders.prestart) {\n      await filesOrchestrator.init();\n    }\n\n    // `preloaders.env` is gone: env is loaded above for every command, so the\n    // branch that used to serve it could only re-parse the same files and\n    // re-override `process.env` a second time.\n    if (preloaders.bootstrap) {\n      await bootstrap();\n\n      if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\n        await filesOrchestrator.load(\"src/app/bootstrap.ts\");\n      }\n    }\n\n    // Load configuration files\n    if (preloaders.config) {\n      await loadConfigFiles(preloaders.config);\n    }\n\n    if (preloaders.prestart) {\n      if (await fileExistsAsync(appPath(\"prestart.ts\"))) {\n        await filesOrchestrator.load(\"src/app/prestart.ts\");\n      }\n    }\n\n    // Initialize connectors.\n    // `connectors: true` only starts the early phase here — late-phase\n    // connectors (http, socket) start after the command's action loads\n    // app code. Explicit lists bypass phase splitting (caller knows\n    // exactly which connectors they want).\n    if (preloaders.connectors) {\n      // REGISTER before starting — the non-bundled counterpart of section 2.5\n      // of the generated production entry, and the \"dev preloader\" path\n      // `register-configured-connectors.ts` documents.\n      //\n      // Without this, `warlock.config.ts > connectors` drove the BUILD only:\n      // `warlock build` read the array to drain each connector's contribution,\n      // but under `warlock dev` nothing ever registered it, so an app had to\n      // call `connectorsManager.register(...)` from its own `main.ts` to get a\n      // connector running. Apps that did BOTH then registered the same\n      // connector twice in production — once here from the baked config, once\n      // from their own app code — and it booted twice, which surfaced as\n      // `Route name \"...\" is already taken` while installing page routes.\n      //\n      // The array is omitted deliberately, so the function reads the config\n      // loaded above; `expectedNames` is omitted too, because drift is a\n      // build↔runtime relationship and dev has no build to drift from.\n      //\n      // The idempotency this function provides is against ITSELF — a second\n      // call skips names the first registered. It does NOT protect against an\n      // app calling `connectorsManager.register()` directly, which pushes\n      // unconditionally, and which runs AFTER this point in both modes. So a\n      // connector belongs in the config array or in app code, never both:\n      // listing it in both is the duplicate this comment's route-name error\n      // describes.\n      registerConfiguredConnectors();\n\n      // Fail fast on a busy port BEFORE the early-phase connectors (database,\n      // cache, ...) connect. `http` itself is a LATE-phase connector, so its\n      // own preflight is not reached until after those early connectors are\n      // up and every app module has been imported — 7-13s of work discarded\n      // before anyone learns the port was taken. This is the dev-preload\n      // counterpart of the check the generated production entry runs at the\n      // same point in its own boot sequence (`production-builder.ts`, step\n      // 2.6) — a cheap bind-and-release probe, not a connector reorder.\n      // Only when this boot will actually start http: a scoped list without\n      // \"http\" (seed, migrate, …) never binds the port, so probing it would\n      // collide with a running dev server on a port it never uses (f9ace89e).\n      if (shouldPreflightHttpPort(preloaders.connectors)) {\n        await preflightConfiguredHttpPort();\n      }\n\n      if (preloaders.connectors === true) {\n        await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\n      } else {\n        await connectorsManager.start(preloaders.connectors);\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli-commands.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/cli-commands.manager.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\nimport { colors } from \"@mongez/copper\";\nimport { fileExistsAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { registerConfiguredConnectors } from \"../connectors/register-configured-connectors\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { isDevWorker } from \"../dev-server/supervisor\";\nimport { preflightConfiguredHttpPort, shouldPreflightHttpPort } from \"../http/boot-port-preflight\";\nimport { manifestManager } from \"../manifest/manifest-manager\";\nimport { appPath } from \"../utils\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { CLICommand } from \"../commands/cli-command\";\nimport {\n  displayBootError,\n  displayCommandError,\n  displayCommandHelp,\n  displayCommandNotFound,\n  displayCommandSuccess,\n  displayExecutingCommand,\n  displayHelp,\n  displayMissingCommand,\n  displayMissingOptions,\n  displayWarlockVersionInTerminal,\n  type HelpCommandInfo,\n  isMatchingCommandName,\n} from \"./cli-commands.utils\";\nimport { cliCommandsLoader } from \"./commands-loader\";\nimport { frameworkCommands } from \"./framework-cli-commands\";\nimport { CliOptionValueError, type ParsedCliArgs, parseCliArgs } from \"./parse-cli-args\";\nimport { findSimilar } from \"./string-similarity\";\nimport type { CommandActionData, ResolvedCLICommandOption } from \"../commands/types\";\n\n/**\n * Best-effort budget (ms) for draining stdout/stderr before a forced exit.\n * Bounded so a stuck stream can never hang the CLI.\n */\nconst EXIT_FLUSH_BUDGET = 500;\n\n/**\n * Exit with `code` once stdout/stderr have drained.\n *\n * `process.exit()` truncates writes still queued on a non-TTY stdout — a pipe,\n * a CI log — which is how the *reason* for a failure gets lost even when the\n * exit code is right. `exitCode` is set up front so that a natural exit (should\n * the drain outlive the process's remaining work) is non-zero too.\n */\nfunction exitAfterFlush(code: number) {\n  process.exitCode = code;\n\n  const timer = setTimeout(() => process.exit(code), EXIT_FLUSH_BUDGET);\n  timer.unref?.();\n\n  let pending = 2;\n  const drained = () => {\n    if (--pending > 0) return;\n\n    clearTimeout(timer);\n    process.exit(code);\n  };\n\n  // A zero-length write's callback fires once everything queued ahead of it has\n  // been handed to the OS.\n  process.stdout.write(\"\", drained);\n  process.stderr.write(\"\", drained);\n}\n\n/**\n * How a command run ended, from the process's point of view.\n *\n * - `succeeded` — finished, nothing rejected afterwards; the CLI may exit 0.\n * - `failed` — reported an error; the exit code is owned by whoever reported it.\n * - `running` — a persistent command (dev/start) now owns the process.\n *\n * `execute` returns this instead of exiting on success itself. A method that\n * terminates the process out from under its caller cannot be awaited honestly:\n * the exit it schedules outlives the call, so the success it represents is\n * still unsettled when `execute` resolves — which is exactly how a green check\n * ends up printed next to the failure that contradicts it.\n */\nexport type CommandRunVerdict = \"succeeded\" | \"failed\" | \"running\";\n\n/**\n * Whether this process is the CHILD half of a supervised command.\n *\n * ## The finding this encodes\n *\n * `warlock dev` printing `› Running dev...` twice was NOT a double boot, and\n * the distinction is the whole point of this function existing rather than the\n * line simply being deleted. The sequence, in file order:\n *\n * 1. `execute()` prints the header (below) — BEFORE `commandPreAction`.\n * 2. `cli/commands/dev-server.command.ts` `preAction` calls\n *    `superviseDevServer()` when `!isDevWorker()`.\n * 3. `dev-server/supervisor.ts` `spawnWorker()` re-spawns `process.argv` with\n *    `WARLOCK_DEV_WORKER=1`, so the child runs `warlock dev` again and prints\n *    the header too.\n * 4. `superviseDevServer()` returns a promise that never settles, so the\n *    supervisor's `await commandPreAction(...)` never resolves — `loadPreloaders`\n *    and `command.execute` are unreachable in the supervisor.\n *\n * Step 4 is why only ONE process ever loads config, connectors, app modules or\n * a scheduler. Verified by running it: one `APP-CODE-LOADED`, one\n * `Application.markBooted`, one `⚡ Warlock.js` banner, one route registration,\n * two processes. The `2 job(s) registered` in the original report is two jobs\n * in one scheduler, not two schedulers — a genuine double boot would have\n * printed that warning twice.\n *\n * So the defect is exactly one duplicated line, and this is the guard that\n * keeps it one. `tests/unit/cli/dev-command-single-boot.test.ts` fails if the\n * supervisor ever starts running preloaders — i.e. if the double boot the\n * duplicated line looked like ever becomes real.\n */\nfunction isRespawnedWorker(): boolean {\n  return isDevWorker();\n}\n\nexport class CLICommandsManager {\n  /**\n   * List of commands\n   */\n  public commands: CLICommand[] = [];\n\n  /**\n   * Commands map (name -> command)\n   */\n  public commandsMap: Map<string, CLICommand> = new Map();\n\n  /**\n   * Alias map (alias -> command name)\n   */\n  public aliasMap: Map<string, string> = new Map();\n\n  /**\n   * Register the given commands\n   */\n  public register(...commands: CLICommand[]): this {\n    this.commands.push(...commands);\n\n    commands.forEach((command) => {\n      // `split` always yields a first element, so this holds. Falling back to\n      // the whole name rather than asserting keeps the map keyed by a REAL\n      // command name — a key of `undefined` would register the command under\n      // the literal string \"undefined\" and make it unreachable by its own name.\n      const commandKey = command.name.split(\" \")[0] ?? command.name;\n\n      manifestManager.addCommandToList(command.name, {\n        relativePath: command.commandRelativePath,\n        source: command.commandSource || \"project\",\n        description: command.commandDescription,\n        alias: command.commandAlias,\n        options: command.commandOptions.length > 0 ? command.commandOptions : undefined,\n      });\n\n      this.commandsMap.set(commandKey, command);\n\n      // Register alias if exists\n      if (command.commandAlias) {\n        this.aliasMap.set(command.commandAlias, commandKey);\n      }\n    });\n\n    return this;\n  }\n\n  /**\n   * Get command by name or alias\n   */\n  public getCommand(name: string): CLICommand | undefined {\n    // First try direct lookup\n    let command = this.commandsMap.get(name);\n    if (command) return command;\n\n    // Try alias lookup\n    const realName = this.aliasMap.get(name);\n    if (realName) {\n      return this.commandsMap.get(realName);\n    }\n\n    return;\n  }\n\n  /**\n   * Get all command names and aliases\n   * Used for fuzzy matching suggestions\n   */\n  public getAllCommandNames(): string[] {\n    const names: string[] = [];\n\n    // Add all command names\n    for (const name of this.commandsMap.keys()) {\n      names.push(name);\n    }\n\n    // Add all aliases\n    for (const alias of this.aliasMap.keys()) {\n      names.push(alias);\n    }\n\n    // Also include cached commands from manifest\n    const manifestCommands = manifestManager.commandsJson?.commands || {};\n    // `Object.entries` rather than keys + index: the index read is\n    // `T | undefined` under the strictness contract even for a key that came\n    // from the object itself, and these names feed the CLI's \"did you mean?\"\n    // suggestions — a literal \"undefined\" in that list is a suggestion no\n    // operator can act on.\n    for (const [name, meta] of Object.entries(manifestCommands)) {\n      const baseName = name.split(\" \")[0] ?? name;\n\n      if (!names.includes(baseName)) {\n        names.push(baseName);\n      }\n\n      const alias = meta?.alias;\n\n      if (alias && !names.includes(alias)) {\n        names.push(alias);\n      }\n    }\n\n    return names;\n  }\n\n  /**\n   * Start the cli manager\n   */\n  public async start() {\n    // Schema-less first pass: it exists to discover the command name and the\n    // command-independent flags (--help, --version, --no-cache). Values here are\n    // raw strings; the typed pass below is the one whose options reach a command.\n    const { name, options } = parseCliArgs(process.argv);\n\n    if (options.noCache) {\n      manifestManager.clearCommandsCache();\n      // remove the commands.json file as wel\n      await manifestManager.removeCommandsFile();\n    }\n\n    // `-v` is only the version flag when no command was given: after a command\n    // name it is that command's own short flag (`--with-validation`).\n    if (options.version || (options.v && !name)) {\n      await displayWarlockVersionInTerminal();\n      process.exit(0);\n    }\n\n    // Try to load from manifest first (fastest path)\n    await manifestManager.loadCommands();\n\n    // Register framework commands first (needed for help)\n    this.register(\n      ...frameworkCommands.map((command) => {\n        if (!command.commandSource) {\n          command.commandSource = \"framework\";\n        }\n        return command;\n      }),\n    );\n\n    const isHelpCommand = options.help || options.h;\n\n    // Handle global help (no command)\n    if (!name && isHelpCommand) {\n      await this.showGlobalHelp();\n      process.exit(0);\n    }\n\n    // Handle warm cache\n    if (options.warmCache) {\n      await this.warmCache();\n      process.exit(0);\n    }\n\n    if (!name) {\n      displayMissingCommand();\n      process.exit(1);\n    }\n\n    const command = await this.lazyGetCommand(name);\n\n    if (manifestManager.hasChanges) {\n      await manifestManager.saveCommands();\n    }\n\n    if (!command) {\n      // Find similar commands for suggestions\n      const allCommandNames = this.getAllCommandNames();\n      const suggestions = findSimilar(name, allCommandNames).map((s) => s.value);\n\n      displayCommandNotFound(name, suggestions);\n      process.exit(1);\n    }\n\n    // Handle command-specific help\n    if (isHelpCommand) {\n      displayCommandHelp({\n        name: command.name,\n        alias: command.commandAlias,\n        description: command.commandDescription,\n        options: command.commandOptions,\n      });\n      process.exit(0);\n    }\n\n    // The first parse above had no command to consult, so every value in it is\n    // a raw string. Now that the command is resolved, re-read argv against its\n    // declared options so a `type: \"boolean\"` option arrives as a boolean.\n    const resolved = this.resolveCommandArgs(command);\n\n    const verdict = await this.execute(command, {\n      options: resolved.options,\n      args: resolved.args,\n    });\n\n    // The process-level exit belongs to the entrypoint, not to `execute`.\n    // A one-shot command can leave a handle open (a db connection, a watcher a\n    // plugin forgot to close), so the CLI exits explicitly rather than waiting\n    // for the loop to drain — but only on a verdict of `succeeded`. `failed`\n    // already exited non-zero through whoever reported it, and `running` means\n    // a persistent command owns the process now.\n    if (verdict === \"succeeded\") {\n      exitAfterFlush(0);\n    }\n  }\n\n  /**\n   * Re-parse argv against the resolved command's declared options.\n   *\n   * parseCliArgs runs twice on purpose. The first run produces the command\n   * name, and there is no schema to consult yet; the second one, here, can be\n   * type-aware. Re-reading argv (rather than post-processing the first result)\n   * is what makes `--rollback users.ts` recoverable: by the time the first pass\n   * returns, the swallowed positional is indistinguishable from a value.\n   */\n  protected resolveCommandArgs(command: CLICommand, argv: string[] = process.argv): ParsedCliArgs {\n    try {\n      return parseCliArgs(argv, command.commandOptions);\n    } catch (error) {\n      if (error instanceof CliOptionValueError) {\n        console.log();\n        console.log(`  ${colors.redBright(\"Error:\")} ${error.message}`);\n        console.log();\n        process.exit(1);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Show global help with all commands\n   * Uses manifest if available for fast display\n   */\n  protected async showGlobalHelp() {\n    // Always rescan rather than trusting `.warlock/commands.json`: the manifest\n    // has no invalidation, so a newly added project command stayed invisible\n    // and a removed one lingered in help until `--warm-cache`.\n    await this.loadPluginsCommands();\n\n    const projectCommands = await cliCommandsLoader.scanAll();\n\n    this.register(...projectCommands);\n\n    await manifestManager.saveCommands();\n\n    // Build help info from registered commands\n    const helpCommands: HelpCommandInfo[] = this.commands.map((cmd) => ({\n      name: cmd.name,\n      alias: cmd.commandAlias,\n      description: cmd.commandDescription,\n      source: cmd.commandSource || \"project\",\n    }));\n\n    await displayHelp(helpCommands);\n  }\n\n  /**\n   * Warm cache - scan all project commands and save to manifest\n   */\n  protected async warmCache() {\n    console.log();\n    console.log(`  ${colors.cyan(\"›\")} Scanning project commands...`);\n\n    const projectCommands = await cliCommandsLoader.scanAll();\n\n    this.register(...projectCommands);\n\n    await manifestManager.saveCommands();\n\n    console.log(\n      `  ${colors.green(\"✔\")} Cached ${colors.bold(String(projectCommands.length))} project commands`,\n    );\n    console.log();\n  }\n\n  /**\n   * Load plugins commands\n   */\n  protected async loadPluginsCommands() {\n    await warlockConfigManager.load();\n\n    if (warlockConfigManager.isLoaded) {\n      this.register(\n        ...(warlockConfigManager.get(\"cli\")?.commands || []).map((command) => {\n          if (!command.commandSource) {\n            command.commandSource = \"plugin\";\n          }\n          return command;\n        }),\n      );\n    }\n  }\n\n  /**\n   * Try to find the command based on the given command name or alias\n   */\n  protected async lazyGetCommand(name: string) {\n    // first step, try to find it directly through current commands\n    let command = this.getCommand(name);\n    if (command) {\n      return command;\n    }\n\n    // second step, try to find it through warlock config commands\n    await this.loadPluginsCommands();\n\n    command = this.getCommand(name);\n\n    if (command) {\n      return command;\n    }\n\n    // third step, try to find it through project commands\n    await this.loadProjectCommands(name);\n\n    command = this.getCommand(name);\n    if (command) {\n      return command;\n    }\n\n    return null;\n  }\n\n  /**\n   * Load project commands\n   */\n  protected async loadProjectCommands(name: string) {\n    // first get the commands.json contents as an object\n    const jsonCommandsFile = await manifestManager.loadCommands();\n\n    if (jsonCommandsFile) {\n      // Check by name or alias\n      // `Object.entries` hands the metadata over already narrowed; a `for...in`\n      // index read is `T | undefined` and every field below is read off it.\n      for (const [fullCommandName, cmdMeta] of Object.entries(jsonCommandsFile.commands)) {\n        if (cmdMeta === undefined) continue;\n\n        // Match by name or alias\n        if (isMatchingCommandName(fullCommandName, name) || cmdMeta.alias === name) {\n          const commandPath = cmdMeta.relativePath;\n          if (commandPath) {\n            const executedCommand = await cliCommandsLoader.load(commandPath);\n\n            if (executedCommand) {\n              executedCommand.$relativePath(commandPath);\n              this.register(executedCommand);\n              return;\n            }\n          }\n        }\n      }\n    }\n\n    const command = await cliCommandsLoader.locate(name);\n\n    if (command) {\n      this.register(command);\n      return;\n    }\n  }\n\n  /**\n   * Validate required options\n   */\n  protected validateOptions(\n    command: CLICommand,\n    options: Record<string, string | boolean | number>,\n  ): ResolvedCLICommandOption[] {\n    const missing: ResolvedCLICommandOption[] = [];\n\n    command.commandOptions.forEach((opt) => {\n      if (opt.required) {\n        // Check if option is provided by name or alias\n        const name = toCamelCase(opt.name);\n        const alias = opt.alias ? toCamelCase(opt.alias) : \"\";\n        const hasOption =\n          options[name] !== undefined ||\n          options[opt.name] !== undefined ||\n          (alias && options[alias] !== undefined);\n        if (!hasOption) {\n          missing.push(opt);\n        }\n      }\n    });\n\n    return missing;\n  }\n\n  /**\n   * Apply default values to options\n   */\n  protected applyDefaultOptions(\n    command: CLICommand,\n    options: Record<string, string | boolean | number>,\n  ): Record<string, string | boolean | number> {\n    const result = { ...options };\n\n    command.commandOptions.forEach((declared) => {\n      // Parsed keys are camelCase; normalise so commands built with raw kebab\n      // names still resolve, and mirror the value to the kebab key.\n      const camelName = toCamelCase(declared.name);\n      const opt = {\n        ...declared,\n        name: camelName,\n        alias: declared.alias ? toCamelCase(declared.alias) : declared.alias,\n      };\n\n      const declaredValue = result[declared.name];\n      if (result[camelName] === undefined && declaredValue !== undefined) {\n        result[camelName] = declaredValue;\n      }\n\n      if (opt.defaultValue !== undefined) {\n        const hasOption =\n          result[opt.name] !== undefined || (opt.alias && result[opt.alias] !== undefined);\n        if (!hasOption) {\n          result[opt.name] = opt.defaultValue;\n        }\n      }\n\n      // `!== undefined`, not truthiness: `-r=false` now resolves to the boolean\n      // `false`, and a truthiness test would drop it before it ever reached the\n      // canonical name — leaving `rollback` undefined instead of explicitly off.\n      if (\n        opt.alias !== undefined &&\n        result[opt.alias] !== undefined &&\n        result[opt.name] === undefined\n      ) {\n        // The `!== undefined` guard on the line above already proves this read\n        // is defined, but the compiler does not carry a guard on one index\n        // expression to a second, textually identical one. Reading it into a\n        // local makes the narrowing survive, WITHOUT weakening the check — an\n        // `?? ` fallback here would resurrect exactly the bug the comment above\n        // describes, turning an explicit `-r=false` into a default.\n        const aliasValue = result[opt.alias];\n\n        if (aliasValue !== undefined) {\n          result[opt.name] = aliasValue;\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Execute the given command and report how it ended.\n   *\n   * Returning the verdict — rather than exiting on success from in here — is\n   * what makes the awaited result trustworthy: see {@link CommandRunVerdict}.\n   */\n  public async execute(command: CLICommand, data: CommandActionData): Promise<CommandRunVerdict> {\n    const startTime = Date.now();\n\n    // Validate required options\n    const missingOptions = this.validateOptions(command, data.options);\n    if (missingOptions.length > 0) {\n      displayMissingOptions(missingOptions);\n      process.exit(1);\n    }\n\n    // Apply default values\n    data.options = this.applyDefaultOptions(command, data.options);\n\n    // ONE header per `warlock <command>` the user typed — not one per process.\n    //\n    // `warlock dev` is TWO processes by design: the invocation the user typed\n    // becomes a thin supervisor (`dev-server/supervisor.ts`) that re-spawns\n    // `process.argv` with `WARLOCK_DEV_WORKER=1`, and the child is the actual\n    // server. Both are `warlock dev`, so both reached this line and the user saw\n    //\n    //     › Running dev...\n    //     › Running dev...\n    //\n    // which reads exactly like the application booting twice. It is not — see\n    // the block comment on `isRespawnedWorker` — but the line was still wrong,\n    // and it re-printed on every crash-restart on top of the supervisor's own\n    // \"restarting\" notice.\n    //\n    // The SUPERVISOR keeps the header, not the worker: it prints immediately\n    // (so a slow boot is not silent), it prints once for the whole session\n    // (restarts are already announced as restarts), and it is the process the\n    // user actually started.\n    if (!isRespawnedWorker()) {\n      displayExecutingCommand(command.name);\n    }\n\n    if (command.commandPreAction) {\n      await command.commandPreAction(data);\n    }\n\n    // load preloaders\n    if (command.commandPreload) {\n      try {\n        await this.loadPreloaders(command);\n      } catch (error) {\n        // A preload failure (a bad import in a config file, a connector that\n        // throws on boot, a missing module export) happens BEFORE the command's\n        // action runs — there is no run loop to recover into, so it is ALWAYS\n        // fatal, persistent command (dev/start) or not. Surface the real cause\n        // and the offending file, then exit. This MUST stay outside the\n        // command-execute try/catch below: letting a preload rejection escape\n        // turned `warlock dev` into a silent hang — the unhandled rejection slid\n        // past while the already-started loader worker thread kept the process\n        // alive, freezing just after the banner with no error printed.\n        displayBootError(command.name, error as Error);\n        process.exit(1);\n      }\n    }\n\n    this.captureFatalAsyncErrors(command);\n\n    try {\n      await command.execute(data);\n\n      // Persistent commands (dev/start) hand control to their run loop here.\n      // There is no success banner to print and nothing to exit for.\n      if (command.isPersistent) return \"running\";\n\n      // Yield one full event-loop turn before declaring success, and AWAIT that\n      // yield. Node flags an unhandled rejection only after the current turn's\n      // microtasks drain, so reporting success synchronously here fired FIRST\n      // and erased the failure — a `build` whose async work rejected exited 0\n      // having emitted nothing.\n      //\n      // The await is the load-bearing part, not the yield. Scheduling this as a\n      // bare `setImmediate` let `execute()` RESOLVE while the verdict was still\n      // pending: the callback outlived the call it belonged to, so the green\n      // check could surface after the caller had already moved on — in a later\n      // command, or after a rejection reported in the interim, which the guard\n      // below cannot see because by then it reads the state of a run that has\n      // already ended. Awaiting binds the banner to THIS invocation: `execute`\n      // does not resolve until the verdict it is about to report has settled.\n      //\n      // `setImmediate` runs in the same loop iteration's check phase, so this\n      // cannot hang on a lingering handle the way dropping the exit would; it\n      // only lets `captureFatalAsyncErrors` win the race when there is one.\n      await new Promise<void>((resolve) => setImmediate(resolve));\n\n      // The yield is what gives a floating rejection the chance to be reported;\n      // this is what acts on it. A green check printed after that error would\n      // contradict it, and the exit that follows would reset `process.exitCode`\n      // to 0 — re-erasing the very failure this whole path exists to surface.\n      if (this.fatalAsyncErrorReported) return \"failed\";\n\n      displayCommandSuccess(command.name, Date.now() - startTime);\n\n      return \"succeeded\";\n    } catch (error) {\n      displayCommandError(command.name, error as Error);\n      // Persistent commands (dev/start) own their startup-failure exits;\n      // by the time an error reaches here they've already entered their\n      // run loop, so it's a runtime error we log but don't crash on —\n      // HMR or process supervisors can recover. Non-persistent\n      // one-shot commands always exit on failure.\n      if (!command.isPersistent) {\n        process.exit(1);\n      }\n\n      return \"failed\";\n    }\n  }\n\n  /**\n   * Fail loudly on async errors that escape the command's own promise.\n   *\n   * `execute` awaits `command.execute(data)`, but work the command merely\n   * *started* settles outside that await — `@mongez/events` `trigger` /\n   * `triggerAll` are synchronous and do not await their listeners, so an async\n   * listener that throws leaves a floating rejection behind. Node reports it at\n   * the end of the turn, by which point the CLI had already exited 0: the\n   * failure was erased and the command looked green.\n   *\n   * Persistent commands (dev/start) are exempt from the exit for the same\n   * reason as the catch block in `execute`: by the time they reach this point\n   * they own a run loop that is expected to survive runtime errors so HMR or a\n   * supervisor can recover. They still print — silence is what made this class\n   * of failure invisible in the first place.\n   */\n  protected fatalAsyncErrorReported = false;\n\n  protected captureFatalAsyncErrors(command: CLICommand) {\n    const onFatalAsyncError = (reason: unknown) => {\n      // A rejection reason is not necessarily an Error (`Promise.reject(\"x\")`),\n      // and a crash handler must never itself throw.\n      const error = reason instanceof Error ? reason : new Error(String(reason));\n\n      // Set before printing, so the deferred success banner is suppressed even\n      // if displaying the error yields.\n      this.fatalAsyncErrorReported = true;\n\n      displayCommandError(command.name, error);\n\n      if (!command.isPersistent) {\n        exitAfterFlush(1);\n      }\n    };\n\n    process.on(\"unhandledRejection\", onFatalAsyncError);\n    process.on(\"uncaughtException\", onFatalAsyncError);\n  }\n\n  /**\n   * Load preloaders\n   */\n  protected async loadPreloaders(command: CLICommand) {\n    const preloaders = command.commandPreload || {};\n\n    if (preloaders.runtimeStrategy) {\n      Application.setRuntimeStrategy(preloaders.runtimeStrategy);\n    }\n\n    // Override, not a default: a command that declares an environment gets it\n    // regardless of what the shell exported. Then read it back — `process.env`\n    // is process-global and anything may have written to it, so a value that\n    // did not take must fail here, loudly, rather than surface later as a\n    // production React bundle under `warlock dev`.\n    if (preloaders.environment) {\n      Application.setEnvironment(preloaders.environment);\n\n      if (process.env.NODE_ENV !== preloaders.environment) {\n        throw new Error(\n          `Command \"${command.name}\" set NODE_ENV to \"${preloaders.environment}\", but it read back as ` +\n            `\"${process.env.NODE_ENV}\". The environment did not take, and every decision made ` +\n            `downstream of it — env file selection, bundler dep optimisation — would be wrong.`,\n        );\n      }\n    }\n\n    // Env BEFORE config, unconditionally, for every command.\n    //\n    // `warlock.config.ts` is a module whose body runs on import, and projects\n    // legitimately call `env(\"BUILD_OUT\", \"dist\")` in it. Loading config first\n    // evaluated that body against an empty env store, so every such call\n    // silently returned its default — under `build` and `start`, which never\n    // loaded env at all, and under `dev` too, because config was loaded first\n    // regardless. The ordering is load-bearing in the other direction as well:\n    // `loadEnv()` reads `process.env.NODE_ENV` at call time to choose\n    // `.env.<NODE_ENV>` over `.env`, so it must follow `setEnvironment` above.\n    await loadEnvironmentFiles();\n\n    await warlockConfigManager.load();\n\n    if (preloaders.config || preloaders.bootstrap || preloaders.prestart) {\n      await filesOrchestrator.init();\n    }\n\n    // `preloaders.env` is gone: env is loaded above for every command, so the\n    // branch that used to serve it could only re-parse the same files and\n    // re-override `process.env` a second time.\n    if (preloaders.bootstrap) {\n      await bootstrap();\n\n      if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\n        await filesOrchestrator.load(\"src/app/bootstrap.ts\");\n      }\n    }\n\n    // Load configuration files\n    if (preloaders.config) {\n      await loadConfigFiles(preloaders.config);\n    }\n\n    if (preloaders.prestart) {\n      if (await fileExistsAsync(appPath(\"prestart.ts\"))) {\n        await filesOrchestrator.load(\"src/app/prestart.ts\");\n      }\n    }\n\n    // Initialize connectors.\n    // `connectors: true` only starts the early phase here — late-phase\n    // connectors (http, socket) start after the command's action loads\n    // app code. Explicit lists bypass phase splitting (caller knows\n    // exactly which connectors they want).\n    if (preloaders.connectors) {\n      // REGISTER before starting — the non-bundled counterpart of section 2.5\n      // of the generated production entry, and the \"dev preloader\" path\n      // `register-configured-connectors.ts` documents.\n      //\n      // Without this, `warlock.config.ts > connectors` drove the BUILD only:\n      // `warlock build` read the array to drain each connector's contribution,\n      // but under `warlock dev` nothing ever registered it, so an app had to\n      // call `connectorsManager.register(...)` from its own `main.ts` to get a\n      // connector running. Apps that did BOTH then registered the same\n      // connector twice in production — once here from the baked config, once\n      // from their own app code — and it booted twice, which surfaced as\n      // `Route name \"...\" is already taken` while installing page routes.\n      //\n      // The array is omitted deliberately, so the function reads the config\n      // loaded above; `expectedNames` is omitted too, because drift is a\n      // build↔runtime relationship and dev has no build to drift from.\n      //\n      // The idempotency this function provides is against ITSELF — a second\n      // call skips names the first registered. It does NOT protect against an\n      // app calling `connectorsManager.register()` directly, which pushes\n      // unconditionally, and which runs AFTER this point in both modes. So a\n      // connector belongs in the config array or in app code, never both:\n      // listing it in both is the duplicate this comment's route-name error\n      // describes.\n      registerConfiguredConnectors();\n\n      // Fail fast on a busy port BEFORE the early-phase connectors (database,\n      // cache, ...) connect. `http` itself is a LATE-phase connector, so its\n      // own preflight is not reached until after those early connectors are\n      // up and every app module has been imported — 7-13s of work discarded\n      // before anyone learns the port was taken. This is the dev-preload\n      // counterpart of the check the generated production entry runs at the\n      // same point in its own boot sequence (`production-builder.ts`, step\n      // 2.6) — a cheap bind-and-release probe, not a connector reorder.\n      // Only when this boot will actually start http: a scoped list without\n      // \"http\" (seed, migrate, …) never binds the port, so probing it would\n      // collide with a running dev server on a port it never uses (f9ace89e).\n      if (shouldPreflightHttpPort(preloaders.connectors)) {\n        await preflightConfiguredHttpPort();\n      }\n\n      if (preloaders.connectors === true) {\n        await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\n      } else {\n        await connectorsManager.start(preloaders.connectors);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { getWarlockVersion } from "../utils/framework-vesion.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/cli/cli-commands.utils.ts
+//#region ../../packages/core/src/cli/cli-commands.utils.ts
 function isMatchingCommandName(commandName, targetingCommandName) {
 	return commandName.split(" ")[0] === targetingCommandName;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cli-commands.utils.mjs","names":[],"sources":["../../../../../../../core/src/cli/cli-commands.utils.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Environment } from \"../utils\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\n\nexport function isMatchingCommandName(commandName: string, targetingCommandName: string) {\n  return commandName.split(\" \")[0] === targetingCommandName;\n}\n\n/**\n * Display the Warlock.js version banner\n */\nexport async function displayWarlockVersionInTerminal() {\n  const version = await getWarlockVersion();\n  console.log(`⚡ ${colors.bold(\"Warlock.js\")} ${colors.greenBright(`v${version}`)}`);\n}\n\ntype StartBannerOptions = {\n  environment: Environment;\n};\n\nfunction getTextColorMethod(environment: Environment) {\n  switch (environment) {\n    case \"development\":\n      return colors.yellowBright;\n    case \"production\":\n      return colors.greenBright;\n    case \"test\":\n      return colors.blueBright;\n    default:\n      return colors.whiteBright;\n  }\n}\n\n/**\n * Display CLI startup banner\n */\nexport async function displayStartupBanner({ environment }: StartBannerOptions) {\n  const version = await getWarlockVersion();\n  const textColorMethod = getTextColorMethod(environment);\n  console.log(`  ⚡ ${colors.bold(textColorMethod(\"Warlock.js\"))} ${colors.dim(`v${version}`)}`);\n  console.log();\n}\n\ntype ProductionReadyBannerOptions = {\n  bootDurationMs?: number;\n};\n\n/**\n * Announce that the production server is up — printed on **stdout**, and only\n * after the child process reported a completed boot.\n *\n * Stdout is the channel a supervisor or CI gate greps to decide the service is\n * healthy, so nothing optimistic may be written to it: this function is the\n * single place allowed to say \"started\", and it is called from exactly one\n * place, the `warlock:ready` handler in the `start` command.\n */\nexport async function displayProductionReadyBanner({\n  bootDurationMs,\n}: ProductionReadyBannerOptions = {}) {\n  const version = await getWarlockVersion();\n  const duration = bootDurationMs ? colors.dim(` in ${bootDurationMs}ms`) : \"\";\n\n  console.log(\n    `  ⚡ ${colors.bold(colors.greenBright(\"Warlock.js\"))} ${colors.dim(`v${version}`)} ${colors.green(\"✔\")} production server started${duration}`,\n  );\n  console.log();\n}\n\n/**\n * Report that the production server died before it ever served anything.\n *\n * Written to **stderr** only. `warlock start` inherits both child streams, and\n * production launchers commonly merge them (`2>&1`), so mirroring this block to\n * stdout prints every line twice. The command's non-zero exit code is the\n * machine-readable failure signal; stdout remains reserved for the ready\n * banner.\n *\n * `causeWasCaptured` gates the \"the cause is printed above\" line. The\n * supervisor cannot always guarantee the child wrote anything before it\n * died — an import that throws before the logger configures its channels,\n * a bundle with no console channel at all — and claiming a cause is above\n * when nothing was ever captured sends the developer looking for output\n * that doesn't exist, which is worse than admitting the gap.\n */\nexport function displayProductionStartFailure(exitCode: number, causeWasCaptured: boolean) {\n  const causeLine = causeWasCaptured\n    ? `  ${colors.dim(\"the cause is printed above, in the application's own output\")}`\n    : `  ${colors.dim(\"no output was captured from the application process — its cause did not reach this terminal\")}`;\n\n  const lines = [\n    \"\",\n    `  ${colors.red(\"✖\")} ${colors.bold(\"warlock start\")} failed — the server never finished booting`,\n    `  ${colors.dim(`the application process exited with code ${exitCode}`)}`,\n    causeLine,\n    \"\",\n  ];\n\n  for (const line of lines) {\n    console.error(line);\n  }\n}\n\n/**\n * Note that a running child has not reported readiness yet.\n *\n * Emitted on **stderr** only. The process may be perfectly healthy — an older\n * bundle has no readiness signal at all — so saying anything on stdout would be\n * the very false-green this channel exists to prevent.\n *\n * The wording offers the likely causes rather than asserting one. It cannot\n * distinguish an old bundle from a slow boot from a boot that is about to fail,\n * and an earlier version claimed \"the bundle predates readiness reporting\" —\n * which was simply wrong when a current bundle was mid-crash, and sent the\n * reader after the wrong thing.\n */\nexport function displayMissingReadinessNotice(waitedMs: number) {\n  console.error();\n  console.error(\n    `  ${colors.yellow(\"!\")} still running after ${Math.round(waitedMs / 1000)}s with no readiness signal`,\n  );\n  console.error(\n    `  ${colors.dim(\"either the boot is still in progress, or this bundle was built\")}`,\n  );\n  console.error(\n    `  ${colors.dim(\"before readiness reporting — re-run\")} ${colors.cyan(\"warlock build\")} ${colors.dim(\"if the banner never appears\")}`,\n  );\n  console.error();\n}\n\n/**\n * Display command execution header.\n *\n * On stderr for the same reason as {@link displayCommandSuccess}: it prints\n * before every command, so on stdout it prefixed `warlock routes --json` with\n * `› Running routes...` and the payload no longer parsed.\n */\nexport function displayExecutingCommand(commandName: string) {\n  console.error(`  ${colors.cyan(\"›\")} Running ${colors.bold(colors.white(commandName))}...`);\n  console.error();\n}\n\n/**\n * Display command not found error with optional suggestions\n */\nexport function displayCommandNotFound(commandName: string, suggestions?: string[]) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} Command ${colors.magenta(commandName)} not found`);\n\n  if (suggestions && suggestions.length > 0) {\n    console.log();\n    console.log(`  ${colors.yellow(\"Did you mean?\")}`);\n    suggestions.forEach((suggestion) => {\n      console.log(`    ${colors.cyan(\"→\")} ${colors.white(suggestion)}`);\n    });\n  }\n\n  console.log();\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock --help\")} ${colors.dim(\"to see available commands\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display missing command error\n */\nexport function displayMissingCommand() {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} No command specified`);\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock --help\")} ${colors.dim(\"to see available commands\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display command success message.\n *\n * Written to STDERR, not stdout. This banner is printed around EVERY command,\n * including ones whose stdout is a machine payload a script is meant to parse —\n * `warlock routes --json` is the clearest case. On stdout it produced this,\n * which is not JSON and cannot be piped anywhere:\n *\n * ```\n * []\n *\n *   ✔ routes completed successfully (696ms)\n * ```\n *\n * stdout belongs to the command's output; status chrome belongs to stderr,\n * where it stays visible to a person in a terminal and out of a pipe.\n */\nexport function displayCommandSuccess(commandName: string, durationMs?: number) {\n  const duration = durationMs ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.error();\n  console.error(\n    `  ${colors.green(\"✔\")} ${colors.bold(commandName)} completed successfully${duration}`,\n  );\n  console.error();\n}\n\n/**\n * Display command error message.\n *\n * On stderr for the same reason as {@link displayCommandSuccess}, and one\n * stronger: a failure interleaved into a machine payload corrupts the payload\n * AND hides the failure from anyone reading stderr for it.\n */\nexport function displayCommandError(commandName: string, error: Error) {\n  console.error();\n  console.error(`  ${colors.red(\"✖\")} ${colors.bold(commandName)} failed`);\n  console.error(`  ${colors.dim(error.message)}`);\n  console.error();\n}\n\n/**\n * Display a FATAL boot/preload failure and exit information.\n *\n * Preload failures — a bad import in a config file, a connector that throws\n * on startup, a missing module export — happen BEFORE the command's run loop\n * exists, so there is nothing to recover into: they are always fatal. Unlike\n * `displayCommandError`, this prints the full stack (not just `error.message`)\n * because the stack names the exact file + line of the offending import, which\n * is the single most useful clue when a config file pulls in a broken module.\n *\n * Surfacing this loudly is the difference between a clear error and a silent\n * hang: an unhandled preload rejection used to escape while the already-started\n * loader worker thread kept the process alive, leaving `warlock dev` frozen\n * just after the banner with no message at all.\n *\n * @example\n * // SyntaxError: The requested module '@warlock.js/cascade' does not\n * //   provide an export named 'belongsTo'\n * //   at src/app/.../permission.model.ts:2\n */\nexport function displayBootError(commandName: string, error: Error) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} ${colors.bold(commandName)} failed to start`);\n  console.log(`  ${colors.red(error.message)}`);\n  if (error.stack) {\n    console.log();\n    console.log(colors.dim(error.stack));\n  }\n  console.log();\n}\n\n/**\n * Display missing required options error\n */\nexport function displayMissingOptions(options: { name: string; text: string }[]) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} Missing required options:`);\n  options.forEach((opt) => {\n    console.log(`     ${colors.yellow(opt.text)} ${colors.dim(`(--${opt.name})`)}`);\n  });\n  console.log();\n}\n\n/**\n * Command info for help display\n */\nexport type HelpCommandInfo = {\n  name: string;\n  alias?: string;\n  description?: string;\n  source: \"framework\" | \"plugin\" | \"project\";\n};\n\n/**\n * Display global help with all commands grouped by source\n */\nexport async function displayHelp(commands: HelpCommandInfo[]) {\n  const version = await getWarlockVersion();\n\n  console.log();\n  console.log(\n    `  ⚡ ${colors.bold(colors.yellowBright(\"Warlock.js\"))} CLI ${colors.dim(`v${version}`)}`,\n  );\n  console.log();\n  console.log(\n    `  ${colors.bold(\"Usage:\")} ${colors.cyan(\"warlock\")} ${colors.dim(\"<command>\")} ${colors.dim(\"[options]\")}`,\n  );\n  console.log();\n\n  // Group by source\n  const grouped: Record<string, HelpCommandInfo[]> = {\n    framework: [],\n    plugin: [],\n    project: [],\n  };\n\n  commands.forEach((cmd) => {\n    grouped[cmd.source]?.push(cmd);\n  });\n\n  // Display each group\n  const groupLabels: Record<string, string> = {\n    framework: \"Framework Commands\",\n    plugin: \"Plugin Commands\",\n    project: \"Project Commands\",\n  };\n\n  for (const [source, cmds] of Object.entries(grouped)) {\n    if (cmds.length === 0) continue;\n\n    console.log(`  ${colors.bold(colors.white(groupLabels[source]))}`);\n    console.log();\n\n    // Find max name length for alignment\n    const maxLen = Math.max(...cmds.map((c) => c.name.length + (c.alias ? c.alias.length + 4 : 0)));\n\n    cmds.forEach((cmd) => {\n      const aliasStr = cmd.alias ? colors.dim(` (${cmd.alias})`) : \"\";\n      const nameWithAlias = cmd.name + (cmd.alias ? ` (${cmd.alias})` : \"\");\n      const padding = \" \".repeat(maxLen - nameWithAlias.length + 2);\n      // const desc = cmd.description || colors.dim(\"No description\");\n      const desc = cmd.description || \"\";\n      console.log(`    ${colors.cyan(cmd.name)}${aliasStr}${padding}${desc}`);\n    });\n    console.log();\n  }\n\n  // Display global flags\n  console.log(`  ${colors.bold(colors.white(\"Global Flags\"))}`);\n  console.log();\n\n  const globalFlags = [\n    { flag: \"--help, -h\", description: \"Show help for a command\" },\n    { flag: \"--version, -v\", description: \"Show Warlock version\" },\n    { flag: \"--no-cache\", description: \"Force reload without cache\" },\n    { flag: \"--warm-cache\", description: \"Pre-cache all project commands\" },\n  ];\n\n  const maxFlagLen = Math.max(...globalFlags.map((f) => f.flag.length));\n\n  globalFlags.forEach(({ flag, description }) => {\n    const padding = \" \".repeat(maxFlagLen - flag.length + 2);\n    console.log(`    ${colors.yellow(flag)}${padding}${description}`);\n  });\n  console.log();\n\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock <command> --help\")} ${colors.dim(\"for command-specific help\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display help for a specific command\n */\nexport function displayCommandHelp(command: {\n  name: string;\n  alias?: string;\n  description?: string;\n  options?: { name: string; text: string; description?: string; required?: boolean }[];\n}) {\n  console.log();\n  console.log(\n    `  ${colors.bold(colors.cyan(command.name))}${command.alias ? colors.dim(` (${command.alias})`) : \"\"}`,\n  );\n\n  if (command.description) {\n    console.log(`  ${command.description}`);\n  }\n  console.log();\n\n  if (command.options && command.options.length > 0) {\n    console.log(`  ${colors.bold(\"Options:\")}`);\n    console.log();\n\n    const maxLen = Math.max(...command.options.map((o) => o.text.length));\n\n    command.options.forEach((opt) => {\n      const padding = \" \".repeat(maxLen - opt.text.length + 2);\n      const required = opt.required ? colors.red(\" (required)\") : \"\";\n      const desc = opt.description || \"\";\n      console.log(`    ${colors.green(opt.text)}${padding}${desc}${required}`);\n    });\n    console.log();\n  } else {\n    console.log(`  ${colors.dim(\"No options available\")}`);\n    console.log();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli-commands.utils.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/cli-commands.utils.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Environment } from \"../utils\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\n\nexport function isMatchingCommandName(commandName: string, targetingCommandName: string) {\n  return commandName.split(\" \")[0] === targetingCommandName;\n}\n\n/**\n * Display the Warlock.js version banner\n */\nexport async function displayWarlockVersionInTerminal() {\n  const version = await getWarlockVersion();\n  console.log(`⚡ ${colors.bold(\"Warlock.js\")} ${colors.greenBright(`v${version}`)}`);\n}\n\ntype StartBannerOptions = {\n  environment: Environment;\n};\n\nfunction getTextColorMethod(environment: Environment) {\n  switch (environment) {\n    case \"development\":\n      return colors.yellowBright;\n    case \"production\":\n      return colors.greenBright;\n    case \"test\":\n      return colors.blueBright;\n    default:\n      return colors.whiteBright;\n  }\n}\n\n/**\n * Display CLI startup banner\n */\nexport async function displayStartupBanner({ environment }: StartBannerOptions) {\n  const version = await getWarlockVersion();\n  const textColorMethod = getTextColorMethod(environment);\n  console.log(`  ⚡ ${colors.bold(textColorMethod(\"Warlock.js\"))} ${colors.dim(`v${version}`)}`);\n  console.log();\n}\n\ntype ProductionReadyBannerOptions = {\n  bootDurationMs?: number;\n};\n\n/**\n * Announce that the production server is up — printed on **stdout**, and only\n * after the child process reported a completed boot.\n *\n * Stdout is the channel a supervisor or CI gate greps to decide the service is\n * healthy, so nothing optimistic may be written to it: this function is the\n * single place allowed to say \"started\", and it is called from exactly one\n * place, the `warlock:ready` handler in the `start` command.\n */\nexport async function displayProductionReadyBanner({\n  bootDurationMs,\n}: ProductionReadyBannerOptions = {}) {\n  const version = await getWarlockVersion();\n  const duration = bootDurationMs ? colors.dim(` in ${bootDurationMs}ms`) : \"\";\n\n  console.log(\n    `  ⚡ ${colors.bold(colors.greenBright(\"Warlock.js\"))} ${colors.dim(`v${version}`)} ${colors.green(\"✔\")} production server started${duration}`,\n  );\n  console.log();\n}\n\n/**\n * Report that the production server died before it ever served anything.\n *\n * Written to **stderr** only. `warlock start` inherits both child streams, and\n * production launchers commonly merge them (`2>&1`), so mirroring this block to\n * stdout prints every line twice. The command's non-zero exit code is the\n * machine-readable failure signal; stdout remains reserved for the ready\n * banner.\n *\n * `causeWasCaptured` gates the \"the cause is printed above\" line. The\n * supervisor cannot always guarantee the child wrote anything before it\n * died — an import that throws before the logger configures its channels,\n * a bundle with no console channel at all — and claiming a cause is above\n * when nothing was ever captured sends the developer looking for output\n * that doesn't exist, which is worse than admitting the gap.\n */\nexport function displayProductionStartFailure(exitCode: number, causeWasCaptured: boolean) {\n  const causeLine = causeWasCaptured\n    ? `  ${colors.dim(\"the cause is printed above, in the application's own output\")}`\n    : `  ${colors.dim(\"no output was captured from the application process — its cause did not reach this terminal\")}`;\n\n  const lines = [\n    \"\",\n    `  ${colors.red(\"✖\")} ${colors.bold(\"warlock start\")} failed — the server never finished booting`,\n    `  ${colors.dim(`the application process exited with code ${exitCode}`)}`,\n    causeLine,\n    \"\",\n  ];\n\n  for (const line of lines) {\n    console.error(line);\n  }\n}\n\n/**\n * Note that a running child has not reported readiness yet.\n *\n * Emitted on **stderr** only. The process may be perfectly healthy — an older\n * bundle has no readiness signal at all — so saying anything on stdout would be\n * the very false-green this channel exists to prevent.\n *\n * The wording offers the likely causes rather than asserting one. It cannot\n * distinguish an old bundle from a slow boot from a boot that is about to fail,\n * and an earlier version claimed \"the bundle predates readiness reporting\" —\n * which was simply wrong when a current bundle was mid-crash, and sent the\n * reader after the wrong thing.\n */\nexport function displayMissingReadinessNotice(waitedMs: number) {\n  console.error();\n  console.error(\n    `  ${colors.yellow(\"!\")} still running after ${Math.round(waitedMs / 1000)}s with no readiness signal`,\n  );\n  console.error(\n    `  ${colors.dim(\"either the boot is still in progress, or this bundle was built\")}`,\n  );\n  console.error(\n    `  ${colors.dim(\"before readiness reporting — re-run\")} ${colors.cyan(\"warlock build\")} ${colors.dim(\"if the banner never appears\")}`,\n  );\n  console.error();\n}\n\n/**\n * Display command execution header.\n *\n * On stderr for the same reason as {@link displayCommandSuccess}: it prints\n * before every command, so on stdout it prefixed `warlock routes --json` with\n * `› Running routes...` and the payload no longer parsed.\n */\nexport function displayExecutingCommand(commandName: string) {\n  console.error(`  ${colors.cyan(\"›\")} Running ${colors.bold(colors.white(commandName))}...`);\n  console.error();\n}\n\n/**\n * Display command not found error with optional suggestions\n */\nexport function displayCommandNotFound(commandName: string, suggestions?: string[]) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} Command ${colors.magenta(commandName)} not found`);\n\n  if (suggestions && suggestions.length > 0) {\n    console.log();\n    console.log(`  ${colors.yellow(\"Did you mean?\")}`);\n    suggestions.forEach((suggestion) => {\n      console.log(`    ${colors.cyan(\"→\")} ${colors.white(suggestion)}`);\n    });\n  }\n\n  console.log();\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock --help\")} ${colors.dim(\"to see available commands\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display missing command error\n */\nexport function displayMissingCommand() {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} No command specified`);\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock --help\")} ${colors.dim(\"to see available commands\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display command success message.\n *\n * Written to STDERR, not stdout. This banner is printed around EVERY command,\n * including ones whose stdout is a machine payload a script is meant to parse —\n * `warlock routes --json` is the clearest case. On stdout it produced this,\n * which is not JSON and cannot be piped anywhere:\n *\n * ```\n * []\n *\n *   ✔ routes completed successfully (696ms)\n * ```\n *\n * stdout belongs to the command's output; status chrome belongs to stderr,\n * where it stays visible to a person in a terminal and out of a pipe.\n */\nexport function displayCommandSuccess(commandName: string, durationMs?: number) {\n  const duration = durationMs ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.error();\n  console.error(\n    `  ${colors.green(\"✔\")} ${colors.bold(commandName)} completed successfully${duration}`,\n  );\n  console.error();\n}\n\n/**\n * Display command error message.\n *\n * On stderr for the same reason as {@link displayCommandSuccess}, and one\n * stronger: a failure interleaved into a machine payload corrupts the payload\n * AND hides the failure from anyone reading stderr for it.\n */\nexport function displayCommandError(commandName: string, error: Error) {\n  console.error();\n  console.error(`  ${colors.red(\"✖\")} ${colors.bold(commandName)} failed`);\n  console.error(`  ${colors.dim(error.message)}`);\n  console.error();\n}\n\n/**\n * Display a FATAL boot/preload failure and exit information.\n *\n * Preload failures — a bad import in a config file, a connector that throws\n * on startup, a missing module export — happen BEFORE the command's run loop\n * exists, so there is nothing to recover into: they are always fatal. Unlike\n * `displayCommandError`, this prints the full stack (not just `error.message`)\n * because the stack names the exact file + line of the offending import, which\n * is the single most useful clue when a config file pulls in a broken module.\n *\n * Surfacing this loudly is the difference between a clear error and a silent\n * hang: an unhandled preload rejection used to escape while the already-started\n * loader worker thread kept the process alive, leaving `warlock dev` frozen\n * just after the banner with no message at all.\n *\n * @example\n * // SyntaxError: The requested module '@warlock.js/cascade' does not\n * //   provide an export named 'belongsTo'\n * //   at src/app/.../permission.model.ts:2\n */\nexport function displayBootError(commandName: string, error: Error) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} ${colors.bold(commandName)} failed to start`);\n  console.log(`  ${colors.red(error.message)}`);\n  if (error.stack) {\n    console.log();\n    console.log(colors.dim(error.stack));\n  }\n  console.log();\n}\n\n/**\n * Display missing required options error\n */\nexport function displayMissingOptions(options: { name: string; text: string }[]) {\n  console.log();\n  console.log(`  ${colors.red(\"✖\")} Missing required options:`);\n  options.forEach((opt) => {\n    console.log(`     ${colors.yellow(opt.text)} ${colors.dim(`(--${opt.name})`)}`);\n  });\n  console.log();\n}\n\n/**\n * Command info for help display\n */\nexport type HelpCommandInfo = {\n  name: string;\n  alias?: string;\n  description?: string;\n  source: \"framework\" | \"plugin\" | \"project\";\n};\n\n/**\n * Display global help with all commands grouped by source\n */\nexport async function displayHelp(commands: HelpCommandInfo[]) {\n  const version = await getWarlockVersion();\n\n  console.log();\n  console.log(\n    `  ⚡ ${colors.bold(colors.yellowBright(\"Warlock.js\"))} CLI ${colors.dim(`v${version}`)}`,\n  );\n  console.log();\n  console.log(\n    `  ${colors.bold(\"Usage:\")} ${colors.cyan(\"warlock\")} ${colors.dim(\"<command>\")} ${colors.dim(\"[options]\")}`,\n  );\n  console.log();\n\n  // Group by source\n  const grouped: Record<string, HelpCommandInfo[]> = {\n    framework: [],\n    plugin: [],\n    project: [],\n  };\n\n  commands.forEach((cmd) => {\n    grouped[cmd.source]?.push(cmd);\n  });\n\n  // Display each group\n  const groupLabels: Record<string, string> = {\n    framework: \"Framework Commands\",\n    plugin: \"Plugin Commands\",\n    project: \"Project Commands\",\n  };\n\n  for (const [source, cmds] of Object.entries(grouped)) {\n    if (cmds.length === 0) continue;\n\n    console.log(`  ${colors.bold(colors.white(groupLabels[source]))}`);\n    console.log();\n\n    // Find max name length for alignment\n    const maxLen = Math.max(...cmds.map((c) => c.name.length + (c.alias ? c.alias.length + 4 : 0)));\n\n    cmds.forEach((cmd) => {\n      const aliasStr = cmd.alias ? colors.dim(` (${cmd.alias})`) : \"\";\n      const nameWithAlias = cmd.name + (cmd.alias ? ` (${cmd.alias})` : \"\");\n      const padding = \" \".repeat(maxLen - nameWithAlias.length + 2);\n      // const desc = cmd.description || colors.dim(\"No description\");\n      const desc = cmd.description || \"\";\n      console.log(`    ${colors.cyan(cmd.name)}${aliasStr}${padding}${desc}`);\n    });\n    console.log();\n  }\n\n  // Display global flags\n  console.log(`  ${colors.bold(colors.white(\"Global Flags\"))}`);\n  console.log();\n\n  const globalFlags = [\n    { flag: \"--help, -h\", description: \"Show help for a command\" },\n    { flag: \"--version, -v\", description: \"Show Warlock version\" },\n    { flag: \"--no-cache\", description: \"Force reload without cache\" },\n    { flag: \"--warm-cache\", description: \"Pre-cache all project commands\" },\n  ];\n\n  const maxFlagLen = Math.max(...globalFlags.map((f) => f.flag.length));\n\n  globalFlags.forEach(({ flag, description }) => {\n    const padding = \" \".repeat(maxFlagLen - flag.length + 2);\n    console.log(`    ${colors.yellow(flag)}${padding}${description}`);\n  });\n  console.log();\n\n  console.log(\n    `  ${colors.dim(\"Run\")} ${colors.cyan(\"warlock <command> --help\")} ${colors.dim(\"for command-specific help\")}`,\n  );\n  console.log();\n}\n\n/**\n * Display help for a specific command\n */\nexport function displayCommandHelp(command: {\n  name: string;\n  alias?: string;\n  description?: string;\n  options?: { name: string; text: string; description?: string; required?: boolean }[];\n}) {\n  console.log();\n  console.log(\n    `  ${colors.bold(colors.cyan(command.name))}${command.alias ? colors.dim(` (${command.alias})`) : \"\"}`,\n  );\n\n  if (command.description) {\n    console.log(`  ${command.description}`);\n  }\n  console.log();\n\n  if (command.options && command.options.length > 0) {\n    console.log(`  ${colors.bold(\"Options:\")}`);\n    console.log();\n\n    const maxLen = Math.max(...command.options.map((o) => o.text.length));\n\n    command.options.forEach((opt) => {\n      const padding = \" \".repeat(maxLen - opt.text.length + 2);\n      const required = opt.required ? colors.red(\" (required)\") : \"\";\n      const desc = opt.description || \"\";\n      console.log(`    ${colors.green(opt.text)}${padding}${desc}${required}`);\n    });\n    console.log();\n  } else {\n    console.log(`  ${colors.dim(\"No options available\")}`);\n    console.log();\n  }\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,12 @@
 import { command } from "../../commands/cli-command.mjs";
+import { generationOutputOptions, runGenerationCommand } from "../../generations/generation-run.mjs";
 import { addCommandAction } from "../../generations/add-command.action.mjs";
 
-//#region ../core/src/cli/commands/add.command.ts
+//#region ../../packages/core/src/cli/commands/add.command.ts
 const addCommand = command({
 	name: "add <features...>",
 	description: "Add new feature(s) to the project",
-	action: addCommandAction,
+	action: (data) => runGenerationCommand("add", data, addCommandAction),
 	options: [
 		{
 			text: "--package-manager, -pm",
@@ -20,7 +21,8 @@ const addCommand = command({
 			text: "--no-install",
 			description: "Record dependencies in package.json without installing them — still ejects configs, adds scripts, and runs setup hooks. Used by scaffolders that run a single install afterwards.",
 			type: "boolean"
-		}
+		},
+		...generationOutputOptions
 	]
 });
 

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

@@ -1 +1 @@
-{"version":3,"file":"add.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/add.command.ts"],"sourcesContent":["import { addCommandAction } from \"../../generations/add-command.action\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const addCommand = command({\n  name: \"add <features...>\",\n  description: \"Add new feature(s) to the project\",\n  action: addCommandAction,\n  options: [\n    {\n      text: \"--package-manager, -pm\",\n      description: \"Package manager to use, if not passed, it will be detected automatically\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"List available features\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--no-install\",\n      description:\n        \"Record dependencies in package.json without installing them — still ejects configs, adds scripts, and runs setup hooks. Used by scaffolders that run a single install afterwards.\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,aAAa,QAAQ;CAChC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,SAAS;EACP;GACE,MAAM;GACN,aAAa;EACf;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"add.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/add.command.ts"],"sourcesContent":["import { addCommandAction } from \"../../generations/add-command.action\";\nimport { generationOutputOptions, runGenerationCommand } from \"../../generations/generation-run\";\nimport { command } from \"../../commands/cli-command\";\n\nexport const addCommand = command({\n  name: \"add <features...>\",\n  description: \"Add new feature(s) to the project\",\n  action: (data) => runGenerationCommand(\"add\", data, addCommandAction),\n  options: [\n    {\n      text: \"--package-manager, -pm\",\n      description: \"Package manager to use, if not passed, it will be detected automatically\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"List available features\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--no-install\",\n      description:\n        \"Record dependencies in package.json without installing them — still ejects configs, adds scripts, and runs setup hooks. Used by scaffolders that run a single install afterwards.\",\n      type: \"boolean\",\n    },\n    ...generationOutputOptions,\n  ],\n});\n"],"mappings":";;;;;AAIA,MAAa,aAAa,QAAQ;CAChC,MAAM;CACN,aAAa;CACb,SAAS,SAAS,qBAAqB,OAAO,MAAM,gBAAgB;CACpE,SAAS;EACP;GACE,MAAM;GACN,aAAa;EACf;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA,GAAG;CACL;AACF,CAAC"}

package/esm/cli/commands/agents-md/agents-md-command.action.mjs

@@ -0,0 +1,69 @@
+import { AGENTS_MD_FILE } from "../../../tooling/agents-md/agents-md-markers.mjs";
+import { listInstalledSkills } from "../../../tooling/agents-md/installed-skills.mjs";
+import { listAppModules, renderAgentsMdSection } from "../../../tooling/agents-md/render-agents-md.mjs";
+import { writeAgentsMd } from "../../../tooling/agents-md/write-agents-md.mjs";
+import { bootForInspect, inspectOptionsFromBoot } from "../../../tooling/inspect/boot-for-inspect.mjs";
+import { inspectApp } from "../../../tooling/inspect/inspect-app.mjs";
+import { withConsoleOnStderr } from "../routes/with-console-on-stderr.mjs";
+import path from "node:path";
+
+//#region ../../packages/core/src/cli/commands/agents-md/agents-md-command.action.ts
+/** The inspect sections the generated section reads. */
+const AGENTS_MD_SECTIONS = [
+	"routes",
+	"models",
+	"packages"
+];
+/** The one line `warlock agents-md --write` prints. */
+function formatWriteStatus(result) {
+	const file = path.relative(process.cwd(), result.file) || "AGENTS.md";
+	switch (result.status) {
+		case "created": return `Created ${file} with the generated section.`;
+		case "updated": return `Updated the generated section of ${file}.`;
+		case "unchanged": return `${file} is up to date.`;
+		default: return `${file} does not exist; nothing written.`;
+	}
+}
+/**
+* Action behind `warlock agents-md`.
+*
+* Boots the app read-only (the inspect boot pass) with boot output on stderr,
+* then prints the section (no flag), writes it (`--write`) or prints
+* `{ file, status, section }` (`--json`; `status` is `"printed"` without
+* `--write`). Malformed markers throw `WL7501` and nothing is written.
+*
+* @param data Parsed CLI args: `options.write`, `options.json`.
+*/
+async function agentsMdCommandAction({ options }) {
+	const cwd = process.cwd();
+	const report = await inspectApp({
+		...inspectOptionsFromBoot(await withConsoleOnStderr(() => bootForInspect(cwd))),
+		cwd,
+		sections: AGENTS_MD_SECTIONS
+	});
+	if (options.write === true) {
+		const result = writeAgentsMd({
+			cwd,
+			report
+		});
+		console.log(options.json === true ? JSON.stringify(result, null, 2) : formatWriteStatus(result));
+		return;
+	}
+	const section = renderAgentsMdSection(report, {
+		skills: listInstalledSkills(cwd),
+		modules: listAppModules(cwd)
+	});
+	if (options.json === true) {
+		console.log(JSON.stringify({
+			file: path.join(cwd, AGENTS_MD_FILE),
+			status: "printed",
+			section
+		}, null, 2));
+		return;
+	}
+	process.stdout.write(section);
+}
+
+//#endregion
+export { agentsMdCommandAction };
+//# sourceMappingURL=agents-md-command.action.mjs.map

package/esm/cli/commands/agents-md/agents-md-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/agents-md/agents-md-command.action.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { AGENTS_MD_FILE } from \"../../../tooling/agents-md/agents-md-markers\";\nimport { listInstalledSkills } from \"../../../tooling/agents-md/installed-skills\";\nimport { listAppModules, renderAgentsMdSection } from \"../../../tooling/agents-md/render-agents-md\";\nimport {\n  writeAgentsMd,\n  type WriteAgentsMdResult,\n} from \"../../../tooling/agents-md/write-agents-md\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp } from \"../../../tooling/inspect/inspect-app\";\nimport type { InspectSection } from \"../../../tooling/inspect/inspect-report.types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\n/** The inspect sections the generated section reads. */\nexport const AGENTS_MD_SECTIONS: readonly InspectSection[] = [\"routes\", \"models\", \"packages\"];\n\n/** The one line `warlock agents-md --write` prints. */\nexport function formatWriteStatus(result: Pick<WriteAgentsMdResult, \"file\" | \"status\">): string {\n  const file = path.relative(process.cwd(), result.file) || AGENTS_MD_FILE;\n\n  switch (result.status) {\n    case \"created\":\n      return `Created ${file} with the generated section.`;\n    case \"updated\":\n      return `Updated the generated section of ${file}.`;\n    case \"unchanged\":\n      return `${file} is up to date.`;\n    default:\n      return `${file} does not exist; nothing written.`;\n  }\n}\n\n/**\n * Action behind `warlock agents-md`.\n *\n * Boots the app read-only (the inspect boot pass) with boot output on stderr,\n * then prints the section (no flag), writes it (`--write`) or prints\n * `{ file, status, section }` (`--json`; `status` is `\"printed\"` without\n * `--write`). Malformed markers throw `WL7501` and nothing is written.\n *\n * @param data Parsed CLI args: `options.write`, `options.json`.\n */\nexport async function agentsMdCommandAction({ options }: CommandActionData): Promise<void> {\n  const cwd = process.cwd();\n  const boot = await withConsoleOnStderr(() => bootForInspect(cwd));\n  const report = await inspectApp({\n    ...inspectOptionsFromBoot(boot),\n    cwd,\n    sections: AGENTS_MD_SECTIONS,\n  });\n\n  if (options.write === true) {\n    const result = writeAgentsMd({ cwd, report });\n\n    console.log(\n      options.json === true ? JSON.stringify(result, null, 2) : formatWriteStatus(result),\n    );\n    return;\n  }\n\n  const section = renderAgentsMdSection(report, {\n    skills: listInstalledSkills(cwd),\n    modules: listAppModules(cwd),\n  });\n\n  if (options.json === true) {\n    console.log(\n      JSON.stringify({ file: path.join(cwd, AGENTS_MD_FILE), status: \"printed\", section }, null, 2),\n    );\n    return;\n  }\n\n  process.stdout.write(section);\n}\n"],"mappings":";;;;;;;;;;;AAeA,MAAa,qBAAgD;CAAC;CAAU;CAAU;AAAU;;AAG5F,SAAgB,kBAAkB,QAA8D;CAC9F,MAAM,OAAO,KAAK,SAAS,QAAQ,IAAI,GAAG,OAAO,IAAI;CAErD,QAAQ,OAAO,QAAf;EACE,KAAK,WACH,OAAO,WAAW,KAAK;EACzB,KAAK,WACH,OAAO,oCAAoC,KAAK;EAClD,KAAK,aACH,OAAO,GAAG,KAAK;EACjB,SACE,OAAO,GAAG,KAAK;CACnB;AACF;;;;;;;;;;;AAYA,eAAsB,sBAAsB,EAAE,WAA6C;CACzF,MAAM,MAAM,QAAQ,IAAI;CAExB,MAAM,SAAS,MAAM,WAAW;EAC9B,GAAG,uBAAuB,MAFT,0BAA0B,eAAe,GAAG,CAAC,CAEhC;EAC9B;EACA,UAAU;CACZ,CAAC;CAED,IAAI,QAAQ,UAAU,MAAM;EAC1B,MAAM,SAAS,cAAc;GAAE;GAAK;EAAO,CAAC;EAE5C,QAAQ,IACN,QAAQ,SAAS,OAAO,KAAK,UAAU,QAAQ,MAAM,CAAC,IAAI,kBAAkB,MAAM,CACpF;EACA;CACF;CAEA,MAAM,UAAU,sBAAsB,QAAQ;EAC5C,QAAQ,oBAAoB,GAAG;EAC/B,SAAS,eAAe,GAAG;CAC7B,CAAC;CAED,IAAI,QAAQ,SAAS,MAAM;EACzB,QAAQ,IACN,KAAK,UAAU;GAAE,MAAM,KAAK,KAAK,KAAK,cAAc;GAAG,QAAQ;GAAW;EAAQ,GAAG,MAAM,CAAC,CAC9F;EACA;CACF;CAEA,QAAQ,OAAO,MAAM,OAAO;AAC9B"}

package/esm/cli/commands/agents-md.command.mjs

@@ -0,0 +1,38 @@
+import { command } from "../../commands/cli-command.mjs";
+import { agentsMdCommandAction } from "./agents-md/agents-md-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/agents-md.command.ts
+/**
+* `warlock agents-md` — render the app-specific AGENTS.md section from the
+* booted app (modules, routes, models, conventions, installed skills, verify
+* commands). Prints it; `--write` puts it between the
+* `<!-- warlock:generated:start -->` / `end` markers of AGENTS.md, creating
+* the file when missing and never touching content outside the markers.
+*
+* Boots like `warlock inspect`: connectors boot but none starts, so no
+* connection opens and no port binds.
+*/
+const agentsMdCommand = command({
+	name: "agents-md",
+	description: "Generate the app-specific AGENTS.md section from the booted app; --write updates it between its markers",
+	action: agentsMdCommandAction,
+	preload: {
+		runtimeStrategy: "development",
+		config: true,
+		env: true,
+		bootstrap: true
+	},
+	options: [{
+		text: "--write, -w",
+		description: "Write the section into AGENTS.md between its markers (creates the file when missing)",
+		type: "boolean"
+	}, {
+		text: "--json, -j",
+		description: "Print { file, status, section } as JSON",
+		type: "boolean"
+	}]
+});
+
+//#endregion
+export { agentsMdCommand };
+//# sourceMappingURL=agents-md.command.mjs.map

package/esm/cli/commands/agents-md.command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/agents-md.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { agentsMdCommandAction } from \"./agents-md/agents-md-command.action\";\n\n/**\n * `warlock agents-md` — render the app-specific AGENTS.md section from the\n * booted app (modules, routes, models, conventions, installed skills, verify\n * commands). Prints it; `--write` puts it between the\n * `<!-- warlock:generated:start -->` / `end` markers of AGENTS.md, creating\n * the file when missing and never touching content outside the markers.\n *\n * Boots like `warlock inspect`: connectors boot but none starts, so no\n * connection opens and no port binds.\n */\nexport const agentsMdCommand = command({\n  name: \"agents-md\",\n  description:\n    \"Generate the app-specific AGENTS.md section from the booted app; --write updates it between its markers\",\n  action: agentsMdCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--write, -w\",\n      description:\n        \"Write the section into AGENTS.md between its markers (creates the file when missing)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Print { file, status, section } as JSON\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,kBAAkB,QAAQ;CACrC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,SAAS,CACP;EACE,MAAM;EACN,aACE;EACF,MAAM;CACR,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,CACF;AACF,CAAC"}