NAME

encode - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard encode

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 encode, the text-to-token half of the dashboard codec pair. It lets users turn bookmark or action text into the portable payload format used by transient dashboard URLs.

WHY IT EXISTS

It exists because users and tests sometimes need a token generator from the CLI, but the public switchboard should not carry the codec implementation directly.

WHEN TO USE

Use this file when changing the CLI contract for token generation or when fixing how encode requests are handed off to the codec module.

HOW TO USE

Users pipe text into dashboard encode or redirect a file into it. The staged helper forwards the request to the private runtime, which compresses and base64-encodes the payload and prints the token.

WHAT USES IT

It is used by token-debugging workflows, by docs that show the encode/decode round trip, and by fuzz and coverage tests around the codec helpers.

EXAMPLES

Example 1:

dashboard encode /app/test

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

Example 2:

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