Update FileFilter logic to prevent exclusion of cached files from contract docblock extraction; adjust related test case for clarity

Author: rcalicdan

src/Contract/FileFilter.php

@@ -49,8 +49,9 @@ public static function isFileExcluded(string|false|null $fileName): bool
             return self::$pathFilterCache[$normalizedPath] = true;
         }
 
+        // Transformed files in the cache directory represent valid application code and must NOT be excluded from reflection!
         if (PathMatcher::isCachePath($normalizedPath)) {
-            return self::$pathFilterCache[$normalizedPath] = true;
+            return self::$pathFilterCache[$normalizedPath] = false;
         }
 
         $config = Config::get();
@@ -63,4 +64,4 @@ public static function isFileExcluded(string|false|null $fileName): bool
 
         return self::$pathFilterCache[$normalizedPath] = ! $isIncluded;
     }
-}
+}

tests/Contract/FileFilterTest.php

@@ -138,7 +138,7 @@
         Config::reset();
     });
 
-    test('unconditionally excludes the configured cache directory even if include pattern is **', function () {
+    test('does not exclude cached files from contract docblock extraction', function () {
         $customCacheDir = getcwd() . '/storage/typephp-cache';
 
         Config::set([
@@ -152,7 +152,7 @@
         $cachedFilePath = str_replace('\\', '/', $customCacheDir . '/v0.1_hash123.php');
         $normalFilePath = str_replace('\\', '/', getcwd() . '/app/Models/User.php');
 
-        expect(FileFilter::isFileExcluded($cachedFilePath))->toBeTrue()
+        expect(FileFilter::isFileExcluded($cachedFilePath))->toBeFalse()
             ->and(FileFilter::isFileExcluded($normalFilePath))->toBeFalse()
         ;