@seemseam/ccb 8.2.1 → 8.3.1

package/README/ar.md

@@ -6,7 +6,7 @@
 **نسّق Codex وClaude وGemini وغيرهم من وكلاء CLI ضمن سير عمل مرئي وقابل للتحكم والتدخل المباشر**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## طريقة التثبيت
 
-ثبّت أو حدّث باستخدام npm:
+ثبّت أو حدّث نسخة CCB التي يديرها npm باستخدام npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-بعد تثبيت CCB استخدم updater المدمج:
+للتثبيت من GitHub release أو المصدر استخدم updater المعاملاتي في CCB:
 
 ```bash
 ccb update
 ```
 
+في التثبيت الذي يديره npm يعرض `ccb update` أمر npm المكافئ ولا يعدّل payload المضمّن.
+
 <details>
 <summary><b>حزم GitHub release وخيار التثبيت من المصدر</b></summary>
 
@@ -180,9 +182,9 @@ ccb update mobile
 <details>
 <summary><b>تفاصيل Mobile App وحدود الأمان والمصدر</b></summary>
 
-يتضمن CCB 8.2.1 مصدر Flutter الخاص بـ CCB Mobile داخل [`mobile/`](../mobile/) وينشر Android APK عبر GitHub Releases:
+يتضمن CCB 8.3.1 مصدر Flutter الخاص بـ CCB Mobile داخل [`mobile/`](../mobile/) وينشر Android APK عبر GitHub Releases:
 
