How charpeni/bilan works
bilan turns GitHub pull-request metadata into contributor, area, review-flow, latency, and workload analytics. The CLI syncs repository history into a local cache and exports a standalone HTML report; the web app authenticates viewers, admits sync jobs, stores shared snapshots, and serves dashboards. The graph preserves those two result paths and the documented web access, example, and retention capabilities. Some web routes and storage implementations were not excerpted, so their internal call links are omitted where evidence is unavailable.
Main entry points: cli.ts CLI workflow · client.ts GitHub client · render.ts Dashboard renderer · engine.ts Sync engine
Components 29
GitHub ingestion
- Sync engine
packages/core/src/sync/engine.ts - GitHub client
packages/core/src/github/client.ts - PR queries
packages/core/src/github/query.ts - PR compaction
packages/core/src/github/compact.ts - Payload builder
packages/core/src/derive/payload.ts
Analytics
- Metric derivation
packages/core/src/metrics/derive.ts - Filtering and windows
packages/core/src/metrics/scope.ts - People and reviews
packages/core/src/metrics/people.ts - Summary brief
packages/core/src/metrics/brief.ts
CLI reporting
- CLI workflow
packages/cli/src/cli.ts - HTML report export
packages/cli/src/output.ts
Web product
- Sync workflow
packages/web/src/workflows/sync-repo.ts - Web API routes
packages/web/src/pages/api/repos/[owner]/[name]/sync.ts - OAuth and sessions
packages/web/src/lib/oauth.ts - Viewer access
packages/web/src/lib/access.ts - Dashboard renderer
packages/ui/src/render.ts - Charts and visuals
packages/ui/src/charts.ts - Static examples
packages/web/src/lib/examples.ts - Data retention
packages/web/src/lib/retention.ts - Cloudflare worker
packages/web/src/worker.ts
Persistence
- Sync store contract
packages/core/src/sync/store.ts - Local cache
packages/store-file/src/index.ts - D1 repository store
packages/store-d1/src/store.ts - D1 schema
packages/store-d1/src/schema.ts - Shared payloads
packages/web/src/workflows/sync-repo.ts
Other components
- CLI user
- Dashboard viewer
- GitHub API
- GitHub login
Connections 30
- CLI user → CLI workflow: runs
packages/cli/src/cli.ts - CLI workflow → GitHub client: creates
packages/cli/src/cli.ts - GitHub client → PR queries: executes
packages/core/src/github/client.ts - GitHub client → GitHub API: requests metadata
- CLI workflow → Sync engine: starts sync
packages/cli/src/cli.ts - Sync engine → GitHub client: fetches PRs
packages/core/src/sync/engine.ts - Sync engine → PR compaction: compacts results
packages/core/src/sync/engine.ts - Sync engine → Sync store contract: persists checkpoints
packages/core/src/sync/engine.ts - CLI workflow → Local cache: loads cache
packages/cli/src/cli.ts - CLI workflow → Payload builder: builds payload
packages/cli/src/cli.ts - Payload builder → Metric derivation: derives fields
packages/core/src/derive/payload.ts - CLI workflow → HTML report export: writes report
packages/cli/src/cli.ts - HTML report export → Dashboard renderer: embeds dashboard
- Metric derivation → Filtering and windows: feeds windows
packages/core/src/metrics/scope.ts - Filtering and windows → People and reviews: scopes people
packages/core/src/metrics/people.ts - Filtering and windows → Summary brief: scopes summary
packages/core/src/metrics/brief.ts - Dashboard renderer → Charts and visuals: renders charts
packages/ui/src/render.ts - Dashboard renderer → Metric derivation: computes views
packages/ui/src/render.ts - Dashboard viewer → OAuth and sessions: signs in
- OAuth and sessions → GitHub login: authorizes
README.md - Dashboard viewer → Web API routes: requests sync
- Web API routes → Sync workflow: admits job
- Sync workflow → GitHub client: syncs repository
packages/web/src/workflows/sync-repo.ts - Sync workflow → D1 repository store: stores metadata
packages/web/src/workflows/sync-repo.ts - D1 repository store → D1 schema: uses schema
- Sync workflow → Shared payloads: publishes snapshots
packages/web/src/workflows/sync-repo.ts - Dashboard viewer → Viewer access: checks permission
- Dashboard viewer → Dashboard renderer: views dashboard
README.md - Static examples → Dashboard renderer: provides snapshots
README.md - Cloudflare worker → Data retention: runs nightly
packages/web/src/worker.ts