From 063015706807cda3d14f8b1c6da36e0ca9d59431 Mon Sep 17 00:00:00 2001
From: john <cynell@139.com>
Date: Mon, 27 Jul 2026 23:42:18 +0800
Subject: [PATCH] docs: register portal canary backup branch

---
 docs/branch-disposition.md | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docs/branch-disposition.md b/docs/branch-disposition.md
index 0ec74e7..c98e54e 100644
--- a/docs/branch-disposition.md
+++ b/docs/branch-disposition.md
@@ -57,6 +57,45 @@
 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。
 - 后续开发必须从最新 `origin/main` 新建分支。
 
+## `codex/fix-portal-canary-backup-ssh`
+
+**状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。**
+
+审计日期：2026-07-27
+分支 HEAD：`7ba63a8`
+`origin/main` 对应提交：`7ba63a8`
+
+### 原始用途
+
+该分支用于修复 Portal canary 生产发布脚本在 103 完整备份阶段的 SSH 中断问题：
+
+- 将 103 full stable backup 与 persisted-data backup 拆到候选安装前的独立 SSH 步骤。
+- 保留 full/persisted 备份硬闸门，后续 canary 安装远程脚本只复核已生成备份的 sha、gzip 与 `.env` 内容。
+- 避免长 here-doc 发布脚本在大备份阶段被远端关闭连接后无法继续发布。
+
+### 已进入 `main` 的提交
+
+| 提交 | 内容 |
+|---|---|
+| `7ba63a8` | 拆分 Portal canary 发布前 103 备份步骤 |
+
+### 验证摘要
+
+本分支闭环前已通过：
+
+- `bash -n scripts/release-portal-canary-prod.sh`
+- `node scripts/build-portal-runtime.mjs`
+- `ALLOW_MAIN_RELEASE=1 bash scripts/release-portal-canary-prod.sh --dry-run --yes`
+- Portal production Gate：187/187 通过，report commit `7ba63a83b1b52add4536a9391e3f3ea7869e569f`
+- `ALLOW_MAIN_RELEASE=1 bash scripts/release-portal-canary-prod.sh --yes`
+
+### 最终处置
+
+- 保留本地分支名用于审计追溯。
+- 不要从该分支继续开发。
+- 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。
+- 后续开发必须从最新 `origin/main` 新建分支。
+
 ## `codex/product-quality-p0`
 
 **状态：禁止再次引用。功能已进入 `main`，该分支不是待合并开发分支。**