SPB Git

Repository Public

IMPLEMENTATION_STATUS.md 15.2 KB

# 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.
Files main
Menu

Theme