NAME

Developer::Dashboard::CLI::Files - lightweight file and files helper dispatch

SYNOPSIS

use Developer::Dashboard::CLI::Files qw(run_files_command);
run_files_command(command => 'file', args => \@ARGV);

DESCRIPTION

Implements the lightweight dashboard file and dashboard files commands so the public entrypoint can hand off file-related work to an extracted helper without loading the heavier dashboard runtime.

PURPOSE

This module is the command runtime behind dashboard file ... and dashboard files. It prints the active runtime file inventory, resolves named file aliases, persists alias add/delete operations, and locates files beneath a search root without forcing the main dashboard entrypoint to load unrelated subsystems.

WHY IT EXISTS

It exists because file alias and file lookup commands are built-ins, but the real lookup and persistence rules need to live in Perl so shell users and Perl callers get one consistent behavior.

WHEN TO USE

Use this file when changing the behavior of dashboard file resolve/add/del/list/locate, the JSON payload returned by dashboard files, or the file alias persistence contract stored in config.

HOW TO USE

Users run dashboard file <verb> ... or dashboard files. Named aliases are loaded from config, file paths are printed as line-oriented output for resolve and as JSON for list/locate/all-files style calls, and alias mutations are persisted into the writable config layer.

WHAT USES IT

It is used by the public file command family, by tests that verify alias persistence and resolution, and by contributors who need a thin built-in path to file alias behavior without loading the full web/runtime stack.

EXAMPLES

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