SPB Git

Repository Public

LiveParityTests.swift 36.6 KB 585 lines swift

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
Files main
Menu

Theme