How CommitCosmos
Maps Code to Stars
An engineering overview of our real-time telemetry pipeline, deterministic cosmic projection algorithms, and WebGL rendering layer.
1. Real-Time Telemetry & Webhooks
Whenever you push commits, merge pull requests, or deploy releases, GitHub transmits payload bursts via authenticated webhooks. Each request verifies against an HMAC-SHA256 signature secret (x-hub-signature-256) with idempotent deduplication.
2. Neon Serverless Postgres Engine
Backed by Neon Lakebase Postgres using Drizzle ORM. Commits, branches, and milestones are parsed and stored in relational schemas. A materializing SQL view (user_stats_view) pre-aggregates streaks and star totals for lightning-fast queries.
3. Deterministic Astronomical Projection
Commit hashes are mapped deterministically into spherical coordinates (Right Ascension & Declination). Active branches form concentric planetary orbital rings, while releases expand into glowing supernova remnant nebulae.
4. Least-Privilege Security
CommitCosmos never requests write access to your code repository. The GitHub OAuth scope is restricted strictly to read-only commit metadata and webhook creation. Access tokens are encrypted and retained strictly server-side.
Streak Constellation Synthesis
CommitCosmos tracks contiguous UTC calendar days of commit activity. When your streak passes threshold intervals (3, 7, 14, 30+ days), our geometry pipeline joins sequential commits with glowing gravitational filaments, christening custom constellations named after celestial figures.