Star7
0
代码
代码
Issues
Pull Requests
项目讨论
Wiki
分析
Star7
0
GGitHubfeat: add New Harness V2 host adapters
856f6128创建于 5月23日历史提交

Release Preflight

scripts/release-preflight.sh は、公開前に「今 release してよいか」を先に止めるための read-only チェックです。 vendor-neutral を前提にしているので、AWS 固定や特定の deploy 基盤に依存しません。

何を見るか

  • working tree が clean か
  • CHANGELOG.md に [Unreleased] があるか
  • .env.example と .env が大きくずれていないか。.env がない repo は warning に留め、managed secrets 前提の運用を止めすぎない
  • 既存の healthcheck / preflight コマンドが通るか
  • agents/ / core/ / hooks/ / scripts/ の shipped surface に mockData / dummy / localhost / TODO / FIXME などの残骸が残っていないかを警告する
  • tag 作成前に node scripts/build-opencode.js / node scripts/validate-opencode.js / bash scripts/sync-skill-mirrors.sh --check を実行し、opencode/, skills-codex/, codex/.codex/skills/ の mirror drift が 0 であるか
  • 取得できる場合は CI の最新状態が成功しているか

mirror drift gate は release tag 前の fail gate です。build-opencode.js が差分を生成した場合、preflight は失敗し、その差分を commit してから tag 作成へ進みます。

Actions runtime audit (2026-05-11): repo workflows use actions/checkout@v6; Node setup uses actions/setup-node@v6; Go setup uses actions/setup-go@v6. These v6 action lines run on the Node 24 action runtime and avoid the Node 20 deprecation warning.

使い方

scripts/release-preflight.sh
scripts/release-preflight.sh --root /path/to/other/repo

環境変数

  • HARNESS_RELEASE_PROJECT_ROOT: 別 repo を点検したいときの root
  • HARNESS_RELEASE_HEALTHCHECK_CMD: repo 固有の healthcheck コマンド
  • HARNESS_RELEASE_CI_STATUS_CMD: CI 状態確認を差し替えたいときのコマンド

dry-run との関係

/release --dry-run でも preflight は必ず通す。 dry-run は「公開操作をしない」という意味で、preflight は「公開してよい状態かを確認する」という意味。 両者は別物なので、dry-run でも preflight は省略しない。

GitHub Release workflow

.github/workflows/release.yml でも、GitHub Release の作成や既存 release への asset upload より前に bash ./scripts/release-preflight.sh --check-adapters を実行する。

tag-triggered workflow は detached HEAD で動くため、CI status が取得できない場合は warning boundary として扱う。release-ready の判断は、clean tree、mirror drift、adapter smoke、distribution archive gate などの preflight failure が 0 であることを前提にする。

tests/test-distribution-archive.sh は git archive HEAD から配布物の形を検証する。これは committed artifact の検証であり、dirty / untracked local files は含まれない。したがって、release claim の前には clean-tree preflight と組み合わせて使う。