Decisions

Architecture Decision Records (ADRs). Tracks why we chose X over Y.

Format: Context → Decision → Consequences.

• 001 — Custom Protocol Over Pure Nostr
• 002 — Checkpoint Reconciliation
• 003 — Replaceable Event Merge
• 004 — DM Conversation State
• 005 — Storage Pact Layer
• 006 — Storage Pact Risk Mitigations
• 007 — Key Derivation Hierarchy
• 008 — Protocol Hardening
• 009 — Incentive Model
• 010 — Bitchat Integration
• 011 — Iroh Transport Integration
• 012 — xx Network Protocol Evaluation
• 013 — Capped Asymmetric Pacts
• 014 — Presence-Aware Reliability Scoring
• 015 — Renewal-by-Default Pacts + 4-State FSM
• 016 — Target-Based Pact Formation
• 017 — Three-Tier Retrieval; Gossip Optional
• 018 — Honest Security and Relay Framing
• 019 — Documentation Simplification (Cut/Defer/Merge)

ADRs 013–019 record the mechanism and documentation decisions that shape the current design, informed by the five adversarial reviews. ADR 019 notes which review recommendations were adopted, deferred, or declined.