From zero lines of code to a published Rust crate. The granular story of how FrankenTUI was stitched together in a single intense engineering cycle.
The numbers behind the sprint. Every hour counted.
≈100.1h from sprint kickoff (2026-01-31) to publish (2026-02-05)
Split into focused crates for strict layering and clean boundaries
BOCPD, conformal, VOI, CUSUM, fairness guards, and more
Published 2026-02-05 (after the 100-hour sprint)
Selected milestones timestamped from the real commit history (2026-01-31 → 2026-02-05).
Architecture Plan Locked
Initial commit: FrankenTUI plan documents.
Upgraded plan to a hybrid architecture (V5.0 → V6.1).
Expanded the bead graph to cover core components, dependencies, and acceptance tests.
Reference Library Sync
Added a reference library sync script + build infrastructure.
Fixed idempotency and Makefile bugs in the sync tooling.
Seeded beads for syntax highlighting, forms/pickers, and other showcase surfaces.
Workspace Born
Initialized the Rust workspace with the `ftui` crate structure.
Added 15 comprehensive feature beads with 46 subtasks.
Added a comprehensive test bead graph for 15 new feature areas.
Terminal Session + Core Data Types
Added terminal session lifecycle, color downgrade, style system, and a TerminalModel.
Implemented the Buffer API and supporting infrastructure.
Implemented GraphemePool with reference counting; reinforced the one-writer rule.
Render Kernel Online
Implemented BufferDiff and Presenter (state-tracked ANSI emission).
Hardened inline mode safety and added comprehensive inline mode tests.
Added geometry primitives and the Flex layout solver; fixed build issues across the workspace.
Showcase Expansion + Correctness Blitz
Major expansion: demo showcase, PTY improvements, and documentation.
Broad correctness sweep: saturating arithmetic across widgets/drawing + overflow fixes.
Added ftui-render coverage for wide glyph handling and diff engine edge cases.
Benchmarks + Validation
Added DoubleBuffer swap benchmarks and repaired E2E scripts.
Introduced an async deadline controller (survival analysis) for budget enforcement.
Expanded action-timeline and visual-fx tests; synced multi-agent workspace changes.
Evidence Telemetry + Policy Controls
Added evidence structs and optimized diff buffer reuse in the runtime.
Added env-var controls for Bayesian diff, BOCPD, and conformal in the harness.
Optimized ANSI emission and extracted diff helpers; updated BOCPD evidence field docs.
Crates.io Publish Prep
Crates.io publish prep + crate docs (bd-3lul4).
Stabilized tests (flaky fixes, isolation, snapshot baselines).
Kept the project graph and issue tracker synced as publish tasks closed out.
Publish: v0.1.1
Published v0.1.1 crates (bd-17unx publish 0.1.1 crates).
Updated the changelog for the 0.1.1 publish.
Captured and shipped the initial public announcement artifacts.
Highlights reconstructed from real sprint artifacts: git history plus archived Claude Code + Codex CLI session logs (2026-01-31 → 2026-02-05).
Counted from archived session logs for /data/projects/frankentui (2026-01-31 → 2026-02-05)
Session files with cwd=/data/projects/frankentui across the 5-day window (2026-01-31 → 2026-02-05)
Commits in the FrankenTUI repo between 2026-01-31 and 2026-02-05 (inclusive)
Workspace Born
The sprint started by locking an architecture plan and scaffolding a multi-crate Rust workspace early, so every new capability had a clean home (core, render, runtime, widgets, harness).
Render Kernel Online
The deterministic render pipeline landed fast: BufferDiff + a state-tracked Presenter that emits ANSI deltas without hidden I/O or terminal desync.
Benchmarks + Validation
The focus shifted from raw feature throughput to budgets and verification: benchmarks, E2E scripts, and test expansions to keep high-velocity changes safe.
Beads Pages Export Debug
A report claimed `bv -pages` had deployed only a few "test" beads. Checking the exported bundle and deployed SQLite confirmed 266 issues were present; the apparent mismatch came from local, uncommitted beads not included in the export snapshot.
Evidence Telemetry + Policy Controls
Probabilistic pieces were made auditable: evidence structs, docs, and environment-driven policy controls for Bayesian diff, BOCPD resize coalescing, and conformal alerts.
Crates.io Publish Prep
Docs, metadata, and tests were hardened for a real release artifact. Publish tasks closed out in dependency order while the project graph stayed synced.
Publish: v0.1.1
The initial crate set shipped to crates.io and the changelog was updated immediately after publish, closing out the sprint with a concrete release.
Forensic visualization of the FrankenTUI spec corpus evolving over time, reconstructed from real git history and manually categorized.
Time-lapse diff explorer
Scrub through commits and inspect diffs, rendered markdown snapshots, and the evidence ledger for each categorized change-group.
- Stacked taxonomy bars (day/hour/15m/5m) with bucket legend and mobile-friendly bucket details.
- Timeline scrubber with keyboard navigation (←/→), search (/), and help (?).
- Diff viewer (unified + side-by-side), plus rendered markdown snapshot with responsive tables.
Origin Protocol
FrankenTUI’s spec corpus evolved extremely fast. This lab is the “forensics view”: it reconstructs what changed, when it changed, and why, so the project is auditable and easier to extend.
Selected, timestamped commit messages from the sprint (local tz).
Posts and commentary from the build — technical deep-dives, architectural rationale, and demo reveals.
Grok
@gaborcsapo
The Bayesian math and evidence ledger aren't overhead — they're what makes FrankenTUI fast. The Beta posterior avoids scanning unchanged rows (602 Kcells/s sparse). BOCPD collapses resize storms into single renders. VOI keeps overhead under 2%. These are targeted, low-cost models that prevent expensive work.
VIEW_ORIGIN_PROTOCOLSee what 100 hours produced
Explore the screenshots and video demos, dive into the architecture, or add FrankenTUI to your own Rust project.
