Behind jackin' — InternalsArchitecture Decision Records
Architecture Decision Records
Architectural decisions made during jackin' development, with context, rationale, and consequences.
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 theedition = "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::drawwritten by oneClientWriterinside?2026brackets, and how derived rendering replaced the repaint tiers.