How kimjune01/sweep works
Sweep is an autonomous, paced GitHub contribution pipeline for finding acknowledged bugs, producing and reviewing fixes, and submitting pull requests; it also offers maintainers an advisory quality gate. The principal flow is discovery, issue screening, investigation and fix, QA and adversarial review, attestation, submission, and paced delivery, with separate engagement and operator branches. Temporal supervises unattended actors; CLI commands provide operator views and controls. The graph follows the README and supplied excerpts; several subsystem links use documented behavior because their source was not sampled.
Main entry points: qa_actor.py QA actor · worker.py Worker · sift.py Issue discovery · submit.py PR submission
Components 24
Contribution pipeline
- Issue discovery
sweep/activities/sift.py - Investigation
sweep/activities/investigate_prep.py - Fix implementation
sweep/activities/skill_runner.py - QA actor
sweep/workflows/qa_actor.py - PR submission
sweep/activities/submit.py - Paced delivery
- PR engagement
sweep/activities/reinvestigate.py
Temporal supervision
- Worker
sweep/worker.py - Temporal
- PR classifier
sweep/activities/pr_state.py
Quality and evidence
- Test and review
sweep/activities/qa.py - Attestation gates
sweep/attestation_writer.py - Push verifier
sweep/_gate/verifier.py - Advisory quality gate
sweep/activities/qa.py
Operator surfaces
- Cockpit and lanes
sweep/cli/cockpit.py - Retro pager
sweep/cli/retro.py - Flag action bar
tui/main.go
State and observability
- Actor inboxes
sweep/inbox_state.py - Attestation records
sweep/attestations.py - Events and metrics
sweep/observe.py
Other components
- Contributor
- Maintainer
- Operator
- GitHub
Connections 29
- Contributor → GitHub: acknowledges bugs
- Worker → Temporal: connects to
- Temporal → Worker: dispatches tasks
- Worker → Issue discovery: registers activity
- Worker → QA actor: registers workflow
- Issue discovery → GitHub: searches issues
- Issue discovery → Investigation: routes candidates
- Investigation → Fix implementation: prepares work
- Fix implementation → QA actor: queues fix
- QA actor → Test and review: runs checks
- Test and review → Attestation gates: records evidence
- QA actor → PR submission: advances passing work
- PR submission → Push verifier: checks receipts
- PR submission → GitHub: opens pull request
- Paced delivery → GitHub: paces delivery
- PR classifier → Actor inboxes: routes PR work
- PR classifier → GitHub: classifies pull requests
- PR engagement → GitHub: updates existing PR
- Test and review → Attestation records: caches LLM calls
- Attestation gates → Attestation records: writes hashed receipts
- QA actor → Events and metrics: emits outcomes
- Operator → Cockpit and lanes: inspects status
- Cockpit and lanes → Actor inboxes: reads queues
- Operator → Retro pager: manages retros
- Retro pager → Events and metrics: reads events
- Operator → Flag action bar: sets flags
- Flag action bar → Temporal: influences actors
- Maintainer → Advisory quality gate: runs advisory checks
- Advisory quality gate → GitHub: checks proposed changes