diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index aca3a49..8d17a8e 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "2.3.1"
+  ".": "2.3.2"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 717bea7..0d5d980 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## [2.3.2](https://github.com/shahboura/agents-opencode/compare/v2.3.1...v2.3.2) (2026-07-08)
+
+
+### Bug Fixes
+
+* tarball cleanup and README restructure ([cfa6f28](https://github.com/shahboura/agents-opencode/commit/cfa6f2815abfd2f253b73561a826de1d8da2abe3))
+* **Tarball cleanup** — `.opencode/package-lock.json` and `.opencode/package.json` no longer ship in the npm tarball. These dev-only plugin dependency files were scanned by Socket.dev, which flagged Apache-2.0 transitive deps and docked the license score to 70 despite MIT licensing. Fixed by replacing the wildcard `"files": [".opencode"]` with explicit subdirectories.
+* **README restructure** — moved cache efficiency stats to 2nd section (was near bottom), added a 30-second demo, collapsed the 10-command install block into 1 command + `<details>`, trimmed verbose behavior notes, moved permission YAML into `<details>`, and rewrote the agent "Best For" column from role labels to action+outcome.
+* **July metrics** — added July column to the efficiency table (145M cache hits, 98.2% hit rate, 1,016 requests). Combined 3-month hit rate now 97.3% across 2,803 requests.
+
 ## [2.3.1](https://github.com/shahboura/agents-opencode/compare/v2.3.0...v2.3.1) (2026-07-03)
 
 
diff --git a/package-lock.json b/package-lock.json
index ba545df..52726a0 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "agents-opencode",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "agents-opencode",
-      "version": "2.3.1",
+      "version": "2.3.2",
       "license": "MIT",
       "bin": {
         "agents-opencode": "install.js"
diff --git a/package.json b/package.json
index 8364324..34b49fd 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "agents-opencode",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "OpenCode Agents: Intelligent AI assistants for software development. Features 9 specialized agents (including legal-advisor for license auditing and compliance), 14 coding standards, automated code review, documentation generation, OpenCode plugin compatibility, and cross-platform installation. Supports .NET, Python, TypeScript, Flutter, Go, Java, Node.js, React, Ruby, and Rust with plan-first execution and context-aware assistance.",
   "files": [
     "install.js",