How carolenache/frontend-node-evolution-dashboard works
Evolution is a local frontend-platform and Node.js change dashboard. Its main workflow is scheduled source polling, source-specific change extraction, normalization and deduplication, optional local AI enrichment, persistence, then filtered timeline and worth-learning views. The graph includes documented capabilities such as conditional fetches, source coverage, cache revalidation, and the optional summary integrations. Some subsystem links rely on the README because their implementation files were not sampled.
Main entry points: run.ts Ingest runner · enrich.ts AI enrichment · sources Source adapters · dashboard.tsx Dashboard views
Components 22
Change collection
- Ingest scheduler
apps/worker/src/schedule.ts - Ingest runner
apps/worker/src/run.ts - Source adapters
packages/ingest/src/sources - Conditional fetch
packages/ingest/src/fetch-if-changed.ts
Entry processing
- Entry normalization
packages/ingest/src/normalise.ts - Entry deduplication
packages/ingest/src/dedupe.ts
Persistence
- Entry and source-state store
packages/db/src
Dashboard
- Timeline page
apps/web/src/app/page.tsx - Worth-learning page
apps/web/src/app/worth-learning/page.tsx - Dashboard views
apps/web/src/components/dashboard.tsx - Filter parsing
apps/web/src/lib/filters.ts - Entries JSON API
apps/web/src/app/api/entries/route.ts - Cache revalidation route
apps/web/src/app/api/revalidate/route.ts
Learning signals
- AI enrichment
packages/ai/src/enrich.ts - Embeddings and similarity
packages/ai/src - Gap classification
packages/ai/src/classify.ts - Summary providers
packages/ai/src - Worth-learning strategy
packages/shared-types/src/worth-learning.ts
Other components
- Public source feeds
- Skills profile
profile/skills.json - Dashboard user
- Web revalidation endpoint
Connections 25
- Ingest scheduler → Ingest runner: runs ingest
- Ingest runner → Source adapters: dispatches sources
- Source adapters → Conditional fetch: fetches conditionally
packages/ingest/src/sources/mdn-bcd.ts - Public source feeds → Source adapters: provides updates
- Source adapters → Entry normalization: normalizes drafts
packages/ingest/src/sources/mdn-bcd.ts - Source adapters → Entry deduplication: deduplicates entries
packages/ingest/src/sources/mdn-bcd.ts - Ingest runner → Entry and source-state store: stores entries and state
- Ingest runner → AI enrichment: enriches optionally
- AI enrichment → Embeddings and similarity: embeds and compares
packages/ai/src/enrich.ts - AI enrichment → Gap classification: classifies gaps
packages/ai/src/enrich.ts - AI enrichment → Summary providers: generates summaries
packages/ai/src/enrich.ts - AI enrichment → Skills profile: compares skills
- Ingest runner → Web revalidation endpoint: posts revalidation
- Web revalidation endpoint → Cache revalidation route: calls route
- Timeline page → Dashboard views: renders timeline
- Worth-learning page → Dashboard views: renders recommendations
- Dashboard views → Entry and source-state store: reads entries
- Dashboard views → Worth-learning strategy: selects worth learning
- Dashboard user → Timeline page: opens view
- Dashboard user → Worth-learning page: opens view
- Dashboard user → Entries JSON API: requests filtered data
- Entries JSON API → Filter parsing: parses query
apps/web/src/app/api/entries/route.ts - Entries JSON API → Entry and source-state store: queries entries
apps/web/src/app/api/entries/route.ts - Dashboard user → Dashboard views: sets filters
- Ingest runner → Entry and source-state store: reads source state