BB-05: scope the libra test-client prohibitions

Add a scope note (plan-20261001 ADR-BB-03) next to ADR-SO-09, GC-AW-04,
GC-LB-04, GC-FT-04 and the test-infra / deploy-trunk prohibitions: they
bind the Git protocol and API write smokes; the Libra interop smoke uses
libra as the client under test. Docs only; ships with the BB-03 release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018bJDjze83ToyPysYzmxxWS
Signed-off-by: Eli Ma <eli@patch.sh>

Author: genedna

docs/deploy-trunk.md

@@ -146,6 +146,9 @@ Trunk / storage-only 协议冒烟使用 **`scripts/git_protocol_smoke_storage_on
 
 产品 **API 写 → Git 可见性** 另用 **`scripts/api_write_smoke_storage_only.sh`**（`curl` + `git`；同样禁止 `libra` 客户端）：
 
+> 作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [plan-20261001](plan/plan-20261001.md)。
+
+
 ```bash
 TOKEN='mega2-storage-only-local-dev-token-0001'
 docker compose -p mega2-trunk -f docker/docker-compose-storage-only.yml --profile smoke \

docs/plan/plan-20260904.md

@@ -141,6 +141,7 @@
 - GC-AW-02：不打开 SSH receive-pack / Cedar enforce。
 - GC-AW-03：API 写不得绕过 MonoWriteQueue 更新 tip。
 - GC-AW-04：协议/API 黑盒测试工具链禁止 `libra` 客户端（仓发布除外）。
+  - 作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [`plan-20261001.md`](plan-20261001.md)。
 - GC-AW-05：场景/功能卡 VER 不得以 IT 顶替 compose 黑盒（AW-04）；也不得以 compose 顶替 IT（AW-03）。
 
 ## 执行检查必备需求（强制）

docs/plan/plan-20260906.md

@@ -225,6 +225,7 @@
      ```
      注释中说明「仓 VCS ≠ 测试客户端 / 不用 libra 作协议客户端」允许保留；不得以注释豁免上述命令形式的调用。
 - **Alternatives:** 用 Libra 客户端测 mega2 兼容性 — **拒绝**（本计划目标是 Git 协议面黑盒，不是 Libra↔mega2 互通）。
+- **作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [`plan-20261001.md`](plan-20261001.md)。**
 
 ### ADR-SO-10: 测试结束后如何获取输出结果
 

docs/plan/plan-20260917.md

@@ -282,6 +282,7 @@
 - **GC-LB-02:** 不得引入 Git delete command 或 `apply_changes` 作为产品写路径。
 - **GC-LB-03:** 一次用户操作 = 一次 commit；禁止先递归 `GET /tree` 再循环删文件。
 - **GC-LB-04:** 协议/API 黑盒禁止用 `libra` 当 HTTP/Git 客户端。
+  - 作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [`plan-20261001.md`](plan-20261001.md)。
 - **GC-LB-05:** 缺失表面未挂载前，OpenAPI/文档不得写成已交付。
 
 ## 执行检查必备需求（强制）

docs/plan/plan-20260918.md

@@ -195,6 +195,7 @@
 - **GC-FT-02:** 不得引入 Git delete command 或 `apply_changes` 作为产品写路径。
 - **GC-FT-03:** 一次用户操作 = 一次 commit；禁止先递归 `GET /tree` 再循环删文件。
 - **GC-FT-04:** 协议/API 黑盒禁止用 `libra` 当 HTTP/Git 客户端。
+  - 作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [`plan-20261001.md`](plan-20261001.md)。
 - **GC-FT-05:** 契约页未翻 `implemented` 的表面，OpenAPI/文档不得写成已交付。
 - **GC-FT-06:** 禁止并行改 `docs/refactoring/directory-entry-api.md`。
 

docs/plan/plan-20261001.md

@@ -749,7 +749,7 @@
 ### Task BB-05: libra 作用域注记
 
 **Task type:** `docs`  
-**Lifecycle / Acceptance:** `pending` / （空）  
+**Lifecycle / Acceptance:** `in-progress` / `locally-accepted`（Codex R1 PASS；本地提交 `BB-05:`，随 BB-03 发布推送）  
 **Description:** 按 ADR-BB-03 在 plan-20260906 ADR-SO-09、plan-20260904 GC-AW-04、plan-20260917 GC-LB-04、plan-20260918 GC-FT-04、`docs/refactoring/test-infra.md`、`docs/deploy-trunk.md` 的 libra 禁令处加「作用域 = Git 协议 / API 写 smoke；Libra 互通 smoke 见 plan-20261001」注记，并用零命中守卫证明既有两个脚本仍无 libra 协议调用。唯一行为轴：libra 禁令的作用域表述。  
 **Out of scope:** 改既有脚本（永久非目标）；推翻 ADR-SO-09（永久非目标，ADR-BB-03）。  
 **Current evidence:**

docs/refactoring/test-infra.md

@@ -37,6 +37,7 @@ runner）必须先按本节登记并评审，**禁止绕规范直接改 `docker/
 - **边界：** **不**使用 `libra` 作协议客户端（本仓 VCS 与冒烟观察者正交）；
   **不**替代 `CARGO_BIN_EXE` 黑盒 IT；review/CL 冒烟仍用
   `scripts/git_protocol_smoke.sh`，勿在 trunk 上当作成功门。
+- 作用域注记（2026-10-02，plan-20261001 ADR-BB-03）：本条约束 Git 协议 smoke 与 API 写 smoke 的客户端；Libra↔mega2 互通黑盒（`scripts/libra_smoke_storage_only.sh`）以 libra 作被测客户端，见 [`../plan/plan-20261001.md`](../plan/plan-20261001.md)。
 - **API 写 → Git 可见性（plan-20260904）：** `scripts/api_write_smoke_storage_only.sh`
   （`curl` + `git`）可与协议 smoke 并列在同一 `git-smoke` 容器执行；运维入口见
   [`deploy-trunk.md`](../deploy-trunk.md)。该脚本独立于 plan-20260906 的 SO case