@seemseam/ccb 7.6.10 → 7.6.12

package/README.md

@@ -6,7 +6,7 @@
 **Visible, controllable multi-agent cooperative TUI workspace**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.6.10-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-7.6.12-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-15%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -45,21 +45,29 @@
 
 Mix CLIs per agent in `.ccb/ccb.config`; actual availability depends on the local CLI installation and account access.
 
-- Codex (`codex`)
-- Claude (`claude`)
-- Gemini (`gemini`)
-- Kimi (`kimi`)
-- MiMo (`mimo`)
-- Qwen (`qwen`)
-- Cursor (`cursor`)
-- GitHub Copilot CLI (`copilot`)
-- Crush (`crush`)
-- Kiro CLI (`kiro`)
-- Pi (`pi`)
-- Z.ai CLI (`zai`)
-- OpenCode (`opencode`)
-- Antigravity (`agy`)
-- Droid (`droid`)
+<table>
+  <tr>
+    <td>Codex<br><code>codex</code></td>
+    <td>Claude<br><code>claude</code></td>
+    <td>Gemini<br><code>gemini</code></td>
+    <td>Kimi<br><code>kimi</code></td>
+    <td>MiMo<br><code>mimo</code></td>
+  </tr>
+  <tr>
+    <td>Qwen<br><code>qwen</code></td>
+    <td>Cursor<br><code>cursor</code></td>
+    <td>GitHub Copilot CLI<br><code>copilot</code></td>
+    <td>Crush<br><code>crush</code></td>
+    <td>Kiro CLI<br><code>kiro</code></td>
+  </tr>
+  <tr>
+    <td>Pi<br><code>pi</code></td>
+    <td>Z.ai CLI<br><code>zai</code></td>
+    <td>OpenCode<br><code>opencode</code></td>
+    <td>Antigravity<br><code>agy</code></td>
+    <td>Droid<br><code>droid</code></td>
+  </tr>
+</table>
 
 **New role specification**: package skills, memory, and tool dependencies into self-contained Role Packs, then create hot-loadable and removable specialist agents.
 
@@ -190,16 +198,49 @@ Run `ccb update rich` to install the optional rich workbench; it bundles Yazi wh
   <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich workbench with Yazi preview in WezTerm" width="860">
 </p>
 
+### Agent Roles Spec And Role Catalog
+
+CCB supports the [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), a host-neutral way to package specialist agents as portable Role Packs. The same repository also acts as the public role catalog.
+
+<details>
+<summary><b>Available catalog roles</b></summary>
+
+| Role | Basic function |
+| :--- | :--- |
+| `agentroles.ccb_self` | CCB self-maintenance, config help, runtime diagnosis, guarded recovery, and workflow orchestration. |
+| `agentroles.archi` | Architecture review, boundary checks, coupling analysis, maintainability risk, and practical next-step gates. |
+| `agentroles.frontend_engineer` | Frontend design and implementation, design-system work, accessibility, browser QA, and reviewed AGY delegation. |
+| `agentroles.mobile_app_engineer` | Mobile app design and implementation across iOS, Android, React Native, Expo, Flutter, SwiftUI, and Jetpack Compose. |
+| `agentroles.mother` | Role creation, role-source audit, role research, blueprinting, and Agent Roles spec compliance review. |
+| `agentroles.su_ccb` | SU-CCB workflow operation for requirement analysis, planning, dispatch, review gates, archive, and recovery. |
+
+</details>
+
 ### Contact
 
 - Email: `bfly123@126.com`
 - WeChat: `seemseam-com`
 
+<p align="center">
+  <img src="assets/weixin.jpg" alt="WeChat group" width="240">
+</p>
+
 ---
 
 ## More Reading
 
