feat(sessions): keep every session, record review details, name and stamp the PDF
Sessions are now the unit of the product instead of an implicit capture run. - Nothing is deleted by default: the fixed 10-session cap is gone. An age limit (Never / 7 / 14 / 30 / 90 / 180 / 365 days) is chosen in Settings > Sessions and applied on launch, after archiving, and by "Clean up now". Sent PDFs are never touched. - Each session carries review details: lane, deployed version, commit, reviewer (pre-filled with the Mac user) and a free note. They persist in session.json and are inherited by the next session, so a review run is typed once. - PDF file names are Redline-<yyyyMMdd-HHmm>-<LANE>-<SHORTID>.pdf, and every page carries a two-line reference footer (tool, build time, session / lane, deployed build, commit, reviewer, note). The PDF document info carries the same values in Author and Keywords. - Verification: 159 tests, a headless panel self-test, and a LaunchServices-driven end-to-end run that types and clicks the real panel.
This commit is contained in:
@@ -203,17 +203,123 @@ private func pixelWindow(
|
||||
return (pixelX0, pixelY0, pixelX1, pixelY1)
|
||||
}
|
||||
|
||||
@Test("fileName uses compose time, not session.createdAt, and matches Redline-yyyyMMdd-HHmmss.pdf")
|
||||
@Test("fileName is Redline-yyyyMMdd-HHmm-SHORTID.pdf and uses compose time")
|
||||
func fileNameUsesComposeTimeNotSessionCreatedAt() {
|
||||
let old = Date(timeIntervalSince1970: 1_600_000_000) // 2020-09-13
|
||||
let session = makeSession(captures: [], createdAt: old)
|
||||
let name = PDFComposer.fileName(for: session)
|
||||
#expect(name.wholeMatch(of: /^Redline-\d{8}-\d{6}\.pdf$/) != nil)
|
||||
#expect(!name.contains(DubaiTime.fileStamp(old)))
|
||||
let today = String(DubaiTime.fileStamp(Date()).prefix(8))
|
||||
#expect(name.wholeMatch(of: /^Redline-\d{8}-\d{4}-[0-9A-F]{8}\.pdf$/) != nil)
|
||||
#expect(name.contains(session.shortID))
|
||||
#expect(!name.contains(DubaiTime.fileMinuteStamp(old)))
|
||||
let today = String(DubaiTime.fileMinuteStamp(Date()).prefix(8))
|
||||
#expect(name.contains(today))
|
||||
}
|
||||
|
||||
@Test("fileName carries the lane slug between the timestamp and the session id")
|
||||
func fileNameCarriesTheLaneSlug() {
|
||||
let session = CaptureSession(
|
||||
id: UUID(uuidString: "4f2a9c1d-0000-4000-8000-000000000000")!,
|
||||
createdAt: fixtureDate,
|
||||
state: .open,
|
||||
captures: [],
|
||||
pdfFileName: nil,
|
||||
context: ReviewContext(lane: "OMS test lane"))
|
||||
let name = PDFComposer.fileName(for: session)
|
||||
#expect(name.wholeMatch(of: /^Redline-\d{8}-\d{4}-OMS-TEST-LANE-4F2A9C1D\.pdf$/) != nil)
|
||||
}
|
||||
|
||||
@Test("Review footer lines state the tool, date, session and the recorded review details")
|
||||
func footerLinesStateTheReviewDetails() {
|
||||
let session = CaptureSession(
|
||||
id: UUID(uuidString: "4f2a9c1d-0000-4000-8000-000000000000")!,
|
||||
createdAt: fixtureDate,
|
||||
state: .open,
|
||||
captures: [],
|
||||
pdfFileName: nil,
|
||||
context: ReviewContext(
|
||||
lane: "dev03", deployedVersion: "v1.4.2 (41)", commit: "a1b2c3d4",
|
||||
reviewer: "Ben Hippler", note: "checkout"))
|
||||
let lines = PDFComposer.footerLines(
|
||||
session: session, toolVersion: "0.5.0", composedAt: fixtureDate)
|
||||
#expect(lines.count == 2)
|
||||
#expect(lines[0].contains("Redline 0.5.0"))
|
||||
#expect(lines[0].contains("Session 4F2A9C1D"))
|
||||
#expect(lines[0].contains(DubaiTime.stamp(fixtureDate)))
|
||||
#expect(lines[1].contains("Lane dev03"))
|
||||
#expect(lines[1].contains("Deployed v1.4.2 (41)"))
|
||||
#expect(lines[1].contains("Commit a1b2c3d4"))
|
||||
#expect(lines[1].contains("Reviewer Ben Hippler"))
|
||||
#expect(lines[1].contains("Note checkout"))
|
||||
|
||||
// A session with no recorded details still identifies itself; nothing is faked.
|
||||
let bare = makeSession(captures: [])
|
||||
let bareLines = PDFComposer.footerLines(
|
||||
session: bare, toolVersion: "", composedAt: fixtureDate)
|
||||
#expect(bareLines.count == 1)
|
||||
#expect(bareLines[0].hasPrefix("Redline · "))
|
||||
}
|
||||
|
||||
@Test("Document info carries the reviewer and the lane/build/commit keywords")
|
||||
func documentInfoCarriesTheReviewDetails() {
|
||||
let session = CaptureSession(
|
||||
id: UUID(uuidString: "deadbeef-dead-4eef-8ead-deadbeef0001")!,
|
||||
createdAt: fixtureDate,
|
||||
state: .open,
|
||||
captures: [],
|
||||
pdfFileName: nil,
|
||||
context: ReviewContext(
|
||||
lane: "DEV03", deployedVersion: "v1.4.2", commit: "a1b2c3d4",
|
||||
reviewer: "Ben Hippler", note: "checkout"))
|
||||
let info = PDFComposer.documentInfo(
|
||||
session: session, title: "Redline – DEV03", toolVersion: "0.5.0", composedAt: fixtureDate)
|
||||
|
||||
#expect(info[kCGPDFContextAuthor as String] as? String == "Ben Hippler")
|
||||
#expect(info[kCGPDFContextCreator as String] as? String == "Redline 0.5.0")
|
||||
let keywords = try? #require(info[kCGPDFContextKeywords as String] as? String)
|
||||
#expect(keywords?.contains("lane=DEV03") == true)
|
||||
#expect(keywords?.contains("deployed=v1.4.2") == true)
|
||||
#expect(keywords?.contains("commit=a1b2c3d4") == true)
|
||||
#expect(keywords?.contains("reviewer=Ben Hippler") == true)
|
||||
#expect(keywords?.contains("built=\(DubaiTime.keywordStamp(fixtureDate))") == true)
|
||||
}
|
||||
|
||||
@Test("A composed PDF carries the footer text and document info a reader can see")
|
||||
func composedPDFCarriesTheReferenceBlock() throws {
|
||||
let directory = try makeScratchDirectory()
|
||||
defer { try? FileManager.default.removeItem(at: directory) }
|
||||
|
||||
let capture = makeCapture(sequence: 1, pixelWidth: 800, pixelHeight: 600)
|
||||
let png = try writePNG(for: capture, red: 60, green: 60, blue: 60, in: directory)
|
||||
let session = CaptureSession(
|
||||
id: UUID(uuidString: "4f2a9c1d-0000-4000-8000-000000000000")!,
|
||||
createdAt: fixtureDate,
|
||||
state: .open,
|
||||
captures: [capture],
|
||||
pdfFileName: nil,
|
||||
context: ReviewContext(
|
||||
lane: "dev03", deployedVersion: "v1.4.2", commit: "a1b2c3d4",
|
||||
reviewer: "Ben Hippler", note: "checkout"))
|
||||
let output = directory.appendingPathComponent("footer.pdf")
|
||||
_ = try PDFComposer().compose(
|
||||
session: session,
|
||||
imageURL: { _ in png },
|
||||
title: "Redline – dev03",
|
||||
to: output,
|
||||
toolVersion: "0.5.0",
|
||||
composedAt: fixtureDate
|
||||
)
|
||||
|
||||
let document = try openDocument(output)
|
||||
let pageText = try #require(document.page(at: 0)?.string ?? "")
|
||||
#expect(pageText.contains("Redline 0.5.0"))
|
||||
#expect(pageText.contains("Lane dev03"))
|
||||
#expect(pageText.contains("Commit a1b2c3d4"))
|
||||
#expect(pageText.contains("Ben Hippler"))
|
||||
|
||||
let attributes = try #require(document.documentAttributes)
|
||||
#expect(attributes[PDFDocumentAttribute.authorAttribute] as? String == "Ben Hippler")
|
||||
}
|
||||
|
||||
@Test("Three-page basic compose")
|
||||
func threePageBasicCompose() throws {
|
||||
let directory = try makeScratchDirectory()
|
||||
|
||||
@@ -0,0 +1,138 @@
|
||||
import Foundation
|
||||
import ShotdeckCore
|
||||
import Testing
|
||||
|
||||
// PDF naming scheme + the persisted session age limit.
|
||||
|
||||
// MARK: - PDF file names
|
||||
|
||||
@Test
|
||||
func laneSlugKeepsLettersDigitsAndSingleDashes() {
|
||||
#expect(PDFFileName.laneSlug("OMS test lane") == "OMS-TEST-LANE")
|
||||
#expect(PDFFileName.laneSlug(" dev03 ") == "DEV03")
|
||||
#expect(PDFFileName.laneSlug("v1.4.2 / stage") == "V1-4-2-STAGE")
|
||||
#expect(PDFFileName.laneSlug("") == "")
|
||||
#expect(PDFFileName.laneSlug("--") == "")
|
||||
}
|
||||
|
||||
@Test
|
||||
func laneSlugIsCappedSoTheFileNameStaysShort() {
|
||||
let long = String(repeating: "abcdefghij", count: 5)
|
||||
let slug = PDFFileName.laneSlug(long)
|
||||
#expect(slug.count == PDFFileName.laneMaxLength)
|
||||
#expect(!slug.hasSuffix("-"))
|
||||
}
|
||||
|
||||
@Test
|
||||
func fileNameIsSortableAndUniquePerSession() {
|
||||
let sessionID = UUID(uuidString: "4F2A9C1D-0000-4000-8000-000000000000")!
|
||||
let builtAt = Date(timeIntervalSince1970: 1_777_482_180)
|
||||
|
||||
let withLane = PDFFileName.make(builtAt: builtAt, lane: "dev03", sessionID: sessionID)
|
||||
#expect(withLane == "Redline-\(DubaiTime.fileMinuteStamp(builtAt))-DEV03-4F2A9C1D.pdf")
|
||||
|
||||
let withoutLane = PDFFileName.make(builtAt: builtAt, lane: "", sessionID: sessionID)
|
||||
#expect(withoutLane == "Redline-\(DubaiTime.fileMinuteStamp(builtAt))-4F2A9C1D.pdf")
|
||||
|
||||
// Two sessions in the same minute never collide.
|
||||
let other = UUID(uuidString: "9B8C7D6E-0000-4000-8000-000000000000")!
|
||||
#expect(PDFFileName.make(builtAt: builtAt, lane: "dev03", sessionID: other)
|
||||
!= withLane)
|
||||
}
|
||||
|
||||
@Test
|
||||
func sessionLabelIsLaneOrShortID() {
|
||||
let id = UUID(uuidString: "4F2A9C1D-0000-4000-8000-000000000000")!
|
||||
#expect(PDFFileName.sessionLabel(lane: "dev03", sessionID: id) == "DEV03-4F2A9C1D")
|
||||
#expect(PDFFileName.sessionLabel(lane: "", sessionID: id) == "4F2A9C1D")
|
||||
}
|
||||
|
||||
// MARK: - Retention setting
|
||||
|
||||
@Test
|
||||
func retentionDefaultsToNever() throws {
|
||||
let suite = try makeDefaults()
|
||||
defer { suite.defaults.removePersistentDomain(forName: suite.name) }
|
||||
|
||||
#expect(RetentionSettings.load(defaults: suite.defaults) == .never)
|
||||
#expect(RetentionSettings.load(defaults: suite.defaults).cutoff() == nil)
|
||||
}
|
||||
|
||||
@Test
|
||||
func retentionRoundTripsThroughDefaults() throws {
|
||||
let suite = try makeDefaults()
|
||||
defer { suite.defaults.removePersistentDomain(forName: suite.name) }
|
||||
|
||||
RetentionSettings.save(.days(30), defaults: suite.defaults)
|
||||
#expect(RetentionSettings.load(defaults: suite.defaults) == .days(30))
|
||||
|
||||
RetentionSettings.save(.never, defaults: suite.defaults)
|
||||
#expect(RetentionSettings.load(defaults: suite.defaults) == .never)
|
||||
#expect(suite.defaults.object(forKey: RetentionSettings.defaultsKey) == nil)
|
||||
}
|
||||
|
||||
@Test
|
||||
func retentionCutoffIsTheDayCountBeforeNow() {
|
||||
let now = Date(timeIntervalSince1970: 1_777_482_180)
|
||||
let cutoff = try? #require(SessionRetention.days(30).cutoff(now: now))
|
||||
let expected = Calendar(identifier: .gregorian).date(byAdding: .day, value: -30, to: now)
|
||||
#expect(cutoff == expected)
|
||||
}
|
||||
|
||||
@Test
|
||||
func retentionPresetsReadAsPlainEnglish() {
|
||||
#expect(SessionRetention.never.displayName == "Never (default)")
|
||||
#expect(SessionRetention.days(7).displayName == "7 days")
|
||||
#expect(SessionRetention.days(365).displayName == "1 year")
|
||||
#expect(SessionRetention.never.policyDescription == "All sessions kept.")
|
||||
#expect(SessionRetention.days(14).policyDescription == "Sessions older than 14 days are deleted.")
|
||||
}
|
||||
|
||||
// MARK: - Review context
|
||||
|
||||
@Test
|
||||
func reviewContextTrimsCapsAndCollapsesLineBreaks() {
|
||||
let long = String(repeating: "x", count: ReviewContext.maxFieldLength + 40)
|
||||
let context = ReviewContext(
|
||||
lane: " dev03 ", deployedVersion: "v1.4.2\n(build 41)", commit: " a1b2c3d4 ",
|
||||
reviewer: "Ben Hippler", note: long)
|
||||
#expect(context.lane == "dev03")
|
||||
#expect(context.deployedVersion == "v1.4.2 (build 41)")
|
||||
#expect(context.commit == "a1b2c3d4")
|
||||
#expect(context.note.count == ReviewContext.maxFieldLength)
|
||||
}
|
||||
|
||||
@Test
|
||||
func reviewContextSummaryDropsEmptyParts() {
|
||||
#expect(ReviewContext(lane: "dev03", commit: "a1b2c3d4").summaryLine == "dev03 · a1b2c3d4")
|
||||
#expect(ReviewContext().summaryLine == "")
|
||||
#expect(ReviewContext().isEmpty)
|
||||
}
|
||||
|
||||
@Test
|
||||
func reviewContextDecodesPartialJSON() throws {
|
||||
let json = Data(#"{"lane":"dev03","commit":"a1b2c3d4"}"#.utf8)
|
||||
let context = try JSONDecoder().decode(ReviewContext.self, from: json)
|
||||
#expect(context.lane == "dev03")
|
||||
#expect(context.commit == "a1b2c3d4")
|
||||
#expect(context.reviewer == "")
|
||||
#expect(context.note == "")
|
||||
}
|
||||
|
||||
// MARK: - Fixtures
|
||||
|
||||
private struct DefaultsSuite {
|
||||
let name: String
|
||||
let defaults: UserDefaults
|
||||
}
|
||||
|
||||
private func makeDefaults() throws -> DefaultsSuite {
|
||||
let name = "shotdeck-retention-settings-\(UUID().uuidString)"
|
||||
guard let defaults = UserDefaults(suiteName: name) else {
|
||||
throw SettingsFixtureError.noSuite
|
||||
}
|
||||
defaults.removePersistentDomain(forName: name)
|
||||
return DefaultsSuite(name: name, defaults: defaults)
|
||||
}
|
||||
|
||||
private enum SettingsFixtureError: Error { case noSuite }
|
||||
@@ -4,9 +4,9 @@ import ImageIO
|
||||
import Testing
|
||||
import ShotdeckCore
|
||||
|
||||
// Session lifecycle + retention (MMDB-2925): "Start new session" keeps the current
|
||||
// screenshots as a past session, and the newest 10 sessions are retained in the one
|
||||
// archive folder.
|
||||
// Session lifecycle + retention: "Start new session" keeps the current screenshots as
|
||||
// a past session; every session is kept by default, and an age limit chosen in
|
||||
// Settings is the only thing that ever removes one.
|
||||
|
||||
// MARK: - 1. closeCurrentSession keeps the captures as a past session
|
||||
|
||||
@@ -95,14 +95,16 @@ func pastSessionsDistinguishSentFromUnsentByPDFFileName() async throws {
|
||||
#expect(past.map(\.pdfFileName) == [nil, "Redline-20261011-120000.pdf"])
|
||||
}
|
||||
|
||||
// MARK: - 4. retention keeps the newest 10 sessions, in the one archive folder
|
||||
// MARK: - 4. nothing is deleted by default
|
||||
|
||||
@Test
|
||||
func retentionKeepsTheNewestTenSessionsAndRemovesTheRest() async throws {
|
||||
func defaultPolicyKeepsEverySession() async throws {
|
||||
let (root, paths) = try makeIsolatedPaths()
|
||||
defer { try? FileManager.default.removeItem(at: root) }
|
||||
|
||||
let store = try SpoolStore(paths: paths)
|
||||
#expect(await store.configuredRetention() == .never)
|
||||
|
||||
var closedIDs: [UUID] = []
|
||||
for index in 0..<12 {
|
||||
_ = try await store.append(
|
||||
@@ -113,78 +115,141 @@ func retentionKeepsTheNewestTenSessionsAndRemovesTheRest() async throws {
|
||||
closedIDs.append(closed.id)
|
||||
}
|
||||
|
||||
// All 12 sessions live in the single archive/ folder as UUID session folders.
|
||||
// All 12 sessions live on in the single archive/ folder; none was pruned.
|
||||
let fm = FileManager.default
|
||||
let entries = try fm.contentsOfDirectory(at: paths.archive, includingPropertiesForKeys: nil)
|
||||
let sessionDirs = entries.filter { UUID(uuidString: $0.lastPathComponent) != nil }
|
||||
#expect(sessionDirs.count == SpoolStore.defaultRetainedSessionCount)
|
||||
#expect(sessionDirs.count == closedIDs.count)
|
||||
|
||||
let kept = try await store.archivedSessions().map(\.id)
|
||||
#expect(kept == Array(closedIDs.suffix(SpoolStore.defaultRetainedSessionCount).reversed()))
|
||||
#expect(kept == closedIDs.reversed())
|
||||
|
||||
// The two oldest sessions are gone; the newest ten are fully on disk.
|
||||
for id in closedIDs.prefix(2) {
|
||||
#expect(!fm.fileExists(atPath: paths.archiveDirectory(id).path))
|
||||
}
|
||||
for id in closedIDs.suffix(SpoolStore.defaultRetainedSessionCount) {
|
||||
for id in closedIDs {
|
||||
#expect(fm.fileExists(atPath: paths.archiveDirectory(id).appendingPathComponent("session.json").path))
|
||||
}
|
||||
|
||||
// The open session is never touched by retention.
|
||||
let open = try await store.currentSession()
|
||||
#expect(open.state == .open)
|
||||
#expect(open.isEmpty)
|
||||
#expect(fm.fileExists(atPath: paths.sessionDirectory(open.id).path))
|
||||
// A prune under the default policy removes nothing at all.
|
||||
#expect(try await store.pruneExpiredSessions().isEmpty)
|
||||
#expect(try await store.expiredSessionIDs().isEmpty)
|
||||
}
|
||||
|
||||
// MARK: - 5. explicit prune keeps exactly the requested count
|
||||
// MARK: - 5. an age limit removes exactly the expired sessions
|
||||
|
||||
@Test
|
||||
func pruneArchivedSessionsKeepingNRemovesExactlyTheOldest() async throws {
|
||||
func ageLimitRemovesOnlySessionsOlderThanTheCutoff() async throws {
|
||||
let (root, paths) = try makeIsolatedPaths()
|
||||
defer { try? FileManager.default.removeItem(at: root) }
|
||||
|
||||
let store = try SpoolStore(paths: paths)
|
||||
var closedIDs: [UUID] = []
|
||||
for _ in 0..<4 {
|
||||
_ = try await store.append(
|
||||
pngData: try makePNGData(width: 4, height: 4, red: 0.2, green: 0.2, blue: 0.2),
|
||||
pixelWidth: 4, pixelHeight: 4, scale: 1.0, capturedAt: Date())
|
||||
closedIDs.append(try #require(try await store.closeCurrentSession()).id)
|
||||
let now = Date(timeIntervalSince1970: 1_700_000_000) // fixed "now" for the test
|
||||
let day: TimeInterval = 86_400
|
||||
let oldIDs = try [
|
||||
try writeArchivedSession(createdAt: now.addingTimeInterval(-40 * day), in: paths),
|
||||
try writeArchivedSession(createdAt: now.addingTimeInterval(-31 * day), in: paths),
|
||||
]
|
||||
let recentIDs = try [
|
||||
try writeArchivedSession(createdAt: now.addingTimeInterval(-29 * day), in: paths),
|
||||
try writeArchivedSession(createdAt: now.addingTimeInterval(-1 * day), in: paths),
|
||||
]
|
||||
|
||||
let store = try SpoolStore(paths: paths, retention: .days(30))
|
||||
|
||||
// Asking what would happen deletes nothing.
|
||||
#expect(Set(try await store.expiredSessionIDs(now: now)) == Set(oldIDs))
|
||||
#expect(try await store.archivedSessions().count == 4)
|
||||
|
||||
let removed = try await store.pruneExpiredSessions(now: now)
|
||||
#expect(Set(removed) == Set(oldIDs))
|
||||
|
||||
let fm = FileManager.default
|
||||
for id in oldIDs {
|
||||
#expect(!fm.fileExists(atPath: paths.archiveDirectory(id).path))
|
||||
}
|
||||
for id in recentIDs {
|
||||
#expect(fm.fileExists(atPath: paths.archiveDirectory(id).appendingPathComponent("session.json").path))
|
||||
}
|
||||
|
||||
let removed = try await store.pruneArchivedSessions(keeping: 2)
|
||||
#expect(removed == Array(closedIDs.prefix(2).reversed())) // newest-first walk order
|
||||
let kept = try await store.archivedSessions().map(\.id)
|
||||
#expect(kept == Array(closedIDs.suffix(2).reversed()))
|
||||
|
||||
// Idempotent: nothing left to prune at that limit.
|
||||
let removedAgain = try await store.pruneArchivedSessions(keeping: 2)
|
||||
#expect(removedAgain.isEmpty)
|
||||
// The open session is never a candidate, and a second pass is a no-op.
|
||||
#expect(try await store.currentSession().state == .open)
|
||||
#expect(try await store.pruneExpiredSessions(now: now).isEmpty)
|
||||
}
|
||||
|
||||
// MARK: - 6. retention runs on the send path too
|
||||
// MARK: - 6. the archive path applies the configured age limit
|
||||
|
||||
@Test
|
||||
func theSendArchivePathAppliesRetention() async throws {
|
||||
func theArchivePathAppliesTheAgeLimit() async throws {
|
||||
let (root, paths) = try makeIsolatedPaths()
|
||||
defer { try? FileManager.default.removeItem(at: root) }
|
||||
|
||||
let store = try SpoolStore(paths: paths)
|
||||
var sentIDs: [UUID] = []
|
||||
for index in 0..<(SpoolStore.defaultRetainedSessionCount + 3) {
|
||||
_ = try await store.append(
|
||||
pngData: try makePNGData(width: 4, height: 4, red: 0.3, green: 0.3, blue: 0.3),
|
||||
pixelWidth: 4, pixelHeight: 4, scale: 1.0,
|
||||
capturedAt: Date(timeIntervalSince1970: 1_700_100_000 + Double(index)))
|
||||
let archived = try await store.archiveCurrent(pdfFileName: "Redline-\(index).pdf")
|
||||
sentIDs.append(archived.id)
|
||||
}
|
||||
let day: TimeInterval = 86_400
|
||||
let expiredID = try writeArchivedSession(
|
||||
createdAt: Date().addingTimeInterval(-10 * day), in: paths)
|
||||
|
||||
let store = try SpoolStore(paths: paths, retention: .days(7))
|
||||
_ = try await store.append(
|
||||
pngData: try makePNGData(width: 4, height: 4, red: 0.3, green: 0.3, blue: 0.3),
|
||||
pixelWidth: 4, pixelHeight: 4, scale: 1.0, capturedAt: Date())
|
||||
let archived = try await store.archiveCurrent(pdfFileName: "Redline-20261031-1200-A1B2C3D4.pdf")
|
||||
|
||||
let kept = try await store.archivedSessions()
|
||||
#expect(kept.count == SpoolStore.defaultRetainedSessionCount)
|
||||
#expect(kept.map(\.id) == Array(sentIDs.suffix(SpoolStore.defaultRetainedSessionCount).reversed()))
|
||||
#expect(kept.allSatisfy { $0.pdfFileName != nil })
|
||||
#expect(kept.map(\.id) == [archived.id])
|
||||
#expect(!FileManager.default.fileExists(atPath: paths.archiveDirectory(expiredID).path))
|
||||
}
|
||||
|
||||
// MARK: - 7. review context is persisted, survives a relaunch and is inherited
|
||||
|
||||
@Test
|
||||
func reviewContextPersistsAndIsInheritedByTheNextSession() async throws {
|
||||
let (root, paths) = try makeIsolatedPaths()
|
||||
defer { try? FileManager.default.removeItem(at: root) }
|
||||
|
||||
let store = try SpoolStore(paths: paths)
|
||||
let context = ReviewContext(
|
||||
lane: "dev03", deployedVersion: "v1.4.2 (41)", commit: "a1b2c3d4",
|
||||
reviewer: "Ben Hippler", note: "checkout flow")
|
||||
|
||||
let updated = try await store.setContext(context)
|
||||
#expect(updated.context == context)
|
||||
|
||||
// A second store on the same directory is what a relaunch sees.
|
||||
let reopened = try SpoolStore(paths: paths)
|
||||
#expect(try await reopened.currentSession().context == context)
|
||||
|
||||
_ = try await store.append(
|
||||
pngData: try makePNGData(width: 4, height: 4, red: 0.4, green: 0.4, blue: 0.4),
|
||||
pixelWidth: 4, pixelHeight: 4, scale: 1.0, capturedAt: Date())
|
||||
let archived = try #require(try await store.closeCurrentSession())
|
||||
#expect(archived.context == context)
|
||||
|
||||
// The fresh session keeps the same review details.
|
||||
#expect(try await store.currentSession().context == context)
|
||||
}
|
||||
|
||||
// MARK: - 8. a manifest written before contexts existed still loads
|
||||
|
||||
@Test
|
||||
func legacyManifestWithoutContextDecodesAsEmptyContext() async throws {
|
||||
let (root, paths) = try makeIsolatedPaths()
|
||||
defer { try? FileManager.default.removeItem(at: root) }
|
||||
|
||||
let id = UUID()
|
||||
let dir = paths.archiveDirectory(id)
|
||||
try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
|
||||
let legacyJSON = """
|
||||
{
|
||||
"id": "\(id.uuidString)",
|
||||
"createdAt": "2026-10-11T12:00:00Z",
|
||||
"state": "archived",
|
||||
"captures": [],
|
||||
"pdfFileName": "Redline-20261011-120000.pdf"
|
||||
}
|
||||
"""
|
||||
try Data(legacyJSON.utf8).write(to: dir.appendingPathComponent("session.json"))
|
||||
|
||||
let store = try SpoolStore(paths: paths)
|
||||
let sessions = try await store.archivedSessions()
|
||||
#expect(sessions.map(\.id) == [id])
|
||||
#expect(sessions.first?.context == .empty)
|
||||
#expect(sessions.first?.pdfFileName == "Redline-20261011-120000.pdf")
|
||||
}
|
||||
|
||||
// MARK: - 7. a stale open session is never returned as current (truth guard)
|
||||
@@ -218,6 +283,28 @@ func aStaleOpenSessionIsNeverReturnedAsCurrent() async throws {
|
||||
|
||||
// MARK: - Fixtures
|
||||
|
||||
/// Writes an archived session folder with the given creation date, exactly the shape
|
||||
/// production writes (a manifest plus one PNG), so retention can be exercised without
|
||||
/// waiting days.
|
||||
private func writeArchivedSession(createdAt: Date, in paths: AppSupportPaths) throws -> UUID {
|
||||
let id = UUID()
|
||||
let dir = paths.archiveDirectory(id)
|
||||
try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
|
||||
let pngName = "001-A1B2C3D4.png"
|
||||
try makePNGData(width: 4, height: 4, red: 0.5, green: 0.5, blue: 0.5)
|
||||
.write(to: dir.appendingPathComponent(pngName))
|
||||
let capture = Capture(
|
||||
id: UUID(), sequence: 1, fileName: pngName,
|
||||
pixelWidth: 4, pixelHeight: 4, scale: 1.0, capturedAt: createdAt)
|
||||
let session = CaptureSession(
|
||||
id: id, createdAt: createdAt, state: .archived, captures: [capture],
|
||||
pdfFileName: "Redline-\(DubaiTime.fileMinuteStamp(createdAt)).pdf")
|
||||
let encoder = JSONEncoder()
|
||||
encoder.dateEncodingStrategy = .iso8601
|
||||
try encoder.encode(session).write(to: dir.appendingPathComponent("session.json"))
|
||||
return id
|
||||
}
|
||||
|
||||
private enum FixtureError: Error {
|
||||
case pngGenerationFailed
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user