aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
(orchestration): Track bypass events for automated review gates
- Vorherrschende Sprache
- TypeScript
- Sterne
- 143
- Forks
- 46
- Ø Merge
- 3 T. 10 Std.
- Gemergte PRs (30 T.)
- 24
Beschreibung
## Component
API or orchestration
## Describe the feature
When repos enable automated pre-human review, record **break-glass bypass** events when a human or policy override merges or advances a PR without automated approval. Feed counts into evaluation dashboards to tune reviewer strictness.
## Use case
Automated reviewers only improve if operators measure when humans **disagree** with them. Without bypass telemetry, teams over-tighten or under-tighten rules based on anecdotes.
## Proposed solution
1. GitHub webhook handler detects merge/approve without required check (when check integration exists) or manual CLI `bgagent review bypass --reason`.
2. Persist `review_bypass` events with reason, actor, finding IDs dismissed.
3. Surface in `bgagent stats` and roadmap analytics widgets.
## Other information
- Depends on **feature-pre-human-automated-review-gate** or customer branch protection wiring; can ship CLI-only bypass logging first.
- Privacy: store finding categories, not full diffs, in event payload.
## Acknowledgements
- [ ] I may be able to implement this feature
- [ ] This might be a breaking change
## Acceptance criteria
- [ ] Bypass events written to `TaskEvents` with structured schema.
- [ ] Operator can list bypasses per repo for a time window via API or CLI.
- [ ] Documentation explains how bypass rate should influence policy tuning.
- [ ] Tests cover webhook and CLI bypass paths.
Beitragsleitfaden
Rechercherichtung
Beginne mit dem GitHub-Webhook-Handler, dem manuellen bgagent-Befehl zum Umgehen der Überprüfung und dem in der Aufgabe erwähnten TaskEvents-Schema. Verfolge, wie Ereignisse die bgagent-Statistiken und Roadmap-Analyse-Widgets erreichen, und prüfe anschließend die vorhandenen Webhook- und CLI-Tests. Als abgeschlossen gilt die Arbeit, wenn strukturierte Umgehungsereignisse aufgezeichnet und nach Repository und Zeitfenster aufgelistet werden können, mit Abdeckung für beide Pfade und einer Dokumentation zur Richtlinienanpassung.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- github, typescript
- Bereich
- analytics, backend-api-design, cli, observability
- Issue-Typ
- Feature
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Ruhig
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 45/100