Rewrite plan

Orchestrator: Opus (plans, designs core abstractions, reviews, integrates, commits). Bulk porting: Sonnet subagents. Hard algorithmic cores: Codex (gpt-6-astra) or Opus. Progress lives in STATUS.md.

Phases

Phase 0 — scaffolding (done)

Workspace, crate skeletons, docs, lints.

Phase 1 — leaf crates (parallel)

W1 ghostty-vt part A: Parser, parse_table, UTF8Decoder, osc + osc/parsers/*, osc/encoding, color, x11_color, kitty/color.
W2 ghostty-vt part B: csi (incl. SepList), sgr, modes, charsets, ansi, device_status, mouse_shape, kitty/key, kitty/graphics_command, apc, dcs.
W3 ghostty-unicode + ghostty-datastruct.
W4 ghostty-os.
W5 ghostty-input.
W6 ghostty-config (+ cli/args, CommaSplitter, diagnostics).
W7 ghostty-font: Metrics + sprite/*.

Phase 2 — terminal core

ghostty-vt::stream (stream.zig) once W1/W2 land.
ghostty-terminal: style, hyperlink, size, point, ref_counted_set, page, PageList (Codex/Opus: hardest part), then Screen, Tabstops, Terminal, ScreenSet, Selection, stream_readonly, formatter, render, highlight, search/*, kitty graphics storage/image/exec/unicode, tmux.

Phase 3 — font engine

discovery (fontconfig), freetype face, harfbuzz shaper (+run, feature, Cache), opentype tables, Collection, CodepointResolver, CodepointMap, DeferredFace, SharedGrid, SharedGridSet, Atlas, embedded fonts, nerd_font_attributes.

Phase 4 — termio

pty, Command (fork/exec), Exec backend, Termio, Thread, mailbox, stream_handler, shell_integration (+ copy ZIG/src/shell-integration).

Phase 5 — renderer

OpenGL backend (glow), generic renderer logic, cells, cursor, image, link, size, State, Thread, Overlay, shadertoy custom shaders.

Phase 6 — core + GTK app

ghostty-core: App, Surface, surface_mouse, apprt action/structs, CLI actions. ghostty-apprt-gtk: application, windows, tabs, splits, surface widget (GLArea, input, IME, clipboard), config reload, dialogs, notifications, quick terminal, IPC (+new-window), CSS/UI.

Phase 7 — integration and polish

End-to-end run, vttest-ish smoke tests, perf, inspector (maybe), docs, CHANGELOG.

Review protocol

After each work package: orchestrator reads the agent report + notes, spot-checks code (esp. tricky logic), runs quality gate on the workspace, commits. Larger cores get an /astrareview or Codex review pass.

Stopping criterion for review rounds (decided 2026-10-12)

Audit rounds RV1–RV17 converged to P3-only findings (no P1 in the last five rounds). To avoid an endless review loop, RV18 is the final audit round. From it, only P1/P2 findings, user-visible behaviour in normal use, memory-safety issues and regressions are fixed; remaining P3 nitpicks are recorded in docs/rewrite/KNOWN_DIFFERENCES.md instead of triggering further rounds.

2.8 KiB Raw Blame History Unescape Escape