native macOS codings agent orchestrator prowl.onev.cat
Something went wrong. Try again.
Swift
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352// App/Tests/WorkflowRunsFeatureTests.swift// The reducer that wires B2's machine to the boundaries (docs-ai 063 B3): ordered effect// execution, the two-phase `deliver` rendezvous, late launches, and the restart scan.
import ComposableArchitectureimport DependenciesTestSupportimport Foundationimport ProwlCLISharedimport Testing
@testable import Prowl
/// A line the fake terminal received, with whether the instruction file it points at existed.struct WorkflowTypedLineRecord { let surfaceID: UUID let line: String let instructionExisted: Bool}
// Runs and restart recovery must share storage within a test, never across tests.@Suite( .dependencies { $0[WorkflowHistoryStorageKey.self] = WorkflowHistoryStorage( baseURL: FileManager.default.temporaryDirectory.appending(path: "workflow-history-\(UUID().uuidString)")) })@MainActorstruct WorkflowRunsFeatureTests { nonisolated private static let now = Date(timeIntervalSince1970: 1_760_000_000) private static let authorPane = WorkflowRunMachineTests.authorPane private static let reviewerProfile = WorkflowRunMachineTests.reviewerProfile
/// A `close` followed by another awaited step, so the close is queued while the run goes on. nonisolated private static let closeThenSummary = """ schema: prowl.workflow/v1 id: test.close-then-summary name: Close Then Summary roles: author: source: current reviewer: source: launch placement: split direction: right steps: - id: brief message: author prompt: "Write the brief." expect: { delivery: brief } - id: launch launch: reviewer prompt: "Review {{ deliveries.brief.path }}." expect: { delivery: findings } - id: cleanup close: reviewer - id: summary message: author prompt: "Findings: {{ deliveries.findings.path }}. Summarize." expect: { delivery: summary } """
/// A native action as the first step: the run starts in `runningAction`. nonisolated private static let actionFirst = """ schema: prowl.workflow/v1 id: test.action-first name: Action First roles: author: source: current reviewer: source: launch placement: tab steps: - id: context action: builtin:collect-worktree-context with: { root: "{{ context.worktree.path }}" } - id: launch launch: reviewer prompt: "Review." - id: done notify: "Done" """
/// Records every boundary call; the runtime fakes answer synchronously. @MainActor final class Fixture { let root: URL let worktree: Worktree var typed: [WorkflowTypedLineRecord] = [] var launches: [WorkflowLaunchRequest] = [] var closed: [UUID] = [] var notifications: [WorkflowRuntimeNotification] = [] var opened: [UUID] = [] var cancelled: [String] = [] var abandoned: [(dispatchID: String, reason: String)] = [] var completed: [String] = [] var armed: [WorkflowWatchdogRequest] = [] var disarmed: [Int] = [] var responses: [(requestID: UUID, resolution: WorkflowRequestResolution)] = [] var roleWaitOutcome: WorkflowRoleWaitOutcome = .idle var launchOutcome: Result<WorkflowLaunchResult, WorkflowLaunchError>? /// What the liveness guard answered on each `deliverLine`. var guardAnswers: [Bool] = [] private var dispatchCounter = 0 private var paneCounter = 10
init() throws { root = FileManager.default.temporaryDirectory .appending(path: "workflow-runs-feature-tests", directoryHint: .isDirectory) .appending(path: UUID().uuidString, directoryHint: .isDirectory) .standardizedFileURL let skill = root.appending( path: "skills/prowl.adversarial-reviewer", directoryHint: .isDirectory) try FileManager.default.createDirectory(at: skill, withIntermediateDirectories: true) try "---\nname: r\ndescription: d\n---\n# Reviewer\n".write( to: skill.appending(path: "SKILL.md"), atomically: true, encoding: .utf8) worktree = Worktree( id: "wt", name: "feature", detail: "", workingDirectory: root, repositoryRootURL: root) }
func cleanUp() { try? FileManager.default.removeItem(at: root) }
var runtime: WorkflowRuntimeClient { WorkflowRuntimeClient( waitForRole: { [self] _ in roleWaitOutcome }, deliverLine: { [self] _, surfaceID, line, isLive in let live = isLive() guardAnswers.append(live) guard live else { return .stale } let pointer = line.split(separator: " ").first { $0.hasPrefix("/") }.map(String.init) let existed = pointer.map { FileManager.default.fileExists(atPath: $0) } ?? true typed.append(WorkflowTypedLineRecord(surfaceID: surfaceID, line: line, instructionExisted: existed)) return .delivered }, launch: { [self] _, _, request in launches.append(request) if let launchOutcome { return launchOutcome } paneCounter += 1 let pane = WorkflowPaneIdentity( surfaceID: UUID(), tabID: UUID(), handle: "p\(paneCounter)", displayName: request.profile.name, agent: request.profile.agent) let dispatchID = request.expectsDelivery ? issue(pane.surfaceID) : nil return .success(WorkflowLaunchResult(pane: pane, dispatchID: dispatchID)) }, close: { [self] _, surfaceID, _ in closed.append(surfaceID) return true }, notify: { [self] _, notification in notifications.append(notification) } ) }
var activation: WorkflowActivationClient { WorkflowActivationClient( openMessage: { [self] surfaceID in .success(issue(surfaceID)) }, cancel: { [self] id in cancelled.append(id) }, abandon: { [self] id, reason in abandoned.append((id, reason)) }, complete: { [self] id, _ in completed.append(id) }, observe: { _ in nil } ) }
var watchdog: WorkflowWatchdogClient { WorkflowWatchdogClient(arm: { [self] _, request in armed.append(request) return WorkflowWatchdogHandle( verdicts: AsyncStream { $0.finish() }, cancel: { [self] in disarmed.append(request.ordinal) }) }) }
var responder: WorkflowCLIResponderClient { WorkflowCLIResponderClient(respond: { [self] requestID, resolution in responses.append((requestID, resolution)) }) }
private func issue(_ surfaceID: UUID) -> String { dispatchCounter += 1 opened.append(surfaceID) return "dispatch-\(dispatchCounter)" }
func session( _ yaml: String = WorkflowRunMachineTests.adversarialReview, selfInitiated: Bool = false, inputs: [String: String] = [:], skipped: Set<String> = [], startedAt: Date = WorkflowRunsFeatureTests.now ) throws -> (WorkflowRunSession, [WorkflowRunEffect]) { let definition = try #require(WorkflowDocumentParser.parse(yaml).definition) let counter = WorkflowRunMachineTests.TokenCounter() let started = try WorkflowRunMachine.start( WorkflowRunStartRequest( definition: definition, runID: UUID(), context: WorkflowRunContext( scope: .user, definitionPath: nil, worktree: WorkflowRunWorktree( id: "wt", name: "feature", branch: "feat/x", path: root.path(percentEncoded: false))), bindings: [ definition.roles[0].name: .current(WorkflowRunsFeatureTests.authorPane), definition.roles[1].name: .launch(WorkflowRunsFeatureTests.reviewerProfile, pane: nil), ], inputs: inputs, skippedSteps: skipped, selfInitiated: selfInitiated), now: { startedAt }, makeToken: { counter.next() }) let plan = AgentProfileLaunchPlan( profileID: WorkflowRunsFeatureTests.reviewerProfile.id, profileName: "Pi Reviewer", runtime: .pi, invocation: AgentInvocation(executable: "pi", arguments: ["placeholder"]), commandEnvironmentTokens: [], placement: .split, splitDirection: .right, surfaceEnvironment: [AgentProfileLaunchPlanner.promptCarrierName: "placeholder"], dedicatedHome: nil) let session = WorkflowRunSession( run: started.machine.run, worktree: worktree, launchPlans: [definition.roles[1].name: plan], bindingMemoryKeys: [ definition.roles[1].name: WorkflowBindingResolver.memoryKey( scope: .user, workflowID: definition.id, role: definition.roles[1]) ], skills: [ "prowl.adversarial-reviewer": BundledSkill( id: "prowl.adversarial-reviewer", name: "Reviewer", description: "d", audience: .workflow, directoryURL: root.appending( path: "skills/prowl.adversarial-reviewer", directoryHint: .isDirectory)) ]) return (session, started.effects) } }
private func makeStore( _ fixture: Fixture, queue: WorkflowEffectQueueClient, storage: SettingsTestStorage = SettingsTestStorage(), actionExecutor: (any WorkflowActionExecuting)? = nil, handoffSessionContext: HandoffStore.SessionContext? = nil, clock: any Clock<Duration> = ImmediateClock() ) -> TestStoreOf<WorkflowRunsFeature> { let store = TestStore(initialState: WorkflowRunsFeature.State()) { WorkflowRunsFeature() } withDependencies: { if let actionExecutor { $0.workflowActionExecutor = actionExecutor } $0[TerminalClient.self].handoffSessionContextForSurface = { _, _ in handoffSessionContext } $0.workflowRuntimeClient = fixture.runtime $0.workflowActivationClient = fixture.activation $0.workflowWatchdogClient = fixture.watchdog $0.workflowEffectQueue = queue $0.workflowCLIResponder = fixture.responder $0.date.now = Self.now $0.uuid = .incrementing $0.settingsFileStorage = storage.storage $0.continuousClock = clock } store.exhaustivity = .off(showSkippedAssertions: false) return store }
/// A queue that records batches without performing them, for transitions under test control. @MainActor final class RecordingQueue { var batches: [(runID: UUID, effects: [WorkflowRunEffect])] = [] var fenced: [UUID] = [] var finished: [UUID] = [] var client: WorkflowEffectQueueClient { WorkflowEffectQueueClient( start: { _ in AsyncStream { $0.finish() } }, enqueue: { [self] runID, batch in batches.append((runID, batch.effects)) }, fence: { [self] runID in fenced.append(runID) }, isStale: { _, _ in false }, finish: { [self] runID in finished.append(runID) }) } var effects: [WorkflowRunEffect] { batches.flatMap(\.effects) } }
@MainActor final class HoldingDeliveryQueue { private let queue = WorkflowEffectQueue() private var held: [(UUID, WorkflowEffectBatch)] = [] var isHolding = false var client: WorkflowEffectQueueClient { WorkflowEffectQueueClient( start: { [queue] in queue.start($0) }, enqueue: { [self] id, batch in if isHolding || batch.effects.contains(where: { if case .persistDelivery = $0 { true } else { false } }) { isHolding = true held.append((id, batch)) } else { queue.enqueue(id, batch) } }, fence: { [queue] in queue.fence($0) }, isStale: { [queue] in queue.isStale($0, sequence: $1) }, finish: { [queue] in queue.finish($0) }) } func release() { isHolding = false for (id, batch) in held { queue.enqueue(id, batch) } held = [] } }
@Test(.dependencies, arguments: [false, true]) func cancellationRetainsLatePersistenceEvidence(persistenceFails: Bool) async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = HoldingDeliveryQueue() let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let id = session.run.id await store.send(.started(session, effects: effects)) await store.receive(.event(runID: id, .roleIdle(ordinal: 1)), timeout: Self.timeout) await store.receive( .event(runID: id, .injectionSucceeded(ordinal: 1, dispatchID: "dispatch-1")), timeout: Self.timeout) await store.send( .deliver( .init( requestID: UUID(), runID: id, ordinal: 1, selector: .token(Self.firstToken), body: "# Brief\n## Scope\nx\n## Claims\ny", verdict: nil, source: "pane"))) #expect(queue.isHolding) let activation = try #require(store.state.sessions[id]?.run.activeActivation) let body = try #require(activation.pendingDelivery?.body) let path = WorkflowRunPaths.submissionURL( runDirectory: session.run.runDirectory, name: activation.deliveryName, ordinal: 1, body: body) if persistenceFails { try FileManager.default.createDirectory(at: path, withIntermediateDirectories: false) } await store.send(.userAction(runID: id, .cancel)) queue.release() await store.receive(\.event, timeout: Self.timeout) await store.finish(timeout: Self.timeout) let run = try #require(store.state.sessions[id]?.run) let record = try session.store.readRecord(runID: id) #expect(run.status == .cancelled) #expect(record.run.status.state == "cancelled") #expect(fixture.completed.isEmpty) #expect(fixture.launches.isEmpty) #expect(fixture.responses.count == 1) #expect(fixture.responses.allSatisfy { if case .failed = $0.resolution { true } else { false } }) let submissions = record.steps.flatMap { $0.submissions ?? [] } if persistenceFails { #expect(submissions.isEmpty) #expect(record.steps.first?.error?.contains("save") == true) } else { #expect(submissions.count == 1) #expect(submissions.first?.accepted == false) #expect(record.steps.first?.ordinal == 1) #expect(try String(contentsOf: path, encoding: .utf8) == body) } }
/// A real queue whose fence rises on the n-th staleness check of the run — as a cancel that /// reduces on that very main-actor turn would raise it; `reached()` returns once it did. @MainActor final class FencingQueue { private let queue = WorkflowEffectQueue() private let fenceOnCheck: Int private var checks = 0 private var waiter: CheckedContinuation<Void, Never>?
init(fenceOnCheck: Int) { self.fenceOnCheck = fenceOnCheck }
var client: WorkflowEffectQueueClient { WorkflowEffectQueueClient( start: { [queue] runID in queue.start(runID) }, enqueue: { [queue] runID, batch in queue.enqueue(runID, batch) }, fence: { [queue] runID in queue.fence(runID) }, isStale: { [self] runID, sequence in checks += 1 if checks == fenceOnCheck { queue.fence(runID) waiter?.resume() waiter = nil } return queue.isStale(runID, sequence: sequence) }, finish: { [queue] runID in queue.finish(runID) }) }
func reached() async { guard checks < fenceOnCheck else { return } await withCheckedContinuation { waiter = $0 } } }
/// A native action that reports when it started and finishes only once released. nonisolated final class GatedActionExecutor: WorkflowActionExecuting, Sendable { let receivedContext = LockIsolated<WorkflowActionContext?>(nil) private let startedStream = AsyncStream<Void>.makeStream() private let releaseStream = AsyncStream<Void>.makeStream()
func execute(actionID: String, inputs: [String: WorkflowJSONValue], context: WorkflowActionContext) async throws -> [String: WorkflowJSONValue] { receivedContext.setValue(context) startedStream.continuation.yield() for await _ in releaseStream.stream { break } return ["summary": "done"] }
func started() async { for await _ in startedStream.stream { break } }
func release() { releaseStream.continuation.yield() } }
private static let timeout: Duration = .seconds(5) /// Tokens are minted by the reducer's `uuid` dependency (`.incrementing`) when a step opens. nonisolated private static let firstToken = "00000000-0000-0000-0000-000000000000" nonisolated private static let secondToken = "00000000-0000-0000-0000-000000000001"
// MARK: - Ordered execution
@Test(.dependencies) func aRunPerformsItsEffectsInMachineOrderAndAnswersDeliverAfterPersistence() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let storage = SettingsTestStorage() let store = makeStore(fixture, queue: WorkflowEffectQueue().client, storage: storage) let (session, effects) = try fixture.session() let runID = session.run.id let runDirectory = session.store.directory(for: runID)
await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await store.receive( .event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "dispatch-1")), timeout: Self.timeout) #expect(fixture.typed.count == 1) #expect( fixture.typed[0].instructionExisted, "the instruction file must exist before the pointer is typed") #expect(fixture.typed[0].line.contains("PROWL_WORKFLOW_TOKEN=\(Self.firstToken) prowl workflow deliver -")) #expect(fixture.armed.map(\.ordinal) == [1]) let record = try session.store.readRecord(runID: runID) #expect(record.run.status.state == "running")
let requestID = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: requestID, runID: runID, ordinal: 1, selector: .token(Self.firstToken), body: "# Brief\n## Scope\nx\n## Claims\ny", verdict: nil, source: "pane")) ) #expect(store.state.pendingDeliveries[requestID]?.ordinal == 1) await store.receive(.event(runID: runID, .deliveryPersisted(ordinal: 1)), timeout: Self.timeout) #expect(fixture.responses.count == 1) guard case .delivered(let run, let receipt) = fixture.responses[0].resolution else { Issue.record("expected a delivered resolution, got \(fixture.responses[0].resolution)") return } #expect(receipt.ordinal == 1) #expect(run.deliveries["brief"]?.ordinal == 1) #expect(store.state.pendingDeliveries.isEmpty) #expect(fixture.disarmed.first == 1, "the accepted delivery disarms its watchdog") #expect(fixture.completed == ["dispatch-1"])
// The next step launches the reviewer: skill materialized, plan frozen, pane bound, memory written. await store.receive(\.event, timeout: Self.timeout) #expect(fixture.launches.count == 1) #expect(fixture.launches[0].environment["PROWL_WORKFLOW_TOKEN"] == Self.secondToken) #expect( FileManager.default.fileExists( atPath: runDirectory.appending(path: "skills/prowl.adversarial-reviewer/SKILL.md").path( percentEncoded: false))) let reviewerPane = try #require(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane) #expect(reviewerPane.handle == "p11") #expect(store.state.paneOwners[reviewerPane.surfaceID] == runID, "a launch take-up records the owner") #expect(fixture.armed.map(\.ordinal) == [1, 2]) let key = try #require(session.bindingMemoryKeys["reviewer"]) let remembered = withDependencies { $0.settingsFileStorage = storage.storage } operation: { @Shared(.userGlobalSettings) var settings return settings.rememberedWorkflowBinding(for: key) } #expect(remembered == Self.reviewerProfile.id)
await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run.status = .cancelled } await store.finish(timeout: Self.timeout) #expect(fixture.abandoned.map(\.dispatchID) == ["dispatch-2"]) #expect(fixture.disarmed.sorted() == [1, 2]) #expect(try session.store.readRecord(runID: runID).run.status.state == "cancelled") let log = try String(contentsOf: runDirectory.appending(path: "log.md"), encoding: .utf8) #expect(log.contains("Run finished: cancelled.")) #expect(!log.contains("TOKEN-")) }
@Test(.dependencies) func aFailedInstructionWriteStopsTheBatchBeforeAnythingIsTyped() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let store = makeStore(fixture, queue: WorkflowEffectQueue().client) let (session, effects) = try fixture.session() let runID = session.run.id // The run directory's `instructions` leaf becomes a link, which the store refuses. try session.store.ensureLayout(runID: runID) let instructions = session.store.directory(for: runID).appending( path: "prompts", directoryHint: .isDirectory) try FileManager.default.removeItem(at: instructions) let elsewhere = fixture.root.appending(path: "elsewhere", directoryHint: .isDirectory) try FileManager.default.createDirectory(at: elsewhere, withIntermediateDirectories: true) try FileManager.default.createSymbolicLink(at: instructions, withDestinationURL: elsewhere)
await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await store.receive(\.event, timeout: Self.timeout) #expect( store.state.sessions[runID]?.run.status.attention?.reason.code == "injection_failed:activation_unavailable") #expect(fixture.typed.isEmpty) #expect(fixture.opened.isEmpty) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Rendezvous (decision W1)
@Test(.dependencies) func cancelWhileTheOutputIsPersistingFailsThePendingDeliver() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: []))
let requestID = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: requestID, runID: runID, ordinal: 1, selector: .token("TOKEN-1"), body: "## Scope\nx\n## Claims\ny", verdict: nil, source: "pane"))) #expect(store.state.pendingDeliveries[requestID]?.ordinal == 1) #expect(store.state.sessions[runID]?.run.activeActivation?.state == .persisting) #expect(fixture.responses.isEmpty) #expect( queue.effects.contains { if case .persistDelivery = $0 { return true } else { return false } })
await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) #expect(store.state.pendingDeliveries.isEmpty) #expect(fixture.responses.count == 1) #expect(fixture.responses[0].requestID == requestID) #expect( fixture.responses[0].resolution == .failed( code: CLIErrorCode.stepNotExpecting, message: "The step stopped waiting for this delivery before the output was saved.")) #expect(queue.effects.contains(.finished(.cancelled)))
// The queued `.deliveryPersisted` of the abandoned write is stale: ignored, nothing answered twice. await store.send(.event(runID: runID, .deliveryPersisted(ordinal: 1))) #expect(fixture.responses.count == 1) }
@Test(.dependencies) func aPersistenceFailureFailsThePendingDeliverWithWorkflowFailed() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: [])) let requestID = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: requestID, runID: runID, ordinal: 1, selector: .token("TOKEN-1"), body: "## Scope\nx\n## Claims\ny", verdict: nil, source: "manual"))) #expect(queue.effects.first == .log("Step 'brief': delivery received (source=manual)."))
await store.send(.event(runID: runID, .deliveryPersistFailed(ordinal: 1, reason: "disk full"))) #expect(store.state.sessions[runID]?.run.status.attention?.reason.code == "persist_failed") #expect(store.state.pendingDeliveries.isEmpty) #expect(fixture.responses.count == 1) guard case .failed(let code, let message) = fixture.responses[0].resolution else { Issue.record("expected a failure") return } #expect(code == CLIErrorCode.workflowFailed) #expect(message.contains("disk full")) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
@Test(.dependencies) func aProvisionalDeliveryIsAnsweredAsProvisionalWithItsIssues() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: [])) let requestID = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: requestID, runID: runID, ordinal: 1, selector: .token("TOKEN-1"), body: "## Scope\nonly", verdict: nil, source: "pane"))) await store.send(.event(runID: runID, .deliveryPersisted(ordinal: 1))) #expect(store.state.sessions[runID]?.run.status.attention?.reason.code == "delivery_issues") #expect(fixture.responses.count == 1) guard case .provisional(_, let receipt) = fixture.responses[0].resolution else { Issue.record("expected a provisional resolution") return } #expect(receipt.issues == [.missingSections(["## Claims"])]) #expect(fixture.completed.isEmpty, "the dispatch record stays pending until the user accepts") await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
@Test(.dependencies) func aRejectedDeliveryIsAnsweredAtOnceWithoutAPendingRequest() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: []))
let wrongToken = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: wrongToken, runID: runID, ordinal: 1, selector: .token("TOKEN-9"), body: "## Scope\nx\n## Claims\ny", verdict: nil, source: "pane"))) let unknownRun = UUID() await store.send( .deliver( WorkflowDeliveryRequest( requestID: unknownRun, runID: UUID(), ordinal: nil, selector: .manual(stepID: "brief"), body: "x", verdict: nil, source: "manual"))) await store.finish(timeout: Self.timeout) #expect(store.state.pendingDeliveries.isEmpty) #expect(fixture.responses.map(\.requestID) == [wrongToken, unknownRun]) #expect( fixture.responses[0].resolution == .failed( code: CLIErrorCode.tokenInvalid, message: WorkflowDeliveryError.tokenInvalid.message)) #expect( fixture.responses[1].resolution == .failed(code: CLIErrorCode.runNotFound, message: "The workflow run is not active.")) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Late and stale launches
@Test(.dependencies) func aLaunchThatCompletesAfterTheRunEndedIsAbandonedAndClosed() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: [])) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout)
let pane = WorkflowPaneIdentity( surfaceID: UUID(), tabID: nil, handle: "p7", displayName: "Pi", agent: "pi") await store.send( .event(runID: runID, .launched(ordinal: 2, pane: pane, dispatchID: "late-dispatch"))) await store.finish(timeout: Self.timeout) #expect(fixture.abandoned.map(\.dispatchID) == ["late-dispatch"]) #expect(fixture.closed == [pane.surfaceID]) }
@Test(.dependencies) func aLaunchTheMachineNoLongerExpectsIsClosedToo() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: []))
let pane = WorkflowPaneIdentity( surfaceID: UUID(), tabID: nil, handle: "p8", displayName: "Pi", agent: "pi") await store.send( .event(runID: runID, .launched(ordinal: 42, pane: pane, dispatchID: "stale-dispatch"))) await store.finish(timeout: Self.timeout) #expect(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane == nil) #expect(fixture.abandoned.map(\.dispatchID) == ["stale-dispatch"]) #expect(fixture.closed == [pane.surfaceID]) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Fences and stale work
/// Cancel, skip, and retry revoke the invocation whose work may still sit in the queue; the /// reducer fences the queue so that work is dropped instead of typing into the pane. @Test(.dependencies) func revokingAnInFlightInvocationFencesTheQueue() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) #expect(queue.fenced.isEmpty) // The idle wait ended and the inject is (conceptually) queued; a cancel must fence it. await store.send(.userAction(runID: runID, .cancel)) #expect(queue.fenced == [runID]) await store.finish(timeout: Self.timeout)
// A retry from an attention likewise revokes the in-flight invocation. let second = try fixture.session().0 let secondID = second.run.id await store.send(.started(second, effects: [])) await store.send(.event(runID: secondID, .roleUnavailable(ordinal: 1, .roleBlocked))) #expect(queue.fenced == [runID], "attention alone revokes nothing") await store.send(.userAction(runID: secondID, .retry)) #expect(queue.fenced == [runID, secondID]) await store.send(.userAction(runID: secondID, .cancel)) await store.finish(timeout: Self.timeout) }
/// A typed line whose `.injectionSucceeded` the machine no longer takes up (the step moved on) /// leaves a pending dispatch record behind unless the wiring abandons it. @Test(.dependencies) func anIgnoredInjectionAbandonsTheRecordItOpened() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let waiting = try waitingForDelivery(session) let runID = waiting.run.id await store.send(.started(waiting, effects: [])) await store.send(.event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "stale-1"))) await store.finish(timeout: Self.timeout) #expect(fixture.abandoned.map(\.dispatchID) == ["stale-1"])
await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) await store.send(.event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "late-1"))) await store.finish(timeout: Self.timeout) // The cancel's own abandon of `dispatch-0` is an ordered effect the recording queue never // performs; the late injection's record is abandoned directly by the reducer. #expect(fixture.abandoned.map(\.dispatchID) == ["stale-1", "late-1"]) }
/// The first `inject` makes three staleness checks in order: the batch check, the guard before /// the record is issued, and the guard the terminal evaluates on the typing turn. A fence that /// rises on the last one (a cancel reducing on that turn) returns the issuance: nothing is typed /// and no event reaches the machine. @Test(.dependencies) func aFenceOnTheTypingTurnReturnsTheIssuanceAndTypesNothing() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = FencingQueue(fenceOnCheck: 3) let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await queue.reached() #expect(fixture.opened.count == 1) #expect(fixture.guardAnswers == [false], "the guard the terminal evaluates reflects the real fence") #expect(fixture.cancelled == ["dispatch-1"]) #expect(fixture.typed.isEmpty) #expect(store.state.sessions[runID]?.run.phase == .injecting(ordinal: 1)) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
/// A fence that rises between the batch check and the issuance opens no record at all. @Test(.dependencies) func aFenceBeforeTheIssuanceOpensNoRecord() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = FencingQueue(fenceOnCheck: 2) let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await queue.reached() #expect(fixture.opened.isEmpty) #expect(fixture.cancelled.isEmpty) #expect(fixture.typed.isEmpty) #expect(fixture.guardAnswers.isEmpty) #expect(store.state.sessions[runID]?.run.phase == .injecting(ordinal: 1)) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
@Test(.dependencies) func handoffActionCapturesTheSourceSession() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let gate = GatedActionExecutor() let source = HandoffStore.SessionContext( agent: "pi", sessionID: "handoff-session", paneID: "source-pane", paneTitle: nil, source: "test", confidence: "exact", excerptText: nil) let store = makeStore( fixture, queue: WorkflowEffectQueue().client, actionExecutor: gate, handoffSessionContext: source) let (session, effects) = try fixture.session( Self.actionFirst .replacing("builtin:collect-worktree-context", with: "builtin:save-handoff") .replacing("root:", with: "briefing:")) await store.send(.started(session, effects: effects)) await gate.started() #expect(gate.receivedContext.value?.sessionContext?.sessionID == "handoff-session") #expect(gate.receivedContext.value?.outgoingAgent == "pi") gate.release() await store.finish(timeout: Self.timeout) }
/// A native action checks the fence once more right before it starts: a cancel that lands /// after the batch check runs nothing, and the run log says so. @Test(.dependencies) func aFenceBeforeANativeActionStartsRunsNothing() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = FencingQueue(fenceOnCheck: 2) let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session(Self.actionFirst) let runID = session.run.id #expect( effects.contains( .runAction( stepID: "context", actionID: "builtin:collect-worktree-context", inputs: ["root": .string(fixture.root.path(percentEncoded: false))]))) await store.send(.started(session, effects: effects)) await queue.reached() #expect(store.state.sessions[runID]?.run.phase == .runningAction(stepID: "context")) #expect(store.state.sessions[runID]?.run.status == .running) #expect(store.state.sessions[runID]?.run.actionOutputs.isEmpty == true) await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run.status = .cancelled } await store.finish(timeout: Self.timeout) let log = try String( contentsOf: session.store.directory(for: runID).appending(path: "log.md"), encoding: .utf8) #expect(log.contains("Run finished: cancelled.")) #expect(!log.contains("action completed")) }
/// An action that already left the main actor runs to completion; the run that was cancelled /// meanwhile discards its result and the log records that it finished late. @Test(.dependencies) func aNativeActionThatOutlivesTheRunIsDiscardedAndLogged() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let gate = GatedActionExecutor() let store = makeStore(fixture, queue: WorkflowEffectQueue().client, actionExecutor: gate) let (session, effects) = try fixture.session(Self.actionFirst) let runID = session.run.id await store.send(.started(session, effects: effects)) await gate.started() await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run.status = .cancelled } gate.release() await store.finish(timeout: Self.timeout) #expect(store.state.sessions[runID]?.run.actionOutputs.isEmpty == true) let log = try String( contentsOf: session.store.directory(for: runID).appending(path: "log.md"), encoding: .utf8) #expect(!log.contains("action completed")) #expect(!log.contains("not started")) #expect(log.contains("Run finished: cancelled.")) }
/// `close` is revocable: a cancel that beats a queued close keeps the pane, while a close the /// run reaches normally removes it before the next line is typed. @Test(.dependencies) func aCloseStepRemovesThePaneBeforeTheNextLineIsTyped() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let store = makeStore(fixture, queue: WorkflowEffectQueue().client) let (session, effects) = try fixture.session(Self.closeThenSummary) let runID = session.run.id let reviewer = try await driveToCleanup(store, fixture: fixture, session: session, effects: effects) await store.receive(.event(runID: runID, .roleIdle(ordinal: 3)), timeout: Self.timeout) await store.receive( .event(runID: runID, .injectionSucceeded(ordinal: 3, dispatchID: "dispatch-3")), timeout: Self.timeout) #expect(fixture.closed == [reviewer.surfaceID]) #expect(fixture.typed.count == 2) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
@Test(.dependencies) func aCancelThatBeatsAQueuedCloseKeepsThePane() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } // Staleness checks in FIFO order: inject 1 (batch, issuance, typing turn), launch 2 (batch), // then the close's batch check — the fence rises there. let queue = FencingQueue(fenceOnCheck: 5) let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session(Self.closeThenSummary) let runID = session.run.id let reviewer = try await driveToCleanup(store, fixture: fixture, session: session, effects: effects) await queue.reached() #expect(fixture.closed.isEmpty) #expect(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane?.surfaceID == reviewer.surfaceID) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) #expect(fixture.closed.isEmpty, "cancel never closes panes") }
/// The boundary's ownership rule: the pane belongs to the run that bound it most recently — /// recorded at admission and at launch take-up, never read from a clock — also once that run /// has ended and kept it, never to an earlier run whose close is still queued. @Test(.dependencies) func theMostRecentBindingOwnsAPaneWhateverTheClockSays() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let pane = WorkflowRunMachineTests.reviewerPane var earlier = try fixture.session().0 earlier.run.bindings["reviewer"] = .launch(Self.reviewerProfile, pane: pane) await store.send(.started(earlier, effects: [])) { $0.paneOwners[pane.surfaceID] = earlier.run.id } // A later admission whose clock reading is *earlier* still takes the pane over. var later = try fixture.session(startedAt: Self.now.addingTimeInterval(-60)).0 later.run.bindings["author"] = .current(pane) await store.send(.started(later, effects: [])) { $0.paneOwners[pane.surfaceID] = later.run.id } await store.send(.userAction(runID: later.run.id, .cancel)) await store.send(.userAction(runID: earlier.run.id, .cancel)) await store.finish(timeout: Self.timeout) #expect(store.state.activeSession(boundTo: pane.surfaceID) == nil, "an ended run is no longer busy") #expect( store.state.paneOwners[pane.surfaceID] == later.run.id, "the later run keeps the pane it ended with; the earlier run never gets it back") }
/// A relaunch drops the old pane from the role's binding, but the pane stays among the panes /// the run ever owned: admission prunes launch reservations against that set, so the old pane /// is neither reserved forever nor handed back to the run that left it. @Test(.dependencies) func aRelaunchKeepsTheOldPaneAmongTheOwnedOnes() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let store = makeStore(fixture, queue: WorkflowEffectQueue().client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await store.receive( .event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "dispatch-1")), timeout: Self.timeout) await store.send( .deliver( WorkflowDeliveryRequest( requestID: UUID(), runID: runID, ordinal: 1, selector: .token(Self.firstToken), body: "# Brief\n## Scope\nx\n## Claims\ny", verdict: nil, source: "pane"))) await store.receive(.event(runID: runID, .deliveryPersisted(ordinal: 1)), timeout: Self.timeout) await store.receive(\.event, timeout: Self.timeout) let first = try #require(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane) #expect(store.state.paneOwners[first.surfaceID] == runID) // The launch boundary reserved the pane while the launch was in flight. let reservations = WorkflowPaneReservations() reservations.reserve(first.surfaceID)
await store.send(.event(runID: runID, .watchdog(ordinal: 2, .attention(.agentGone(.sessionEnded))))) await store.send(.userAction(runID: runID, .relaunch)) await store.receive(\.event, timeout: Self.timeout) let second = try #require(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane) #expect(second.surfaceID != first.surfaceID) #expect(store.state.sessions[runID]?.boundSurfaceIDs == [Self.authorPane.surfaceID, second.surfaceID]) #expect(store.state.paneOwners[first.surfaceID] == runID, "the pane the relaunch left stays owned") #expect(store.state.paneOwners[second.surfaceID] == runID) #expect( reservations.pending(for: store.state, isLive: { _ in true }).isEmpty, "admission no longer holds the pane the relaunch left, even while it lives") await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
/// A fence that lands before the executor even reaches the action's batch skips it at the /// batch check, and the run log still records that the action was not started. @Test(.dependencies) func anActionSkippedAtTheBatchCheckIsLoggedAsNotStarted() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = FencingQueue(fenceOnCheck: 1) let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session(Self.actionFirst) let runID = session.run.id await store.send(.started(session, effects: effects)) await queue.reached() #expect(store.state.sessions[runID]?.run.phase == .runningAction(stepID: "context")) await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run.status = .cancelled } await store.finish(timeout: Self.timeout) let log = try String( contentsOf: session.store.directory(for: runID).appending(path: "log.md"), encoding: .utf8) #expect( log.contains( "Step 'context': native action 'builtin:collect-worktree-context' not started; the run had moved on.")) #expect(!log.contains("finished after the run moved on")) }
/// Brief delivered, reviewer launched, findings delivered: the run is at `cleanup` (a queued /// close) with the `summary` message's idle wait armed. Returns the reviewer's pane. private func driveToCleanup( _ store: TestStoreOf<WorkflowRunsFeature>, fixture: Fixture, session: WorkflowRunSession, effects: [WorkflowRunEffect] ) async throws -> WorkflowPaneIdentity { let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive(.event(runID: runID, .roleIdle(ordinal: 1)), timeout: Self.timeout) await store.receive( .event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "dispatch-1")), timeout: Self.timeout) await store.send( .deliver( WorkflowDeliveryRequest( requestID: UUID(), runID: runID, ordinal: 1, selector: .token(Self.firstToken), body: "brief", verdict: nil, source: "pane"))) await store.receive(.event(runID: runID, .deliveryPersisted(ordinal: 1)), timeout: Self.timeout) await store.receive(\.event, timeout: Self.timeout) let reviewer = try #require(store.state.sessions[runID]?.run.bindings["reviewer"]?.pane) await store.send( .deliver( WorkflowDeliveryRequest( requestID: UUID(), runID: runID, ordinal: 2, selector: .token(Self.secondToken), body: "findings", verdict: nil, source: "pane"))) await store.receive(.event(runID: runID, .deliveryPersisted(ordinal: 2)), timeout: Self.timeout) return reviewer }
/// Bookkeeping survives a fence; only pane- and worktree-facing effects are revocable. @Test func onlyPaneAndWorktreeFacingEffectsAreRevocable() { let pane = UUID() let request = WorkflowLaunchRequest( role: "r", ordinal: 1, profile: Self.reviewerProfile, prompt: "p", environment: [:], placement: .tab, direction: .right, background: false, anchorSurfaceID: nil, skill: nil, expectsDelivery: true, redelivery: false) #expect(WorkflowRunEffect.openActivation(role: "r", surfaceID: pane, ordinal: 1).isRevocable) #expect( WorkflowRunEffect.inject(role: "r", surfaceID: pane, ordinal: 1, line: "l", opensActivation: true).isRevocable) #expect(WorkflowRunEffect.typeLine(role: "r", surfaceID: pane, line: "l").isRevocable) #expect(WorkflowRunEffect.launch(request).isRevocable) #expect( WorkflowRunEffect.runAction(stepID: "s", actionID: "builtin:collect-worktree-context", inputs: [:]).isRevocable) #expect(!WorkflowRunEffect.completeActivation(dispatchID: "d", summary: "s").isRevocable) #expect(!WorkflowRunEffect.abandonActivation(dispatchID: "d", reason: "r").isRevocable) #expect(!WorkflowRunEffect.persist.isRevocable) #expect(!WorkflowRunEffect.persistDelivery(name: "o", ordinal: 1, body: "b").isRevocable) #expect(!WorkflowRunEffect.log("l").isRevocable) #expect(WorkflowRunEffect.close(role: "r", surfaceID: pane).isRevocable, "cancel never closes panes") #expect(!WorkflowRunEffect.notify("n").isRevocable) #expect(!WorkflowRunEffect.notify("n").isRevocable) #expect(!WorkflowRunEffect.finished(.cancelled).isRevocable) }
// MARK: - Start rendezvous
/// A self-initiated `run` is answered only once its first activation is open, so the caller /// never holds a completion command before the record `done` is attributed by exists. @Test(.dependencies) func aSelfInitiatedRunIsAnsweredOnceItsActivationIsOpen() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session(selfInitiated: true) let runID = session.run.id #expect(session.run.phase == .injecting(ordinal: 1)) #expect(effects.contains(.openActivation(role: "author", surfaceID: Self.authorPane.surfaceID, ordinal: 1))) let requestID = UUID() await store.send(.started(session, effects: effects, requestID: requestID)) { $0.pendingStarts[requestID] = runID } #expect(fixture.responses.isEmpty) await store.send(.event(runID: runID, .injectionSucceeded(ordinal: 1, dispatchID: "dispatch-1"))) { $0.pendingStarts = [:] } await store.finish(timeout: Self.timeout) #expect(fixture.responses.count == 1) guard case .started(let run) = fixture.responses[0].resolution else { Issue.record("expected a started resolution") return } #expect(run.phase == .waitingForDelivery(ordinal: 1)) #expect(run.activeActivation?.dispatchID == "dispatch-1")
// A failed opening answers too, with the run in attention. let (second, secondEffects) = try fixture.session(selfInitiated: true) let secondRequest = UUID() await store.send(.started(second, effects: secondEffects, requestID: secondRequest)) await store.send(.event(runID: second.run.id, .injectionFailed(ordinal: 1, .surfaceMissing))) await store.finish(timeout: Self.timeout) guard case .started(let failed) = fixture.responses[1].resolution else { Issue.record("expected a started resolution") return } #expect(failed.status.attention?.reason.code == "injection_failed:surface_missing") await store.send(.userAction(runID: runID, .cancel)) await store.send(.userAction(runID: second.run.id, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Idle wait outcomes
@Test(.dependencies) func aBlockedRoleDuringTheIdleWaitRaisesAttention() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } fixture.roleWaitOutcome = .blocked let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive( .event(runID: runID, .roleUnavailable(ordinal: 1, .roleBlocked)), timeout: Self.timeout) #expect(store.state.sessions[runID]?.run.status.attention?.reason.code == "injection_failed:role_blocked") await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
@Test(.dependencies) func aPaneWithAForeignPendingDispatchEndsTheIdleWaitInAttention() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } fixture.roleWaitOutcome = .dispatchPending("someone-elses-dispatch") let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) await store.receive(\.event, timeout: Self.timeout) #expect( store.state.sessions[runID]?.run.status.attention?.reason.code == "injection_failed:activation_unavailable") #expect(store.state.sessions[runID]?.run.status.attention?.message.contains("someone-elses-dispatch") == true) #expect(fixture.typed.isEmpty) await store.send(.userAction(runID: runID, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Presentation notices
@Test(.dependencies) func statusEdgesEmitOneTypedNotice() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let (session, _) = try fixture.session() let runID = session.run.id var expectedMachine = session.machine(now: { Self.now }, makeToken: { "unused" }) _ = expectedMachine.apply(.injectionFailed(ordinal: 1, .surfaceMissing)) let notice = try #require( WorkflowRunNotice.statusEdge(from: session.run.status, to: expectedMachine.run) )
await store.send(.started(session, effects: [])) await store.send(.event(runID: runID, .injectionFailed(ordinal: 1, .surfaceMissing))) await store.receive(\.delegate.notice, notice) #expect(notice.kind == .needsAttention) #expect(notice.runID == runID) #expect(notice.worktreeID == fixture.worktree.id) #expect(notice.targetSurfaceID == Self.authorPane.surfaceID) #expect(notice.body.contains("pane is gone"))
// A late event while the same attention state is active is ignored and emits no duplicate. store.exhaustivity = .on await store.send(.event(runID: runID, .injectionFailed(ordinal: 1, .surfaceMissing))) _ = expectedMachine.apply(.user(.cancel)) await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run = expectedMachine.run $0.recentlyFinishedRunIDs = [runID] } // The immediate test clock releases the status item's hold right away. await store.receive(.finishedNoticeExpired(runID)) { $0.recentlyFinishedRunIDs = [] } await store.finish(timeout: Self.timeout) }
@Test func runNoticeCoversMeaningfulTerminalEdgesButNotExplicitCancellation() throws { let fixture = try Fixture() defer { fixture.cleanUp() } var session = try fixture.session().0 let running = session.run.status
session.run.status = .completed #expect(WorkflowRunNotice.statusEdge(from: running, to: session.run)?.kind == .completed) session.run.status = .skipped(step: "brief", dependent: "launch") #expect(WorkflowRunNotice.statusEdge(from: running, to: session.run)?.kind == .skipped) session.run.status = .iterationLimitReached #expect(WorkflowRunNotice.statusEdge(from: running, to: session.run)?.kind == .iterationLimitReached) session.run.status = .cancelled #expect(WorkflowRunNotice.statusEdge(from: running, to: session.run) == nil) #expect(WorkflowRunNotice.statusEdge(from: .completed, to: session.run) == nil) }
@Test func changedAttentionEmitsANewNoticeButIdenticalAttentionDoesNot() throws { let fixture = try Fixture() defer { fixture.cleanUp() } var session = try fixture.session().0 let ordinal = try #require(session.run.currentInvocation?.ordinal) let blocked = WorkflowAttention( reason: .blocked, stepID: "brief", role: "author", ordinal: ordinal, actions: [.focusPane, .keepWaiting, .cancel], message: "The role is blocked." ) let waiting = WorkflowAttention( reason: .idleWithoutDelivery, stepID: "brief", role: "author", ordinal: ordinal, actions: [.focusPane, .nudge, .keepWaiting, .skip, .cancel], message: "The role went idle without delivering." ) session.run.status = .needsAttention(waiting)
#expect( WorkflowRunNotice.statusEdge(from: .needsAttention(blocked), to: session.run)?.kind == .needsAttention ) #expect(WorkflowRunNotice.statusEdge(from: session.run.status, to: session.run) == nil) }
@Test(.dependencies) func explicitFinalNotifySuppressesTheDuplicateGenericCompletionNotification() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let store = makeStore(fixture, queue: WorkflowEffectQueue().client) var session = try fixture.session().0 session.run.status = .completed let base = try #require(WorkflowRunNotice.statusEdge(from: nil, to: session.run)) let expected = WorkflowRunNotice( kind: base.kind, runID: base.runID, worktreeID: base.worktreeID, workflowName: base.workflowName, title: base.title, body: base.body, targetSurfaceID: base.targetSurfaceID, postsNotification: false )
await store.send(.started(session, effects: [.notify("Custom completion")])) await store.receive(\.delegate.notice, expected) await store.finish(timeout: Self.timeout) #expect(fixture.notifications.count == 1) #expect(fixture.notifications.first?.workflowRunID == session.run.id) }
// MARK: - Restart scan
@Test(.dependencies) func recoveryRunsOnceGlobally() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let (session, _) = try fixture.session() try session.store.ensureLayout(runID: session.run.id) try session.store.writeRecord(WorkflowRunRecord(run: session.run)) let queue = RecordingQueue() let store = makeStore(fixture, queue: queue.client) let root = fixture.root.path(percentEncoded: false)
await store.send(.markInterruptedRuns(worktreeRoots: [root])) { $0.scannedWorktreeRoots = [root] } await store.finish(timeout: Self.timeout) #expect(try session.store.readRecord(runID: session.run.id).run.status.state == "interrupted")
// A second scan of the same root is a no-op even after a new run started there. await store.send(.started(session, effects: [])) await store.send(.markInterruptedRuns(worktreeRoots: [root])) await store.finish(timeout: Self.timeout) #expect(store.state.sessions[session.run.id]?.run.status == .running) await store.send(.userAction(runID: session.run.id, .cancel)) await store.finish(timeout: Self.timeout) }
// MARK: - Helpers
/// The session after its first message was typed: activation 1 waits on `dispatch-0`. private func waitingForDelivery(_ session: WorkflowRunSession) throws -> WorkflowRunSession { var machine = session.machine(now: { Self.now }, makeToken: { "TOKEN-1" }) _ = machine.apply(.roleIdle(ordinal: 1)) _ = machine.apply(.injectionSucceeded(ordinal: 1, dispatchID: "dispatch-0")) #expect(machine.run.phase == .waitingForDelivery(ordinal: 1)) var waiting = session waiting.run = machine.run return waiting }}
/// The per-run FIFO's fence: everything enqueued before it is stale, later batches are not.@MainActorstruct WorkflowEffectQueueTests { @Test func aFenceMarksEarlierBatchesStaleAndLaterOnesLive() async throws { let queue = WorkflowEffectQueue() let runID = UUID() let stream = queue.start(runID) let session = try WorkflowRunsFeatureTests.Fixture().session().0 queue.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("one")])) queue.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("two")])) queue.fence(runID) queue.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("three")])) queue.finish(runID) var seen: [(sequence: Int, stale: Bool)] = [] for await batch in stream { seen.append((batch.sequence, queue.isStale(runID, sequence: batch.sequence))) } #expect(seen.map(\.sequence) == [1, 2, 3]) // After `finish` nothing is known about the run: every sequence reads stale. #expect(queue.isStale(runID, sequence: 3)) let queue2 = WorkflowEffectQueue() _ = queue2.start(runID) queue2.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("one")])) queue2.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("two")])) queue2.fence(runID) queue2.enqueue(runID, WorkflowEffectBatch(session: session, effects: [.log("three")])) #expect(queue2.isStale(runID, sequence: 1)) #expect(queue2.isStale(runID, sequence: 2)) #expect(!queue2.isStale(runID, sequence: 3)) }}
extension WorkflowRunsFeatureTests { @Test(.dependencies) func aFinishedRunIsHeldForTheStatusItemThenReleased() async throws { let fixture = try Fixture() defer { fixture.cleanUp() } let clock = TestClock() let store = makeStore(fixture, queue: RecordingQueue().client, clock: clock) let (session, effects) = try fixture.session() let runID = session.run.id await store.send(.started(session, effects: effects)) #expect(store.state.recentlyFinishedRunIDs.isEmpty)
await store.send(.userAction(runID: runID, .cancel)) { $0.sessions[runID]?.run.status = .cancelled $0.recentlyFinishedRunIDs = [runID] } await clock.advance(by: WorkflowRunsFeature.finishedNoticeDuration - .seconds(1)) #expect(store.state.recentlyFinishedRunIDs == [runID]) await clock.advance(by: .seconds(1)) await store.receive(.finishedNoticeExpired(runID)) { $0.recentlyFinishedRunIDs = [] } await store.finish(timeout: Self.timeout) }}