How supercheck-io/supercheck works
Supercheck combines browser/API and k6 test automation, synthetic monitoring, incident communication, and AI-assisted SRE. The principal test workflow is: users configure jobs in the web app; the app schedules work through Redis/BullMQ; location-aware workers run isolated workloads; results and artifacts are surfaced for review. Other major branches include monitor checks and alerts, public status pages, and evidence-based SRE investigations. The README documents deployment and storage relationships; sampled source confirms selected SRE client behavior and requirement coverage updates, but not the full API or worker wiring.
Main entry points: api Application API · investigate/route.ts SRE investigation · src Location workers · monitors/route.ts Synthetic monitors
Components 21
Web application
- Web interface
app/src/app/(main)/page.tsx - Application API
app/src/app/api - Access and governance
app/src/app/api/organizations/route.ts
Test execution
- Test jobs
app/src/app/api/jobs/route.ts - Location workers
worker/src - Isolated execution
- Coverage snapshots
worker/src/execution/services/requirement-coverage.service.ts - Run artifacts
app/src/app/api/test-results/[...path]/route.ts
Monitoring and status
- Synthetic monitors
app/src/app/api/monitors/route.ts - Alerts and notifications
app/src/actions/send-incident-notifications.ts - Public status pages
app/src/app/api/status-pages/route.ts
AI SRE
- SRE investigation
app/src/app/api/sre/investigate/route.ts - Evidence graph
app/src/actions/sre-evidence-graph.ts - Read-only connectors
app/src/lib/sre/connectors/policy-engine.ts - SRE incidents
app/src/app/api/sre/incidents/route.ts
Platform state
- Work queue
- PostgreSQL
- S3 artifact storage
Other components
- Users / CI
- Configured integrations
- Kubernetes / gVisor
Connections 24
- Users / CI → Web interface: use
- Web interface → Application API: request
- Application API → Access and governance: authorize
- Application API → PostgreSQL: read / write
- Application API → Test jobs: manage jobs
- Test jobs → Work queue: schedule
- Work queue → Location workers: dispatch
- Location workers → Kubernetes / gVisor: launch workloads
- Location workers → Run artifacts: produce results
- Run artifacts → S3 artifact storage: store
- Location workers → Coverage snapshots: update coverage
- Coverage snapshots → PostgreSQL: write snapshots
- Application API → Synthetic monitors: manage checks
- Synthetic monitors → Work queue: schedule checks
- Synthetic monitors → Alerts and notifications: trigger alerts
- Alerts and notifications → Configured integrations: notify
- Application API → Public status pages: manage pages
- Public status pages → Configured integrations: publish updates
- Application API → SRE investigation: investigate
- SRE investigation → Evidence graph: assemble evidence
- SRE investigation → SRE incidents: manage incidents
- SRE investigation → Read-only connectors: query under policy
- Read-only connectors → Configured integrations: read evidence
- SRE investigation → PostgreSQL: read platform data