refactor: remove legacy env restoration block from EnvironmentLoader

Eliminated the old immutability logic that re-applied the original $_ENV values
after loading. The EnvironmentLoader now follows a cleaner and more predictable
load flow without overriding user-injected or runtime environment variables.

Author: megyptm

CHANGELOG.md

@@ -7,6 +7,18 @@
 
 ---
 
+## [1.0.4] - 2025-11-14
+### Changed
+- Removed legacy environment variable restoration logic from `EnvironmentLoader`.
+    - Deleted the immutability block that re-applied original `$_ENV` values after loading.
+    - Simplified the loader flow to avoid unintended overrides and ensure consistent variable precedence.
+
+### Improved
+- Environment loading now behaves predictably and respects the current process environment without forced rollback.
+- Codebase cleanup for clarity and reduced side-effects.
+
+---
+
 ## [1.0.3] — 2025-11-13
 Release 1.0.3 (fix missing VERSION update)
 

VERSION

@@ -1 +1 @@
-1.0.3
+1.0.4

src/Core/EnvironmentLoader.php

@@ -88,9 +88,6 @@ public function load(): void
         $envFiles = ['.env.local', '.env.testing', '.env', '.env.example'];
         $loaded   = false;
 
-        // Preserve pre-existing environment variables
-        $existing = $_ENV;
-
         foreach ($envFiles as $file) {
             $path = $this->basePath . DIRECTORY_SEPARATOR . $file;
 
@@ -108,12 +105,6 @@ public function load(): void
             throw new Exception('No .env file found in ' . $this->basePath);
         }
 
-        // ♻️ Restore original environment variables (maintain immutability guarantee)
-        foreach ($existing as $key => $value) {
-            $_ENV[$key] = $value;
-            putenv("$key=$value");
-        }
-
         // 🕒 Apply timezone setting (default: Africa/Cairo)
         $timezone = $_ENV['APP_TIMEZONE']
                     ?? $_SERVER['APP_TIMEZONE']