@warlock.js/core 5.31.0 → 5.32.0

package/esm/warlock-config/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;AAcA;;;KAAY,aAAA;EA8BF;;;EA1BR,MAAA;IAkKiD;;;IA9J/C,IAAA;IA+PkB;;;IA3PlB,IAAA;IAIA;;;IAAA,cAAA;EAAA;EA+BA;;;;;;;;;;;EAjBF,KAAA,GAAQ,IAAA,CAAK,YAAA;IAkHb;;;;;IA5GE,MAAA;IAkI+C;;;;;;;;;;IAvH/C,YAAA;IAsMF;;;;;IAhME,OAAA;IA6OA;;AAAO;;;;IAtOP,0BAAA;;;;;;;;;;;;;;;;;IAiBA,YAAA;;;;;;;;;;;;;;;;IAgBA,OAAA;;;;;;IAMA,MAAA;;;;;;IAMA,SAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,UAAA,GAAa,SAAA;;;;EAKb,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;;IAMF,cAAA,GAAiB,yBAAA,KAA8B,2BAAA;;;;;IAK/C,eAAA;;;;;;;;;IASA,eAAA;;;;;;;;;IASA,qBAAA;;;;;;;;;;IAUA,mBAAA;;;;;;;;;;;;IAYA,OAAA;;;;;;;;;;IAUA,QAAA;;;;;;;;;IASA,GAAA;8CAIM,IAAA;MAEA,KAAA;MAEA,WAAA;IAAA;EAAA;;;;EAOR,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;;;IASE,OAAA;;;;;;;;IASA,OAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;;;YAcY;;;;EAIV;;;;IAIE;;;;IAIA;;;;IAIA;;;;;;;;;;;;;EAcF,QAAQ,KAAK;;;;;;IAMX;;;;;;;;;;;IAWA;;;;;;IAMA;;;;;;;IAOA;;;;;;;;;;;;;;;;;IAiBA;;;;;;;;;;;;;;;;IAgBA;;;;;;IAMA;;;;;;IAMA;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,aAAa;;;;EAKb;IACE,WAAW;;;;;EAMb;;;;IAIE;;;;;;MAME;;;;;;MAMA;;;;;;IAMF,iBAAiB,8BAA8B;;;;;IAK/C;;;;;;;;;IASA;;;;;;;;;IASA;;;;;;;;;;IAUA;;;;;;;;;;;;IAYA;;;;;;;;;;IAUA;;;;;;;;;IASA;;MAIM;;MAEA;;MAEA;;;;;;EAOR;;;;;;;;;;;;;;;;;;IAkBE,aAAa,MAAM;;;;;;;;EASrB;;;;;;;;;IASE;;;;;;;;IASA"}

package/esm/warlock-config/warlock-config.manager.d.mts

@@ -1,5 +1,4 @@
 import { WarlockConfig } from "./types.mjs";
-
 //#region ../../packages/core/src/warlock-config/warlock-config.manager.d.ts
 /**
  * True when `error` is Node's "this runtime can't import a `.ts` file" error.
@@ -9,7 +8,7 @@ import { WarlockConfig } from "./types.mjs";
  * `import("warlock.config.ts")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is
  * the signal to fall back to transpiling the config ourselves.
  */
-declare function isUnknownTsExtensionError(error: unknown): boolean;
+export declare function isUnknownTsExtensionError(error: unknown): boolean;
 /**
  * True when `error` is Node failing to RESOLVE an import of the config's OWN
  * graph: an extensionless relative import (`./src/connectors/local`), a
@@ -24,20 +23,20 @@ declare function isUnknownTsExtensionError(error: unknown): boolean;
  * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message
  * cannot be parsed the error is treated as a graph error, as before.
  */
-declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
+export declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
 /**
  * True when `error` is native type stripping refusing TypeScript it cannot
  * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under
  * `node_modules`. Both are raised while loading, before the graph runs.
  */
-declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
+export declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
 /**
  * Warlock Config Manager
  *
  * Manages lazy loading of the pre-compiled warlock.config.js file
  * from the .warlock/cache directory.
  */
