wip - boot

Author: michalsn

system/Boot.php

@@ -184,6 +184,7 @@ public static function bootTest(Paths $paths): void
         static::setExceptionHandler();
         static::initializeKint();
         static::autoloadHelpers();
+        static::preloadCoreClasses();
     }
 
     /**
@@ -443,4 +444,20 @@ protected static function runCommand(Console $console): int
 
         return is_int($exit) ? $exit : EXIT_SUCCESS;
     }
+
+    /**
+     * Pre-loads core framework classes during test bootstrap.
+     *
+     * In parallel test environments (e.g., GitHub Actions with Docker
+     * overlayfs), the first autoload of a large PHP file can fail due to
+     * transient filesystem read issues at process startup time — either
+     * a realpath() failure or a truncated read from the overlayfs kernel
+     * layer. Loading the affected files here (after all other bootstrap
+     * I/O has completed) ensures they are in PHP's class table before
+     * any test runs, avoiding the need to autoload them cold.
+     */
+    protected static function preloadCoreClasses(): void
+    {
+        require_once SYSTEMPATH . 'CodeIgniter.php';
+    }
 }