How dhruvnavadiya0/security-signal-engine works
Security Signal Engine is a security-scanning and finding-prioritization platform. Its principal workflow accepts a local codebase or live URL through the CLI or REST API, dispatches scanners, normalizes and deduplicates findings, scores risk, enriches findings with an optional local LLM or deterministic fallback, and generates reports. The graph also preserves the documented evaluation, plugin, and URL-scanning capabilities. Edges follow the pipeline excerpt, source-index references, or README; unsampled internals are not treated as inspected.
Main entry points: pipeline.py Scan pipeline · url_scanner.py URL scanner · orchestrator.py Scanner orchestrator · cli.py CLI
Components 27
Entry points
- CLI
security-signal-engine/src/cli.py - REST API
security-signal-engine/src/api/main.py - Scan pipeline
security-signal-engine/src/pipeline.py - Configuration
security-signal-engine/src/config.py
Scanning
- Scanner orchestrator
security-signal-engine/src/scanners/orchestrator.py - Semgrep adapter
security-signal-engine/src/scanners/semgrep.py - URL scanner
security-signal-engine/src/scanners/url_scanner.py - Plugin manager
security-signal-engine/src/scanners/plugin_manager.py - Smart crawler
security-signal-engine/src/scanners/smart_crawler.py - Rate limiter
security-signal-engine/src/scanners/adaptive_rate_limiter.py - Traffic store
security-signal-engine/src/scanners/traffic_store.py - OAST detector
security-signal-engine/src/scanners/oast_detector.py
Finding analysis
- Finding schemas
security-signal-engine/src/models/schemas.py - Normalization
security-signal-engine/src/normalization/engine.py - False-positive filter
security-signal-engine/src/scanners/false_positive_filter.py - Deduplication
security-signal-engine/src/dedup/engine.py - Risk scoring
security-signal-engine/src/scoring/engine.py - OWASP evaluation
security-signal-engine/src/evaluation/owasp.py
Explanation
- LLM intelligence
security-signal-engine/src/llm/intelligence.py - Ollama client
security-signal-engine/src/llm/client.py - Deterministic fallback
security-signal-engine/src/llm/fallback.py
Reports
- CLI report
security-signal-engine/src/reports/cli_report.py - JSON report
security-signal-engine/src/reports/json_report.py - PDF report
security-signal-engine/src/reports/pdf_report.py - SARIF report
security-signal-engine/src/reports/sarif_report.py
Other components
- Security engineer
- Ollama service
Connections 30
- Security engineer → CLI: runs scan
- Security engineer → REST API: requests scan
- CLI → Scan pipeline: runs
security-signal-engine/src/cli.py - REST API → Scan pipeline: runs
security-signal-engine/src/api/main.py - CLI → Configuration: loads settings
security-signal-engine/src/cli.py - Scan pipeline → Configuration: builds configuration
security-signal-engine/src/pipeline.py - Scan pipeline → Scanner orchestrator: runs scanners
security-signal-engine/src/pipeline.py - Scanner orchestrator → Semgrep adapter: dispatches
security-signal-engine/src/scanners/orchestrator.py - Scanner orchestrator → URL scanner: dispatches
security-signal-engine/src/scanners/orchestrator.py - Scanner orchestrator → Plugin manager: loads plugins
security-signal-engine/src/scanners/orchestrator.py - URL scanner → Smart crawler: uses
security-signal-engine/src/scanners/url_scanner.py - URL scanner → Rate limiter: uses
security-signal-engine/src/scanners/url_scanner.py - URL scanner → Traffic store: uses
security-signal-engine/src/scanners/url_scanner.py - URL scanner → OAST detector: uses
security-signal-engine/src/scanners/url_scanner.py - Scan pipeline → False-positive filter: filters findings
security-signal-engine/src/pipeline.py - Scan pipeline → Normalization: normalizes
security-signal-engine/src/pipeline.py - Scan pipeline → Deduplication: deduplicates
security-signal-engine/src/pipeline.py - Scan pipeline → Risk scoring: scores risk
security-signal-engine/src/pipeline.py - Scan pipeline → LLM intelligence: enriches findings
security-signal-engine/src/pipeline.py - LLM intelligence → Ollama client: requests generation
security-signal-engine/src/llm/intelligence.py - LLM intelligence → Deterministic fallback: uses fallback
security-signal-engine/src/llm/intelligence.py - Ollama client → Ollama service: sends requests
security-signal-engine/src/llm/client.py - Scan pipeline → CLI report: generates report
- Scan pipeline → JSON report: generates report
- Scan pipeline → PDF report: generates PDF
security-signal-engine/src/pipeline.py - Scan pipeline → SARIF report: generates report
- REST API → PDF report: generates PDF
security-signal-engine/src/api/main.py - OWASP evaluation → Scan pipeline: evaluates scans
- Normalization → Finding schemas: creates findings
security-signal-engine/src/normalization/engine.py - Risk scoring → Finding schemas: scores findings
security-signal-engine/src/scoring/engine.py