Flow — Publish an asset release¶
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 | Lena (AssetMaintainer) |
| Experience requirements | FUX-02, FUX-05, FUX-10 |
| Steps | 5 |
A maintainer takes an agent, skill, workflow, tool, profile or template from Draft through evaluation and review to Published.
flowchart TD
s1["1. asset-catalog<br/>which asset and version?"] --> s2
s2["2. release-detail<br/>validate then submit?"] --> s3
s3["3. evaluation-runs<br/>passed, failed, waive?"] --> s4
s4["4. approval-card"] --> s5
s5["5. release-detail"]
s1 -. "asset referenced by a vendor model name: validation finding" .-> x1_1["adverse 1.1"]
s2 -. "manifest validation findings by rule" .-> x2_1["adverse 2.1"]
s2 -. "submitting without evaluation evidence: refused" .-> x2_2["adverse 2.2"]
s3 -. "verdict Failed: candidate stays InReview" .-> x3_1["adverse 3.1"]
s3 -. "waiver needs a publication-class approval by someone else" .-> x3_2["adverse 3.2"]
s4 -. "reviewer is the maintainer: not eligible" .-> x4_1["adverse 4.1"]
s5 -. "alias move refused while the previous release has pinned runs: shown, not blocked" .-> x5_1["adverse 5.1"]
Hold "Alt" / "Option" to enable pan & zoom
Steps¶
| # | Screen | Decision point | Reads | Commands | Adverse branches |
|---|---|---|---|---|---|
| 1 | asset-catalog — Asset catalog |
which asset and version? | ListReleases |
— | asset referenced by a vendor model name: validation finding |
| 2 | release-detail — Asset release |
validate then submit? | GetRelease, ListReleaseEvaluations |
ValidateRelease, SubmitRelease, PublishRelease, DeprecateRelease, MoveAlias |
manifest validation findings by rule; submitting without evaluation evidence: refused |
| 3 | evaluation-runs — Evaluation runs |
passed, failed, waive? | ListEvaluationSuites, GetEvaluation |
StartEvaluation, WaiveEvaluation |
verdict Failed: candidate stays InReview; waiver needs a publication-class approval by someone else |
| 4 | approval-card — Approval card |
— | ListApprovals, GetRun, ListRunArtifacts |
DecideApproval |
reviewer is the maintainer: not eligible |
| 5 | release-detail — Asset release |
— | GetRelease, ListReleaseEvaluations |
ValidateRelease, SubmitRelease, PublishRelease, DeprecateRelease, MoveAlias |
alias move refused while the previous release has pinned runs: shown, not blocked |
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.