NEXTERM — Progress log (verified outcomes only)
Legend: ✅ verified · 🔄 in progress · ⛔ blocked · ⬜ not started
Phase 0 — Discovery & spike ✅ (2026-11-01)
- ✅ Environment inspected (see PLAN.md table).
- ✅ libghostty spike: 320/337 build steps, blocked by missing Metal Toolchain; API unstable → deferred (ADR 0001).
- ✅ SwiftTerm 1.99.2 adopted;
NEXTERMKitpackage builds with Swift 6 strict concurrency. - ✅
xcodegen generate→NEXTERM.xcodeproj;Scripts/build.sh debug→build/DerivedData/Build/Products/Debug/NEXTERM.app. - ✅ Spike launched:
-zshchild on/dev/ttys012; typed command echoedNEXTERM_OK cols=112 lines=24.
Phase 1 — Terminal MVP ✅ (2026-11-01)
- ✅
WorkspaceController: tabs, nested splits (same-axis splits stay flat), focus, close semantics with confirmation when a foreground program is detected viatcgetpgrpon the PTY. - ✅ Pane canvas: absolute layout from the tree, drag-to-resize dividers, focus ring, maximize/restore, exited overlay (Restart/Close), context menu (split/move/close).
- ✅ Tab strip (rename, reorder, close), status bar (host via
gethostname, cwd, kind, grid, status, live count), sidebar (sessions), inspector (verified facts: pid, tty, cwd, foreground program). - ✅ Menu commands + shortcuts (docs/SHORTCUTS.md); Settings (appearance, behaviour); 4 themes; zoom.
- ✅ Paste protection (multi-line confirm), find bar (⌘F/⌘G), ⌘K clear.
- ✅ Verified by driving the app with System Events: 3 panes on ttys012/013/014, typing routed to the focused pane only, Focus Next/Left via menu (screenshots mvp3/mvp4).
- ⚠️ Fixed:
ProcessInfo.hostNameblocked the main thread (reverse DNS) → app launched with no visible window.
Phase 2 — Workspace system 🔄
- ✅
PersistenceCore: SQLite (WAL, bound parameters), migrations (user_version=1),WorkspaceStore,SettingsStore; 6/6 tests (round trip, subtree replace, corrupt rows dropped, SQL injection probe). - ✅ Debounced saves (400 ms) after every mutation; save on quit; DB at
~/Library/Application Support/NEXTERM/nexterm.sqlite. - ✅ Restore on launch: 1 window / 2 tabs / 4 panes came back with new ttys and a per-pane banner "Layout restored · new process started (previous one was not reattached)" (persist2.png).
- ✅ Session identity is regenerated on restore so nothing can be mistaken for reattachment.
- ✅ Multi-window:
Move Pane to New Windowkeptsleep 600(pid 40471, ttys014) and its zsh alive. - ✅ Window geometry saved with display id/name; missing display → relocated to main screen (unit-tested
with simulated topologies in
WindowPlacementTests; hardware hot-plug not yet exercised). - ✅ cwd tracking: OSC 7 when the shell emits it + libproc
PROC_PIDVNODEPATHINFOprobe every 2 s. - ⬜ Workspace switcher / templates / multi-monitor presets.
Phase 3 — Claude Code ⬜
Phase 4 — SSH, tmux, Git ⬜
Phase 5 — Polish & release ⬜
Acceptance tests
| # | Test | Status | Evidence |
|---|---|---|---|
| 1 | Local zsh shell interactive | ✅ PASS | spike3.png, mvp3.png: typed commands echo tty + $COLUMNS |
| 2 | Interactive app + resize | ✅ PASS | vim in alt screen; window resized → grid 109×35, redraw correct (vim-resized.png) |
| 3 | 8 panes, no cross-session leakage | ✅ PASS | Scripts/smoke-test.sh: 8 shells on ttys012–019, each marker landed in exactly one pane |
| 4 | Move live pane between windows | ✅ PASS | sleep 600 pid 40471 / ttys014 unchanged after move; 3 windows |
| 5 | Restore layout after restart | ✅ PASS | persist2.png, sqlite rows 1/2/4 |
| 6 | Restoration ≠ reattachment | ✅ PASS | banner "new process started", new session IDs + ttys; Claude panes marked "reattached (resume)" |
| 7 | Launch installed Claude Code, auth untouched | ✅ PASS | claude 2.1.316 interactive, answered PONG; only --session-id/--settings passed; ~/.claude/settings.json not modified |
| 8 | Two Git worktrees in two panes | ✅ PASS | worktrees.png; git worktree list shows main + agent/1 |
| 9 | SSH to authorized host, host-key handling | ✅ PASS | M1M32 (user's own node): known key → connected; unknown key → OpenSSH prompt, declined, known_hosts unchanged |
| 10 | Recover from SSH disconnect / missing monitor | ✅ PASS (SSH) · 🔄 (monitor: unit-tested relocation, no physical unplug performed) | ssh-drop1.png; WindowPlacementTests |
| 11 | Unit + integration + UI smoke + clean Release build | ✅ PASS (XCUITest runner ⛔ BLOCKED by environment) | Kit 42/42 (swift test), app unit 9/9 (xcodebuild test), Scripts/smoke-test.sh PASS, Release build clean |
| 12 | .app bundle launches on build machine | ✅ PASS | dist/NEXTERM.app (signed + notarized + stapled) launched, shell on ttys012; DMG dist/NEXTERM-0.1.0.dmg |
Known issues / caveats
- Claude Code's own "trust this folder" prompt appears for untrusted directories; NEXTERM never answers it.
Verified after testing:
~/.claude.json→projects["/Users/simon-pierreboucher"].hasTrustDialogAcceptedis stillfalse. - macOS attributes TCC prompts (Downloads/Desktop/Documents) to NEXTERM when a child shell touches those folders — expected.