How vatshal27/backend works
SentinelAI is a security-analysis backend. Its main workflow accepts a project scan, runs static checks, enriches findings with optional LLM analysis, and can validate findings in a Docker sandbox before returning results. The graph also shows the separate runtime-discovery/check and sandbox-control API capabilities. Relationships are limited to the shown excerpts, SOURCE INDEX references, and README; unsampled implementation details are not inferred.
Main entry points: sandbox.js Sandbox orchestrator · server.js Express API · scanner.js Scan orchestrator · analyzer.js Finding analysis
Components 29
API orchestration
- Express API
server.js - Runtime checks
runtime.js
Static analysis
- Scan orchestrator
scanner/scanner.js - ESLint checks
scanner/eslint.js - Bandit checks
scanner/bandit.js - Semgrep checks
scanner/semgrep.js - File context
scanner/context.js - Finding normalization
scanner/normalize.js - Output sanitization
scanner/sanitizer.js - Security rules
scanner/rules - Docker static scan
docker-scanner.js
AI analysis
- Finding analysis
llm/analyzer.js - Prompt builder
llm/prompt-builder.js - Ollama client
llm/ollama.js - Finding parser
llm/parser.js - Finding filters
llm/filters.js
Docker validation
- Sandbox orchestrator
docker/sandbox.js - Docker client
docker/client.js - Sandbox config
docker/config.js - Attack planner
docker/planner.js - Synthetic target
docker/target.js - Attack runner
docker/runner.js - Evidence capture
docker/evidence.js - Finding validators
docker/validator.js - Tool validators
docker/validators - Sandbox report
docker/report.js
Other components
- API client
- Ollama service
- Docker daemon
Connections 26
- API client → Express API: sends requests
README.md - Express API → Scan orchestrator: runs scans
scanner/scanner.js - Scan orchestrator → ESLint checks: dispatches checks
scanner/scanner.js - Scan orchestrator → Bandit checks: dispatches checks
scanner/scanner.js - Scan orchestrator → Semgrep checks: dispatches checks
scanner/scanner.js - Scan orchestrator → Finding normalization: normalizes findings
scanner/scanner.js - Finding normalization → File context: gets context
scanner/normalize.js - Express API → Docker static scan: uses scanner
server.js - Express API → Finding analysis: requests analysis
server.js - Finding analysis → Prompt builder: builds prompts
llm/analyzer.js - Finding analysis → Ollama client: requests completions
llm/analyzer.js - Finding analysis → Finding parser: parses findings
llm/analyzer.js - Finding analysis → Finding filters: filters findings
llm/analyzer.js - Ollama client → Ollama service: sends requests
- Express API → Runtime checks: checks runtime
server.js - Express API → Sandbox orchestrator: runs sandbox
server.js - Sandbox orchestrator → Docker client: manages containers
docker/sandbox.js - Sandbox orchestrator → Sandbox config: uses settings
docker/sandbox.js - Sandbox orchestrator → Attack planner: plans attacks
docker/sandbox.js - Sandbox orchestrator → Synthetic target: creates target
docker/sandbox.js - Sandbox orchestrator → Attack runner: runs attacks
docker/sandbox.js - Sandbox orchestrator → Evidence capture: uses evidence
docker/sandbox.js - Sandbox orchestrator → Finding validators: validates findings
docker/sandbox.js - Sandbox orchestrator → Sandbox report: builds report
docker/sandbox.js - Finding validators → Tool validators: uses tool validators
- Docker client → Docker daemon: controls containers
docker/client.js