What problem does it solve?
Provides a structured, evidence-first workflow to investigate GitHub repositories for supply-chain compromise, recover deleted commits and artifacts, and produce a verifiable forensic report suitable for defensive disclosure and remediation.
Core Features & Use Cases
- 7-phase investigation framework: prompt parsing and IOC extraction, parallel evidence collection, consolidation, hypothesis formation, validation, and final reporting.
- Multi-source evidence collection: local git analysis, GitHub REST API, GH Archive (BigQuery), Wayback Machine snapshots, and IOC enrichment.
- Built-in integrity tooling: JSON evidence store with SHA-256 integrity checks, templated forensic reports, and explicit chain-of-custody recording.
- Anti-hallucination guardrails & ethics: evidence-first citation rules, strict role boundaries for sub-agents, secret redaction, and responsible disclosure guidance.
- Use Case: recover a force-pushed malicious commit, validate its provenance via GH Archive and API cross-checks, and produce a pinned, verifiable remediation report.
Quick Start
Run a full supply-chain investigation for owner/repo and generate an evidence-backed forensic report.