How jdx/mise-versions works
mise-versions publishes version catalogs for mise clients, while its Astro/Worker application provides a tool directory, analytics, and GitHub repository proxying. Scheduled Worker jobs dispatch updates and monitor GitHub-token health; analytics records and summarizes downloads and version activity. The graph includes documented static-data outputs and sampled runtime wiring. Several web routes and data integrations are represented at subsystem level because their implementations were not sampled; unsupported call paths are omitted.
Main entry points: token-observability.ts Token observability · index.ts Analytics composition · worker.ts Worker runtime · api Web API routes
Components 26
Version data
- Tool version files
scripts/generate-toml.js - Versions index
scripts/build-versions-index.js - GitHub version files
scripts/bake-github-versions.js
Web application
- Tool directory
web/src/components/ToolSearch.tsx - Web API routes
web/src/pages/api - Authentication
web/src/pages/api/auth - Favorites
src/favorites.ts
Usage analytics
- Analytics composition
src/analytics/index.ts - Download tracking
src/analytics/tracking.ts - Analytics rollups
src/analytics/rollups.ts - Analytics queries
src/analytics/trends.ts - Analytics schema
src/analytics/schema.ts - Analytics Engine
src/analytics/analytics-engine.ts
GitHub proxy
- GitHub proxy
web/src/lib/github/mirror.ts - Edge cache snippet
snippets/github-mirror-cache.js
Worker operations
- Worker runtime
src/worker.ts - Token observability
src/token-observability.ts - Token budget rules
src/token-budget.ts - Worker migrations
src/migrations.ts - Dead-token cleanup
src/dead-token-cleanup.ts - Update dispatch
src/workflow-dispatch.ts
Other components
- mise clients
- Cloudflare D1
- Analytics Engine dataset
- GitHub
- Resend
Connections 25
- mise clients → Tool version files: fetch versions
README.md - mise clients → Versions index: fetch index
README.md - mise clients → GitHub version files: fetch baked lists
README.md - Tool directory → Web API routes
- Web API routes → Authentication: routes auth
- Web API routes → Favorites: serves favorites
- Edge cache snippet → GitHub proxy: falls back
snippets/github-mirror-cache.js - GitHub proxy → GitHub: proxies requests
- Analytics composition → Download tracking: composes
src/analytics/index.ts - Analytics composition → Analytics rollups: composes
src/analytics/index.ts - Analytics composition → Analytics queries: composes
src/analytics/index.ts - Analytics composition → Cloudflare D1: accepts database
src/analytics/index.ts - Download tracking → Analytics Engine: writes events
src/analytics/tracking.ts - Analytics rollups → Analytics Engine: queries events
src/analytics/rollups.ts - Analytics rollups → Analytics schema: updates rollups
src/analytics/rollups.ts - Worker runtime → Worker migrations: runs migrations
src/worker.ts - Worker runtime → Dead-token cleanup: runs cleanup
src/worker.ts - Worker runtime → Token observability: runs monitoring
src/worker.ts - Worker runtime → Update dispatch: dispatches updates
src/worker.ts - Token observability → Token budget rules: checks budget
src/token-observability.ts - Token observability → Cloudflare D1: stores observations
- Token observability → GitHub: checks token quotas
- Token observability → Resend: sends alerts
README.md - Analytics schema → Cloudflare D1: defines tables
- Analytics Engine → Analytics Engine dataset: queries or writes
src/analytics/analytics-engine.ts