NAME

path - private path helper for Developer Dashboard

SYNOPSIS

dashboard path <resolve|locate|add|del|project-root|list> ...

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can keep path registry operations available without loading the full runtime first.

PURPOSE

This staged helper exposes the dashboard path ... subcommand family: resolve, locate, cdr, add, del, project-root, and list. It is the public CLI front end for saved path aliases, layered runtime path discovery, and the payload generation used by shell navigation helpers.

WHY IT EXISTS

It exists because path alias and navigation commands are built-ins, but the actual lookup and regex narrowing rules need to live in Perl so bash, zsh, POSIX sh, and PowerShell all use the same behavior.

WHEN TO USE

Use this file when changing dashboard path verbs, staged-helper argv handling, or the examples that describe alias resolution and cdr-style regex narrowing.

HOW TO USE

Users run dashboard path <verb> .... The staged helper loads the path command runtime and prints either JSON or line-oriented output. For dashboard path cdr, the first argument is treated as a saved alias when one exists; otherwise it becomes the first search regex under the current directory. Any remaining narrowing arguments are case-insensitive regexes and all of them must match a candidate directory path.

WHAT USES IT

It is used by the public path command family, by shell bootstraps that depend on dashboard path cdr, and by path/cdr regression tests that verify alias lookup, current-directory fallback, and multiple-match behavior.

EXAMPLES

dashboard path resolve dashboards
dashboard path add work ~/projects/work
dashboard path cdr work alpha red
dashboard path list
dashboard path project-root