Repository navigation
Ghostty enhanced integration (post-abstraction) #12
Description
Goal
Preserve and improve Ghostty-specific enhanced behaviors behind the TerminalHost capability abstraction so they do not leak into NMSh core.
Why
Ghostty is the primary development host and has capabilities (keyboard protocols, appearance integration, graphics/protocol support) that improve NMSh. These should be retained and improved — but must be isolated behind host-specific logic so NMSh core remains host-agnostic.
Scope
Ghostty-enhanced behaviors to preserve and route through the capability abstraction (#10):
- Enhanced keyboard forwarding (Kitty protocol / Ghostty extensions)
- Appearance integration (theme/palette sync)
- Graphics/protocol capabilities where applicable
- Modern keyboard protocol support (Shift+Enter, Option+Backspace, etc.)
Ghostty must NOT become a structural dependency of NMSh core.
Non-goals
- Adding new Ghostty-only features without capability gating
- Requiring Ghostty for any baseline NMSh behavior
Acceptance criteria
- All existing Ghostty-enhanced behaviors work after the capability abstraction refactor
- Enhanced behaviors are provably isolated (not reached on baseline hosts)
- No NMSh core code contains Ghostty-specific string literals or conditionals
Human verification
- Full NMSh session in Ghostty after refactor
- Verify Shift+Enter, Option+Backspace, and other enhanced key combos work
- Verify appearance integration (if implemented) is Ghostty-only
Dependencies
Requires #10 (TerminalHost capability abstraction).
Rough effort
1 day
Activity
raiseCatError commentedon Oct 1, 2026
Enhanced-host integration is isolated in unmerged #261, stacked on #260 → #259 → #258. Core consumes capabilities/adapter operations; it no longer selects configuration integration by host names or by finding another host’s config file. Existing explicit panel actions are preserved, startup is passive, and architecture tests pin the boundary.
Local build/typecheck/diff check and 782 tests passed. Node 22/26 CI passed at run 36924237544. Physical keyboard/configuration/selection validation remains deferred and this issue stays open. Development stopped at a disk-headroom checkpoint; see #10 for exact branch/SHA and remaining work.
raiseCatError commentedon Oct 4, 2026
Implemented on the v0.16 branch (PR #303,
feature/v016-platform-portability-agents). Enhanced Ghostty integration behind the host abstraction (capabilities and adapter operations, no host-name branching in core):docs/architecture/terminal-host.md,docs/architecture/host-actions.md. It was part of the integrated build the maintainer physically validated in the earlier v0.16 QA pass; closing with the implementation.