-Start with Quick Start for first use; the sections below cover CCB's design boundaries, comparisons, daily operations, and configuration model.
+Start with Quick Start for first use. Open only the reference area you need.
+
+| Topic | When to open it |
+| :--- | :--- |
+| Concepts and positioning | What CCB is, why multi-agent workflows help, and how CCB compares with other approaches. |
+| Daily operation | Common commands and tmux basics for routine use. |
+| Configuration and roles | `.ccb/ccb.config`, Role Packs, and `ccb_self` configuration help. |
+| Collaboration and maintenance | Ask routes, install/update notes, FAQ, and credits. |
+| Release notes | Current v7 highlights and historical release entries. |
+
+<details open>
+<summary><b>Concepts and positioning</b></summary>
 
 ### What Is CCB?
 
@@ -264,6 +305,11 @@ CCB also supports complex workflows, but it is not an automatic DAG generator. Y
 
 </details>
 
+</details>
+
+<details>
+<summary><b>Daily operation</b></summary>
+
 ### Daily Operation
 
 | Goal | Command |
@@ -326,6 +372,11 @@ New users should avoid pane/window killing shortcuts at first. To stop a CCB pro
 
 </details>
 
+</details>
+
+<details>
+<summary><b>Configuration and roles</b></summary>
+
 ### Configure Your Agent Team
 
 CCB resolves config in three layers, from lowest to highest priority:
@@ -356,10 +407,19 @@ If you want to discuss the configuration before writing it by hand, ask `ccb_sel
 
 #### Role Packs
 
-Role Packs define reusable agent roles. A role can carry a stable identity,
-responsibilities, memory, provider-specific skills, tool hooks, and dependency
-setup. This keeps project config short and makes specialized agents reusable
-instead of copying long role instructions into every project.
+Role Packs define reusable agent roles through the
+[Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec). The spec is a
+host-neutral package format for specialist agents: a Role carries a stable
+identity, responsibilities, non-goals, memory, skills, prompts, references,
+tools, plugin content, validation notes, and host adapter metadata as one
+reviewable unit.
+
+The practical value is separation. Role source stays portable and versioned;
+project bindings decide where that Role is mounted; runtime provider state,
+credentials, task progress, and generated projection output stay outside the
+Role. That makes specialist agents easier to install, update, audit, migrate,
+and remove without copying long prompts into every project or mutating user
+global configuration.
 
 The recommended default catalog roles are `agentroles.ccb_self`, the CCB
 self-maintenance role, and `agentroles.archi`, an architecture reviewer role
@@ -369,6 +429,9 @@ refreshes installed roles and installs missing recommended roles in the user
 environment. You can also refresh manually:
 
 ```bash
+ccb roles list
+ccb roles show agentroles.archi
+ccb roles install agentroles.archi
 ccb roles update agentroles.ccb_self
 ccb roles update agentroles.archi
 ```
@@ -518,6 +581,11 @@ By default, `ccb-config` does not edit `.ccb/ccb_memory.md` or `.ccb/agents/<age
 
 </details>
 
+</details>
+
+<details>
+<summary><b>Collaboration and maintenance</b></summary>
+
 ### Agent Collaboration
 
 Normal `ask` is submit-and-return: after handing work to the target agent, the current agent should not poll and wait.
@@ -627,9 +695,10 @@ Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and
 
 Thanks to [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) for the sidebar ideas and inspiration.
 
-<div align="center">
-  <img src="assets/weixin.jpg" alt="WeChat group" width="300">
-</div>
+</details>
+
+<details>
+<summary><b>Release notes</b></summary>
 
 ### Release Notes
 
@@ -643,6 +712,36 @@ v7 highlights:
 - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
 
 <details open>
