Skip to content

[Fix] Environment boot failures show no useful error feedback#539

Draft
roomote-roomote[bot] wants to merge 1 commit into
developfrom
fix/boot-environment-error-feedback-0vimbcnkqeuew
Draft

[Fix] Environment boot failures show no useful error feedback#539
roomote-roomote[bot] wants to merge 1 commit into
developfrom
fix/boot-environment-error-feedback-0vimbcnkqeuew

Conversation

@roomote-roomote

Copy link
Copy Markdown
Contributor

Opened on behalf of Matt Rubens. Follow up by mentioning @roomote-roomote, in the web UI, or in Discord.

Related issue

Fixes #538

Why this PR exists

  • A maintainer explicitly invited this PR in the linked issue or discussion
  • I am a maintainer / this is internal Roomote work

What changed

When an environment fails while booting, the startup UI used to leave people on Booting environment with little context, then fail with a raw docker run … command dump instead of the actual cause.

This PR:

  • Prefer Docker daemon stderr when spawn fails so causes like missing images / pull denied reach the run error field
  • Rewrite common worker-boot failures into actionable UI copy (missing worker image, container exited early, fetch failed, generic Docker command dumps)
  • Show Still booting… (elapsed: …) after 15s on the active startup step so long boots are visibly alive

How it was tested

  • Vitest: controller (BaseController, docker-sandbox-security) and web (task-run-errors, StartupMessage.client)
  • Typecheck: @roomote/controller and @roomote/web
  • Storybook screenshots of the failed missing-image and still-booting states

Checklist

  • The PR title follows the repo convention: [Fix], [Feat], [Improve], [Refactor], [Docs], or [Chore] followed by a user-facing description
  • This PR is small and scoped to one change
  • pnpm lint and pnpm check-types pass locally
  • I added tests or included a clear manual validation note above
  • I removed secrets, tokens, private keys, and customer data from code, logs, and screenshots
  • If this change should appear in the changelog, I ran pnpm changeset

Screenshots

Failed start shows actionable missing worker image guidance instead of the raw docker command

Active booting step shows Still booting elapsed time after waiting

Preserve Docker stderr when spawn fails, rewrite common boot failures into
clear user-facing messages, and show still-booting elapsed time while waiting.
@roomote-roomote

roomote-roomote Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor Author

No code issues found. See task

Reviewed af513ac

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Workspace stuck in 'Booting environment' with no error feedback

1 participant