Skip to content

Flow — Submit an assessment run

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
Persona Dana (Requester)
Experience requirements FUX-01, FUX-03, FUX-04, FUX-08
Steps 5

A requester submits a run against a Published agent release with an explicit repository revision, model profile and limits, watches it progress and reads its artifacts.

flowchart TD
    s1["1. my-work<br/>scope correct?"] --> s2
    s2["2. run-submit<br/>release Published and budget available?"] --> s3
    s3["3. run-detail<br/>approval needed?"] --> s4
    s4["4. artifacts"] --> s5
    s5["5. usage-cost"]
    s1 -. "scope switch refused: no permission in the target project (FUX-01)" .-> x1_1["adverse 1.1"]
    s2 -. "release not Published (shown, not selectable)" .-> x2_1["adverse 2.1"]
    s2 -. "budget exhausted: submission refused with the limiting quota" .-> x2_2["adverse 2.2"]
    s2 -. "idempotency key reused with different input: 409" .-> x2_3["adverse 2.3"]
    s3 -. "run WaitingApproval with the approval named" .-> x3_1["adverse 3.1"]
    s3 -. "projection stale: freshness badge and refresh" .-> x3_2["adverse 3.2"]
    s3 -. "run Failed with the failure class and the last receipt" .-> x3_3["adverse 3.3"]
    s4 -. "artifact classification above the viewer's ceiling: denied with explanation" .-> x4_1["adverse 4.1"]
    s5 -. "uncertain usage shown separately (FUX-08)" .-> x5_1["adverse 5.1"]
Hold "Alt" / "Option" to enable pan & zoom

Steps

# Screen Decision point Reads Commands Adverse branches
1 my-work — My work scope correct? GetStudioSession, ListNotifications, ListRuns, ListApprovals SetStudioScope scope switch refused: no permission in the target project (FUX-01)
2 run-submit — Submit a run release Published and budget available? ListReleases, GetProjectUsage, ListModelProfiles SubmitRun release not Published (shown, not selectable); budget exhausted: submission refused with the limiting quota; idempotency key reused with different input: 409
3 run-detail — Run detail approval needed? GetRun, GetRunTimeline, ListRunArtifacts, ListRunReceipts, ListRunToolReceipts, GetRunUsage CancelRun run WaitingApproval with the approval named; projection stale: freshness badge and refresh; run Failed with the failure class and the last receipt
4 artifacts — Artifacts and lineage — ListRunArtifacts, GetArtifact, PreviewArtifact, ListArtifactVersions ExportArtifacts artifact classification above the viewer's ceiling: denied with explanation
5 usage-cost — Usage and cost — GetProjectUsage, GetRunUsage, GetSubscription, ListInvoices SetProjectBudget uncertain usage shown separately (FUX-08)

Acceptance

Every step is exercised keyboard-only at 1440×900 and 390×844, in light and dark, in en and he (RTL); every adverse branch renders its state from the states catalog with words, never colour alone; a command's outcome is the server's response, never a toast.