mancode 0.3.9 → 0.3.10

package/README.en.md

@@ -17,9 +17,10 @@
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
   <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm version" /></a>
-  <img src="https://img.shields.io/badge/status-stable%20v0.3.9-green?style=flat-square" alt="Status: stable v0.3.9" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.3.10-green?style=flat-square" alt="Status: stable v0.3.10" />
+  <img src="https://img.shields.io/badge/V3-cross--CLI%20team%20Beta-FB6A21?style=flat-square" alt="V3: cross-CLI team Beta" />
   <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex in ChatGPT desktop and CLI, GitHub Copilot, ZCode" />
-  <img src="https://img.shields.io/badge/tests-444%20passed-brightgreen?style=flat-square" alt="Tests: 444 passed" />
+  <img src="https://img.shields.io/badge/tests-passing-brightgreen?style=flat-square" alt="Tests passing" />
 </p>
 
 <p align="center">
@@ -89,6 +90,47 @@ These are agent skills, not deprecated custom prompts. See the official
 [slash-command](https://learn.chatgpt.com/docs/reference/slash-commands) docs.
 Existing workflow metadata remains compatible and does not need migration.
 
+## V3 Cross-CLI and Team Beta
+
+V3 gives new team projects stable `TaskRef` context, isolated sessions,
+governance ledgers, worktree claims and handoffs, and optional git-ref
+coordination across clones. It is a **hard-gated Beta**: adapters bootstrap
+Claude Code, Cursor, Codex, GitHub Copilot, and ZCode, but platform files never
+become the authority for task or session state.
+
+For a new project, start with one platform you actually use:
+
+```bash
+mancode init --v3 --team --platform claude-code
+mancode team identity create --name "Your name"
+mancode context session new --client claude-code
+mancode list-platforms
+```
+
+Use the CLI for creation, resume, and coordination: `mancode workflow create`,
+`mancode context resume`, `mancode team claim`, and `mancode team handoff`. For
+an existing project, begin with `mancode migrate context --dry-run`, then follow
+its stage and activation report. Do not manually mix legacy `state.json` writes
+with V3 authority.
+
+### Beta validation boundary
+
+- The `main` branch requires a Windows gate that runs smoke tests in CMD,
+  PowerShell, and Git Bash.
+- `mancode context beta --release-candidate <commit> --json` checks activation,
+  adapters, repair state, worktree binding, and session evidence for all five
+  platforms. Evidence must bind to that immutable release candidate; any blocker
+  stops broad enablement.
+- Each platform must prove distinct sessions in two real host windows, child-command
+  propagation, and child-agent inheritance (or record a specific reason it is not
+  applicable). `context session spike` records an operator-attested real-host result;
+  it never infers propagation from a temporary environment variable. Stored evidence
+  never includes raw session keys.
+
+Until that gate passes, use an explicit `--session <id>` and do not treat host
+identity as verified. This lets you try V3 without presenting unproven
+cross-platform session behavior as a fact.
+
 ## What Gets Installed
 
 `mancode init` creates local workflow files and platform integration files:
@@ -302,7 +344,7 @@ it should behave, and why previous decisions were made.
 
 ## Installation
 
-**Status**: stable v0.3.9. Claude Code, Cursor, Codex in the ChatGPT desktop app
+**Status**: stable v0.3.10. Claude Code, Cursor, Codex in the ChatGPT desktop app
 and CLI, and GitHub Copilot are supported. ZCode adapter support is included,
 with project skill discovery kept behind a verification gate before release.
 
@@ -405,7 +447,7 @@ mancode version
 Example output for a UI project (not a default stack):
 
 ```text
-mancode v0.3.9
+mancode v0.3.10
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)

package/README.md

@@ -17,13 +17,17 @@
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="许可证：AGPL-3.0" /></a>
   <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm 版本" /></a>
-  <img src="https://img.shields.io/badge/status-stable%20v0.3.9-green?style=flat-square" alt="状态：稳定版 v0.3.9" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.3.10-green?style=flat-square" alt="状态：稳定版 v0.3.10" />
+  <img src="https://img.shields.io/badge/V3-%E8%B7%A8%20CLI%20%E5%9B%A2%E9%98%9F%20Beta-FB6A21?style=flat-square" alt="V3：跨 CLI 团队协作 Beta" />
   <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、ChatGPT 桌面端 Codex、Codex CLI、GitHub Copilot、ZCode" />
-  <img src="https://img.shields.io/badge/tests-444%20passed-brightgreen?style=flat-square" alt="测试：444 通过" />
+  <img src="https://img.shields.io/badge/tests-passing-brightgreen?style=flat-square" alt="测试通过" />
 </p>
 
 <p align="center">
-  <a href="./README.en.md">English</a>
+  <a href="https://github.com/whitelonng/mancode/blob/main/README.en.md">English</a> ·
+  <a href="https://whitelonng.github.io/mancode/">官网</a> ·
+  <a href="https://github.com/whitelonng/mancode#%E5%AE%89%E8%A3%85%E6%96%B9%E6%B3%95">安装方法</a> ·
+  <a href="https://github.com/whitelonng/mancode#%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95">使用方法</a>
 </p>
 
 ---
@@ -34,8 +38,6 @@
 日常任务用轻量 `solo`，关键任务用季后赛级别的 `/man`，复杂任务让教练组 subagents
 负责调研、计划、实现和审查。
 
-[安装方法](#安装方法) · [使用方法](#使用方法)
-
 mancode 当前支持 Claude Code、Cursor、ChatGPT 桌面端中的 Codex、Codex CLI、
 GitHub Copilot 和 ZCode。Claude Code 获得完整 hooks、skills 和 subagents；其他
 平台通过持久化 rules、skills 或 instructions 文件提供降级适配。
@@ -82,6 +84,38 @@ ChatGPT 桌面端、Codex CLI 和 Codex IDE 扩展会从 `.agents/skills/` 读
 和 [slash command 文档](https://learn.chatgpt.com/docs/reference/slash-commands)。
 已有 workflow 元数据继续兼容，不需要迁移。
 
+## V3 跨 CLI 与团队协作 Beta
+
+V3 为新团队项目提供稳定 `TaskRef` 上下文、隔离 session、治理账本、worktree
+claim/handoff，以及可选的 git-ref 跨 clone 协调。它是**带硬门禁的 Beta**：adapter 能为
+Claude Code、Cursor、Codex、GitHub Copilot 和 ZCode 提供 bootstrap，但不会把平台文件
+当作任务或 session 状态的权威来源。
+
+在全新项目中，从一个实际使用的平台开始：
+
+```bash
+mancode init --v3 --team --platform claude-code
+mancode team identity create --name "Your name"
+mancode context session new --client claude-code
+mancode list-platforms
+```
+
+创建、恢复和协作均通过 CLI 完成：`mancode workflow create`、`mancode context resume`、
+`mancode team claim` 和 `mancode team handoff`。已有项目先运行
+`mancode migrate context --dry-run`，再按迁移报告确认 stage/activation；不要手工混写
+legacy `state.json` 与 V3 authority。
+
+### Beta 的验证边界
+
+- `main` 的 Windows 门禁会从 CMD、PowerShell 和 Git Bash 运行 smoke 测试。
+- `mancode context beta --release-candidate <commit> --json` 会检查 activation、adapter、repair、worktree binding 和
+  五个平台的 session evidence；evidence 必须绑定同一个不可变发布候选，任何 blocker 都会阻止大范围启用。
+- 每个平台都必须在真实宿主中证明两个窗口的 session 区分、子命令传播以及子 agent 继承（或记录明确的不适用原因）。
+  `context session spike` 只记录操作者报告的真实宿主结果，不会由临时环境变量自动推断传播成功；证据不保存原始 session key。
+
+在门禁通过前，继续显式传入 `--session <id>`，不要把 host identity 视为已验证。这样可以
+先试用 V3，同时避免把尚未证明的跨平台 session 行为当作事实。
+
 ## 安装后创建哪些文件？
 
 `mancode init` 会创建本地工作流文件和平台适配文件：
@@ -262,7 +296,7 @@ src/components/
 
 ## 安装
 
-**状态**：稳定版 v0.3.9。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
+**状态**：稳定版 v0.3.10。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
 Codex CLI 和 GitHub Copilot 均已支持。ZCode adapter 已接入，但项目级 skill
 发现路径在发布前仍作为验证门禁。
 
@@ -363,7 +397,7 @@ mancode version
 以下是 UI 项目的输出示例，并非默认技术栈：
 
 ```text
-mancode v0.3.9
+mancode v0.3.10
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)