[floriankraemer]

Summary

• analyse prints Config: and Cache: header lines, Found N files. Starting analysis., and a progress line on stderr only when running on a terminal.
• Tables per class (Class:/File:, classes sorted by name) or a single All Methods (N total) table with a leading Class column (groupByClass).
• Columns follow showDetailedCognitiveMetrics, showHalsteadComplexity, showCyclomaticComplexity and showUnderstandability; showOnlyMethodsExceedingThreshold hides methods at or below scoreThreshold.
• Colors through picocli Ansi AUTO (off without a terminal, NO_COLOR honoured) from the score, Halstead and risk thresholds.
• --sort-by (all PHP fields plus understandability), --sort-order asc|desc with the PHP validation messages; the sorted order is passed on to the reports.
• --debug prints stage timings (config, discovery, analysis, sorting, output) and statistics (files found/analysed/failed, methods, cache hits/misses); the clock is injectable.
• TextTable now pads cells by one space and ignores ANSI codes when measuring widths, so the churn table changes slightly too.
• Docs: README and docs/Configuration.md describe the console options; the "not yet applied" note is reduced to customReporters.
• The extra columns of baseline deltas and coverage have a marked hook in ResultTableBuilder.columns().

Test plan

• ./mvnw -B verify green (JaCoCo line 96.7%, branch 97.0%; PIT 636 of 638 mutations killed)
• ApprovalTests golden files for default, all metrics, cyclomatic only, Halstead only, understandability, minimal, without detail columns, single table, threshold filter and sorted single table
• Sorter unit tests for every field, both directions, case handling, tie-break, invalid field and order
• E2E tests for the header lines, progress, colors with Ansi forced on, sort validation, sorted report order and the debug summary with a fixed ticker
• Smoke test of the jar on a pseudo-terminal: colors and progress appear, NO_COLOR removes the colors