How a3-n/xpfarm works
XPFarm is a web-based vulnerability scanner that coordinates discovery, network and web-asset analysis, and vulnerability lookup across wrapped security tools, with results managed through a database and web UI. Its separate Overlord capability supports AI-assisted binary and mobile analysis through specialized tools. The scan stages and major product branches follow the README architecture map; sampled source confirms selected Overlord tool-to-helper calls. Other source relationships were not inspected, so the graph omits unsupported internal call details.
Main entry points: manager.go Scan orchestration · r2analyze.ts Binary analysis tools · server.go Web UI and API · tool_instrument.ts Tool instrumentation
Components 31
Web application
- Web UI and API
internal/ui/server.go - Application startup
main.go
Scan engine
- Scan orchestration
internal/core/manager.go - Target resolution
internal/core/target.go - Nuclei scan planning
internal/core/nuclei_tags.go - Global search
internal/core/search.go - Template indexing
internal/core/template_indexer.go
Security modules
- Module registry
internal/modules/registry.go - Subdomain discovery
internal/modules/subfinder.go - Port and service scans
internal/modules/naabu.go - HTTP probing
internal/modules/httpx.go - Web asset analysis
internal/modules/gowitness.go - Technology detection
internal/modules/wappalyzer.go - Vulnerability scanning
internal/modules/nuclei.go - CVE lookup
internal/modules/cvemap.go
Data and alerts
- SQLite database
internal/database/db.go - Scan data models
internal/database/models.go - Scan notifications
internal/notifications
Overlord analysis
- Overlord API proxy
internal/overlord/overlord.go - Binary analysis tools
overlord/tools/r2analyze.ts - Binary triage
overlord/tools/r2triage.ts - APK analysis
overlord/tools/apk_analyze.ts - Frida runtime hooks
overlord/tools/frida_hook.ts - YARA scanning
overlord/tools/yarascan.ts - Radare2 sessions
overlord/tools/lib/r2session.ts - JSON extraction
overlord/tools/lib/json_utils.ts - Tool instrumentation
overlord/tools/lib/tool_instrument.ts - Overlord logging
overlord/tools/lib/logger.ts
Other components
- Security user
- OpenCode service
- External security tools
Connections 37
- Security user → Web UI and API: uses
- Web UI and API → Scan orchestration: starts scans
- Web UI and API → Global search: submits searches
- Application startup → SQLite database: initializes
- Application startup → Module registry: registers modules
- Application startup → Template indexing: indexes templates
- Application startup → Web UI and API: starts server
- Scan orchestration → Target resolution: resolves targets
- Scan orchestration → Subdomain discovery: discovers subdomains
- Scan orchestration → Port and service scans: scans ports
- Scan orchestration → HTTP probing: probes HTTP
- Scan orchestration → Web asset analysis: processes web assets
- Scan orchestration → Technology detection: detects technologies
- Scan orchestration → CVE lookup: looks up CVEs
- Scan orchestration → Nuclei scan planning: plans scans
- Scan orchestration → Vulnerability scanning: runs scans
- Module registry → External security tools: wraps tools
- Scan orchestration → SQLite database: stores scan data
- SQLite database → Scan data models: persists
- Web UI and API → Overlord API proxy: routes requests
- Overlord API proxy → OpenCode service: proxies API
- OpenCode service → Binary analysis tools: invokes tools
- OpenCode service → Binary triage: invokes tools
- OpenCode service → APK analysis: invokes tools
- OpenCode service → Frida runtime hooks: invokes tools
- OpenCode service → YARA scanning: invokes tools
- Binary analysis tools → Radare2 sessions: runs commands
overlord/tools/r2analyze.ts - Binary analysis tools → JSON extraction: extracts JSON
overlord/tools/r2analyze.ts - Binary analysis tools → Tool instrumentation: wraps execution
overlord/tools/r2analyze.ts - Binary analysis tools → Overlord logging: logs activity
overlord/tools/r2analyze.ts - Binary triage → Radare2 sessions: runs commands
overlord/tools/r2triage.ts - Binary triage → JSON extraction: extracts JSON
overlord/tools/r2triage.ts - Radare2 sessions → Overlord logging: logs sessions
overlord/tools/lib/r2session.ts - Tool instrumentation → Overlord logging: logs tool calls
overlord/tools/lib/tool_instrument.ts - APK analysis → Tool instrumentation: wraps execution
overlord/tools/apk_analyze.ts - Frida runtime hooks → Tool instrumentation: wraps execution
overlord/tools/frida_hook.ts - YARA scanning → Tool instrumentation: wraps execution
overlord/tools/yarascan.ts