Release v6.3.0 native sidebar control

Author: SeemSeam

.github/workflows/release-sidebar.yml

@@ -0,0 +1,47 @@
+name: Release Sidebar Helper
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  linux-x86_64:
+    name: Linux x86_64 sidebar helper
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Test sidebar crate
+        run: cargo test --manifest-path tools/ccb-agent-sidebar/Cargo.toml
+
+      - name: Build release sidebar helper
+        run: bin/build-ccb-agent-sidebar
+
+      - name: Stage artifact
+        run: bin/package-ccb-agent-sidebar-release
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ccb-agent-sidebar-linux-x86_64
+          path: |
+            dist/ccb-agent-sidebar-linux-x86_64.tar.gz
+            dist/ccb-agent-sidebar-linux-x86_64.tar.gz.sha256
+
+      - name: Attach to GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/ccb-agent-sidebar-linux-x86_64.tar.gz
+            dist/ccb-agent-sidebar-linux-x86_64.tar.gz.sha256

.github/workflows/test.yml

@@ -82,6 +82,23 @@ jobs:
           export TERM=xterm-256color
           python -m pytest -q -m provider_blackbox test/test_v2_phase2_entrypoint.py
 
+  rust-sidebar:
+    name: Rust sidebar
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Run sidebar tests
+        run: cargo test --manifest-path tools/ccb-agent-sidebar/Cargo.toml
+
+      - name: Build sidebar binary
+        run: bin/build-ccb-agent-sidebar
+
   macos-install-smoke:
     name: macOS install smoke
     runs-on: macos-latest

.gitignore

@@ -1,5 +1,6 @@
 __pycache__/
 *.pyc
+target/
 .venv/
 .pytest_cache/
 .architec/

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+## v6.3.0 (2026-05-22)
+
+### Native Sidebar Control Release
+
+- **Native CCB Sidebar Added**: adds a Rust `ccb-agent-sidebar` helper with per-window project view, fixed gray sidebar identity, colored agent status symbols, mouse/keyboard focus switching, and release packaging hooks.
+- **Project Topology Added**: `.ccb/ccb.config` now supports window/sidebar topology while preserving the default three-agent `main` window layout when no project config is present.
+- **Comms Recovery Added**: the sidebar and ccbd now expose comms retry, cancel, and clear flows through ccbd-owned RPCs with project-view recoverability metadata and shared dismissed-row state.
+- **Window-Aware Runtime Metadata Added**: runtime attach, startup results, `ps`, project view, and tmux identity now carry window names/ids so focus and sidebar state remain stable across tmux windows.
+- **Reset History Inheritance Added**: `ccb -n` now clears runtime/mail/pane residue while preserving `.ccb/ccb.config`, project memory, and same-name managed provider-state/session history.
+
 ## v6.2.9 (2026-05-22)
 
 ### Callback Visibility And Diagnostics 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.2.9-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.3.0-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 **English** | [Chinese](README_zh.md)
