How nealbridges/vulnhunter works
VulnHunter is an agentic source-code security auditing tool, with a separate fix/verification-support package and a local batch harness. The principal workflow is to configure and clone a target, run a harness skill scan, extract findings, then manage issues and adversarial verification; findings can also be audited and published. The README describes portable harness operation and planned sandboxed exploit validation and measured-impact PoCs, but the supplied tree does not expose the skill prompts or a sandbox runtime implementation. Edges reflect shown imports/references and documented capabilities; unsampled internals are not inferred.
Main entry points: __main__.py Agent CLI · runner.py Scan runner · issues.py Issue workflow · publish.py Report publishing
Components 28
Agent workflow
- Agent CLI
vulnhunter-agent/agent/__main__.py - Agent config
vulnhunter-agent/agent/config.py - Repository clone
vulnhunter-agent/agent/clone.py - Scan runner
vulnhunter-agent/agent/runner.py - Audit records
vulnhunter-agent/agent/audit.py - Audit extraction
vulnhunter-agent/agent/audit_extract.py - Issue workflow
vulnhunter-agent/agent/issues.py - Finding verification
vulnhunter-agent/agent/verify.py - Verification stages
vulnhunter-agent/agent/verify_extract.py
GitHub and model
- Repository metadata
vulnhunter-agent/agent/repo_properties.py - Model authentication
vulnhunter-agent/agent/auth.py - LLM client
vulnhunter-agent/agent/_llm.py - GitHub helpers
vulnhunter-agent/agent/_github.py - GitHub token client
vulnhunter-agent/agent/token_client.py - Report publishing
vulnhunter-agent/agent/publish.py
Local harness
- Batch benchmark runner
harness/local_harness/batch/run.py - Harness cloning
harness/local_harness/clone.py - Harness scan
harness/local_harness/scan.py - Harness configuration
harness/local_harness/config.py
Fix support
- Graph builder
vulnhunter-fix/vulnhunter_fix/graph/build.py - Graph configuration
vulnhunter-fix/vulnhunter_fix/graph/config.py - Fallback graph
vulnhunter-fix/vulnhunter_fix/graph/fallback.py - Graph queries
vulnhunter-fix/vulnhunter_fix/graph/query.py - Graph schema
vulnhunter-fix/vulnhunter_fix/graph/schema.py - Fix delivery
vulnhunter-fix/vulnhunter_fix/delivery.py
Other components
- Operator
- GitHub
- Model service
Connections 33
- Operator → Agent CLI: invokes
vulnhunter-agent/agent/__main__.py - Agent CLI → Agent config: loads
vulnhunter-agent/agent/__main__.py - Agent CLI → Repository clone: dispatches
vulnhunter-agent/agent/__main__.py - Agent CLI → Scan runner: dispatches
vulnhunter-agent/agent/__main__.py - Agent CLI → Issue workflow: dispatches
vulnhunter-agent/agent/__main__.py - Agent CLI → Finding verification: dispatches
vulnhunter-agent/agent/__main__.py - Agent CLI → Audit records: emits records
vulnhunter-agent/agent/__main__.py - Agent CLI → Repository metadata: resolves metadata
vulnhunter-agent/agent/__main__.py - Agent CLI → Report publishing: dispatches
vulnhunter-agent/agent/__main__.py - Agent CLI → GitHub token client: uses
vulnhunter-agent/agent/__main__.py - Scan runner → Model authentication: uses
vulnhunter-agent/agent/runner.py - Scan runner → Audit records: records scan
vulnhunter-agent/agent/runner.py - Scan runner → Audit extraction: uses
vulnhunter-agent/agent/runner.py - Scan runner → Model service: starts session
- Issue workflow → LLM client: uses
vulnhunter-agent/agent/issues.py - Issue workflow → GitHub helpers: uses
vulnhunter-agent/agent/issues.py - Issue workflow → GitHub token client: uses
vulnhunter-agent/agent/issues.py - Finding verification → Verification stages: uses
vulnhunter-agent/agent/verify.py - Finding verification → Audit records: records decisions
vulnhunter-agent/agent/verify.py - Repository metadata → GitHub token client: authenticates requests
vulnhunter-agent/agent/repo_properties.py - Repository metadata → GitHub: fetches properties
vulnhunter-agent/agent/repo_properties.py - Report publishing → GitHub helpers: uses
vulnhunter-agent/agent/publish.py - Report publishing → GitHub token client: uses
vulnhunter-agent/agent/publish.py - Report publishing → GitHub: publishes reports
vulnhunter-agent/agent/publish.py - Batch benchmark runner → Harness cloning: uses
harness/local_harness/batch/run.py - Batch benchmark runner → Harness scan: runs scans
harness/local_harness/batch/run.py - Batch benchmark runner → Harness configuration: loads settings
harness/local_harness/batch/run.py - Harness scan → Harness configuration: reads settings
harness/local_harness/scan.py - Graph builder → Graph configuration: uses
vulnhunter-fix/vulnhunter_fix/graph/build.py - Graph builder → Fallback graph: uses fallback
vulnhunter-fix/vulnhunter_fix/graph/build.py - Graph builder → Graph schema: builds document
vulnhunter-fix/vulnhunter_fix/graph/build.py - Graph queries → Fallback graph: queries fallback
vulnhunter-fix/vulnhunter_fix/graph/query.py - Graph queries → Graph schema: uses document
vulnhunter-fix/vulnhunter_fix/graph/query.py