DocslothReleases
checking session

Releases

Releases displays real server state with a next action, not placeholder statistics.

Releases

Read from the connected engine through the control plane.

Loading…

Rows come from the connected engine through the control-plane proxy; this page never renders placeholder records.

Served by the core studio

Software records (sources, programs, runs, releases, components, environments, media, verification and exports) live in the core engine and are edited in its studio. When a connected engine answers through this workspace, the panels above render its own records as returned; without a connection the shell states that and shows nothing rather than an invented row. The surface contract below names each action and the setup it needs.

Surface contract

Primary object: releases: the multi-repository version vector for each revision, its manifest, and the deployments it maps to.

Actions

  • CompareCore studioComparison is computed by the engine from two release manifests and their source revisions; this build holds no manifests and shows no diff.
  • Create manifestCore studioA manifest records the exact source revisions and digests the engine verified; the hosted shell cannot sign or invent one.
  • Select channelCore studioChannel selection (stable/candidate) changes what the engine deploys; the change is recorded with the actor and never applied by the browser.
Required states and how this surface reaches them
loading
the session probe and each list show Loading… until the control plane answers.
ready
the server’s own records render as returned; the primary object is named before its details.
empty
no release exists until the engine has built and published a candidate; the direct action is the guided setup.
error
the control plane’s status and detail are shown; no placeholder row replaces them.
offline
no control plane is reachable; nothing is rendered rather than invented.
permission_denied
a 401 returns to sign-in with this path; a 403 states that the role cannot read this surface.
not_configured
a 503 names the missing provider or secret; setup is shown, never fake results.
budget_paused
a 402 (quota_exceeded / upgrade_required) pauses spending; the budget row shows the cap and consumption that caused it.
requires_approval
mutations the server reserves for an explicit human owner/admin are refused with its own detail and never auto-approved here.

Scope: workspace membership. Engine records are read and written through the core engine’s own routes (proxied by the control plane); the hosted shell binds only to named contracts, shows a record only when the server returned it, and never calculates permissions in the browser.