@warlock.js/core 5.30.0 → 5.31.0

package/esm/errors/error-codes.d.mts

@@ -0,0 +1,653 @@
+//#region ../../packages/core/src/errors/error-codes.d.ts
+/**
+ * The registry of stable Warlock error codes.
+ *
+ * Every framework error core throws, every `warlock doctor` finding and every
+ * `warlock check` problem carries one of these codes, so a person or an agent
+ * can look the code up instead of interpreting the message. `warlock explain
+ * <CODE>` prints an entry; the docs page `cli/error-codes` lists all of them.
+ *
+ * THE SCHEME: `WL` followed by four digits. The first digit is the area:
+ *
+ * | Range  | Area        | Meaning                                              |
+ * | ------ | ----------- | ---------------------------------------------------- |
+ * | WL1xxx | config      | a configuration value is missing or invalid          |
+ * | WL2xxx | boot        | the app could not boot: modules, connectors, services |
+ * | WL3xxx | routing     | route registration and lookup                        |
+ * | WL4xxx | validation  | request validation schemas                           |
+ * | WL5xxx | http        | the HTTP layer at runtime                            |
+ * | WL6xxx | database    | migrations, seeders and database code                |
+ * | WL7xxx | cli         | CLI usage, and problems `warlock check` finds in code |
+ * | WL8xxx | environment | this machine: Node, tools, services, ports           |
+ * | WL9xxx | convention  | framework conventions and release hygiene            |
+ *
+ * STABILITY: a code, once released, keeps its meaning forever. Its `title`,
+ * `fix` and links may be reworded; a code is never reused for a different
+ * problem and never renumbered. A retired code stays in this table with
+ * `retired: true`.
+ *
+ * `category` splits "your code" from "this machine": `environment` problems are
+ * the ones `warlock check` reports with exit code 2, so an agent stops editing
+ * code to fix a missing Redis server.
+ *
+ * This module is part of the side-effect-free `@warlock.js/core/errors` entry:
+ * it imports nothing.
+ */
+/** The area a code belongs to, matching its first digit. */
+type ErrorCodeArea = "config" | "boot" | "routing" | "validation" | "http" | "database" | "cli" | "environment" | "convention";
+/**
+ * Who has to act: `code` problems are fixed in the project's source or config,
+ * `environment` problems on the machine running it.
+ */
+type ErrorCodeCategory = "code" | "environment";
+/** One registry entry. */
+type ErrorCodeDefinition = {
+  /** The stable code, e.g. `"WL3001"`. */readonly code: string; /** The area, matching the first digit. */
+  readonly area: ErrorCodeArea; /** Whether the project or the machine has to change. */
+  readonly category: ErrorCodeCategory; /** One-line name of the problem. */
+  readonly title: string; /** One-line "what to do". */
+  readonly fix: string; /** Slug of the skill that explains the fix (`packages/<pkg>/skills/<slug>/SKILL.md`). */
+  readonly skill: string; /** Names of the error classes that carry this code, when an error class does. */
+  readonly errorNames?: readonly string[]; /** Set when the code is no longer emitted. Retired codes are never reused. */
+  readonly retired?: true;
+};
+/** Base URL of the error-code reference; each code is an anchor on that page. */
+declare const ERROR_CODES_DOCS_URL = "https://warlock.js.org/v/latest/core/cli/error-codes/";
+/** The registry, keyed by code. */
+declare const ERROR_CODES: {
+  readonly WL1001: {
+    readonly code: "WL1001";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "A required config section is missing";
+    readonly fix: "Add the missing file under src/config/ (for example src/config/app.ts) exporting the section.";
+    readonly skill: "configure-app";
+  };
+  readonly WL1002: {
+    readonly code: "WL1002";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "No JWT signing secret is configured";
+    readonly fix: "Run `warlock jwt.generate` (writes JWT_SECRET to .env) and read it as auth.accessToken.secret in src/config/auth.ts.";
+    readonly skill: "configure-app";
+  };
+  readonly WL1003: {
+    readonly code: "WL1003";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "The rate-limit store cannot use the configured cache driver";
+    readonly fix: "Use a redis, pg or memory cache driver for http.rateLimit store \"cache\", or set store: \"memory\".";
+    readonly skill: "configure-app";
+    readonly errorNames: readonly ["UnsupportedRateLimitDriverError"];
+  };
+  readonly WL1004: {
+    readonly code: "WL1004";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "An http.csp directive value is invalid";
+    readonly fix: "Fix the directive value named in the message in your http config; quotes must balance and values may not contain ';'.";
+    readonly skill: "configure-app";
+    readonly errorNames: readonly ["InvalidCspDirectiveError"];
+  };
+  readonly WL1005: {
+    readonly code: "WL1005";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "The uploads.images configuration is invalid";
+    readonly fix: "Correct the uploads.images variant settings named in the message.";
+    readonly skill: "upload-file";
+    readonly errorNames: readonly ["ImageVariantsConfigError"];
+  };
+  readonly WL1006: {
+    readonly code: "WL1006";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "warlock.config.ts sets a build option the builder refuses";
+    readonly fix: "Remove the named option from the build block of warlock.config.ts; change tsconfig.json instead.";
+    readonly skill: "run-app";
+    readonly errorNames: readonly ["ForbiddenBuildOptionError"];
+  };
+  readonly WL1007: {
+    readonly code: "WL1007";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "A locale dictionary file cannot be parsed";
+    readonly fix: "Fix the key named in the message in the locales.json file it names.";
+    readonly skill: "use-localization";
+    readonly errorNames: readonly ["LocaleDictionaryError"];
+  };
+  readonly WL1008: {
+    readonly code: "WL1008";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "A locale outside app.localeCodes was requested";
+    readonly fix: "Add the locale to app.localeCodes in src/config/app.ts, or pass a configured locale.";
+    readonly skill: "use-localization";
+    readonly errorNames: readonly ["UnknownLocaleError"];
+  };
+  readonly WL1009: {
+    readonly code: "WL1009";
+    readonly area: "config";
+    readonly category: "code";
+    readonly title: "warlock.config.ts > connectors was refused";
+    readonly fix: "Give every connector in warlock.config.ts a unique name that is not a built-in connector name.";
+    readonly skill: "add-connector";
+  };
+  readonly WL2001: {
+    readonly code: "WL2001";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "An app module failed to load";
+    readonly fix: "Open the file named in the message and fix the error it throws on import; its routes and listeners are missing until then.";
+    readonly skill: "warlock-doctor";
+    readonly errorNames: readonly ["ModuleLoadError"];
+  };
+  readonly WL2002: {
+    readonly code: "WL2002";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "The app's source files could not be discovered";
+    readonly fix: "Run the command from the project root and check that src/ exists and is readable.";
+    readonly skill: "warlock-doctor";
+  };
+  readonly WL2003: {
+    readonly code: "WL2003";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "A connector failed to boot";
+    readonly fix: "Read the connector's message; it usually names the config value or package it needs.";
+    readonly skill: "add-connector";
+  };
+  readonly WL2004: {
+    readonly code: "WL2004";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "A container key was read before it was registered";
+    readonly fix: "Register the key (container.set) before reading it, or read it after the connector that sets it has booted.";
+    readonly skill: "use-app-context";
+    readonly errorNames: readonly ["ContainerKeyMissingError"];
+  };
+  readonly WL2005: {
+    readonly code: "WL2005";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "A boot precondition failed";
+    readonly fix: "Fix the condition named in the message; restarting does not help until it changes.";
+    readonly skill: "run-app";
+    readonly errorNames: readonly ["BootPreconditionError"];
+  };
+  readonly WL2006: {
+    readonly code: "WL2006";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "Storage was used before the storage connector ran";
+    readonly fix: "Add src/config/storage.ts; in a custom command add \"storage\" to preload.connectors.";
+    readonly skill: "store-file";
+    readonly errorNames: readonly ["StorageNotInitializedError"];
+  };
+  readonly WL2007: {
+    readonly code: "WL2007";
+    readonly area: "boot";
+    readonly category: "code";
+    readonly title: "A configured driver's package is not installed";
+    readonly fix: "Install the package named in the message (for example `pnpm add sharp`), or stop configuring the driver.";
+    readonly skill: "update-packages";
+  };
+  readonly WL3001: {
+    readonly code: "WL3001";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "A route name is already taken";
+    readonly fix: "Rename one of the two routes with the \"name\" route option; pages and API routes share one namespace.";
+    readonly skill: "register-route";
+    readonly errorNames: readonly ["RouteNameTakenError"];
+  };
+  readonly WL3002: {
+    readonly code: "WL3002";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "A route points at a controller method that does not exist";
+    readonly fix: "Fix the [controller, action] pair: the action must be a method on the controller.";
+    readonly skill: "register-route";
+  };
+  readonly WL3003: {
+    readonly code: "WL3003";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "A URL was built for a route name that is not registered";
+    readonly fix: "Check the name passed to router.route(); `warlock routes --name <part>` lists the registered names.";
+    readonly skill: "warlock-routes";
+  };
+  readonly WL3004: {
+    readonly code: "WL3004";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "A URL was built without one of the route's path parameters";
+    readonly fix: "Pass every :param of the route path when building the URL.";
+    readonly skill: "warlock-routes";
+  };
+  readonly WL3005: {
+    readonly code: "WL3005";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "Route modules loaded but registered no routes";
+    readonly fix: "Make sure routes.ts calls router.get/post/... at module level and is not wrapped in an unused function.";
+    readonly skill: "register-route";
+  };
+  readonly WL3006: {
+    readonly code: "WL3006";
+    readonly area: "routing";
+    readonly category: "code";
+    readonly title: "A handler uses the v4 (request, response) signature";
+    readonly fix: "Rewrite the handler as async ({ request, response }) => { ... }.";
+    readonly skill: "create-controller";
+  };
+  readonly WL4001: {
+    readonly code: "WL4001";
+    readonly area: "validation";
+    readonly category: "code";
+    readonly title: "A validation schema cannot be described as JSON Schema";
+    readonly fix: "Use Seal validators with a static shape for validation.schema/params; custom validate middleware is not described.";
+    readonly skill: "validate-input";
+  };
+  readonly WL5001: {
+    readonly code: "WL5001";
+    readonly area: "http";
+    readonly category: "code";
+    readonly title: "A cookie was read but the cookie plugin is not registered";
+    readonly fix: "Register @fastify/cookie on the server before reading cookies by name.";
+    readonly skill: "send-response";
+    readonly errorNames: readonly ["CookieJarUnavailableError"];
+  };
+  readonly WL5002: {
+    readonly code: "WL5002";
+    readonly area: "http";
+    readonly category: "code";
+    readonly title: "An app route claims a health-probe path";
+    readonly fix: "Move the app route, or rename the probe with http.health.path / http.health.readinessPath.";
+    readonly skill: "health-checks";
+  };
+  readonly WL5003: {
+    readonly code: "WL5003";
+    readonly area: "http";
+    readonly category: "code";
+    readonly title: "Health probes are enabled but not registered";
+    readonly fix: "Check that the http connector booted and that nothing removed the probe routes.";
+    readonly skill: "health-checks";
+  };
+  readonly WL5004: {
+    readonly code: "WL5004";
+    readonly area: "http";
+    readonly category: "code";
+    readonly title: "Devtools recorded no timeline for the traced request";
+    readonly fix: "Keep http.requestId enabled (its echoed header is how the request is found) and retry; a path under the devtools prefix is never recorded.";
+    readonly skill: "warlock-trace";
+  };
+  readonly WL6001: {
+    readonly code: "WL6001";
+    readonly area: "database";
+    readonly category: "code";
+    readonly title: "A seeder depends on a seeder that is not registered";
+    readonly fix: "Fix the dependsOn name, or register the missing seeder.";
+    readonly skill: "write-seeder";
+    readonly errorNames: readonly ["UnknownSeederDependencyError"];
+  };
+  readonly WL6002: {
+    readonly code: "WL6002";
+    readonly area: "database";
+    readonly category: "code";
+    readonly title: "Seeder dependencies form a cycle";
+    readonly fix: "Remove one dependsOn edge from the cycle printed in the message.";
+    readonly skill: "write-seeder";
+    readonly errorNames: readonly ["SeederDependencyCycleError"];
+  };
+  readonly WL7001: {
+    readonly code: "WL7001";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A boolean CLI option received a value it cannot read";
+    readonly fix: "Pass true/false/1/0/yes/no, or the flag on its own for true.";
+    readonly skill: "write-cli-command";
+    readonly errorNames: readonly ["CliOptionValueError"];
+  };
+  readonly WL7002: {
+    readonly code: "WL7002";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "Generated code imports a package the app does not declare";
+    readonly fix: "Add the named package to the app's dependencies, or import it through @warlock.js/core.";
+    readonly skill: "run-app";
+    readonly errorNames: readonly ["UndeclaredGeneratedImportError"];
+  };
+  readonly WL7003: {
+    readonly code: "WL7003";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A command needs an optional package that is not installed";
+    readonly fix: "Install the packages named in the message as dev dependencies (warlock mcp needs @warlock.js/ai-tools and @warlock.js/ai).";
+    readonly skill: "warlock-mcp";
+  };
+  readonly WL7004: {
+    readonly code: "WL7004";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "warlock mcp was asked to listen off loopback without a token";
+    readonly fix: "Pass --token (or set WARLOCK_MCP_TOKEN) when --host is not 127.0.0.1, ::1 or localhost, or keep the default loopback host.";
+    readonly skill: "warlock-mcp";
+  };
+  readonly WL7005: {
+    readonly code: "WL7005";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "An MCP tool that writes files was called on a read-only server";
+    readonly fix: "Restart the server with --allow-writes to let generate tools write; without it they only return the diff.";
+    readonly skill: "warlock-mcp";
+  };
+  readonly WL7101: {
+    readonly code: "WL7101";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "TypeScript reports a type error";
+    readonly fix: "Fix the type error at the reported position; the TypeScript code (TS1234) is in `rule`.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7102: {
+    readonly code: "WL7102";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "tsconfig.json is missing or invalid";
+    readonly fix: "Fix tsconfig.json at the project root; the message names the problem.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7201: {
+    readonly code: "WL7201";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "The linter reports an error";
+    readonly fix: "Fix the lint error at the reported position; the rule id is in `rule`.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7202: {
+    readonly code: "WL7202";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "The linter reports a warning";
+    readonly fix: "Fix the warning, or change the rule's severity in the lint config if it does not apply.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7301: {
+    readonly code: "WL7301";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A test failed";
+    readonly fix: "Run the test file alone, read the assertion message and fix the code or the test.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7302: {
+    readonly code: "WL7302";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A test file failed before its tests ran";
+    readonly fix: "Fix the import or setup error named in the message; none of the file's tests ran.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL7401: {
+    readonly code: "WL7401";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "The agent board is not initialized";
+    readonly fix: "Run `warlock board init` at the project root first.";
+    readonly skill: "warlock-board";
+  };
+  readonly WL7402: {
+    readonly code: "WL7402";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A board item does not exist";
+    readonly fix: "Run `warlock board status` to list the item ids.";
+    readonly skill: "warlock-board";
+  };
+  readonly WL7403: {
+    readonly code: "WL7403";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "A board item cannot move to the requested state";
+    readonly fix: "Use one of the next states listed in the message; `warlock board status <id>` shows the item's current state.";
+    readonly skill: "warlock-board";
+  };
+  readonly WL7404: {
+    readonly code: "WL7404";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "No board message arrived before the watch timed out";
+    readonly fix: "Run `warlock board watch` again, or raise --timeout.";
+    readonly skill: "warlock-board";
+  };
+  readonly WL7501: {
+    readonly code: "WL7501";
+    readonly area: "cli";
+    readonly category: "code";
+    readonly title: "AGENTS.md has malformed generated-section markers";
+    readonly fix: "Keep one `<!-- warlock:generated:start -->` line followed by one `<!-- warlock:generated:end -->` line, or remove both.";
+    readonly skill: "warlock-agents-md";
+  };
+  readonly WL8001: {
+    readonly code: "WL8001";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "The Node.js version is not supported";
+    readonly fix: "Switch to a Node.js version that satisfies the engines range in the message (for example with nvm).";
+    readonly skill: "update-packages";
+  };
+  readonly WL8002: {
+    readonly code: "WL8002";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "A tool the project is configured to use is not installed";
+    readonly fix: "Install the tool named in the message (pnpm install), or remove its config file.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL8003: {
+    readonly code: "WL8003";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "A service the code needs is unreachable";
+    readonly fix: "Start the service named in the message (database, Redis, ...) or point the config at a running one.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL8004: {
+    readonly code: "WL8004";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "A port is already in use";
+    readonly fix: "Stop whatever listens on the port, or use another port (port 0 in tests).";
+    readonly skill: "run-app";
+    readonly errorNames: readonly ["PortInUseError"];
+  };
+  readonly WL8005: {
+    readonly code: "WL8005";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "esbuild's native binary is not installed";
+    readonly fix: "Run `pnpm approve-builds`, then reinstall dependencies without skipping install scripts.";
+    readonly skill: "run-app";
+    readonly errorNames: readonly ["EsbuildBinaryMissingError"];
+  };
+  readonly WL8006: {
+    readonly code: "WL8006";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "Git cannot list the changed files";
+    readonly fix: "Run inside a git repository with git on PATH, or run the command without --changed.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL8007: {
+    readonly code: "WL8007";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "A tool crashed, timed out or ran out of memory";
+    readonly fix: "Re-run the step; if it repeats, raise the memory limit (NODE_OPTIONS=--max-old-space-size) or use --changed.";
+    readonly skill: "warlock-check";
+  };
+  readonly WL8008: {
+    readonly code: "WL8008";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "The dev server is not running";
+    readonly fix: "Start `warlock dev` in this project, or pass --url with the address of a running dev server.";
+    readonly skill: "warlock-trace";
+  };
+  readonly WL8009: {
+    readonly code: "WL8009";
+    readonly area: "environment";
+    readonly category: "environment";
+    readonly title: "Devtools is not running in the dev server";
+    readonly fix: "Install it with `warlock add devtools` and restart `warlock dev`; devtools answers loopback requests in development only.";
+    readonly skill: "warlock-trace";
+  };
+  readonly WL9001: {
+    readonly code: "WL9001";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "An auto-loaded file is imported";
+    readonly fix: "Remove the import: routes.ts, main.ts, worker.ts and events/ files are loaded by the framework.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9002: {
+    readonly code: "WL9002";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "An import path ends in .js";
+    readonly fix: "Drop the .js extension from the import path.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9003: {
+    readonly code: "WL9003";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A relative import reaches into another module";
+    readonly fix: "Import across modules through the app/<module>/... alias instead of ../../.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9004: {
+    readonly code: "WL9004";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "tsconfig.json enables legacy experimentalDecorators";
+    readonly fix: "Remove \"experimentalDecorators\": true from tsconfig.json; Cascade uses standard decorators.";
+    readonly skill: "lower-stage3-decorators";
+  };
+  readonly WL9005: {
+    readonly code: "WL9005";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "`request.all()` is passed to a query, a service or inApp()";
+    readonly fix: "Give the route a validation schema and pass `request.validated()`, which holds only the fields the schema accepted (mass assignment otherwise).";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9006: {
+    readonly code: "WL9006";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A mutating route has no auth guard and is not marked public";
+    readonly fix: "Register the POST/PUT/PATCH/DELETE route inside `guarded()` (or with auth middleware), or pass `{ public: true }` if it is meant to be open.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9007: {
+    readonly code: "WL9007";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A redirect or link target comes from request input";
+    readonly fix: "Wrap the target in `safeRedirect()` (server, @warlock.js/core) or `safeRedirectTarget()` (pages, @warlock.js/web), or check it with `isSafeRedirect()` first.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9008: {
+    readonly code: "WL9008";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A raw email, credential or request body is logged";
+    readonly fix: "Pass the value through `maskEmail()`, `redact()`, `escapeLogValue()` or `request.toLogSnapshot()`, or log it under a key the logger censors (`token`, `password`, ...).";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9009: {
+    readonly code: "WL9009";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A regex with an unbounded quantifier runs on request input";
+    readonly fix: "Bound the repetition (`{1,256}` instead of `+` or `*`) or cap the input length before matching.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9010: {
+    readonly code: "WL9010";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "`await` on a synchronous log call";
+    readonly fix: "Remove the `await`: `log.info()` and its siblings return the logger; `await log.flush()` waits for delivery.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9011: {
+    readonly code: "WL9011";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A file defines more than one controller";
+    readonly fix: "Move each extra controller into its own `<name>.controller.ts` file.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9012: {
+    readonly code: "WL9012";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A tagged union uses `kind` as its discriminator";
+    readonly fix: "Rename the discriminator to `type` and update the code that narrows on it.";
+    readonly skill: "warlock-conventions";
+  };
+  readonly WL9101: {
+    readonly code: "WL9101";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "A module still uses the deprecated utils/locales.ts";
+    readonly fix: "Run `warlock doctor --fix` to convert it to locales.json, or convert it by hand.";
+    readonly skill: "use-localization";
+  };
+  readonly WL9102: {
+    readonly code: "WL9102";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "package.json version and CHANGELOG.md disagree";
+    readonly fix: "Add a CHANGELOG.md heading for the package.json version, or fix the version.";
+    readonly skill: "warlock-doctor";
+  };
+  readonly WL9103: {
+    readonly code: "WL9103";
+    readonly area: "convention";
+    readonly category: "code";
+    readonly title: "CHANGELOG.md is missing or has no version heading";
+    readonly fix: "Add a CHANGELOG.md with a `## x.y.z` heading for the current version.";
+    readonly skill: "warlock-doctor";
+  };
+};
+/** Every registered code, as a union. */
+type WarlockErrorCode = keyof typeof ERROR_CODES;
+/** Whether `value` is a registered code. */
+declare function isWarlockErrorCode(value: unknown): value is WarlockErrorCode;
+/**
+ * The registry entry for a code, or `undefined` for an unknown one. Case and
+ * surrounding whitespace are ignored, so `explainErrorCode(" wl3001 ")` works.
+ */
+declare function explainErrorCode(code: string): ErrorCodeDefinition | undefined;
+/** The docs URL of a code: the reference page with the code as its anchor. */
+declare function errorCodeDocsUrl(code: WarlockErrorCode): string;
+/**
+ * The Warlock code of a thrown value, or `undefined` when it has none.
+ *
+ * Reads, in order: a registered `code` property (framework errors carry one);
+ * the error's `name`, for classes whose `code` property already means
+ * something else (`PortInUseError.code` is Node's `"EADDRINUSE"`); a Node
+ * system errno such as `ECONNREFUSED`; then the same checks on `cause`. Reading
+ * by name rather than `instanceof` keeps the answer right when two copies of
+ * core are loaded.
+ */
+declare function errorCodeOf(error: unknown): WarlockErrorCode | undefined;
+//#endregion
+export { ERROR_CODES, ERROR_CODES_DOCS_URL, ErrorCodeArea, ErrorCodeCategory, ErrorCodeDefinition, WarlockErrorCode, errorCodeDocsUrl, errorCodeOf, explainErrorCode, isWarlockErrorCode };
+//# sourceMappingURL=error-codes.d.mts.map

package/esm/errors/error-codes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/errors/error-codes.ts"],"mappings":";;AAoCA;;;;AAAyB;AAezB;;;;AAA6B;AAG7B;;;;;;;;;;;;;;;AAgBkB;AAIlB;;;;AAAiC;AAGjC;;;KAzCY,aAAA;;;;;KAeA,iBAAA;;KAGA,mBAAA;mDAED,IAAA;WAEA,IAAA,EAAM,aAAA;WAEN,QAAA,EAAU,iBAAiB;WAE3B,KAAA;WAEA,GAAA;WAEA,KAAA;WAEA,UAAA;WAEA,OAAA;AAAA;;cAIE,oBAAA;;cAGA,WAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+kBD,gBAAA,gBAAgC,WAAW;;iBAGvC,kBAAA,CAAmB,KAAA,YAAiB,KAAA,IAAS,gBAAgB;;;;;iBAQ7D,gBAAA,CAAiB,IAAA,WAAe,mBAAmB;;iBAOnD,gBAAA,CAAiB,IAAsB,EAAhB,gBAAgB;;;;;;;;;;;iBA8BvC,WAAA,CAAY,KAAA,YAAiB,gBAAgB"}