Skip to content

doctor: show Core's own reason when it's in the failed-startup state #3

Description

@wizzomafizzo

When Zaparoo Core fails to start, it now stays up in a failed state and explains itself: /health and / carry the reason (ZaparooProject/zaparoo-core#1526, ZaparooProject/zaparoo-core#1527). zaparoo-cli doctor never asks for it.

Seen on Windows with Core in that failed state, zaparoo-cli --device … doctor reports only:

"websocket-version", ok:false, "WebSocket upgrade rejected with HTTP 503"
remediation: ["Check host, port, Core service state, firewall, and SSH artifact fallback."]

The explanation is sitting one request away, and the generic advice points at the network when the network is fine.

Ask: when the WebSocket upgrade is refused with 503, fetch /health and show Core's own failure reason in place of the generic remediation. Keep the current advice for any other failure.

The point of Core's failed-startup state is that a stuck install can say what's wrong, and doctor is the first tool anyone reaches for.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions