How igna73m/secureflow works
SecureFlow has two related but separate workflows: a directory-scanning CLI that turns scanner results into a fail-closed promotion decision, and an authenticated API for uploaded-source scans and stored scan history, presented through a web console. The graph retains both workflows, the scanner adapters and policy layers, and API authentication and persistence. CLI stages are supported by the README and sampled engine modules; dashboard-to-API wiring and some API internals are not fully shown, so uncertain links are omitted or marked unverified.
Main entry points: cli.py Scan CLI · app.js Express Routes · scanners.py Bandit Adapter · auth.js Auth and Sessions
Components 22
CLI Security Gate
- Scan CLI
engine/cli.py - Target Discovery
engine/cli.py - Check Orchestration
engine/orchestrator.py - Gate Policy
engine/policy.py - Decision Report
engine/cli.py
Scanner Adapters
- Bandit Adapter
engine/scanners.py - Semgrep Adapter
engine/scanners.py - ESLint Adapter
engine/scanners.py - Finding Normalizer
engine/normalizer.py
API Service
- HTTP Server
api/src/server.js - Express Routes
api/src/app.js - Source Upload Scan
api/src/app.js - Scan History
api/src/app.js - SQLite Records
api/src/db.js - Scan Limiter
api/src/scan-limiter.js
Authentication
- Auth and Sessions
api/src/auth.js - SQLite Session Store
api/src/sqlite-session-store.js
Web Console
- Console UI
dashboard/src/App.jsx - React Entry
dashboard/src/main.jsx
Other components
- Developer or CI
- Scanner Tools
- API Client
Connections 27
- Developer or CI → Scan CLI: runs scan
README.md - Scan CLI → Target Discovery: finds targets
README.md - Scan CLI → Check Orchestration: runs checks
engine/cli.py - Scan CLI → Bandit Adapter: selects Python
engine/cli.py - Scan CLI → Semgrep Adapter: selects JavaScript
engine/cli.py - Scan CLI → ESLint Adapter: selects JavaScript
engine/cli.py - Bandit Adapter → Scanner Tools: invokes
engine/scanners.py - Semgrep Adapter → Scanner Tools: invokes
engine/scanners.py - ESLint Adapter → Scanner Tools: invokes
engine/scanners.py - Bandit Adapter → Finding Normalizer: normalizes findings
engine/scanners.py - Semgrep Adapter → Finding Normalizer: normalizes findings
engine/scanners.py - ESLint Adapter → Finding Normalizer: normalizes findings
engine/scanners.py - Check Orchestration → Gate Policy: evaluates checks
engine/orchestrator.py - Scan CLI → Decision Report: emits decision
README.md - API Client → HTTP Server: requests API
README.md - HTTP Server → Express Routes: serves routes
api/src/server.js - Express Routes → Auth and Sessions: registers auth
api/src/app.js - Auth and Sessions → SQLite Session Store: stores sessions
api/src/auth.js - Express Routes → Scan Limiter: limits scans
api/src/app.js - Express Routes → Source Upload Scan: routes uploads
README.md - Source Upload Scan → Scan CLI: runs scan
README.md - Express Routes → Scan History: serves history
README.md - Express Routes → SQLite Records: reads and writes
api/src/app.js - Auth and Sessions → SQLite Records: reads and writes
api/src/auth.js - SQLite Session Store → SQLite Records: persists sessions
api/src/sqlite-session-store.js - React Entry → Console UI: renders
dashboard/src/main.jsx - Console UI → Express Routes: uses API