fix(self-update): use realpath via Safe namespace for global scope checks

Author: coisa

src/SelfUpdate/ComposerSelfUpdateScopeResolver.php

@@ -22,6 +22,9 @@
 use FastForward\DevTools\Environment\EnvironmentInterface;
 use FastForward\DevTools\Path\DevToolsPathResolver;
 use Symfony\Component\Filesystem\Path;
+use Throwable;
+
+use function Safe\realpath;
 
 /**
  * Detects Composer global DevTools installations from known Composer home paths.
@@ -44,10 +47,10 @@ public function __construct(
      */
     public function isGlobalInstallation(): bool
     {
-        $packagePath = Path::canonicalize($this->packagePath ?? DevToolsPathResolver::getPackagePath());
+        $packagePath = $this->normalizePath($this->packagePath ?? DevToolsPathResolver::getPackagePath());
 
         foreach ($this->getComposerHomeCandidates() as $composerHome) {
-            $globalPackagePath = Path::canonicalize(Path::join($composerHome, self::PACKAGE_PATH));
+            $globalPackagePath = $this->normalizePath(Path::join($composerHome, self::PACKAGE_PATH));
 
             if ($packagePath === $globalPackagePath || str_starts_with(
                 $packagePath,
@@ -96,4 +99,18 @@ private function getComposerHomeCandidates(): array
 
         return array_values(array_unique($candidates));
     }
+
+    /**
+     * Safely canonicalizes a path, resolving symlinks when available.
+     *
+     * @param string $path
+     */
+    private function normalizePath(string $path): string
+    {
+        try {
+            return Path::canonicalize(realpath($path));
+        } catch (Throwable) {
+            return Path::canonicalize($path);
+        }
+    }
 }