diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index d4f6f2994..ada7355e0 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "3.0.0"
+  ".": "3.1.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4bee6066f..92e8aa513 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [3.1.0](https://github.com/dallay/corvus/compare/v3.0.0...v3.1.0) (2026-04-12)
+
+
+### Features
+
+* capability-based agent composition and architecture ([#520](https://github.com/dallay/corvus/issues/520)) ([69353fc](https://github.com/dallay/corvus/commit/69353fc8ab0105cd5206096760193829a95d2515))
+
 ## [3.0.0](https://github.com/dallay/corvus/compare/v2.3.1...v3.0.0) (2026-04-12)
 
 
diff --git a/clients/agent-runtime/Cargo.lock b/clients/agent-runtime/Cargo.lock
index f7be0f69c..dd54c67af 100644
--- a/clients/agent-runtime/Cargo.lock
+++ b/clients/agent-runtime/Cargo.lock
@@ -807,7 +807,7 @@ dependencies = [
 
 [[package]]
 name = "cerebro"
-version = "3.0.0"
+version = "3.1.0"
 dependencies = [
  "anyhow",
  "async-trait",
@@ -1142,7 +1142,7 @@ dependencies = [
 
 [[package]]
 name = "corvus"
-version = "3.0.0"
+version = "3.1.0"
 dependencies = [
  "anyhow",
  "async-trait",
@@ -7020,9 +7020,9 @@ dependencies = [
 
 [[package]]
 name = "surrealdb-rocksdb"
-version = "0.24.0-surreal.2"
+version = "0.24.0-surreal.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7ad8043908ee7d39c8eb01eaccc7c285f19313b0544b45c92ed85339019ab38"
+checksum = "fc16b80e46348dc188693328fe2a818b8f47457e40451364bd2ae73df7cb738e"
 dependencies = [
  "libc",
  "surrealdb-librocksdb-sys",
diff --git a/clients/agent-runtime/Cargo.toml b/clients/agent-runtime/Cargo.toml
index d1602e65c..7671b37f8 100644
--- a/clients/agent-runtime/Cargo.toml
+++ b/clients/agent-runtime/Cargo.toml
@@ -4,7 +4,7 @@ resolver = "2"
 
 [package]
 name = "corvus"
-version = "3.0.0"
+version = "3.1.0"
 edition = "2021"
 build = "build.rs"
 authors = ["theonlyhennygod"]
@@ -109,7 +109,7 @@ chrono-tz = "0.10"
 cron = "0.15"
 
 # Cerebro MCP service client
-cerebro = { version = "3.0.0", path = "../../modules/cerebro" }
+cerebro = { version = "3.1.0", path = "../../modules/cerebro" }
 
 # Interactive CLI prompts
 dialoguer = { version = "0.12", features = ["fuzzy-select"] }
diff --git a/clients/agent-runtime/npm/corvus-darwin-arm64/package.json b/clients/agent-runtime/npm/corvus-darwin-arm64/package.json
index 6eaffad05..37701f94a 100644
--- a/clients/agent-runtime/npm/corvus-darwin-arm64/package.json
+++ b/clients/agent-runtime/npm/corvus-darwin-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus-darwin-arm64",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI for macOS Apple Silicon (ARM64)",
   "license": "Apache-2.0",
   "os": [
diff --git a/clients/agent-runtime/npm/corvus-darwin-x64/package.json b/clients/agent-runtime/npm/corvus-darwin-x64/package.json
index c0a45769d..e2eee6b71 100644
--- a/clients/agent-runtime/npm/corvus-darwin-x64/package.json
+++ b/clients/agent-runtime/npm/corvus-darwin-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus-darwin-x64",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI for macOS Intel (x64)",
   "license": "Apache-2.0",
   "os": [
diff --git a/clients/agent-runtime/npm/corvus-linux-arm64/package.json b/clients/agent-runtime/npm/corvus-linux-arm64/package.json
index 97bc3a6b7..b2773425f 100644
--- a/clients/agent-runtime/npm/corvus-linux-arm64/package.json
+++ b/clients/agent-runtime/npm/corvus-linux-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus-linux-arm64",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI for Linux ARM64",
   "license": "Apache-2.0",
   "os": [
diff --git a/clients/agent-runtime/npm/corvus-linux-x64/package.json b/clients/agent-runtime/npm/corvus-linux-x64/package.json
index f39a2cb03..336ca1d02 100644
--- a/clients/agent-runtime/npm/corvus-linux-x64/package.json
+++ b/clients/agent-runtime/npm/corvus-linux-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus-linux-x64",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI for Linux x64",
   "license": "Apache-2.0",
   "os": [
diff --git a/clients/agent-runtime/npm/corvus-windows-x64/package.json b/clients/agent-runtime/npm/corvus-windows-x64/package.json
index 56e15cc3f..86b13e378 100644
--- a/clients/agent-runtime/npm/corvus-windows-x64/package.json
+++ b/clients/agent-runtime/npm/corvus-windows-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus-windows-x64",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI for Windows x64",
   "license": "Apache-2.0",
   "os": [
diff --git a/clients/agent-runtime/npm/corvus/package.json b/clients/agent-runtime/npm/corvus/package.json
index ebba334dd..af116dafb 100644
--- a/clients/agent-runtime/npm/corvus/package.json
+++ b/clients/agent-runtime/npm/corvus/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@dallay/corvus",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Corvus runtime CLI - Cross-platform binary distribution",
   "license": "Apache-2.0",
   "repository": {
@@ -16,11 +16,11 @@
   ],
   "scripts": {},
   "optionalDependencies": {
-    "@dallay/corvus-darwin-x64": "3.0.0",
-    "@dallay/corvus-darwin-arm64": "3.0.0",
-    "@dallay/corvus-linux-x64": "3.0.0",
-    "@dallay/corvus-linux-arm64": "3.0.0",
-    "@dallay/corvus-windows-x64": "3.0.0"
+    "@dallay/corvus-darwin-x64": "3.1.0",
+    "@dallay/corvus-darwin-arm64": "3.1.0",
+    "@dallay/corvus-linux-x64": "3.1.0",
+    "@dallay/corvus-linux-arm64": "3.1.0",
+    "@dallay/corvus-windows-x64": "3.1.0"
   },
   "engines": {
     "node": ">=18"
diff --git a/gradle.properties b/gradle.properties
index c41befa2c..e77ed297e 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -25,7 +25,7 @@ org.gradle.configuration-cache.integrity-check=false
 # project repo info. snapshot: -SNAPSHOT
 GROUP=com.profiletailors
 # x-release-please-start-version
-VERSION=3.0.0
+VERSION=3.1.0
 # x-release-please-end
 LICENSE=NONE
 
diff --git a/gradle/build-logic/gradle.properties b/gradle/build-logic/gradle.properties
index 49dbe0060..941f0520d 100644
--- a/gradle/build-logic/gradle.properties
+++ b/gradle/build-logic/gradle.properties
@@ -17,7 +17,7 @@ org.gradle.configuration-cache.integrity-check=true
 # project repo info. snapshot: -SNAPSHOT
 GROUP=com.profiletailors
 # x-release-please-start-version
-VERSION=3.0.0
+VERSION=3.1.0
 # x-release-please-end
 
 # gradle-maven-publish-plugin
diff --git a/modules/cerebro/Cargo.lock b/modules/cerebro/Cargo.lock
index b5d7a79a5..ba9757d12 100644
--- a/modules/cerebro/Cargo.lock
+++ b/modules/cerebro/Cargo.lock
@@ -578,7 +578,7 @@ dependencies = [
 
 [[package]]
 name = "cerebro"
-version = "3.0.0"
+version = "3.1.0"
 dependencies = [
  "anyhow",
  "assert_cmd",
@@ -4480,9 +4480,9 @@ dependencies = [
 
 [[package]]
 name = "surrealdb-rocksdb"
-version = "0.24.0-surreal.2"
+version = "0.24.0-surreal.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7ad8043908ee7d39c8eb01eaccc7c285f19313b0544b45c92ed85339019ab38"
+checksum = "fc16b80e46348dc188693328fe2a818b8f47457e40451364bd2ae73df7cb738e"
 dependencies = [
  "libc",
  "surrealdb-librocksdb-sys",
diff --git a/modules/cerebro/Cargo.toml b/modules/cerebro/Cargo.toml
index b8d986525..df2780bc0 100644
--- a/modules/cerebro/Cargo.toml
+++ b/modules/cerebro/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "cerebro"
-version = "3.0.0"
+version = "3.1.0"
 edition = "2021"
 license = "Apache-2.0"
 autobins = false
diff --git a/version.txt b/version.txt
index 4a36342fc..fd2a01863 100644
--- a/version.txt
+++ b/version.txt
@@ -1 +1 @@
-3.0.0
+3.1.0