Runbook: Transition Testing

Status: living

Use this after the machine can boot the flake-managed desktop baseline.

Preflight

mode status
mode current
mode desired
systemctl status desktop.target
systemctl status compute.target
systemctl status vllm.service

The expected baseline is:

• observed state is desktop
• vLLM is inactive
• no transition lock is held
• latest transition is not failed

Test Studio Overlay

sudo mode request studio-local
mode status
systemctl status studio-local-policy.service
systemctl status audio-priority.service
sudo mode request desktop
mode status

Expected result:

• studio-local is observed only while both overlay services are active
• returning to desktop stops both overlay services
• vLLM remains inactive

Test Compute Promotion

Before testing:

• close REAPER and active low-latency audio work
• avoid foreground long-running user jobs
• expect the graphical session to terminate

sudo mode request compute
mode status
systemctl status compute.target
systemctl status vllm.service

Expected result:

• observer reports compute or an explicit degraded/failed state
• graphical session is absent or non-authoritative
• vLLM is active if enabled
• guard and transition records explain any block or failure

Test Desktop Return

sudo mode request desktop
mode status
systemctl status vllm.service

Expected result:

• observer reports desktop
• vLLM is inactive
• graphical/session path is usable

If rollback only partially restores desktop, classify it as degraded rather than successful.