1  # ADR-0002 — Start With HTML Fragment Patches
 2  
 3  Date: 2026-05-07
 4  
 5  Status: Proposed
 6  
 7  ## Context
 8  
 9  A precise structural DOM diff is desirable but not required to validate the runtime model.
10  
11  ## Decision
12  
13  Start with full-fragment replacement and a patch instruction that carries HTML. Add structural patches after lifecycle, transport, and ack semantics are stable.
14  
15  ## Consequences
16  
17  Easier:
18  
19  - faster proof of concept
20  - simpler browser runtime
21  - simpler test fixtures
22  
23  Harder:
24  
25  - larger patch payloads
26  - less efficient UI updates
27  - more client-side DOM churn
28  
29  ## Alternatives considered
30  
31  - implement structural diff first
32  - use a third-party morphing library first
33  - require a virtual DOM representation in core