SPB Git

Repository Public

PROGRESS.md 5.1 KB

# 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; NEXTERMKit package builds with Swift 6 strict concurrency.
  • ✅ xcodegen generate → NEXTERM.xcodeproj; Scripts/build.sh debug → build/DerivedData/Build/Products/Debug/NEXTERM.app.
  • ✅ Spike launched: -zsh child on /dev/ttys012; typed command echoed NEXTERM_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 via tcgetpgrp on 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.hostName blocked 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 Window kept sleep 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_PIDVNODEPATHINFO probe 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"].hasTrustDialogAccepted is still false.
  • macOS attributes TCC prompts (Downloads/Desktop/Documents) to NEXTERM when a child shell touches those folders — expected.
Files main
Menu

Theme