Architecture Decision Records

Architecture Decision Records (ADRs) document significant design choices — what was decided, why, what alternatives were considered, and what the trade-offs are.

Active ADRs

• ADR-001: Single-crate vs Cargo workspace — why jackin' started as a single crate, the threshold that triggered workspace adoption, and the current workspace structure.
• ADR-002: Rust toolchain pinning and MSRV policy — how the toolchain is pinned via rust-toolchain.toml, the MSRV guarantee, and the edition = "2024" floor.
• ADR-003: Ratatui as the TUI rendering library — why ratatui over tui-rs, raw ANSI, or cursive, and how it is used across all three TUI surfaces.
• ADR-004: Capsule pane-body rendering mechanism — why the capsule renders pane bodies through a custom cell widget rather than tui-term.
• ADR-005: Capsule single render path — why every capsule frame is one Terminal::draw written by one ClientWriter inside ?2026 brackets, and how derived rendering replaced the repaint tiers.