GitHub issue から Project queue、agent PR、review、merge まで。

この最初の end-to-end example は、work item から観測可能な agent workflow までの意図した経路を、provider detail を Rainrail contract の後ろに保ったまま示します。

GitHub -> Project -> agent -> PR -> review -> mergesource bundle、queue、runtime、review event をまたぐ traceable な workflow です。

End-to-end path

1. GitHub issue

選ばれた issue は provider event になり、workflow code に raw GitHub payload を直接渡す代わりに Rainrail が正規化します。

1b. Manual / chat message

operator prompt や web chat message も独自の source adapter から入り、同じ neutral envelope shape を publish できます。

2. Project queue

queue provider が次の eligible issue を選び、starting lock を取り、closed issue やすでに running の work を dispatch path から外します。

3. Agent run

workflow plugin が runtime provider に agent run を依頼し、deterministic な issue、branch、session input を渡します。

4. Pull request

agent は implementation branch を push し、issue への link と実行した check を記録した pull request を開きます。

5. Review

review event は neutral event として Rainrail に戻せるため、follow-up work も同じ workflow / provider boundary を使えます。

6. Merge

review と CI が通った後の merge は、event ingestion の暗黙の副作用ではなく、明示的な workflow capability gate の後ろに残します。

この example の背後にある contract

Example は意図的に implementation-neutral にしています。正確な event envelope、Project queue claim semantics、runtime capability gate は engineering specs に記録します。