NAME
upgrade - private self-upgrade helper for Developer Dashboard
SYNOPSIS
dashboard upgrade
dashboard upgrade --dry-run
d2 upgradeDESCRIPTION
This private helper is staged under ~/.developer-dashboard/cli/dd/ so the public dashboard entrypoint remains a thin switchboard while the reusable upgrade module owns platform selection, download validation, and execution.
PURPOSE
Expose the first-class dashboard upgrade and d2 upgrade command surface through the managed private-helper namespace.
WHY IT EXISTS
Self-upgrade crosses a remote-code execution boundary. A dedicated helper keeps that behavior out of the public switchboard and hands it to one tested module that validates the canonical installer before execution.
WHEN TO USE
Use this file when changing the staged handoff into the self-upgrade module. Change platform, transport, validation, and execution policy in Developer::Dashboard::CLI::Upgrade instead.
HOW TO USE
Run dashboard upgrade or d2 upgrade to download the canonical installer, validate its Developer Dashboard markers, and execute it through the active platform interpreter while preserving its visible output and exit status. Add --dry-run to print the platform, canonical HTTPS URL, and argv-style command plan without downloading or executing an installer. Unix-like hosts use sh; Windows prefers pwsh and otherwise uses powershell with a process-scoped execution-policy bypass.
WHAT USES IT
The public dashboard switchboard, the d2 short entrypoint, installed home runtimes, and focused upgrade acceptance tests use this helper.
EXAMPLES
dashboard upgrade --dry-run
d2 upgrade
prove -lv t/122-upgrade-cli.t