@seemseam/ccb 7.7.0 → 8.0.3

package/README.md

@@ -6,7 +6,7 @@
 **Visible, controllable multi-agent cooperative TUI workspace**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.7.0-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.0.3-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>
@@ -31,7 +31,7 @@
 
 **English** | [中文](README_zh.md)
 
-[Quick Start](#quick-start) · [v7 UI](#v7-ui-tour) · [Rich Mode](#rich-mode-new) · [Configure Agents](#configure-your-agent-team) · [Mobile Gateway Alpha](docs/mobile-cloudflare-alpha.md) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
+[Quick Start](#quick-start) · [v7 UI](#v7-ui-tour) · [Rich Mode](#rich-mode-new) · [Mobile App](#mobile-app) · [Configure Agents](#configure-your-agent-team) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
 
 <p align="center">
   <img src="assets/readme_v7/ccb-hero-en.png" alt="CCB v7 visible multi-agent CLI workspace" width="960">
@@ -79,6 +79,18 @@ Mix CLIs per agent in `.ccb/ccb.config`; actual availability depends on the loca
 
 ## Quick Start
 
+## Repository Layout
+
+This repository now carries both the CCB core and the mobile controller source:
+
+- core CLI, ccbd, mobile gateway, and Python tests live at the repository root;
+- Flutter mobile app source, mobile tools, and mobile planning docs live under
+  [`mobile/`](mobile/).
+
+The mobile app remains a separate build surface inside the monorepo. Core
+commands such as `ccb update mobile` should consume released mobile artifacts
+or the mobile release manifest, not Android build outputs checked into source.
+
 ### 1. Install or update
 
 New installs should use the npm package:
@@ -101,10 +113,20 @@ ccb update rich
 
 After rich is enabled, plain `ccb` opens the rich WezTerm launcher unless it is already running inside a CCB-managed rich WezTerm; use `ccb uninstall rich` to return to the normal terminal startup.
 
+Install or refresh the optional mobile controller setup:
+
+```bash
+ccb update mobile
+```
+
+This command checks the local mobile gateway prerequisites, guides Tailscale
+login/Serve setup when needed, keeps the gateway loopback-only, and prints the
+current Android APK download link plus pairing steps.
+
 <details>
 <summary><b>GitHub release package and source install fallbacks</b></summary>
 
-If npm is not available in your environment, download the matching package from [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases):
+If npm is not available in your environment, download the matching package from [Releases](https://github.com/bfly123/claude_code_bridge/releases):
 
 ```bash
 tar -xzf ccb-*.tar.gz
@@ -115,8 +137,8 @@ cd ccb-*
 Source install is for development or temporary fallback use:
 
 ```bash
-git clone https://github.com/SeemSeam/claude_codex_bridge.git
-cd claude_codex_bridge
+git clone https://github.com/bfly123/claude_code_bridge.git
+cd claude_code_bridge
 ./install.sh install
 ```
 
@@ -196,6 +218,45 @@ 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>
 
+<a id="mobile-app"></a>
+
+### Mobile App (Android Alpha)
+
+CCB 8.0.3 includes the Flutter CCB Mobile source under [`mobile/`](mobile/)
+and publishes an Android APK as a GitHub Release asset:
+
+- [Download CCB Mobile v8.0.3 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.3/ccb-mobile-v8.0.3.apk)
+- App source: [`mobile/app`](mobile/app)
+- Server/gateway source: [`lib/mobile_gateway`](lib/mobile_gateway)
+
+The mobile app is a remote controller for real server-side CCB projects. It can
+discover all mounted CCB projects exposed by the server-wide mobile gateway,
+switch windows and agents, render the agent transcript, send text as pane-native
+input, open terminal views, and upload/download image or document attachments
+through the authenticated gateway.
+
+Recommended first-time setup:
+
+```bash
+ccb update mobile
+```
+
+Then follow the printed steps:
+
+1. Install and sign in to Tailscale on the desktop/server and the phone.
+2. Install the APK on Android.
+3. Run `ccb update mobile` on the desktop/server.
+4. Open CCB Mobile and scan the QR printed by the terminal.
+
+Security boundaries:
+
+- The CCB gateway remains bound to loopback, such as `127.0.0.1:8787`.
+- Tailscale Serve is used for tailnet access; Tailscale Funnel is not enabled.
+- CCB does not store Tailscale passwords, OAuth tokens, admin API tokens, or
+  alter tailnet ACLs/grants.
+- The phone only receives the scopes granted by the pairing profile, such as
+  view, content, terminal, file upload, and file download.
+
 ### 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.
@@ -644,7 +705,7 @@ For later updates:
 ccb update
 ```
 
-[GitHub Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) remain available for environments where npm is unavailable. Source checkout install is for development, fix validation, or temporary fallback.
+[GitHub Releases](https://github.com/bfly123/claude_code_bridge/releases) remain available for environments where npm is unavailable. Source checkout install is for development, fix validation, or temporary fallback.
 
 #### Uninstall
 
@@ -709,6 +770,55 @@ v7 highlights:
 - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
 
 <details open>
+<summary><b>v8.0.3</b> - npm Release Metadata Fix</summary>
+
+- Fixes npm provenance metadata so `@seemseam/ccb` publishes from the canonical
+  GitHub repository used by GitHub Actions.
+- Synchronizes VERSION, package metadata, mobile app version metadata, README
+  links, workflow defaults, and APK download URLs for 8.0.3.
+
+</details>
+
+<details>
+<summary><b>v8.0.2</b> - Mobile Tailnet Onboarding Fixes</summary>
+
+- Handles the Tailscale Serve one-time approval flow without exposing raw
+  timeout errors.
+- Reuses an existing correct Tailscale Serve proxy for `:8787`, so users who
+  already approved or started Serve can immediately get the pairing QR.
+- Fixes source worktree installs so installed `ccb` is not mistaken for a source
+  checkout.
+
+</details>
+
+<details>
+<summary><b>v8.0.1</b> - Simplified CCB Mobile Pairing</summary>
+
+- Makes `ccb update mobile` the single user-facing setup command: it checks
+  Tailscale, guides login/install, starts the server-wide loopback gateway plus
+  Tailscale Serve, and prints a pairing QR directly in the terminal.
+- Updates CCB Mobile first launch to show pairing instructions, Tailscale
+  download guidance, and a scan button instead of opening the fake/demo project.
+- Automatically opens the server-wide mounted project list after a stored
+  pairing profile is found, reducing setup friction for normal phone use.
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - CCB Mobile Monorepo Release</summary>
+
+- Ships the Flutter CCB Mobile source inside this repository and publishes the
+  Android APK as a GitHub Release asset.
+- Adds server-wide mobile project discovery, pairing, authenticated gateway
+  routes, pane-native message input, transcript rendering, terminal access, and
+  image/document upload and download support.
+- Promotes `ccb update mobile` as the guided setup entry for Tailscale Tailnet
+  onboarding while preserving loopback-only gateway binding and avoiding Funnel,
+  token storage, or ACL/grant automation.
+
+</details>
+
+<details>
 <summary><b>v7.7.0</b> - Runtime Accelerator Release Hardening</summary>
 
 - Ships the optional Rust `ccb-runtime-accelerator` in release artifacts, so

package/README_zh.md

@@ -6,7 +6,7 @@
 **可见、可控的多 Agent 合作TUI工作台**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.7.0-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.0.3-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>
@@ -31,7 +31,7 @@
 
 **中文** | [English](README.md)
 
-[快速开始](#快速开始) · [v7 界面](#v7-界面速览) · [Rich 模式](#rich-mode-new) · [配置团队](#配置-agent-团队) · [Mobile Gateway Alpha](docs/mobile-cloudflare-alpha.zh.md) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
+[快速开始](#快速开始) · [v7 界面](#v7-界面速览) · [Rich 模式](#rich-mode-new) · [Mobile App](#mobile-app) · [配置团队](#配置-agent-团队) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
 
 <p align="center">
   <img src="assets/readme_v7/ccb-hero-zh.png" alt="CCB v7 可见多 Agent CLI 工作台" width="960">
@@ -101,10 +101,19 @@ ccb update rich
 
 rich 启用后，普通 `ccb` 会自动打开 rich WezTerm launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；运行 `ccb uninstall rich` 可退回普通终端启动。
 
+可选手机控制端用下面的入口安装或刷新本机侧配置：
+
+```bash
+ccb update mobile
+```
+
+该命令会检查 mobile gateway 依赖，按需引导 Tailscale 登录/Serve 配置，
+保持 gateway 仅监听 loopback，并打印当前 Android APK 下载链接和扫码配对步骤。
+
 <details>
 <summary><b>GitHub release 包和源码安装兜底</b></summary>
 
-如果当前环境不方便使用 npm，可以到 [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) 下载与你的平台匹配的包，解压后安装：
+如果当前环境不方便使用 npm，可以到 [Releases](https://github.com/bfly123/claude_code_bridge/releases) 下载与你的平台匹配的包，解压后安装：
 
 ```bash
 tar -xzf ccb-*.tar.gz
@@ -115,8 +124,8 @@ cd ccb-*
 源码安装只建议开发或临时兜底使用：
 
 ```bash
-git clone https://github.com/SeemSeam/claude_codex_bridge.git
-cd claude_codex_bridge
+git clone https://github.com/bfly123/claude_code_bridge.git
+cd claude_code_bridge
 ./install.sh install
 ```
 
@@ -197,6 +206,44 @@ ccb
   <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
 </p>
 
+<a id="mobile-app"></a>
+
+### Mobile App（Android Alpha）
+
+CCB 8.0.3 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，
+并在 GitHub Release 中发布 Android APK：
+
+- [下载 CCB Mobile v8.0.3 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.3/ccb-mobile-v8.0.3.apk)
+- App 源码：[`mobile/app`](mobile/app)
+- 服务端 gateway 源码：[`lib/mobile_gateway`](lib/mobile_gateway)
+
+手机端定位是远程控制真实服务器上的 CCB 项目。它可以从 server-wide
+mobile gateway 获取所有已挂载项目，切换 window/agent，渲染 agent
+对话上下文，以 pane-native 输入方式发送文本，打开 terminal 视图，并通过
+认证 gateway 上传/下载图片和文档附件。
+
+首次配置建议：
+
+```bash
+ccb update mobile
+```
+
+然后按终端提示：
+
+1. 在桌面/服务器和手机上安装并登录同一个 Tailscale tailnet。
+2. 在 Android 手机上安装 APK。
+3. 在桌面/服务器运行 `ccb update mobile`。
+4. 打开 CCB Mobile，扫描终端打印的配对二维码。
+
+安全边界：
+
+- CCB gateway 只绑定 loopback，例如 `127.0.0.1:8787`。
+- 远程访问使用 Tailscale Serve，不启用 Tailscale Funnel。
+- CCB 不保存 Tailscale 密码、OAuth token、admin API token，也不会自动修改
+  tailnet ACL/grants。
+- 手机只获得 pairing profile 授权的 scope，例如 view、content、terminal、
+  file upload 和 file download。
+
 ### Agent Roles Spec 规范和角色库
 
 CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把专业角色打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
@@ -630,7 +677,7 @@ npm install -g @seemseam/ccb
 ccb update
 ```
 
-[GitHub Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) 仍作为不方便使用 npm 时的备选路径。源码 checkout 安装只适合开发、验证修复或临时兜底。
+[GitHub Releases](https://github.com/bfly123/claude_code_bridge/releases) 仍作为不方便使用 npm 时的备选路径。源码 checkout 安装只适合开发、验证修复或临时兜底。
 
 #### 卸载
 
@@ -695,6 +742,53 @@ v7 线重点：
 - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
 
 <details open>
+<summary><b>v8.0.3</b> - npm Release Metadata 修复</summary>
+
+- 修复 npm provenance metadata，使 `@seemseam/ccb` 的发布仓库与 GitHub
+  Actions 使用的 canonical 仓库一致。
+- 同步 VERSION、package metadata、mobile app version metadata、README 链接、
+  workflow 默认值和 APK 下载链接到 8.0.3。
+
+</details>
+
+<details>
+<summary><b>v8.0.2</b> - Mobile Tailnet Onboarding 修复</summary>
+
+- 正确识别 Tailscale Serve 一次性授权链接，不再把原始 timeout 暴露给用户。
+- 如果 `:8787` 的 Tailscale Serve 代理已经正确指向 loopback mobile gateway，
+  `ccb update mobile` 会直接复用并进入配对二维码流程。
+- 修复 source worktree 安装时误复制 `.git` worktree 标记的问题，避免安装版
+  `ccb` 被误判为源码 checkout。
+
+</details>
+
+<details>
+<summary><b>v8.0.1</b> - CCB Mobile 极简配对</summary>
+
+- 将 `ccb update mobile` 收敛为唯一面向普通用户的设置入口：检测
+  Tailscale、引导登录/安装、启动 server-wide loopback gateway 和 Tailscale
+  Serve，并直接在终端打印配对二维码。
+- 手机端首次启动不再进入 fake/demo 项目，而是显示配对说明、Tailscale 下载提示
+  和扫码按钮。
+- 检测到已保存 pairing profile 后，手机端会自动进入 server-wide 已挂载项目列表，
+  降低普通手机使用的配置压力。
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - CCB Mobile Monorepo 发布</summary>
+
+- Flutter 版 CCB Mobile 源码正式进入本仓库，并在 GitHub Release 中发布
+  Android APK。
+- 新增 server-wide mobile 项目发现、配对、认证 gateway 路由、pane-native
+  消息输入、对话上下文渲染、terminal 访问，以及图片/文档上传下载能力。
+- 将 `ccb update mobile` 提升为 Tailscale Tailnet onboarding 的统一入口，
+  同时保持 gateway 仅监听 loopback，不启用 Funnel、不保存 token、不自动修改
+  ACL/grants。
+
+</details>
+
+<details>
 <summary><b>v7.7.0</b> - Runtime Accelerator 发布加固</summary>
 
 - Release artifacts 现在会携带可选 Rust `ccb-runtime-accelerator`，安装版

package/VERSION

@@ -1 +1 @@
-7.7.0
+8.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "7.7.0",
+  "version": "8.0.3",
   "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",