fix(sniffs): allow Helper classes in Service/ directory

src/Sniffs/Structure/ServiceStructureSniff.php

@@ -79,6 +79,10 @@ private function assertCompanionClassAllowed(
         string $className,
         string $normalizedPath,
     ): void {
+        if (str_ends_with($className, 'Helper') || str_ends_with($className, 'Factory')) {
+            return;
+        }
+
         $directory     = dirname($normalizedPath);
         $serviceFiles  = $this->findServiceClassesInDirectory($directory);
 

tests/fixtures.php

@@ -293,4 +293,16 @@
         'errors' => [],
         'warnings' => [],
     ],
+    // ServiceStructureSniff — Helper class in Service/ directory — valid per convention
+    [
+        'file' => __DIR__ . '/fixtures/src/Module/Example/Infrastructure/Service/Source/ParamsGetter/Helper/RutubeHelper.inc',
+        'errors' => [],
+        'warnings' => [],
+    ],
+    // ServiceStructureSniff — Factory class in Service/ directory — valid per convention
+    [
+        'file' => __DIR__ . '/fixtures/src/Module/Example/Application/Service/SomeService/PaymentDtoFactory.inc',
+        'errors' => [],
+        'warnings' => [],
+    ],
 ];

tests/fixtures/src/Module/Example/Application/Service/SomeService/PaymentDtoFactory.inc

@@ -0,0 +1,12 @@
+<?php
+
+// Factory class inside Service/ directory — should pass per convention
+namespace App\Module\Example\Application\Service\SomeService;
+
+final readonly class PaymentDtoFactory
+{
+    public function create(int $amount): object
+    {
+        return new \stdClass();
+    }
+}

tests/fixtures/src/Module/Example/Infrastructure/Service/Source/ParamsGetter/Helper/RutubeHelper.inc

@@ -0,0 +1,12 @@
+<?php
+
+// Helper class in Service/ directory — should pass per convention
+namespace App\Module\Example\Infrastructure\Service\Source\ParamsGetter\Helper;
+
+final class RutubeHelper
+{
+    public static function getVideoId(string $uri): string
+    {
+        return $uri;
+    }
+}