sneakoscope 7.3.0 → 7.6.0

package/dist/native/sks-menubar/Sources/RemoteTelegramRendering.swift

@@ -0,0 +1,484 @@
+import Cocoa
+
+extension RemoteTelegramViewController {
+    func render(remote: [String: Any]?, telegram: [String: Any]?) {
+        if let remote = remote {
+            let host = remote["host"] as? [String: Any]
+            let project = remote["project"] as? [String: Any]
+            let blockers = remote["blockers"] as? [String] ?? []
+            readinessStatus.stringValue = "Project \(remote["ok"] as? Bool == true ? "ready" : "needs attention") · Codex App \(host?["codex_app_found"] as? Bool == true ? "found" : "missing") · CLI \(host?["codex_cli_found"] as? Bool == true ? "found" : "missing") · Git \(project?["git_repo"] as? Bool == true ? "ready" : "missing")" + (blockers.isEmpty ? "" : " · \(blockers.prefix(2).joined(separator: "; "))")
+        } else {
+            readinessStatus.stringValue = "Project readiness is unavailable. Open Diagnostics for the redacted log."
+        }
+
+        guard let telegram = telegram else {
+            ControlKit.setBadge(
+                setupReady ? connectionBadge : setupBadge,
+                text: "Telegram live status unavailable",
+                tone: .warning
+            )
+            if setupReady {
+                connectionStatus.stringValue = "The linked session and locally readable Codex history are retained. Retry status to restore live bot diagnostics."
+            } else {
+                setupStatus.stringValue = "Telegram setup status is unavailable."
+            }
+            renderVisibility()
+            return
+        }
+        let token = telegram["token_configured"] as? Bool == true
+        let botVerified = telegram["bot_verified"] as? Bool == true
+        let bot = telegram["bot"] as? [String: Any]
+        let username = (bot?["username"] as? String).map { "@\($0)" }
+        let webhookConfigured = telegram["webhook_configured"] as? Bool == true
+        let longPollReady = telegram["long_poll_ready"] as? Bool == true
+        let pairing = telegram["pairing_valid"] as? Bool == true
+        let sessions = telegram["registered_session_count"] as? Int ?? 0
+        let blockers = telegram["blockers"] as? [String] ?? []
+        let identityMigrationRequired = blockers.contains("telegram_identity_migration_required")
+        let transientBlockers: Set<String> = [
+            "telegram_hub_not_running",
+            "telegram_receive_not_ready",
+            "telegram_bot_probe_failed",
+            "telegram_ingress_dead_letter_present"
+        ]
+        let setupBlockers = blockers.filter { !transientBlockers.contains($0) }
+        let nextAction = (telegram["next_actions"] as? [String])?.first
+        setupReady = token && pairing && sessions > 0 && setupBlockers.isEmpty
+        hubRunning = telegram["hub_running"] as? Bool == true
+        let hubReady = telegram["hub_ready"] as? Bool == true
+        deadLetterIngressCount = telegram["dead_letter_ingress"] as? Int ?? 0
+        registeredSessionCount = sessions
+        updateSessions(telegram["registered_sessions"] as? [[String: Any]] ?? [])
+
+        if setupReady && botVerified && longPollReady {
+            ControlKit.setBadge(connectionBadge, text: "\(username ?? "Telegram bot") connected", tone: .ok)
+            connectionStatus.stringValue = "Private account paired · \(sessions) coding session\(sessions == 1 ? "" : "s") · the selector chooses the thread shown below."
+        } else if setupReady {
+            ControlKit.setBadge(connectionBadge, text: "Telegram linked · live probe degraded", tone: .warning)
+            connectionStatus.stringValue = "The saved pairing, session selector, and Codex history remain available. Refresh status to restore live Bot API readiness."
+        } else if identityMigrationRequired {
+            ControlKit.setBadge(setupBadge, text: "Reconnect once for Telegram v2", tone: .warning)
+            setupStatus.stringValue = nextAction
+                ?? "Stop the Telegram Hub, then reconnect this project once to write the v2 bot and private-pair identity."
+        } else if webhookConfigured {
+            ControlKit.setBadge(setupBadge, text: "Existing webhook blocks long polling", tone: .error)
+            setupStatus.stringValue = "Remove the bot’s existing webhook in the service that created it, send /start again, then reconnect."
+        } else {
+            ControlKit.setBadge(setupBadge, text: "Complete the 3 setup steps", tone: .warning)
+            setupStatus.stringValue = setupGuidance(
+                token: token,
+                botVerified: botVerified,
+                longPollReady: longPollReady,
+                pairing: pairing,
+                sessions: sessions,
+                fallback: nextAction
+            )
+        }
+
+        let service = telegram["service"] as? [String: Any]
+        let installed = service?["installed"] as? Bool == true
+        let state = service?["state"] as? String
+        let mode = service?["mode"] as? String
+        let runtimeLabel = mode == "direct"
+            ? "Center supervised"
+            : state.map { "launchd \($0)" }
+        ControlKit.setBadge(
+            hubBadge,
+            text: deadLetterIngressCount > 0
+                ? "Telegram ingress needs recovery"
+                : hubReady
+                ? "Telegram Hub ready"
+                : hubRunning
+                ? "Telegram Hub receiving degraded"
+                : setupReady
+                ? "Telegram Hub stopped"
+                : "Telegram Hub waits for setup",
+            tone: deadLetterIngressCount > 0 ? .error : hubReady ? .ok : hubRunning || setupReady ? .warning : .neutral
+        )
+        hubStatus.stringValue = deadLetterIngressCount > 0
+            ? hubRunning
+                ? "\(deadLetterIngressCount) failed ingress record\(deadLetterIngressCount == 1 ? "" : "s") · Stop Hub, acknowledge the failure, restart, then resend the request."
+                : "\(deadLetterIngressCount) failed ingress record\(deadLetterIngressCount == 1 ? "" : "s") · Acknowledge below, restart Hub, then resend the request."
+            : (runtimeLabel ?? (installed ? "Local Hub" : "Hub not installed"))
+                + (hubReady ? " · ordinary Telegram text reaches Codex" : hubRunning ? " · receive path not ready" : setupReady ? " · stopped; click Start Hub" : "")
+        renderVisibility()
+    }
+
+    private func updateSessions(_ sessions: [[String: Any]]) {
+        let previous = selectedSessionId
+        let projectName = URL(fileURLWithPath: AppRuntime.projectRoot).lastPathComponent
+        sessionPicker.removeAllItems()
+        for session in sessions {
+            guard let sessionId = session["session_id"] as? String, !sessionId.isEmpty else { continue }
+            let threadReady = (session["codex_thread_id"] as? String)?.isEmpty == false
+            let suffix = threadReady ? "thread ready" : "awaiting first message"
+            sessionPicker.addItem(withTitle: "\(projectName) · session …\(sessionId.suffix(4)) · \(suffix)")
+            sessionPicker.lastItem?.representedObject = sessionId
+        }
+        if sessionPicker.numberOfItems == 0 {
+            sessionPicker.addItem(withTitle: "No registered coding session")
+            selectedSessionId = nil
+            if previous != nil {
+                invalidateCenterRequests()
+                clearLoadedCenterState()
+                resetConversationPagination()
+            }
+            return
+        }
+        if let previous = previous,
+           let index = sessionPicker.itemArray.firstIndex(where: { ($0.representedObject as? String) == previous }) {
+            sessionPicker.selectItem(at: index)
+            selectedSessionId = previous
+        } else {
+            sessionPicker.selectItem(at: 0)
+            selectedSessionId = sessionPicker.selectedItem?.representedObject as? String
+        }
+        if selectedSessionId != previous {
+            invalidateCenterRequests()
+            clearLoadedCenterState()
+            resetConversationPagination()
+        }
+    }
+
+    func renderVisibility() {
+        setupCard?.isHidden = setupReady
+        connectedCard?.isHidden = !setupReady
+        workspaceCard?.isHidden = !setupReady
+    }
+
+    func renderSnapshot(_ snapshot: [String: Any]) {
+        guard snapshot["schema"] as? String == "sks.telegram-center-snapshot.v1" else {
+            ControlKit.setBadge(liveSourceBadge, text: "Unexpected snapshot format", tone: .error)
+            snapshotStatus.stringValue = "Center refused an unrecognized Telegram snapshot."
+            return
+        }
+        if let selected = snapshot["selected_session_id"] as? String, !selected.isEmpty {
+            selectedSessionId = selected
+        }
+        loadedSessionId = selectedSessionId
+        loadedConversationRevision = snapshot["conversation_revision"] as? String
+        loadedLiveActivityDigest = snapshot["live_activity_digest"] as? String
+        liveTriggeredConversationRevision = nil
+        let source = snapshot["source"] as? [String: Any]
+        loadedLiveActivityState = source?["live_activity_state"] as? String ?? "pending"
+        loadedLiveActivityError = source?["live_activity_error"] as? String
+        let state = snapshot["state"] as? String ?? "unavailable"
+        let guidance = snapshot["guidance"] as? String
+        if state == "awaiting_first_message" {
+            loadedTranscriptRows = []
+            loadedHistoryActivityRows = []
+            loadedLiveActivityRows = []
+            loadedThreadId = nil
+            loadedThreadStatus = "awaiting_first_message"
+            loadedConversationPageTurnCount = 0
+            loadedSnapshotTruncated = false
+            applyConversationPage(nil)
+            ControlKit.setBadge(liveSourceBadge, text: "Waiting for the first ordinary Telegram message", tone: .warning)
+            snapshotStatus.stringValue = (guidance ?? "Send ordinary text to create the dedicated Codex thread.") + " Local journal files are checked every 2.5 seconds and refreshed only after a change."
+            renderConversationPlaceholder("No Codex conversation exists yet.\n\nSend an ordinary text message to the paired bot; the first completed turn creates and persists this thread.")
+            renderActivityPlaceholder("Live public activity starts with that first real Codex turn.")
+            return
+        }
+        if state != "ready" {
+            loadedTranscriptRows = []
+            loadedHistoryActivityRows = []
+            loadedLiveActivityRows = []
+            loadedThreadId = nil
+            loadedThreadStatus = state
+            loadedConversationPageTurnCount = 0
+            loadedSnapshotTruncated = false
+            applyConversationPage(nil)
+            ControlKit.setBadge(liveSourceBadge, text: "Codex thread not ready", tone: .neutral)
+            snapshotStatus.stringValue = guidance ?? "Connect Telegram and select a registered coding session."
+            renderConversationPlaceholder("No linked conversation is available.")
+            renderActivityPlaceholder("No linked activity is available.")
+            return
+        }
+
+        let thread = snapshot["thread"] as? [String: Any]
+        loadedThreadId = thread?["id"] as? String
+        loadedThreadStatus = thread?["status"] as? String ?? "unknown"
+        loadedTranscriptRows = boundedRows(snapshot["transcript"] as? [[String: Any]] ?? [])
+        let activity = boundedRows(snapshot["activity"] as? [[String: Any]] ?? [])
+        loadedHistoryActivityRows = activity.filter { ($0["source"] as? String) != "remote_event_journal" }
+        loadedLiveActivityRows = activity.filter { ($0["source"] as? String) == "remote_event_journal" }
+        let conversationPage = snapshot["conversation_page"] as? [String: Any]
+        applyConversationPage(conversationPage)
+        let truncation = snapshot["truncation"] as? [String: Any]
+        loadedSnapshotTruncated = truncation?["truncated"] as? Bool == true
+        loadedConversationPageTurnCount = conversationPage?["page_turn_count"] as? Int ?? 0
+        renderLoadedStatus()
+        renderTranscript(loadedTranscriptRows)
+        renderActivity(mergedActivityRows())
+    }
+
+    func renderLiveSnapshot(_ live: [String: Any]) {
+        guard live["schema"] as? String == "sks.telegram-center-live.v1" else {
+            renderLiveFailure()
+            return
+        }
+        let source = live["source"] as? [String: Any]
+        loadedLiveActivityState = source?["live_activity_state"] as? String ?? "pending"
+        loadedLiveActivityError = source?["live_activity_error"] as? String
+        let digest = live["live_activity_digest"] as? String
+        if digest != loadedLiveActivityDigest {
+            loadedLiveActivityRows = boundedRows(live["activity"] as? [[String: Any]] ?? [])
+            loadedLiveActivityDigest = digest
+            renderActivity(mergedActivityRows())
+        }
+        renderLoadedStatus()
+    }
+
+    func renderLiveFailure() {
+        liveSourceFileSignature = nil
+        ControlKit.setBadge(liveSourceBadge, text: "Journal refresh temporarily unavailable", tone: .warning)
+        snapshotStatus.stringValue = loadedSessionId == nil
+            ? "The lightweight public journal could not be read. The next 2.5-second check will retry."
+            : "The last loaded conversation and public activity remain visible. The next lightweight journal check will retry."
+    }
+
+    private func renderTranscript(_ rows: [[String: Any]]) {
+        guard !rows.isEmpty else {
+            renderConversationPlaceholder("The linked thread has no retained user or assistant messages.")
+            return
+        }
+        let signature = rowSignature(
+            rows,
+            fields: ["id", "role", "phase", "occurred_at", "text"]
+        )
+        guard signature != renderedTranscriptSignature else { return }
+        renderedTranscriptSignature = signature
+        let output = NSMutableAttributedString()
+        for row in rows {
+            let role = row["role"] as? String == "assistant" ? "Codex" : "You"
+            let phase = row["phase"] as? String
+            let time = shortTime(row["occurred_at"] as? String)
+            let header = [time, role, phase].compactMap { value -> String? in
+                guard let value = value, !value.isEmpty else { return nil }
+                return value
+            }.joined(separator: " · ")
+            output.append(NSAttributedString(
+                string: "\(header)\n",
+                attributes: [
+                    .font: NSFont.systemFont(ofSize: 11, weight: .semibold),
+                    .foregroundColor: role == "Codex" ? NSColor.systemBlue : NSColor.labelColor
+                ]
+            ))
+            output.append(NSAttributedString(
+                string: "\(row["text"] as? String ?? "")\n\n",
+                attributes: [
+                    .font: NSFont.systemFont(ofSize: 12),
+                    .foregroundColor: NSColor.labelColor
+                ]
+            ))
+        }
+        conversationView.textStorage?.setAttributedString(output)
+    }
+
+    private func renderActivity(_ rows: [[String: Any]]) {
+        guard !rows.isEmpty else {
+            renderActivityPlaceholder("No public tool, file, search, subagent, or turn activity is retained yet.")
+            return
+        }
+        let signature = rowSignature(
+            rows,
+            fields: ["id", "occurred_at", "title", "status", "detail"]
+        )
+        guard signature != renderedActivitySignature else { return }
+        renderedActivitySignature = signature
+        let output = NSMutableAttributedString()
+        for row in rows {
+            let time = shortTime(row["occurred_at"] as? String) ?? "—"
+            let title = row["title"] as? String ?? "Codex activity"
+            let status = row["status"] as? String ?? "unknown"
+            output.append(NSAttributedString(
+                string: "\(time)  \(title) · \(status)\n",
+                attributes: [
+                    .font: NSFont.systemFont(ofSize: 11, weight: .medium),
+                    .foregroundColor: NSColor.labelColor
+                ]
+            ))
+            if let detail = row["detail"] as? String, !detail.isEmpty {
+                output.append(NSAttributedString(
+                    string: "     \(detail)\n",
+                    attributes: [
+                        .font: NSFont.monospacedSystemFont(ofSize: 10, weight: .regular),
+                        .foregroundColor: NSColor.secondaryLabelColor
+                    ]
+                ))
+            }
+        }
+        activityView.textStorage?.setAttributedString(output)
+    }
+
+    func renderConversationPlaceholder(_ text: String) {
+        renderedTranscriptSignature = nil
+        conversationView.string = text
+        conversationView.font = NSFont.systemFont(ofSize: 12)
+        conversationView.textColor = .secondaryLabelColor
+    }
+
+    func renderActivityPlaceholder(_ text: String) {
+        renderedActivitySignature = nil
+        activityView.string = text
+        activityView.font = NSFont.systemFont(ofSize: 11)
+        activityView.textColor = .secondaryLabelColor
+    }
+
+    func guideStep(_ number: String, title: String, detail: String) -> NSStackView {
+        let numberLabel = NSTextField(labelWithString: number)
+        numberLabel.font = NSFont.systemFont(ofSize: 11, weight: .bold)
+        numberLabel.textColor = .white
+        numberLabel.alignment = .center
+        numberLabel.backgroundColor = .controlAccentColor
+        numberLabel.drawsBackground = true
+        numberLabel.isBordered = false
+        numberLabel.widthAnchor.constraint(equalToConstant: 22).isActive = true
+        numberLabel.heightAnchor.constraint(equalToConstant: 22).isActive = true
+        numberLabel.setContentHuggingPriority(.required, for: .horizontal)
+
+        let titleLabel = NSTextField(labelWithString: title)
+        titleLabel.font = NSFont.systemFont(ofSize: 12, weight: .medium)
+        let detailLabel = NativeView.detail(detail)
+        detailLabel.textColor = .labelColor
+        let copy = NSStackView(views: [titleLabel, detailLabel])
+        copy.orientation = .vertical; copy.alignment = .leading; copy.spacing = 2
+        copy.setContentHuggingPriority(.defaultLow, for: .horizontal); for view in copy.arrangedSubviews { view.widthAnchor.constraint(equalTo: copy.widthAnchor).isActive = true }
+        let row = NSStackView(views: [numberLabel, copy])
+        row.orientation = .horizontal
+        row.alignment = .top
+        row.spacing = 9
+        copy.widthAnchor.constraint(equalTo: row.widthAnchor, constant: -31).isActive = true
+        return row
+    }
+
+    func textArea(_ textView: NSTextView, height: CGFloat) -> NSScrollView {
+        let scroll = NSScrollView()
+        scroll.documentView = textView
+        scroll.hasVerticalScroller = true
+        scroll.hasHorizontalScroller = false
+        scroll.autohidesScrollers = true
+        scroll.borderType = .bezelBorder
+        scroll.drawsBackground = true
+        scroll.backgroundColor = .textBackgroundColor
+        scroll.heightAnchor.constraint(equalToConstant: height).isActive = true
+        return scroll
+    }
+
+    static func readOnlyTextView(label: String) -> NSTextView {
+        let text = NSTextView()
+        text.isEditable = false
+        text.isSelectable = true
+        text.isRichText = true
+        text.drawsBackground = false
+        text.textContainerInset = NSSize(width: 10, height: 9)
+        text.isHorizontallyResizable = false
+        text.autoresizingMask = [.width]
+        text.textContainer?.widthTracksTextView = true
+        text.textContainer?.containerSize = NSSize(width: 0, height: CGFloat.greatestFiniteMagnitude)
+        text.setAccessibilityLabel(label)
+        return text
+    }
+
+    private func shortId(_ value: String) -> String {
+        value.count > 14 ? "\(value.prefix(8))…\(value.suffix(4))" : value
+    }
+
+    private func shortTime(_ value: String?) -> String? {
+        guard let value = value,
+              let date = Self.iso8601FractionalFormatter.date(from: value)
+                ?? Self.iso8601Formatter.date(from: value) else { return nil }
+        return Self.shortTimeFormatter.string(from: date)
+    }
+
+    func json(_ text: String) -> [String: Any]? {
+        guard let data = text.data(using: .utf8) else { return nil }
+        if let object = try? JSONSerialization.jsonObject(with: data) as? [String: Any] { return object }
+        guard let start = text.firstIndex(of: "{"), let end = text.lastIndex(of: "}") else { return nil }
+        let slice = String(text[start...end])
+        guard let sliced = slice.data(using: .utf8) else { return nil }
+        return try? JSONSerialization.jsonObject(with: sliced) as? [String: Any]
+    }
+
+    private func renderLoadedStatus() {
+        guard loadedSessionId != nil, loadedThreadId != nil else { return }
+        let liveActivityDegraded = loadedLiveActivityState == "degraded"
+        let pageName = isViewingLatestConversationPage ? "Latest page" : "Stored history page"
+        let refreshState = isViewingLatestConversationPage
+            ? "journal files checked every 2.5 seconds; lightweight refresh runs only after a change, and conversation refreshes after completed turns or manual navigation"
+            : "journal polling paused; select Latest to resume"
+        let activityCount = mergedActivityRows().count
+        let threadStatus = userFacingThreadStatus(loadedThreadStatus)
+        ControlKit.setBadge(
+            liveSourceBadge,
+            text: liveActivityDegraded
+                ? "History ready · live activity degraded"
+                : isViewingLatestConversationPage
+                ? "Live · lightweight journal polling"
+                : "History · live polling paused",
+            tone: liveActivityDegraded ? .warning : isViewingLatestConversationPage ? .ok : .neutral
+        )
+        snapshotStatus.stringValue = "Thread \(shortId(loadedThreadId ?? "unknown")) · \(threadStatus). \(pageName): \(loadedConversationPageTurnCount) turns, \(loadedTranscriptRows.count) messages, \(activityCount) public activity items. \(refreshState)." + (loadedSnapshotTruncated ? " This page was display-bounded." : "") + (liveActivityDegraded ? " Live journal warning: \(loadedLiveActivityError ?? "remote_event_journal_degraded")." : "")
+    }
+
+    private func mergedActivityRows() -> [[String: Any]] {
+        var rowsById: [String: [String: Any]] = [:]
+        let historyDedupeKeys = Set(loadedHistoryActivityRows.compactMap { row -> String? in
+            guard let key = row["dedupe_key"] as? String, !key.isEmpty else { return nil }
+            return key
+        })
+        let uniqueLiveRows = loadedLiveActivityRows.filter { row in
+            guard let key = row["dedupe_key"] as? String, !key.isEmpty else { return true }
+            return !historyDedupeKeys.contains(key)
+        }
+        for row in loadedHistoryActivityRows + uniqueLiveRows {
+            guard let id = row["id"] as? String, !id.isEmpty else { continue }
+            rowsById[id] = row
+        }
+        let sorted = rowsById.values.sorted { left, right in
+            let leftTime = activitySortDate(left["occurred_at"] as? String)
+            let rightTime = activitySortDate(right["occurred_at"] as? String)
+            if leftTime != rightTime { return leftTime < rightTime }
+            return (left["id"] as? String ?? "") < (right["id"] as? String ?? "")
+        }
+        return boundedRows(sorted)
+    }
+
+    private func boundedRows(_ rows: [[String: Any]], limit: Int = 768) -> [[String: Any]] {
+        guard rows.count > limit else { return rows }
+        return Array(rows.suffix(limit))
+    }
+
+    private func activitySortDate(_ value: String?) -> Date {
+        guard let value = value else { return .distantPast }
+        return Self.iso8601FractionalFormatter.date(from: value)
+            ?? Self.iso8601Formatter.date(from: value)
+            ?? .distantPast
+    }
+
+    private func rowSignature(_ rows: [[String: Any]], fields: [String]) -> String {
+        rows.map { row in
+            fields.map { field in
+                row[field].map { String(describing: $0) } ?? ""
+            }.joined(separator: "\u{1f}")
+        }.joined(separator: "\u{1e}")
+    }
+
+    private static let iso8601FractionalFormatter: ISO8601DateFormatter = {
+        let formatter = ISO8601DateFormatter()
+        formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+        return formatter
+    }()
+
+    private static let iso8601Formatter: ISO8601DateFormatter = {
+        let formatter = ISO8601DateFormatter()
+        formatter.formatOptions = [.withInternetDateTime]
+        return formatter
+    }()
+
+    private static let shortTimeFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.dateFormat = "HH:mm:ss"
+        return formatter
+    }()
+}