NAME

files - private runtime file helper for Developer Dashboard

SYNOPSIS

dashboard files

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can expose the active runtime file set without loading the full runtime first.

PURPOSE

This staged helper exposes dashboard files, the command that prints the active runtime file set as JSON. It is the shell-visible entrypoint for named runtime files such as logs, pid/state files, config files, and configured file aliases.

WHY IT EXISTS

It exists because file reporting is a built-in dashboard feature, but the public switchboard should only dispatch to a helper while the file runtime owns the lookup and serialization rules.

WHEN TO USE

Use this file when changing the dashboard files CLI contract, the staged helper handoff, or the exact examples contributors use to inspect active runtime files from the shell.

HOW TO USE

Users run dashboard files. The staged helper forwards the request to the lightweight file runtime, which collects named runtime files and configured aliases for the current working directory and prints that payload as JSON.

WHAT USES IT

It is used by users debugging file alias state and by tests that verify the active runtime file payload.

EXAMPLES

dashboard files