aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

(orchestration): Track bypass events for automated review gates

Offen
#411 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement observability orchestration
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

Beitragsleitfaden öffnen

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

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.