SP Term — Implementation status
Legend — Tested: covered by an automated test or an observed end-to-end check listed in TEST_REPORT.md · Implemented: code is in place and compiles, behaviour not verified beyond what is stated · Partial / Not done: as described. Nothing is marked Tested on the basis of "it should work".
Last update: 2026-11-17 · version 1.0.0 (1) · reference machine: MacBook Pro, Apple M5 Max, 48 GB, macOS 27.0, one built-in display.
SP Term Next (2.0.0, 2026-11-19)
| Feature | State | Evidence / note |
|---|---|---|
| Audit and upgrade plan | Done | docs/SPTERM-NEXT-AUDIT.md |
| Design tokens, motion tokens, accent engine, 2 new themes | Tested | ThemeTests (9), contrast asserted for all 8 themes |
| Settings of 1.0.0 load with the new defaults; invalid values fall back | Tested | settingsFromVersionOneLoadWithNextDefaults |
| Card layout, translucent chrome, ambient light, pill tabs, palette, sidebar, status bar | Implemented, visually checked | docs/evidence/next/01–06 |
| Liquid Glass with material fallback | Implemented | seen on macOS 27; the fallback path (macOS 14/15) compiles, never run |
| Motion system, Reduce Motion | Tested (policy) / Implemented (animations) | testReducedMotionReplacesMovementWithFades; no frame-timing measurement |
| Pane frames snap, no PTY resize storm | By construction | snapGeometry on the canvas; not measured with a resize counter |
| Dynamic accent per SSH host | Tested | testDynamicAccentGivesEachHostItsOwnStableColour; not captured with a live host |
| Customizable toolbar (context menu and Settings) | Tested (model) / visually checked (menu) | real click on the bar opened the menu |
| Compact and expanded title bar, traffic lights centred | Visually checked | measured from the window, not hard-coded |
| Focus mode with hidden traffic lights, return on hover | Visually checked (hidden state) | the hover return was not exercised |
| Full-Screen Workspace | Tested (state) | the native full-screen transition itself was not exercised |
| Command-finished feedback | Tested (model) | not captured live |
| Window keeps its controller and delegate | Tested | testAWindowKeepsItsControllerUntilItIsClosed |
| Developer ID signature, notarization and stapling of the app and DMG (2.0.0) | Accepted by Apple | see RELEASE.md; Scripts/smoke.sh not run on this build |
| Publication of the 2.0.0 DMG | Done | git.spboucher.ai/sp-term/releases; download re-verified (SHA-256, staple, Gatekeeper) |
Phases
| Phase | Scope | State |
|---|---|---|
| 0 | Reconnaissance, engine choice, licences, project, architecture | Done |
| 1 | App opens, real PTY, rendering, keyboard, scrollback, resize, base tests | Done, tested |
| 2 | Tabs, recursive splits, detachable windows, multi-display, layout restore | Done, tested (multi-display on simulated displays) |
| 3 | UX, palette, settings, themes, icon, accessibility | Done; accessibility not audited with VoiceOver |
| 4 | SSH, profiles, history, search, git, quick terminal, snippets, monitoring | Done; quick terminal and notifications not verified live |
| 5 | Optional assistant, BYOK/Keychain, agent CLIs, guard rails | Done, tested with a mock transport (no real provider call was made) |
| 6 | Robustness, performance, tests, security, Release build, signing, notarization, DMG | See "Distribution" below |
Terminal core
| Feature | State | Evidence / note |
|---|---|---|
Real PTY (forkpty + exec-mode posix_spawn), controlling terminal, job control |
Tested | PTYProcessTests (17), smoke test |
| Echo, exit codes, signals, Ctrl+C / Ctrl+Z / Ctrl+D | Tested | PTYProcessTests, smoke test |
TTY size, SIGWINCH, repeated resize |
Tested | unit + hosted + smoke (300 resizes under output) |
| No descriptor leak to children, clean environment, no zombies | Tested | childInheritsNoDescriptorFromTheApp, releasingTheObject… |
TERM/COLORTERM/TERM_PROGRAM, login shell, working directory, fallback when a directory is gone |
Tested | LaunchTests, smoke test |
| zsh, bash, sh | Tested | zsh/sh in tests, bash in PTY probe |
| fish and other shells | Implemented | detected if installed; fish is not installed on the reference machine |
| VT/xterm emulation (cursor, erase, SGR, 256/true colour, alt screen, scroll regions, bracketed paste, mouse modes, focus reports, OSC 0/2/8/52, wide + combining + ZWJ, reflow) | Tested (engine conformance) | ConformanceTests (15) against SwiftTerm 1.99.2 |
| Malformed/unknown sequences never crash | Tested | malformed corpus + 60 fuzz rounds |
| vim, less, top, python, ssh | Tested | smoke test + live SSH session to a LAN host |
| nvim, htop, nano, fish | Not verified | nvim/htop/fish are not installed on the reference machine; nano not exercised |
| Scrollback bounded by setting, search (plain, case, regex), match counter, search across sessions | Tested | hosted tests, benchmark (200 000 lines) |
| Selection, copy, ⌘-click on URLs | Implemented | provided by the engine; link policy (LinkPolicy) tested, clicking not automated |
| Drag & drop of files → escaped paths | Tested (escaping) / Implemented (gesture) | round-trip of 17 hostile names through a real shell; the drop gesture itself is not automated |
| Inline images (Sixel/iTerm/Kitty) | Not verified | engine defaults left untouched; no validation done |
| Ligatures | Partial | follow the selected font; no on/off switch |
| Line spacing | Not done | fixed by the engine |
| Metal renderer | Implemented, off by default | exposed as "experimental"; not benchmarked, no performance claim is made |
Windows, panes, displays
| Feature | State | Evidence / note |
|---|---|---|
| Tabs: create, select, reorder, rename, close, close-last-closes-window | Tested (reorder by drag: Implemented) | WorkspaceTests |
| Recursive horizontal/vertical splits, 2/3/4/6/8 panes | Tested | LayoutTests (incl. 200 random operation sequences), hosted, smoke |
| Resize by mouse (dividers) | Implemented | divider maths tested; the drag gesture is not automated |
| Resize by keyboard, equalize | Tested | hosted |
| Keyboard focus navigation, next/previous pane | Tested | hosted + smoke (found and fixed a real focus bug, see TEST_REPORT) |
| Temporary zoom of a pane | Tested | hosted + smoke |
| Rearranging panes by drag & drop (same tab, across tabs/windows) | Tested (model) / Implemented (gesture) | testMovePaneAcrossTabsByDrop |
| Detach pane / tab to a new window without killing the shell | Tested | pid and shell variable preserved |
| Merge a window back into another | Tested | same |
| Independent windows on several displays, open on a chosen display, move to a display | Tested on simulated displays | DisplayTests; real hardware: one display only |
| Display unplugged → windows rescued, none lost, sessions untouched | Tested on simulated displays | testUnpluggingADisplayBringsItsWindowsBack, 500 random configuration changes in PlacementTests |
| Resolution / arrangement change | Tested on simulated displays | |
| Spaces | Not specifically handled | windows use standard AppKit behaviour |
| Native full screen | Tested | smoke test |
| Presets (Code+Tests+Logs, SSH Fleet, Agent Command Center, 4 panes, Dual Monitor, grids) | Tested | unit + hosted |
| Pane count adapted to screen size | Partial | a hint is shown when a preset exceeds the comfortable capacity; panes are not removed |
| Broadcast input: off by default, confirmation, banner, destructive lines held | Tested | BroadcastTests (3) |
Sessions and workspaces
| Feature | State | Evidence / note |
|---|---|---|
| New, duplicate, rename, restart, close with confirmation when busy | Tested | hosted |
| Quit confirmation when sessions are busy | Implemented | same code path as close; not automated |
| Layout autosave, restore at launch (layout, titles, kinds, directories), new processes | Tested | hosted + smoke; a banner states that processes are new |
| Named workspaces (save, open, delete) | Tested (save/open path) | deletion not separately tested |
| Versioned storage, migration v1→v2, corruption recovery, 0600/0700 permissions | Tested | StoreTests |
| Private mode | Tested | layout deleted and no longer written |
| tmux / zellij integration | Partial | palette entries appear when the tools are installed and attach-or-create a session; nothing beyond that |
| Opt-in command history (snippets / assistant / broadcast), masked, bounded | Tested | StoreTests; shell history typed at prompts is intentionally not captured |
| Per-project / per-directory profiles | Not done |
SSH, git, tools
| Feature | State | Evidence / note |
|---|---|---|
~/.ssh/config parsing (wildcards, negation, Include, Match all) |
Tested | SSHKitTests (39) |
| Profiles, groups, favourites, ProxyJump, ports | Tested (model) / Implemented (UI) | |
| System OpenSSH only; no option weakening host-key checks; hostile names refused | Tested | unit + hosted |
| Live connection | Tested | one real session to a LAN host (hostname, exit, "connection ended" note, Reconnect button) |
| Host key prompts | By design left to OpenSSH | SP Term never answers them |
| known_hosts state in the dashboard | Implemented | inspector tested against a temp file |
| Connection state, manual reconnect, failure diagnosis | Tested | testFailedSSHSessionIsDiagnosedAndCanBeReconnected |
| SSH latency in the status bar | Not done | |
| SFTP | Partial | opens the system sftp in a tab; no graphical transfer |
| Multi-host dashboard and grid | Tested (model) | opening hosts runs ssh only |
| Git panel: branch, status, diff, commits — read-only | Tested (GitKit, 26) / Implemented (UI) | mutating subcommands are refused by the runner |
| Snippets with variables, review before run | Tested | quoting and consent path |
| Resource monitor (CPU, memory, duration of the foreground task) | Implemented | values come from libproc; displayed, not validated against another tool |
| Notifications (long command finished, SSH ended) | Implemented | needs the user's permission; not verified live |
| Quick terminal with global hotkey | Implemented | not verified live |
| Finder: open a folder with the app | Tested | smoke test (open -a) |
| Finder Services entry "New SP Term Window Here" | Implemented | declared in Info.plist; not verified (needs the app installed and the services cache refreshed) |
| Session export with secret masking | Tested (masking) / Implemented (save panel) | |
| Automatic updates (Sparkle) | Not done | no feed URL exists; deliberately not enabled |
SP Intelligence
| Feature | State | Evidence / note |
|---|---|---|
| Providers: Anthropic, OpenAI, OpenAI-compatible; keys in Keychain | Tested with mock transport; Keychain round trip tested | no request was ever sent to a real provider |
| Preview of the exact payload before sending; nothing sent without it | Tested | AssistantSafetyTests |
| Secret masking | Tested | 28 redaction cases |
| Local-only mode | Tested | refused before any I/O |
| Terminal text attached only on explicit choice | Tested | |
| Suggested commands never run without confirmation; typed phrase for destructive | Tested | 118 risk-analyzer cases, consent gate, hosted tests |
| Modes Explain / Suggest / Draft command / Review diff / Agent workspace | Implemented | system prompts exist; answer quality not evaluated |
| Streaming answers | Implemented in the client | the panel uses non-streaming requests |
| Agent CLIs (Claude Code…) in their own panes | Implemented | detection tested; launching is an ordinary session; not exercised with a real agent |
Interface and accessibility
| Feature | State | Evidence / note |
|---|---|---|
| Integrated title bar, compact tab bar, sidebar, status bar, pane headers, context menu | Implemented, visually checked | screenshots in docs/evidence/ |
| Command palette | Tested (items, fuzzy match, execution) | |
| Customizable shortcuts applied immediately | Tested (model) / Implemented (editor) | conflict detection in the editor |
| Themes: 2 dark, 2 light, 2 high contrast; accent override | Tested | contrast ratios asserted for every theme |
| Follows system appearance and "Increase contrast" | Tested (model) | |
| Font family and size 6–72 pt, cursor shape/blink | Tested | extremes applied to live sessions |
| Opacity and blur | Implemented | not visually verified |
| Focus mode, presentation mode | Implemented | |
| VoiceOver | Not audited | controls carry labels and the engine ships an accessibility service; no VoiceOver session was run |
| Localization | Not done | interface in English only |
Icon and brand
| Item | State |
|---|---|
| Three SVG concepts, winner chosen on small-size legibility | Done (Assets/Brand/Concepts, BRAND.md) |
| Editable SVG source, small-size variant, monochrome glyph | Done |
PNG exports 1024–16 px, AppIcon.appiconset, accent colour |
Done; catalog compiles |
| Display in Dock / Finder / About | Checked in the built app bundle; Launchpad not checked |
| Light/dark icon variants | Not done (single appearance) |
Distribution
| Step | State | Evidence |
|---|---|---|
Reproducible project (XcodeGen project.yml), bundle id ai.spboucher.spterm |
Done | Scripts/build.sh generate |
| Debug and Release builds, no error | Done | ** BUILD SUCCEEDED ** for both |
| Universal binary | Done — built, arm64 run only | lipo -archs → x86_64 arm64; the Intel slice was never executed |
| Developer ID signature, hardened runtime | Done | codesign --verify --deep --strict: valid; flags 0x10000(runtime); authority Developer ID Application: Simon-Pierre Boucher (3YM54G49SN) |
| Minimal entitlements | Done | only com.apple.security.automation.apple-events (a get-task-allow injected by Xcode was found during verification and removed) |
| Notarization of the app | Accepted by Apple | submission 7a507c0c-ce4b-47d6-8111-da25c045e712, log status Accepted, no issues (build/notary/) |
| Stapling | Done | stapler validate: "The validate action worked!" |
| DMG with Applications shortcut and release notes, signed, notarized, stapled | Accepted by Apple | submission 4b91a4c0-efb5-4d42-90d2-fa5f3135d09b; dist/SPTerm-1.0.0.dmg (8.3 MB) |
| Gatekeeper | Accepted | spctl: source=Notarized Developer ID for the app, the DMG and the app inside the mounted DMG |
| SHA-256 | Done | 9f07160dd2f174d19a4830e90d89656a1accc28f779650a8febeda2e24eb5a00 (dist/SPTerm-1.0.0.dmg.sha256) |
| End-to-end check of the signed build | Done | Scripts/smoke.sh "dist/SP Term.app": 29/29 on the last run (earlier runs: see TEST_REPORT) |
| Publication | Not done, on purpose | nothing was uploaded anywhere except to Apple's notary service; the DMG is only in dist/ |
| Installation test on another Mac / quarantined download | Not done | Gatekeeper was assessed with spctl on the build machine only |
Known issues
- The 16 px icon is soft (strokes are not pixel-hinted).
- During one automated run a second window opened without a traceable cause; it could not be reproduced in two replays of the same keystrokes (other automation was active on the machine at the time).
- System Events key injection is unreliable when keystrokes are sent faster than ~1 per second on this machine; the smoke test therefore runs slowly and can report a spurious failure.
- A 200 000-line scrollback costs several hundred MB of memory (see BENCHMARKS.md); the default is 20 000.
- Exported text keeps soft-wrapped lines as separate lines.