Proposal: Add a run header and hook status summary to prek run

[pygarap]

Summary

As a follow-up to #2644, add a one-line run header before the hook reports and a one-line hook status summary footer after them.

The run header and hook status summary should become the new default behavior for prek run.

--hide-status <STATUS> can hide every hook report, leaving prek run with no visible output(0-character output), even though the hooks definitely ran.
This occurs when all three statuses are hidden, but also in common cases such as --hide-status passed when every hook passes.

Also, add --hide-header and --hide-footer opt-in CLI flags to prek run to suppress either line independently.

Proposed output

Header:

Running prek on 12 files with 4 hooks.

Footer without status filtering:

• All hooks passed!
• All hooks failed!
• All hooks skipped!
• 2 hooks passed, 1 hook failed, 3 hooks skipped.

The header should report the files and hooks selected for the run.

The footer should summarize the final hook statuses after applying --hide-status. Any hidden status should be omitted from the summary, including its count.

For example, if 5 hooks passed, 2 failed, and 3 were skipped:

$ prek run --hide-status failed
5 hooks passed, 3 hooks skipped.

$ prek run --hide-status passed
2 hooks failed, 3 hooks skipped.

$ prek run --hide-status skipped
5 hooks passed, 2 hooks failed.

If status filtering hides every hook status, the footer should still provide a clear message:

$ prek run --hide-status skipped --hide-status failed --hide-status passed
All hooks are hidden.

The same message should be used whenever no hook statuses remain visible after filtering, even if only one or two --hide-status values were specified.

Usage

$ prek run --all-files --hide-status passed
Running prek on 12 files with 4 hooks.
2 hooks failed, 1 hook skipped.

This keeps filtered output concise while confirming that prek ran and showing the hook statuses that were not hidden.

References

• Add --hide-skipped flag to prek run to suppress (no files to check)Skipped lines #1468
• Proposal: Hook status level report #1777
• Add --hide-status <passed|failed|skipped> for hook reports #2644

[pygarap]

@j178 The problem is that --hide-status <STATUS> or the new config option, can hide every hook report, leaving prek run with no visible output(0-character output), even though the hooks definitely ran.
What do you think is the best solution to avoid empty output?