How santhoshjanan/veerabahu works
Veerabahu is a local human-in-the-loop DNS-domain enrichment sidecar: it observes resolved domains from Pi-hole or AdGuard Home, investigates them through reputation sources, and presents recommendations for human review. Approved domains appear in a blocklist the gatekeeper pulls; Veerabahu does not change gatekeeper rules. The graph preserves this workflow plus onboarding/settings, review and audit, live events, and persistence. Several links are documented in the README; unsampled implementation details are not inferred as direct calls.
Main entry points: drainer.ts Assessment drainer · repo.ts Application database · review.ts Review decisions · store.ts Encrypted settings
Components 24
Domain observation
- Ingestion scheduler
src/lib/server/ingestion/scheduler.ts - Gatekeeper adapters
src/lib/server/adapters/gatekeeper
Enrichment and assessment
- DNS enrichment
src/lib/server/enrichment/dns.ts - Assessment drainer
src/lib/server/governor/drainer.ts - Reputation sources
src/lib/server/reputation - Source rate state
src/lib/server/governor/rate-state.ts - Domain evaluation
src/lib/server/pipeline/evaluate.ts - Scoring
src/lib/server/scoring/score.ts
Human review
- Review interface
src/lib/components/ReviewEntry.svelte - Review endpoints
src/routes/api/review/[domain]/+server.ts - Review decisions
src/lib/server/pipeline/review.ts - Blocklist publisher
src/lib/server/publisher/blocklist.ts
Application services
- Local authentication
src/lib/server/auth.ts - Encrypted settings
src/lib/server/settings/store.ts - Runtime configuration
src/lib/server/config.ts - Application database
src/lib/server/db/repo.ts - Audit log
src/lib/server/audit/log.ts - Live event bus
src/lib/server/events.ts
Web experience
- Setup and settings
src/routes/setup/+page.server.ts - Event stream endpoint
src/routes/events/+server.ts - Domain and queue views
src/lib/server/pipeline/dashboard.ts
Other components
- Pi-hole / AdGuard
- Gatekeeper adlist pull
- Administrator
Connections 23
- Pi-hole / AdGuard → Gatekeeper adapters: serves domain data
README.md - Ingestion scheduler → Gatekeeper adapters: reads resolved domains
- Ingestion scheduler → Assessment drainer: schedules assessment
- Assessment drainer → Source rate state: checks call limits
src/lib/server/governor/drainer.ts - Assessment drainer → Application database: loads queued domains
src/lib/server/governor/drainer.ts - Assessment drainer → Reputation sources: requests assessments
src/lib/server/governor/drainer.ts - Assessment drainer → Domain evaluation: evaluates domain
src/lib/server/governor/drainer.ts - Domain evaluation → Scoring: uses scoring
src/lib/server/pipeline/evaluate.ts - Assessment drainer → Live event bus: publishes progress
src/lib/server/governor/drainer.ts - Review interface → Review endpoints: submits decision
src/lib/components/ReviewEntry.svelte - Review endpoints → Review decisions: dispatches decision
- Review decisions → Application database: records decision
src/lib/server/pipeline/review.ts - Review decisions → Audit log: appends audit entry
src/lib/server/pipeline/review.ts - Review decisions → Live event bus: publishes decision
src/lib/server/pipeline/review.ts - Blocklist publisher → Application database: reads approved domains
- Gatekeeper adlist pull → Blocklist publisher: pulls published list
README.md - Setup and settings → Encrypted settings: saves setup
src/routes/setup/+page.server.ts - Encrypted settings → Application database: stores settings and secrets
src/lib/server/settings/store.ts - Encrypted settings → Runtime configuration: loads runtime config
src/lib/server/settings/store.ts - Local authentication → Application database: stores sessions
src/lib/server/auth.ts - Administrator → Review interface: reviews recommendations
README.md - Event stream endpoint → Live event bus: streams updates
- Domain and queue views → Application database: reads domain summaries