Repository Public
1import AppKit2import MCCCore3import SwiftUI4import UniformTypeIdentifiers56/// The append-only, hash-chained audit log: filters, UTC timestamps, chain verification, signed export.7struct AuditView: View {8 @Environment(AppModel.self) private var app9 @Environment(\.mccTheme) private var theme10 @State private var form = AuditFilterForm()11 @State private var applied = AuditFilter()12 @State private var selection: String?13 @State private var exporting = false14 @State private var verifying = false1516 var body: some View {17 let audit = app.session.audit18 let entries = audit.entries[applied]19 Page(title: SidebarItem.audit.title, subtitle: tr("audit.subtitle"), scrolls: false) {20 HStack(spacing: Tokens.Space.s3) {21 Button { verifying = true; Task { await audit.verification.load() } } label: { Label(tr("audit.verify"), systemImage: "checkmark.shield") }22 .accessibilityIdentifier("audit-verify")23 if app.session.can("audit.export") {24 Button { exporting = true } label: { Label(tr("audit.export"), systemImage: "square.and.arrow.up") }25 .mutation(app, permission: "audit.export")26 .accessibilityIdentifier("audit-export")27 }28 Button { Task { await entries.load() } } label: { Label(tr("action.refresh"), systemImage: "arrow.clockwise") }29 }30 } content: {31 VStack(alignment: .leading, spacing: Tokens.Space.s3) {32 filters33 ResourceView(entries) { list in34 if list.isEmpty {35 EmptyStateView(tr("audit.empty"), message: form.isEmpty ? nil : tr("audit.empty.filtered"), systemImage: "checkmark.shield")36 } else {37 VSplitView {38 table(list).frame(minHeight: 200)39 if let e = list.first(where: { String($0.seq) == selection }) {40 AuditEntryDetail(entry: e).frame(minHeight: 180)41 }42 }43 }44 }45 }46 .padding(.horizontal, Tokens.Space.s7)47 .padding(.bottom, Tokens.Space.s5)48 }49 .task(id: applied) { await entries.load() }50 .sheet(isPresented: $verifying) { AuditVerificationSheet() }51 .sheet(isPresented: $exporting) { AuditExportSheet() }52 }5354 private var filters: some View {55 Card(padding: Tokens.Space.s4) {56 VStack(alignment: .leading, spacing: Tokens.Space.s3) {57 HStack(spacing: Tokens.Space.s3) {58 TextField(tr("audit.filter.action"), text: $form.action).textFieldStyle(.roundedBorder).frame(minWidth: 140)59 .accessibilityIdentifier("audit-filter-action")60 TextField(tr("audit.filter.actor"), text: $form.actorID).textFieldStyle(.roundedBorder).frame(minWidth: 140)61 TextField(tr("audit.filter.target_kind"), text: $form.targetKind).textFieldStyle(.roundedBorder).frame(width: 130)62 TextField(tr("audit.filter.target_id"), text: $form.targetID).textFieldStyle(.roundedBorder).frame(minWidth: 120)63 Picker(tr("audit.filter.outcome"), selection: $form.outcome) {64 Text(tr("audit.filter.any")).tag(API.AuditOutcome?.none)65 ForEach(API.AuditOutcome.allCases, id: \.self) { Text($0.label).tag(API.AuditOutcome?.some($0)) }66 }67 .fixedSize()68 }69 HStack(spacing: Tokens.Space.s3) {70 Toggle(tr("audit.filter.from"), isOn: $form.useFrom)71 DatePicker(tr("audit.filter.from"), selection: $form.from).labelsHidden().disabled(!form.useFrom)72 Toggle(tr("audit.filter.to"), isOn: $form.useTo)73 DatePicker(tr("audit.filter.to"), selection: $form.to).labelsHidden().disabled(!form.useTo)74 TextField(tr("audit.filter.correlation"), text: $form.correlationID).textFieldStyle(.roundedBorder).frame(minWidth: 160)75 Spacer()76 Button(tr("audit.filter.reset")) { form = AuditFilterForm(); applied = AuditFilter(); selection = nil }.disabled(form.isEmpty && applied == AuditFilter())77 Button(tr("audit.filter.apply")) { applied = form.filter; selection = nil }78 .keyboardShortcut(.defaultAction)79 .disabled(form.rangeInvalid)80 .accessibilityIdentifier("audit-filter-apply")81 }82 if form.rangeInvalid { Text(tr("audit.filter.range_invalid")).font(.caption).foregroundStyle(StatusTone.warning.color(theme)) }83 Text(tr("audit.utc_note")).font(.caption).foregroundStyle(theme.textTertiary)84 }85 }86 }8788 private func table(_ list: [API.AuditEntry]) -> some View {89 Table(list.keyed { String($0.seq) }, selection: $selection) {90 TableColumn(tr("audit.col.seq")) { r in Text(String(r.value.seq)).monospacedDigit() }.width(min: 50, ideal: 64, max: 90)91 TableColumn(tr("audit.col.time")) { r in Text(Format.utc(r.value.ts)).font(.callout.monospacedDigit()) }.width(min: 170, ideal: 190)92 TableColumn(tr("audit.col.actor")) { r in Text(AuditLogic.actor(r.value)).lineLimit(1) }93 TableColumn(tr("audit.col.action")) { r in Text(r.value.action).font(.callout.monospaced()).lineLimit(1) }94 TableColumn(tr("audit.col.target")) { r in OptionalValueText(AuditLogic.target(r.value)) }95 TableColumn(tr("audit.col.outcome")) { r in StatusLabel(r.value.outcome.label, tone: r.value.outcome.tone) }.width(min: 90, ideal: 110)96 TableColumn(tr("audit.col.correlation")) { r in97 HStack(spacing: Tokens.Space.s1) {98 Text(r.value.correlationId.prefix(8) + "…").font(.caption.monospaced()).help(r.value.correlationId)99 CopyButton(value: r.value.correlationId, label: tr("error.copy_correlation"))100 }101 }102 .width(min: 110, ideal: 130)103 }104 .accessibilityLabel(SidebarItem.audit.title)105 .accessibilityIdentifier("audit-table")106 }107}108109struct AuditEntryDetail: View {110 let entry: API.AuditEntry111 @Environment(\.mccTheme) private var theme112 var body: some View {113 ScrollView {114 VStack(alignment: .leading, spacing: Tokens.Space.s2) {115 SectionTitle(tr("audit.detail.title", String(entry.seq)))116 KeyValueRow(tr("audit.col.time"), Format.utc(entry.ts), monospaced: true)117 KeyValueRow(tr("audit.col.actor"), AuditLogic.actor(entry))118 if let id = entry.actorId { KeyValueRow(tr("audit.detail.actor_id"), id, monospaced: true) }119 KeyValueRow(tr("audit.col.action"), entry.action, monospaced: true)120 if let t = AuditLogic.target(entry) { KeyValueRow(tr("audit.col.target"), t, monospaced: true) }121 KeyValueRow(tr("audit.col.outcome"), entry.outcome.label)122 if !entry.detail.isEmpty { KeyValueRow(tr("audit.detail.detail"), entry.detail) }123 if let d = entry.deviceId { KeyValueRow(tr("audit.detail.device"), d, monospaced: true) }124 if let s = entry.sessionId { KeyValueRow(tr("audit.detail.session"), s, monospaced: true) }125 if let ip = entry.ip { KeyValueRow(tr("audit.detail.ip"), ip, monospaced: true) }126 KeyValueRow(tr("error.correlation_id"), entry.correlationId, monospaced: true)127 KeyValueRow(tr("audit.detail.prev_hash"), entry.prevHash, monospaced: true)128 KeyValueRow(tr("audit.detail.hash"), entry.hash, monospaced: true)129 Text(tr("audit.detail.params")).font(.callout).foregroundStyle(theme.textSecondary)130 JSONBlock(value: JSONValue(entry.params.additionalProperties))131 }132 .padding(Tokens.Space.s4)133 }134 .background(theme.surface)135 .accessibilityIdentifier("audit-detail")136 }137}138139struct AuditVerificationSheet: View {140 @Environment(AppModel.self) private var app141 @Environment(\.mccTheme) private var theme142 @Environment(\.dismiss) private var dismiss143 var body: some View {144 let verification = app.session.audit.verification145 VStack(alignment: .leading, spacing: Tokens.Space.s4) {146 Text(tr("audit.verify")).font(.title3.weight(.semibold))147 if verification.state.isLoading {148 ProgressView(tr("audit.verify.running"))149 } else {150 ResourceView(verification) { v in151 VStack(alignment: .leading, spacing: Tokens.Space.s2) {152 StatusBadge(v.ok ? tr("audit.verify.ok") : tr("audit.verify.broken"), tone: v.ok ? .ok : .critical)153 .accessibilityIdentifier("audit-verify-result")154 KeyValueRow(tr("audit.verify.checked"), String(v.checkedEntries))155 if let a = v.firstSeq, let b = v.lastSeq { KeyValueRow(tr("audit.verify.range"), "\(a) – \(b)") }156 if let b = v.firstBrokenSeq { KeyValueRow(tr("audit.verify.first_broken"), String(b)) }157 if let r = v.reason, !r.isEmpty { KeyValueRow(tr("audit.verify.reason"), r) }158 if let h = v.headHash { KeyValueRow(tr("audit.verify.head"), h, monospaced: true) }159 if let k = v.exportKeyId { KeyValueRow(tr("audit.verify.key_id"), k, monospaced: true) }160 if let k = v.exportPublicKey { KeyValueRow(tr("audit.verify.public_key"), k, monospaced: true) }161 KeyValueRow(tr("audit.verify.at"), Format.utc(v.verifiedAt), monospaced: true)162 }163 }164 }165 HStack { Spacer(); Button(tr("action.close")) { dismiss() }.keyboardShortcut(.defaultAction) }166 }167 .padding(Tokens.Space.s6)168 .frame(width: 600)169 .frame(minHeight: 260)170 }171}172173struct AuditExportSheet: View {174 @Environment(AppModel.self) private var app175 @Environment(\.mccTheme) private var theme176 @Environment(\.dismiss) private var dismiss177 @State private var from = Date().addingTimeInterval(-7 * 86_400)178 @State private var to = Date()179 @State private var format: AuditRepository.ExportFormat = .ndjson180 @State private var working = false181 @State private var failure: APIError?182 @State private var savedTo: URL?183184 var body: some View {185 VStack(alignment: .leading, spacing: Tokens.Space.s4) {186 Text(tr("audit.export")).font(.title3.weight(.semibold))187 Form {188 DatePicker(tr("audit.filter.from"), selection: $from)189 DatePicker(tr("audit.filter.to"), selection: $to)190 Picker(tr("audit.export.format"), selection: $format) {191 Text("NDJSON").tag(AuditRepository.ExportFormat.ndjson)192 Text("CSV").tag(AuditRepository.ExportFormat.csv)193 }194 .pickerStyle(.segmented)195 }196 .formStyle(.grouped)197 if !AuditLogic.exportRangeValid(from: from, to: to) {198 Text(tr("audit.export.range_invalid")).font(.caption).foregroundStyle(StatusTone.warning.color(theme))199 }200 Text(tr("audit.export.help")).font(.caption).foregroundStyle(theme.textTertiary)201 if let failure { InlineErrorView(failure) }202 if let savedTo {203 InfoBanner(tone: .ok, title: tr("audit.export.saved"), message: savedTo.path)204 .accessibilityIdentifier("audit-export-saved")205 }206 HStack {207 if working { ProgressView().controlSize(.small) }208 Spacer()209 Button(tr("action.close")) { dismiss() }.keyboardShortcut(.cancelAction)210 Button(tr("audit.export.confirm")) { export() }211 .keyboardShortcut(.defaultAction)212 .disabled(working || !AuditLogic.exportRangeValid(from: from, to: to))213 .mutation(app, permission: "audit.export")214 }215 }216 .padding(Tokens.Space.s6)217 .frame(width: 520)218 }219220 private func export() {221 Task {222 working = true; failure = nil; savedTo = nil223 defer { working = false }224 do {225 // Step-up (passkey) happens inside when the server asks for it; the bytes are only held until saved.226 let data = try await app.session.audit.export(from: from, to: to, format: format)227 let panel = NSSavePanel()228 panel.nameFieldStringValue = AuditLogic.exportFileName(from: from, to: to, format: format)229 panel.allowedContentTypes = [format == .csv ? .commaSeparatedText : (UTType(filenameExtension: "ndjson") ?? .json)]230 panel.canCreateDirectories = true231 guard panel.runModal() == .OK, let url = panel.url else { return }232 try data.write(to: url, options: [.atomic])233 savedTo = url234 } catch let e as CocoaError {235 failure = APIError(code: "client.file", message: e.localizedDescription)236 } catch {237 let e = APIError.from(error)238 if !e.isPasskeyCancelled && !e.isCancelled { failure = e }239 }240 }241 }242}243