How ilyasmeziani2-hub/mavd-public-edition works
MAVD is a local SAST-triage product: a user starts an analysis through either the CLI or dashboard-backed launcher, which runs Semgrep, adds source context, obtains LLM qualification and (for confirmed findings) mitigation, then records evaluation, provenance and reports. The dashboard reads saved artifacts and presents analyses, findings, evaluation and reports. The README documents the linear pipeline; some backend orchestration and dashboard-to-API links are documented but their full implementation was not excerpted.
Main entry points: main.py CLI runner · launcher.py Local API runner · outputs Analysis artifacts · context.py Source context
Components 21
Entry points
- CLI runner
main.py - Local API runner
launcher.py
Analysis pipeline
- Semgrep scanner
scanner.py - Source context
context.py - Finding qualification
triage.py - Mitigation advice
mitigation.py - LLM client
llm_client.py
Results and reporting
- Metrics evaluation
evaluation.py - Run provenance
provenance.py - HTML report
report.py - Analysis artifacts
outputs
Dashboard
- Artifact access
web/lib/academic-data.ts - Artifact interpretation
web/lib/analysis-model.ts - Overview dashboard
web/app/page.tsx - Analysis views
web/app/analyses/[id]/page.tsx - Finding views
web/app/findings/page.tsx - Evaluation summary
web/components/analysis/evaluation-summary.tsx - Report views
web/app/reports/[id]/page.tsx - Workspace navigation
web/components/layout/sidebar.tsx
Other components
- Analyst
- LLM service
Connections 32
- Analyst → CLI runner: runs analysis
README.md - Analyst → Overview dashboard: views results
README.md - Overview dashboard → Local API runner: starts analysis
README.md - CLI runner → Semgrep scanner: runs scan
main.py - Local API runner → Semgrep scanner: runs scan
README.md - Semgrep scanner → Source context: provides findings
README.md - Source context → Finding qualification: provides source window
README.md - Finding qualification → LLM client: requests qualification
triage.py - Mitigation advice → LLM client: requests suggestion
mitigation.py - LLM client → LLM service: sends prompt
llm_client.py - Local API runner → Source context: extracts context
README.md - Local API runner → Finding qualification: qualifies findings
README.md - Local API runner → Mitigation advice: mitigates confirmed
README.md - CLI runner → Source context: extracts context
main.py - CLI runner → Finding qualification: qualifies findings
main.py - CLI runner → Mitigation advice: mitigates confirmed
main.py - Local API runner → Metrics evaluation: evaluates findings
README.md - Local API runner → Run provenance: records provenance
launcher.py - Local API runner → HTML report: generates report
README.md - CLI runner → Metrics evaluation: evaluates findings
main.py - CLI runner → Run provenance: records provenance
main.py - CLI runner → HTML report: generates report
main.py - Local API runner → Analysis artifacts: writes run artifacts
README.md - CLI runner → Analysis artifacts: writes run artifacts
main.py - HTML report → Analysis artifacts: saves HTML report
README.md - Artifact access → Analysis artifacts: reads saved artifacts
web/lib/academic-data.ts - Artifact access → Artifact interpretation: interprets artifacts
web/lib/academic-data.ts - Analysis artifacts → Overview dashboard: supplies analysis data
README.md - Analysis artifacts → Analysis views: supplies analysis data
README.md - Analysis artifacts → Finding views: supplies findings
README.md - Analysis artifacts → Evaluation summary: supplies evaluation
README.md - Analysis artifacts → Report views: supplies reports
README.md