Skip to content

States catalog

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.

Family Owner Values Colour family Screens
Asset readiness (asset-readiness) BC-04 Asset Publication Draft → InReview → Published → Deprecated → Revoked review 21
Deployment availability (deployment-availability) BC-07 Model Access / BC-17 Connectors Registered → Evaluating → Approved → Active → Degraded → Retired live 4
Run (run) BC-03 Run Control (ADR-0014) Accepted → Resolving → Running → WaitingApproval → Paused → Completed → Failed → Cancelled running 6
Approval (approval) BC-03 / BC-20 Pending → Approved → Rejected → Expired → Superseded review 17
Usage (usage) BC-05 Usage Accounting Estimated → Reserved → Observed → Reconciled → Uncertain blocked 8
Freshness (freshness) BC-21 Operations Fresh → Stale → Degraded → Unknown idle 33
Delivery (delivery) BC-23 / BC-24 Proposed → PullRequestOpen → Merged → Candidate → Released → Promoting → Verified → RolledBack passed 8
Fleet (fleet) BC-35..37 Provisioning → Running → Degraded → Upgrading → Suspended → Offboarding live 7
## Asset readiness

Lifecycle of an agent, skill, workflow, tool, model profile, template or blueprint release; Published is the only runnable state.

stateDiagram-v2
    Draft --> InReview
    InReview --> Published
    Published --> Deprecated
    Deprecated --> Revoked
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: run-submit · asset-catalog · release-detail · agent-card · tool-descriptor · mcp-servers · model-profiles · workflow-definitions · template-catalog · marketplace-browse · marketplace-installations · publisher-console · memory · release-evidence · datasets · learning-proposals · policies · approval-policy · blueprints · dsl-studio · recipes · ## Deployment availability

Whether a model deployment or connector can be routed to now; distinct from asset readiness.

stateDiagram-v2
    Registered --> Evaluating
    Evaluating --> Approved
    Approved --> Active
    Active --> Degraded
    Degraded --> Retired
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: mcp-servers · model-profiles · connections · connectors · ## Run

The run vocabulary of ADR-0014; steps and attempts carry their own sub-states; every transition is journaled.

stateDiagram-v2
    Accepted --> Resolving
    Resolving --> Running
    Running --> WaitingApproval
    WaitingApproval --> Paused
    Paused --> Completed
    Completed --> Failed
    Failed --> Cancelled
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: my-work · run-detail · approval-card · run-list · run-timeline · workflow-run-graph · ## Approval

A decision bound to the exact proposal version; Pending shows expiry; Superseded means the proposal changed.

stateDiagram-v2
    Pending --> Approved
    Approved --> Rejected
    Rejected --> Expired
    Expired --> Superseded
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: my-work · approvals-list · approval-card · release-detail · marketplace-browse · publisher-console · memory · evaluation-runs · learning-proposals · rollouts · offboardings · governance-orders · editions-billing · recipes · promotions · provisioning · inventory · ## Usage

Money and tokens by status; uncertain amounts are never folded into totals (FUX-08).

stateDiagram-v2
    Estimated --> Reserved
    Reserved --> Observed
    Observed --> Reconciled
    Reconciled --> Uncertain
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: run-submit · run-detail · project-overview · marketplace-installations · run-list · overview · usage-cost · editions-billing · ## Freshness

Projection lag and last observation per source; a degraded source is shown, never hidden (FUX-04, FUX-07).

stateDiagram-v2
    Fresh --> Stale
    Stale --> Degraded
    Degraded --> Unknown
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: my-work · run-detail · project-overview · project-settings · environment-board · knowledge-sources · knowledge-search · repository-intelligence · context-snapshot · artifacts · evaluation-runs · feedback · run-list · run-timeline · overview · status-objectives · alerts · capacity · fleet-board · product · audit · findings · secrets-references · connectors · topic-registry · stores · retention-residency · governance-orders · users-roles · notification-preferences · pipeline-runs · inventory · workflow-run-graph · ## Delivery

Change proposals, releases and promotions of generated products.

stateDiagram-v2
    Proposed --> PullRequestOpen
    PullRequestOpen --> Merged
    Merged --> Candidate
    Candidate --> Released
    Released --> Promoting
    Promoting --> Verified
    Verified --> RolledBack
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: environment-board · product-releases · generated-outputs · proposals · pipeline-runs · promotions · provisioning · generated-products · ## Fleet

Operated product instances, rollouts and off-boarding.

stateDiagram-v2
    Provisioning --> Running
    Running --> Degraded
    Degraded --> Upgrading
    Upgrading --> Suspended
    Suspended --> Offboarding
Hold "Alt" / "Option" to enable pan & zoom

Rendered on: fleet-board · product · rollouts · incidents · on-call · offboardings · generated-products ·