chore: release 6.1.20 claude active version

Author: SeemSeam

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## Unreleased
 
+## v6.1.20 (2026-05-16)
+
+### Claude Active Version Cache Release
+
+- **Managed Claude Follows Source Active Version**: when the source home uses the standard Claude Code layout, CCB now detects `~/.local/bin/claude -> ~/.local/share/claude/versions/<version>/claude` and makes managed Claude use that active version.
+- **Active Version Is Cached Safely**: the selected source-home Claude version is copied into the CCB provider cache, then managed `.local/bin/claude` points at the cached copy instead of selecting another version already present in shared cache.
+- **Fallback Behavior Preserved**: if the source active-version layout is unavailable, Claude binary routing keeps the previous shared-cache behavior.
+- **Provider Hook Routing Updated**: Claude provider workspace preparation now passes the source home into binary-cache routing so the active-version preference is applied during managed startup.
+
 ## v6.1.19 (2026-05-16)
 
 ### Managed Ask Skill Projection Release

README.md

@@ -7,7 +7,7 @@
   <img src="https://img.shields.io/badge/Every_Model_Controllable-CF1322?style=for-the-badge" alt="Every Model Controllable">
 </p>
 
-[![Version](https://img.shields.io/badge/version-6.1.19-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.1.20-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 **English** | [Chinese](README_zh.md)
@@ -74,10 +74,10 @@ Build project-local teams with roles, pane layout, provider state, worktree isol
 <details>
 <summary><b>Latest release highlights</b></summary>
 
-- **Managed ask skills inherit cleanly**: Claude skills/commands and Droid skills now route through CCB projected assets, matching Codex's inherited-skill model without copy-sync drift.
-- **Droid gets a managed FACTORY_HOME**: each managed Droid agent has a project-scoped Factory home and session root, so Droid session readers follow the managed session log after restart or rotation.
-- **Ask replies are concise by default**: `ccb ask` injects reply guidance, with `--compact` for distilled answers and `--silence` for silent-on-success checks.
-- **Provider storage diagnostics recognize the new projections**: projected Claude and Droid skill assets are classified as managed projected config rather than unknown residue.
+- **Managed Claude follows your active Claude Code version**: CCB now detects the source-home `~/.local/bin/claude` symlink and uses that active version inside managed Claude homes.
+- **Claude binaries are still cached safely**: the active source version is copied into the CCB provider cache, and managed `.local/bin/claude` points at the cached copy.
+- **Shared-cache fallback remains intact**: when the standard source-home active-version layout is missing, CCB keeps the existing shared-cache routing behavior.
+- **Startup routing applies the preference automatically**: Claude provider workspace preparation passes the source home into binary-cache routing during managed startup.
 
 See [Release Notes](#release-notes) for the full history.
 
@@ -306,6 +306,16 @@ Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and
 Historical note: older release notes below may mention `askd`, legacy flags, or removed commands. Those references are kept only as changelog history and do not redefine the current CLI surface.
 
 <details open>
+<summary><b>v6.1.20</b> - Claude Active Version Cache Release</summary>
+
+- Detects the source home's active Claude Code symlink under `~/.local/bin/claude` and prefers that version for managed Claude startup.
+- Copies the active source-home Claude version into the CCB provider cache, then points managed `.local/bin/claude` at the cached active version.
+- Preserves previous shared-cache fallback behavior when the source active-version layout is unavailable.
+- Updates provider workspace preparation and the Claude binary-cache contract to document the source-home active-version preference.
+
+</details>
+
+<details>
 <summary><b>v6.1.19</b> - Managed Ask Skill Projection Release</summary>
 
 - Routes inherited Claude `skills/` and `commands/` through CCB projected assets instead of copy-sync, so system-installed ask skills reach managed Claude agents without duplicating provider homes.

README_zh.md

@@ -7,7 +7,7 @@
   <img src="https://img.shields.io/badge/模型皆可控-CF1322?style=for-the-badge" alt="模型皆可控">
 </p>
 
-[![Version](https://img.shields.io/badge/version-6.1.19-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.1.20-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 [English](README.md) | **中文**
@@ -74,10 +74,10 @@
 <details>
 <summary><b>最新版本亮点</b></summary>
 
-- **Managed ask skill 会干净继承**：Claude skills/commands 和 Droid skills 都通过 CCB projected assets 投射，行为对齐 Codex，避免 copy-sync 漂移。
-- **Droid 获得 managed FACTORY_HOME**：每个 managed Droid agent 都有项目级 Factory home 和 session root，重启或 session rotation 后 reader 会继续跟随 managed session log。
-- **Ask 默认回复更简洁**：`ccb ask` 会注入回复指导，`--compact` 用于压缩回答，`--silence` 用于成功静默的检查任务。
-- **Storage 诊断识别新投射物**：Claude 和 Droid 的 projected skill assets 会被归类为 managed projected config，而不是 unknown residue。
+- **Managed Claude 会跟随系统当前 Claude Code 版本**：CCB 现在会识别 source home 的 `~/.local/bin/claude` symlink，并在 managed Claude home 中使用该 active version。
+- **Claude binary 仍通过缓存安全复用**：source active version 会复制到 CCB provider cache，managed `.local/bin/claude` 指向缓存副本。
+- **Shared-cache fallback 保持不变**：source active-version 布局不可用时，继续使用原有 shared-cache 路由行为。
+- **启动阶段自动应用该偏好**：Claude provider workspace prepare 会把 source home 传入 binary-cache routing。
 
 完整历史见 [新版本记录](#新版本记录)。
 
@@ -297,6 +297,16 @@ ccb reinstall
 历史说明：下面较旧的发布记录里仍可能出现 `askd`、旧 flag 或已移除命令。这些内容仅作为 changelog 历史保留，不代表当前 CLI 入口。
 
 <details open>
+<summary><b>v6.1.20</b> - Claude Active Version Cache Release</summary>
+
+- 识别 source home 下 `~/.local/bin/claude` 指向的 Claude Code active version，并优先用于 managed Claude 启动。
+- 将 source active version 复制进 CCB provider cache，再让 managed `.local/bin/claude` 指向缓存中的 active version。
+- source active-version 布局不可用时，保留原有 shared-cache fallback 行为。
+- 更新 provider workspace prepare 与 Claude binary-cache 契约，记录 source-home active-version 优先级。
+
+</details>
+
+<details>
 <summary><b>v6.1.19</b> - Managed Ask Skill Projection Release</summary>
 
 - Claude 继承的 `skills/` 和 `commands/` 改为通过 CCB projected assets 路由，不再 copy-sync，让系统 ask skill 可进入 managed Claude home。

VERSION

@@ -1 +1 @@
-6.1.19
+6.1.20

ccb

@@ -21,7 +21,7 @@ backend_env = get_backend_env()
 if backend_env and not os.environ.get("CCB_BACKEND_ENV"):
     os.environ["CCB_BACKEND_ENV"] = backend_env
 
-VERSION = "6.1.19"
+VERSION = "6.1.20"
 GIT_COMMIT = "release"
 GIT_DATE = "2026-05-11"