diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index ada7355e..b4b8d0ff 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "3.1.0"
+  ".": "3.1.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 77ee4421..3566eb3a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## [3.1.1](https://github.com/morluto/rea/compare/rea-agents-3.1.0...rea-agents-3.1.1) (2026-08-14)
+
+
+### Bug Fixes
+
+* **ci:** retain artifacts for delayed reruns ([07888ec](https://github.com/morluto/rea/commit/07888ec096f69753a1535703fb7b3c3070e786b7))
+
+
+### Code Refactoring
+
+* **domain:** encode comparison and lifecycle states exactly ([#473](https://github.com/morluto/rea/issues/473)) ([d65730c](https://github.com/morluto/rea/commit/d65730c4c24ab6183426516d4564e6c25294b35d))
+* **test:** colocate pure-domain tests and reduce test debt ([#471](https://github.com/morluto/rea/issues/471)) ([e91c8c3](https://github.com/morluto/rea/commit/e91c8c39c2acddc4389ed0d01950d1954c472e47))
+* **test:** keep coverage at behavioral boundaries ([#474](https://github.com/morluto/rea/issues/474)) ([d4dc940](https://github.com/morluto/rea/commit/d4dc940bd871089ffa1b42d3475798b2f4f9c992))
+
 ## [3.1.0](https://github.com/morluto/rea/compare/rea-agents-3.0.0...rea-agents-3.1.0) (2026-08-09)
 
 
diff --git a/README.md b/README.md
index 7264083d..c6390d22 100644
--- a/README.md
+++ b/README.md
@@ -535,7 +535,7 @@ Setup detects Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf,
   "mcpServers": {
     "rea": {
       "command": "npx",
-      "args": ["-y", "rea-agents@3.1.0", "mcp"]
+      "args": ["-y", "rea-agents@3.1.1", "mcp"]
     }
   }
 }
diff --git a/README_ar.md b/README_ar.md
index eb03754e..0f957458 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -183,7 +183,7 @@ rea uninstall --purge-data
   "mcpServers": {
     "rea": {
       "command": "npx",
-      "args": ["-y", "rea-agents@3.1.0", "mcp"]
+      "args": ["-y", "rea-agents@3.1.1", "mcp"]
     }
   }
 }
diff --git a/README_ja.md b/README_ja.md
index 4ba596db..58fa9dfe 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -173,7 +173,7 @@ Setup は Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf
   "mcpServers": {
     "rea": {
       "command": "npx",
-      "args": ["-y", "rea-agents@3.1.0", "mcp"]
+      "args": ["-y", "rea-agents@3.1.1", "mcp"]
     }
   }
 }
diff --git a/README_ko.md b/README_ko.md
index 889f688b..c0673738 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -173,7 +173,7 @@ Setup은 Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf, Devin
   "mcpServers": {
     "rea": {
       "command": "npx",
-      "args": ["-y", "rea-agents@3.1.0", "mcp"]
+      "args": ["-y", "rea-agents@3.1.1", "mcp"]
     }
   }
 }
diff --git a/README_zh.md b/README_zh.md
index ebdde2cb..8e45adc5 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -173,7 +173,7 @@ Setup 会检测 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Win
   "mcpServers": {
     "rea": {
       "command": "npx",
-      "args": ["-y", "rea-agents@3.1.0", "mcp"]
+      "args": ["-y", "rea-agents@3.1.1", "mcp"]
     }
   }
 }
diff --git a/docs/product-catalog.json b/docs/product-catalog.json
index 7acc9a5e..30ea4d2c 100644
--- a/docs/product-catalog.json
+++ b/docs/product-catalog.json
@@ -2,7 +2,7 @@
   "catalog_schema_version": 1,
   "package": {
     "name": "rea-agents",
-    "version": "3.1.0",
+    "version": "3.1.1",
     "sdk": {
       "server": "2.0.0",
       "client": "2.0.0",
diff --git a/package-lock.json b/package-lock.json
index 72aa01b0..609e093e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "rea-agents",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "rea-agents",
-      "version": "3.1.0",
+      "version": "3.1.1",
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "8.0.4",
diff --git a/package.json b/package.json
index 1f985bc6..2b6eccb5 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "rea-agents",
   "mcpName": "io.github.morluto/rea",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Reverse engineer anything from your terminal or agent with one CLI and MCP server.",
   "license": "MIT",
   "repository": {
diff --git a/server.json b/server.json
index bb8b3c4d..ebda7308 100644
--- a/server.json
+++ b/server.json
@@ -8,13 +8,13 @@
     "url": "https://github.com/morluto/rea",
     "source": "github"
   },
-  "version": "3.1.0",
+  "version": "3.1.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "rea-agents",
-      "version": "3.1.0",
+      "version": "3.1.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
diff --git a/src/generatedPackageMetadata.ts b/src/generatedPackageMetadata.ts
index 9639036e..70e2b5a2 100644
--- a/src/generatedPackageMetadata.ts
+++ b/src/generatedPackageMetadata.ts
@@ -1,7 +1,7 @@
 /** Generated from package.json and package-lock.json; do not edit. */
 export const PACKAGE_METADATA = {
   name: "rea-agents",
-  version: "3.1.0", // x-release-please-version
+  version: "3.1.1", // x-release-please-version
   serverSdkVersion: "2.0.0",
   clientSdkVersion: "2.0.0",
   coreSdkVersion: "2.0.0",