NAME

decode - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard decode

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 decode, the token-to-text half of the dashboard codec pair. It lets users inspect the payload behind a transient bookmark or action token from the CLI.

WHY IT EXISTS

It exists because token debugging and manual inspection are useful, but the public switchboard should dispatch to a staged helper instead of owning the codec implementation itself.

WHEN TO USE

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

HOW TO USE

Users pipe or pass a token into dashboard decode. The staged helper forwards the request to the private runtime, which decodes the base64+gzip payload and prints the recovered text.

WHAT USES IT

It is used by developers debugging transient bookmark URLs, by docs that demonstrate the codec round-trip, and by command coverage for the encode/decode pair.

EXAMPLES

Example 1:

dashboard decode eyJwYWdlIjoiL2FwcC90ZXN0In0

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

Example 2:

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