SPB Git

Repository Public

IMPLEMENTATION_STATUS.md 15.2 KB 191 lines markdown

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

Theme