HugoRCD · HugoRCD · May 5, 2026 · May 5, 2026
diff --git a/.changeset/error-code-field.md b/.changeset/error-code-field.md
diff --git a/examples/community-adapter-skeleton/CHANGELOG.md b/examples/community-adapter-skeleton/CHANGELOG.md
@@ -1,5 +1,12 @@
 # evlog-community-adapter-skeleton
 
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies [[`8080662`](https://github.com/HugoRCD/evlog/commit/8080662e0ba2b3746aebf0aa1c5cf89756c3c44d)]:
+  - evlog@2.16.0
+
 ## 1.0.0
 
 ### Patch Changes

diff --git a/examples/community-adapter-skeleton/package.json b/examples/community-adapter-skeleton/package.json
@@ -1,6 +1,6 @@
 {
   "name": "evlog-community-adapter-skeleton",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Reference skeleton for a community evlog drain adapter built on defineHttpDrain.",
   "private": true,
   "type": "module",

diff --git a/examples/community-enricher-skeleton/CHANGELOG.md b/examples/community-enricher-skeleton/CHANGELOG.md
@@ -1,5 +1,12 @@
 # evlog-community-enricher-skeleton
 
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies [[`8080662`](https://github.com/HugoRCD/evlog/commit/8080662e0ba2b3746aebf0aa1c5cf89756c3c44d)]:
+  - evlog@2.16.0
+
 ## 1.0.0
 
 ### Patch Changes

diff --git a/examples/community-enricher-skeleton/package.json b/examples/community-enricher-skeleton/package.json
@@ -1,6 +1,6 @@
 {
   "name": "evlog-community-enricher-skeleton",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Reference skeleton for a community evlog enricher built on defineEnricher.",
   "private": true,
   "type": "module",

diff --git a/examples/community-framework-skeleton/CHANGELOG.md b/examples/community-framework-skeleton/CHANGELOG.md
@@ -1,5 +1,12 @@
 # evlog-community-framework-skeleton
 
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies [[`8080662`](https://github.com/HugoRCD/evlog/commit/8080662e0ba2b3746aebf0aa1c5cf89756c3c44d)]:
+  - evlog@2.16.0
+
 ## 1.0.0
 
 ### Patch Changes

diff --git a/examples/community-framework-skeleton/package.json b/examples/community-framework-skeleton/package.json
@@ -1,6 +1,6 @@
 {
   "name": "evlog-community-framework-skeleton",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Reference skeleton for a community evlog framework integration built on defineFrameworkIntegration.",
   "private": true,
   "type": "module",

diff --git a/packages/evlog/CHANGELOG.md b/packages/evlog/CHANGELOG.md
@@ -1,5 +1,35 @@
 # evlog
 
+## 2.16.0
+
+### Minor Changes
+
+- [#318](https://github.com/HugoRCD/evlog/pull/318) [`8080662`](https://github.com/HugoRCD/evlog/commit/8080662e0ba2b3746aebf0aa1c5cf89756c3c44d) Thanks [@HugoRCD](https://github.com/HugoRCD)! - Add an optional `code` field to `createError` / `EvlogError` so structured errors can carry a stable, machine-readable identifier for client branching, dashboards, and future error-catalog tooling. Foundation for an upcoming `defineErrorCatalog` primitive.
+
+  ```ts
+  import { createError, parseError } from "evlog";
+
+  throw createError({
+    code: "PAYMENT_DECLINED",
+    message: "Payment failed",
+    status: 402,
+    why: "Card declined by issuer",
+    fix: "Try a different payment method",
+  });
+
+  // Client
+  const err = parseError(caught);
+  if (err.code === "PAYMENT_DECLINED") retryWithDifferentCard();
+  ```
+
+  `code` is public and propagates through every existing serialization path with no breaking change:
+  - **HTTP responses** — surfaces under `data.code` via the existing `EvlogError.data` getter (Nitro v2/v3, Next.js, and any framework using `serializeEvlogErrorResponse` get it for free).
+  - **`parseError(err)`** — new `code` field on `ParsedError`. Extracted from EvlogError JSON, h3-style `data.code`, and Node-style `Error.code` (e.g. `'ENOENT'`, `'ECONNRESET'`) so existing system errors flow through the same client branch.
+  - **Wide events** — copied onto `event.error.code` so drains and dashboards can group, alert, and chart by code without parsing free-text messages.
+  - **`toString()`** — renders a `Code:` line for terminal pretty-print.
+
+  Out of scope here (planned next): `defineErrorCatalog` for centralized typed code unions, plus the equivalent for audit actions.
+
 ## 2.15.0
 
 ### Minor Changes

diff --git a/packages/evlog/package.json b/packages/evlog/package.json
@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "Modern TypeScript logger — simple logs, wide events, structured errors. Built for scripts, libraries, jobs, edge, and HTTP. One drain pipeline everywhere.",
   "author": "HugoRCD <contact@hrcd.fr>",
   "homepage": "https://evlog.dev",