+<summary><b>v7.6.12</b> - Claude MCP And Hook Inheritance</summary>
+
+- Managed Claude agents now inherit Claude Code MCP configuration from the
+  source `.claude.json`, including global `mcpServers` and current
+  project/workspace MCP server state.
+- Project-level MCP state is mapped only onto the current managed workspace key,
+  so unrelated source project records are not copied into the agent home.
+- Source-home Claude Code hooks are merged with CCB-managed finish/activity
+  hooks, so installed user hook tools stay visible after agent restart.
+- Managed Claude `.claude.json` is treated as secret provider state because MCP
+  definitions may include environment variables or auth-adjacent launch data.
+
+</details>
+
+<details>
+<summary><b>v7.6.11</b> - Layout Percent And Codex MCP Overlays</summary>
+
+- Adds explicit pane split ratios in layout tokens, such as
+  `agent1:codex@30`, while preserving the existing even-split default when no
+  suffix is present.
+- Adds source-controlled per-agent Codex MCP overlays through
+  `provider_profile.mcp_servers`; same-name MCP servers override inherited
+  Codex config and different names are additive.
+- Preserves trusted Codex command hooks during managed Codex home projection,
+  improves sidebar Comms/Tips scrolling and resizing, and exposes more reply
+  artifact evidence in `ccb trace`.
+
+</details>
+
+<details>
 <summary><b>v7.6.10</b> - Z.ai Provider Support</summary>
 
 - Adds managed optional Z.ai CLI provider support with `provider = "zai"`,
@@ -809,6 +908,11 @@ v7 highlights:
   only when `.hindsight/kimi.json`, `.hindsight/codex.json`,
   `HINDSIGHT_API_URL`, or `HINDSIGHT_BANK_ID` is configured, and failures remain
   non-blocking provider diagnostics.
+- Preserves trusted Codex command hooks, including Hindsight Codex hooks, when
+  CCB materializes managed Codex homes. Operators can extend the allowlist with
+  `CCB_CODEX_INHERITED_HOOK_EVENTS` and
+  `CCB_CODEX_INHERITED_COMMAND_HOOK_MARKERS`; arbitrary root hooks remain
+  filtered out.
 - Accepts both `HINDSIGHT_API_KEY` and `HINDSIGHT_API_TOKEN` for the Kimi
   bridge and the `scripts/hindsight` helper.
 - Documents the supported provider surface more clearly in the README while
@@ -1213,4 +1317,6 @@ v7 highlights:
 
 </details>
 
+</details>
+
 See [CHANGELOG.md](CHANGELOG.md) for the full history.

package/README_zh.md

@@ -6,7 +6,7 @@
 **可见、可控的多 Agent 合作TUI工作台**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.6.10-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-7.6.12-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-15%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -45,21 +45,29 @@
 
 可在 `.ccb/ccb.config` 中按 agent 混用不同 CLI；实际可用性取决于本机 CLI 安装和账号权限。
 
-- Codex（`codex`）
-- Claude（`claude`）
-- Gemini（`gemini`）
-- Kimi（`kimi`）
-- MiMo（`mimo`）
-- Qwen（`qwen`）
-- Cursor（`cursor`）
-- GitHub Copilot CLI（`copilot`）
-- Crush（`crush`）
-- Kiro CLI（`kiro`）
-- Pi（`pi`）
-- Z.ai CLI（`zai`）
-- OpenCode（`opencode`）
-- Antigravity（`agy`）
-- Droid（`droid`）
+<table>
+  <tr>
+    <td>Codex<br><code>codex</code></td>
+    <td>Claude<br><code>claude</code></td>
+    <td>Gemini<br><code>gemini</code></td>
+    <td>Kimi<br><code>kimi</code></td>
+    <td>MiMo<br><code>mimo</code></td>
+  </tr>
+  <tr>
+    <td>Qwen<br><code>qwen</code></td>
+    <td>Cursor<br><code>cursor</code></td>
+    <td>GitHub Copilot CLI<br><code>copilot</code></td>
+    <td>Crush<br><code>crush</code></td>
+    <td>Kiro CLI<br><code>kiro</code></td>
+  </tr>
+  <tr>
+    <td>Pi<br><code>pi</code></td>
+    <td>Z.ai CLI<br><code>zai</code></td>
+    <td>OpenCode<br><code>opencode</code></td>
+    <td>Antigravity<br><code>agy</code></td>
+    <td>Droid<br><code>droid</code></td>
+  </tr>
+</table>
 
 **全新角色规范**：可把 skills、记忆和工具依赖封装进自封闭 Role Pack，快速生成可热加载、可卸载的专业 agent。
 
@@ -191,16 +199,49 @@ ccb
   <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
 </p>
 
