初始提交：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/Sources/GhosttyTerminal/Metrics/TerminalGridMetrics.swift

@@ -0,0 +1,44 @@
+//
+//  TerminalGridMetrics.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import GhosttyKit
+
+public struct TerminalGridMetrics: Sendable, Equatable {
+    public var columns: UInt16
+    public var rows: UInt16
+    public var widthPixels: UInt32
+    public var heightPixels: UInt32
+    public var cellWidthPixels: UInt32
+    public var cellHeightPixels: UInt32
+
+    public init(
+        columns: UInt16,
+        rows: UInt16,
+        widthPixels: UInt32,
+        heightPixels: UInt32,
+        cellWidthPixels: UInt32,
+        cellHeightPixels: UInt32
+    ) {
+        self.columns = columns
+        self.rows = rows
+        self.widthPixels = widthPixels
+        self.heightPixels = heightPixels
+        self.cellWidthPixels = cellWidthPixels
+        self.cellHeightPixels = cellHeightPixels
+    }
+
+    init(_ rawValue: ghostty_surface_size_s) {
+        self.init(
+            columns: rawValue.columns,
+            rows: rawValue.rows,
+            widthPixels: rawValue.width_px,
+            heightPixels: rawValue.height_px,
+            cellWidthPixels: rawValue.cell_width_px,
+            cellHeightPixels: rawValue.cell_height_px
+        )
+    }
+}

vendor/libghostty-spm/Sources/GhosttyTerminal/Metrics/TerminalInputModifiers.swift

@@ -0,0 +1,62 @@
+//
+//  TerminalInputModifiers.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import GhosttyKit
+
+#if canImport(UIKit)
+    import UIKit
+#elseif canImport(AppKit)
+    import AppKit
+#endif
+
+public struct TerminalInputModifiers: OptionSet, Sendable {
+    public let rawValue: UInt32
+
+    public init(rawValue: UInt32) {
+        self.rawValue = rawValue
+    }
+
+    public static let shift = TerminalInputModifiers(rawValue: 1 << 0)
+    public static let ctrl = TerminalInputModifiers(rawValue: 1 << 1)
+    public static let alt = TerminalInputModifiers(rawValue: 1 << 2)
+    public static let super_ = TerminalInputModifiers(rawValue: 1 << 3)
+    public static let caps = TerminalInputModifiers(rawValue: 1 << 4)
+    public static let num = TerminalInputModifiers(rawValue: 1 << 5)
+    public static let shiftRight = TerminalInputModifiers(rawValue: 1 << 6)
+    public static let ctrlRight = TerminalInputModifiers(rawValue: 1 << 7)
+    public static let altRight = TerminalInputModifiers(rawValue: 1 << 8)
+    public static let superRight = TerminalInputModifiers(rawValue: 1 << 9)
+
+    public var ghosttyMods: ghostty_input_mods_e {
+        ghostty_input_mods_e(rawValue)
+    }
+
+    #if canImport(UIKit)
+        public init(from flags: UIKeyModifierFlags) {
+            var mods = TerminalInputModifiers()
+            if flags.contains(.shift) { mods.insert(.shift) }
+            if flags.contains(.control) { mods.insert(.ctrl) }
+            if flags.contains(.alternate) { mods.insert(.alt) }
+            if flags.contains(.command) { mods.insert(.super_) }
+            if flags.contains(.alphaShift) { mods.insert(.caps) }
+            if flags.contains(.numericPad) { mods.insert(.num) }
+            self = mods
+        }
+
+    #elseif canImport(AppKit)
+        public init(from flags: NSEvent.ModifierFlags) {
+            var mods = TerminalInputModifiers()
+            if flags.contains(.shift) { mods.insert(.shift) }
+            if flags.contains(.control) { mods.insert(.ctrl) }
+            if flags.contains(.option) { mods.insert(.alt) }
+            if flags.contains(.command) { mods.insert(.super_) }
+            if flags.contains(.capsLock) { mods.insert(.caps) }
+            if flags.contains(.numericPad) { mods.insert(.num) }
+            self = mods
+        }
+    #endif
+}

vendor/libghostty-spm/Sources/GhosttyTerminal/Metrics/TerminalScrollModifiers.swift

@@ -0,0 +1,51 @@
+//
+//  TerminalScrollModifiers.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import GhosttyKit
+
+#if canImport(AppKit) && !canImport(UIKit)
+    import AppKit
+#endif
+
+public struct TerminalScrollModifiers: Sendable {
+    public let rawValue: ghostty_input_scroll_mods_t
+
+    public init(rawValue: ghostty_input_scroll_mods_t = 0) {
+        self.rawValue = rawValue
+    }
+
+    public init(precision: Bool, momentum: Momentum = .none) {
+        var value: Int32 = 0
+        if precision { value |= 1 }
+        value |= momentum.rawValue << 1
+        rawValue = value
+    }
+
+    public var precision: Bool {
+        (rawValue & 1) != 0
+    }
+
+    public var momentum: Momentum {
+        Momentum(rawValue: (rawValue >> 1) & 0x3) ?? .none
+    }
+
+    public enum Momentum: Int32, Sendable {
+        case none = 0
+        case began = 1
+        case stationary = 2
+        case changed = 3
+    }
+
+    #if canImport(AppKit) && !canImport(UIKit)
+        static func momentumFrom(phase: NSEvent.Phase) -> Momentum {
+            if phase.contains(.began) { return .began }
+            if phase.contains(.stationary) { return .stationary }
+            if phase.contains(.changed) { return .changed }
+            return .none
+        }
+    #endif
+}

vendor/libghostty-spm/Sources/GhosttyTerminal/Metrics/TerminalViewportMetrics.swift

@@ -0,0 +1,13 @@
+//
+//  TerminalViewportMetrics.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import Foundation
+
+struct TerminalViewportMetrics: Equatable {
+    var surfaceSize: TerminalGridMetrics
+    var scale: Double
+}