Skip to content
Shepherd

GUIDANCE_ONLY

const GUIDANCE_ONLY: ReadonlySet<string>

Defined in: src/remediations.ts:55

Hints that have a verbatim REMEDIATIONS command but that the in-app Fix surface must NOT auto-run — it presents them as guidance, not a one-click fix. Two reasons qualify a hint:

  • running the command never clears the check unattended — tailscale: installing the binary leaves resolveNodeHost null until an interactive tailnet login;
  • the fix is a privileged system-package install — git: an apt/apk/dnf/pacman install that needs root/sudo we can’t assume for the Shepherd service user, even though it DOES clear the check when run with privilege. This is the in-app analogue of the harness detectionOnly split in scenarios.ts. remediationsFor stays guidance-agnostic, so the harness (running as root) still applies these and reaches green.