Skip to content

sandy --doctor [--fix]: standalone preflight diagnostics #124

Description

@rappdw

Source: bulkhead's bulkhead doctor --fix — Aug-2026 landscape pass (research/sandbox-landscape-synthesis-2026-08.md §4).

What

A standalone sandy --doctor [--fix] fast-path (same family as --print-state/--gc) that runs the scattered preflight checks as one callable command, independent of a launch attempt: docker reachable, buildx health (incl. the known buildx-permission gotcha), image presence/staleness, proxy-image freshness, orphaned resources, workspace-lock sanity. --fix applies the safe remediations.

Why

Today these checks are embedded in the launch path and only surface when a launch fails; a dedicated command aids support/triage and gives sandy-ui/CI a health probe. Consolidates existing logic (_sandy_image_stale, orphan listers, --print-state internals) behind one verb.

Effort: S (mostly wiring existing predicates + human-readable output).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions