# ArmorBreak V2.2 审计与 GA Gate

> 结论：**pre-release 可复核；正式 GA 未通过**。本地 host/provider 测试和 OIDC 构建溯源不替代逐项外部签名证据、独立审查或生产制品签名。
>
> 基线：`2.2.0-rc.1`，源码/证据 commit 以 `docs/v2/acceptance/v2.2-readiness.json` 为准；测试 **388 / 387 pass / 0 fail / 1 skipped**。

## 1. 已完成

| 范围 | 结果 | 证据 |
|---|---|---|
| 46 能力 / 9 工作流 / Universal Core | PASS | 能力与测试 |
| MCP stdio / HTTP / HTTPS / SSE | PASS | MCP 测试 |
| TypeScript SDK / tsc | PASS | `sdk-types.test.mjs` |
| OpenAI Chat / Responses / Anthropic / Gemini native 协议 | Mock + golden PASS | `provider-*` 测试 |
| Secret Vault / egress / budget | PASS | `provider-vault-policy.test.mjs` |
| Workbench | PASS | `workbench.png`、`workbench.test.mjs` |
| 旧数据只读/迁移/回滚/灰度 | PASS | `old-data-readonly-drill.json` |
| 确定性构建 / SBOM / GitHub OIDC attestation | PASS | `release-build.json`、`github-attestation.json` |
| 本地记录的真实宿主 L0 | **10/10 总矩阵，9/9 第三方** | `compatibility-matrix.json`；Full GA 另要求各 host 记录的签名收据 |

兼容口径：矩阵有 **12 个入口、10 个 L0 成功记录**。Claude Cowork CLI L0 与 Claude Code MCP handshake 分开记录；Gemini CLI handshake 与 Antigravity Desktop MCP L0 分开记录。第三方 L0 为 9/9，不把 CLI 成功或 handshake 宣称为原生 MCP 全流程通过。

真实宿主：

- Codex、Hermes、Cursor、WorkBuddy、TRAE、Pi：真实 L0。
- ZCode：真实 MCP L0，`task_mvjo2nqy_726bd805`，4 证据，2 findings。
- Antigravity：真实 MCP L0，`task_mvjoq3xk_a07113b4`，2 证据。
- Claude Cowork：真实宿主模型 L0，`task_mvjo4s66_c4407844`，2 证据；该会话未挂载 ArmorBreak MCP，使用仓库 CLI，因此标为 `cli_verified_l0`。Claude Code 的 MCP 入口单独保留 handshake 级证据，不冒充 MCP 模型 E2E。
- Gemini CLI：独立 MCP handshake 7 工具，无模型 L0；Antigravity Desktop 单独记录真实 MCP L0。

## 2. Full GA 外部证据要求

Full GA 需要 17 项针对精确候选提交签名的收据：5 个真实 Provider endpoint、1 个独立审查、10 个 host L0/install 记录，以及 ABU-408 的生产 artifact signature。GitHub OIDC/Sigstore build provenance 是另一项独立门禁，不计入这 17 项。当前没有配置的可信外部 signer 集或签名收据，因此这些项保持阻断；本地 compatibility matrix 的 L0 状态和任务 Markdown 仅供阅读，不能充当签名证明。

### Provider 真实端点（5 个验收项，3 个根因）

- `ABU-311` OpenAI Responses
- `ABU-312` OpenAI Chat
- `ABU-313` Anthropic Messages
- `ABU-314` Gemini native
- `ABU-318` 跨协议 golden（派生项）

以上 Mock/流式/工具/错误映射均 PASS；缺真实付费端点凭据。

### 独立审查（1）

- `ABU-409`：旧数据、迁移、灰度、证据包 PASS；独立第三方审查 `BLOCKED_EXTERNAL`。

## 3. 签名与信任边界

`portable-artifact.json` 的 GitHub OIDC + Sigstore attestation 是构建来源证明，不是生产 artifact signature。Full GA 分别验证 Sigstore 来源证明和由 `production-signer` 角色密钥签署的确切制品摘要；两者都不替代独立审查或 Provider/host 外部证据。

## 4. 安装、升级与回滚

- 安装：`node packages/cli/index.js agent install --target generic|claude|codex|hermes --config <path> --apply`
- 升级：显式 `--force`，保留其他 server
- 卸载：只删除 armorbreak 条目
- 回滚：JSON/TOML/YAML byte-exact；旧 V2 迁移 copy-only
- Pi：`pi install D:\dsh-ABM\armorbreak\plugins\pi` / `pi remove ...` 已验证

## 5. 决定

- `preReleaseReady:true`
- `gaReady:false`
- pre-release waivers：**0**
- 不创建正式 `v2.2.0` tag，不覆盖 `v2.0.0` 或 `v2.2.0-owner-waiver`
- 配置受保护的外部 signer 公钥集、提交并签署精确候选的外部证据收据、完成生产签名和候选 artifact attestation 后，再运行 `v2-readiness --require-ga`