How imdigitalashish/rubicon-poc works
rubicon-poc is a runnable, single-process proof of concept for GitHub’s Rubicon-style Git storage architecture. Its principal workflow creates Git objects and packs, routes pushes and fetches through Spokes to disposable replica caches, stores durable packs in Blob Storage, and commits ref and manifest changes through Ref-CAS. Background compaction leases shards, merges and verifies packs, publishes replacements, and retires old packs. The README documents these capabilities; unsampled modules are represented only where that documentation supports them.
Main entry points: cluster.rs Cluster assembly · spokes.rs Spokes routing · refcas.rs Ref-CAS transactions · replica.rs Replica push
Components 12
Client workflow
- Demo and bench
src/main.rs - Agent changes
src/agent.rs - Git objects and packs
src/object.rs
Replica serving
- Spokes routing
src/spokes.rs - Replica push
src/replica.rs - Replica fetch and cache
src/replica.rs
Durable storage
- Blob Storage
src/blob.rs - Ref-CAS transactions
src/refcas.rs - Quorum log nodes
src/refcas.rs
Background maintenance
- Compaction workers
src/compaction.rs
Runtime wiring
- Cluster assembly
src/cluster.rs
Other components
- Git client
Connections 20
- Git client → Spokes routing: pushes and fetches
README.md - Demo and bench → Cluster assembly: creates cluster
src/main.rs - Demo and bench → Agent changes: creates changes
src/main.rs - Demo and bench → Spokes routing: runs requests
src/main.rs - Agent changes → Git objects and packs: encodes pack
src/agent.rs - Spokes routing → Replica push: routes push
src/spokes.rs - Spokes routing → Replica fetch and cache: routes fetch
src/spokes.rs - Replica push → Git objects and packs: indexes pack
src/replica.rs - Replica push → Blob Storage: uploads pack
src/replica.rs - Replica push → Ref-CAS transactions: commits refs
src/replica.rs - Replica fetch and cache → Ref-CAS transactions: checks version
README.md - Replica fetch and cache → Blob Storage: pulls packs
src/replica.rs - Replica fetch and cache → Git objects and packs: opens packs
src/replica.rs - Ref-CAS transactions → Quorum log nodes: replicates appends
src/refcas.rs - Compaction workers → Blob Storage: leases and merges packs
src/compaction.rs - Compaction workers → Ref-CAS transactions: publishes and retires
src/compaction.rs - Cluster assembly → Blob Storage: constructs store
src/cluster.rs - Cluster assembly → Ref-CAS transactions: constructs log
src/cluster.rs - Cluster assembly → Spokes routing: assembles replicas
src/cluster.rs - Cluster assembly → Compaction workers: starts workers
src/cluster.rs