release-branch.yml 在 gh-pages 分支不存在时 bootstrap-fail (issue #3 Gap 3 / 独立)

[libz-renlab-ai]

release-branch.yml 在 gh-pages 分支不存在时 bootstrap-fail

现象

PR #2 合主分支后,release-branch.yml 首次端到端跑(commit 1c23fde)在 step 14「Publish latest.json to gh-pages」挂了:

+ git clone -q --branch gh-pages ...
fatal: Remote branch gh-pages not found in upstream origin
##[error]Process completed with exit code 128.

run 25905129718

根因

gh-pages 分支在本仓库从未被建过。release-branch.yml 假设它已存在,直接 git clone --branch gh-pages 来 update latest.json,不存在就 fail。

之前的 release runs(3cfbdb4 时也失败)说明这是一个长期存在的 bootstrap gap,只是 PR #2 之前没人盯过 release-branch 的成功率。

验证(本 PR 没引入这个 bug)

本 PR 在此 workflow 唯一改动是「在 publish job 开头加 early-exit 守门 + 给后续 12 个 step 加 if: steps.guard.outputs.skip != true」。守门本身工作正确(日志「latest.json 不存在(首次 release?) → 继续发布」),它说要继续 publish 是对的,挂在了下游不相关的 step 14。

修复方案

step 14 的 git clone --branch gh-pages 改成「先 fetch 试,失败则 orphan 建」:

TMPDIR=$(mktemp -d)
cd "$TMPDIR"
if git clone -q --depth=1 --branch gh-pages "https://x-access-token:${GH_TOKEN}@github.com/$GITHUB_REPOSITORY.git" .; then
  echo "gh-pages 已存在,fast-forward 写 latest.json"
else
  echo "gh-pages 不存在 → 初始化为 orphan"
  git clone -q --depth=1 "https://x-access-token:${GH_TOKEN}@github.com/$GITHUB_REPOSITORY.git" .
  git checkout --orphan gh-pages
  git rm -rf .
fi
# ... 后续 jq 写 latest.json + commit + push (已存在的逻辑)

或者更简单:在 release-branch.yml 单独加一个 prerequisite job「ensure-gh-pages-branch」,只在首次需要时跑。

优先级

• 影响:6h 自动 release 链路目前全部 fail;docs/WORKFLOW.md 第 8 步实际上没生效(虽然 cron + workflow_dispatch + 守门已落地,但每次跑都到不了 latest.json publish 这步)。
• 修复成本:5–10 行 bash,改 1 个 step。
• 建议作为下一个独立 PR(本类纯 CI fix 也是 PR fix(ci): ReproSpec.ci.skip —— 让 Windows-only / 手工预置类 spec 在 Ubuntu CI 上自报豁免 (closes #3) #4 解决 Gap 1 之后享受全自动合的好材料 —— 但 Gap 2 还没修,实际仍要 human-merge)。

关联

• PR feat: 端到端搭通 WORKFLOW.md —— 5 个 Plans + 2 个 Phase,25 commits #2 dogfood 后续 issue [follow-up] PR #2 dogfood 揭示两个预存问题:CI repro 豁免 + Matrix baseline pnpm test 失败 #3(Gap 1 = PR fix(ci): ReproSpec.ci.skip —— 让 Windows-only / 手工预置类 spec 在 Ubuntu CI 上自报豁免 (closes #3) #4 ; Gap 2 = pnpm test failures)
• 本 issue = Gap 3(独立模块,跟前两 Gap 没强依赖)

---

🤖 由 Claude Code 在 PR #2 合主分支后 release-branch.yml 首跑 dogfood 时发现

[libz-renlab-ai]

PR #6 merged in c758c5c(本仓库首个完全自动 squash-merge)。gh-pages bootstrap fix 已落 main,下一次 release-branch.yml 跑会真把 latest.json 推上 gh-pages。