PJR-TC43 executor / reporterパイプラインのE2E検証と文書化を行う
1. 概要
従来フローとの後方互換、ローカルLLM構成、クラウドagent構成、失敗・再開経路をテストし、設定例と運用手順を文書化する。
2. 完了条件
- 従来の単一エージェントフローと新しい pipeline フローの E2E テストが成功する。
- Gemma を executor と reporter の両方に使うローカル LLM 構成を検証できる。
- Codex または Claude を executor に使う構成でも、共通の reporter と result 生成経路を利用できる。
- executor、reporter、result 検証の各失敗と、ステージ単位の再開を E2E テストで確認できる。
- strategy、member、CLI、ログと evidence の運用例が利用者向け文書へ反映される。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 従来フローの回帰テストを追加する | ARC | done | pipeline 未指定 phase で単一 agent が plan を受け取り result を記入する |
| 2 | ローカル LLM 構成の E2E テストを追加する | ARC | done | 同一 provider の executor / reporter を stage 要件だけで自動選択 |
| 3 | クラウド executor 構成の E2E テストを追加する | ARC | done | expert executor は別 provider、reporter と result 生成は共通経路 |
| 4 | 失敗、block、resume の E2E テストを追加する | ARC | done | executor 失敗・reporter 失敗・形式不正・blocked と reporter 単独再開 |
| 5 | 設定例、運用、復旧手順を文書化する | ARC | done | 設定ガイドへ構成例とログ引き渡し方針、運用ガイドへ stage 別の復旧手順 |
4. 対応結果
tests/src/exec-pipeline-e2e.test.tsを追加し、実 git リポジトリのフィクスチャに対してexec run/exec resumeを CLI 経由で実行する E2E を 9 件用意した。agent は provider のcommand_templateから起動されるテスト用スクリプトで、nickname ごとの振る舞い（成功・失敗・形式不正・blocked）を切り替える。- 従来フローの回帰では、
agent_pipelineを持たない phase で単一 agent が plan をそのまま受け取り、agent 自身が result を記入し、evidence や pipeline state を作らないことを固定した。stage role 付き agent が従来フローの候補へ混入しないことも、--executor-byに従来 agent を指定した場合の拒否とあわせて確認した。 - ローカル LLM 構成では、
stage_roleとproficiencyだけで executor / reporter が自動選択され、同一 provider のテンプレートが member 属性で展開されること、成果物更新・evidence 収集・reporter の構造化出力からの result 描画までが通ることを確認した。クラウド executor 構成では expert 要件が別 provider の executor を選び、reporter と result 生成は同じ経路を共有することを確認した。 - ログ引き渡しでは、reporter へ渡るのが plan と上限つき evidence とスキーマだけであり、executor の生ログ本文が渡らないこと、ログは run 単位のファイルに残り秘匿値が伏せ字化されることを確認した。
- 失敗経路では、executor 失敗時に reporter が起動しないこと、reporter の形式不正が executor を再実行せず reporter だけを 3 回試行して blocked になること、
outcome=blockedが result へ反映されることを確認した。worktree 経路では reporter 失敗の block イベントに stage checkpoint が残り、exec resume --taskが executor を再実行せず reporter だけを再開して完了することを確認した。 - exec設定ガイド に
executor / reporter pipeline の構成章を追加し、ローカル LLM 構成、クラウド executor 混在構成、evidence とログの引き渡し方針を記載した。exec運用ガイド にはexecutor / reporter pipelineの実行と復旧節を追加し、run 単位の記録の見方と stage 別の失敗・復旧手順を記載した。 - 検証は
npm run typecheck、npm run lint:ts、npm test（79 ファイル 1,050 件）、変更 Markdown のprettier/markdownlint、register build、catalog validate、index buildを実行した。