Documentation
Architecture, design decisions, contributor guides, and implementation plans rendered directly from the repository's canonical docs.
Browse documentation sections
design
Focused decisions for metadata, storage, and SQL paths.
guides
Contributor workflows, operations, CLI, and deployment guidance.
-
AGENT.md Requirements
-
CLI Standards
-
Code Comments
-
Commit Style — Conventional Commits (MANDATORY)
-
Development Workflow — Spec / Issue → Workspace → Local Commit → Verify → Review → Push → PR → Merge
-
Kubernetes reference deployment
-
Local Deploy Standards
-
Mise + GitHub CI Standards
-
Rust Code Style
-
What NOT To Do
overview
System architecture and project-wide documentation.
plans
Implementation plans that preserve the reasoning behind major changes.
-
ADBC and Flight interoperability plan
-
Append-operation GC throughput implementation plan
-
Async result streaming implementation plan
-
Async tenant fairness implementation plan
-
Async Tenant Resource Quotas Implementation Plan
-
Bounded Flight Discovery Implementation Plan
-
Bounded managed-object presigned read plan
-
Bounded Metasrv Shutdown Implementation Plan
-
Bounded Rust SDK batch insert plan
-
Bounded S3 multipart pipeline implementation plan
-
Bounded SDK schema cache implementation plan
-
Cancel-safe S3 uploads implementation plan
-
Cargo-chef Path Dependencies Implementation Plan
-
Catalog directory generation implementation plan
-
Catalog stale-while-revalidate implementation plan
-
Complete FILE SDK Experience Implementation Plan
-
Configurable Lance Retention Implementation Plan
-
Credentialless direct managed-reader plan
-
Credentialless managed read capabilities Implementation Plan
-
Durable Drop Tombstones — Implementation Plan
-
Durable PollFlightInfo async results
-
Durable SDK append recovery implementation plan
-
Dynamo prefix isolation implementation plan
-
Dynamo prefix metrics implementation plan
-
Encrypted statement tickets implementation plan
-
Fence Metasrv Publications Implementation Plan
-
Flight Schema Discovery Cache Implementation Plan
-
Flight Transport Security Implementation Plan
-
GC registry scan implementation plan
-
Graceful Flight Shutdown Implementation Plan
-
gRPC health readiness implementation plan
-
Historical Release Image Recipe Implementation Plan
-
Idempotent Stage Cleanup Race Implementation Plan
-
Immutable catalog generation implementation plan
-
Incremental Object Reference GC Implementation Plan
-
Kubernetes reference deployment implementation plan
-
Lake Marketing Site Implementation Plan
-
Lease-Fenced Mutations Implementation Plan
-
Managed Objects Implementation Plan
-
Managed Range Reads Implementation Plan
-
Managed S3 Protocol CI Implementation Plan
-
Managed Stage Discovery Implementation Plan
-
Manifest history cleanup implementation plan
-
Metadata Hardening and SQL-over-S3 Implementation Plan
-
Metasrv Append Admission Implementation Plan
-
O(1) external manifest latest pointer
-
Operation-fenced reference-stage lifetime plan
-
OTLP distributed tracing implementation plan
-
Paged Table Maintenance Implementation Plan
-
Per-tenant Query admission plan
-
Pinned Flight SQL statement snapshots
-
Prometheus runtime metrics implementation plan
-
Provider generation cache implementation plan
-
Query Admission Control Implementation Plan
-
Query Catalog Client Implementation Plan
-
Query Manifest Authority Isolation Plan
-
Query memory and spill budgets
-
Query-Mediated FILE Writes Implementation Plan
-
Restart-safe async query handles
-
Resumable S3 Managed Uploads Implementation Plan
-
Robot Training Lakehouse Direction Implementation Plan
-
S3 Managed Stage Implementation Plan
-
S3 multipart scale implementation plan
-
Server-Authoritative Table Placement Implementation Plan
-
Stream Direct SQL Results Implementation Plan
-
Stream Lance removal results
-
Streaming Integrity-Verified Object Read Implementation Plan
-
Structured server logging implementation plan
-
Tenant catalog and managed-object authorization plan