初始提交：terminalX 可运行态（M0/M1/M1.5 已真机验证）

- M0: libghostty SSH 终端（渲染/输入/连接）+ 白屏修复(OutputGate) + 会话状态机/自动重连
- M1: tsnet 用户态组网 + SSH-over-tsnet(fd 桥)，shell 级真机验证；R5(Go+gvisor+C+++Swift 同进程) retire
- M1.5: tmux -CC 原生 tab（MVP）
- 结构: packages/(TXCore·TXTransport), apps/TerminalX, vendor/(libghostty-spm/libssh2/mbedtls/tsnet-bridge), artifacts/
- 文档: CLAUDE.md + docs/HANDOFF.md（新会话入口）
- 环境: 认证代理→依赖 vendor 本地化；Go 在 ~/.local/go；仅模拟器/未签名
- 待续: M2 mosh, tmux 多 pane, M4 安全(host key/SE)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

vendor/libghostty-spm/Tests/GhosttyKitTest/TerminalLifecycleTests.swift

@@ -0,0 +1,94 @@
+@testable import GhosttyTerminal
+import Testing
+
+@MainActor
+struct TerminalLifecycleTests {
+    @Test
+    func `failed surface creation does not retain bridge`() {
+        let controller = TerminalController()
+        let bridge = TerminalCallbackBridge()
+
+        let surface = controller.createSurface(
+            bridge: bridge,
+            configuration: .init()
+        ) { _ in }
+
+        #expect(surface == nil)
+        #expect(controller.retainedBridgeCount == 0)
+    }
+
+    @Test
+    func `switching controllers removes bridge from old controller`() {
+        let oldController = TerminalController()
+        let newController = TerminalController()
+        let coordinator = TerminalSurfaceCoordinator()
+
+        coordinator.isAttached = { false }
+        oldController.retain(coordinator.bridge)
+        #expect(oldController.retainedBridgeCount == 1)
+
+        coordinator.controller = oldController
+        #expect(oldController.retainedBridgeCount == 0)
+
+        oldController.retain(coordinator.bridge)
+        #expect(oldController.retainedBridgeCount == 1)
+
+        coordinator.controller = newController
+
+        #expect(oldController.retainedBridgeCount == 0)
+        #expect(newController.retainedBridgeCount == 0)
+    }
+
+    @Test
+    func `free surface removes retained bridge`() {
+        let controller = TerminalController()
+        let coordinator = TerminalSurfaceCoordinator()
+
+        coordinator.isAttached = { false }
+        coordinator.controller = controller
+
+        controller.retain(coordinator.bridge)
+        #expect(controller.retainedBridgeCount == 1)
+
+        coordinator.freeSurface()
+
+        #expect(controller.retainedBridgeCount == 0)
+    }
+
+    @Test
+    func `suspended wakeup does not schedule render`() {
+        let controller = TerminalController()
+        var wakeups = 0
+
+        controller.shouldProcessWakeup = { false }
+        controller.onWakeup = {
+            wakeups += 1
+        }
+
+        controller.handleWakeup()
+
+        #expect(wakeups == 0)
+    }
+
+    @Test
+    func `application active state controls immediate ticks`() async {
+        let coordinator = TerminalSurfaceCoordinator()
+        var renders = 0
+
+        coordinator.isAttached = { true }
+        coordinator.onPostRender = {
+            renders += 1
+        }
+
+        coordinator.setApplicationActive(false)
+        coordinator.requestImmediateTick()
+        await Task.yield()
+
+        #expect(renders == 0)
+
+        coordinator.setApplicationActive(true)
+        await Task.yield()
+
+        #expect(renders == 1)
+    }
+}