NAME

docker - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard docker ...

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 docker compose. It is the command surface for dashboard-specific Compose discovery, addon/mode handling, and dry-run output.

WHY IT EXISTS

It exists because the docker helper is a built-in dashboard feature, but the command wrapper should stay staged and thin while the compose resolver owns the hard rules.

WHEN TO USE

Use this file when changing docker helper CLI arguments or the handoff into the compose resolver.

HOW TO USE

Users run dashboard docker compose .... The staged helper forwards the passthrough args and wrapper flags into the private runtime, which resolves the compose files and then execs the final Docker command.

WHAT USES IT

It is used by developers who keep compose stacks under dashboard config roots, by docker command tests, and by docs around isolated service folders.

EXAMPLES

Example 1:

dashboard docker compose ps

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

Example 2:

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