Architecture Decision Records (ADRs)

This directory records decisions that are likely to be controversial later, or that we want to lock to avoid churn.

Format

Each ADR follows a consistent shape:

ADRs should be short, opinionated, and operational.

Hybrid (scroll-region + overlay redraw) with automatic strategy selection from terminal capabilities.

Reset+apply for v1; incremental SGR diffs deferred until terminal-model tests cover all edge cases.

Crossterm is the v1 backend, wrapped behind TerminalSession.

Windows supported with documented limitations — honest docs beat unstable half-support.

TerminalWriter is the single gate for UI, logs, and mode toggles.

Sanitize-by-default for all log paths; raw passthrough is opt-in.

Embedded host-agnostic core + first-class host bindings; no universal C ABI.

Introduce a backend boundary at the runtime; enable WASM without threads or blocking.

FrankenTerm’s first-party WebGPU renderer with atlas-based glyph caching and patch-driven updates.

Asupersync only at orchestration seams — runtime shell + doctor_frankentui.

The four-layer pipeline these ADRs operate on.

Key non-negotiables that feed into the ADRs.