rdmbair15m5-changelog-20260923-1055-feat-20260831-08-tyreltty-terminal-multiplexer

Implemented and verified TyrelTTY native macOS terminal emulator and fleet agent multiplexer subsystem in TyrellCore (FEAT-20260831-08), delivering background PTY supervision, non-blocking I/O, Metal-accelerated terminal grid specifications, real-time agent stream state parsing (Working, Blocked, Done, Idle), and CLI commands.

Scope

• Hosts: rdmbair15m5 (author), rdmsm4x (canonical hub)
• Repos: apps/Tyrell (commit 75335d3), issues (commit 368c42b)

Files Touched

• Sources/TyrellCore/Terminal/TyrelTTYModels.swift (new): Defined AgentTTYState (working, blocked, done, idle, offline), SupportedAgentFamily (claude, codex, agy, grok, generic), TerminalSessionSpec, TerminalMultiplexSession, MetalTerminalGridSpec, and AgentStateParser for real-time terminal output stream parsing.
• Sources/TyrellCore/Terminal/TyrelTTYMultiplexer.swift (new): Background PTY manager actor leveraging POSIX pseudo-terminals (posix_openpt, grantpt, unlockpt, ptsname), non-blocking stream processing, attach/detach semantics, active scrollback buffer tracking, and live agent status deduction.
• Package.swift: Updated exclude list with "Terminal" for modular target isolation.
• Sources/tyrell/Tyrell.swift: Added tyrell tty {list|spawn|parse|status} CLI subcommands.
• Tests/TyrellCoreTests/TyrelTTYMultiplexerTests.swift (new): 7 unit tests covering PTY session allocation and detachment, chunk stream ingestion, scrollback buffer sizing, Metal grid specification parameters, and agent state stream parsing across Working, Blocked, Done, and Idle conditions.

Verification Evidence

• swift test --filter TyrelTTYMultiplexerTests: 7/7 tests passed in 0.002s.
• swift run tyrell tty parse "Running tests... 5 passed": Verified live state detection -> ⚡ WORKING (Terminal output stream active).
• swift run tyrell tty parse "Waiting for confirmation (y/n)": Verified live state detection -> ✋ BLOCKED (Prompting for user confirmation: '(y/n)').
• swift run tyrell tty status: Verified status summary reporting 0 active sessions and Liquid Glass hardware accelerated rendering.
• Pushed to origin (git.ecs0.net:git/apps/Tyrell.git) and backup (https://github.com/richhdoty/rdmsm4x-dev-apps-tyrell.git).
• Pulled cleanly on canonical rdmsm4x:~/dev/apps/Tyrell.
• Ticket FEAT-20260831-08 resolved on rdmsm4x and pushed across remotes.
• Broadcast sent across message bus (20260923-105459-E0C923CD) and synchronized to all 5 fleet peers.

Rollback / Undo

• git revert 75335d3 in apps/Tyrell.
• ticket reopen FEAT-20260831-08 on rdmsm4x.