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 forwards the request into the private runtime, which loads indicator and collector state and prints the rendered prompt fragment.

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.