Sandbox Lifecycle Debug

Use this skill when the sandbox state machine is the primary suspect.

For Sandbox v2 truth-model work, also load sandbox-v2-lifecycle. Official Vercel Sandbox v2 docs override older repo guidance that treats manual snapshots as the normal restore source.

Start Here

Read lat.md/sandbox-lifecycle.md sections Status State Machine, Triggers -- What Causes State Transitions, and the specific trigger involved. Run lat locate "Sandbox Lifecycle" or lat search "sandbox lifecycle <symptom>" when unsure.

Collect before edits:

• GET /api/status and any UI state that triggered the action.
• GET /api/admin/sandbox-diag.
• GET /api/admin/logs filtered for sandbox., gateway., watchdog., proxy..
• Local git rev-parse HEAD, remote git ls-remote origin main, and live deployment proof.

Split The State