NAME

ticket - private tmux ticket helper for Developer Dashboard

SYNOPSIS

dashboard ticket <ticket-ref>

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can keep ticket-session behaviour available without installing a generic executable into the user's global PATH.

PURPOSE

This staged helper exposes dashboard ticket, the command that creates or reuses a tmux session for a ticket and then attaches the terminal to it. It is the shell-facing entrypoint for the ticket-session workflow.

WHY IT EXISTS

It exists because ticket-session behavior is a built-in convenience feature, but the public switchboard should stay thin while the ticket module owns tmux session naming, environment seeding, and create-vs-attach logic.

WHEN TO USE

Use this file when changing the dashboard ticket CLI contract, the staged helper handoff, or the examples contributors use to understand explicit ticket selection and TICKET_REF fallback.

HOW TO USE

Users run dashboard ticket <ticket-ref> or set TICKET_REF and run dashboard ticket. The staged helper forwards the request into the private runtime, which loads Developer::Dashboard::CLI::Ticket, resolves the ticket name, seeds TICKET_REF, B, and OB in the tmux session environment, creates a detached Code1 window when the session does not exist yet, and then attaches to that session.

WHAT USES IT

It is used by ticket-session workflows in the shell, by prompt integrations that rely on consistent ticket environment variables, and by ticket regression tests that verify explicit ticket selection and environment fallback.

EXAMPLES

dashboard ticket
dashboard ticket DD-123
TICKET_REF=DD-123 dashboard ticket
dashboard ticket feature-branch-42