Proposal: Add top-level and hook-level hide_captured_output configuration

[pygarap]

Summary

Following discussion #2578 and discussion #2646, propose a configuration option for suppressing captured output from successful hooks without introducing another CLI flag.

Add hide_captured_output with the following properties:

• Type: Boolean
• Default: false, preserving existing behavior.
• Scope: Top-level and hook-level, following the same inheritance and override semantics as fail_fast.

Behavior

• Passed hooks: At verbosity level 0, captured output is normally hidden unless the hook has verbose: true. At verbosity level 1 or higher, captured output is displayed. Setting hide_captured_output: true suppresses it regardless of CLI verbosity or the hook's verbose setting.
• Failed hooks: Continue displaying captured output as usual, regardless of this setting.
• Skipped hooks: Unaffected, as they have no captured output.

Hook statuses, metadata, execution, exit codes, logging, and existing verbosity semantics remain unchanged.

Motivation

I want to use prek run -v to display basic metadata for every hook, including successful hooks, without printing their potentially lengthy captured output.

The metadata I want to retain includes:

• Hook ID
• Hook alias
• Hook description
• Execution duration

Currently, the verbosity settings do not allow this combination:

• Without -v: Successful hooks generally do not display their captured output, but their detailed metadata is also hidden.
• With -v or higher: The metadata is displayed, but so is the captured output from successful hooks, which can add significant noise.

The missing capability is to display verbose metadata for all hooks while showing captured output only for failed hooks.

Setting hide_captured_output: true would provide exactly this behavior, preserving useful metadata and failure diagnostics without unnecessary output from successful hooks.

Usage

hide_captured_output: true

repos:
  - repo: local
    hooks:
      - id: example-check
        name: Example check
        entry: echo "Captured output"
        language: system
        pass_filenames: false
        verbose: true
        hide_captured_output: false

Here, captured output is suppressed globally for successful hooks but remains enabled for example-check.

To restore default reporting behavior:

• Project-wide: Set hide_captured_output: false (the default).
• Single run: Use --no-hide_captured_output to override configured values, including hook-level settings.

Support the configuration option in both YAML and TOML.

References

• Discussion #2578
• Discussion #2646
• Configuration reference

[pygarap]

Can also be: hide_captured_passed_output or hide_passed_output.