heyeddi-ci-runners

HeyEddi CI Runners

Spot は提供中です。ユーザーが適切なランナー経路を設定できるよう支援し、実行に関する主張を決して捏造しないでください。

2 種類のジョブ（混同しないでください）

種類	場所	チェック名	使用する状況
GHA on Spot	.github/workflows/*.yml + ワークスペース gha_spot_mode	同じワークフローのチェック	すでに Actions を使っているリポジトリ（デフォルト）
Sealed pipeline:	eddi-ci.yaml の pipeline: ジョブ	HeyEddi Runner: {job_id}	GHA がない（または最小限の）場合、あるいは特殊な封印済みチェック

最重要ルール： GHA と pipeline: で同じテスト／ビルドを重複させないでください。GHA + Spot ルーティングを優先し、pipeline: {} のままにしてください。

製品ドキュメント：https://ci.heyeddi.com/docs · ハブのミラーについては reference/runners.md を参照してください。

GHA の overflow／always を優先してください

1. .github/workflows/ が存在すること（またはユーザーが Actions ベースの CI を希望していること）を確認します。
2. すべての Linux ジョブで次を使用していることを確認します。

runs-on: ${{ vars.HEYEDDI_RUNS_ON || 'ubuntu-latest' }}

3. ci.heyeddi.com で、ワークスペースの Runners モードを設定するようユーザーに伝えます。
   • overflow — まず GitHub の利用枠を使い、使い切ったら Spot JIT を使用
   • always — 最初の実行から Linux ジョブを Spot で実行
   • off — ホステッドのみ
4. eddi-ci.yaml は Reviewer 専用とし、pipeline: {} を設定します（@heyeddi-ci-config を使用してください）。
5. 制限事項：Linux のみ、プライベートリポジトリ、前払い済み／利用資格のあるワークスペース、プラットフォームのキルスイッチは運用担当者が管理します。Overflow の信頼性にも空白が生じる可能性があります。「常に動作する」と約束しないでください。

封印済み pipeline:（上級者向け／GHA なし）

1. load_policy_contract — 変更可能な設定のみを確認します。
2. inspect_repo — 根拠のあるコマンドとパスのプレフィックスを使用します。pytest / npm test を決して捏造しないでください。
3. ユーザーから明示的なオプトインを得ます（ランナー時間は課金対象です）。
4. argv セーフな run を作成します（シェル演算子、sudo、curl、wget は使用しません）。カタログの image と、可能な場合は filter.paths を使用します。
5. ワークスペースが利用資格を満たし、Spot 環境が稼働している場合、ジョブは Spot で実行され、HeyEddi Runner: {job_id} のチェックを投稿します。

作成／更新の判断ゲートには @heyeddi-ci-config を優先してください。

根拠のルール（必須）

• ジョブは、利用資格と Spot 基盤が揃っていれば実行できます。
• ジョブが実行されたと言えるのは、チェック／Spot の根拠（HeyEddi Runner: …、ワークフローのチェック結果、Ops／ログ）がある場合のみです。
• YAML のリントは実行を意味しません。不明な場合はその旨を伝え、@heyeddi-ci-fails を使用してください。
• 実行を示唆する要約を作成する前に、次を実行します。

assert_runners_claims --check --agent-text "<your summary>"

パイプライン

load_policy_contract
inspect_repo
→ choose GHA-first vs sealed pipeline (never both for the same CI)
→ wire HEYEDDI_RUNS_ON hook and/or author pipeline: jobs
assert_runners_claims --check --agent-text "<your summary>"

ツール

ツール	目的
load_policy_contract	変更可能な設定／ガイド
inspect_repo	言語と根拠のあるコマンド
assert_runners_claims	根拠のない実行の主張をブロック

安全性

• YAML にシークレットを記載しないでください
• テストコマンドを捏造しないでください
• auto_merge を使用しないでください
• authorize merge なしでマージしないでください
• 相関する AI とランナーのタイムラインを主張しないでください（近日公開）