NAME

restart - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard restart

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the public dashboard entrypoint can stay a thin switchboard.

PURPOSE

This staged helper exposes dashboard restart, which restarts the web listener and coordinated collectors for the current runtime.

WHY IT EXISTS

It exists because runtime restart is a built-in operational command, but the switchboard should stage a helper while the runtime manager owns pid handling, port waits, and collector coordination.

WHEN TO USE

Use this file when changing restart CLI flags or the handoff into the runtime lifecycle manager.

HOW TO USE

Users run dashboard restart with any host, port, or worker overrides. The staged helper forwards that request into the private runtime, which stops the current runtime processes and starts them again in the right order.

WHAT USES IT

It is used by operators restarting the local service, by integration smoke that verifies runtime lifecycle behavior, and by runtime manager tests.

EXAMPLES

Example 1:

dashboard restart

Run the public built-in command path that stages or re-enters this helper.

Example 2:

~/.developer-dashboard/cli/dd/restart --help

Inspect the staged helper directly after dashboard init or helper extraction has populated the home runtime.

Example 3:

prove -lv t/05-cli-smoke.t t/30-dashboard-loader.t

Rerun the focused staged-helper and thin-loader tests after changing helper dispatch behavior.

Example 4:

prove -lr t

Verify that the helper still behaves correctly inside the complete repository suite.