# Status

**Spinbox is experimental: APIs change and data may be lost.** What is built and what proves it is on [Status](https://docs.spinbox.dev/reference/status.md); what Spinbox does not do is on [Limitations](https://docs.spinbox.dev/overview/limitations.md).

> What Spinbox does today with what proves each, what is partly there, what is not built, and its limits.

<!-- Generated by tools/refgen from spin:internal/features/features.go. Edit the source, not this file. -->

Every row of this page is a line of `internal/features` in spin, and a test there resolves it against the tree. A row that says **built** names what shows the feature exists - a procedure the control plane serves, a command the CLI has, or a test - and, under **End to end**, the tests that drive a real runner and its guest and check what the feature did, or what no test checks yet. spin's build checks that each of those tests is there and not quarantined; whether it checks the whole feature is its review's. A row that says **not built** is an item of [`docs/ROADMAP.md`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/docs/ROADMAP.md). The page is written by `task reference` from `spin features` at spin `51f7e0dea`, and cannot say a feature the binary does not. spin is a private repository: a link to its code opens only for someone with access to it.

## Built

### Workspaces

| Feature | Exists | End to end |
|---|---|---|
| A machine per workspace: KVM, its own kernel, root, a persistent disk, SSH | [`TestAWorkspaceBootsARealGuest`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vm_test.go#L190), a test of `internal/e2e` | [`TestAWorkspaceBootsARealGuest`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vm_test.go#L190) |
| Create, start, stop and delete | [`WorkspaceService/CreateWorkspace`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | [`TestE2E_WorkspaceCRUD`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L390) |
| A trash: a deleted workspace stays whole, for its owner to undelete, until its days are up | [`TestAWorkspaceWhoseDaysInTheTrashAreUpIsErasedFromItsHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L507), a test of `internal/e2e` | [`TestATrashedWorkspaceIsWholeWhenItsOwnerUndeletesIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L539)<br/>[`TestAWorkspaceWhoseDaysInTheTrashAreUpIsErasedFromItsHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L507) |
| Idle suspend, with a question before it that a keep answers | [`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36), a test of `internal/e2e` | [`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36) |
| A workspace that ran as long as the installation allows is suspended | [`TestAWorkspaceThatRanForAsLongAsAllowedIsSuspended`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L172), a test of `internal/e2e` | [`TestAWorkspaceThatRanForAsLongAsAllowedIsSuspended`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L172) |
| A process inside holds its workspace awake while it lives | [`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36), a test of `internal/e2e` | [`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36) |
| Suspend with the processes where they are; a start resumes them | [`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36), a test of `internal/e2e` | [`TestE2E_ASuspendedWorkspaceResumesWhereItWas`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L247)<br/>[`TestAWorkspaceNobodyUsesIsSuspendedUnlessKeptOrHeld`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L36) |
| Cores and memory lent while the host has them, and taken back<br/>*A loan refused while the host is full has no test against the stack: the budget is the host's own cores and half its memory, which no lane's workspaces fill.* | [`TestABusyWorkspaceIsLentCoresAndGivesThemBack`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L470), a test of `internal/e2e` | [`TestABusyWorkspaceIsLentCoresAndGivesThemBack`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L470)<br/>[`TestABusyWorkspaceIsLentMemoryAndGivesItBack`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/memory_test.go#L110)<br/>[`TestAnEditorAtTheFloorIsNotKilledForMemory`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/memory_test.go#L162) |
| A grant of cores and memory of its own, for a while | [`TestAGrantWhoseTimeIsUpIsGivenBackToTheMachine`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L416), a test of `internal/e2e` | [`TestAGrantWhoseTimeIsUpIsGivenBackToTheMachine`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/background_test.go#L416)<br/>[`TestAResumedWorkspaceIsGivenWhatItIsGrantedWhileItRuns`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/resume_grant_test.go#L20) |
| An administrator changes a running workspace's bandwidth, its connections open | [`TestAnAdministratorChangesARunningWorkspacesBandwidth`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/bandwidth_test.go#L118), a test of `internal/e2e` | [`TestAnAdministratorChangesARunningWorkspacesBandwidth`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/bandwidth_test.go#L118)<br/>[`TestAWorkspacesBandwidthHoldsAcrossItsRunsAndItsRunner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/bandwidth_test.go#L172) |
| Move a running workspace to another host, its processes as they are | [`TestHostsAMoveTakesARunningWorkspaceToAnotherHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/hosts_flows_test.go#L65), a test of `internal/e2e` | [`TestHostsAMoveTakesARunningWorkspaceToAnotherHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/hosts_flows_test.go#L65) |
| Clone a workspace: its disk, team, project, size, policies and environment, in one | [`TestACloneHoldsWhatItsSourceWroteAndItsShape`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/clone_test.go#L64), a test of `internal/e2e` | [`TestACloneHoldsWhatItsSourceWroteAndItsShape`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/clone_test.go#L64) |
| Recover a workspace whose host is gone, at a cost its owner accepts | [`TestHostsAWorkspaceWhoseHostIsGoneIsRecoveredOnAnother`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/hosts_flows_test.go#L100), a test of `internal/e2e` | [`TestHostsAWorkspaceWhoseHostIsGoneIsRecoveredOnAnother`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/hosts_flows_test.go#L100) |
| A workspace outlives its runner | [`TestAWorkspaceOutlivesItsRunner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vm_test.go#L343), a test of `internal/e2e` | [`TestAWorkspaceOutlivesItsRunner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vm_test.go#L343) |
| Quarantine, by an administrator | [`WorkspaceService/QuarantineWorkspace`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | [`TestE2E_AQuarantinedWorkspaceIsHeldUntilReleased`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L291) |
| Why a workspace is not behaving: status, console, history | [`spin workspace status`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestE2E_AQuarantinedWorkspaceIsHeldUntilReleased`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L291)<br/>[`TestE2E_AWorkspacesConsoleIsWhatItsMachinePrinted`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L323) |
| The owner's shell, environment, editor settings, Taskfile and dotfiles reach the guest as they save them | [`TestAWorkspacesOwnEnvironmentIsInItsOwnersLoginShell`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/env_test.go#L22), a test of `internal/e2e` | [`TestTheOwnersSettingsArriveInTheGuest`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/env_test.go#L74)<br/>[`TestAWorkspacesOwnEnvironmentIsInItsOwnersLoginShell`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/env_test.go#L22) |
| Reset a disk to what it was created from | [`spin workspace reset`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestE2E_ResetPutsAWorkspaceBackToWhatItWasCreatedFrom`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1211) |
| Claude Code, Codex and T3 Code on every workspace's PATH, at the versions the release pins, with their own defaults<br/>*Where an administrator accepted their terms (Admin → Extensions) or an operator publishes them: no image carries Claude Code, which only Anthropic may distribute.* | [`TestTheAgentCLIsAreOnPathWithThePinnedVersions`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/agentclis_test.go#L24), a test of `internal/e2e` | [`TestTheAgentCLIsAreOnPathWithThePinnedVersions`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/agentclis_test.go#L24) |
| An agent UI: T3 Code in a workspace as its agent user, over the owner's SSH session - from `spin agent` on the person's computer, or in the workspace's Agent tab in the dashboard, which frames the client and carries it over a passkey's session<br/>*The lane has no provider credential, so no test has a model answer through the brokered egress: the server is reached, as the agent's user, and nothing is asked of it. The browser's test drives the page with a virtual authenticator, which no real passkey's maker vouches for.* | [`spin agent --port`](https://docs.spinbox.dev/reference/cli/agent.md) | [`TestTheSupervisorRunsTheAgentForItsOwner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/t3_test.go#L79)<br/>[`TestE2E_TheAgentIsServedOnThisComputerWhileTheSessionIsOpen`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L81)<br/>[`agent.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/agent.spec.ts#L62): a passkey signs the person in, and the agent runs in their workspace from the dashboard |
| Claude Code and Codex signed in from the agent's page: each CLI's own login, run by the supervisor as the agent's user, its credentials kept in the agent's home and never passing through the page<br/>*The lane has no provider account: it begins a login and sees the provider's page, and finishing one is the unit tests' on each CLI's own output.* | `AgentService/BeginLogin` | [`TestTheSupervisorRunsTheAgentForItsOwner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/t3_test.go#L79) |
| A person signs Claude Code and Codex in once: every workspace of theirs, plain or a project's, is handed the same credentials and hands back each refresh and logout, and a workspace that names a guest holds none<br/>*The lane has no provider account: its login is the file the CLI writes, written as the agent's user. Only a workspace its owner's alone through all it came from holds them: a project opened from its prebuild does, but not a prebuild's build, a copy of another person's snapshot, or one made before the release that keeps the mark.* | [`TestAPersonSignsInToTheAgentOnceForEveryWorkspaceOfTheirs`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/agentcredentials_test.go#L29), a test of `internal/e2e` | [`TestAPersonSignsInToTheAgentOnceForEveryWorkspaceOfTheirs`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/agentcredentials_test.go#L29) |
| The supervisor runs the agent for its owner while it is used: started, paired and listed over the owner's own session on a socket only root opens, and stopped once nobody has used it for half an hour and no chat is at work<br/>*That it stops once idle is the sweep's unit test on a clock the test moves: no lane waits half an hour.* | `AgentService/Start` | [`TestTheSupervisorRunsTheAgentForItsOwner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/t3_test.go#L79) |
| The agent's chats listed on the workspace - titles, paths and times, never a message - reported by its supervisor | [`WorkspaceService/ListAgentThreads`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | [`TestTheAgentsThreadsAreListed`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/t3_test.go#L134) |
| Chat mode: the dashboard flips to the person's own chats across their workspaces, grouped by project, with the agent full height and a new chat that makes its workspace | [`WorkspaceService/ListOwnAgentThreads`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | not yet: The RPC is held to the caller's own chats by its unit test, the mode by the dashboard's; no lane opens chat mode in a browser against an agent that has reported. |
| The agent's home is a volume of its own: the chats and sessions outlive the workspace, kept in the installation's store as every disk is, and a new workspace mounts them at its creation<br/>*Sealed with the workspace's checkpoints, claimed with the launch beside the disk, and moved with the workspace.* | [`spin workspace create --agent-home`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestAnAgentsHomeOutlivesItsWorkspace`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/agenthome_test.go#L78) |

### Teams and projects

| Feature | Exists | End to end |
|---|---|---|
| Open a repository, branch, commit or pull request from its URL, in the dashboard (/launch) and from the terminal<br/>*From the terminal; the dashboard's /launch page makes the same create and has no test of its own against the stack.* | [`spin open --no-connect`](https://docs.spinbox.dev/reference/cli/open.md) | [`TestE2E_AURLOpensTheWorkspaceItNames`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L190) |
| A workspace opened at a commit or a pull request, checked out as pr-&lt;n> | [`TestAProjectsWorkspaceOpensAtTheCommitItWasAskedFor`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/project_test.go#L156), a test of `internal/e2e` | [`TestAProjectsWorkspaceOpensAtTheCommitItWasAskedFor`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/project_test.go#L156)<br/>[`TestE2E_AURLOpensTheWorkspaceItNames`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L190) |
| Teams, with owner, admin and member | [`spin team member role`](https://docs.spinbox.dev/reference/cli/team.md) | [`TestE2E_ATeamRoleIsWhatItsHolderMayDo`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L457) |
| A team's own identity providers | [`TeamService/CreateIdentityProvider`](https://docs.spinbox.dev/reference/api/teamservice.md) | [`TestE2E_ATeamsIdentityProviderIsItsAdminsAndSignsNobodyIn`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L485) |
| Your GitHub account, connected once: private repositories cloned and pushed with nothing on the disk | [`ForgeService/CompleteConnect`](https://docs.spinbox.dev/reference/api/forgeservice.md) | not yet: consent takes a person on GitHub's page, and revoking a grant would end the one authorization a lane could live on: checked by hand once per release |
| Your GitHub account connected from the CLI, with a code entered on GitHub's page | [`spin git connect`](https://docs.spinbox.dev/reference/cli/git.md) | not yet: the code is entered by a person on GitHub's page: checked by hand once per release |
| A repository picked from the ones your account reaches | [`spin git repos`](https://docs.spinbox.dev/reference/cli/git.md) | not yet: a real GitHub account the lane can search with |
| A team's own network policies, where the installation allows them | [`spin team policy set`](https://docs.spinbox.dev/reference/cli/team.md) | [`TestATeamsOwnPolicyIsWhatItsWorkspacesReach`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/team_policy_test.go#L24) |
| Projects of the installation: a repository and the shape of the workspace that opens it, shared with everyone or some | [`TestAProjectsWorkspaceHasItsRepositoryCheckedOutAtTheRef`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/project_test.go#L27), a test of `internal/e2e` | [`TestAProjectsWorkspaceHasItsRepositoryCheckedOutAtTheRef`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/project_test.go#L27) |
| Prebuilds of a project's refs, as the floor of the workspaces that open them | [`TestAProjectOpensAsItsPrebuildMadeIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/prebuild_test.go#L24), a test of `internal/e2e` | [`TestAProjectOpensAsItsPrebuildMadeIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/prebuild_test.go#L24) |
| A team's workspaces run on the installation's hosts | [`TestATeamsWorkspaceRunsOnTheInstallationsHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/team_test.go#L20), a test of `internal/e2e` | [`TestATeamsWorkspaceRunsOnTheInstallationsHost`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/team_test.go#L20) |

### Snapshots

| Feature | Exists | End to end |
|---|---|---|
| Snapshots of a running workspace's disk | [`WorkspaceService/CreateSnapshot`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | [`TestACloneHoldsWhatItsSourceWroteAndItsShape`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/clone_test.go#L64)<br/>[`TestADiskSnapshottedPastTheThresholdIsCompactedWhileItRuns`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/compaction_test.go#L19) |
| Snapshots with memory, resumed with their processes | [`TestARunningWorkspaceResumesFromASnapshotsMemory`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restore_test.go#L175), a test of `internal/e2e` | [`TestARunningWorkspaceResumesFromASnapshotsMemory`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restore_test.go#L175) |
| Restore a workspace to a snapshot | [`TestARestoredWorkspaceBootsOnTheSnapshotItWasRestoredTo`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restore_test.go#L29), a test of `internal/e2e` | [`TestARestoredWorkspaceBootsOnTheSnapshotItWasRestoredTo`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restore_test.go#L29)<br/>[`TestE2E_TheQuickstartsDiffIsWhatTheSiteShows`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/site_e2e_test.go#L16) |
| A diff of the files that changed between two snapshots | [`TestADiffOfTwoSnapshotsIsWhatChangedBetweenThem`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/diff_test.go#L28), a test of `internal/e2e` | [`TestADiffOfTwoSnapshotsNamesWhatWasAddedChangedAndRemoved`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/diff_test.go#L95)<br/>[`TestE2E_TheQuickstartsDiffIsWhatTheSiteShows`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/site_e2e_test.go#L16) |
| Share a snapshot with a person or make it public, and create a workspace from it | [`TestACloneOfASnapshotRegistersAsItself`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/clone_test.go#L23), a test of `internal/e2e` | [`TestASharedSnapshotIsCreatedFromByThePersonItIsSharedWith`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/share_test.go#L21) |
| What looks like a credential is found before a share, and the share refused unless acknowledged | [`ShareService/ShareSnapshot`](https://docs.spinbox.dev/reference/api/shareservice.md) | [`TestE2E_ASharedSnapshotIsScannedForCredentials`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L147) |
| A long chain is compacted while the workspace runs | [`TestADiskSnapshottedPastTheThresholdIsCompactedWhileItRuns`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/compaction_test.go#L19), a test of `internal/e2e` | [`TestADiskSnapshottedPastTheThresholdIsCompactedWhileItRuns`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/compaction_test.go#L19) |

### Network

| Feature | Exists | End to end |
|---|---|---|
| Egress is closed by default; policies, by tag, name what a workspace may reach | [`TestAnOwnerMayOnlyChooseAPolicyTheInstallationDeclares`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L163), a test of `internal/e2e` | [`TestAWorkspaceNamedNoPolicyReachesNothing`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L71)<br/>[`TestChangingAWorkspacesPoliciesReachesTheHostThatRunsIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L24) |
| A workspace's DNS goes upstream only for what its policy names, so a policy that closes egress closes the tunnel through names | [`TestAWorkspaceAsksItsResolverOnlyWhatItsPolicyNames`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/resolver_test.go#L76), a test of `internal/e2e` | [`TestAWorkspaceAsksItsResolverOnlyWhatItsPolicyNames`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/resolver_test.go#L76) |
| A policy changed reaches the host that runs the workspace | [`TestChangingAWorkspacesPoliciesReachesTheHostThatRunsIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L24), a test of `internal/e2e` | [`TestAnEditedPolicyChangesWhatARunningGuestReaches`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L100)<br/>[`TestChangingAWorkspacesPoliciesReachesTheHostThatRunsIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/retag_test.go#L24) |
| Brokered names: the host's proxy stands in and adds what the workspace never holds - a team secret, a forge token, its identity, a cloud role<br/>*The team secret's value is read at the origin; the forge token, identity and cloud role injections have no test against the stack.* | [`spin team secret set`](https://docs.spinbox.dev/reference/cli/team.md) | [`TestAPersonsRuleAndAnAgentsOnOneNameEachArriveWithTheirOwnInjection`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L99) |
| What a workspace reached, what it looked up and what it was refused | [`spin workspace egress`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestE2E_EgressIsAnsweredByTheHostTheWorkspaceRunsOn`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L881) |
| Each request to a brokered name as the proxy read it, served or refused and why; and whether each injection's secret is the team's to give | [`TestABrokeredRequestIsSeenAsTheProxyReadIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L27), a test of `internal/e2e` | [`TestABrokeredRequestIsSeenAsTheProxyReadIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L27) |
| The egress proxy is a process of its own, holding no key of the host's, started again by the runner when it ends | [`TestTheEgressProxyIsAProcessOfItsOwnThatTheRunnerStartsAgain`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/egress_process_test.go#L21), a test of `internal/e2e` | [`TestTheEgressProxyIsAProcessOfItsOwnThatTheRunnerStartsAgain`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/egress_process_test.go#L21) |
| A brokered rule names whose it is, the agent's or the person's: one policy says what each may reach and with what | [`TestABrokeredNameForTheAgentIsTheAgentsAlone`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L71), a test of `internal/e2e` | [`TestAPersonsRuleAndAnAgentsOnOneNameEachArriveWithTheirOwnInjection`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L99)<br/>[`TestABrokeredNameForTheAgentIsTheAgentsAlone`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L71) |
| A WebSocket to a brokered name: its handshake under the rule's headers and scope, then bytes each way<br/>*The rule's header on the handshake is not read at the origin: the lane's WebSocket echo answers frames, not headers.* | [`TestAWebSocketToABrokeredNameIsCarriedAfterItsHandshake`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L167), a test of `internal/e2e` | [`TestAWebSocketToABrokeredNameCarriesTheGuestsBytesAndRefusesAPathOutOfScope`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L195)<br/>[`TestAWebSocketToABrokeredNameIsCarriedAfterItsHandshake`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L167) |
| HTTP/2 to a brokered name, the proxy's ALPN the real host's: a rule's headers set stream by stream, gRPC's trailers both ways<br/>*gRPC's trailers are egressproxy's h2 test against an origin of its own; the lane has no gRPC origin to reach.* | [`TestHTTP2ToABrokeredNameIsTheRealHosts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L230), a test of `internal/e2e` | [`TestHTTP2ToABrokeredNameIsTheRealHosts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L230)<br/>[`TestEachStreamOfAnHTTP2ConnectionToABrokeredNameCarriesTheRulesHeader`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L250) |
| Watch where a workspace connects, into its logs | [`spin workspace watch`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestE2E_AWatchedWorkspacesConnectionsAreInItsLogs`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L336) |
| An agent the supervisor starts is marked, and reaches only brokered names | [`TestARealWorkspaceMarksTheAgentItsSupervisorStarts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/seal_test.go#L21), a test of `internal/e2e` | [`TestAnAgentReachesOnlyBrokeredNames`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/brokered_test.go#L137)<br/>[`TestARealWorkspaceMarksTheAgentItsSupervisorStarts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/seal_test.go#L21) |
| Published ports at https://{port}-{workspace}.{domain}: private, whitelisted or public | [`spin port expose`](https://docs.spinbox.dev/reference/cli/port.md) | [`TestAPublicPortIsReachedWithNoSessionAtAll`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/proxy/lane_test.go#L132)<br/>[`workspace-sign-in.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/workspace-sign-in.spec.ts#L31): a visitor signed in to the dashboard reaches their private port |

### Access

| Feature | Exists | End to end |
|---|---|---|
| Sign in with GitHub or an OIDC provider | [`AuthService/StartLogin`](https://docs.spinbox.dev/reference/api/authservice.md) | not yet: a GitHub provider: the sign-in through it and the verified email it gives |
| Device login for a terminal | [`AuthService/StartDeviceLogin`](https://docs.spinbox.dev/reference/api/authservice.md) | [`TestE2E_Logout`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1202)<br/>[`auth.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/auth.spec.ts#L18): the CLI's device page stands alone and keeps its code through a sign-in |
| API keys for scripts and agents | [`spin api-key create`](https://docs.spinbox.dev/reference/cli/api-key.md) | [`TestE2E_APIKeyCRUD`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1158) |
| SSH keys, and plain ssh to spin.&lt;workspace> | [`spin ssh-config`](https://docs.spinbox.dev/reference/cli/ssh-config.md) | [`TestE2E_SSHConfigCarriesSSHToAWorkspace`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L655) |
| A key logs in only once its person adds it with a passkey: their own for good, a browser's for twelve hours | [`PasskeyService/BeginPasskeyCeremony`](https://docs.spinbox.dev/reference/api/passkeyservice.md) | [`TestOnlyTheOwnerAndTheirGuestsLogInToAWorkspace`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/login_test.go#L175) |
| Guests of a workspace, let in by its owner with a passkey | [`spin workspace guests`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestOnlyTheOwnerAndTheirGuestsLogInToAWorkspace`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/login_test.go#L175) |
| A workspace's identity, signed by its host, for the audiences its installation allows | [`TestAWorkspacesIdentityIsTheHostsSignatureOfItsSet`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/identity_test.go#L58), a test of `internal/e2e` | [`TestAWorkspacesIdentityIsTheHostsSignatureOfItsSet`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/identity_test.go#L58) |
| VS Code over SSH, with the server the installation publishes and nothing downloaded<br/>*The server is Microsoft's, for Remote-SSH; spin code also opens an editor with Open Remote - SSH, which downloads its own. spin code itself is run by its unit tests only: it opens a desktop editor, which no lane has.* | [`TestAVSCodeServerOfAnotherCommitIsHandedToTheRunningMachine`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vscodehotplug_test.go#L23), a test of `internal/e2e` | [`TestTheCarriedVSCodeServerRunsOfflineAndAnswersOverTheSSHTunnel`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vscodeserver_test.go#L86)<br/>[`TestAVSCodeServerOfAnotherCommitIsHandedToTheRunningMachine`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vscodehotplug_test.go#L23) |
| Run a command in a workspace, copy files to and from it | [`spin exec`](https://docs.spinbox.dev/reference/cli/exec.md) | [`TestE2E_ADetachedRunIsFollowedToItsEndAndFilesGoBothWays`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L263) |
| A program runs a command and reads and writes files in a workspace through the API, with a key that holds workspace:exec, every call recorded with the key it came on | [`ExecService/Exec`](https://docs.spinbox.dev/reference/api/execservice.md) | [`TestAKeyWithExecRunsACommandInAWorkspaceAndOneWithoutIsRefused`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/exec_test.go#L36) |
| An agent works in workspaces through `spin mcp` on a key delegated to it: never more than the key it came from - scopes, team, projects, end, how many workspaces and cores its tree holds - and revoked with it | [`spin mcp`](https://docs.spinbox.dev/reference/cli/mcp.md) | [`TestE2E_AnAgentDrivesAWorkspaceThroughMCPOnADelegatedKey`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/mcp_e2e_test.go#L55) |
| An agent in a workspace drives others with spin, on a key it gets for the workspace's own SPIFFE identity - a child of the key that made the workspace, through its host, whatever the workspace's network<br/>*No forge in the lane: a workspace reaches no private or host address, and no test repository has a credential in CI yet, so an agent opening a pull request is not run.* | [`AuthService/ExchangeWorkloadToken`](https://docs.spinbox.dev/reference/api/authservice.md) | [`TestAnAgentInAWorkspaceDrivesAnotherOnTheIdentityOfItsWorkspace`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/inception_test.go#L97) |

### Administration

| Feature | Exists | End to end |
|---|---|---|
| Installation settings seeded from a file; a change in the file is a proposal to apply or dismiss | [`AdminService/DecideConfigChange`](https://docs.spinbox.dev/reference/api/adminservice.md) | [`TestTheInstallationFileSeedsAndItsChangesAreAnAdministratorsToDecide`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/config_file_test.go#L92) |
| Every installation setting read and changed from the terminal, by the definitions the dashboard and the file use | [`spin admin settings set`](https://docs.spinbox.dev/reference/cli/admin.md) | not yet: the RPC's round trip of every definition is tested against a real database; no lane runs the command against a stack yet |
| Resource presets | [`AdminService/CreateResourcePreset`](https://docs.spinbox.dev/reference/api/adminservice.md) | [`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L438): an admin's preset sizes a person's workspace, and is gone once deleted |
| Registration: open, by allowlist, or closed | [`AdminService/SetSettings`](https://docs.spinbox.dev/reference/api/adminservice.md) | [`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L244): closed, open and a domain on the allowlist decide who registers<br/>[`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L177): the allowlist lets in who it names, and nobody else |
| An audit log | [`AdminService/ListAuditLog`](https://docs.spinbox.dev/reference/api/adminservice.md) | [`TestE2E_AnAdministratorsActionIsAuditedWithItsActorAndTarget`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L555)<br/>[`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L959): admin reads the log and can narrow it to one kind of event |
| A timeline: what happened to a workspace, a runner, a team, a project or the installation, by whom, in one read | [`AdminService/ListTimeline`](https://docs.spinbox.dev/reference/api/adminservice.md) | not yet: no lane reads it yet: its reading is held against a real database by internal/controlplane/domain/timeline's tests, and a host's loss and return by hostserver's over a real stream |
| The control plane's jobs, and running one now | [`spin admin jobs`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestE2E_Admin`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1075)<br/>[`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L728): admin runs a job by hand and sees how it ended |
| The month's bill, its forecast, and what each workspace cost | [`spin admin costs`](https://docs.spinbox.dev/reference/cli/admin.md) | not yet: the cloud's real bill read: no lane has an AWS account, so the bill a test gives the reader stands in for it |
| The store: every volume, whose it is, and taking out what nothing needs | [`spin admin storage list`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestAVolumeNothingNeedsIsTakenOutOfTheStore`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/orphan_test.go#L26) |
| Re-key a workspace's disk | [`spin admin volume rekey`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestARekeyedDiskBootsWithWhatItHeldUnderANewKey`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/rekey_test.go#L24) |
| An administrator stops a workspace that is not theirs, moves it off a lost host with a reason its owner reads on its history, reads where it sends, and lists the disks hosts refuse: each audited | [`spin admin workspace recover`](https://docs.spinbox.dev/reference/cli/admin.md) | not yet: no lane asks these as an administrator of a real runner: each runs what its owner's stop, recover and egress run, which the lanes cover, and who may ask, the audit entry and what the owner's history says are tested at the RPC against the database (workspaceserver's adminacts tests) |
| Runners: registration tokens, drain, activate, revoke, and a policy per host | [`spin admin runner drain`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestARunnerRegisteredWithATokenTheAPIMadeIsRevokedByTheAdmin`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/runner_token_test.go#L99)<br/>[`TestARegistrationTokenExpiredOrRevokedRegistersNothing`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/runner_token_test.go#L148) |
| Runners start when a workspace waits for one and stop when nothing runs | [`HostService/GetFleet`](https://docs.spinbox.dev/reference/api/hostservice.md) | not yet: an autoscaling group to start and stop: the one group is AWS's, and no lane has an account |
| A root shell on a runner, for a while and with a reason: the runner emptied first, every session recorded under Object Lock, the runner retired after | [`spin admin shell open`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestHostsARootShellOnAHostIsRecordedAndItsHostRetired`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/hosts_test.go#L420) |
| A host that reboots brings its workspaces back | [`TestAHostRebootBringsItsWorkspacesBack`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restart_test.go#L38), a test of `internal/e2e` | [`TestAHostRebootBringsItsWorkspacesBack`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/restart_test.go#L38) |
| A cloud's reclaim warning empties the host before the machine goes | [`TestACloudsReclaimWarningEmptiesTheHostBeforeAnySignal`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/preemption_test.go#L26), a test of `internal/e2e` | [`TestACloudsReclaimWarningEmptiesTheHostBeforeAnySignal`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/preemption_test.go#L26) |
| A writeback bound per host, measured on that host before it is taken | [`TestCustomWritebackValuesAreMeasuredOnTheRunner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/writeback_test.go#L28), a test of `internal/e2e` | [`TestCustomWritebackValuesAreMeasuredOnTheRunner`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/writeback_test.go#L28) |
| What is running where: the control plane, each runner and its machine | [`spin admin versions`](https://docs.spinbox.dev/reference/cli/admin.md) | [`TestE2E_Admin`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1075) |
| A workspace whose host never comes back is moved when little would be lost, and its owner is told when it waits for them | [`WorkspaceService/RecoverWorkspace`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | not yet: the move without asking and the wait it records are tested against the database (workspaceserver's autorehome tests); the hosts lane recovers by hand, and no lane has an SMTP server to receive the owner's email |

### Observability

| Feature | Exists | End to end |
|---|---|---|
| A workspace's cost this month and its rate, as an estimate with its day, for its owner; a team's workspaces summed for its admins, and a project's with its prebuilds' storage for its admins<br/>*A share of days already billed, never of this hour; nothing is said where the cloud sends no bill.* | [`WorkspaceService/GetWorkspaceCost`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | not yet: the cloud's real bill read: no lane has an AWS account, so the bill a test gives the reader stands in for it |
| A workspace's owner is told by email when it waits for them or something happened to it, each event switchable<br/>*Held after its host was lost, a stop that could not be taken, stopped for not responding, moved off a lost host. A disk almost full is not an event yet.* | [`SettingsService/UpdateNotificationPreferences`](https://docs.spinbox.dev/reference/api/settingsservice.md) | not yet: no lane has an SMTP server: delivery is tested against a generated mail server, with every attempt and retry recorded (internal/controlplane/notify) |
| Platform logs, workspace logs and traces, searched in the product | [`LogService/SearchPlatformLogs`](https://docs.spinbox.dev/reference/api/logservice.md) | [`TestAWorkspacesLinesAndTracesAreFoundBySearchingForIt`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/observe_test.go#L190)<br/>[`TestE2E_TheInstallationsLogsAreSearchable`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1023) |
| Metrics, with Grafana on the control plane | [`AdminService/GetMonitoring`](https://docs.spinbox.dev/reference/api/adminservice.md) | [`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L1309): a series of the lane's host is in the metric store, read through Grafana<br/>[`admin.spec.ts`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/dashboard/e2e/admin.spec.ts#L1278): admin reads the installation's dashboards without leaving the page |
| A workspace's journal and console are collected as the installation's policy says | [`spin workspace logs`](https://docs.spinbox.dev/reference/cli/workspace.md) | [`TestE2E_AWorkspacesConsoleIsKeptAndSearchable`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/e2e_test.go#L1038) |
| A workspace's last hour of CPU, memory and network against what it holds, for its owner<br/>*Kept on the host, so it starts again with a restart of it or a move; the disk's use is not sampled.* | [`WorkspaceService/GetWorkspaceUsage`](https://docs.spinbox.dev/reference/api/workspaceservice.md) | [`TestAWorkspacesUsageIsWhatItsHostSampled`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/host_report_test.go#L99) |

### Platform

| Feature | Exists | End to end |
|---|---|---|
| A smoke test of what an installation's API promises, with a workspace of its own | [`spin smoke`](https://docs.spinbox.dev/reference/cli/smoke.md) | [`TestE2E_SmokePassesAndLeavesNothingBehind`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/cmd/cli/journeys_e2e_test.go#L380) |
| A host serves only the releases it carries<br/>*A resume whose recorded release was collected since has no test against the stack.* | [`TestAMachineAdoptedWithoutItsReleasesIsSuspendedWithItsDisk`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/suspend_test.go#L126), a test of `internal/e2e` | [`TestAMachineAdoptedWithoutItsReleasesIsSuspendedWithItsDisk`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/suspend_test.go#L126)<br/>[`TestAVSCodeServerOfAnotherCommitIsHandedToTheRunningMachine`](https://github.com/spin-stack/spin/blob/51f7e0dea53e6f85aa855753766b688634487168/internal/e2e/vscodehotplug_test.go#L23) |

## Partly there

Nothing today.

## Not built

Each is an item of `docs/ROADMAP.md`, with the command that checks it.

- **What a workspace grew to is asked for and never recorded** (Workspaces)
- **Placement cannot be told which kind of host a workspace belongs on** (Workspaces)

## Limits

Not planned: a limit of the platform or of where it runs today. [Limitations](https://docs.spinbox.dev/overview/limitations.md) says what each means.

- **AWS only** (Platform): The Terraform module is the one supported install; nothing else is packaged or tested.
- **x86-64 only** (Platform): Runners are x86-64 machines with nested virtualization.
- **The CLI runs on Linux and macOS** (Platform): x86-64 and Arm of each; there is no Windows build.
- **One region, one control plane** (Platform): A machine that fails is replaced in minutes, not seconds.
- **No GPUs** (Workspaces): A preset names the class of runner its workspaces run on, and no class hands a workspace a GPU.
- **Linux guests only** (Workspaces): Booted with the kernel spin provides.
- **No IPv6 inside a workspace** (Network)
- **TCP only for published ports** (Network)
- **A diff does not see everything** (Snapshots): A file is hashed only when its size, inode or times changed; extended attributes are not compared.
- **A memory snapshot resumes only on the same machine** (Snapshots): The same QEMU, guest kernel and guest init; a disk restore has no such limit.
- **Disk chains have a limit** (Snapshots): At the limit the top layer grows instead, so less of the recent work is in the bucket.
- **Work since the last upload can be lost** (Snapshots): A runner uploads writes in layers, on the RPO, on snapshot and on stop; what it had not uploaded goes with it.
- **No multi-factor authentication of Spinbox's own** (Access): Sign in through a provider that enforces it.
- **No team invitations** (Access): A person signs in once before they can be added to a team; a workspace's guests are invited by email.
- **Team roles are fixed** (Access): Owner, admin and member.
- **Nothing pages the operator** (Observability): Metrics, logs and traces stay inside the installation; alert rules fire in its Grafana and no contact point tells anyone. A workspace's owner is emailed when it waits for them.
- **An update is one way** (Administration): A release older than the one that last started the database refuses to start on it.