-declare class WarlockConfigManager {
+export declare class WarlockConfigManager {
   /**
    * Cached config instance
    */
@@ -123,7 +122,6 @@ declare class WarlockConfigManager {
  * await warlockConfig.load();
  * const commands = warlockConfig.get("cli.commands");
  */
-declare const warlockConfigManager: WarlockConfigManager;
+export declare const warlockConfigManager: WarlockConfigManager;
 //#endregion
-export { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };
 //# sourceMappingURL=warlock-config.manager.d.mts.map

package/esm/warlock-config/warlock-config.manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;AAyBA;;;;AAAwD;AAqBxD;iBArBgB,yBAAA,CAA0B,KAAc;;;AAuBnB;AA4BrC;;;;AAA8D;AA+B9D;;;;;;iBA7DgB,6BAAA,CACd,KAAA,WACA,WAAmC;;;;;;iBA4BrB,+BAAA,CAAgC,KAAc;;;;;;;cA+BjD,oBAAA;EA0LmB;;;EAAA,QAtLtB,MAAA;EAYK;;;EAAA,QAPL,OAAA;EA6FM;;;;;EAtFD,IAAA,IAAQ,OAAA,CAAQ,aAAA;EAwHZ;;;;;;EAAA,QA1FH,MAAA;EA6GkB;;;;;;;;;;;;EAAA,QArDlB,cAAA;EAoFS;;AAAO;AAwDhC;;;;AAA8D;;;;EA5GrD,GAAA,mBAAsB,aAAA,EAC3B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,aAAA,CAAc,GAAA;;;;;;;;;;;EAkBX,OAAA,mBAA0B,aAAA,EAC9B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,OAAA,CAAQ,aAAA,CAAc,GAAA;;;;MAQd,QAAA;;;;;;EASJ,MAAA,IAAU,aAAA;;;;EAWJ,MAAA,IAAU,OAAA;AAAA;;;;;;;;;;;;;;cAwDZ,oBAAA,EAAoB,oBAA6B"}
+{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;;;;;;wBAyBgB,0BAA0B;;;;;;;;;;;;;;;wBAqB1B,8BACd,gBACA;;;;;;wBA4Bc,gCAAgC;;;;;;;qBA+BnC;;;;UAIH;;;;UAKA;;;;;;EAOK,QAAQ,QAAQ;;;;;;;UA8Bf;;;;;;;;;;;;;UAwDA;;;;;;;;;;;;EAgCP,IAAI,kBAAkB,eAC3B,KAAK,KACL,eAAe,cAAc,OAC5B,cAAc;;;;;;;;;;;EAkBX,QAAQ,kBAAkB,eAC9B,KAAK,KACL,eAAe,cAAc,OAC5B,QAAQ,cAAc;;;;MAQd;;;;;;EASJ,UAAU;;;;EAWJ,UAAU;;;;;;;;;;;;;;;qBAwDZ,sBAAoB"}

package/esm/warlock-config/warlock-config.manager.mjs

@@ -207,7 +207,8 @@ function configPathAliases(configPath) {
 function nameOriginalConfig(error, compiledPath, configPath) {
 	const code = error?.code;
 	if (typeof code !== "string" || !code.startsWith("ERR_")) return error;
-	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath)}`, { cause: error });
+	const message = String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath);
+	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, { cause: error });
 	wrapped.code = code;
 	return wrapped;
 }

package/esm/warlock-config/warlock-config.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { getTsconfig } from \"get-tsconfig\";\nimport { unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { bundleWarlockConfig } from \"./bundle-config\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * `Error` with the ES2022 `cause` option, typed for packages still compiled\n * against an older lib (see `application.ts`).\n */\nconst ErrorWithCause = Error as new (message: string, options: { cause: unknown }) => Error;\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * True when `error` is Node failing to RESOLVE an import of the config's OWN\n * graph: an extensionless relative import (`./src/connectors/local`), a\n * directory import, or a tsconfig `paths` alias (`app/connectors`) — all of\n * which only a TypeScript toolchain resolves. Native type stripping\n * (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.\n *\n * A package that is genuinely not installed is NOT a fallback case: the error\n * names a bare specifier that matches no `paths` pattern, and it is rethrown\n * as is. Neither is a missing module imported from inside `node_modules`.\n *\n * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message\n * cannot be parsed the error is treated as a graph error, as before.\n */\nexport function isUnresolvedConfigImportError(\n  error: unknown,\n  pathAliases: readonly string[] = [],\n): boolean {\n  const code = (error as { code?: string })?.code;\n\n  if (code === \"ERR_UNSUPPORTED_DIR_IMPORT\") return true;\n  if (code !== \"ERR_MODULE_NOT_FOUND\") return false;\n\n  const message = String((error as Error)?.message ?? \"\");\n  const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);\n\n  if (!match) return true;\n\n  const [, kind, specifier = \"\", importer = \"\"] = match;\n\n  if (/[\\\\/]node_modules[\\\\/]/.test(importer)) return false;\n\n  // An unresolved relative or absolute path: an extensionless TS import.\n  if (kind === \"module\") return true;\n\n  // A bare name: only a tsconfig alias is the config graph's own code.\n  return pathAliases.some((pattern) => aliasCovers(pattern, specifier));\n}\n\n/**\n * True when `error` is native type stripping refusing TypeScript it cannot\n * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under\n * `node_modules`. Both are raised while loading, before the graph runs.\n */\nexport function isUnsupportedTypeStrippingError(error: unknown): boolean {\n  const code = (error as { code?: string })?.code;\n\n  return (\n    code === \"ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX\" ||\n    code === \"ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING\"\n  );\n}\n\n/**\n * True when a tsconfig `paths` pattern can produce `packageName` as the first\n * segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers\n * `@shared`, a catch-all `*` covers anything.\n */\nfunction aliasCovers(pattern: string, packageName: string): boolean {\n  const star = pattern.indexOf(\"*\");\n  const prefix = star === -1 ? pattern : pattern.slice(0, star);\n\n  if (prefix === \"\") return true;\n\n  return (\n    prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix)\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works for a\n      // self-contained config. But `build` / `start` register no hook, so on an\n      // older Node the import throws ERR_UNKNOWN_FILE_EXTENSION; native\n      // stripping cannot resolve extensionless or tsconfig-aliased local\n      // imports, nor strip an `enum` or a parameter property. Bundle the\n      // config's local graph with esbuild ourselves so config loading is\n      // Node-version-independent.\n      //\n      // These errors are raised while resolving and loading the STATIC graph,\n      // before any of it runs. An unresolved import reached later — a dynamic\n      // `import()` while the config runs — is indistinguishable by code, so the\n      // fallback is limited to the config's own relative and aliased imports.\n      if (\n        isUnknownTsExtensionError(error) ||\n        isUnsupportedTypeStrippingError(error) ||\n        isUnresolvedConfigImportError(error, configPathAliases(configPath))\n      ) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes that cannot import the config as written.\n   *\n   * Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,\n   * extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping\n   * every package external so `BaseConnector`, the container and other\n   * registries keep the application's identity (see `bundleWarlockConfig`).\n   * The bundle is written as a sibling `.mjs` — so its external imports resolve\n   * from the project exactly as they would from the original config — imported\n   * once, then removed whether it loaded or threw. An error thrown by the\n   * user's config propagates unchanged.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const code = await bundleWarlockConfig(configPath);\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.${Date.now()}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } catch (error) {\n      throw nameOriginalConfig(error, compiledPath, configPath);\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * The tsconfig `paths` patterns of the project holding `configPath`.\n */\nfunction configPathAliases(configPath: string): string[] {\n  try {\n    return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});\n  } catch {\n    return [];\n  }\n}\n\n/**\n * A loader error raised by the bundled config names the temporary `.mjs`\n * module. Rewrite it to name `warlock.config.ts`, keeping the original as the\n * cause. An error thrown by the user's own config is returned unchanged.\n */\nfunction nameOriginalConfig(error: unknown, compiledPath: string, configPath: string): unknown {\n  const code = (error as { code?: string })?.code;\n\n  if (typeof code !== \"string\" || !code.startsWith(\"ERR_\")) return error;\n\n  const message = String((error as Error).message ?? error)\n    .split(pathToFileURL(compiledPath).href)\n    .join(pathToFileURL(configPath).href)\n    .split(compiledPath)\n    .join(configPath);\n\n  const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, {\n    cause: error,\n  });\n\n  (wrapped as Error & { code?: string }).code = code;\n\n  return wrapped;\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":"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"}
+{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { getTsconfig } from \"get-tsconfig\";\nimport { unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { bundleWarlockConfig } from \"./bundle-config\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * `Error` with the ES2022 `cause` option, typed for packages still compiled\n * against an older lib (see `application.ts`).\n */\nconst ErrorWithCause = Error as new (message: string, options: { cause: unknown }) => Error;\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * True when `error` is Node failing to RESOLVE an import of the config's OWN\n * graph: an extensionless relative import (`./src/connectors/local`), a\n * directory import, or a tsconfig `paths` alias (`app/connectors`) — all of\n * which only a TypeScript toolchain resolves. Native type stripping\n * (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.\n *\n * A package that is genuinely not installed is NOT a fallback case: the error\n * names a bare specifier that matches no `paths` pattern, and it is rethrown\n * as is. Neither is a missing module imported from inside `node_modules`.\n *\n * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message\n * cannot be parsed the error is treated as a graph error, as before.\n */\nexport function isUnresolvedConfigImportError(\n  error: unknown,\n  pathAliases: readonly string[] = [],\n): boolean {\n  const code = (error as { code?: string })?.code;\n\n  if (code === \"ERR_UNSUPPORTED_DIR_IMPORT\") return true;\n  if (code !== \"ERR_MODULE_NOT_FOUND\") return false;\n\n  const message = String((error as Error)?.message ?? \"\");\n  const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);\n\n  if (!match) return true;\n\n  const [, kind, specifier = \"\", importer = \"\"] = match;\n\n  if (/[\\\\/]node_modules[\\\\/]/.test(importer)) return false;\n\n  // An unresolved relative or absolute path: an extensionless TS import.\n  if (kind === \"module\") return true;\n\n  // A bare name: only a tsconfig alias is the config graph's own code.\n  return pathAliases.some((pattern) => aliasCovers(pattern, specifier));\n}\n\n/**\n * True when `error` is native type stripping refusing TypeScript it cannot\n * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under\n * `node_modules`. Both are raised while loading, before the graph runs.\n */\nexport function isUnsupportedTypeStrippingError(error: unknown): boolean {\n  const code = (error as { code?: string })?.code;\n\n  return (\n    code === \"ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX\" ||\n    code === \"ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING\"\n  );\n}\n\n/**\n * True when a tsconfig `paths` pattern can produce `packageName` as the first\n * segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers\n * `@shared`, a catch-all `*` covers anything.\n */\nfunction aliasCovers(pattern: string, packageName: string): boolean {\n  const star = pattern.indexOf(\"*\");\n  const prefix = star === -1 ? pattern : pattern.slice(0, star);\n\n  if (prefix === \"\") return true;\n\n  return (\n    prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix)\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works for a\n      // self-contained config. But `build` / `start` register no hook, so on an\n      // older Node the import throws ERR_UNKNOWN_FILE_EXTENSION; native\n      // stripping cannot resolve extensionless or tsconfig-aliased local\n      // imports, nor strip an `enum` or a parameter property. Bundle the\n      // config's local graph with esbuild ourselves so config loading is\n      // Node-version-independent.\n      //\n      // These errors are raised while resolving and loading the STATIC graph,\n      // before any of it runs. An unresolved import reached later — a dynamic\n      // `import()` while the config runs — is indistinguishable by code, so the\n      // fallback is limited to the config's own relative and aliased imports.\n      if (\n        isUnknownTsExtensionError(error) ||\n        isUnsupportedTypeStrippingError(error) ||\n        isUnresolvedConfigImportError(error, configPathAliases(configPath))\n      ) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes that cannot import the config as written.\n   *\n   * Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,\n   * extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping\n   * every package external so `BaseConnector`, the container and other\n   * registries keep the application's identity (see `bundleWarlockConfig`).\n   * The bundle is written as a sibling `.mjs` — so its external imports resolve\n   * from the project exactly as they would from the original config — imported\n   * once, then removed whether it loaded or threw. An error thrown by the\n   * user's config propagates unchanged.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const code = await bundleWarlockConfig(configPath);\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.${Date.now()}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } catch (error) {\n      throw nameOriginalConfig(error, compiledPath, configPath);\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * The tsconfig `paths` patterns of the project holding `configPath`.\n */\nfunction configPathAliases(configPath: string): string[] {\n  try {\n    return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});\n  } catch {\n    return [];\n  }\n}\n\n/**\n * A loader error raised by the bundled config names the temporary `.mjs`\n * module. Rewrite it to name `warlock.config.ts`, keeping the original as the\n * cause. An error thrown by the user's own config is returned unchanged.\n */\nfunction nameOriginalConfig(error: unknown, compiledPath: string, configPath: string): unknown {\n  const code = (error as { code?: string })?.code;\n\n  if (typeof code !== \"string\" || !code.startsWith(\"ERR_\")) return error;\n\n  const message = String((error as Error).message ?? error)\n    .split(pathToFileURL(compiledPath).href)\n    .join(pathToFileURL(configPath).href)\n    .split(compiledPath)\n    .join(configPath);\n\n  const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, {\n    cause: error,\n  });\n\n  (wrapped as Error & { code?: string }).code = code;\n\n  return wrapped;\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":"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"}

package/esm/warlock-config/warn-deprecated-config.mjs

@@ -21,5 +21,5 @@ function getDeprecatedConfigWarnings(config) {
 }
 
 //#endregion
-export { getDeprecatedConfigWarnings };
+export { deprecatedConfigKeys, getDeprecatedConfigWarnings };
 //# sourceMappingURL=warn-deprecated-config.mjs.map

package/llms-full.txt

@@ -1877,6 +1877,13 @@ await warmupProductCache();
 - The `write-seeder` topic — populating the generated `seeds/` folder.
 - The `use-localization` topic — populating the generated `utils/locales.ts`.
 
+## Verify generated imports
+
+Generated web starter files match the scaffold’s Prettier configuration, using
+`@ianvs/prettier-plugin-sort-imports` with Babel independently of TypeScript 7.
+After editing generated code, run `npm run format` and `npm run lint:check`.
+Formatting retains unused imports; the linter reports them.
+
 
 ## define-resource  `@warlock.js/core/define-resource/SKILL.md`
 
@@ -5022,11 +5029,12 @@ diagnostics keep their specific message. Command failure messages contain a
 bounded status/output summary, without the batch command line. Shutdown gives
 workers up to 500 ms to exit and reap owned CLI children before forcing termination.
 
-Source TypeScript health workers use the framework's JavaScript/tsx bootstrap on
-Node.js 22.15; published JavaScript workers start directly. Framework regression
-tests cover that bootstrap and a built `.mjs` worker with no inherited loader
-hooks. Both paths check configured declaration roots, source updates and deleted
-declarations under the supported minimum runtime.
+Source TypeScript health workers use the framework's JavaScript bootstrap to
+register tsx inside each worker on Node.js 22.15 and Node.js 24. Registration
+remains active for later TypeScript imports and lets native dependencies load
+Node builtins through `createRequire`. Published JavaScript workers start
+directly. Regression tests cover both paths without inherited loader hooks,
+including configured declaration roots, source updates and deleted declarations.
 
 
 ## send-mail  `@warlock.js/core/send-mail/SKILL.md`
@@ -7945,6 +7953,12 @@ instead of a plain `ProviderError`; update exhaustive `AIErrorCode` switches and
 custom `fallbackModel({ retryOn })` lists. Bedrock calls with a `cacheControl`
 breakpoint now also cache the system prompt and (Claude) tool definitions.
 
+## 5.31 to 5.32 notifications with the herald queue
+
+Apps that call `.queue()` with `heraldQueue()` must now install `@warlock.js/herald` themselves (it became an
+optional peer of `@warlock.js/notifications`; 5.31.0 bundled a private copy of it). Install it at the same version
+as the rest of the family.
+
 ## Verify the application paths that changed
 
 Run the app's type check, its logger channel tests, any tools with ordered side
@@ -7975,6 +7989,41 @@ It also writes `.warlock/dev-server.json` (the server's address, for
 `warlock trace` and `warlock mcp`); `.warlock/` is already git-ignored by the
 starter. See the `warlock-agents-md` topic.
 
+## 5.31 to 5.32 TypeScript 7
+
+With the default Oxlint/Oxfmt toolchain, pin the app's development dependency to
+`typescript@7.0.2`. The regular `tsc`
+command is now the native Go compiler; no native-preview package is needed.
+Remove `baseUrl` from every app tsconfig and resolve each `paths` target relative
+to the config. For example, `baseUrl: "src"` with `"app/*": ["app/*"]` becomes
+`"app/*": ["./src/app/*"]`. Replace `moduleResolution: "node"` / `"node10"` with
+`"bundler"` and use `module: "ESNext"` for Warlock's build pipeline. Explicitly
+include Node ambient types with `"types": ["node"]`; set `rootDir` if sources
+sit outside the config folder. Keep strict checking enabled.
+
+```bash
+npm install --save-dev --save-exact typescript@7.0.2
+npx tsc --noEmit
+npx warlock typecheck
+npx warlock typecheck --changed
+```
+
+The CLI preserves incremental state and changed-file filtering. Development
+health checks keep one native compiler session and update its snapshots. Syntax
+analysis uses OXC. `warlock upgrade` still parses/transforms with ts-morph's own
+bundled TypeScript, without using it as the app's compiler. New scaffolds default
+to Oxlint/Oxfmt (`--lint=oxc`). Explicit `--lint=eslint` pins the app's compiler to
+TypeScript **6.0.3** because typescript-eslint requires the old JavaScript API
+and supports `>=4.8.4 <6.1.0`. Keep ESLint apps on 6.0.3 until switching tools:
+
+```bash
+npm install --save-dev --save-exact typescript@6.0.3
+npx tsc --noEmit
+```
+
+The same tsconfig cleanups work with TS6. ESLint mode prints a compatibility
+notice and is planned for deprecation in 5.33 and removal in 5.34.
+
 
 ## upload-file  `@warlock.js/core/upload-file/SKILL.md`
 
@@ -10794,6 +10843,7 @@ const types = runTypecheck({ files: ["src/app/posts/services/publish.service.ts"
 
 ## See also
 
+- `report-framework-issue.md` — confirm a framework bug or missing capability, collect `warlock issue` output, and get the user's approval before filing.
 - The `warlock-doctor` topic — boot-time diagnostics; `doctor --json` uses the same codes and fields.
 - The `warlock-inspect` topic — the app's routes, models and config as JSON.
 - The `warlock-conventions` topic — the rules behind `WL9001`–`WL9012`, with the fix for each.

package/package.json

@@ -25,17 +25,17 @@
     "@mongez/slug": "^1.0.7",
     "@mongez/supportive-is": "^3.0.0",
     "@mongez/time-wizard": "^1.0.6",
-    "@warlock.js/cache": "5.31.0",
-    "@warlock.js/cascade": "5.31.0",
-    "@warlock.js/context": "5.31.0",
-    "@warlock.js/fs": "5.31.0",
-    "@warlock.js/logger": "5.31.0",
-    "@warlock.js/seal": "5.31.0",
+    "@warlock.js/cache": "5.32.0",
+    "@warlock.js/cascade": "5.32.0",
+    "@warlock.js/context": "5.32.0",
+    "@warlock.js/fs": "5.32.0",
+    "@warlock.js/logger": "5.32.0",
+    "@warlock.js/seal": "5.32.0",
     "bcryptjs": "^3.0.3",
     "chokidar": "^5.0.0",
     "dayjs": "^1.11.19",
     "es-module-lexer": "^2.0.0",
-    "esbuild": "^0.27.2",
+    "esbuild": "^0.28.2",
     "eslint": "^9.18.0",
     "fast-glob": "^3.3.3",
     "fastify": "^5.12.5",
@@ -43,9 +43,11 @@
     "get-tsconfig": "^5.0.0-beta.5",
     "glob": "^13.0.6",
     "import-meta-resolve": "^4.2.0",
+    "jsonc-parser": "3.3.1",
     "mime": "^4.1.0",
+    "oxc-parser": "0.154.0",
     "pluralize-esm": "^9.0.5",
-    "typescript": "^5.7.3"
+    "typescript": "7.0.2"
   },
   "peerDependencies": {
     "@aws-sdk/client-s3": "^3.955.0",
@@ -53,12 +55,12 @@
     "@aws-sdk/lib-storage": "^3.955.0",
     "@aws-sdk/s3-request-presigner": "^3.955.0",
     "@react-email/render": "^2.0.5",
-    "@warlock.js/access": "5.31.0",
-    "@warlock.js/ai": "5.31.0",
-    "@warlock.js/ai-tools": "5.31.0",
-    "@warlock.js/devtools": "5.31.0",
-    "@warlock.js/herald": "5.31.0",
-    "@warlock.js/notifications": "5.31.0",
+    "@warlock.js/access": "5.32.0",
+    "@warlock.js/ai": "5.32.0",
+    "@warlock.js/ai-tools": "5.32.0",
+    "@warlock.js/devtools": "5.32.0",
+    "@warlock.js/herald": "5.32.0",
+    "@warlock.js/notifications": "5.32.0",
     "nodemailer": "^8.0.5",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
@@ -140,7 +142,7 @@
   "engines": {
     "node": ">=22.15"
   },
-  "version": "5.31.0",
+  "version": "5.32.0",
   "type": "module",
   "main": "./esm/index.mjs",
   "module": "./esm/index.mjs",

package/skills/create-module/SKILL.md

@@ -188,3 +188,10 @@ await warmupProductCache();
 - The `validate-input` topic — wiring `schema/*.schema.ts` to controllers.
 - The `write-seeder` topic — populating the generated `seeds/` folder.
 - The `use-localization` topic — populating the generated `utils/locales.ts`.
+
+## Verify generated imports
+
+Generated web starter files match the scaffold’s Prettier configuration, using
+`@ianvs/prettier-plugin-sort-imports` with Babel independently of TypeScript 7.
+After editing generated code, run `npm run format` and `npm run lint:check`.
+Formatting retains unused imports; the linter reports them.

package/skills/index.md

@@ -14,6 +14,8 @@ Core is the application runtime: it boots the app, auto-loads each module's spec
 4. Return via `response.*` (`send-response.md`) and shape output with a resource (`define-resource.md`); declare `responseSchema` for typed clients and docs (`create-controller.md`, `generate-openapi.md`).
 5. Configure and run (`configure-app.md`, `run-app.md`); check setup with `warlock-doctor.md`, read the app with `warlock-inspect.md` (or serve it to an agent with `warlock-mcp.md`), verify a change with `warlock-check.md`, and a request's runtime behaviour with `warlock-trace.md`.
 
+When the framework is wrong or missing a capability, follow `report-framework-issue.md` to prepare a public report and ask the user before filing.
+
 ## Topics by area
 
 - **Foundations:** warlock-conventions, create-module, make-endpoint, configure-app, use-app-context, resolve-path, build-url, update-packages, lower-stage3-decorators

package/skills/report-framework-issue.md

@@ -0,0 +1,154 @@
+# Report a Warlock.js framework issue
+
+Use this topic when behavior contradicts the installed version's docs or skills,
+a crash originates inside `@warlock.js/*`, or a needed framework capability is
+missing. Framework reports belong at <https://github.com/warlockjs/framework>.
+
+## Confirm and search first
+
+1. Reduce the problem to a minimal reproduction in a clean, generic app. Isolate
+   application logic, third-party packages and configuration mistakes; a stack
+   frame in the framework alone does not prove a framework bug.
+2. Read the **installed version's** package `CHANGELOG.md` and skills. Confirm
+   that the documented API exists in that version and check whether a later
+   release already addresses it. For a feature, describe the missing capability
+   and why the documented APIs or an app-level workaround are insufficient.
+3. Run `warlock doctor --json` (see `warlock-doctor.md`). Fix app/environment
+   findings first. If boot fails, retain only the sanitized failure; `warlock
+   issue` itself does not boot the app.
+4. Search existing reports, including closed issues, using distinctive public
+   terms. If a matching issue exists, show its link and help draft a useful
+   follow-up instead of opening a duplicate. Ask before posting that follow-up.
+
+```bash
+gh issue list -R warlockjs/framework --state all --search "public error or capability"
+```
+
+Without GitHub CLI, use
+<https://github.com/warlockjs/framework/issues?q=is%3Aissue> and enter those terms.
+
+## Collect and protect
+
+```bash
+warlock issue --type bug --title "Public description of the failure"
+warlock issue --type feature --title "Public description of the capability" --json
+```
+
+Collect affected package names and **installed versions**, Node and package
+manager versions, OS/architecture, TypeScript version, the reviewed `warlock
+issue` environment output, a minimal reproduction with exact steps, expected
+versus actual behavior, and relevant sanitized logs / `warlock doctor --json`
+output. If a tool cannot run or there are no relevant logs, explain why.
+
+**Never paste secrets, tokens, `.env` contents, customer data, proprietary code or
+private app names** into titles, bodies, logs, screenshots, repro repositories,
+search queries or URLs. Replace the original app with a minimal generic repro.
+Review even generated environment output and stack traces; remove local paths,
+hostnames and identifying details. The command reads installed package metadata
+and a static config summary; it never reads `.env` or executes the app/config.
+Do not attach the app's full config or diagnostic report without sanitizing it.
+
+## Draft and get consent
+
+Choose one template below, replace every prompt with concrete evidence, and
+write the sanitized body to a local UTF-8 file such as `framework-issue.md`.
+**Always show the complete drafted title and body to the user and explicitly ask
+before filing.** Generating a draft or URL is not consent to publish. If the user
+requests edits, show the revised draft and obtain approval for that version.
+
+### Bug body
+
+```markdown
+### Summary
+
+Public description of the framework failure and affected packages.
+
+### Environment / warlock issue output
+
+Reviewed environment output: installed @warlock.js package versions, Node,
+package manager + version, OS/arch, TypeScript, static config summary.
+
+### Minimal reproduction
+
+Public minimal code or repro link, setup commands and exact steps.
+
+### Expected behavior
+
+What should happen, with the installed version's docs/skills reference.
+
+### Actual / current behavior
+
+What happens instead, including the error and impact.
+
+### Sanitized logs / doctor output
+
+Relevant logs and warlock doctor --json, or why unavailable / not applicable.
+
+### Checks
+
+- [ ] Searched existing issues and checked installed-version CHANGELOG and skills.
+- [ ] Removed secrets, tokens, .env, customer data, proprietary code and private app names.
+- [ ] User reviewed this complete draft and approved filing.
+```
+
+### Feature request body
+
+```markdown
+### Problem / use case
+
+Public description of the missing framework capability and affected packages.
+
+### Environment / warlock issue output
+
+Reviewed environment output: installed @warlock.js package versions, Node,
+package manager + version, OS/arch, TypeScript, static config summary.
+
+### Minimal reproduction
+
+Minimal public example of the capability that cannot currently be expressed.
+
+### Proposed behavior
+
+Desired API/behavior, with an example and why it belongs in the framework.
+
+### Actual / current behavior
+
+Current limitation and relevant installed-version docs/skills.
+
+### Alternatives considered
+
+Existing APIs, app-level workarounds and their limitations.
+
+### Sanitized logs / doctor output
+
+Relevant logs and warlock doctor --json, or why unavailable / not applicable.
+
+### Checks
+
+- [ ] Searched existing issues and checked installed-version CHANGELOG and skills.
+- [ ] Removed secrets, tokens, .env, customer data, proprietary code and private app names.
+- [ ] User reviewed this complete draft and approved filing.
+```
+
+Only check a box after completing that step, including obtaining consent.
+
+## File the approved draft
+
+Check `gh --version` and `gh auth status --hostname github.com`. If GitHub CLI is
+available and authenticated, **after approval** run:
+
+```bash
+gh issue create -R warlockjs/framework --title "Approved public title" --body-file framework-issue.md
+```
+
+Return the created issue's link. If GitHub CLI is unavailable or unauthenticated,
+give the user the pre-filled new-issue URL printed by `warlock issue` together
+with the approved body. The URL selects `bug.yml` or `feature.yml` and prefills
+the environment field; the user must complete the remaining form fields. URLs
+are capped at 7,500 characters and may include a truncation note: restore the
+remaining reviewed output manually. Never claim the issue was filed from merely
+printing or opening a URL. `warlock issue` never sends anything itself.
+
+GitHub CLI flags: [list](https://cli.github.com/manual/gh_issue_list),
+[create](https://cli.github.com/manual/gh_issue_create),
+[authentication](https://cli.github.com/manual/gh_auth_status).

package/skills/run-app/SKILL.md

@@ -599,8 +599,9 @@ diagnostics keep their specific message. Command failure messages contain a
 bounded status/output summary, without the batch command line. Shutdown gives
 workers up to 500 ms to exit and reap owned CLI children before forcing termination.
 
-Source TypeScript health workers use the framework's JavaScript/tsx bootstrap on
-Node.js 22.15; published JavaScript workers start directly. Framework regression
-tests cover that bootstrap and a built `.mjs` worker with no inherited loader
-hooks. Both paths check configured declaration roots, source updates and deleted
-declarations under the supported minimum runtime.
+Source TypeScript health workers use the framework's JavaScript bootstrap to
+register tsx inside each worker on Node.js 22.15 and Node.js 24. Registration
+remains active for later TypeScript imports and lets native dependencies load
+Node builtins through `createRequire`. Published JavaScript workers start
+directly. Regression tests cover both paths without inherited loader hooks,
+including configured declaration roots, source updates and deleted declarations.

package/skills/upgrade-from-5-29/SKILL.md

@@ -382,6 +382,12 @@ instead of a plain `ProviderError`; update exhaustive `AIErrorCode` switches and
 custom `fallbackModel({ retryOn })` lists. Bedrock calls with a `cacheControl`
 breakpoint now also cache the system prompt and (Claude) tool definitions.
 
+## 5.31 to 5.32 notifications with the herald queue
+
+Apps that call `.queue()` with `heraldQueue()` must now install `@warlock.js/herald` themselves (it became an
+optional peer of `@warlock.js/notifications`; 5.31.0 bundled a private copy of it). Install it at the same version
+as the rest of the family.
+
 ## Verify the application paths that changed
 
 Run the app's type check, its logger channel tests, any tools with ordered side
@@ -411,3 +417,38 @@ export default defineConfig({
 It also writes `.warlock/dev-server.json` (the server's address, for
 `warlock trace` and `warlock mcp`); `.warlock/` is already git-ignored by the
 starter. See the `warlock-agents-md` topic.
+
+## 5.31 to 5.32 TypeScript 7
+
+With the default Oxlint/Oxfmt toolchain, pin the app's development dependency to
+`typescript@7.0.2`. The regular `tsc`
+command is now the native Go compiler; no native-preview package is needed.
+Remove `baseUrl` from every app tsconfig and resolve each `paths` target relative
+to the config. For example, `baseUrl: "src"` with `"app/*": ["app/*"]` becomes
+`"app/*": ["./src/app/*"]`. Replace `moduleResolution: "node"` / `"node10"` with
+`"bundler"` and use `module: "ESNext"` for Warlock's build pipeline. Explicitly
+include Node ambient types with `"types": ["node"]`; set `rootDir` if sources
+sit outside the config folder. Keep strict checking enabled.
+
+```bash
+npm install --save-dev --save-exact typescript@7.0.2
+npx tsc --noEmit
+npx warlock typecheck
+npx warlock typecheck --changed
+```
+
+The CLI preserves incremental state and changed-file filtering. Development
+health checks keep one native compiler session and update its snapshots. Syntax
+analysis uses OXC. `warlock upgrade` still parses/transforms with ts-morph's own
+bundled TypeScript, without using it as the app's compiler. New scaffolds default
+to Oxlint/Oxfmt (`--lint=oxc`). Explicit `--lint=eslint` pins the app's compiler to
+TypeScript **6.0.3** because typescript-eslint requires the old JavaScript API
+and supports `>=4.8.4 <6.1.0`. Keep ESLint apps on 6.0.3 until switching tools:
+
+```bash
+npm install --save-dev --save-exact typescript@6.0.3
+npx tsc --noEmit
+```
+
+The same tsconfig cleanups work with TS6. ESLint mode prints a compatibility
+notice and is planned for deprecation in 5.33 and removal in 5.34.

package/skills/warlock-check/SKILL.md

@@ -127,6 +127,7 @@ const types = runTypecheck({ files: ["src/app/posts/services/publish.service.ts"
 
 ## See also
 
+- `report-framework-issue.md` — confirm a framework bug or missing capability, collect `warlock issue` output, and get the user's approval before filing.
 - The `warlock-doctor` topic — boot-time diagnostics; `doctor --json` uses the same codes and fields.
 - The `warlock-inspect` topic — the app's routes, models and config as JSON.
 - The `warlock-conventions` topic — the rules behind `WL9001`–`WL9012`, with the fix for each.

package/esm/tooling/check/index.d.mts

@@ -1,8 +0,0 @@
-import { GitResult, GitRunner, listChangedFiles, runGit } from "./changed-files.mjs";
-import { CHECK_EXIT_CODES, CHECK_STEPS, CheckExitCode, CheckReport, CheckStep, CheckStepName, CheckStepStatus, checkExitCode } from "./check-report.types.mjs";
-import { checkFileConventions, checkTsconfigConventions, isAutoLoadedFile, runConventions } from "./conventions-step.mjs";
-import { MIN_NODE_VERSION, checkNodeVersion } from "./environment-step.mjs";
-import { LintOutcome, runLint } from "./lint-step.mjs";
-import { VitestRun, VitestRunner, findVitest, parseVitestReport, runVitest } from "./tests-step.mjs";
-import { CheckOptions, TypecheckRunner, runCheck } from "./run-check.mjs";
-import { RunTestsOptions, TestRunReport, runTests, testRunArguments } from "./run-tests.mjs";

package/esm/tooling/typecheck/index.d.mts

@@ -1 +0,0 @@
-import { DEFAULT_TYPECHECK_BUILD_INFO, TypecheckOptions, TypecheckResult, diagnosticToProblem, directImporters, runTypecheck } from "./run-typecheck.mjs";