How j-mazz/sys-scan-graph works
Sys-Scan-Graph is a host security scanner with a standalone C++ scan path and an optional Python intelligence stage. The main workflow is scan → canonical JSON report → local analysis and enrichment → enriched report or analyst-facing outputs. Python’s pipeline imports the principal analysis stages; the CLI exposes analysis and reporting capabilities. README documentation supplies the cross-process handoff and capabilities not established by sampled implementation. Several scanner internals and UI connections are not shown, so those relationships are omitted.
Main entry points: pipeline.py Analysis pipeline · cli.py Agent CLI · main.cpp C++ scanner · llm.py Summary generation
Components 20
Host scanning
- C++ scanner
src/main.cpp - eBPF event probes
src/ebpf/process_exec.bpf.c - Canonical scan report
Intelligence pipeline
- Agent CLI
agent/sys_scan_agent/cli.py - Analysis pipeline
agent/sys_scan_agent/pipeline.py - Report loading
agent/sys_scan_agent/loader.py - Finding enrichment
agent/sys_scan_agent/enricher.py - Finding correlation
agent/sys_scan_agent/correlator.py - Finding reduction
agent/sys_scan_agent/reduction.py - Summary generation
agent/sys_scan_agent/llm.py
Analysis services
- Baseline comparison
agent/sys_scan_agent/baseline.py - Rules and gaps
agent/sys_scan_agent/rules.py - Security knowledge
agent/sys_scan_agent/knowledge.py - LLM providers
agent/sys_scan_agent/llm_provider.py - Data redaction
agent/sys_scan_agent/redaction.py - Agent configuration
agent/sys_scan_agent/config.py
Reports and operations
- HTML reporting
agent/sys_scan_agent/report_html.py - Metrics reporting
agent/sys_scan_agent/metrics_exporter.py
Other components
- Operator or pipeline
- Analysts and pipelines
Connections 19
- Operator or pipeline → C++ scanner: runs scan
README.md - C++ scanner → Canonical scan report: writes JSON
README.md - Canonical scan report → Agent CLI: analyzes report
README.md - Operator or pipeline → Agent CLI: runs analysis
README.md - Agent CLI → Analysis pipeline: dispatches analysis
agent/sys_scan_agent/cli.py - Analysis pipeline → Report loading: loads report
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Finding enrichment: enriches findings
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Finding correlation: correlates findings
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Finding reduction: reduces findings
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Baseline comparison: compares baseline
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Agent configuration: reads settings
agent/sys_scan_agent/pipeline.py - Analysis pipeline → Summary generation: generates summary
agent/sys_scan_agent/pipeline.py - Summary generation → Data redaction: uses redaction
agent/sys_scan_agent/llm.py - Agent CLI → Rules and gaps: loads rules
agent/sys_scan_agent/cli.py - Agent CLI → HTML reporting: creates HTML
agent/sys_scan_agent/cli.py - Agent CLI → Metrics reporting: exports metrics
agent/sys_scan_agent/cli.py - Summary generation → LLM providers: selects provider
agent/sys_scan_agent/llm_provider.py - Agent CLI → Analysts and pipelines: delivers outputs
README.md - C++ scanner → eBPF event probes