Share
## https://sploitus.com/exploit?id=1D940885-262E-5384-8817-131B4DFEDE9E
# VulnPilot
VulnPilot is an automation framework for vulnerability disclosure workflows. It coordinates target scouting, environment deployment, code audit, reproduction, report generation, disclosure-route selection, optional Notion synchronization, and final vendor submission.
The project was extracted from an OpenClaw-based local workflow. This repository contains only source code, tests, templates, and documentation. Runtime state, logs, reports, evidence archives, browser profiles, credentials, and real disclosure material are intentionally excluded.
## Components
- `scripts/vuln_pipeline.py` - main state machine.
- `tools/mcp/target_scout_runner.py` - GitHub and HackerOne backed target scouting.
- `tools/mcp/hackerone_*.py` - local HackerOne MCP client/server/wrapper layer.
- `tools/mcp/github_*.py` - GitHub MCP helper and repository intelligence wrappers.
- `scripts/vuln_reprove.py` - reproduction executor.
- `scripts/disclosure_route.py` - disclosure route resolver.
- `scripts/notion_vuln_sync.py` - optional Notion synchronization.
- `scripts/proton_send_mail.py` - optional Proton Mail UI automation through OpenClaw browser control.
- `scripts/vuln_pipeline_queue_guard.py`, `scripts/watchdog_runtime_monitor.py`, and the retired `scripts/task_watchdog.py` compatibility entrypoint - guard and runtime monitor scripts.
- `runtime_logging.py` - structured runtime logging helper.
## Workflow
The default pipeline stages are:
```text
PRE_CLEAN -> DEPLOY -> HEALTHCHECK -> AUDIT -> REPROVE -> MARKET_REVIEW
-> NOTION_SYNC -> MARKET_SUBMISSION_PREP -> DISCLOSURE_ROUTE -> REPORT
-> WAIT_MAIL_APPROVAL -> SEND_MAIL -> DONE
```
Self-iteration and recovery stages are also present for repairing stalled pipeline work.
## Setup
Use Python 3.10 or newer.
```bash
git clone git@github.com:lalalala5678/VulnPilot.git
cd VulnPilot
python3 -m unittest discover -s tests
```
Copy `.env.example` or export only the variables required for the integrations you use:
```bash
export VULNPILOT_WORKSPACE="$PWD"
export OPENAI_API_KEY="..."
export HACKERONE_API_USERNAME="..."
export HACKERONE_API_TOKEN="..."
export GITHUB_PERSONAL_ACCESS_TOKEN="..."
```
The Python code itself uses only the standard library. Optional integrations expect local tools such as `codex`, `git`, `gh`, `mcporter`, `node`, OpenClaw, and macOS `launchctl`.
## Basic Commands
Initialize local pipeline state:
```bash
python3 scripts/vuln_pipeline.py init
```
Run target scouting:
```bash
bash scripts/run_latest_target_scout.sh
```
Start a pipeline run for a selected repository:
```bash
python3 scripts/vuln_pipeline.py approve-deploy owner/repo
```
Advance one pipeline tick:
```bash
python3 scripts/vuln_pipeline.py tick
```
Inspect status:
```bash
python3 scripts/vuln_pipeline.py status
```
## Sensitive Data Policy
Do not commit local runtime data. The repository ignores:
- `state/`
- `reports/`
- `exports/`
- `output/`
- `targets/`
- `memory/`
- `.openclaw/`
- `.playwright-cli/`
- credentials, browser profiles, logs, screenshots, archives, and temporary files
Before pushing changes, run tests and a secret scan over the repository.
## Documentation
- Pipeline details: `docs/VULN_PIPELINE.md`
- GitHub MCP skill: `skills/github-mcp/`
- HackerOne MCP skill: `skills/hackerone-mcp/`