How gotingalawrence-sys/vuln-triage-assistant works
The Vulnerability Triage Assistant accepts a vulnerability title or CVE ID and optional scanner notes, then returns a structured analysis with remediation guidance and ticket-ready text. The main flow runs from the browser through the triage API, validation, optional NVD grounding, AI generation and schema validation, then returns a result with an application-built advisory link. The README documents these capabilities; the sampled source confirms key calls, but some UI rendering and deployment details are only partially shown.
Main entry points: route.ts Triage API · triage.ts AI triage · page.tsx Triage UI · nvd.ts NVD lookup
Components 12
User interaction
- Triage UI
app/page.tsx
Request handling
- Triage API
app/api/triage/route.ts - Rate limiter
lib/rateLimit.ts - Input validation
lib/validation.ts
Triage analysis
- Prompt builder
lib/prompt.ts - AI triage
lib/triage.ts - Result schema
lib/schema.ts - Advisory link builder
lib/advisory.ts
External data and AI
- NVD lookup
lib/nvd.ts - NVD service
- Gemini API
Other components
- Security specialist
Connections 15
- Security specialist → Triage UI: submits input
README.md - Triage UI → Triage API: posts request
app/page.tsx - Triage API → Rate limiter: checks rate
app/api/triage/route.ts - Triage API → Input validation: validates input
app/api/triage/route.ts - Triage API → NVD lookup: looks up CVE
app/api/triage/route.ts - NVD lookup → NVD service: fetches CVE data
lib/nvd.ts - Triage API → AI triage: runs triage
app/api/triage/route.ts - AI triage → Prompt builder: builds prompt
lib/triage.ts - Prompt builder → NVD lookup: formats NVD facts
lib/prompt.ts - AI triage → Gemini API: generates analysis
lib/triage.ts - AI triage → Result schema: validates output
lib/triage.ts - Triage API → NVD lookup: applies CVSS severity
app/api/triage/route.ts - Triage API → Advisory link builder: builds advisory link
app/api/triage/route.ts - Triage API → Triage UI: returns result
README.md - Triage UI → Security specialist: shows guidance
README.md