+### Agent Roles Spec 规范和角色库
+
+CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把专业角色打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
+
+<details>
+<summary><b>当前角色库</b></summary>
+
+| Role | 基本功能 |
+| :--- | :--- |
+| `agentroles.ccb_self` | CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。 |
+| `agentroles.archi` | 架构审查、边界检查、耦合分析、可维护性风险和后续 gate 建议。 |
+| `agentroles.frontend_engineer` | 前端设计与实现、设计系统、可访问性、浏览器 QA 和受审查的 AGY 委派。 |
+| `agentroles.mobile_app_engineer` | iOS、Android、React Native、Expo、Flutter、SwiftUI、Jetpack Compose 等移动端设计与实现。 |
+| `agentroles.mother` | Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。 |
+| `agentroles.su_ccb` | SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。 |
+
+</details>
+
 ### 联系方式
 
 - Email: `bfly123@126.com`
 - 微信: `seemseam-com`
 
+<p align="center">
+  <img src="assets/weixin.jpg" alt="微信群" width="240">
+</p>
+
 ---
 
 ## 更多阅读
 
-初次使用可以先从快速开始进入；下面内容补充 CCB 的设计边界、方案对比、日常操作和配置方式。
+初次使用先看“快速开始”即可。下面按用途折叠，需要哪块再展开。
+
+| 主题 | 什么时候看 |
+| :--- | :--- |
+| 概念和定位 | 了解 CCB 是什么、多 agent 为什么有用，以及与其他方案的区别。 |
+| 日常操作 | 查常用命令、tmux 基础操作和复制粘贴。 |
+| 配置和角色 | 配 `.ccb/ccb.config`、Role Packs、`ccb_self` 配置助手。 |
+| 协作与维护 | ask 路由、安装更新、FAQ 和致谢。 |
+| 版本记录 | 查看当前 v7 重点和历史版本条目。 |
+
+<details open>
+<summary><b>概念和定位</b></summary>
 
 ### CCB 是什么
 
@@ -263,6 +304,11 @@ CCB 也支持复杂工作流，但它不是自动生成 DAG 的 harness；复杂
 
 </details>
 
+</details>
+
+<details>
+<summary><b>日常操作</b></summary>
+
 ### 日常操作
 
 | 目标 | 命令 |
@@ -322,6 +368,11 @@ CCB 虽然基本全部可以使用鼠标操作，但是学会 tmux 命令可以
 
 </details>
 
+</details>
+
+<details>
+<summary><b>配置和角色</b></summary>
+
 ### 配置 agent 团队
 
 CCB 配置有三层，优先级从低到高：
@@ -352,9 +403,15 @@ CCB 配置有三层，优先级从低到高：
 
 #### Role Packs
 
-Role Pack 用来定义可复用的 agent 角色。一个 role 可以包含稳定身份、职责、
-记忆、provider-specific skills、工具 hooks 和依赖准备逻辑。这样项目配置会更短，
-专门角色也能跨项目复用，不需要在每个项目里复制一大段角色说明。
+Role Pack 通过 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)
+定义可复用的 agent 角色。这个规范是 host-neutral 的专业 agent 包格式：一个
+Role 可以把稳定身份、职责、非目标、记忆、skills、prompts、references、tools、
+plugin 内容、验证说明和 host adapter metadata 放进一个可审查的独立单元。
+
+它的意义是把边界分清楚：Role source 保持可移植、可版本化；项目绑定决定这个
+Role 挂载到哪里；provider 运行态、凭据、任务进度和生成的投影文件都留在 Role
+外部。这样专门 agent 更容易安装、更新、审计、迁移和卸载，不需要在每个项目里复制
+大段 prompt，也不会污染用户全局配置。
 
 推荐默认 catalog roles 包括 `agentroles.ccb_self` 和
 `agentroles.archi`：前者是 CCB 自维护角色，后者用于架构审查，来自
@@ -363,6 +420,9 @@ Role Pack 用来定义可复用的 agent 角色。一个 role 可以包含稳定
 推荐角色。也可以手动刷新：
 
 ```bash
+ccb roles list
+ccb roles show agentroles.archi
+ccb roles install agentroles.archi
 ccb roles update agentroles.ccb_self
 ccb roles update agentroles.archi
 ```
