Skip to content

Architecture Decisions Confirmation List [CONFIRM WITH DEVELOPER] ​

The following design decisions and operational assumptions were deduced from the codebase and should be confirmed by the primary engineer:

Item #TopicDeduced Design ChoiceLocation in CodebaseRationale to Confirm
C1Storage TieringDefaulting to in-memory MemoryStore with flat segment DiskStore fallback instead of Redis.src/cache/store.tsSelected to achieve true sub-millisecond lookups (< 0.1ms) without external network hops.
C2Coalescing PolicyIn-flight leader-follower stream fanout instead of queuing in Redis/RabbitMQ.src/proxy/coalesce.tsEliminates distributed locking overhead; maximizes local proxy throughput.
C3Purge StrategySynchronous purge for < 50 items; asynchronous worker queue for > 50 items.src/purge/api.ts:25Prevents event loop blocking during massive tenant or tag purge operations.
C4AIML Tier RoleTier A/B models strictly advisory; zero AI models placed on critical latency path.aiml/MODEL_CARD.mdEnsures strict deterministic RFC 9111 correctness and avoids latency jitter.
C5Compression CapBrotli compression level capped at 6 instead of 11.src/compression/codecs.tsBalances CPU consumption against byte savings during high-throughput edge proxying.