NAME

ps1 - private prompt helper for Developer Dashboard

SYNOPSIS

dashboard ps1 [--jobs N] [--cwd DIR] [--mode compact|extended] [--color] [--max-age N]

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can keep prompt rendering on a lightweight handoff path.

PURPOSE

This staged helper exposes dashboard ps1, the prompt-rendering command used by generated shell bootstraps. It is the CLI face of the prompt subsystem.

WHY IT EXISTS

It exists because prompt rendering is built into the product, but the prompt text should come from the prompt module rather than from shell code or the public switchboard.

WHEN TO USE

Use this file when changing prompt CLI flags, compact versus extended mode handling, or the handoff from the helper into the prompt renderer.

HOW TO USE

Users or shell bootstrap functions run dashboard ps1 .... The staged helper uses DEVELOPER_DASHBOARD_REPO_LIB from the public switchboard when that directory is available, avoiding a FindBin startup import. Direct standalone invocation retains a FindBin fallback to the helper-relative library directory. The helper forwards the request into the private runtime, which loads indicator and collector state and prints the rendered prompt fragment. Exact options emitted by generated prompts are parsed with a small local parser; unsupported or abbreviated forms continue through Getopt::Long so its compatibility behavior remains available when needed.

WHAT USES IT

It is used by generated bash/zsh/sh/PowerShell prompts, by prompt smoke tests, and by contributors checking prompt output while iterating on indicator behavior.

EXAMPLES

Example 1:

dashboard shell ps1

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

Example 2:

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