NAME

auth - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard auth ...

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 helper-user administration commands such as dashboard auth add-user, list-users, and remove-user. It gives the CLI a focused auth-management entrypoint without putting user-management code in bin/dashboard.

WHY IT EXISTS

It exists because helper login management is part of the product surface, but the public switchboard should only dispatch to a staged helper, not own password and user-storage behavior itself.

WHEN TO USE

Use this file when changing the CLI auth command surface or when fixing how helper-user administration is handed off to the auth runtime.

HOW TO USE

Users run dashboard auth .... The staged helper forwards the subcommand and arguments into the private built-in runtime, which loads the auth module and updates the runtime user store.

WHAT USES IT

It is used by administrators creating or removing helper users, by integration smoke that verifies helper login setup, and by auth command coverage tests.

EXAMPLES

Example 1:

dashboard auth helper login

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

Example 2:

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