Session Inspector — 별도 NSPanel + SwiftUI + actor→MainActor publish

자녀  어머님 옆에서 *진행 상황* 봄
       Slack/카톡으로 멀리서도 "1단계 됐어요?" 물음 가능
       
기업  compliance audit (어떤 step 박혔는지 visible)
       "사용자가 송금 button 박았는지" 외부 확인 가능
       
본인  디버그 + Phase 9 Probe D-prime 시각화
       Qwen tps / Gemini latency / sourceTag / irreversible badge

@MainActor
final class InspectorState: ObservableObject {
    static let shared = InspectorState()
 
    enum Phase: Sendable, Equatable {
        case idle
        case analyzing(stepIndex: Int)
        case waitingForUserClick(stepIndex: Int)
        case completed
        case cancelled
        case failed(String)
    }
 
    struct StepView: Identifiable, Equatable {
        let id = UUID()
        let stepNumber: Int
        let targetText: String
        let nextAction: String
        let sourceTag: String
        let irreversible: Bool
        let elapsedSec: Double
        let timestamp: Date
    }
 
    @Published var sessionID: String?
    @Published var instruction: String?
    @Published var steps: [StepView] = []
    @Published var phase: Phase = .idle
    @Published var dispatcherName: String = "?"
    @Published var privacyMode: String = "cloud"
    @Published var lastElapsed: Double?
    @Published var lastTokensPerSecond: Double?
 
    func beginSession(...) { ... }
    func markAnalyzing(stepIndex: Int) { ... }
    func appendStep(_ step: StepView) { ... }
    func finishCompleted() { ... }
    func finishCancelled() { ... }
    func finishFailed(_ reason: String) { ... }
}

@MainActor
final class SessionInspectorPanel {
    static let shared = SessionInspectorPanel()
    private var window: NSPanel?
 
    private func makeWindow(onCancel: @escaping () -> Void) -> NSPanel {
        let view = SessionInspectorView(state: InspectorState.shared, onCancel: onCancel)
        let hosting = NSHostingController(rootView: view)
 
        let panel = NSPanel(
            contentRect: NSRect(x: 0, y: 0, width: 440, height: 560),
            styleMask: [.titled, .closable, .resizable, .utilityWindow, .nonactivatingPanel],
            backing: .buffered, defer: false
        )
        panel.title = "Session Inspector"
        panel.contentViewController = hosting
        panel.isFloatingPanel = true
        panel.becomesKeyOnlyIfNeeded = false
        panel.hidesOnDeactivate = false
        panel.collectionBehavior = [.canJoinAllSpaces, .stationary, .fullScreenAuxiliary]
        panel.level = .floating
        panel.setFrameAutosaveName("ScreenBridge.SessionInspector")
        return panel
    }
}

// run() new session 시작:
let publishedID = sessionID!
let publishedInstr = maskedInstruction
Task { @MainActor in
    InspectorState.shared.beginSession(
        id: publishedID,
        instruction: publishedInstr,
        dispatcherName: "auto",
        privacyMode: "cloud"
    )
}
 
// run() analyzing 진입:
let stepIdx = history.count
Task { @MainActor in
    InspectorState.shared.markAnalyzing(stepIndex: stepIdx)
}
 
// run() step success:
let inspectorStep = InspectorState.StepView(...)
Task { @MainActor in
    InspectorState.shared.appendStep(inspectorStep)
}
 
// run() taskComplete:
Task { @MainActor in
    InspectorState.shared.finishCompleted()
}
 
// cancelSession:
Task { @MainActor in
    InspectorState.shared.finishCancelled()
}

// menu setUp:
menu.addItem(
    withTitle: "세션 진행 보기",
    action: #selector(toggleSessionInspector),
    keyEquivalent: "i"
).keyEquivalentModifierMask = [.command, .option]   // ⌥⌘I
 
// callback:
@objc private func toggleSessionInspector() {
    SessionInspectorPanel.shared.toggle { [weak self] in
        self?.cancelCurrentSession()  // Inspector "현재 세션 취소" button
    }
}

./dev.sh
  ↓
⌥⌘I → "Session Inspector" panel 떠
  - 처음엔 "⌥+Space → instruction 입력 → 진행 봄" placeholder
  ↓
⌥+Space → instruction 입력 (예: "github 알림 끄기")
  ↓
Inspector 실시간 표시:
  - Header: "분석 중... step 1" 오렌지 dot + "auto" dispatcher chip + "Cloud" badge
  - Instruction: "github 알림 끄기"
  - Steps list: 비어있음 (분석 중)
  ↓
박스 떠 + step 1 publish:
  Inspector Steps list:
    #1 GitHub 프로필 [AX:AXButton]  ← clickable not, 단 visible
       "여기 [프로필 아이콘] 누르세요"
       2.4s
  Header: "step 1 — 사용자 클릭 대기" 파랑 dot
  ↓
사용자 클릭 → ⌥+Space → continuation
  ↓
step 2 publish, list에 박힘
...
  ↓
taskComplete:
  Inspector Header: "끝났어요 ✓" 초록 dot

// 박는 거 (actor 안):
let publishedID = sessionID!                  // ← immutable copy
let publishedInstr = maskedInstruction
Task { @MainActor in
    InspectorState.shared.beginSession(
        id: publishedID, instruction: publishedInstr, ...  // ← Sendable closure
    )
}