How warden-osint/warden works
Warden is a passive-OSINT cyber-risk assessment platform. Users confirm company assets, enable public-data sources, and launch or schedule scans; the worker collects evidence, updates findings, computes versioned KRI scores, then supports alerts, reports, and optional SIEM delivery. The graph follows documented capabilities and worker call references in the source index. Many web pages and pipeline modules were not excerpted, so uncertain implementation links are omitted or marked unverified.
Main entry points: run-scan.ts Scan job · index.ts Queue worker · notify.ts Alert delivery · route.ts Scan API
Components 25
Web app
- Dashboard
apps/web/src/app/(dashboard)/page.tsx - Scan API
apps/web/src/app/api/scans/route.ts - Scan settings
apps/web/src/app/(dashboard)/settings/schedule/page.tsx - Findings
apps/web/src/app/(dashboard)/findings/page.tsx - Reports
apps/web/src/app/(dashboard)/reports/[id]/page.tsx - User administration
supabase/functions/manage-users/handler.ts
Scan processing
- Queue worker
apps/worker/src/index.ts - Scan job
apps/worker/src/jobs/run-scan.ts - OSINT collection
apps/worker/src/pipeline/collect.ts - Public sources
packages/collectors/src - Evidence persistence
apps/worker/src/pipeline/persist.ts
Analysis
- Finding resolution
apps/worker/src/pipeline/resolve.ts - KRI scoring
packages/scoring/src/index.ts - Risk analyzers
packages/risk-analysis/src
Notifications and reporting
- Alert evaluation
apps/worker/src/pipeline/alerts.ts - Alert delivery
apps/worker/src/pipeline/notify.ts - Email alerts
apps/worker/src/pipeline/email-alert.ts - Report generation
apps/worker/src/pipeline/report.ts - AI summary
packages/ai/src/client.ts - SIEM integration
apps/worker/src/pipeline/siem.ts
Shared services
- Supabase
apps/worker/src/supabase.ts
Other components
- Analyst
- OpenRouter
- SMTP service
- Splunk HEC
Connections 25
- Analyst → Dashboard: uses
README.md - Dashboard → Scan API: launches
- Scan settings → Scan API: schedules
- Scan API → Supabase: requests scan
- Queue worker → Supabase: polls queues
apps/worker/src/index.ts - Queue worker → Scan job: runs scan
apps/worker/src/index.ts - Scan job → OSINT collection: collects
apps/worker/src/jobs/run-scan.ts - OSINT collection → Public sources: queries sources
- Scan job → Evidence persistence: persists results
apps/worker/src/jobs/run-scan.ts - Scan job → Finding resolution: resolves findings
apps/worker/src/jobs/run-scan.ts - Scan job → KRI scoring: scores scan
apps/worker/src/jobs/run-scan.ts - Finding resolution → KRI scoring: precedes scoring
- Analyst → Findings: triages
README.md - Analyst → Reports: reviews
README.md - Analyst → User administration: manages users
README.md - Scan job → Alert evaluation: evaluates score
apps/worker/src/jobs/run-scan.ts - Queue worker → Alert delivery: delivers alerts
apps/worker/src/index.ts - Alert delivery → Email alerts: builds email
apps/worker/src/pipeline/notify.ts - Queue worker → Report generation: generates reports
apps/worker/src/index.ts - Report generation → AI summary: requests summary
apps/worker/src/pipeline/report.ts - AI summary → OpenRouter: calls API
packages/ai/src/client.ts - Queue worker → SIEM integration: delivers events
apps/worker/src/index.ts - SIEM integration → Splunk HEC: sends events
- Alert delivery → SMTP service: sends mail
- Risk analyzers → OSINT collection: analyzes evidence