NAME

file - private file helper for Developer Dashboard

SYNOPSIS

dashboard file <resolve|locate|add|del|list> ...

DESCRIPTION

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

PURPOSE

This staged helper exposes the dashboard file ... subcommand family: resolve, locate, add, del, and list. It is the public CLI front end for saved file aliases and lightweight file lookup.

WHY IT EXISTS

It exists because file alias commands are built-ins, but the actual lookup and config persistence rules need to live in Perl so shell users and tests all see one behavior.

WHEN TO USE

Use this file when changing dashboard file verbs, staged-helper argv handling, or the examples that describe file alias resolution and lookup.

HOW TO USE

Users run dashboard file <verb> .... The staged helper loads the file command runtime and prints either JSON or line-oriented output depending on the selected subcommand.

WHAT USES IT

It is used by the public file command family and by regression tests that verify file alias persistence, resolution, and locate behavior.

EXAMPLES

dashboard file resolve global_config
dashboard file add notes ~/notes.txt
dashboard file locate notes txt
dashboard file list
dashboard file del notes