ft/Client/Packages/io.github.hatayama.uloopmcp/Editor/CLI/NpmInstallDiagnostics.cs

using System.Diagnostics;
using System.IO;
using System.Text;
using UnityEngine;

namespace io.github.hatayama.uLoopMCP
{
    /// <summary>
    /// Pre-flight diagnostics and error classification for npm global install.
    /// Windows npm installs often fail silently due to directory permissions
    /// (e.g. C:\Program Files\nodejs requires admin elevation).
    /// </summary>
    public static class NpmInstallDiagnostics
    {
        private const int PREFIX_CHECK_TIMEOUT_MS = 5000;

        private const string ERROR_PATTERN_EPERM = "EPERM";
        private const string ERROR_PATTERN_EACCES = "EACCES";
        private const string ERROR_PATTERN_OPERATION_NOT_PERMITTED = "operation not permitted";

        /// <summary>
        /// Returns the npm global prefix path by running `npm prefix -g`, or null if resolution fails.
        /// </summary>
        public static string GetGlobalPrefix(string npmPath)
        {
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(npmPath), "npmPath must not be null or empty");

            ProcessStartInfo startInfo = new ProcessStartInfo
            {
                FileName = npmPath,
                Arguments = "prefix -g",
                UseShellExecute = false,
                RedirectStandardOutput = true,
                RedirectStandardError = true,
                CreateNoWindow = true
            };

            NodeEnvironmentResolver.SetupEnvironmentPath(startInfo, NodeEnvironmentResolver.FindNodePath());

            using (Process process = Process.Start(startInfo))
            {
                if (process == null)
                {
                    return null;
                }

                StringBuilder stdoutBuilder = new StringBuilder();

                process.OutputDataReceived += (sender, e) =>
                {
                    if (e.Data != null)
                    {
                        stdoutBuilder.AppendLine(e.Data);
                    }
                };
                process.ErrorDataReceived += (sender, e) => { };

                process.BeginOutputReadLine();
                process.BeginErrorReadLine();

                if (!process.WaitForExit(PREFIX_CHECK_TIMEOUT_MS))
                {
                    // Process may exit between WaitForExit(timeout) and Kill() (TOCTOU race)
                    try
                    {
                        process.Kill();
                        process.WaitForExit(1000);
                    }
                    catch (System.InvalidOperationException)
                    {
                        UnityEngine.Debug.Log("Process already exited before Kill() was called");
                    }

                    return null;
                }

                process.WaitForExit();

                string output = stdoutBuilder.ToString().Trim();
                if (process.ExitCode == 0 && !string.IsNullOrEmpty(output))
                {
                    return output;
                }
            }

            return null;
        }

        /// <summary>
        /// Checks whether the npm global prefix directory is writable by creating and deleting a temp file.
        /// Returns true if writable, false otherwise.
        /// </summary>
        public static bool IsGlobalPrefixWritable(string globalPrefixPath)
        {
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(globalPrefixPath), "globalPrefixPath must not be null or empty");

            try
            {
                // npm creates the prefix directory on first install, so a non-existent directory
                // does not mean non-writable — test by creating it (no-op if it already exists)
                if (!Directory.Exists(globalPrefixPath))
                {
                    Directory.CreateDirectory(globalPrefixPath);
                }

                string testFilePath = Path.Combine(
                    globalPrefixPath,
                    ".uloop_write_test_" + System.Guid.NewGuid().ToString("N").Substring(0, 8));
                File.WriteAllText(testFilePath, "");
                File.Delete(testFilePath);
                return true;
            }
            // OS permission denial cannot be pre-checked with assertions; must attempt the operation
            catch (System.UnauthorizedAccessException)
            {
                return false;
            }
            catch (IOException)
            {
                return false;
            }
            // npm prefix -g output is external input — malformed paths throw these exceptions
            // Return true (indeterminate) to skip pre-flight and let npm attempt the actual install
            catch (System.ArgumentException e)
            {
                UnityEngine.Debug.LogWarning("[uLoopMCP] Cannot validate npm global prefix path: " + e.Message);
                return true;
            }
            catch (System.NotSupportedException e)
            {
                UnityEngine.Debug.LogWarning("[uLoopMCP] Cannot validate npm global prefix path: " + e.Message);
                return true;
            }
        }

        /// <summary>
        /// Analyzes npm stderr output and returns a user-friendly guidance message.
        /// Returns null if no specific pattern is matched (caller falls back to raw error).
        /// </summary>
        public static string ClassifyInstallError(string stderrOutput, string manualCommand)
        {
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(manualCommand), "manualCommand must not be null or empty");

            if (string.IsNullOrEmpty(stderrOutput))
            {
                return null;
            }

            if (!IsPermissionError(stderrOutput))
            {
                return null;
            }

            return "npm does not have permission to write to the global directory.\n\n"
                 + BuildPermissionSolutions(manualCommand);
        }

        /// <summary>
        /// Combines classified guidance with the raw npm stderr so users see both
        /// the actionable suggestion and the original error details.
        /// </summary>
        public static string BuildInstallErrorMessage(string guidance, string rawStderr)
        {
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(guidance), "guidance must not be null or empty");
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(rawStderr), "rawStderr must not be null or empty");

            return guidance + "\n\n--- npm output ---\n" + rawStderr;
        }

        /// <summary>
        /// Builds the common "Solutions" block shared by the pre-flight dialog and
        /// the post-install error classifier.
        /// </summary>
        public static string BuildPermissionSolutions(string manualCommand)
        {
            UnityEngine.Debug.Assert(!string.IsNullOrEmpty(manualCommand), "manualCommand must not be null or empty");

            return "Solutions:\n"
                 + "1. Open a terminal as Administrator and run:\n"
                 + "   " + manualCommand + "\n\n"
                 + "2. Or change npm's global prefix to a user-writable directory:\n"
                 + "   Step 1: Open Command Prompt (cmd.exe) and run:\n"
                 + "      npm config set prefix \"%USERPROFILE%\\.npm-global\"\n"
                 + "      (PowerShell: npm config set prefix \"$env:USERPROFILE\\.npm-global\")\n"
                 + "   Step 2: Add %USERPROFILE%\\.npm-global to your PATH\n"
                 + "      (System Settings > Environment Variables > Path)";
        }

        internal static bool IsPermissionError(string stderrOutput)
        {
            UnityEngine.Debug.Assert(stderrOutput != null, "stderrOutput must not be null");

            return stderrOutput.Contains(ERROR_PATTERN_EPERM)
                || stderrOutput.Contains(ERROR_PATTERN_EACCES)
                || stderrOutput.IndexOf(ERROR_PATTERN_OPERATION_NOT_PERMITTED, System.StringComparison.OrdinalIgnoreCase) >= 0;
        }
    }
}