Repository Public
1// SP Notes Core2// File: Tests/SPNotesAPITests/LiveParityTests.swift3// Description: Integration tests of the parity route groups against the SCRATCH backend only (never production):4// databases, search, graph links, inbox, research, AI bookkeeping, agents, dashboard, settings, trash.5// Skipped unless SPN_LIVE_URL and SPN_LIVE_TOKEN are set. Nothing here calls a paid model: no chat turn,6// no agent run, hybrid search with `semantic: false` only.7//8// Author: Simon-Pierre Boucher9// Contact: contact@spboucher.ai10import Foundation11import XCTest12@testable import SPNotesAPI1314final class LiveParityTests: XCTestCase {15 // MARK: databases1617 func testDatabaseLifecycle() async throws {18 let live = try await LiveParity.make()19 let api = live.api20 let host = try await live.page(self, "base", type: .database, section: .databases)2122 // The object is born when the database is first opened with its host page id.23 var database = try await api.database(id: host.id)24 XCTAssertEqual(database.pageId, host.id)25 XCTAssertEqual(database.properties?.map(\.type), [DatabasePropertyType.title])26 let title = try XCTUnwrap(database.titleProperty)27 let listed = try await api.databases()28 XCTAssertTrue(listed.contains { $0.id == database.id && $0.rowCount == 0 })29 database = try await api.updateDatabase(id: database.id, DatabaseChanges(description: .value("live"), icon: .value("🏠")))30 XCTAssertEqual(database.description, "live")3132 // Properties: client id, idempotent creation, patch, formula.33 let statusID = NotesAPI.newID()34 let options = [DatabaseSelectOption(id: "optlive1", name: "Loué", color: "green"), DatabaseSelectOption(id: "optlive2", name: "Vacant", color: "red")]35 let draft = DatabasePropertyDraft(id: statusID, name: "État", type: DatabasePropertyType.select, config: DatabasePropertyConfig(options: options))36 let status = try await api.createDatabaseProperty(databaseID: database.id, draft)37 XCTAssertEqual(status.id, statusID)38 XCTAssertEqual(status.options, options)39 var retry = draft40 retry.name = "Autre"41 let again = try await api.createDatabaseProperty(databaseID: host.id, retry)42 XCTAssertEqual(again, status, "same id: the stored property, untouched")43 let price = try await api.createDatabaseProperty(databaseID: database.id, DatabasePropertyDraft(name: "Prix", type: DatabasePropertyType.number))44 let double = try await api.createDatabaseProperty(databaseID: database.id, DatabasePropertyDraft(name: "Double", type: DatabasePropertyType.formula, config: DatabasePropertyConfig(expression: #"prop("Prix") * 2"#)))45 let renamed = try await api.updateDatabaseProperty(databaseID: database.id, propertyID: price.id, DatabasePropertyChanges(width: .value(140)))46 XCTAssertEqual(renamed.width, 140)47 let secondTitle = await captureAPIError { try await api.createDatabaseProperty(databaseID: database.id, DatabasePropertyDraft(name: "T2", type: DatabasePropertyType.title)) }48 XCTAssertEqual(secondTitle?.status, 400)49 _ = try await api.reorderDatabaseProperties(databaseID: database.id, order: [price.id, statusID])5051 // Views.52 let board = try await api.createDatabaseView(databaseID: database.id, DatabaseViewDraft(id: NotesAPI.newID(), name: "Par état", type: DatabaseViewType.board, config: DatabaseViewConfig(sorts: [DatabaseSort(property: price.id, descending: true)], groupBy: statusID)))53 XCTAssertEqual(board.typedConfig.groupBy, statusID)54 let patchedView = try await api.updateDatabaseView(databaseID: database.id, viewID: board.id, DatabaseViewChanges(name: "Tableau", isDefault: true))55 XCTAssertEqual(patchedView.isDefault, true)56 let views = try await api.databaseViews(databaseID: database.id)57 XCTAssertEqual(views.count, 2)5859 // Rows: client ids for the row and its page, idempotent creation, bulk, update.60 let rowID = NotesAPI.newID(), rowPage = NotesAPI.newID()61 let values = RawJSON(string: #"{"\#(statusID)":"optlive1","\#(price.id)":425000}"#)62 let row = try await api.createDatabaseRow(databaseID: database.id, DatabaseRowDraft(id: rowID, pageId: rowPage, title: live.title("ligne A"), values: values))63 live.cleanUp(self, page: rowPage)64 XCTAssertEqual(row.id, rowID)65 XCTAssertEqual(row.pageId, rowPage)66 XCTAssertEqual(row.cell(price.id)?.double, 425_000)67 XCTAssertEqual(row.cell(double.id)?.double, 850_000, "the formula is computed by the server")68 XCTAssertEqual(row.cell(title.id)?.string, live.title("ligne A"))69 let rowAgain = try await api.createDatabaseRow(databaseID: database.id, DatabaseRowDraft(id: rowID, pageId: rowPage, title: "retry"))70 XCTAssertEqual(rowAgain.title, row.title, "same id: never overwritten")71 let bulk = try await api.createDatabaseRows(databaseID: database.id, [72 DatabaseRowDraft(title: live.title("ligne B"), values: RawJSON(string: #"{"\#(price.id)":560000}"#)),73 DatabaseRowDraft(title: live.title("ligne C"), values: RawJSON(string: #"{"Prix":80000,"\#(statusID)":"optlive2"}"#)),74 ])75 bulk.forEach { live.cleanUp(self, page: $0.pageId) }76 XCTAssertEqual(bulk.map { $0.cell(price.id)?.double }, [560_000, 80_000], "values may be keyed by property name")77 let updated = try await api.updateDatabaseRow(databaseID: database.id, rowID: rowID, values: RawJSON(string: #"{"\#(price.id)":430000,"\#(statusID)":null}"#))78 XCTAssertEqual(updated.cell(double.id)?.double, 860_000)79 XCTAssertNil(updated.cell(statusID))80 let many = try await api.updateDatabaseRows(databaseID: database.id, [DatabaseRowUpdate(id: bulk[0].id, values: RawJSON(string: #"{"\#(statusID)":"optlive1"}"#))])81 XCTAssertEqual(many.first?.cell(statusID)?.string, "optlive1")82 _ = try await api.reorderDatabaseRows(databaseID: database.id, order: [bulk[1].id, rowID, bulk[0].id])8384 // Query: filter + sort + paging, the view, search, light references.85 let filter = DatabaseFilter.all([.rule(price.id, DatabaseFilterOp.gte, 400_000)])86 let page1 = try await api.queryDatabase(id: database.id, DatabaseQuery(filter: .value(filter), sorts: [DatabaseSort(property: price.id, descending: true)], limit: 1))87 XCTAssertEqual(page1.total, 2)88 XCTAssertEqual(page1.rows.map(\.id), [bulk[0].id])89 XCTAssertTrue(page1.hasMore)90 let byView = try await api.queryDatabase(id: database.id, DatabaseQuery(viewId: board.id))91 XCTAssertEqual(byView.rows.compactMap { $0.cell(price.id)?.double }, [560_000, 430_000, 80_000], "the sort of the view")92 let found = try await api.queryDatabase(id: host.id, DatabaseQuery(search: "ligne C"))93 XCTAssertEqual(found.rows.map(\.id), [bulk[1].id])94 let refs = try await api.databaseRowRefs(databaseID: database.id, search: live.marker, limit: 10)95 XCTAssertEqual(refs.map(\.rowId), [bulk[1].id, rowID, bulk[0].id], "in the stored order")96 let stored = try await api.databaseRows(databaseID: database.id, limit: 2, offset: 1)97 XCTAssertEqual(stored.rows.map(\.id), [rowID, bulk[0].id])98 XCTAssertEqual(stored.total, 3)99100 // CSV out and in.101 let csv = try await api.databaseCSV(id: database.id, viewID: board.id)102 XCTAssertTrue(csv.hasPrefix("\u{FEFF}"))103 XCTAssertTrue(csv.contains("ligne B"))104 let file = FileManager.default.temporaryDirectory.appendingPathComponent("spn-live-\(UUID().uuidString).csv")105 try Data("Name,Prix,Quartier\n\(live.title("ligne D")),100000,Hull\n".utf8).write(to: file)106 defer { try? FileManager.default.removeItem(at: file) }107 let imported = try await api.importDatabaseCSV(databaseID: database.id, fileURL: file)108 XCTAssertEqual(imported.created, 1)109 XCTAssertEqual(imported.properties, ["Quartier"])110 let withImport = try await api.databaseRowRefs(databaseID: database.id, search: "ligne D")111 withImport.forEach { live.cleanUp(self, page: $0.pageId) }112 XCTAssertEqual(withImport.count, 1)113114 // Delete, the typed 409 of a deleted client id, restore.115 let deleted = try await api.deleteDatabaseRows(databaseID: database.id, ids: [bulk[1].id])116 XCTAssertEqual(deleted.deleted, 1)117 let resurrect = await captureAPIError { try await api.createDatabaseRow(databaseID: database.id, DatabaseRowDraft(id: bulk[1].id, title: "x")) }118 XCTAssertEqual(resurrect?.isRowDeleted, true)119 let missingRow = await captureAPIError { try await api.updateDatabaseRow(databaseID: database.id, rowID: bulk[1].id, values: .emptyObject) }120 XCTAssertEqual(missingRow?.isNotFound, true)121 let restored = try await api.restoreDatabaseRows(databaseID: database.id, ids: [bulk[1].id])122 XCTAssertEqual(restored.restored, 1)123124 // The same objects in the entity feed.125 let head = try await api.sync(since: 0, limit: 1).head126 _ = try await api.updateDatabaseRow(databaseID: database.id, rowID: rowID, values: RawJSON(string: #"{"\#(price.id)":431000}"#))127 let feed = try await api.sync(since: head, limit: 100, kinds: [SyncKind.databaseRow])128 let fed = try XCTUnwrap(feed.entities?[SyncKind.databaseRow]?.first { $0.id == rowID }).decode(DatabaseRow.self)129 XCTAssertEqual(fed.databaseId, database.id)130 XCTAssertEqual(fed.cell(price.id)?.double, 431_000)131 XCTAssertNil(fed.cell(double.id), "no computed value in the feed")132133 // Property and view deletion, templates, duplicate.134 _ = try await api.deleteDatabaseProperty(databaseID: database.id, propertyID: double.id)135 _ = try await api.deleteDatabaseView(databaseID: database.id, viewID: board.id)136 let lastView = await captureAPIError { try await api.deleteDatabaseView(databaseID: database.id, viewID: views.first { $0.id != board.id }?.id ?? "") }137 XCTAssertEqual(lastView?.status, 400)138 let templates = try await api.databaseTemplates()139 XCTAssertTrue(templates.contains { $0.id == "tasks" })140 let templated = try await live.page(self, "modèle", type: .database, section: .databases)141 let applied = try await api.applyDatabaseTemplate(databaseID: templated.id, template: "tasks")142 XCTAssertEqual(applied.applied, "tasks")143 let tasksDB = try await api.database(id: templated.id)144 XCTAssertTrue(tasksDB.properties?.contains { $0.type == DatabasePropertyType.status } ?? false)145 let copy = try await api.duplicateDatabase(id: database.id, DatabaseDuplicateOptions(withRows: true, title: live.title("copie")))146 live.cleanUp(self, page: copy.pageId)147 XCTAssertNotEqual(copy.id, database.id)148 let source = try await api.database(id: database.id)149 XCTAssertEqual(copy.properties?.map(\.name), source.properties?.map(\.name))150 let copied = try await api.databaseRowRefs(databaseID: copy.id)151 XCTAssertEqual(copied.count, 4)152153 let unknown = await captureAPIError { try await api.database(id: NotesAPI.newID()) }154 XCTAssertEqual(unknown?.isNotFound, true)155 }156157 // MARK: search158159 func testSearchAndIndexState() async throws {160 let live = try await LiveParity.make()161 let api = live.api162 let page = try await live.page(self, "recherche", section: .research, content: live.document("La volatilité des loyers \(live.marker)."))163 let reference = try await api.createReference(ReferenceDraft(id: NotesAPI.newID(), title: live.title("référence"), authors: ["Jane Doe"], year: 2021))164 addTeardownBlock { _ = try? await api.deleteReference(id: reference.id) }165166 let quick = try await api.search(SearchQuery(live.marker, mode: .quick, limit: 5))167 XCTAssertEqual(quick.map(\.targetPageID), [page.id])168 XCTAssertNotNil(quick.first?.updatedAt, "the PostgreSQL text date of a matching quick search is read")169170 // Keyword-only hybrid search (semantic: false — the query is never sent to the embedding provider).171 let passages = try await api.search(.keywords(live.marker, limit: 10))172 XCTAssertTrue(passages.allSatisfy { $0.pageId == page.id }, "at most passages of the page (none while it is not indexed)")173 let grouped = try await api.search(.keywords(live.marker, kinds: [SearchKind.reference], group: true))174 let hit = try XCTUnwrap(grouped.first)175 XCTAssertEqual(hit.kind, SearchKind.reference)176 XCTAssertEqual(hit.referenceId, reference.id)177 XCTAssertEqual(hit.keywordScore, 1)178 let badDate = await captureAPIError { try await api.search(.keywords(live.marker, since: "hier")) }179 XCTAssertEqual(badDate?.status, 400)180181 let state = try await api.searchIndexState()182 XCTAssertGreaterThanOrEqual(state.pages ?? 0, 1)183 XCTAssertNotNil(state.model)184 XCTAssertNotNil(state.health)185 _ = try await api.duplicatePages()186 }187188 // MARK: graph (2.x)189190 func testBacklinksMentionsAndNeighbours() async throws {191 let live = try await LiveParity.make()192 let api = live.api193 let target = try await live.page(self, "cible", section: .projects)194 let mention = RawJSON(string: #"{"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"Voir "},{"type":"mention","attrs":{"id":"\#(target.id)","label":"cible"}}]}]}"#)195 let linker = try await live.page(self, "lien", content: mention)196 let mentioner = try await live.page(self, "mention", content: live.document("Le dossier \(target.title) avance."))197198 var overview = try await api.backlinks(search: live.marker, pageID: target.id)199 XCTAssertEqual(overview.pages.first { $0.id == target.id }?.incoming, 1)200 XCTAssertEqual(overview.pages.first { $0.id == linker.id }?.outgoing, 1)201 XCTAssertEqual(overview.mentions.map(\.fromId), [mentioner.id])202 XCTAssertEqual(overview.mentions.first?.toId, target.id)203204 _ = try await api.resolveMention(.dismiss, fromID: mentioner.id, toID: target.id)205 overview = try await api.backlinks(pageID: target.id)206 XCTAssertFalse(overview.mentions.contains { $0.fromId == mentioner.id })207 _ = try await api.resolveMention(.undismiss, fromID: mentioner.id, toID: target.id)208 _ = try await api.resolveMention(.link, fromID: mentioner.id, toID: target.id)209 overview = try await api.backlinks(search: live.marker, pageID: target.id)210 XCTAssertEqual(overview.pages.first { $0.id == target.id }?.incoming, 2)211 XCTAssertEqual(overview.mentions, [])212 let selfLink = await captureAPIError { try await api.resolveMention(.link, fromID: target.id, toID: target.id) }213 XCTAssertEqual(selfLink?.status, 400)214215 let graph = try await api.graphNeighbors(pageID: target.id, depth: 2, includeSuggestions: false, includeLinked: true)216 XCTAssertEqual(graph.center, target.id)217 XCTAssertEqual(Set(graph.nodes.map(\.id)), [target.id, linker.id, mentioner.id])218 XCTAssertEqual(graph.nodes.first { $0.id == target.id }?.incoming, 2)219 XCTAssertEqual(graph.edges.count, 2)220 XCTAssertEqual(Set(graph.linked?.map(\.id) ?? []), [linker.id, mentioner.id])221 XCTAssertEqual(graph.suggestions, [])222 let small = try await api.graphNeighbors(pageID: target.id)223 XCTAssertNil(small.linked)224225 // Suggestions: reading and the 404 of a decision only (creating a suggestion calls a model).226 let suggestions = try await api.linkSuggestions(pageID: target.id)227 XCTAssertEqual(suggestions.items, [])228 XCTAssertGreaterThanOrEqual(suggestions.counts.suggested, 0)229 let unknown = await captureAPIError { try await api.decideLinkSuggestion(id: NotesAPI.newID(), status: .accepted) }230 XCTAssertEqual(unknown?.isNotFound, true)231 }232233 // MARK: inbox234235 func testCaptureKindsTriageAndSmartInbox() async throws {236 let live = try await LiveParity.make()237 let api = live.api238 let before = try await api.inboxCount()239240 let note = try await api.capture(CaptureDraft(kind: CaptureKindName.note, text: live.title("capture")), idempotencyKey: NotesAPI.newIdempotencyKey())241 live.cleanUp(self, page: note.id)242 let link = try await api.capture(CaptureDraft(kind: CaptureKindName.link, text: live.title("lien"), url: "https://example.org/\(live.marker)"))243 live.cleanUp(self, page: link.id)244 let todo = try await api.capture(CaptureDraft(kind: CaptureKindName.tasks, text: "\(live.title("tâche 1"))\n\(live.title("tâche 2"))"))245 live.cleanUp(self, page: todo.id)246 let count = try await api.inboxCount()247 XCTAssertEqual(count, before + 3)248 let inbox = try await api.inbox()249 XCTAssertEqual(inbox.first { $0.id == link.id }?.url, "https://example.org/\(live.marker)")250 XCTAssertEqual(inbox.first { $0.id == todo.id }?.openTasks, 2)251252 // A 3.0 kind: accepted by a server that knows it (it then stays in the inbox), refused with a validation error otherwise.253 var extraCaptures = 0254 do {255 let shot = try await api.capture(CaptureDraft(kind: CaptureKindName.selection, text: live.title("sélection")))256 live.cleanUp(self, page: shot.id)257 XCTAssertEqual(shot.kind, CaptureKindName.selection)258 extraCaptures = 1259 } catch let error as APIError {260 XCTAssertEqual(error.status, 400)261 XCTAssertTrue(error.message.hasPrefix("Validation: kind"), error.message)262 }263264 // keep → typed "not in inbox" → undo; task; reference; trash.265 let parent = try await live.page(self, "classeur", section: .projects)266 let kept = try await api.triageInboxItem(id: note.id, .keep(section: .projects, parentId: .value(parent.id)))267 XCTAssertEqual(kept.createdObjects, TriageCreated())268 let twice = await captureAPIError { try await api.triageInboxItem(id: note.id, .archive) }269 XCTAssertEqual(twice?.isNotInInbox, true)270 let undone = try await api.undoInboxAction(actionID: kept.actionId)271 XCTAssertEqual(undone.already, false)272 let tasked = try await api.triageInboxItem(id: todo.id, .task(dueAt: .value(Date(timeIntervalSince1970: 1_796_000_000)), priority: .high))273 let taskIDs = try XCTUnwrap(tasked.createdObjects.taskIds)274 XCTAssertEqual(taskIDs.count, 2)275 addTeardownBlock { for id in taskIDs { _ = try? await api.removeTask(id: id) } }276 let made = try await api.task(id: taskIDs[0])277 XCTAssertEqual(made.pageId, todo.id)278 XCTAssertEqual(made.priority, "high")279 let referenced = try await api.triageInboxItem(id: link.id, .reference)280 let referenceID = try XCTUnwrap(referenced.createdObjects.referenceId)281 let reference = try await api.reference(id: referenceID)282 XCTAssertEqual(reference.url, "https://example.org/\(live.marker)")283 XCTAssertEqual(reference.entryType, "misc")284 _ = try await api.undoInboxAction(actionID: referenced.actionId)285 let removed = await captureAPIError { try await api.reference(id: referenceID) }286 XCTAssertEqual(removed?.isNotFound, true, "undo deletes the reference the triage created")287 _ = try await api.triageInboxItem(id: note.id, .trash)288 let after = try await api.inboxCount()289 XCTAssertEqual(after, before + 1 + extraCaptures, "the link capture is back in the inbox (plus the 3.0 capture when the server accepted it)")290291 // Smart Inbox: `cachedOnly` never calls a provider. A server without the AI workstream has no such route.292 do {293 let cached = try await api.inboxSuggestions(id: link.id, cachedOnly: true)294 XCTAssertEqual(cached.pageId, link.id)295 } catch let error as APIError {296 XCTAssertTrue(error.isRouteMissing || error.code == ParityCode.notGenerated, "unexpected: \(error)")297 }298 do {299 _ = try await api.applyInboxSuggestions(id: link.id, InboxSuggestionSelection())300 XCTFail("an empty selection cannot be applied")301 } catch let error as APIError {302 XCTAssertTrue(error.isRouteMissing || error.code == ParityCode.nothingToApply, "unexpected: \(error)")303 }304 }305306 // MARK: research307308 func testResearchWorkspace() async throws {309 let live = try await LiveParity.make()310 let api = live.api311 let paper = try await api.createWorkingPaper(title: live.title("papier"), status: PaperStatus.writing, venue: "JREFE")312 live.cleanUp(self, page: paper.id)313 XCTAssertEqual(paper.type, "research")314315 // References: client id, idempotent creation, patch, links.316 let id = NotesAPI.newID()317 let key = "parity\(live.marker.suffix(8))"318 let draft = ReferenceDraft(id: id, pageId: paper.id, citeKey: key, entryType: "article", title: live.title("référence"), authors: ["Jane Doe", "John Roe"], year: 2021,319 journal: "Journal of Housing Finance", fields: RawJSON(string: #"{"volume":"12","pages":"1--20"}"#))320 let created = try await api.createReference(draft)321 addTeardownBlock { _ = try? await api.deleteReference(id: id) }322 XCTAssertEqual(created.citeKey, key)323 XCTAssertEqual(created.verified, ReferenceVerification.user)324 var retry = draft325 retry.title = "retry"326 let again = try await api.createReference(retry)327 XCTAssertEqual(again, created, "same id: the stored reference, untouched")328 let patched = try await api.updateReference(id: id, ReferenceChanges(year: .value(2022), journal: .null, fields: RawJSON(string: #"{"volume":"13","pages":""}"#)))329 XCTAssertEqual(patched.year, 2022)330 XCTAssertNil(patched.journal)331 XCTAssertEqual(try patched.fields?.decode([String: String].self)["volume"], "13")332 XCTAssertNil(try patched.fields?.decode([String: String].self)["pages"])333 let onPage = try await api.references(pageID: paper.id)334 XCTAssertEqual(onPage.map(\.id), [id])335 let links = try await api.referenceLinks(id: id)336 XCTAssertEqual(links.attached?.id, paper.id)337 let detached = try await api.attachReferencePDF(id: id, attachmentID: nil)338 XCTAssertNil(detached.attachmentId)339 let noDOI = await captureAPIError { try await api.verifyReference(id: id) }340 XCTAssertEqual(noDOI?.code, ParityCode.invalidDOI)341 let badDOI = await captureAPIError { try await api.lookupDOI("not-a-doi") }342 XCTAssertEqual(badDOI?.code, ParityCode.invalidDOI)343344 // Lookup by ids: right whether or not the server knows the parameter.345 let ghost = "00000000-0000-4000-8000-000000000000"346 let lookup = try await api.references(ids: [id, ghost])347 XCTAssertEqual(lookup.references.map(\.id), [id])348 XCTAssertEqual(lookup.missingIDs, [ghost])349350 // Extracts.351 let extractID = NotesAPI.newID()352 let added = try await api.addReferenceExtract(referenceID: id, ReferenceExtractDraft(id: extractID, quote: "Prepayment speeds rise.", page: "p. 7", note: "à citer"))353 XCTAssertEqual(added.extract?.id, extractID)354 let edited = try await api.updateReferenceExtract(referenceID: id, extractID: extractID, ReferenceExtractChanges(page: .value("p. 8"), note: .null))355 XCTAssertEqual(edited.extract?.page, "p. 8")356 XCTAssertNil(edited.extract?.note)357 let listedExtracts = try await api.referenceExtracts(referenceID: id)358 XCTAssertEqual(listedExtracts.map(\.id), [extractID])359 let removed = try await api.deleteReferenceExtract(referenceID: id, extractID: extractID)360 let gone = try XCTUnwrap(removed.extract)361 XCTAssertEqual(removed.extracts, [])362 let back = try await api.restoreReferenceExtract(referenceID: id, gone)363 XCTAssertEqual(back.extracts, [gone])364365 // BibTeX: dry run, import, export.366 let bibKey = "roe\(live.marker.suffix(8))"367 let bib = "@article{\(bibKey),\n author = {Roe, John},\n title = {Fixture live \(live.marker)},\n journal = {Housing Studies},\n year = {2019}\n}\n"368 let dry = try await api.importBibTeX(text: bib, pageID: paper.id, dryRun: true)369 XCTAssertTrue(dry.dryRun)370 XCTAssertEqual(dry.wouldCreate.map(\.citeKey), [bibKey])371 XCTAssertEqual(dry.created, [])372 let file = FileManager.default.temporaryDirectory.appendingPathComponent("spn-live-\(UUID().uuidString).bib")373 try Data(bib.utf8).write(to: file)374 defer { try? FileManager.default.removeItem(at: file) }375 let imported = try await api.importBibTeX(fileURL: file, pageID: paper.id)376 XCTAssertEqual(imported.created.map(\.citeKey), [bibKey])377 let importedID = try XCTUnwrap(imported.created.first?.id)378 addTeardownBlock { _ = try? await api.deleteReference(id: importedID) }379 let duplicate = try await api.importBibTeX(text: bib, pageID: paper.id)380 XCTAssertEqual(duplicate.counts?.skipped, 1, "duplicates are skipped, never overwritten")381 let empty = await captureAPIError { try await api.importBibTeX(text: " ") }382 XCTAssertEqual(empty?.code, ParityCode.bibtexEmpty)383 let export = try await api.exportBibTeX(pageID: paper.id)384 XCTAssertEqual(export.count, 2)385 XCTAssertTrue(export.text.contains("{\(bibKey),"))386 XCTAssertTrue(export.text.contains("{\(key),"))387388 // Experiments.389 let experiment = try await api.createExperiment(ExperimentDraft(pageId: paper.id, name: live.title("expérience"), status: ExperimentStatus.running, params: RawJSON(string: #"{"p":1}"#)))390 XCTAssertNotNil(experiment.startedAt)391 let finished = try await api.updateExperiment(id: experiment.id, ExperimentChanges(status: ExperimentStatus.done, metrics: RawJSON(string: #"{"qlike":0.398}"#), notes: .value("ok")))392 XCTAssertEqual(finished.status, ExperimentStatus.done)393 XCTAssertNotNil(finished.finishedAt)394 XCTAssertEqual(try finished.metrics?.decode([String: Double].self), ["qlike": 0.398])395 let experiments = try await api.experiments(pageID: paper.id)396 XCTAssertEqual(experiments.map(\.id), [experiment.id])397398 // Research tasks, and the restore of a deleted task.399 let task = try await api.createResearchTask(pageID: paper.id, ResearchTaskDraft(title: live.title("tâche"), status: .doing, priority: .high, dueAt: "2026-12-05"))400 let more = try await api.createResearchTasks(pageID: paper.id, [ResearchTaskDraft(title: live.title("tâche 2")), ResearchTaskDraft(title: live.title("tâche 3"), priority: .low)])401 addTeardownBlock { for id in [task.id] + more.map(\.id) { _ = try? await api.removeTask(id: id) } }402 XCTAssertEqual(task.status, TaskStatus.doing.rawValue)403 let paperTasks = try await api.researchTasks(pageID: paper.id)404 XCTAssertEqual(Set(paperTasks.map(\.id)), Set([task.id] + more.map(\.id)))405 _ = try await api.removeTask(id: task.id)406 let restoredTask = try await api.restoreTask(id: task.id)407 XCTAssertNil(restoredTask.deletedAt)408 // The general list reads the same rows (`doing` included).409 let general = try await api.tasks(includeDone: true, pageId: paper.id)410 XCTAssertEqual(general.first { $0.id == task.id }?.status, TaskStatus.doing.rawValue)411412 let overview = try await api.researchOverview()413 let row = try XCTUnwrap(overview.first { $0.id == paper.id })414 XCTAssertEqual(row.status, PaperStatus.writing)415 XCTAssertEqual(row.references, 2)416 XCTAssertEqual(row.experiments, 1)417 XCTAssertEqual(row.openTasks, 3)418419 // LaTeX export: only on a server with the AI workstream.420 do {421 let tex = try await api.exportLaTeX(projectID: paper.id)422 XCTAssertTrue(tex.tex.contains("\\documentclass"))423 let bundle = try await api.exportLaTeXBundle(projectID: paper.id)424 XCTAssertEqual(bundle.projectId, paper.id)425 } catch let error as APIError {426 XCTAssertTrue(error.isRouteMissing, "unexpected: \(error)")427 }428429 // Delete: soft, not readable by id, restorable; the feed keeps the row.430 _ = try await api.deleteExperiment(id: experiment.id)431 let head = try await api.sync(since: 0, limit: 1).head432 _ = try await api.deleteReference(id: id)433 let unreadable = await captureAPIError { try await api.reference(id: id) }434 XCTAssertEqual(unreadable?.isNotFound, true)435 let feed = try await api.sync(since: head, limit: 100, kinds: [SyncKind.reference])436 let fed = try XCTUnwrap(feed.entities?[SyncKind.reference]?.first { $0.id == id }).decode(ResearchReference.self)437 XCTAssertNotNil(fed.deletedAt)438 let restored = try await api.restoreReference(id: id)439 XCTAssertNil(restored.deletedAt)440 }441442 // MARK: AI bookkeeping and agents (nothing here calls a provider)443444 func testAIBookkeeping() async throws {445 let live = try await LiveParity.make()446 let api = live.api447 let page = try await live.page(self, "plan")448449 let conversations = try await api.aiConversations()450 XCTAssertTrue(conversations.allSatisfy { !$0.id.isEmpty })451 let onPage = try await api.aiConversations(pageID: page.id)452 XCTAssertEqual(onPage, [])453 if let first = conversations.first {454 let detail = try await api.aiConversation(id: first.id)455 XCTAssertEqual(detail.conversation.id, first.id)456 }457 let unknown = await captureAPIError { try await api.aiConversation(id: NotesAPI.newID()) }458 XCTAssertEqual(unknown?.isNotFound, true)459460 let usage = try await api.aiUsage(days: 7)461 XCTAssertEqual(usage.days, 7)462 XCTAssertGreaterThanOrEqual(usage.totalCostUsd, 0)463 XCTAssertEqual(usage.totalCalls, usage.byModel.compactMap(\.calls).reduce(0, +))464465 // Dry runs: where a request WOULD go. No provider is called and no text is sent.466 let chat = try await api.aiChatPlan(mode: .notes, pageID: page.id, chars: 1_200)467 XCTAssertEqual(chat.mode, "notes")468 XCTAssertNotNil(chat.configured)469 let action = try await api.aiActionPlan(.summarize, chars: 4_000)470 XCTAssertNotNil(action.task)471 let all = try await api.aiActionPlans(chars: 800)472 XCTAssertNotNil(all["rewrite"])473 XCTAssertEqual(all.count, 10)474 }475476 func testAgentCatalogueWithoutEverRunning() async throws {477 let live = try await LiveParity.make()478 let api = live.api479 let catalogue = try await api.agents(limit: 5)480 XCTAssertEqual(catalogue.agents.map(\.id), ["sort_inbox", "suggest_tags", "plan_from_page", "check_references"])481 XCTAssertTrue(catalogue.agents.allSatisfy { ($0.limits?.maxCostUsd ?? 0) > 0 })482 XCTAssertLessThanOrEqual(catalogue.executions.count, 5)483484 // `confirmCost: false` is refused before anything is queued: no run, no cost.485 let refused = await captureAPIError { try await api.runAgent("sort_inbox", confirmCost: false) }486 if catalogue.configured == true, catalogue.target != nil {487 XCTAssertEqual(refused?.needsCostConfirmation, true)488 } else {489 XCTAssertEqual(refused?.code, APIError.Code.notConfigured)490 }491 let unknownAgent = await captureAPIError { try await api.runAgent("unicorn", confirmCost: false) }492 XCTAssertEqual(unknownAgent?.code, ParityCode.unknownAgent)493494 let missing = NotesAPI.newID()495 let execution = await captureAPIError { try await api.agentExecution(id: missing) }496 XCTAssertEqual(execution?.isNotFound, true)497 let approve = await captureAPIError { try await api.approveAgentProposals(executionID: missing, changes: [0]) }498 XCTAssertEqual(approve?.isNotFound, true)499 let cancel = await captureAPIError { try await api.cancelAgentExecution(id: missing) }500 XCTAssertEqual(cancel?.isNotFound, true)501 if let first = catalogue.executions.first {502 let detail = try await api.agentExecution(id: first.id)503 XCTAssertEqual(detail.id, first.id)504 }505 }506507 // MARK: dashboard, settings, page lists, trash508509 func testDashboardSettingsListsAndTrash() async throws {510 let live = try await LiveParity.make()511 let api = live.api512 let parent = try await live.page(self, "accueil", section: .projects)513 let child = try await live.page(self, "enfant", section: .projects, parentId: parent.id)514 _ = try await api.patchPage(id: parent.id, PagePatch(pinned: true))515 let task = try await api.createTaskIdempotent(TaskDraft(title: live.title("échéance"), priority: .high, pageId: parent.id, id: NotesAPI.newID(), status: .doing, due: "2026-11-20"))516 addTeardownBlock { _ = try? await api.removeTask(id: task.value.id) }517518 // Dashboard.519 let dashboard = try await api.dashboard()520 XCTAssertTrue(dashboard.pinned?.contains { $0.id == parent.id } ?? false)521 XCTAssertTrue(dashboard.recent?.contains { $0.id == child.id } ?? false)522 XCTAssertEqual(dashboard.tasks?.first { $0.id == task.value.id }?.pageTitle, parent.title)523 XCTAssertNotNil(dashboard.usage?.budgetUsd)524 let original = try XCTUnwrap(dashboard.layout)525 let saved = try await api.saveDashboardLayout([DashboardWidget(id: "w-live", type: DashboardWidgetType.tasksDue, size: "half", config: RawJSON(string: #"{"days":7}"#))])526 XCTAssertEqual(saved.custom, true)527 XCTAssertEqual(saved.widgets.map(\.id), ["w-live"])528 let badWidget = await captureAPIError { try await api.saveDashboardLayout([DashboardWidget(id: "x", type: "unicorn", size: "half")]) }529 XCTAssertEqual(badWidget?.status, 400)530 // Put the layout of the account back exactly as it was.531 if original.custom == true { _ = try await api.saveDashboardLayout(original.widgets) } else { _ = try await api.resetDashboardLayout() }532 let layoutAfter = try await api.dashboard().layout533 XCTAssertEqual(layoutAfter, original)534 _ = try await api.dashboardSummary()535536 // Settings: preferences are merged; one namespaced key, set back to null at the end (a key cannot be removed).537 let settings = try await api.settings()538 XCTAssertFalse(settings.id.isEmpty)539 XCTAssertNotNil(settings.aiBudgetUsd)540 let merged = try await api.updateSettings(SettingsChanges(preferences: RawJSON(string: #"{"spnLiveParity":{"marker":"\#(live.marker)"}}"#)))541 XCTAssertEqual(try merged.preferences?.member("spnLiveParity")?.raw().decode([String: String].self), ["marker": live.marker])542 XCTAssertEqual(merged.displayName, settings.displayName, "a patch of the preferences leaves the profile alone")543 let cleared = try await api.updateSettings(SettingsChanges(preferences: RawJSON(string: #"{"spnLiveParity":null}"#)))544 XCTAssertNil(cleared.preferences?.member("spnLiveParity"))545 let badMail = await captureAPIError { try await api.updateSettings(SettingsChanges(email: .value("pas un courriel"))) }546 XCTAssertEqual(badMail?.status, 400)547 let audit = try await api.auditLog(limit: 5)548 XCTAssertEqual(audit.first?.action, "settings.update")549 XCTAssertEqual(audit.count, 5)550551 // Page lists and the trash.552 let pinned = try await api.pages(view: .pinned, limit: 100)553 XCTAssertTrue(pinned.contains { $0.id == parent.id })554 let children = try await api.pages(view: .children(parent.id))555 XCTAssertEqual(children.map(\.id), [child.id])556 let section = try await api.pages(view: .section(.projects), limit: 100)557 XCTAssertTrue(section.contains { $0.id == child.id })558 _ = try await api.patchPage(id: child.id, PagePatch(archived: true))559 let archived = try await api.pages(view: .archived, limit: 100)560 XCTAssertTrue(archived.contains { $0.id == child.id })561 _ = try await api.trashPage(id: child.id)562 let trash = try await api.trashedPages()563 XCTAssertNotNil(trash.first { $0.id == child.id }?.deletedAt)564 _ = try await api.restorePage(id: child.id)565 let trashAfter = try await api.trashedPages()566 XCTAssertFalse(trashAfter.contains { $0.id == child.id })567568 // Purge of old trash: needs a fresh session. 365 days matches nothing on a scratch database.569 do {570 let purge = try await api.purgeOldTrash(days: 365)571 XCTAssertEqual(purge.autoPurgeDays, 365)572 XCTAssertNotNil(purge.remaining)573 } catch let error as APIError {574 XCTAssertTrue(error.needsReauth, "unexpected: \(error)")575 }576577 // Tags: listing only (the server has no route to rename, recolour or delete a tag).578 let names = try await api.setPageTags(pageID: parent.id, tags: ["spn-live-parity"])579 XCTAssertEqual(names, ["spn-live-parity"])580 let tags = try await api.tags()581 XCTAssertEqual(tags.first { $0.name == "spn-live-parity" }?.pages, 1)582 _ = try await api.setPageTags(pageID: parent.id, tags: [])583 }584}585