How arvindiyu/manthan works
MANTHAN is a local-first application-security orchestration gateway: users submit repository, image, SBOM, or endpoint scans, then inspect normalized results and related security data through the UI, REST API, or MCP. Its core flow selects engines, dispatches configured scanner providers, and stores results; additional branches cover commit-centered quality gates and GitHub webhooks. The README documents capabilities beyond the sampled source, so those are represented at subsystem level where implementation details are unavailable; edges are limited to documented or excerpt-supported relationships.
Main entry points: main.js Gateway API · scan.js Scan Orchestrator · loader.js Config Loader · commit.js Commit Scan Flow
Components 25
Configuration
- Config Loader
gateway/config/loader.js - Environment Reader
gateway/config/env.js - YAML Parser
gateway/utils/yaml.js
Scanning
- Engine Selector
gateway/services/engine-selector.js - Scan Orchestrator
gateway/services/scan.js - Provider Registry
gateway/integrations/registry.js - Scanner Adapters
gateway/integrations/scanners/base-tool.js
Results and State
- SARIF Parser
gateway/integrations/sarif-parser.js - Finding Processing
gateway/services/finding-presenter.js - Finding Signatures
gateway/services/finding-signature.js - Vulnerability Triage
gateway/services/vulnerability-aggregator.js - Artifact Services
gateway/services/artifacts.js - Store Adapter
gateway/services/store/index.js - SQLite Repository
gateway/db/repository.js
Interfaces
- Gateway API
gateway/main.js - HTMX UI
gateway/ui/pages/dashboard.js - Page Layout
gateway/ui/layout.js - MCP Tools
mcp/tools/index.js
Events and Integrations
- Commit Scan Flow
gateway/services/commit.js - GitHub Webhook
gateway/services/github/webhook.js - Repository Cloner
gateway/services/github/repo-cloner.js - Quality Gates
gateway/services/commit.js
Other components
- User or IDE
- GitHub
- OSS Scanner CLIs
Connections 27
- User or IDE → Gateway API: submits requests
README.md - Gateway API → Config Loader: loads config
gateway/main.js - Config Loader → Environment Reader: reads settings
gateway/config/loader.js - Config Loader → YAML Parser: parses YAML
gateway/config/loader.js - Gateway API → Store Adapter: creates store
gateway/main.js - Gateway API → Engine Selector: selects engines
gateway/main.js - Engine Selector → Provider Registry: filters providers
gateway/services/engine-selector.js - Gateway API → Scan Orchestrator: starts scans
gateway/main.js - Scan Orchestrator → Provider Registry: dispatches scans
README.md - Provider Registry → Scanner Adapters: registers providers
gateway/integrations/registry.js - Scanner Adapters → OSS Scanner CLIs: runs subprocesses
README.md - Scan Orchestrator → SARIF Parser: normalizes reports
- Scan Orchestrator → Store Adapter: persists results
README.md - SARIF Parser → Finding Signatures: computes signatures
gateway/integrations/sarif-parser.js - Store Adapter → SQLite Repository: uses SQLite repository
gateway/services/store/index.js - Gateway API → Artifact Services: serves artifacts
gateway/main.js - Gateway API → HTMX UI: routes UI pages
gateway/main.js - HTMX UI → Page Layout: renders through
gateway/ui/pages/dashboard.js - User or IDE → MCP Tools: invokes tools
README.md - MCP Tools → Gateway API: calls scan API
README.md - GitHub → GitHub Webhook: sends events
README.md - GitHub Webhook → Commit Scan Flow: dispatches event
gateway/services/github/webhook.js - Commit Scan Flow → Quality Gates: produces decisions
README.md - Commit Scan Flow → Scan Orchestrator: runs scanners
README.md - Repository Cloner → Scan Orchestrator: provides workspace
- Gateway API → Vulnerability Triage: serves triage views
gateway/main.js - Gateway API → Finding Processing: presents findings
gateway/main.js