Phauthentic · floriankraemer · May 24, 2026 · May 24, 2026 · May 24, 2026 · May 24, 2026
diff --git a/.github/workflows/cognitive-code-analysis.yaml b/.github/workflows/cognitive-code-analysis.yaml
@@ -0,0 +1,29 @@
+name: Cognitive Code Analysis
+
+on:
+  pull_request:
+    paths:
+      - '**/*.php'
+
+permissions:
+  pull-requests: write
+  contents: read
+
+jobs:
+  analyse:
+    name: Cognitive Code Analysis
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: Phauthentic/cognitive-code-analysis-github-action@v1
+        with:
+          install-mode: phar
+          config: phpcca.yaml
+          post-comment: true
+          upload-artifact: true
+          emit-annotations: true
+          upload-sarif: false
+          fail-on-threshold: false
diff --git a/box.json.dist b/box.json.dist
@@ -9,7 +9,7 @@
         "KevinGH\\Box\\Compactor\\PhpScoper"
     ],
     "files": [
-        "config.yml",
+        "phpcca.yaml",
         "composer.json",
         "readme.md",
         "LICENSE"

diff --git a/docs/CI-Integration.md b/docs/CI-Integration.md
@@ -13,7 +13,7 @@ A typical CI integration follows these steps:
 3. Run `bin/phpcca analyse` on those files only
 4. Publish the report (Markdown comment, SARIF upload, or quality gate)
 
-When `cca.yaml` exists in the project root, `analyse` loads it automatically. Use `--config=path/to/config.yaml` to override.
+When `phpcca.yaml` exists in the project root, `analyse` loads it automatically. Use `--config=path/to/config.yaml` to override.
 
 ## Report formats for CI
 
@@ -38,7 +38,7 @@ See [Baseline Analysis](./Baseline-Analysis.md) to compare metrics against a pre
 
 The workflow below runs on pull requests, analyses changed PHP files, posts a Markdown report as a PR comment, and uploads the report as an artifact.
 
-Add `--config=cca.yaml` if your config file is not named `cca.yaml` or not in the working directory.
+Add `--config=phpcca.yaml` if your config file is not named `phpcca.yaml` or not in the working directory.
 
 ```yaml
 name: Code Metrics
@@ -142,7 +142,7 @@ Then upload `results.sarif` using the [GitHub Code Scanning upload action](https
 
 The job below runs on merge requests, analyses changed PHP files, posts a Markdown report as an MR note, and stores the report as an artifact.
 
-Use `--config=cca.yaml` when your config file is not auto-discovered from the project root.
+Use `--config=phpcca.yaml` when your config file is not auto-discovered from the project root.
 
 ```yaml
 Code-Metrics:
@@ -166,7 +166,7 @@ Code-Metrics:
         CHANGED_FILES=$(find src/ -name "*.php" | tr '\n' ' ')
       fi
       if [ -n "$CHANGED_FILES" ]; then
-        bin/phpcca analyse $CHANGED_FILES --report-type=markdown --report-file=cca-report.md --config=cca.yaml
+        bin/phpcca analyse $CHANGED_FILES --report-type=markdown --report-file=cca-report.md --config=phpcca.yaml
         if [ -f "cca-report.md" ] && [ -s "cca-report.md" ]; then
           # Try with CI_JOB_TOKEN first, fallback to CI/CD variables
           if [ -n "$VALIDATOR" ]; then
@@ -237,7 +237,7 @@ GitLab picks up the Code Quality report automatically when configured in your pi
 
 ## Related
 
-- [Configuration](./Configuration.md) — project setup with `bin/phpcca init` and `cca.yaml`
+- [Configuration](./Configuration.md) — project setup with `bin/phpcca init` and `phpcca.yaml`
 - [Baseline Analysis](./Baseline-Analysis.md) — track complexity changes over time
 - [Creating Custom Reporters](./Creating-Custom-Reporters.md) — extend report output for custom CI integrations
 - [Issue #29](https://github.com/Phauthentic/cognitive-code-analysis/issues/29) — original feature discussion for GitHub Actions and branch comparison
diff --git a/docs/Configuration.md b/docs/Configuration.md
@@ -2,15 +2,15 @@
 
 ## Creating a configuration file
 
-Run `init` to create a `cca.yaml` in your project:
+Run `init` to create a `phpcca.yaml` in your project:
 
 ```bash
 bin/phpcca init
 bin/phpcca init --silent
-bin/phpcca init --path=/path/to/cca.yaml
+bin/phpcca init --path=/path/to/phpcca.yaml
 ```
 
-When `cca.yaml` exists in the working directory, `analyse` and `churn` pick it up automatically. You only need `--config` for a custom path or filename.
+When `phpcca.yaml` exists in the working directory, `analyse` and `churn` pick it up automatically. You only need `--config` for a custom path or filename.
 
 ## Passing a configuration file
 
@@ -20,7 +20,7 @@ You can specify another configuration file by passing it to the config options:
 bin/phpcca analyse <path-to-folder> --config=<path-to-config-file>
 ```
 
-When both `cca.yaml` and `--config` are available, the explicit `--config` path takes precedence.
+When both `phpcca.yaml` and `--config` are available, the explicit `--config` path takes precedence.
 
 ## Excluding Classes and Methods
 

diff --git a/config.yml → phpcca.yaml b/config.yml → phpcca.yaml
@@ -2,7 +2,7 @@ cognitive:
   excludeFilePatterns:
   excludePatterns:
   scoreThreshold: 0.5
-  showOnlyMethodsExceedingThreshold: false
+  showOnlyMethodsExceedingThreshold: true
   showHalsteadComplexity: false
   showCyclomaticComplexity: false
   showDetailedCognitiveMetrics: true

diff --git a/readme.md b/readme.md
@@ -37,12 +37,12 @@ composer require --dev phauthentic/cognitive-code-analysis
 Create a project configuration file:
 
 ```bash
-bin/phpcca init                  # interactive setup → creates cca.yaml in current directory
+bin/phpcca init                  # interactive setup → creates phpcca.yaml in current directory
 bin/phpcca init --silent         # non-interactive, all defaults
-bin/phpcca init --path=/path/to/cca.yaml
+bin/phpcca init --path=/path/to/phpcca.yaml
 ```
 
-When `cca.yaml` exists in the current working directory, `analyse` and `churn` load it automatically. Use `--config` to specify a different file.
+When `phpcca.yaml` exists in the current working directory, `analyse` and `churn` load it automatically. Use `--config` to specify a different file.
 
 Cognitive Complexity Analysis
 
@@ -163,6 +163,6 @@ Especially the AST-parser used under the hood to analyse the code might have iss
 
 ## License ⚖️
 
-Copyright Florian Krämer
+Copyright [Florian Krämer](https://florian-kraemer.net/)
 
 Licensed under the [GPL3 license](LICENSE).
diff --git a/src/Application.php b/src/Application.php
@@ -192,7 +192,7 @@ private function registerUtilityServices(): void
             ->setArguments([
                 new Reference(Processor::class),
                 new Reference(ConfigLoader::class),
-                __DIR__ . '/../config.yml',
+                __DIR__ . '/../phpcca.yaml',
             ])
             ->setPublic(true);
 

diff --git a/src/Command/InitCommand.php b/src/Command/InitCommand.php
@@ -16,7 +16,7 @@
 
 #[AsCommand(
     name: 'init',
-    description: 'Create a default cca.yaml for cognitive code analysis.'
+    description: 'Create a default phpcca.yaml for cognitive code analysis.'
 )]
 class InitCommand extends Command
 {

diff --git a/src/Config/ConfigFileResolver.php b/src/Config/ConfigFileResolver.php
@@ -6,7 +6,7 @@
 
 class ConfigFileResolver
 {
-    public const DEFAULT_FILENAME = 'cca.yaml';
+    public const DEFAULT_FILENAME = 'phpcca.yaml';
 
     public function resolve(?string $explicitConfigPath): ?string
     {

diff --git a/src/Config/ConfigService.php b/src/Config/ConfigService.php
@@ -27,7 +27,7 @@ public function __construct(
     private function loadDefaultConfig(): void
     {
         $config = $this->processor->processConfiguration($this->configuration, [
-            Yaml::parseFile(__DIR__ . '/../../config.yml'),
+            Yaml::parseFile(__DIR__ . '/../../phpcca.yaml'),
         ]);
 
         $this->config = (new ConfigFactory())->fromArray($config);
@@ -38,7 +38,7 @@ private function loadDefaultConfig(): void
      */
     public function loadConfig(string $configFilePath): void
     {
-        $defaultConfig = Yaml::parseFile(__DIR__ . '/../../config.yml');
+        $defaultConfig = Yaml::parseFile(__DIR__ . '/../../phpcca.yaml');
         $providedConfig = Yaml::parseFile($configFilePath);
 
         $config = $this->processor->processConfiguration($this->configuration, [

diff --git a/tests/Unit/Command/CognitiveMetricsCommandCoverageTest.php b/tests/Unit/Command/CognitiveMetricsCommandCoverageTest.php
@@ -17,6 +17,17 @@
  */
 class CognitiveMetricsCommandCoverageTest extends TestCase
 {
+    private const TEST_CONFIG = __DIR__ . '/minimal-config.yml';
+
+    /**
+     * @param array<string, mixed> $input
+     * @return array<string, mixed>
+     */
+    private function withTestConfig(array $input): array
+    {
+        return ['--config' => self::TEST_CONFIG] + $input;
+    }
+
     #[Test]
     #[DataProvider('coverageFormatProvider')]
     public function testAnalyseWithCoverageFormats(string $option, string $file, string $format): void
@@ -25,10 +36,10 @@ public function testAnalyseWithCoverageFormats(string $option, string $file, str
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php',
             $option => __DIR__ . '/../../Fixtures/Coverage/' . $file,
-        ]);
+        ]));
 
         $this->assertEquals(
             Command::SUCCESS,
@@ -48,11 +59,11 @@ public function testAnalyseWithBothCoverageFormatsReturnsError(): void
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php',
             '--coverage-clover' => __DIR__ . '/../../Fixtures/Coverage/testcode-clover.xml',
             '--coverage-cobertura' => __DIR__ . '/../../Fixtures/Coverage/testcode-cobertura.xml',
-        ]);
+        ]));
 
         $this->assertEquals(
             Command::FAILURE,
@@ -71,10 +82,10 @@ public function testAnalyseWithNonExistentCoverageFile(): void
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php',
             '--coverage-clover' => __DIR__ . '/../../Fixtures/Coverage/does-not-exist.xml',
-        ]);
+        ]));
 
         $this->assertEquals(
             Command::FAILURE,
@@ -93,9 +104,9 @@ public function testAnalyseWithoutCoverageDoesNotShowCoverageColumn(): void
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php',
-        ]);
+        ]));
 
         $this->assertEquals(Command::SUCCESS, $tester->getStatusCode());
         $output = $tester->getDisplay();
@@ -119,10 +130,10 @@ public function testAnalyseShowsMethodLevelCoverage(
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php',
             "--coverage-{$format}" => __DIR__ . '/../../Fixtures/Coverage/' . $file,
-        ]);
+        ]));
 
         $this->assertEquals(Command::SUCCESS, $tester->getStatusCode());
         $output = $tester->getDisplay();
@@ -148,10 +159,10 @@ public function testAnalyseWithCoverageAndMultiplePaths(): void
         $command = $application->getContainer()->get(CognitiveMetricsCommand::class);
         $tester = new CommandTester($command);
 
-        $tester->execute([
+        $tester->execute($this->withTestConfig([
             'path' => __DIR__ . '/../../TestCode/Paginator.php,' . __DIR__ . '/../../TestCode/FileWithTwoClasses.php',
             '--coverage-clover' => __DIR__ . '/../../Fixtures/Coverage/testcode-clover.xml',
-        ]);
+        ]));
 
         $this->assertEquals(
             Command::SUCCESS,

diff --git a/tests/Unit/Command/InitCommandTest.php b/tests/Unit/Command/InitCommandTest.php
@@ -30,7 +30,7 @@ protected function tearDown(): void
     #[Test]
     public function silentModeCreatesConfigWithDefaultsAtGivenPath(): void
     {
-        $targetPath = $this->tempDir . '/cca.yaml';
+        $targetPath = $this->tempDir . '/phpcca.yaml';
         $tester = $this->createCommandTester();
 
         $statusCode = $tester->execute([
@@ -61,7 +61,7 @@ public function silentModeUsesDefaultPathInWorkingDirectory(): void
             $statusCode = $tester->execute(['--silent' => true]);
 
             $this->assertSame(Command::SUCCESS, $statusCode);
-            $this->assertFileExists($this->tempDir . '/cca.yaml');
+            $this->assertFileExists($this->tempDir . '/phpcca.yaml');
         } finally {
             chdir($originalWorkingDirectory);
         }

diff --git a/tests/Unit/Command/OutputWithAllMetrics.txt b/tests/Unit/Command/OutputWithAllMetrics.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/all-metrics-config.yml
+Cache: enabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬───────┬───────────┬─────────┬───────────┬──────────┬───────┬────────────┬───────┬────────────┬──────────┬────────────┬──────────┬────────────┐

diff --git a/tests/Unit/Command/OutputWithCyclomaticOnly.txt b/tests/Unit/Command/OutputWithCyclomaticOnly.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/cyclomatic-only-config.yml
+Cache: enabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬───────┬───────────┬─────────┬───────────┬──────────┬───────┬────────────┬───────┬────────────┬────────────┐

diff --git a/tests/Unit/Command/OutputWithHalsteadOnly.txt b/tests/Unit/Command/OutputWithHalsteadOnly.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/halstead-only-config.yml
+Cache: enabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬───────┬───────────┬─────────┬───────────┬──────────┬───────┬────────────┬───────┬────────────┬──────────┬────────────┬──────────┐

diff --git a/tests/Unit/Command/OutputWithMinimalConfig.txt b/tests/Unit/Command/OutputWithMinimalConfig.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/minimal-config.yml
+Cache: enabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬────────────┐

diff --git a/tests/Unit/Command/OutputWithSingleTable.txt b/tests/Unit/Command/OutputWithSingleTable.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/single-table-config.yml
+Cache: enabled
+
 All Methods (23 total)
 ┌──────────────────────────────────────────┬───────────────────────────────────────────┬──────────────┬───────────┬─────────┬─────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬───────────┬────────────┬────────────┬─────────────────┐
 │ Class                                    │ Method Name                               │ Lines        │ Arguments │ Returns │ Variables   │ Property   │ If         │ If Nesting │ Else       │ Cognitive  │ Halstead  │ Halstead   │ Halstead   │ Cyclomatic      │

diff --git a/tests/Unit/Command/OutputWithThreshold.txt b/tests/Unit/Command/OutputWithThreshold.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/threshold-config.yml
+Cache: enabled
+
 Class: \Doctrine\ORM\Tools\Pagination\Paginator
 File: tests/TestCode/Paginator.php
 ┌───────────────────────────────────────────┬────────┬───────────┬─────────┬───────────┬──────────┬───────┬────────────┬───────────┬────────────┬──────────┬────────────┬──────────┬────────────┐

diff --git a/tests/Unit/Command/OutputWithoutDetailedMetrics.txt b/tests/Unit/Command/OutputWithoutDetailedMetrics.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/../../../tests/Fixtures/no-detailed-metrics-config.yml
+Cache: enabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬────────────┬──────────┬────────────┬──────────┬────────────┐

diff --git a/tests/Unit/Command/OutputWithoutOptions.txt b/tests/Unit/Command/OutputWithoutOptions.txt
@@ -1,3 +1,6 @@
+Config: ./tests/Unit/Command/minimal-config.yml
+Cache: disabled
+
 Class: \ClassOne
 File: tests/TestCode/FileWithTwoClasses.php
 ┌─────────────┬───────┬───────────┬─────────┬───────────┬──────────┬───────┬────────────┬───────┬────────────┐

diff --git a/tests/Unit/Command/Presentation/RuntimeStatusRendererTest.php b/tests/Unit/Command/Presentation/RuntimeStatusRendererTest.php
@@ -50,10 +50,10 @@ public function renderShowsConfigPathAndDisabledCache(): void
         $output = new BufferedOutput();
         $renderer = new RuntimeStatusRenderer();
 
-        $renderer->render($output, $tempDir . '/cca.yaml', $this->createConfig(cacheEnabled: false));
+        $renderer->render($output, $tempDir . '/phpcca.yaml', $this->createConfig(cacheEnabled: false));
 
         $this->assertSame(
-            "Config: ./cca.yaml\nCache: disabled\n\n",
+            "Config: ./phpcca.yaml\nCache: disabled\n\n",
             $output->fetch()
         );
 

diff --git a/tests/Unit/Config/ConfigInitializerTest.php b/tests/Unit/Config/ConfigInitializerTest.php
@@ -59,7 +59,7 @@ public function writeConfigFileCreatesFileAndParentDirectory(): void
     {
         $initializer = $this->createInitializer();
         $config = $initializer->createDefaultConfig();
-        $targetPath = $this->tempDir . '/nested/cca.yaml';
+        $targetPath = $this->tempDir . '/nested/phpcca.yaml';
 
         $initializer->writeConfigFile($targetPath, $config);
 
@@ -73,7 +73,7 @@ private function createInitializer(): ConfigInitializer
         return new ConfigInitializer(
             new Processor(),
             new ConfigLoader(),
-            __DIR__ . '/../../../config.yml',
+            __DIR__ . '/../../../phpcca.yaml',
         );
     }