PJR-DKD8 ローカル LLM につながらないとき reporter が切り替わらずに止まる
1. 課題内容
2026-10-20 06:33 に PJR-16S0 の reporter（gemma26-reporter）が、ホストの Ollama が止まっていたため Cannot connect to API で失敗し、--fallback-reporter-by claude-reporter を指定していたのに切り替わらずに waiting になった。切り替えは rate limit のときだけ働き、つながらないエラーは対象にしていない
2. 影響範囲
| 観点 | 影響 |
|---|---|
| スコープ | reporter の切り替えの判定（src/exec/run/agent.ts などの fallback の処理） |
| スケジュール | 中。ローカル LLM が止まっていると、executor が通った run も reporter の段で止まる |
| コスト | 人が reporter を替えて再開する手間 |
| 品質 | --fallback-reporter-by を指定しても切り替わらない |
| 関係者 | ローカル LLM を reporter に使う利用者、夜間の自動実行 |
3. 対応方針
| 項目 | 内容 |
|---|---|
| 原因 | 指名した agent の切り替え（BHMH）は rate limit のときだけ働き、つながらないエラー（Cannot connect to API・接続の拒否など）は対象にしていない |
| 対応策 | つながらないエラーも、切り替えの対象にする |
| 依存事項 | なし |
| 完了条件 | 下記の完了条件を満たす |
3.1. 完了条件
--fallback-reporter-by・--fallback-executor-byを指定した run で、agent がつながらないエラー（opencode のCannot connect to API、ECONNREFUSEDなど）で失敗した場合、指定した代わりの agent へ切り替える。--on-rate-limitの指定（wait・fallback・stop）との関係を決めて実装し、理由を result に書く。- つながらないエラーの文言は、provider の設定（
exec-defaults.yamlの provider ごとの検出の設定など）で持ち、rate limit の検出と同じ仕組みに寄せる。 - 切り替えたことをイベントと result に記録する（rate limit の切り替えと同じ形）。
- 単体テストで、つながらないエラーで代わりの reporter へ切り替わること、代わりを指定していなければ今までどおり失敗することを確かめる。
- 作業を終える前に、
npm run typecheck・npm run lint:ts・npm run test:unitを実行して通す。 - 親の検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）が通る。
- runner のコードを変えるため、統合の後に
exec run --registerを 1 回流して動作を確かめる（PJR-JSEY）。 - CHANGELOG の
## [0.4.1] - 未定の節に書く。公開済みの版の節は変えない。
4. 対応結果
- provider ごとの
connection_error_detectionを追加し、終了コードと出力パターンによる検出を rate limit と共通の仕組みに寄せた。配布する OpenCode の初期設定ではCannot connect to API・ECONNREFUSED・connection refusedを接続不能として設定した。 - 接続不能時は
--on-rate-limitの指定と独立して、--fallback-executor-by/--fallback-reporter-byまたはrate_limit_policy.pinnedの対応する fallback agent へ1回だけ切り替える。fallback 未指定時は従来どおり agent の失敗として停止し、接続不能では同じ agent の再開待ちは行わない。 - 切替イベントには
trigger: connection_errorを記録し、既存の pipeline state・executor evidence・result の経路で切替元・切替先・時刻・原因を残すようにした。 - 単体テストへ、接続不能になった reporter が fallback reporter へ切り替わる場合と、fallback 未指定時に失敗のままとなる場合を追加した。共通検証は pipeline の親 runner が実行する。
- このリポジトリで稼働中の
.specdojo/exec-defaults.yamlは agent 書き換え禁止の保護設定であるため、統合後にホスト側で OpenCode のconnection_error_detectionを配布テンプレートと同じ値へ反映する。