Architecture Decision Records¶ ADRs capture significant design decisions and their rationale. # ADR Status 0001 Architecture - Store, Registry, Backends Accepted 0002 Configuration Resolution - No Merging Accepted 0003 fsspec Is an Implementation Detail Accepted 0004 Empty Path Semantics in Store Accepted 0005 Bidirectional Path Resolution via to_key Accepted 0006 Documentation Architecture - Source of Truth and Audiences Accepted 0007 Three-Tier Documentation Architecture with docs-src/ and Literate Nav Accepted 0008 Extension Namespace Contract (ext.*) Accepted 0009 Glob - Three-Tier Design Accepted 0010 Observe - Proxy Subclass Pattern Accepted 0011 Retry - Per-Backend Native Configuration Accepted 0012 Async Store / Backend API — Hybrid Model Accepted 0013 Drop Optional-Extension Re-exports from __init__.py Accepted 0014 Middleware Architecture — Path 1 (ProxyStore + Stream Wrappers) Accepted 0015 Document ProxyStore in the Public API Reference Accepted 0016 Seekable Read — Three-Tier Design Accepted 0017 Seekable Read on Store API Accepted 0018 SQLAlchemy Backend — Two-Class Architecture with Shared Base Accepted 0019 Multi-Agent Orchestration Architecture Accepted 0020 Orchestrate Iterative Convergence Model Accepted 0021 Microsoft Graph SDK Choice — httpx + msal Accepted 0022 Microsoft Graph Auth Model — Dual Flows Behind a Token-Provider Protocol Accepted 0023 Async Monitor-URL Polling as a Shared Backend-Local Module Accepted 0024 ResourceLocked Error Type Accepted 0025 Async-to-Sync Backend Adapter (AsyncBackendSyncAdapter) Accepted 0026 Strict-Gate Pattern for Optional Capability Kwargs Accepted 0027 Single Bridge with Enforcement, Not Layered Mechanisms Accepted 0028 Testing Architecture with Kind and Stage Axes and HTTP Replay Demotion Accepted