fix(release): gh-pages bootstrap on first run (closes #5)

[libz-renlab-ai]

fix(release): gh-pages bootstrap on first run (closes #5)

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.

本仓库 gh-pages 分支从未建过(Matrix 是 baseline fork,bootstrap 阶段),release workflow 没处理这个 edge case。

修复(12 行 bash)

release-branch.yml step「Publish latest.json to gh-pages」:

- git clone --depth=1 --branch=gh-pages "$REPO_URL" "$REPO_DIR"
- cd "$REPO_DIR"
+ if git clone --depth=1 --branch=gh-pages "$REPO_URL" "$REPO_DIR" 2>/dev/null; then
+   echo "gh-pages 已存在 → 在其上 update latest.json"
+   cd "$REPO_DIR"
+ else
+   echo "gh-pages 不存在(首次)→ 初始化为 orphan branch"
+   rm -rf "$REPO_DIR"
+   git clone --depth=1 "$REPO_URL" "$REPO_DIR"
+   cd "$REPO_DIR"
+   git checkout --orphan gh-pages
+   git rm -rf . >/dev/null 2>&1 || true
+ fi

后续 git add latest.json + git commit + git push origin gh-pages 会把 latest.json 作为 orphan 首 commit 推上去,GitHub 自动建 gh-pages 分支。

预期 dogfood

本 PR 合后,下次任一触发(push main / 0 */6 * * * cron / workflow_dispatch):

1. 早退守门看 https://libz-renlab-ai.github.io/Matrix/latest.json —— 第一次会 404(gh-pages 还没建)→ skip=false,继续
2. publish 流程跑完到 step 14
3. clone gh-pages 失败 → 走 orphan 路径
4. push origin gh-pages → GitHub Pages 自动 enable & serve latest.json
5. 下次任一触发 → 早退守门成功命中(因为 SHA 已发布)→ skip=true → 后续 12 step 全 skip → workflow 总体 success

至此 docs/WORKFLOW.md 第 8 步「每 6 小时自动发一个 release」真正端到端可用。

测试状态

YAML 语法 OK。bash 改动小且独立 —— 没有单元测试,验证靠 dogfood:本 PR 一过 + merge,下一次 release-branch.yml 跑就能验证。

预期 verdict

• repro-pass ✅(全 spec 被 ci.skip 豁免,PR fix(ci): ReproSpec.ci.skip —— 让 Windows-only / 手工预置类 spec 在 Ubuntu CI 上自报豁免 (closes #3) #4 修)
• tests-and-merge-clean ❌(issue [follow-up] PR #2 dogfood 揭示两个预存问题:CI repro 豁免 + Matrix baseline pnpm test 失败 #3 Gap 2,21 个 Matrix baseline 预存失败,本 PR 不修)

→ verdict 仍 fail,仍需 human-merge —— 但这是 Gap 2 的锅,不是本 PR 的锅。

关联

• issue release-branch.yml 在 gh-pages 分支不存在时 bootstrap-fail (issue #3 Gap 3 / 独立) #5: release-branch.yml 在 gh-pages 分支不存在时 bootstrap-fail (issue #3 Gap 3 / 独立) #5
• PR feat: 端到端搭通 WORKFLOW.md —— 5 个 Plans + 2 个 Phase,25 commits #2 dogfood 揭示的第 3 个 gap(前 2 个:Gap 1 = PR fix(ci): ReproSpec.ci.skip —— 让 Windows-only / 手工预置类 spec 在 Ubuntu CI 上自报豁免 (closes #3) #4 已合,Gap 2 = 待开 PR)
• WORKFLOW.md 第 8 步

🤖 Generated with Claude Code

[github-actions]

✅ 远程评审 verdict: pass

commit e5004cb · workflow run · 2026-05-15T08:59:38Z

标准	结果	简述
repro-pass	✅	豁免 — all-specs-ci-skip: fixtures/repro-specs/hook-moment-block.ts (需 $TA_DEMO_STAGE 下 home-empty/home-loaded 两份知识库目录预置 + 录 GIF 仅 Win32 可行)
tests-and-merge-clean	✅	tests pass + tree clean

[github-actions]

🤖 远程 review 通过 → 已自动 squash 合并到 main(auto-merge.yml)。