# darksilenxe/auto-bughunter architecture

> Architecture diagram of the GitHub repository darksilenxe/auto-bughunter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darksilenxe/auto-bughunter
- Repository: https://github.com/darksilenxe/auto-bughunter

## Overview

Auto Bughunter is a platform for authorized web-application security assessments. An operator configures and starts an asynchronous scan in the dashboard; shared frontend state tracks job status and live events while the backend coordinates reconnaissance, probing, and specialist agents. Findings are analyzed, triaged, correlated into attack paths, and presented for review or reporting. The README documents persistence, proxy workflows, AI providers, and knowledge retrieval. Some backend links are documented capabilities rather than inspected call sites, so those edges cite the README; optional or unverified wiring is omitted.

Main entry points: [`backend/internal/agent/orchestrator.go`](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/orchestrator.go) (Agent orchestration), [`frontend/src/context/ScanContext.jsx`](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/context/ScanContext.jsx) (Scan state), [`backend/internal/agent/analysis.go`](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/analysis.go) (Finding analysis), [`backend/internal/api/handlers.go`](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/api/handlers.go) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator interface"]
  node_dashboard["Scan dashboard<br/>[Dashboard.jsx]"]
  node_scanstate["Scan state<br/>[ScanContext.jsx]"]
  node_findingsui["Findings review<br/>[Findings.jsx]"]
  node_attackui["Attack graph<br/>[AttackGraph.jsx]"]
  node_proxyui["Proxy workspace<br/>[Proxy.jsx]"]
  node_reportsui["Report center<br/>[Reports.jsx]"]
end

subgraph group_scan["Assessment engine"]
  node_api["HTTP API<br/>[handlers.go]"]
  node_orchestrator["Agent orchestration<br/>[orchestrator.go]"]
  node_recon["Reconnaissance<br/>[reconnaissance.go]"]
  node_scanner["Security probes"]
  node_wordlist["Surface fuzzing<br/>[wordlist.go]"]
  node_proxy["Intercepting proxy<br/>[proxy.go]"]
end

subgraph group_analysis["Analysis and guidance"]
  node_analysis["Finding analysis<br/>[analysis.go]"]
  node_mltriage["ML triage<br/>[service.go]"]
  node_attackpaths["Attack path correlation<br/>[builder.go]"]
  node_ai["AI providers<br/>[client.go]"]
end

subgraph group_results["Results and persistence"]
  node_reporting["Report generation<br/>[reporting.go]"]
  node_postgres[("Scan persistence<br/>[postgres.go]")]
  node_neo4j[("Graph persistence<br/>[neo4j_store.go]")]
end

subgraph group_integrations["External services"]
  node_knowledge["Security knowledge<br/>[main.py]"]
  node_mlservice["ML triage service<br/>[main.py]"]
end

node_operator(("Security operator"))

node_operator -->|"configures scan"| node_dashboard
node_dashboard -->|"uses scan state"| node_scanstate
node_scanstate -.->|"submits scan"| node_api
node_api -->|"starts scan jobs"| node_orchestrator
node_orchestrator -->|"coordinates agents"| node_recon
node_orchestrator -->|"coordinates agents"| node_scanner
node_orchestrator -->|"coordinates agents"| node_wordlist
node_orchestrator -->|"coordinates agents"| node_analysis
node_analysis -->|"requests risk scoring"| node_mltriage
node_analysis -->|"correlates findings"| node_attackpaths
node_orchestrator -->|"uses AI planning"| node_ai
node_analysis -->|"retrieves guidance"| node_knowledge
node_analysis -->|"requests triage"| node_mlservice
node_orchestrator -->|"persists scans"| node_postgres
node_attackpaths -->|"persists graph"| node_neo4j
node_orchestrator -->|"generates reports"| node_reporting
node_scanstate -->|"supplies scan data"| node_findingsui
node_scanstate -->|"supplies scan data"| node_attackui
node_scanstate -->|"shares API settings"| node_proxyui
node_reporting -->|"provides reports"| node_reportsui
node_proxyui -.->|"uses proxy API"| node_proxy
node_proxy -.->|"serves proxy routes"| node_api

