szn

szn — Functional Clone Progress

Track progress toward a fully functional tmux clone. Based on code audit as of 2026-06-21.

Current State: 1,082 tests, v0.11.0 release. Dual Zig 0.16/0.17 toolchain support from a single source tree, lifecycle memory reclamation and Session.arena removal (#542), Lao script reflow, RPM packaging, hot-path performance architecture overhaul (batch chunk parser advanceBatch, fast-path ASCII streaming in writeStr, O(1) pane validity tracking isPaneValid, batched SGR and render output, arena format string allocations). Configurable Unicode VS16 emoji presentation width option (variation-selector-always-wide). Hardened Sixel graphics subsystem (containment verification, scroll-region bound anchor shifting, surviving marker cell purging, transactional placement error rollback). Stable display client pointer lifetimes (ArrayList(*DisplayClient)), bounded OSC 52 clipboard and IPC frame limits, race-free PTY child reaping before SIGKILL, Kitty extended keyboard release filtering, raw terminal diagnostics, a 70-bug stability sweep (#441–#510), and the #511–#562 audit sweeps.

Thai & Lao text rendering & reflow correctness sweep (#502–#505, SARA AM diff-cache cluster repair): compound-vowel cluster integrity (เ-าะ patterns no longer split at reflow boundaries), atomic state transitions for runtime libthai loading in src/thai.zig, and two-way SARA AM diff repair (Display.renderContent pre-pass covering Thai U+0E33 and Lao U+0EB3 with deduplicated resolveCell and isolated thai.isSaraAm).

Dual-toolchain support (2026-10-05): szn now compiles on both Zig 0.16.0 and 0.17.0 from one source tree. Zig 0.17 removed or renamed a number of std APIs; each was replaced with a spelling that exists in both releases (bufPrintSentinel, meta.fieldNames, mem.zeroes, allocSentinel, ascii.eqlIgnoreCase, = .empty), and the two cases with no shared form (Allocator.dupeZ, std.ascii.indexOfIgnoreCase) plus the optimize-tag check were routed through a new src/compat.zig. The only comptime version branches are two @hasField gates in build.zig (Build.build_root, .Debug tag). zig build test passes 1082/1082 on 0.16.0 and on 0.17.0 (re-verified 2026-10-30 with -Doptimize=ReleaseFast on a clean cache, after the #562 fix: a test use-after-free that only Zig 0.17’s non-reusing SafeAllocator exposed).


Migration Phase Audit

Phase Description Status Tests Notes
0 Scaffolding + Test Harness ✅ Done — build.zig, test.zig, log.zig (err.zig was removed — see bug #36)
1 Grid + Colour + Screen ✅ Done ~90 Cell, Grid, Screen, Colour all complete
2 Key + Session + Window + Layout ✅ Done ~40 Key parse/format, Session, Window, Pane, Layout tree
3 Options + Config ✅ Done ~25 Options store, config parser (set, bind, source, if-shell)
4 TTY Output Engine ✅ Done ~35 Term writer, cursor, SGR, clearing, scroll region, alt screen
5 TTY Input Parsing ✅ Done ~25 InputReader: keys, mouse, UTF-8, focus, paste, kitty
6 Input Escape Parser ✅ Done ~80 CSI, OSC, DCS, DECSET, SGR, scroll regions, alt screen
7 Format + Status ✅ Done ~30 format.zig and status.zig complete
8 Mode + Key Bindings ✅ Done ~40 copy mode and key bindings structure complete
9 Client-Server IPC ✅ Done ~30 IPC protocols, unix sockets, and live client-server communication complete
10 Commands ✅ Done ~74 All 49 commands registered in CMD_TABLE (including set-window-option / setw, copy-mode, paste-buffer, find-window, show-messages, and list-keys)
11 Full Integration ✅ Done ~30 integration.zig integration test suite complete

Total: 1,082 / 1,082 tests passing (verified 2026-10-30, Zig 0.16.0 and 0.17.0, -Doptimize=ReleaseFast; detectNested self-skips inside szn). All Phases 0–11 fully complete.

The per-phase Tests column above is a snapshot taken when each phase landed, not a partition of the current total — later phases and audit sweeps added tests to earlier modules, so those figures do not sum to the current total.


Feature Gaps (by priority)

P0 — Usable Daily Driver (All Completed)


Milestones

M1: Interactive Multi-Pane (target: usable daily driver)

M2: Configurable & Scriptable