architectureAct I · Scope, Requirements & SDK Budgets
SDK Guarantees & Resource Envelope
Step 1 of 5
checklistFunctional & Non-Functional Requirements
Library Contract
extension
Pluggable Transport & Cache SPI: Expose minimal interfaces for NetworkTransport, MemoryCache, DiskCache, and Decoder so host apps inject their own stacks.
call_merge
Single-Flight Request Deduplication: Coalesce concurrent requests for the same normalized key into one upstream network fetch and fan out results to all waiters.
cancel
Lifecycle-Bound Cancellation & Generation-Tag Guard: Abort orphaned jobs when the last waiter detaches and reject stale recycled-cell paints via monotonic view generation tags.
aspect_ratio
Header-Only Bounds Decode & Subsampling: Read image dimensions without allocating pixel memory, compute power-of-2 sampleSize, and decode into pooled buffers.
sync
Cursor Pagination with Stale-While-Revalidate: Serve cached pages at 0ms while validating ETag / 304 Not Modified in the background under a single-flight page mutex.
bolt
Zero Reflection & Minimal Binary Size: Pure compile-time typed generics with no runtime reflection, keeping SDK initialization sub-millisecond and footprint tiny.
memorySDK & Device Budgets
4 Hard Ceilings
L1 Memory & Pool Cap
sd_storage
15–20%
Hard ceiling of app heap budget; trims 75% immediately on OS memory pressure signals.
Decode + L1 Hit
shutter_speed
< 12 ms
Keeps 60/120fps scrolling smooth with off-main subsampling and zero GC pauses.
Single-Flight Rate
call_merge
100%
Zero duplicate in-flight HTTP fetches for identical normalized cache keys.
Core SDK Footprint
inventory_2
< 50 KB
Zero heavy transitive dependencies; host app supplies network and disk adapters.
data_objectAct II · Public API Contract & Internal Cache Schema
Pluggable SPI Surface & Disk LRU Journal
Step 2 of 5
apiPublic SDK Contract (SPI & Request Builder)
Zero-Reflection SPI
table_chartCache Key Normalization & Disk LRU Journal (SQLite WAL)
Deterministic Key
hubAct III · Interactive 5-Node SDK Pipeline & Chaos Switchboard