File Summarization

Read the shared fidelity rules and execution contract. Use the selected format; do not force structured Markdown when JSON, TL;DR or another template was requested.

Acquire and choose depth

Resolve the exact source scope first. For directories, enumerate the requested tree without following cycles, preserve exclusions/inaccessible entries, and account for all intended sources. Do not narrow a directory request to a representative file without disclosing that scope change.

Inspect file type and size before choosing a read strategy. When execution is available:

uv run --script "<plugin-root>/scripts/file_metrics.py" "<file-path>" --json --no-excerpt