diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9b4f76d..da90293 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
-## [Unreleased]
+## [0.3.2] - 2026-08-24
 
 ### Fixed
 
@@ -13,6 +13,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
   so folded CSS rule sets keep a parseable `}` closer. Corpus re-parse
   regressions on `/usr/include`, `/usr/lib/go/src`, and `/usr/lib/python3.14`
   (55,498 files, 1,879,020 raw-parse-ok slices): 458 → 0.
+- **`deps` sibling shadows in degenerate roots** — when no `.git` ancestor
+  exists anywhere above the analyzed file, the fallback project root equals
+  the file's own directory, so a same-directory namesake of a bare import is
+  now classified `Unresolved` instead of guessed `Local`. Explicit relative
+  imports stay `Local`; trees rooted by a `.git` ancestor are unchanged.
+
+### Changed
+
+- **`mcp` tool ergonomics aligned with real agent call patterns** —
+  absolute paths under the pinned workspace root are now accepted; read
+  `lines` is optional (omitted or empty returns the whole file); numeric
+  arguments coerce to their decimal string form; teaching errors guide
+  recovery: unknown tools enumerate the registry, missing required
+  arguments append usage hints, unknown arguments list valid keys, and
+  not-found symbols suggest up to three similar names from the file.
 
 ## [0.3.1] - 2026-08-24
 
diff --git a/Cargo.lock b/Cargo.lock
index c210ea9..979c0db 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -157,7 +157,7 @@ checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"
 
 [[package]]
 name = "ctx-exec"
-version = "0.3.1"
+version = "0.3.2"
 dependencies = [
  "regex",
  "serde",
@@ -167,7 +167,7 @@ dependencies = [
 
 [[package]]
 name = "ctx-symbol"
-version = "0.3.1"
+version = "0.3.2"
 dependencies = [
  "regex",
  "serde",
@@ -191,7 +191,7 @@ dependencies = [
 
 [[package]]
 name = "ctxctl"
-version = "0.3.1"
+version = "0.3.2"
 dependencies = [
  "clap",
  "ctx-exec",
diff --git a/Cargo.toml b/Cargo.toml
index 318cc64..ce337e4 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -3,7 +3,7 @@ resolver = "2"
 members = ["crates/ctx-symbol", "crates/ctx-exec", "crates/ctxctl"]
 
 [workspace.package]
-version = "0.3.1"
+version = "0.3.2"
 edition = "2024"
 license = "MIT"
 authors = ["fuyu"]
@@ -11,8 +11,8 @@ repository = "https://github.com/Xuepoo/ctxctl"
 homepage = "https://ctxctl.xuepoo.xyz"
 
 [workspace.dependencies]
-ctx-symbol = { path = "crates/ctx-symbol", version = "0.3.1" }
-ctx-exec = { path = "crates/ctx-exec", version = "0.3.1" }
+ctx-symbol = { path = "crates/ctx-symbol", version = "0.3.2" }
+ctx-exec = { path = "crates/ctx-exec", version = "0.3.2" }
 clap = { version = "4", features = ["derive"] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"