SleelaTerminal™ ↔ Bash Phraign™ Native Pixel Handshake
Part of SleelaTerminal™, SLeeLa's terminal product, built on GNU Bash (GPL, © Free Software Foundation). Phraign™ is SleelaTerminal™'s frame-based, pixel-accurate terminal control system. See
PHRAIGN.mdfor the system overview. This branding covers SLeeLa's own additions only; the vendored GNU Bash sources keep their GPL headers and copyright unchanged.
Purpose
SLeeLa can execute selected programs through Bash. The Phraign™ native pixel-terminal system has an explicit capability handshake so SLeeLa can determine whether the Bash environment understands the Phraign™ pixel-granularity terminal interface before sending pixel commands.
The handshake is deliberately small, versioned, and additive. Ordinary Bash execution does not depend on it.
Protocol identity
The current protocol identity is:
SLEELA-BASH/1 PHRAIGN/1 VARIANT=NATIVE
The fields mean:
SLEELA-BASH/1— Bash integration protocol major version.PHRAIGN/1— Phraign™ pixel-terminal interface version.VARIANT=NATIVE— the Bash endpoint is paired with the native SLeeLa Phraign™ implementation.
A future incompatible protocol increments the SLEELA-BASH major version. Additive Phraign™ features may increment the PHRAIGN version while retaining compatibility rules.
Handshake exchange
SLeeLa should begin a Bash session by requesting the capability handshake:
sleeLa-pixel-terminal HELLO SLEELA-BASH/1 PHRAIGN/1 VARIANT=NATIVE
The Bash-side helper answers with:
sleeLa-pixel-terminal READY SLEELA-BASH/1 PHRAIGN/1 VARIANT=NATIVE
It then advertises capabilities:
sleeLa-pixel-terminal CAPS PIXEL_GRANULARITY NATIVE_FRAME RESIZE_EVENTS
A bridge may treat READY as the compatibility acknowledgement and CAPS as the authoritative feature list.
Bash helper
The shell interface exposes:
pixel_terminal_handshake
It emits the versioned HELLO, READY, and CAPS records for a SLeeLa-aware Bash environment.
The implementation also exports these environment variables for child programs:
SLEELA_BASH_PROTOCOL=1
SLEELA_PHRAIGN_VERSION=1
SLEELA_PHRAIGN_VARIANT=NATIVE
A child program may therefore inspect the environment without parsing terminal output.
Capability meaning
PIXEL_GRANULARITY means a program may address the terminal frame using (x,y) coordinates.
NATIVE_FRAME means the SLeeLa native Phraign™ C++ layer owns the frame geometry and pixel buffer rather than treating the pixel commands as ordinary character output.
RESIZE_EVENTS means terminal resize changes can be observed through the Bash SIGWINCH path and the native pollResize() path.
Physical pixel dimensions remain optional. Character-cell dimensions are the portability fallback, while a pixel-capable bridge may supply an actual raster size.
Compatibility rule
SLeeLa should not send Phraign™ pixel-frame commands until the handshake has returned READY with a compatible major version and the PIXEL_GRANULARITY capability.
If the handshake is unavailable, an ordinary Bash program remains valid. SLeeLa should simply use its normal non-pixel execution path.
Architecture
SLeeLa
|
| HELLO
v
Bash
|
pixel_terminal_handshake
|
+-------+-------+
| |
READY CAPS
| |
+-------+-------+
|
v
Native Phraign™ pixel-terminal layer
|
frame + geometry + resize
|
v
SLeeLa terminal bridge
The handshake establishes capability awareness; it does not itself render a frame. Rendering remains the responsibility of the terminal/frame bridge.