How lc-lly/ai-hot works
ai-hot aggregates public AI-related feeds, filters and scores items, triages them with a budgeted multi-stage AI layer, clusters related coverage, and matches configured monitoring topics for notifications. The primary user workflow is a dashboard request or scheduled/manual collection through source adapters and ingestion, followed by AI triage and topic matching; results appear in the feed and realtime updates. The README documents several subsystem relationships not visible in sampled implementation excerpts, so those edges cite the README; uncertain internal calls are omitted.
Main entry points: scheduler.ts Job scheduler · useDashboard.ts Dashboard state · ingest.ts Ingestion pipeline · db.ts SQLite database
Components 22
Collection and analysis
- Source adapters
server/src/sources - Ingestion pipeline
server/src/pipeline/ingest.ts - Heat and importance
server/src/score - Hotspot clustering
server/src/cluster
AI triage
- Layered AI triage
server/src/ai - AI client and budget
server/src/ai/client.ts
Scheduled work
- Job scheduler
server/src/jobs/scheduler.ts - Domain discovery
server/src/discover
Backend services
- HTTP routes
server/src/routes - SQLite database
server/src/db.ts - Topic matching
server/src/triage - Notifications
server/src/notify - External search
server/src/routes/search.ts - WebSocket broadcast
server/src/realtime/server.ts
Dashboard
- Dashboard app
web/src/App.tsx - Dashboard state
web/src/state/useDashboard.ts - Feed state
web/src/state/useFeed.ts - HTTP client
web/src/net/api.ts - Realtime client
web/src/net/useRealtime.ts - Feed and controls
web/src/components
Other components
- User
- Email and Web Push
Connections 25
- User → Dashboard app: uses
- Dashboard app → Dashboard state: composes
web/src/App.tsx - Dashboard app → Feed and controls: renders
web/src/App.tsx - Dashboard state → Feed state: uses
web/src/state/useDashboard.ts - Dashboard state → HTTP client: requests
web/src/state/useDashboard.ts - Feed state → HTTP client: fetches
web/src/state/useFeed.ts - Dashboard state → Realtime client: handles updates
web/src/state/useDashboard.ts - HTTP client → HTTP routes: calls
- HTTP routes → SQLite database: reads and writes
- Job scheduler → Source adapters: collects from
- Source adapters → Ingestion pipeline: supplies items
server/src/pipeline/ingest.ts - Ingestion pipeline → Heat and importance: calculates scores
server/src/pipeline/ingest.ts - Ingestion pipeline → SQLite database: persists items
server/src/pipeline/ingest.ts - Job scheduler → Ingestion pipeline: runs collection
- Job scheduler → Layered AI triage: runs triage
- Layered AI triage → AI client and budget: requests model
server/src/ai/authenticity.ts - AI client and budget → SQLite database: caches results
server/src/ai/client.ts - Layered AI triage → Topic matching: evaluates items
- Topic matching → Notifications: triggers alerts
- Notifications → Email and Web Push: sends through
- Job scheduler → Domain discovery: runs discovery
- HTTP routes → External search: routes search
server/src/app.ts - WebSocket broadcast → Dashboard state: streams updates
- Job scheduler → Hotspot clustering: clusters coverage
- Hotspot clustering → SQLite database: stores clusters