@@ -509,6 +569,11 @@ ccb ask ccb_self "为一个 Python library 设计团队：main 负责任务拆
 
 </details>
 
+</details>
+
+<details>
+<summary><b>协作与维护</b></summary>
+
 ### Agent 之间如何协作
 
 普通 `ask` 是提交即返回：把任务交给目标 agent 后，当前 agent 不应该轮询等待。
@@ -616,9 +681,10 @@ ccb reinstall
 
 感谢 [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) 提供的 sidebar 思路和启发。
 
-<div align="center">
-  <img src="assets/weixin.jpg" alt="微信群" width="300">
-</div>
+</details>
+
+<details>
+<summary><b>版本记录</b></summary>
 
 ### 新版本记录
 
@@ -632,6 +698,33 @@ v7 线重点：
 - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
 
 <details open>
+<summary><b>v7.6.12</b> - Claude MCP 与 Hook 继承</summary>
+
+- managed Claude agent 现在会从 source `.claude.json` 继承 Claude Code MCP
+  配置，包括全局 `mcpServers` 和当前 project/workspace 的 MCP server 状态。
+- project 级 MCP 状态只映射到当前 managed workspace key，不会把无关 source
+  project 记录复制进 agent home。
+- source-home Claude Code hooks 会与 CCB-managed finish/activity hooks 合并，
+  用户安装的 hook 工具在 agent restart 后仍可见。
+- managed Claude `.claude.json` 现在按 secret provider state 处理，因为 MCP
+  定义可能包含环境变量或接近认证材料的启动配置。
+
+</details>
+
+<details>
+<summary><b>v7.6.11</b> - Layout Percent 与 Codex MCP Overlay</summary>
+
+- 新增显式 pane split 比例 layout token，例如 `agent1:codex@30`；没有
+  `@N` 后缀时继续保持原有 sibling panes 均分行为。
+- 新增通过 `provider_profile.mcp_servers` 配置 per-agent Codex MCP overlay；
+  同名 MCP server 覆盖继承配置，不同名 additive。
+- managed Codex home projection 现在会保留可信 Codex command hook，并改进
+  sidebar Comms/Tips 的滚动和拖拽调整，同时在 `ccb trace` 暴露更多 reply
+  artifact 证据。
+
+</details>
+
+<details>
 <summary><b>v7.6.10</b> - Z.ai Provider 支持</summary>
 
 - 新增 Z.ai CLI optional provider：支持 `provider = "zai"`、可见
@@ -779,6 +872,10 @@ v7 线重点：
 - Kimi Hindsight 记忆改为 CCB 执行边界上的显式 opt-in：只有配置
   `.hindsight/kimi.json`、`.hindsight/codex.json`、`HINDSIGHT_API_URL` 或
   `HINDSIGHT_BANK_ID` 时才启用，失败时只记录 provider diagnostics，不阻塞任务。
+- CCB 物化 managed Codex home 时会保留可信 Codex command hook，包括
+  Hindsight Codex hooks。运维可通过 `CCB_CODEX_INHERITED_HOOK_EVENTS` 和
+  `CCB_CODEX_INHERITED_COMMAND_HOOK_MARKERS` 扩展 allowlist；任意 root hook
+  仍会被过滤。
 - Kimi bridge 和 `scripts/hindsight` helper 同时兼容 `HINDSIGHT_API_KEY` 与
   `HINDSIGHT_API_TOKEN`。
 - README 更明确展示支持的 provider surface，同时保持无关 provider 行为不变。
@@ -1165,4 +1262,6 @@ v7 线重点：
 
 </details>
 
+</details>
+
 完整历史请看 [CHANGELOG.md](CHANGELOG.md)。

package/VERSION

@@ -1 +1 @@
-7.6.10
+7.6.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "7.6.10",
+  "version": "7.6.12",
   "description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, Kimi, MiMo, Qwen, Cursor, Copilot, Crush, Kiro, Pi, Z.ai, OpenCode, Antigravity, and Droid.",
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",