click node_dashboard "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Dashboard.jsx"
click node_scanstate "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/context/ScanContext.jsx"
click node_findingsui "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Findings.jsx"
click node_attackui "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/AttackGraph.jsx"
click node_proxyui "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Proxy.jsx"
click node_reportsui "https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Reports.jsx"
click node_api "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/api/handlers.go"
click node_orchestrator "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/orchestrator.go"
click node_recon "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/reconnaissance.go"
click node_scanner "https://github.com/darksilenxe/auto-bughunter/tree/main/backend/internal/scanner"
click node_wordlist "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/wordlist.go"
click node_proxy "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/proxy/proxy.go"
click node_analysis "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/analysis.go"
click node_mltriage "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/ml/service.go"
click node_attackpaths "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/attackgraph/builder.go"
click node_ai "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/ai/client.go"
click node_reporting "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/reporting.go"
click node_postgres "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/storage/postgres.go"
click node_neo4j "https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/graphdb/neo4j_store.go"
click node_knowledge "https://github.com/darksilenxe/auto-bughunter/blob/main/security-knowledge/app/main.py"
click node_mlservice "https://github.com/darksilenxe/auto-bughunter/blob/main/ml-service/app/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_scanstate,node_findingsui,node_attackui,node_proxyui,node_reportsui toneBlue
class node_api,node_orchestrator,node_recon,node_scanner,node_wordlist,node_proxy toneAmber
class node_analysis,node_mltriage,node_attackpaths,node_ai toneMint
class node_reporting,node_postgres,node_neo4j toneRose
class node_knowledge,node_mlservice,node_operator toneIndigo
```

## Components

### Operator interface

- [Scan dashboard](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Scan state](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/context/ScanContext.jsx): `frontend/src/context/ScanContext.jsx`
- [Findings review](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Findings.jsx): `frontend/src/pages/Findings.jsx`
- [Attack graph](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/AttackGraph.jsx): `frontend/src/pages/AttackGraph.jsx`
- [Proxy workspace](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Proxy.jsx): `frontend/src/pages/Proxy.jsx`
- [Report center](https://github.com/darksilenxe/auto-bughunter/blob/main/frontend/src/pages/Reports.jsx): `frontend/src/pages/Reports.jsx`

### Assessment engine

- [HTTP API](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/api/handlers.go): `backend/internal/api/handlers.go`
- [Agent orchestration](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/orchestrator.go): `backend/internal/agent/orchestrator.go`
- [Reconnaissance](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/reconnaissance.go): `backend/internal/agent/reconnaissance.go`
- [Security probes](https://github.com/darksilenxe/auto-bughunter/tree/main/backend/internal/scanner): `backend/internal/scanner`
- [Surface fuzzing](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/wordlist.go): `backend/internal/agent/wordlist.go`
- [Intercepting proxy](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/proxy/proxy.go): `backend/internal/proxy/proxy.go`

### Analysis and guidance

- [Finding analysis](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/analysis.go): `backend/internal/agent/analysis.go`
- [ML triage](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/ml/service.go): `backend/internal/ml/service.go`
- [Attack path correlation](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/attackgraph/builder.go): `backend/internal/attackgraph/builder.go`
- [AI providers](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/ai/client.go): `backend/internal/ai/client.go`

### Results and persistence

- [Report generation](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/agent/reporting.go): `backend/internal/agent/reporting.go`
- [Scan persistence](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/storage/postgres.go): `backend/internal/storage/postgres.go`
- [Graph persistence](https://github.com/darksilenxe/auto-bughunter/blob/main/backend/internal/graphdb/neo4j_store.go): `backend/internal/graphdb/neo4j_store.go`

### External services

- [Security knowledge](https://github.com/darksilenxe/auto-bughunter/blob/main/security-knowledge/app/main.py): `security-knowledge/app/main.py`
- [ML triage service](https://github.com/darksilenxe/auto-bughunter/blob/main/ml-service/app/main.py): `ml-service/app/main.py`

### Other components

- **Security operator**

## Connections

- Security operator → Scan dashboard: configures scan (evidence: `README.md`)
- Scan dashboard → Scan state: uses scan state (evidence: `frontend/src/pages/Dashboard.jsx`)
- Scan state → HTTP API: submits scan
- HTTP API → Agent orchestration: starts scan jobs (evidence: `README.md`)
- Agent orchestration → Reconnaissance: coordinates agents (evidence: `README.md`)
- Agent orchestration → Security probes: coordinates agents (evidence: `README.md`)
- Agent orchestration → Surface fuzzing: coordinates agents (evidence: `README.md`)
- Agent orchestration → Finding analysis: coordinates agents (evidence: `README.md`)
- Finding analysis → ML triage: requests risk scoring (evidence: `README.md`)
- Finding analysis → Attack path correlation: correlates findings (evidence: `README.md`)
- Agent orchestration → AI providers: uses AI planning (evidence: `README.md`)
- Finding analysis → Security knowledge: retrieves guidance (evidence: `README.md`)
- Finding analysis → ML triage service: requests triage (evidence: `README.md`)
- Agent orchestration → Scan persistence: persists scans (evidence: `README.md`)
- Attack path correlation → Graph persistence: persists graph (evidence: `README.md`)
- Agent orchestration → Report generation: generates reports (evidence: `README.md`)
- Scan state → Findings review: supplies scan data (evidence: `frontend/src/pages/Findings.jsx`)
- Scan state → Attack graph: supplies scan data (evidence: `frontend/src/pages/AttackGraph.jsx`)
- Scan state → Proxy workspace: shares API settings (evidence: `frontend/src/pages/Proxy.jsx`)
- Report generation → Report center: provides reports (evidence: `README.md`)
- Proxy workspace → Intercepting proxy: uses proxy API
- Intercepting proxy → HTTP API: serves proxy routes
