-
Notifications
You must be signed in to change notification settings - Fork 4
Add reactions framework reference page to docs site #470
Copy link
Copy link
Open
Labels
area:configWORKFLOW.md parsing, typed config, env resolution, validationWORKFLOW.md parsing, typed config, env resolution, validationarea:docs-sitedocs.sortie-ai.com content and infrastructuredocs.sortie-ai.com content and infrastructurearea:orchestratorDispatch, retry, reconciliation, state machine, poll loopDispatch, retry, reconciliation, state machine, poll loop
Metadata
Metadata
Assignees
Labels
area:configWORKFLOW.md parsing, typed config, env resolution, validationWORKFLOW.md parsing, typed config, env resolution, validationarea:docs-sitedocs.sortie-ai.com content and infrastructuredocs.sortie-ai.com content and infrastructurearea:orchestratorDispatch, retry, reconciliation, state machine, poll loopDispatch, retry, reconciliation, state machine, poll loop
Type
Projects
Status
Todo
Auto-merge lands as a new reaction kind in this milestone (#417). The docs site needs a reference page for the reactions framework that documents the existing
ci_failureandreview_commentsreactions already shipped in M17, and addsauto_mergeas the third entry.Scope: explain the shared reaction model (poll -> fingerprint -> deduplicate -> dispatch -> escalate) at a level that lets operators reason about retry budgets and escalation across all reaction kinds without reading the source. Document every field of
reactions.auto_merge(enabled,strategy,require_ci,delete_branch) with defaults, valid values, and safety behavior (Sortie-managed label check, draft PR exclusion). Include a full WORKFLOW.md snippet that opts in with conservative settings, and call out the irreversibility of the action. Back-fill reference entries forreactions.ci_failureandreactions.review_commentsin the same page since they currently live only in release notes.Depends on #417 (auto-merge implementation).
Verify: a new
reference/reactions.mdpage exists ondocs.sortie-ai.com, covers all three reaction kinds with field tables, and is linked from the reference index and the WORKFLOW.md reference page.