-- [تنزيل CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [تنزيل CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - مصدر التطبيق: [`mobile/app`](../mobile/app)
 - مصدر gateway الخادم: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ ccb update rich
 ## ملاحظات الإصدار
 
 <details open>
+<summary><b>v8.3.1</b> - تحديثات Provider موحدة وتنظيف آمن للذاكرة المؤقتة ووصول ثابت إلى Config UI</summary>
+
+- يوحّد ترقيات Provider المدعومة داخل `ccb update` مع فحص الإصدار وخيارات الرفض أو تخطي الإصدار المحدد، من دون إعادة تشغيل panes النشطة.
+- يلغي ذاكرات Claude وGemini المؤقتة الخاصة بكل مشروع ويضيف تنظيفاً محدوداً يحافظ على المشاريع النشطة وبيانات الجلسات والمصادقة.
+- يضيف منفذ loopback ثابتاً ومصدر token محمياً لـ Config UI من دون إظهار قيمة token.
+- يحافظ على shutdown finalizers أثناء توقف الخادم ويستخدم تخطيط Yazi مدمجاً بعمودين في Rich mode.
+- يزامن CLI وnpm وLinux وmacOS وAndroid وجميع أصول الإصدار مع 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - دورات provider دقيقة وسلامة jobs وMobile terminal داخل المشروع</summary>
+
+- يربط Kimi وClaude وQoder بعقود turn وactivation وsession وcompletion الأصلية لكل منها.
+- يضيف follow-up للـ active job الدقيق ومراحل تنفيذ مترابطة وتشخيص inbound اليتيم ونتيجة cancellation نهائية.
+- يرث امتدادات providers وإضافات Copilot مع حماية ownership صريحة للـ assets المسقطة.
+- يفوض ترقيات التثبيت المُدار عبر npm إلى npm ويسحب worktrees التي تحتوي markers فقط بصورة متحفظة.
+- يبقي chat وterminal في Mobile داخل workspace المشروع المحدد ويزامن جميع أسطح الإصدار مع 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - بدء حتمي واستعادة مصادقة قابلة للتنفيذ واتصال Android في الخلفية</summary>
 
 - أضيفت حواجز جيل البدء وإثبات الجاهزية المحدود وتشخيصات العمليات والخط الزمني.

package/README/de.md

@@ -6,7 +6,7 @@
 **Koordiniere Codex, Claude, Gemini und andere CLI-Agenten in sichtbaren, steuerbaren Workflows, die du direkt uebernehmen kannst**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## Installation
 
-Installieren oder aktualisieren Sie mit npm:
+Installieren oder aktualisieren Sie eine von npm verwaltete CCB-Installation mit npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-Nach der Installation verwenden Sie den CCB updater:
+Für GitHub-release- oder Source-Installationen verwenden Sie den transaktionalen CCB updater:
 
 ```bash
 ccb update
 ```
 
+Bei einer von npm verwalteten Installation zeigt `ccb update` den entsprechenden npm-Befehl an und ändert das eingebettete Payload nicht.
+
 <details>
 <summary><b>GitHub-release-Pakete und Source-Install als Fallback</b></summary>
 
@@ -180,9 +182,9 @@ Dieser Befehl fuehrt durch Installation und Konfiguration.
 <details>
 <summary><b>Mobile-App-Details, Sicherheitsgrenze und Source</b></summary>
 
-CCB 8.2.1 enthaelt den Flutter-Quellcode von CCB Mobile in [`mobile/`](../mobile/) und veroeffentlicht das Android APK ueber GitHub Releases:
+CCB 8.3.1 enthaelt den Flutter-Quellcode von CCB Mobile in [`mobile/`](../mobile/) und veroeffentlicht das Android APK ueber GitHub Releases:
 
-- [CCB Mobile v8.2.1 APK herunterladen](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [CCB Mobile v8.3.1 APK herunterladen](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - App-Source: [`mobile/app`](../mobile/app)
 - Server-gateway-Source: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ Danke an [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) fue
 ## Release Notes
 
 <details open>
+<summary><b>v8.3.1</b> - Einheitliche Provider-Updates, sichere Cache-Ablösung und persistenter Config-UI-Zugriff</summary>
+
+- Buendelt unterstuetzte Provider-Upgrades in `ccb update`, einschliesslich exakter Versionspruefung, Ablehnen und versionsgenauem Ueberspringen, ohne aktive Panes neu zu starten.
+- Ersetzt projektbezogene Claude-/Gemini-Software-Caches und bereinigt nur eindeutig CCB-eigene Altlasten; aktive Projekte, Sessions und Auth-Daten bleiben erhalten.
+- Ermoeglicht einen festen Loopback-Port und eine geschuetzte Token-Quelle fuer die Config UI, ohne Token-Werte auszugeben.
+- Erhaelt Shutdown-Finalizer waehrend des Serverstopps und nutzt im Rich Mode ein kompaktes Yazi-Layout mit zwei Spalten.
+- Synchronisiert CLI, npm, Linux, macOS, Android und alle Release-Artefakte auf 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Exakte Provider-Turns, Job-Integritaet und projektgebundenes Mobile-Terminal</summary>
+
+- Bindet Kimi, Claude und Qoder an ihre nativen Turn-, Aktivierungs-, Session- und Completion-Vertraege.
+- Ergaenzt Follow-ups fuer den exakten aktiven Job, korrelierte Ausfuehrungsphasen, Diagnose verwaister Inbounds und terminale Cancellation-Ergebnisse.
+- Uebernimmt Provider-Erweiterungen und Copilot-Plugins mit explizitem Ownership-Schutz fuer projizierte Assets.
+- Delegiert npm-verwaltete Upgrades an npm und entfernt Marker-only-Worktrees konservativ.
+- Haelt Mobile-Chat und -Terminal im Workspace des ausgewaehlten Projekts und synchronisiert alle Release-Oberflaechen mit 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Deterministischer Start, klare Auth-Recovery und Android-Hintergrundzugriff</summary>
 
 - Fuegt durchgaengige Startup-Generationszaeune, begrenzte Readiness-Nachweise und Zeitliniendiagnosen hinzu.

package/README/es.md

@@ -6,7 +6,7 @@
 **Coordina Codex, Claude, Gemini y otros agentes CLI en flujos visibles y controlables que puedes tomar directamente**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## Cómo instalar
 
-Instala o actualiza con npm:
+Instala o actualiza una instalación administrada por npm con npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-Después de instalar CCB, usa su updater:
+Para instalaciones desde GitHub release o fuente, usa el updater transaccional de CCB:
 
 ```bash
 ccb update
 ```
 
+En una instalación administrada por npm, `ccb update` muestra el comando npm equivalente sin modificar el payload incluido.
+
 <details>
 <summary><b>Paquete de GitHub release e instalación desde fuente como respaldo</b></summary>
 
@@ -180,9 +182,9 @@ Este comando guía la instalación y configuración.
 <details>
 <summary><b>Detalles de Mobile App, límite de seguridad y fuente</b></summary>
 
-CCB 8.2.1 incluye el código Flutter de CCB Mobile en [`mobile/`](../mobile/) y publica el APK Android mediante GitHub Releases:
+CCB 8.3.1 incluye el código Flutter de CCB Mobile en [`mobile/`](../mobile/) y publica el APK Android mediante GitHub Releases:
 
-- [Descargar CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [Descargar CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - Fuente de la app: [`mobile/app`](../mobile/app)
 - Fuente del gateway del servidor: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ Gracias a [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) po
 ## Notas de versión
 
 <details open>
+<summary><b>v8.3.1</b> - Actualizaciones unificadas de providers, retiro seguro de cachés y acceso persistente a Config UI</summary>
+
+- Centraliza las actualizaciones compatibles de providers en `ccb update`, con comprobación exacta de versión, rechazo y omisión por versión, sin reiniciar panes activos.
+- Retira las cachés de software Claude/Gemini por proyecto y limpia solo datos heredados cuya propiedad está verificada; conserva proyectos activos, sesiones y autenticación.
+- Permite un puerto loopback estable y una fuente de token protegida para Config UI sin mostrar el valor del token.
+- Conserva los finalizadores de shutdown mientras se detiene el servidor y adopta un diseño Yazi compacto de dos columnas en Rich mode.
+- Sincroniza CLI, npm, Linux, macOS, Android y todos los artefactos de release con 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Turnos exactos de providers, integridad de jobs y terminal Mobile dentro del proyecto</summary>
+
+- Vincula Kimi, Claude y Qoder a sus contratos nativos de turno, activación, sesión y finalización.
+- Añade follow-ups para el job activo exacto, fases de ejecución correlacionadas, diagnóstico de inbounds huérfanos y cancelación terminal.
+- Hereda extensiones de providers y plugins de Copilot con protección explícita de ownership para los assets proyectados.
+- Delega las actualizaciones gestionadas por npm a npm y retira de forma conservadora los worktrees que solo contienen marcadores.
+- Mantiene el chat y el terminal Mobile dentro del workspace del proyecto seleccionado y sincroniza todas las superficies de release con 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Inicio determinista, recuperación de autenticación accionable y conexión Android en segundo plano</summary>
 
 - Añade cercas de generación de inicio, prueba acotada de disponibilidad y diagnósticos de operaciones y cronología.

package/README/fr.md

@@ -6,7 +6,7 @@
 **Coordonne Codex, Claude, Gemini et d'autres agents CLI dans des workflows visibles, contrôlables et reprenables directement**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## Comment installer
 
-Installez ou mettez à jour avec npm :
+Installez ou mettez à jour une installation gérée par npm avec npm :
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-Après l'installation, utilisez l'updater intégré de CCB :
+Pour une installation GitHub release ou source, utilisez l'updater transactionnel de CCB :
 
 ```bash
 ccb update
 ```
 
+Dans une installation gérée par npm, `ccb update` affiche la commande npm équivalente sans modifier le payload embarqué.
+
 <details>
 <summary><b>Paquets GitHub release et installation source en secours</b></summary>
 
@@ -180,9 +182,9 @@ Cette commande guide l'installation et la configuration.
 <details>
 <summary><b>Détails de l'app mobile, frontière de sécurité et source</b></summary>
 
-CCB 8.2.1 inclut le code source Flutter de CCB Mobile dans [`mobile/`](../mobile/) et publie l'APK Android via GitHub Releases :
+CCB 8.3.1 inclut le code source Flutter de CCB Mobile dans [`mobile/`](../mobile/) et publie l'APK Android via GitHub Releases :
 
-- [Télécharger l'APK CCB Mobile v8.2.1](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [Télécharger l'APK CCB Mobile v8.3.1](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - Source de l'app : [`mobile/app`](../mobile/app)
 - Source du gateway serveur : [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ Merci à [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) pou
 ## Notes de version
 
 <details open>
+<summary><b>v8.3.1</b> - Mises à jour provider unifiées, retrait sûr des caches et accès Config UI persistant</summary>
+
+- Centralise les mises à niveau provider prises en charge dans `ccb update`, avec vérification exacte, refus et saut limité à une version, sans redémarrer les panes actifs.
+- Retire les caches logiciels Claude/Gemini par projet et ne nettoie que les données historiques dont CCB peut prouver la propriété ; projets actifs, sessions et authentification sont préservés.
+- Autorise un port loopback stable et une source de token protégée pour Config UI sans afficher la valeur du token.
+- Préserve les finalizers de shutdown pendant l'arrêt du serveur et adopte une vue Yazi compacte à deux colonnes en Rich mode.
+- Synchronise CLI, npm, Linux, macOS, Android et tous les artefacts de release avec 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Tours provider exacts, intégrité des jobs et terminal Mobile lié au projet</summary>
+
+- Lie Kimi, Claude et Qoder à leurs contrats natifs de tour, d'activation, de session et d'achèvement.
+- Ajoute les follow-ups du job actif exact, les phases d'exécution corrélées, le diagnostic des inbounds orphelins et l'annulation terminale.
+- Hérite des extensions provider et des plugins Copilot avec une protection explicite de l'ownership des assets projetés.
+- Délègue les mises à niveau gérées par npm à npm et retire prudemment les worktrees ne contenant que des marqueurs.
+- Maintient le chat et le terminal Mobile dans le workspace du projet sélectionné et synchronise toutes les surfaces de release avec 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Démarrage déterministe, récupération d'authentification explicite et connexion Android en arrière-plan</summary>
 
 - Ajoute des barrières de génération de démarrage, une preuve de disponibilité bornée et des diagnostics chronologiques.

package/README/ja.md

@@ -6,7 +6,7 @@
 **Codex、Claude、Gemini などの CLI Agent を、見える・制御できる・直接引き継げるワークフローで連携**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## インストール方法
 
-npm でのインストールまたは更新を推奨します。
+npm 管理の CCB は npm でインストールまたは更新します。
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-インストール後は CCB の updater を使います。
+GitHub release パッケージまたはソースからのインストールでは、CCB のトランザクション updater を使います。
 
 ```bash
 ccb update
 ```
 
+npm 管理のインストールでは、`ccb update` は同等の npm コマンドを表示するだけで、vendored payload を直接変更しません。
+
 <details>
 <summary><b>GitHub release パッケージとソースインストールのフォールバック</b></summary>
 
@@ -180,9 +182,9 @@ ccb update mobile
 <details>
 <summary><b>Mobile App の詳細、安全境界、ソース</b></summary>
 
-CCB 8.2.1 では Flutter 版 CCB Mobile のソースが [`mobile/`](../mobile/) に含まれ、Android APK は GitHub Releases で公開されています。
+CCB 8.3.1 では Flutter 版 CCB Mobile のソースが [`mobile/`](../mobile/) に含まれ、Android APK は GitHub Releases で公開されています。
 
-- [CCB Mobile v8.2.1 APK をダウンロード](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [CCB Mobile v8.3.1 APK をダウンロード](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - App ソース：[`mobile/app`](../mobile/app)
 - サーバー gateway ソース：[`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ sidebar のアイデアと示唆を提供してくれた [tmux-agent-sidebar](ht
 ## リリースノート
 
 <details open>
+<summary><b>v8.3.1</b> - Provider 更新の一元化、安全なキャッシュ廃止、永続的な Config UI アクセス</summary>
+
+- 対応する Provider の更新を `ccb update` に集約し、正確なバージョン確認、辞退、バージョン単位のスキップを提供します。実行中の pane は自動再起動しません。
+- プロジェクト単位の Claude/Gemini ソフトウェアキャッシュを廃止し、所有権を検証できる旧データだけを削除します。稼働中のプロジェクト、session、認証情報は保持します。
+- token 値を表示せずに、Config UI の固定 loopback ポートと保護された token ソースを設定できます。
+- サーバー停止中も shutdown finalizer を維持し、Rich mode の Yazi をコンパクトな 2 カラム構成にしました。
+- CLI、npm、Linux、macOS、Android とすべてのリリース成果物を 8.3.1 に同期しました。
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - 正確な provider turn、job の整合性、プロジェクト内 Mobile ターミナル</summary>
+
+- Kimi、Claude、Qoder をそれぞれのネイティブな turn、activation、session、completion 契約に結び付けました。
+- 正確な active job への follow-up、相関した実行フェーズ、孤立 inbound の診断、終端 cancellation 結果を追加しました。
+- provider 拡張と Copilot plugin を、投影 asset の明示的な ownership 保護付きで継承します。
+- npm 管理インストールの更新を npm に委譲し、marker-only worktree を保守的に廃止します。
+- Mobile の chat と terminal を選択中の project workspace 内に保ち、すべての release surface を 8.3.0 に同期しました。
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - 決定的な起動、操作可能な認証復旧、Android バックグラウンド接続</summary>
 
 - 起動世代フェンス、有限の readiness 証明、操作数とタイムラインの診断を追加しました。

package/README/ko.md

@@ -6,7 +6,7 @@
 **Codex, Claude, Gemini 등 CLI Agent를 보이고 제어 가능하며 직접 이어받을 수 있는 워크플로로 조율**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## 설치 방법
 
-npm으로 설치하거나 업데이트합니다.
+npm이 관리하는 CCB는 npm으로 설치하거나 업데이트합니다.
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-CCB 설치 후에는 내장 updater를 사용합니다.
+GitHub release 패키지 또는 소스 설치에는 CCB의 트랜잭션 updater를 사용합니다.
 
 ```bash
 ccb update
 ```
 
+npm 관리 설치에서 `ccb update`는 동일한 npm 명령만 표시하며 vendored payload를 직접 변경하지 않습니다.
+
 <details>
 <summary><b>GitHub release 패키지와 소스 설치 대체 경로</b></summary>
 
@@ -180,9 +182,9 @@ ccb update mobile
 <details>
 <summary><b>Mobile App 세부 정보, 안전 경계, 소스</b></summary>
 
-CCB 8.2.1은 Flutter CCB Mobile 소스를 [`mobile/`](../mobile/)에 포함하며 Android APK를 GitHub Releases로 배포합니다.
+CCB 8.3.1은 Flutter CCB Mobile 소스를 [`mobile/`](../mobile/)에 포함하며 Android APK를 GitHub Releases로 배포합니다.
 
-- [CCB Mobile v8.2.1 APK 다운로드](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [CCB Mobile v8.3.1 APK 다운로드](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - 앱 소스: [`mobile/app`](../mobile/app)
 - 서버 gateway 소스: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ sidebar 아이디어와 영감을 준 [tmux-agent-sidebar](https://github.com/hi
 ## 릴리스 노트
 
 <details open>
+<summary><b>v8.3.1</b> - Provider 업데이트 통합, 안전한 캐시 폐기, 지속 가능한 Config UI 접근</summary>
+
+- 지원되는 Provider 업그레이드를 `ccb update`로 통합하고 정확한 버전 확인, 거절, 버전별 건너뛰기를 제공합니다. 활성 pane은 자동으로 재시작하지 않습니다.
+- 프로젝트별 Claude/Gemini 소프트웨어 캐시를 폐기하고 소유권이 검증된 레거시 데이터만 정리합니다. 활성 프로젝트, session, 인증 데이터는 보존합니다.
+- token 값을 노출하지 않으면서 Config UI의 고정 loopback 포트와 보호된 token 소스를 설정할 수 있습니다.
+- 서버가 중지되는 동안 shutdown finalizer를 유지하고 Rich mode의 Yazi를 간결한 2열 레이아웃으로 변경했습니다.
+- CLI, npm, Linux, macOS, Android와 모든 릴리스 산출물을 8.3.1로 동기화했습니다.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - 정확한 provider turn, job 무결성, 프로젝트 내부 Mobile 터미널</summary>
+
+- Kimi, Claude, Qoder 실행을 각각의 네이티브 turn, activation, session, completion 계약에 바인딩했습니다.
+- 정확한 active job follow-up, 연계된 실행 단계, 고아 inbound 진단, 종결 cancellation 결과를 추가했습니다.
+- provider 확장과 Copilot plugin을 투영 asset의 명시적 ownership 보호와 함께 상속합니다.
+- npm-managed 설치의 업그레이드를 npm에 위임하고 marker-only worktree를 보수적으로 정리합니다.
+- Mobile chat과 terminal을 선택한 project workspace 안에 유지하고 모든 release surface를 8.3.0으로 동기화했습니다.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - 결정적 시작, 실행 가능한 인증 복구, Android 백그라운드 연결</summary>
 
 - 시작 세대 펜스, 제한된 준비 상태 증명, 작업 수와 타임라인 진단을 추가했습니다.

package/README/pt.md

@@ -6,7 +6,7 @@
 **Coordene Codex, Claude, Gemini e outros agentes CLI em fluxos visíveis e controláveis que você pode assumir diretamente**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## Como instalar
 
-Instale ou atualize com npm:
+Instale ou atualize uma instalação gerenciada pelo npm com npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-Depois de instalar o CCB, use o updater integrado:
+Para instalações via GitHub release ou fonte, use o updater transacional do CCB:
 
 ```bash
 ccb update
 ```
 
+Em uma instalação gerenciada pelo npm, `ccb update` mostra o comando npm equivalente sem modificar o payload incluído.
+
 <details>
 <summary><b>Pacote GitHub release e instalação por fonte como fallback</b></summary>
 
@@ -180,9 +182,9 @@ Esse comando orienta a instalação e a configuração.
 <details>
 <summary><b>Detalhes do Mobile App, limite de segurança e fonte</b></summary>
 
-O CCB 8.2.1 inclui o código Flutter do CCB Mobile em [`mobile/`](../mobile/) e publica o APK Android pelo GitHub Releases:
+O CCB 8.3.1 inclui o código Flutter do CCB Mobile em [`mobile/`](../mobile/) e publica o APK Android pelo GitHub Releases:
 
-- [Baixar CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [Baixar CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - Fonte do app: [`mobile/app`](../mobile/app)
 - Fonte do gateway servidor: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ Obrigado ao [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar)
 ## Notas de versão
 
 <details open>
+<summary><b>v8.3.1</b> - Atualizações de providers unificadas, retirada segura de caches e acesso persistente à Config UI</summary>
+
+- Centraliza upgrades de providers suportados em `ccb update`, com verificação exata, recusa e salto por versão, sem reiniciar panes ativos.
+- Retira caches de software Claude/Gemini por projeto e limpa apenas dados legados com propriedade comprovada; projetos ativos, sessões e autenticação são preservados.
+- Permite uma porta loopback estável e uma fonte de token protegida para a Config UI sem exibir o valor do token.
+- Preserva finalizadores de shutdown durante a parada do servidor e adota um layout Yazi compacto de duas colunas no Rich mode.
+- Sincroniza CLI, npm, Linux, macOS, Android e todos os artefatos de release com 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Turnos exatos dos providers, integridade dos jobs e terminal Mobile dentro do projeto</summary>
+
+- Vincula Kimi, Claude e Qoder aos contratos nativos de turno, ativação, sessão e conclusão.
+- Adiciona follow-ups para o job ativo exato, fases de execução correlacionadas, diagnóstico de inbounds órfãos e cancelamento terminal.
+- Herda extensões de providers e plugins do Copilot com proteção explícita de ownership dos assets projetados.
+- Delega upgrades gerenciados por npm ao próprio npm e torna conservadora a remoção de worktrees que contêm apenas marcadores.
+- Mantém chat e terminal Mobile no workspace do projeto selecionado e sincroniza todas as superfícies de release com 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Inicialização determinística, recuperação de autenticação acionável e conexão Android em segundo plano</summary>
 
 - Adiciona cercas de geração de inicialização, prova limitada de prontidão e diagnósticos de operações e linha do tempo.

package/README/ru.md

@@ -6,7 +6,7 @@
 **Координируйте Codex, Claude, Gemini и другие CLI Agent в видимых и управляемых процессах, которые можно напрямую взять под контроль**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,20 @@
 
 ## Как установить
 
-Установите или обновите через npm:
+Устанавливайте или обновляйте управляемую npm установку через npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-После установки CCB используйте встроенный updater:
+Для установки из GitHub release или исходников используйте транзакционный updater CCB:
 
 ```bash
 ccb update
 ```
 
+В установке под управлением npm команда `ccb update` выводит эквивалентную npm-команду и не изменяет vendored payload.
+
 <details>
 <summary><b>GitHub release package и установка из исходников как fallback</b></summary>
 
@@ -180,9 +182,9 @@ ccb update mobile
 <details>
 <summary><b>Детали Mobile App, граница безопасности и исходники</b></summary>
 
-CCB 8.2.1 включает Flutter source CCB Mobile в [`mobile/`](../mobile/) и публикует Android APK через GitHub Releases:
+CCB 8.3.1 включает Flutter source CCB Mobile в [`mobile/`](../mobile/) и публикует Android APK через GitHub Releases:
 
-- [Скачать CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [Скачать CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - Исходники app: [`mobile/app`](../mobile/app)
 - Исходники server gateway: [`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -261,6 +263,28 @@ CCB поддерживает [Agent Roles Spec](https://github.com/SeemSeam/agen
 ## Release Notes
 
 <details open>
+<summary><b>v8.3.1</b> - Единое обновление providers, безопасный вывод кешей и постоянный доступ к Config UI</summary>
+
+- Объединяет поддерживаемые обновления providers в `ccb update`: точная проверка версии, отказ и пропуск конкретной версии без перезапуска активных panes.
+- Выводит из эксплуатации проектные кеши Claude/Gemini и удаляет только подтверждённые CCB legacy-данные; активные проекты, sessions и данные аутентификации сохраняются.
+- Позволяет задать стабильный loopback-порт и защищённый источник token для Config UI без вывода значения token.
+- Сохраняет shutdown finalizers во время остановки сервера и использует компактный двухколоночный Yazi layout в Rich mode.
+- Синхронизирует CLI, npm, Linux, macOS, Android и все release-артефакты с 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Точные provider-turn, целостность jobs и Mobile-терминал внутри проекта</summary>
+
+- Kimi, Claude и Qoder привязаны к своим нативным контрактам turn, активации, сессии и завершения.
+- Добавлены follow-up для точного active job, коррелированные фазы выполнения, диагностика потерянных inbound и терминальный результат отмены.
+- Расширения providers и плагины Copilot наследуются с явной защитой ownership проецируемых assets.
+- Обновления npm-managed установок переданы npm, а worktree только с маркерами удаляются консервативно.
+- Чат и терминал Mobile остаются в workspace выбранного проекта; все release-поверхности синхронизированы с 8.3.0.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Детерминированный запуск, понятное восстановление авторизации и фоновое подключение Android</summary>
 
 - Добавлены ограждение поколений запуска, ограниченная проверка готовности и диагностика операций и временной шкалы.

package/README/zh.md

@@ -6,7 +6,7 @@
 **让 Codex、Claude、Gemini 等 CLI Agent 可见、可控、可接管地协同工作**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,35 @@
 
 ## 如何安装
 
-推荐使用 npm 安装或更新：
+通过 npm 管理的 CCB 应继续使用 npm 安装或更新：
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-安装完成后，后续更新直接使用 CCB 自带 updater：
+通过 GitHub release 包或源码安装时，使用 CCB 自带的事务 updater：
 
 ```bash
 ccb update
 ```
 
+在 npm 管理的安装中，`ccb update` 只会显示等价的 npm 命令，不会原地修改 npm vendored payload。
+
+CCB 托管的 provider pane 会关闭已知的 provider 原生启动更新提示。更新 CCB
+后，或者 CCB 已经是最新版时，`ccb update` 会统一检查已安装的 provider
+CLI，并只提示一次可安全管理的更新。可使用 `--providers check`、
+`--providers all` 或 `--providers none` 分别执行仅检查、非交互全部更新或
+本次跳过。选择“暂不更新”后，下次 `ccb update` 会再次提示；选择“跳过此
+版本”只会静默当前检测到的准确版本。该流程不会自动重启正在运行的
+provider pane；已接受的新版本会在 pane 下次启动或显式重启后生效。
+
+版本发生更新后，新安装的 CCB 还会迁移旧的项目级 Claude/Gemini 缓存：
+manifest 校验通过且项目已经删除的缓存会立即清理；当前项目已经停止时会
+立即清理，仍在运行或属于其他现存项目的缓存会保留到对应项目下一次成功
+执行 `ccb kill` 后再清理。未知 Provider、损坏的 manifest、外来符号链接、
+session/auth 和用户级 Gemini 缓存都不会被该迁移删除。单次更新可用
+`ccb update --no-cache-cleanup` 跳过。
+
 <details>
 <summary><b>GitHub release 包和源码安装兜底</b></summary>
 
@@ -115,6 +132,20 @@ mkdir -p .ccb
 
 点击 CCB sidebar 左上角的 **⚙ 设置** 图标即可打开本地配置控制面；也可以在项目目录运行 `ccb config ui`。
 
+#### 固化本地 Config UI 访问
+
+Config UI 始终只绑定 loopback。若需要固定本地端口和 token，请在 `.ccb/ccb.config` 中配置 token 的**来源**，不要将 token 明文写入该文件：
+
+```toml
+[config_ui]
+port = 43123
+token_env = "CCB_CONFIG_UI_TOKEN"
+# 或使用下面这一项替代 token_env：
+# token_file = ".ccb/config-ui.token"
+```
+
+`--port` 仍可覆盖单次启动端口。`token_file` 必须是项目内相对路径、不能是符号链接，并且在 POSIX 上应仅允许文件所有者读取（`chmod 600 .ccb/config-ui.token`）。未配置 token 来源时，CCB 保持原有的随机 token 与临时端口行为。CLI 只输出 loopback URL 和 token 来源，不会输出 token 值。
+
 <p align="center">
   <img src="../assets/readme_v7/config-control-panel.png" alt="CCB 配置控制面正在编辑默认 demo agent" width="960">
 </p>
@@ -180,9 +211,9 @@ ccb update mobile
 <details>
 <summary><b>Mobile App 详情、安全边界和源码</b></summary>
 
-CCB 8.2.1 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](../mobile/)，并在 GitHub Release 中发布 Android APK：
+CCB 8.3.1 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](../mobile/)，并在 GitHub Release 中发布 Android APK：
 
-- [下载 CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [下载 CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - App 源码：[`mobile/app`](../mobile/app)
 - 服务端 gateway 源码：[`lib/mobile_gateway`](../lib/mobile_gateway)
 
@@ -266,6 +297,31 @@ CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：
 ## 新版本记录
 
 <details open>
+<summary><b>v8.3.1</b> - 统一 Provider 更新、安全回收缓存与持久化 Config UI 访问</summary>
+
+- 将受支持的 Provider 升级统一到 `ccb update`，提供准确版本检查、暂不更新和精确版本跳过，并且不会自动重启运行中的 pane。
+- 废弃项目级 Claude/Gemini 软件缓存，改用用户安装的 Claude 可执行文件和一份用户级 Gemini 缓存。
+- 增加有边界的更新后与关闭后清理，保留运行中的项目、未知内容、session、认证数据和用户自有缓存。
+- 支持固化 Config UI 的 loopback 端口与受保护的 token 来源，同时不暴露 token 值。
+- 新增原生 Qoder CLI CN 支持，隔离配置与 session 状态，并修正 Qoder 的 `--print` / `--config-dir` 执行协议。
+- 在服务停止阶段继续可靠执行 shutdown finalizer，并让 sidebar 发布校验和生成兼容不同主机。
+- 将 Rich 模式切换为紧凑的 Yazi 双栏布局，并把所有发布面同步到 8.3.1。
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - 精确 Provider 回合、作业完整性与项目内 Mobile 终端</summary>
+
+- 将 Kimi、Claude 和 Qoder 执行绑定到各自原生的回合、激活、会话和完成协议。
+- 增加精确 active job follow-up、关联执行阶段、孤立 inbound 诊断和终态取消结果。
+- 以明确的投影资源所有权保护继承 Provider 扩展与 Copilot 插件。
+- 将 npm 管理安装的升级交还 npm，并保守回收仅含标记的 worktree。
+- 让 Mobile 的聊天和终端模式留在所选项目工作区，并将所有发布面统一到 8.3.0。
+- 修复 WSL 与 macOS 上 sidebar 设置按钮无响应的问题：优先使用原生浏览器打开方式、刷新桌面会话环境，并在自动打开失败时明确提示手动打开。
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - 确定性启动、可操作的认证恢复与 Android 后台连接</summary>
 
 - 增加端到端启动代际栅栏、有限就绪证明，以及启动操作量和时间线诊断。

package/README.md

@@ -6,7 +6,7 @@
 **Coordinate Codex, Claude, Gemini, and other CLI agents in visible, controllable workflows you can take over**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.2.1-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.3.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -54,18 +54,38 @@
 
 ## How to Install
 
-Install or update with npm:
+Install or update an npm-managed CCB with npm:
 
 ```bash
-npm install -g @seemseam/ccb
+npm install -g @seemseam/ccb@latest
 ```
 
-After CCB is installed, use CCB's updater:
+For GitHub release-package or source installs, use CCB's transactional updater:
 
 ```bash
 ccb update
 ```
 
+On an npm-managed install, `ccb update` prints the equivalent npm command and
+does not modify npm's vendored payload in place.
+
+CCB-managed provider panes suppress known provider-native startup update prompts.
+After updating CCB—or immediately when CCB is already current—`ccb update`
+checks installed provider CLIs and offers supported updates once. Use
+`--providers check`, `--providers all`, or `--providers none` for explicit
+report-only, non-interactive update, or skip behavior. Declining prompts again
+on the next `ccb update`; skipping a version hides only that exact version.
+CCB never restarts active provider panes during this flow, so an accepted
+provider update applies when that pane next starts or is explicitly restarted.
+
+After a release change, the newly installed CCB also retires old
+project-scoped Claude/Gemini caches. Manifest-valid caches for deleted projects
+are removed immediately. A stopped current project is cleaned immediately;
+active or other existing projects are preserved and cleaned after their next
+successful `ccb kill`. Unknown providers, malformed manifests, foreign
+symlinks, sessions/auth, and the user-scoped Gemini cache are never removed by
+this migration. Use `ccb update --no-cache-cleanup` to skip it for one update.
+
 To roll back, use the same transactional updater with an older released version,
 for example `ccb update 8.1.3`. CCB rejects a same-version artifact whose build
 identity differs from the installed build, and restores the prior local prefix
@@ -121,6 +141,20 @@ A blank project starts light: CCB opens one `main` window with a single agent na
 
 Click the **⚙ Settings** icon at the top-left of the CCB sidebar to open the local configuration control panel. You can also run `ccb config ui` from the project directory.
 
+#### Persistent local Config UI access
+
+The Config UI always binds to loopback. To use a stable local port and token, configure a token **source** in `.ccb/ccb.config`; never put a literal token in that file:
+
+```toml
+[config_ui]
+port = 43123
+token_env = "CCB_CONFIG_UI_TOKEN"
+# Or use this instead of token_env:
+# token_file = ".ccb/config-ui.token"
+```
+
+`--port` remains a one-run override. `token_file` must be project-relative, non-symlinked, and owner-only (`chmod 600 .ccb/config-ui.token` on POSIX). Without a token source, CCB keeps the existing random token and ephemeral-port behavior. The CLI prints only the loopback URL and token source, never the token value.
+
 <p align="center">
   <img src="assets/readme_v7/config-control-panel.png" alt="CCB configuration control panel editing the default demo agent" width="960">
 </p>
@@ -186,9 +220,9 @@ This command guides installation and configuration.
 <details>
 <summary><b>Mobile App details, safety boundary, and source</b></summary>
 
-CCB 8.2.1 includes the Flutter CCB Mobile source in [`mobile/`](mobile/) and publishes the Android APK through GitHub Releases:
+CCB 8.3.1 includes the Flutter CCB Mobile source in [`mobile/`](mobile/) and publishes the Android APK through GitHub Releases:
 
-- [Download CCB Mobile v8.2.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.2.1/ccb-mobile-v8.2.1.apk)
+- [Download CCB Mobile v8.3.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.3.1/ccb-mobile-v8.3.1.apk)
 - App source: [`mobile/app`](mobile/app)
 - Server gateway source: [`lib/mobile_gateway`](lib/mobile_gateway)
 
@@ -272,6 +306,31 @@ Thanks to [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) fo
 ## Release Notes
 
 <details open>
+<summary><b>v8.3.1</b> - Unified Provider updates, safe cache retirement, and persistent Config UI access</summary>
+
+- Centralized supported Provider upgrades under `ccb update`, with exact version checks, explicit decline/skip choices, and no automatic restart of active panes.
+- Retired project-scoped Claude/Gemini software caches in favor of the user-installed Claude executable and one user-scoped Gemini cache.
+- Added bounded post-update and post-shutdown cleanup that preserves active projects, unknown content, sessions, authentication data, and user-owned caches.
+- Added persistent Config UI loopback port and protected token-source settings without exposing token values.
+- Added native Qoder CLI CN support with isolated config/session state and corrected Qoder `--print` / `--config-dir` execution.
+- Preserved shutdown finalizers while the server is stopping and made sidebar release checksum generation portable.
+- Switched Rich mode to a compact two-column Yazi layout and synchronized all release surfaces to 8.3.1.
+
+</details>
+
+<details>
+<summary><b>v8.3.0</b> - Exact provider turns, job integrity, and project-bound Mobile terminal</summary>
+
+- Bound Kimi, Claude, and Qoder execution to their native turn, activation, session, and completion contracts.
+- Added exact active-job follow-ups, correlated execution phases, orphaned-inbound diagnosis, and terminal cancellation outcomes.
+- Inherited provider extensions and Copilot plugins with explicit projected-asset ownership safeguards.
+- Delegated npm-managed upgrades to npm and made marker-only worktree retirement conservative.
+- Kept Mobile chat and terminal modes inside the selected project workspace and synchronized all release surfaces to 8.3.0.
+- Fixed sidebar settings launch on WSL and macOS with native browser fallbacks, refreshed desktop-session environment, and visible manual-open status.
+
+</details>
+
+<details>
 <summary><b>v8.2.1</b> - Deterministic startup, actionable auth recovery, and Android background access</summary>
 
 - Added end-to-end startup generation fencing, bounded readiness proof, and detailed startup operation/timeline diagnostics.

package/VERSION

@@ -1 +1 @@
-8.2.1
+8.3.1

package/bin/ccb-npm-runner.js

@@ -2,13 +2,27 @@
 
 const childProcess = require("child_process");
 const { executablePath, install } = require("./ccb-npm-install");
+const path = require("path");
+
+const packageRoot = path.resolve(__dirname, "..");
+const manifest = require(path.join(packageRoot, "package.json"));
+
+function npmManagedEnvironment(baseEnv = process.env) {
+  return {
+    ...baseEnv,
+    CCB_INSTALL_KIND: "npm",
+    CCB_NPM_PACKAGE_NAME: manifest.name,
+    CCB_NPM_PACKAGE_ROOT: packageRoot,
+    CCB_NPM_PACKAGE_VERSION: manifest.version,
+  };
+}
 
 async function run(command) {
   await install();
   const target = executablePath(command);
   const child = childProcess.spawn(target, process.argv.slice(2), {
     stdio: "inherit",
-    env: process.env,
+    env: npmManagedEnvironment(),
   });
   child.on("error", (error) => {
     console.error(error.message || error);
@@ -24,5 +38,6 @@ async function run(command) {
 }
 
 module.exports = {
+  npmManagedEnvironment,
   run,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "8.2.1",
+  "version": "8.3.1",
   "description": "Lightweight multi-agent TUI and stable cross-provider collaboration layer for Codex, Claude, Gemini, Grok, Kimi, DeepSeek, and other CLI agents.",
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",