How suvanshsehgal/sceptic works
Sceptic verifies submitted code through a web dashboard or CLI: projects and audit requests enter the backend, asynchronous audits fan out to independent verification agents, and synthesized findings and trust scores are stored and presented. The README also documents feature analysis and webhook-triggered PR audits. The graph reflects those documented capabilities, but some links for unsampled modules are omitted or shown as unverified rather than inferred.
Main entry points: main.py FastAPI Backend · orchestrator.py Audit Orchestrator · celery_app.py Celery Worker · App.tsx Web Dashboard
Components 24
User Interfaces
- Web Dashboard
frontend/src/App.tsx - Audit and Project Views
frontend/src/components - Web Authentication
frontend/src/context/AuthContext.tsx - CLI
cli/main.py - Frontend API Client
frontend/src/api.ts
Backend and Data
- FastAPI Backend
backend/main.py - Backend Authentication
backend/auth.py - Feature Analysis
backend/feature_scoper.py - Audit and Project Models
backend/models.py - PostgreSQL
backend/database.py
Audit Pipeline
- Redis Task Queue
- Celery Worker
worker/celery_app.py - Audit Service
worker/audit_service.py - Audit Orchestrator
worker/orchestrator.py
Code Analysis
- Language Adapters
worker/languages - Universal Parser
worker/languages/universal_parser.py - Analysis Models
worker/languages/models.py - Fact Checker
worker/fact_checker.py - Blind Tester
worker/blind_tester.py - Security Guard
worker/security_guard.py
Findings and Reports
- Report Synthesizer
worker/synthesizer.py - Audit Findings
backend/models.py
Other components
- Engineer
- GitHub PR Event
Connections 29
- Engineer → Web Dashboard: uses
- Engineer → CLI: runs audits
- GitHub PR Event → FastAPI Backend: submits PR event
- Web Dashboard → Audit and Project Views: renders
frontend/src/App.tsx - Web Dashboard → Web Authentication: provides auth
frontend/src/App.tsx - Audit and Project Views → Frontend API Client: requests data
frontend/src/components/AuditDetailView.tsx - Web Authentication → FastAPI Backend: authenticates
frontend/src/context/AuthContext.tsx - Frontend API Client → FastAPI Backend: calls API
- CLI → Audit Service: runs audits
cli/main.py - CLI → FastAPI Backend: submits results
backend/main.py - FastAPI Backend → Backend Authentication: uses
backend/main.py - FastAPI Backend → Feature Analysis: scopes features
backend/main.py - FastAPI Backend → Audit and Project Models: queries and saves
backend/main.py - FastAPI Backend → PostgreSQL: opens sessions
backend/main.py - FastAPI Backend → Celery Worker: queues audit
backend/main.py - Celery Worker → Redis Task Queue: dispatches tasks
- Celery Worker → Audit Orchestrator: runs pipeline
worker/celery_app.py - Celery Worker → PostgreSQL: persists audit
worker/celery_app.py - Audit Service → Audit Orchestrator: runs pipeline
worker/audit_service.py - Audit Service → Language Adapters: discovers languages
worker/audit_service.py - Audit Orchestrator → Fact Checker: verifies APIs
worker/orchestrator.py - Audit Orchestrator → Blind Tester: tests specifications
worker/orchestrator.py - Audit Orchestrator → Security Guard: scans security
worker/orchestrator.py - Audit Orchestrator → Report Synthesizer: synthesizes findings
worker/orchestrator.py - Language Adapters → Universal Parser: parses code
worker/languages/python_adapter.py - Universal Parser → Analysis Models: builds models
worker/languages/universal_parser.py - Report Synthesizer → Audit Findings: produces findings
- FastAPI Backend → Audit Findings: stores results
backend/main.py - Audit and Project Views → Audit Findings: displays results