chore(release): bump to v0.3.1

Cargo.toml

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 license = "MIT"
 repository = "https://github.com/DevVig/microbridge"

apps/microbridge-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "microbridge-ui",
   "private": true,
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "scripts": {
     "dev": "vite",

apps/microbridge-ui/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "microbridge-ui"
-version = "0.3.0"
+version = "0.3.1"
 description = "Microbridge menu bar app (primary UI)"
 authors = ["Microbridge contributors"]
 edition = "2021"

apps/microbridge-ui/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Microbridge",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "identifier": "ai.microbridge.ui",
   "build": {
     "beforeDevCommand": "npm run dev",

docs/releases/v0.3.1.md

@@ -0,0 +1,50 @@
+# Microbridge 0.3.1 (2026-07-20)
+
+This patch release adds native CNVS support without changing existing adapter
+configuration or installation paths.
+
+## Highlight
+
+- **CNVS:** Microbridge now discovers agent terminals through CNVS's
+  authenticated local control API. Each session is tied to its exact canvas
+  and terminal node, so an Agent Key can switch to the correct workspace,
+  select the intended terminal, and bring CNVS forward.
+
+## Controls
+
+- Agent lifecycle state drives the existing key assignment and LED pipeline.
+- Double-press/open focuses the exact CNVS canvas and terminal.
+- Interrupt routes to the exact running terminal.
+- Approval, new-session, and reasoning-effort controls remain disabled because
+  CNVS does not expose stable targets for them through this contract.
+
+## Privacy and footprint
+
+- No CNVS plugin, pairing code, private database access, or workspace changes.
+- The short-lived CNVS token is read from its endpoint descriptor for each
+  scan or action and is never logged or persisted by Microbridge.
+- Only loopback endpoints are accepted. Snapshot refreshes are adaptive and
+  publish only changed sessions.
+
+## Upgrade notes
+
+- No migration or manual configuration is required. CNVS support is enabled by
+  default and connects automatically while CNVS is running.
+- Direct installs can use **Check for Updates…**. Homebrew installs update with
+  `brew update && brew upgrade microbridge` after the formula promotion finishes.
+
+## Verification
+
+- Live CNVS test across 8 canvases and 9 agent terminals.
+- Agent Key routing switched to ProjectHeimdall, selected the exact requested
+  Codex terminal node, and brought CNVS to the foreground.
+- Rust workspace tests, strict Clippy, formatting, UI tests/build, Tauri compile,
+  macOS CI, Linux CI, and a clean local CodeRabbit review.
+
+## Risk / notes
+
+- Existing `v0.3.0` installations do not contain CNVS support until upgraded.
+- Cursor-hosted CNVS terminals may appear twice because Cursor's current managed
+  lifecycle payload does not expose enough stable workspace identity for exact
+  reconciliation. Codex and Claude journal duplicates are reconciled safely.
+- Physical Codex Micro behavior still requires validation on real hardware.