Repository Public
1import AppKit2import Foundation3import Observation4import PersistenceCore5import TerminalCore6import WorkspaceCore7import os89/// Bridges the live `WorkspaceController` to the SQLite stores: loads settings and the current10/// workspace at launch, then saves with a short debounce after every change.11@MainActor12final class PersistenceCoordinator {13 static let logger = Logger(subsystem: "ai.spboucher.nexterm", category: "persistence")14 static let settingsKey = "app.settings"1516 let database: SQLiteDatabase17 let workspaces: WorkspaceStore18 let settings: SettingsStore19 let hosts: HostStore20 private weak var controller: WorkspaceController?21 private var saveTask: Task<Void, Never>?22 private(set) var lastSaveAt: Date?23 private(set) var lastError: String?2425 init(dataDirectory: String?) throws {26 database = try PersistenceLocations.openDatabase(override: dataDirectory)27 workspaces = WorkspaceStore(database: database)28 settings = SettingsStore(database: database)29 hosts = HostStore(database: database)30 }3132 /// Loads persisted settings (defaults when missing/corrupt) and the current workspace.33 func loadSettings() -> AppSettings {34 settings.get(Self.settingsKey, as: AppSettings.self) ?? .default35 }3637 func loadWorkspace() -> WorkspaceState? {38 do {39 guard var ws = try workspaces.loadCurrent(), !ws.windows.isEmpty else { return nil }40 // Restoration = re-creating processes: give every pane a fresh session identity so that41 // nothing can be mistaken for a reattached process.42 var panes: [PaneID: PaneState] = [:]43 for (id, pane) in ws.panes {44 var p = pane45 p.sessionID = SessionID()46 panes[id] = p47 }48 ws.panes = panes49 return ws50 } catch {51 lastError = "load failed: \(error)"52 Self.logger.error("workspace load failed: \(String(describing: error), privacy: .public)")53 return nil54 }55 }5657 func attach(to controller: WorkspaceController) {58 self.controller = controller59 controller.changeHandler = { [weak self] in self?.scheduleSave() }60 }6162 func scheduleSave(delay: Duration = .milliseconds(400)) {63 saveTask?.cancel()64 saveTask = Task { [weak self] in65 try? await Task.sleep(for: delay)66 guard !Task.isCancelled else { return }67 self?.saveNow()68 }69 }7071 func saveNow() {72 guard let controller else { return }73 let snapshot = controller.snapshotForPersistence()74 do {75 try workspaces.save(snapshot)76 try settings.set(Self.settingsKey, controller.settings)77 lastSaveAt = Date()78 lastError = nil79 } catch {80 lastError = "save failed: \(error)"81 Self.logger.error("workspace save failed: \(String(describing: error), privacy: .public)")82 }83 }84}8586/// Which panes were re-created from a saved layout (vs. reattached) — surfaced in the pane UI so the87/// user is never misled about process continuity.88enum RestorationKind: Sendable {89 case layoutOnlyNewProcess90 case reattached91}92