Architecture Decision Records

All significant design decisions are recorded as ADRs. Each ADR captures context, the decision made, consequences, and alternatives considered.

• Mixed Geometry Storage And Execution
• Dual Precision Dispatch
• Null And Empty Geometry Contract
• Predicate And Overlay Robustness Strategy
• Device Residency And Transfer Visibility
• Per-Kernel Dispatch Crossover Policy
• Probe-First Adaptive Runtime
• Owned Geometry Buffer Schema
• Staged Fusion Strategy
• Staged Point Predicate Pipeline
• Staged Binary Predicate Refine Pipeline
• Spatial Query And Join Assembly
• Explicit CPU Fallback Events
• Staged Segment Intersection Primitives
• Rectangle Clip As First Constructive Fast Path
• Shared Overlay Reconstruction Plan
• Dissolve Grouped Union Pipeline
• Stroke Kernel Seam
• Compact Invalid Row Make Valid
• Public API Dispatch Boundary
• IO Support Matrix
• GeoArrow, GeoParquet, and WKB Bridges
• Hybrid File Format Adapters
• Staged GPU-Native IO Execution Model
• Zero-Copy GeoArrow Adoption
• GeoParquet Scan Engine
• Family-Specialized GeoArrow Codecs
• Staged WKB Bridge
• Staged GeoJSON Ingest
• Batch-First Shapefile Ingest
• Determinism And Reproducibility Policy
• ADR-0032: Point-in-Polygon GPU Utilization Diagnosis
• ADR-0033: GPU Primitive Dispatch Rules
• ADR-0034: CCCL make_* Pre-Compilation and Warmup Strategy
• ADR-0035: Geodesic Distance Kernel and CRS-Aware Dispatch
• Index-Array Boundary Attribute Model
• ADR-0037: GPU Voronoi Diagram Kernel
• ADR-0038: GPU Byte-Classification GeoJSON Parser