Release v0.3.5

Author: kihiku

docs/ref/ai-quickstart.md

@@ -23,7 +23,7 @@ Open (or restart) the Unity Editor after running this command. For contributor w
 
 ```bash
 unityctl init --project "/path/to/unity/project" --source /path/to/unityctl/src/Unityctl.Plugin
-unityctl init --project "/path/to/unity/project" --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.4"
+unityctl init --project "/path/to/unity/project" --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
 ```
 
 ### 3. Verify

docs/ref/getting-started.md

@@ -79,7 +79,7 @@ If you need a contributor-style source install instead, you can still do one of
 
 ```bash
 unityctl init --project /path/to/unity/project --source /path/to/unityctl/src/Unityctl.Plugin
-unityctl init --project /path/to/unity/project --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.4"
+unityctl init --project /path/to/unity/project --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
 ```
 
 When switching away from an older `file:` install, first run:

src/Unityctl.Mcp/Prompts/GameWorkflowPrompts.cs

@@ -155,7 +155,7 @@ 2. Confirm Unity Editor is open with the target project
             ## Step 2: Install Plugin
             3. unityctl_run(command="init") with parameters:
                - project: "/path/to/unity/project"
-               - source: "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.4"
+               - source: "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
             4. Restart Unity Editor (or wait for domain reload)
 
             ## Step 3: Verify

src/Unityctl.Plugin/Editor/Commands/PingHandler.cs

@@ -11,7 +11,7 @@ public CommandResponse Execute(CommandRequest request)
         {
             var data = new JObject
             {
-                ["version"] = "0.3.4",
+                ["version"] = "0.3.5",
 #if UNITY_EDITOR
                 ["unityVersion"] = UnityEngine.Application.unityVersion
 #endif

src/Unityctl.Plugin/Editor/Ipc/IpcServer.cs

@@ -22,6 +22,12 @@ namespace Unityctl.Plugin.Editor.Ipc
     /// </summary>
     public sealed class IpcServer
     {
+        private enum ShutdownMode
+        {
+            Graceful,
+            EditorQuit
+        }
+
         private const int MaxServerInstances = 4;
         private const int PipeBusyRetryDelayMs = 250;
         private const int ErrorPipeBusy = 231;
@@ -78,7 +84,7 @@ public void Start(string projectPath)
                 if (IsRunning && _pipeName == pipeName) return;
 
                 // Different project or not running — stop existing, start new
-                if (IsRunning) StopInternal();
+                if (IsRunning) StopInternal(ShutdownMode.Graceful);
 
                 _projectPath = projectPath;
                 _pipeName = pipeName;
@@ -111,58 +117,79 @@ public void Stop()
         {
             lock (_lock)
             {
-                StopInternal();
+                StopInternal(ShutdownMode.Graceful);
             }
         }
 
-        private void StopInternal()
+        private void StopForEditorQuit()
+        {
+            lock (_lock)
+            {
+                StopInternal(ShutdownMode.EditorQuit);
+            }
+        }
+
+        private void StopInternal(ShutdownMode shutdownMode)
         {
             if (!IsRunning) return;
 
+            var fastExit = shutdownMode == ShutdownMode.EditorQuit;
             _stopping = true;
             _shutdownCompletion.TrySetResult(true);
 
+            EditorApplication.update -= PumpMainThreadQueue;
+            AssemblyReloadEvents.beforeAssemblyReload -= OnBeforeAssemblyReload;
+            EditorApplication.quitting -= OnQuitting;
+
             // Signal watch session to stop
             if (_watchActive)
             {
-                try
+                if (!fastExit)
                 {
-                    var closeEnvelope = EventEnvelope.Create("_close", "Shutdown");
-                    _watchQueue.Enqueue(closeEnvelope);
+                    try
+                    {
+                        var closeEnvelope = EventEnvelope.Create("_close", "Shutdown");
+                        _watchQueue.Enqueue(closeEnvelope);
+                    }
+                    catch { }
                 }
-                catch { }
                 _watchActive = false;
                 _watchEventSource?.Unsubscribe();
                 _watchEventSource = null;
             }
 
             // Dispose current pipe to unblock WaitForConnection
             try { _listenPipe?.Dispose(); } catch { }
+            try { _watchPipe?.Dispose(); } catch { }
 
             foreach (var activePipe in _activePipes.Values)
             {
                 try { activePipe.Dispose(); } catch { }
             }
 
-            if (_listenThread != null && _listenThread.IsAlive)
-                _listenThread.Join(3000);
-
-            // Wait for watch writer thread to finish
-            if (_watchThread != null && _watchThread.IsAlive)
-                _watchThread.Join(2000);
+            if (!fastExit)
+            {
+                if (_listenThread != null && _listenThread.IsAlive)
+                    _listenThread.Join(3000);
 
-            EditorApplication.update -= PumpMainThreadQueue;
-            AssemblyReloadEvents.beforeAssemblyReload -= OnBeforeAssemblyReload;
-            EditorApplication.quitting -= OnQuitting;
+                // Wait for watch writer thread to finish
+                if (_watchThread != null && _watchThread.IsAlive)
+                    _watchThread.Join(2000);
+            }
 
             // Cancel and drain remaining queued requests so listener threads do not block.
             while (_mainThreadQueue.TryDequeue(out var pending))
             {
                 pending.WorkItem.Cancel();
             }
 
+            _listenPipe = null;
+            _watchPipe = null;
+            _listenThread = null;
+            _watchThread = null;
             IsRunning = false;
-            Debug.Log("[unityctl] IPC server stopped");
+            if (!fastExit)
+                Debug.Log("[unityctl] IPC server stopped");
         }
 
         private void OnBeforeAssemblyReload()
@@ -172,7 +199,7 @@ private void OnBeforeAssemblyReload()
 
         private void OnQuitting()
         {
-            Stop();
+            StopForEditorQuit();
         }
 
         /// <summary>

src/Unityctl.Plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.unityctl.bridge",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "displayName": "unityctl Bridge",
   "description": "Unity Editor bridge for unityctl CLI — enables batchmode commands and IPC communication.",
   "unity": "2021.3",

src/Unityctl.Shared/Constants.cs

@@ -10,7 +10,7 @@ public static class Constants
     private static readonly string? InformationalVersion =
         typeof(Constants).Assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
 
-    public static string Version => NormalizeVersion(InformationalVersion) ?? "0.3.4";
+    public static string Version => NormalizeVersion(InformationalVersion) ?? "0.3.5";
     public const string PipePrefix = "unityctl_";
     public const int DefaultTimeoutMs = 120_000;
     public const int PingTimeoutMs = 10_000;

tests/Unityctl.Shared.Tests/CommandSyncGuardrailTests.cs

@@ -49,6 +49,16 @@ public void WatchCommand_UsesDedicatedIpcPath_InPlugin()
         Assert.Contains("watch session started", source);
     }
 
+    [Fact]
+    public void IpcServer_UsesFastQuitShutdownPath()
+    {
+        var source = ReadRepoFile(@"src\Unityctl.Plugin\Editor\Ipc\IpcServer.cs");
+
+        Assert.Contains("private void StopForEditorQuit()", source);
+        Assert.Contains("StopInternal(ShutdownMode.EditorQuit)", source);
+        Assert.Contains("if (!fastExit)", source);
+    }
+
     [Fact]
     public void ScriptCommands_AreRegisteredAcrossCliMcpAndPlugin()
     {