NAME

serve - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard serve ...

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 serve, the command that starts the dashboard web server in background or foreground mode and can also print or follow logs and worker information.

WHY IT EXISTS

It exists because serving the dashboard is a built-in runtime operation, but the CLI wrapper should remain staged and thin while the runtime and web server modules own process and transport behavior.

WHEN TO USE

Use this file when changing serve CLI flags, foreground/background behavior, or the handoff into the runtime manager and web server stack.

HOW TO USE

Users run dashboard serve or one of its log/worker submodes. The staged helper forwards the request into the private runtime, which launches or inspects the managed web process.

WHAT USES IT

It is used by local dashboard startup, by integration smoke runs, and by runtime manager tests that verify background serving and log inspection.

EXAMPLES

Example 1:

dashboard serve --foreground

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

Example 2:

~/.developer-dashboard/cli/dd/serve --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.