@@ -89,7 +89,7 @@ See [Release Notes](#release-notes) for the full history.
 ```bash
 ccb                              # Start default agents from .ccb/ccb.config
 ccb -s                           # Safe start: keep configured/manual permission behavior
-ccb -n                           # Rebuild .ccb except ccb.config, then start fresh
+ccb -n                           # Rebuild runtime state; keep config and managed agent history
 ccb kill                         # Stop this project's background runtime
 ccb kill -f                      # Force cleanup before rebuilding state
 ```
@@ -338,6 +338,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.3.0</b> - Native Sidebar Control Release</summary>
+
+- Adds the native Rust `ccb-agent-sidebar` helper with per-window project view, fixed gray sidebar identity, colored agent status symbols, and mouse/keyboard focus switching.
+- Adds window/sidebar topology support while keeping the default no-config layout as one `main` window with `agent1`, `agent2`, and `agent3`.
+- Adds comms retry, cancel, and clear actions through ccbd-owned RPCs, with recoverability metadata in `project_view`.
+- Carries tmux window names and ids through runtime attach, startup results, `ps`, project view, and pane identity for stable cross-window focus.
+
+</details>
+
+<details>
 <summary><b>v6.2.9</b> - Callback Visibility And Diagnostics Release</summary>
 
 - Shows `callback_pending` for delegated callback root jobs while the child chain is still running, then resolves `ask get` and `watch` to the final message-bureau reply after continuation.
@@ -927,7 +937,7 @@ Historical note: older release notes below may mention `askd`, legacy flags, or
 - **Safe Agent Churn**: Adding agents no longer disturbs existing worktrees; removing or renaming worktree agents retires clean branches and blocks on dirty or unmerged ones
 
 **🛠 Recovery & Reset Hardening:**
-- **Config-Preserving Reset**: `ccb -n` rebuilds project runtime state while keeping `.ccb/ccb.config`
+- **History-Preserving Reset**: `ccb -n` rebuilds project runtime state while keeping `.ccb/ccb.config`, project memory, and same-name managed agent history
 - **Stale Registration Cleanup**: Start and reset now prune missing registered git worktrees before rematerialization
 - **Kill Warnings**: `ccb kill` warns clearly when a worktree agent still has unmerged or dirty state
 

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.2.9-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.3.0-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 [English](README.md) | **中文**
@@ -89,7 +89,7 @@
 ```bash
 ccb                    # 按 .ccb/ccb.config 启动默认 agent
 ccb -s                 # 安全启动：保留 agent 自身配置的权限策略
-ccb -n                 # 重建 .ccb（保留 ccb.config），再重新启动
+ccb -n                 # 重建运行态，保留配置和同名 managed agent 历史
 ccb kill               # 停止当前项目相关后台
 ccb kill -f            # 强制清理项目残留后再配合 ccb -n 使用
 ```
@@ -329,6 +329,16 @@ ccb reinstall
 历史说明：下面较旧的发布记录里仍可能出现 `askd`、旧 flag 或已移除命令。这些内容仅作为 changelog 历史保留，不代表当前 CLI 入口。
 
 <details open>
+<summary><b>v6.3.0</b> - Native Sidebar Control Release</summary>
+
+- 新增 Rust `ccb-agent-sidebar` 原生侧边栏 helper，支持每个 window 的 project view、固定灰色侧边栏身份、彩色 agent 状态符号，以及鼠标/键盘 focus 切换。
+- 新增 window/sidebar topology 支持，同时保留无配置时默认一个 `main` window，包含 `agent1`、`agent2`、`agent3`。
+- 新增 comms retry、cancel、clear 操作，统一通过 ccbd RPC 执行，并在 `project_view` 中提供可恢复状态元数据。
+- runtime attach、startup results、`ps`、project view、pane identity 现在携带 tmux window name/id，让跨 window focus 更稳定。
+
+</details>
+
+<details>
 <summary><b>v6.2.9</b> - Callback Visibility And Diagnostics Release</summary>
 
 - 委派式 callback root job 在子链路运行期间显示 `callback_pending`，continuation 完成后 `ask get` 和 `watch` 会解析到最终 message-bureau reply。
@@ -918,7 +928,7 @@ ccb reinstall
 - **Agent 变更更稳**：新增 agent 不再影响已有 worktree；删除或改名 worktree agent 时，干净分支会自动退休，脏分支或未合并分支会阻断并提醒
 
 **🛠 重建与恢复加固：**
-- **保留配置重建**：`ccb -n` 会重建项目运行时状态，但保留 `.ccb/ccb.config`
+- **保留历史重建**：`ccb -n` 会重建项目运行时状态，但保留 `.ccb/ccb.config`、项目记忆和同名 managed agent 历史
 - **陈旧注册清理**：启动与重建前会先清理已注册但路径丢失的 git worktree
 - **Kill 提醒**：`ccb kill` 在发现 worktree agent 仍有未合并或脏状态时会显著提醒用户
 

VERSION

@@ -1 +1 @@
-6.2.9
+6.3.0

bin/build-ccb-agent-sidebar

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CRATE_DIR="$REPO_ROOT/tools/ccb-agent-sidebar"
+TARGET_BIN="$CRATE_DIR/target/release/ccb-agent-sidebar"
+OUT_BIN="$REPO_ROOT/bin/ccb-agent-sidebar"
+
+if [[ ! -f "$CRATE_DIR/Cargo.toml" ]]; then
+  echo "ERROR: missing $CRATE_DIR/Cargo.toml" >&2
+  exit 1
+fi
+
+if ! command -v cargo >/dev/null 2>&1; then
+  echo "ERROR: cargo is required to build ccb-agent-sidebar" >&2
+  exit 1
+fi
+
+cargo build --release --manifest-path "$CRATE_DIR/Cargo.toml"
+cp -f "$TARGET_BIN" "$OUT_BIN"
+chmod +x "$OUT_BIN"
+echo "Built $OUT_BIN"

bin/ccb-agent-sidebar

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# CCB_AGENT_SIDEBAR_WRAPPER
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TARGET_BIN="$REPO_ROOT/tools/ccb-agent-sidebar/target/release/ccb-agent-sidebar"
+
+if [[ -x "$TARGET_BIN" ]]; then
+  exec "$TARGET_BIN" "$@"
+fi
+
+printf '%s\n' 'CCB sidebar helper binary is not built.'
+printf '%s\n' 'Run: bin/build-ccb-agent-sidebar'
+while :; do sleep 3600; done

bin/package-ccb-agent-sidebar-release

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+ARTIFACT_NAME="${CCB_AGENT_SIDEBAR_ARTIFACT_NAME:-ccb-agent-sidebar-linux-x86_64}"
+SOURCE_BIN="$REPO_ROOT/bin/ccb-agent-sidebar"
+STAGE_DIR="$REPO_ROOT/dist/$ARTIFACT_NAME"
+OUT_TAR="$REPO_ROOT/dist/$ARTIFACT_NAME.tar.gz"
+OUT_SHA="$OUT_TAR.sha256"
+
+if [[ ! -x "$SOURCE_BIN" ]]; then
+  echo "ERROR: missing executable $SOURCE_BIN" >&2
+  exit 1
+fi
+
+rm -rf "$STAGE_DIR" "$OUT_TAR" "$OUT_SHA"
+mkdir -p "$STAGE_DIR/bin"
+cp -f "$SOURCE_BIN" "$STAGE_DIR/bin/ccb-agent-sidebar"
+chmod +x "$STAGE_DIR/bin/ccb-agent-sidebar"
+tar -C "$REPO_ROOT/dist" -czf "$OUT_TAR" "$ARTIFACT_NAME"
+sha256sum "$OUT_TAR" > "$OUT_SHA"
+echo "Packaged $OUT_TAR"
+echo "Checksum $OUT_SHA"