63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
|
---
|
||
|
|
kind: task
|
||
|
|
slug: pr-checks-recovery-panel
|
||
|
|
title: PR checks recovery panel in mission control
|
||
|
|
plan_slug: automation-foundation
|
||
|
|
epic_slug: forge-webhooks
|
||
|
|
status: draft
|
||
|
|
priority: P2
|
||
|
|
tenant_id: global
|
||
|
|
owner: unassigned
|
||
|
|
cursor_todo_id: null
|
||
|
|
updated_at: "2026-08-03"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Task summary
|
||
|
|
|
||
|
|
When a convoy is in `pr_review`, show linked PR CI status in mission control with classified failures and recovery actions (rerun jobs, link to repo setup).
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
**Benchmark:** Autensa v2.5.1 PR checks recovery panel — classify failures as retryable, repo setup, or external provider; offer rerun where forge API supports it.
|
||
|
|
|
||
|
|
### UI (convoy detail panel)
|
||
|
|
|
||
|
|
- PR link + check run list (name, status, conclusion)
|
||
|
|
- Failure classification badge per check
|
||
|
|
- Actions: **Rerun failed jobs** (GitHub Actions API), **Open repo setup** (Epic 3 follow-on task)
|
||
|
|
|
||
|
|
### Backend
|
||
|
|
|
||
|
|
- tRPC `convoys.getPrChecks` — workspace-scoped, uses forge adapter
|
||
|
|
- `convoys.rerunFailedChecks` — admin only; audit log in `convoy_events`
|
||
|
|
|
||
|
|
### Webhook integration
|
||
|
|
|
||
|
|
- CI `completed` webhook refreshes cached check status on convoy metadata
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
|
||
|
|
- [Task-forge-webhook-receiver](./Task-forge-webhook-receiver.md)
|
||
|
|
- [Task-repo-setup-preflight](../Epic-connected-repos/Task-repo-setup-preflight.md) (link target for setup failures)
|
||
|
|
|
||
|
|
## Subtasks
|
||
|
|
|
||
|
|
- [ ] Forge adapter: list check runs for PR
|
||
|
|
- [ ] Failure classifier (heuristics: permissions → setup, timeout → retryable, external → informational)
|
||
|
|
- [ ] Mission control PR checks section when status is `pr_review`
|
||
|
|
- [ ] Rerun action + event logging
|
||
|
|
|
||
|
|
## Estimation
|
||
|
|
|
||
|
|
M
|
||
|
|
|
||
|
|
## Acceptance criteria
|
||
|
|
|
||
|
|
- [ ] Failed lint CI shows retryable with working rerun (GitHub fixture or manual dogfood)
|
||
|
|
- [ ] Missing Actions permission links to repo setup tab with failing check highlighted
|
||
|
|
- [ ] No recovery action exposed without workspace admin role
|
||
|
|
|
||
|
|
## Links
|
||
|
|
|
||
|
|
- Epic: `./Epic-forge-webhooks.md`
|