diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 1cde6387..750b7a67 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.25.2"
+  ".": "0.25.3"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6bf0d710..8f1c5f67 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.25.3](https://github.com/zaebee/codegraph-brain/compare/codegraph-brain-v0.25.2...codegraph-brain-v0.25.3) (2026-09-18)
+
+
+### Bug Fixes
+
+* **analyze:** TYPE_CHECKING imports are not a runtime dependency ([#501](https://github.com/zaebee/codegraph-brain/issues/501)) ([a6d09fe](https://github.com/zaebee/codegraph-brain/commit/a6d09fe21c5fa4dd7611ade50aea239dccde6960))
+
+
+### Documentation
+
+* auto-sync architecture graph and MCP reference ([#502](https://github.com/zaebee/codegraph-brain/issues/502)) ([a1156ec](https://github.com/zaebee/codegraph-brain/commit/a1156ec4b8cd4a4d8adfdc610dc2a31c434e11d7))
+
 ## [0.25.2](https://github.com/zaebee/codegraph-brain/compare/codegraph-brain-v0.25.1...codegraph-brain-v0.25.2) (2026-09-18)
 
 
diff --git a/pyproject.toml b/pyproject.toml
index ea984b78..fba14b75 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -7,7 +7,7 @@ packages = ["src/cgis"]
 
 [project]
 name = "codegraph-brain"
-version = "0.25.2"
+version = "0.25.3"
 description = "Semantic code graph for AI agents — deterministic FQN resolution, impact analysis and architectural drift gates, exposed over MCP."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/server.json b/server.json
index 2e238577..8ca52686 100644
--- a/server.json
+++ b/server.json
@@ -8,13 +8,13 @@
     "source": "github",
     "id": "1260843154"
   },
-  "version": "0.25.2",
+  "version": "0.25.3",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "codegraph-brain",
-      "version": "0.25.2",
+      "version": "0.25.3",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"
diff --git a/uv.lock b/uv.lock
index 0c28f1f9..199cb8cb 100644
--- a/uv.lock
+++ b/uv.lock
@@ -261,7 +261,7 @@ wheels = [
 
 [[package]]
 name = "codegraph-brain"
-version = "0.25.2"
+version = "0.25.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },