@alpsckr/unitycli 0.4.4 → 0.5.0

package/unitypkg/Editor/Infrastructure/CodeExecSupport.cs

@@ -36,7 +36,7 @@ namespace UnityCli
         private static void RegisterCodeExecCommand(BridgeCommandRegistry registry)
         {
             registry.Register<UnityCli.Protocol.BridgeRequest>(
-                "code.exec",
+                "code.execute",
                 "code",
                 true,
                 60000,
@@ -49,7 +49,7 @@ namespace UnityCli
         private static string CodeExec(UnityCli.Protocol.BridgeRequest request, CancellationToken cancellationToken)
         {
             if (request.Execution != null && request.Execution.DryRun == true)
-                throw new BridgeCommandException("E_DRY_RUN_UNSUPPORTED", "Raw Bridge code.exec dry-run cannot execute or compile caller source.", "Use the public tools run code.exec --dry-run path, which returns the CLI-side source preview without Bridge dispatch.");
+                throw new BridgeCommandException("E_DRY_RUN_UNSUPPORTED", "Raw Bridge code.execute dry-run cannot execute or compile caller source.", "Use the public tools run code.execute --dry-run path, which returns the CLI-side source preview without Bridge dispatch.");
             var source = request.StringArg("sourceText");
             // raw Bridge不读取调用方路径；公开CLI已按入口deadline有界读取并内联唯一源码。
             if (string.IsNullOrWhiteSpace(source))
@@ -60,11 +60,11 @@ namespace UnityCli
             var result = ExecuteCodeSource(request, source, cancellationToken);
             WriteLog("code_exec requestId=" + request.RequestId + " ok=" + result.Ok + " exitState=" + result.ExitState);
             var serialized = SerializeCodeExecutionResult(request.RequestId, result);
-            if (result.Ok) RecordDirectCompletionEvidence(request.RequestId, "code.exec", ResolveRequestCompletionContract(request), result.Data);
+            if (result.Ok) RecordDirectCompletionEvidence(request.RequestId, "code.execute", ResolveRequestCompletionContract(request), result.Data);
             return serialized;
         }
 
-        /// <summary>所有 code.exec terminal 统一经过同一 Bridge envelope 与总 byte 上限。</summary>
+        /// <summary>所有 code.execute terminal 统一经过同一 Bridge envelope 与总 byte 上限。</summary>
         private static string SerializeCodeExecutionResult(string requestId, CodeExecutionResult result)
         {
             object envelope = result.Ok

package/unitypkg/Editor/Infrastructure/UnityCliAdmission.cs

@@ -1398,7 +1398,7 @@ namespace UnityCli
         /// <summary>root观察不确定时用队列冻结身份建立可执行Recovery marker；候选缺失时继续保留WorkItem。</summary>
         private static AdmissionTransferResult PersistWorkItemRecoveryAfterTransferFailure(BridgeQueueState state, BridgeWorkItem item, AdmissionOwnerIdentity identity, string command, string response)
         {
-            if (identity == null || (!AdmissionDurableRootCommand(command) && command != "project-tool.run" && command != "code.exec"))
+            if (identity == null || (!AdmissionDurableRootCommand(command) && command != "catalog.editor.run" && command != "code.execute"))
                 return AdmissionTransferResult.TransferPending;
             try
             {
@@ -1439,7 +1439,7 @@ namespace UnityCli
         private static AdmissionTransferResult TransferAdmissionAfterAcceptedWork(BridgeQueueState state, BridgeWorkItem item, AdmissionOwnerIdentity identity, string command, string response)
         {
             if (identity == null) return AdmissionTransferResult.NotAccepted;
-            var directMutation = command == "project-tool.run" || command == "code.exec";
+            var directMutation = command == "catalog.editor.run" || command == "code.execute";
             if (!AdmissionDurableRootCommand(command) && !directMutation) return AdmissionTransferResult.NotAccepted;
             string markerScope;
             string rootScope;
@@ -1733,7 +1733,7 @@ namespace UnityCli
                     if (command == "internal.test.run.cancel") return false;
                     bool ownsLease;
                     if (!queueState.TryIsLeaseOwned(identity.RequestId, identity.RequestDigest, out ownsLease)) return false;
-                    if (command == "project-tool.run" || command == "code.exec")
+                    if (command == "catalog.editor.run" || command == "code.execute")
                     {
                         durable = ownsLease;
                         return true;
@@ -1769,7 +1769,7 @@ namespace UnityCli
         /// <summary>deadline之后仍允许同字节direct request读取已发布terminal，不入队也不重新占slot。</summary>
         private static string AdmissionRecoveredDirectTerminal(UnityCli.Protocol.BridgeRequest request, byte[] rawRequestBytes)
         {
-            if (request == null || rawRequestBytes == null || (request.Command != "code.exec" && request.Command != "project-tool.run")) return null;
+            if (request == null || rawRequestBytes == null || (request.Command != "code.execute" && request.Command != "catalog.editor.run")) return null;
             var digest = UnityCliRequestDigest.Compute(rawRequestBytes, request.InstanceId);
             object terminal;
             if (!UnityCliActiveOperation.TryGetTerminal("direct-mutation", request.RequestId, digest, out terminal)) return null;
@@ -1801,8 +1801,8 @@ namespace UnityCli
                 case "internal.test.run.cancel": return "test-cancel";
                 case "internal.navmesh.bake.start": return "navmesh-bake";
                 case "internal.occlusion.bake.start": return "occlusion-bake";
-                case "project-tool.run":
-                case "code.exec":
+                case "catalog.editor.run":
+                case "code.execute":
                     return "direct-mutation";
                 default:
                     return null;
@@ -1833,7 +1833,7 @@ namespace UnityCli
                 || command == "internal.package.embed.start" || command == "internal.package.resolve.start"
                 || command == "internal.test.run.start" || command == "internal.test.run.cancel"
                 || command == "internal.navmesh.bake.start" || command == "internal.occlusion.bake.start"
-                || command == "project-tool.run" || command == "code.exec";
+                || command == "catalog.editor.run" || command == "code.execute";
         }
 
         private static string AdmissionAcceptedTopDigest(BridgeQueueState state, string response, AdmissionOwnerIdentity identity, string command)
@@ -1867,7 +1867,7 @@ namespace UnityCli
                 || UnityCliPackageEmbedCoordinator.IsCommand(command) || UnityCliPackageResolveCoordinator.IsCommand(command)
                 || UnityCliTestRunCoordinator.IsCommand(command) || UnityCliNavMeshBakeCoordinator.IsCommand(command)
                 || UnityCliOcclusionBakeCoordinator.IsCommand(command)
-                || command == "project-tool.run" || command == "code.exec";
+                || command == "catalog.editor.run" || command == "code.execute";
         }
 
         private static bool AdmissionBypassCommand(string command)
@@ -1875,15 +1875,15 @@ namespace UnityCli
             if (IsDoctorAdmissionBypassCommand(command)) return true;
             switch (command)
             {
-                case "project-tool.health":
-                case "project-tool.groups":
-                case "project-tool.summary":
-                case "project-tool.describe":
-                case "project-tool.list":
-                case "runtime-tool.groups":
-                case "runtime-tool.summary":
-                case "runtime-tool.describe":
-                case "runtime-tool.list":
+                case "catalog.editor.health":
+                case "catalog.editor.groups":
+                case "catalog.editor.summary":
+                case "catalog.editor.describe":
+                case "catalog.editor.list":
+                case "catalog.player.groups":
+                case "catalog.player.summary":
+                case "catalog.player.describe":
+                case "catalog.player.list":
                 case "internal.editor.state.snapshot":
                 case "internal.editor.compile.status":
                 case "internal.editor.refresh.status":

package/unitypkg/Editor/Infrastructure/UnityCliCompileCoordinator.cs

@@ -6,7 +6,6 @@ using System.IO;
 using System.Linq;
 using System.Text;
 using UnityEditor;
-using UnityEditor.Compilation;
 using UnityCli.Protocol;
 
 namespace UnityCli
@@ -31,30 +30,36 @@ namespace UnityCli
                 }
                 protected override void ValidateLoadedRoot(Dictionary<string, object> root)
                 {
-                    ValidateRootContract(root, new[] { "sequence", "runId", "refresh", "path", "forceUpdate", "importRecursive", "includeWarnings", "diagnostics", "diagnosticErrorCount", "diagnosticWarningCount", "diagnosticInfoCount", "diagnosticsTruncated", "startedCycle", "startedAt", "finishedAt", "reloadObserved", "rootContractDigest" },
+                    ValidateRootContract(root, new[] { "sequence", "runId", "refresh", "path", "forceUpdate", "importRecursive", "includeWarnings", "compilationObserved", "compileObservationSequence", "startedSequence", "diagnostics", "diagnosticErrorCount", "diagnosticWarningCount", "diagnosticInfoCount", "diagnosticsTruncated", "stableFrames", "startedCycle", "startedAt", "finishedAt", "reloadObserved", "rootContractDigest" },
                         "queued", "prepared", "dispatching", "awaiting_started", "compiling", "cycle_finished");
-                    object sequence; object refresh; object forceUpdate; object recursive; object warnings; object diagnostics; object errorCount; object warningCount; object infoCount; object truncated;
+                    object sequence; object refresh; object forceUpdate; object recursive; object warnings; object observed; object diagnostics; object errorCount; object warningCount; object infoCount; object truncated; object stableFrames;
                     if (!root.TryGetValue("sequence", out sequence) || !(sequence is long) || (long)sequence <= 0
                         || string.IsNullOrWhiteSpace(Text(root, "runId"))
                         || !root.TryGetValue("refresh", out refresh) || !(refresh is bool)
                         || !root.TryGetValue("forceUpdate", out forceUpdate) || !(forceUpdate is bool)
                         || !root.TryGetValue("importRecursive", out recursive) || !(recursive is bool)
                         || !root.TryGetValue("includeWarnings", out warnings) || !(warnings is bool)
+                        || !root.TryGetValue("compilationObserved", out observed) || !(observed is bool)
+                        || !root.TryGetValue("compileObservationSequence", out sequence) || !(sequence is long) || (long)sequence < 0
+                        || !root.TryGetValue("startedSequence", out sequence) || !(sequence is long) || (long)sequence < 0
                         || !root.TryGetValue("diagnostics", out diagnostics) || !(diagnostics is List<object>)
                         || !root.TryGetValue("diagnosticErrorCount", out errorCount) || !(errorCount is long) || (long)errorCount < 0 || (long)errorCount > 1000000
                         || !root.TryGetValue("diagnosticWarningCount", out warningCount) || !(warningCount is long) || (long)warningCount < 0 || (long)warningCount > 1000000
                         || !root.TryGetValue("diagnosticInfoCount", out infoCount) || !(infoCount is long) || (long)infoCount < 0 || (long)infoCount > 1000000
-                        || !root.TryGetValue("diagnosticsTruncated", out truncated) || !(truncated is long) || (long)truncated < 0 || (long)truncated > 1000000)
+                        || !root.TryGetValue("diagnosticsTruncated", out truncated) || !(truncated is long) || (long)truncated < 0 || (long)truncated > 1000000
+                        || !root.TryGetValue("stableFrames", out stableFrames) || !(stableFrames is long) || (long)stableFrames < 0
+                        || string.IsNullOrWhiteSpace(Text(root, "startedAt")))
                         throw new InvalidDataException("Compile active root fields are invalid.");
                     if (!string.Equals(Text(root, "rootContractDigest"), CompileRootContractDigest(root), StringComparison.Ordinal))
                         throw new InvalidDataException("Compile immutable root contract changed.");
                     ValidateBoundedDiagnostics(root, "diagnostics", "diagnosticErrorCount", "diagnosticWarningCount", "diagnosticInfoCount", "diagnosticsTruncated", (bool)warnings);
                     var phase = Text(root, "phase");
-                    var fenced = HasExactEffectFence("compile", root, "compile-dispatch");
+                    var fenced = HasExactEffectFence("compile", root, "asset-refresh-dispatch");
                     if ((phase == "queued" || phase == "prepared") == fenced)
                         throw new InvalidDataException("Compile effect fence is inconsistent with phase.");
-                    if ((phase == "compiling" || phase == "cycle_finished")
-                        && (Long(root, "startedCycle") <= 0 || string.IsNullOrWhiteSpace(Text(root, "startedAt"))))
+                    if ((bool)observed != (phase == "compiling" || phase == "cycle_finished"))
+                        throw new InvalidDataException("Compile observation state is inconsistent with phase.");
+                    if ((bool)observed && (Long(root, "startedCycle") <= 0 || Long(root, "startedSequence") <= Long(root, "compileObservationSequence")))
                         throw new InvalidDataException("Compile active cycle identity is invalid.");
                 }
 
@@ -67,11 +72,20 @@ namespace UnityCli
                     });
                 }
 
-                protected override object Planned(object value) { return new Dictionary<string, object> { { "plannedEffects", new List<object> { new Dictionary<string, object> { { "type", "script-compile" } } } } }; }
+                protected override object Planned(object value)
+                {
+                    var args = (StartArgs)value;
+                    var effects = new List<object>();
+                    if (!string.IsNullOrEmpty(args.Path)) effects.Add(new Dictionary<string, object> { { "type", "asset-import" }, { "path", args.Path } });
+                    else effects.Add(new Dictionary<string, object> { { "type", "asset-refresh" } });
+                    effects.Add(new Dictionary<string, object> { { "type", "script-compile" } });
+                    effects.Add(new Dictionary<string, object> { { "type", "domain-reload" } });
+                    return new Dictionary<string, object> { { "plannedEffects", effects } };
+                }
                 protected override Dictionary<string, object> CreateRoot(BridgeRequest request, string digest, object value)
                 {
                     var args = (StartArgs)value;
-                    var root = new Dictionary<string, object> { { "requestId", request.RequestId }, { "editorSessionId", EditorSessionId() }, { "requestDigest", digest }, { "deadline", request.Execution.AbsoluteDeadlineUtc }, { "phase", "queued" }, { "sequence", NextSequenceLocked() }, { "runId", "compile-" + digest.Substring(0, 32) }, { "refresh", args.Refresh ?? true }, { "path", args.Path }, { "forceUpdate", args.ForceUpdate ?? false }, { "importRecursive", args.ImportRecursive ?? false }, { "includeWarnings", args.IncludeWarnings ?? true }, { "diagnostics", new List<object>() }, { "diagnosticErrorCount", 0L }, { "diagnosticWarningCount", 0L }, { "diagnosticInfoCount", 0L }, { "diagnosticsTruncated", 0L } };
+                    var root = new Dictionary<string, object> { { "requestId", request.RequestId }, { "editorSessionId", EditorSessionId() }, { "requestDigest", digest }, { "deadline", request.Execution.AbsoluteDeadlineUtc }, { "phase", "queued" }, { "sequence", NextSequenceLocked() }, { "runId", "compile-" + digest.Substring(0, 32) }, { "refresh", string.IsNullOrEmpty(args.Path) }, { "path", args.Path }, { "forceUpdate", args.ForceUpdate ?? false }, { "importRecursive", args.ImportRecursive ?? false }, { "includeWarnings", args.IncludeWarnings ?? true }, { "compilationObserved", false }, { "compileObservationSequence", 0L }, { "startedSequence", 0L }, { "diagnostics", new List<object>() }, { "diagnosticErrorCount", 0L }, { "diagnosticWarningCount", 0L }, { "diagnosticInfoCount", 0L }, { "diagnosticsTruncated", 0L }, { "stableFrames", 0L }, { "startedAt", DateTime.UtcNow.ToString("O", CultureInfo.InvariantCulture) }, { "reloadObserved", false } };
                     root["rootContractDigest"] = CompileRootContractDigest(root);
                     return root;
                 }
@@ -81,6 +95,14 @@ namespace UnityCli
                     var phase = Text(root, "phase");
                     if (phase == "queued") { Update(x => x["phase"] = "prepared"); return; }
                     if (phase == "prepared") { if (!EditorApplication.isCompiling && !EditorApplication.isUpdating && !IsDomainReloading()) Dispatch(root); return; }
+                    if (phase == "awaiting_started" && !EditorApplication.isCompiling && !EditorApplication.isUpdating && !IsDomainReloading())
+                    {
+                        var frames = Long(root, "stableFrames") + 1L;
+                        root["stableFrames"] = frames;
+                        Update(x => x["stableFrames"] = frames);
+                        if (frames >= 3L) Complete(root);
+                        return;
+                    }
                     if (phase == "cycle_finished" && !EditorApplication.isCompiling && !EditorApplication.isUpdating && !IsDomainReloading()) Complete(root);
                 }
                 protected override object BuildSuccessData(Dictionary<string, object> root)
@@ -90,17 +112,30 @@ namespace UnityCli
                     var assemblies = typed.Where(x => !string.IsNullOrEmpty(Text(x, "assembly"))).Select(x => Text(x, "assembly")).Distinct(StringComparer.Ordinal).Count();
                     var startedAt = Text(root, "startedAt"); var finishedAt = DateTime.UtcNow.ToString("O", CultureInfo.InvariantCulture);
                     var durationMs = DateTimeOffset.TryParse(startedAt, out var started) ? (long)Math.Max(0, (DateTimeOffset.UtcNow - started).TotalMilliseconds) : 0L;
-                    var refresh = Bool(root, "refresh"); var path = string.IsNullOrEmpty(Text(root, "path")) ? null : Text(root, "path");
-                    var compile = new Dictionary<string, object> { { "completed", true }, { "refresh", refresh }, { "path", path }, { "startedAt", startedAt }, { "finishedAt", finishedAt }, { "durationMs", durationMs }, { "assemblyCount", (long)assemblies }, { "errorCount", (long)errors }, { "warningCount", (long)warnings }, { "status", warnings > 0 ? "warnings" : "clean" } };
-                    var effects = new List<object>(); if (path != null) effects.Add(new Dictionary<string, object> { { "type", "asset-import" }, { "path", path } }); else if (refresh) effects.Add(new Dictionary<string, object> { { "type", "asset-refresh" } }); effects.Add(new Dictionary<string, object> { { "type", "script-compile" } }); effects.Add(new Dictionary<string, object> { { "type", "domain-reload" } });
+                    var refresh = Bool(root, "refresh"); var path = string.IsNullOrEmpty(Text(root, "path")) ? null : Text(root, "path"); var compilationTriggered = Bool(root, "compilationObserved");
+                    var status = compilationTriggered ? (warnings > 0 ? "warnings" : "clean") : "unchanged";
+                    var compile = new Dictionary<string, object> { { "completed", true }, { "compilationTriggered", compilationTriggered }, { "noOpReason", compilationTriggered ? null : "no-script-changes" }, { "refresh", refresh }, { "path", path }, { "startedAt", startedAt }, { "finishedAt", finishedAt }, { "durationMs", durationMs }, { "assemblyCount", (long)assemblies }, { "errorCount", (long)errors }, { "warningCount", (long)warnings }, { "status", status } };
+                    var effects = new List<object>(); if (path != null) effects.Add(new Dictionary<string, object> { { "type", "asset-import" }, { "path", path } }); else if (refresh) effects.Add(new Dictionary<string, object> { { "type", "asset-refresh" } }); if (compilationTriggered) { effects.Add(new Dictionary<string, object> { { "type", "script-compile" } }); effects.Add(new Dictionary<string, object> { { "type", "domain-reload" } }); }
                     var state = new Dictionary<string, object> { { "status", "ready" }, { "compile", new Dictionary<string, object> { { "known", true }, { "value", false } } }, { "import", new Dictionary<string, object> { { "known", true }, { "value", false } } }, { "playMode", new Dictionary<string, object> { { "known", true }, { "value", EditorApplication.isPlaying ? "play" : "edit" } } } };
                     return new Dictionary<string, object> { { "compile", compile }, { "diagnostics", diagnostics }, { "editorState", state }, { "plannedEffects", effects } };
                 }
+                /// <summary>刷新前冻结事件序号；刷新后的编译是否发生完全由 Unity Asset Pipeline 决定。</summary>
                 private void Dispatch(Dictionary<string, object> root)
                 {
                     var id = Text(root, "requestId"); if (!string.IsNullOrEmpty(activeDispatchRequestId)) return; activeDispatchRequestId = id;
-                    try { root = CrossEffectFence(root, "compile-dispatch", "dispatching"); var path = Text(root, "path"); if (!string.IsNullOrEmpty(path)) AssetDatabase.ImportAsset(path); else if (Bool(root, "refresh")) AssetDatabase.Refresh(Bool(root, "forceUpdate") ? ImportAssetOptions.ForceUpdate : ImportAssetOptions.Default); if (!EditorApplication.isCompiling) CompilationPipeline.RequestScriptCompilation(); Update(x => { if (Text(x, "phase") == "dispatching") x["phase"] = "awaiting_started"; }); }
-                    catch (Exception e) { Fail(root, "E_EXECUTION_TIMEOUT", "Compilation dispatch result cannot be confirmed: " + e.Message + "; check the business state."); }
+                    try
+                    {
+                        var observationSequence = UnityCliCompilationEventBroker.CurrentCompilationEventSequence();
+                        if (UnityCliCompilationEventBroker.SequenceCorrupt) throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Compilation event sequence is corrupt; refresh is forbidden.");
+                        Update(x => { x["compileObservationSequence"] = observationSequence; x["stableFrames"] = 0L; });
+                        root["compileObservationSequence"] = observationSequence;
+                        root = CrossEffectFence(root, "asset-refresh-dispatch", "dispatching");
+                        var path = Text(root, "path");
+                        if (!string.IsNullOrEmpty(path)) AssetDatabase.ImportAsset(path);
+                        else AssetDatabase.Refresh(Bool(root, "forceUpdate") ? ImportAssetOptions.ForceUpdate : ImportAssetOptions.Default);
+                        Update(x => { if (Text(x, "phase") == "dispatching") x["phase"] = "awaiting_started"; });
+                    }
+                    catch (Exception e) { Fail(root, "E_EXECUTION_TIMEOUT", "Compilation refresh result cannot be confirmed: " + e.Message + "; check the business state."); }
                     finally { activeDispatchRequestId = null; }
                 }
                 private void Complete(Dictionary<string, object> root) { if (Long(root, "diagnosticErrorCount") > 0) Fail(root, "E_UNITY_COMPILE_FAILED", "Unity reported compiler errors.", BuildCompileFailureDetails(root), new[] { "Fix the listed compiler diagnostics before retrying." }); else Succeed(root); }
@@ -108,13 +143,13 @@ namespace UnityCli
                 {
                     return new Dictionary<string, object>
                     {
-                        { "compile", new Dictionary<string, object> { { "completed", true }, { "errorCount", Long(root, "diagnosticErrorCount") }, { "warningCount", Long(root, "diagnosticWarningCount") }, { "status", "errors" }, { "diagnosticsTruncated", Long(root, "diagnosticsTruncated") } } },
+                        { "compile", new Dictionary<string, object> { { "completed", true }, { "compilationTriggered", true }, { "noOpReason", null }, { "errorCount", Long(root, "diagnosticErrorCount") }, { "warningCount", Long(root, "diagnosticWarningCount") }, { "status", "errors" }, { "diagnosticsTruncated", Long(root, "diagnosticsTruncated") } } },
                         { "diagnostics", root["diagnostics"] }
                     };
                 }
                 internal void BeforeReload() { Update(x => x["reloadObserved"] = true); }
                 internal long CurrentOwnedCycle() { var root = Load(); return root != null && UnityCliSessionMutationLease.IsOwnedBy(Text(root, "requestId"), Text(root, "requestDigest")) ? Long(root, "startedCycle") : 0; }
-                internal void OnCompilationStarted(long cycle, DateTime startedAt) { Update(x => { if (Text(x, "phase") == "dispatching" || Text(x, "phase") == "awaiting_started") { x["startedCycle"] = cycle; x["startedAt"] = startedAt.ToString("O", CultureInfo.InvariantCulture); x["phase"] = "compiling"; } }); }
+                internal void OnCompilationStarted(long cycle, long sequence, DateTime startedAt) { Update(x => { if ((Text(x, "phase") == "dispatching" || Text(x, "phase") == "awaiting_started") && sequence > Long(x, "compileObservationSequence")) { x["startedCycle"] = cycle; x["startedSequence"] = sequence; x["compilationObserved"] = true; x["stableFrames"] = 0L; x["phase"] = "compiling"; } }); }
                 internal void OnAssemblyCompilationFinished(long cycle, List<Dictionary<string, object>> diagnostics) { Update(x => { if (Text(x, "phase") == "compiling" && Long(x, "startedCycle") == cycle) AppendBoundedDiagnostics(x, "diagnostics", "diagnosticErrorCount", "diagnosticWarningCount", "diagnosticInfoCount", "diagnosticsTruncated", Bool(x, "includeWarnings"), diagnostics); }); }
                 internal void OnCompilationFinished(long cycle, DateTime finishedAt) { Update(x => { if (Text(x, "phase") == "compiling" && Long(x, "startedCycle") == cycle) { x["finishedAt"] = finishedAt.ToString("O", CultureInfo.InvariantCulture); x["phase"] = "cycle_finished"; } }); }
             }
@@ -128,51 +163,25 @@ namespace UnityCli
             internal static void BeforeReload() { operation.BeforeReload(); }
             internal static void Tick() { operation.Tick(); }
             internal static long CurrentOwnedCycle() { return operation.CurrentOwnedCycle(); }
-            internal static void RequestRefreshCompilation(string requestId, string requestDigest)
-            {
-                if (!UnityCliSessionMutationLease.IsOwnedBy(requestId, requestDigest)) throw new BridgeCommandException("E_UNITY_BUSY", "Refresh root does not own the exact mutation lease.");
-                var dispatchSequence = UnityCliCompilationEventBroker.CurrentCompilationEventSequence();
-                if (UnityCliCompilationEventBroker.SequenceCorrupt)
-                    throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh compilation sequence is corrupt; dispatch is forbidden.");
-                var refreshRoot = UnityCliActiveOperation.Load("refresh");
-                if (refreshRoot == null || Text(refreshRoot, "requestId") != requestId || Text(refreshRoot, "requestDigest") != requestDigest)
-                    throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh compilation root identity cannot be proven.");
-                if (UnityCliReloadOperation.HasExactEffectFence("refresh", refreshRoot, "compile-dispatch"))
-                    throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh compilation effect fence was already crossed.");
-                UnityCliReloadOperation.WriteEffectFence("refresh", refreshRoot, "compile-dispatch");
-                UpdateRefresh(requestId, requestDigest, x =>
-                {
-                    if (!Bool(x, "compile") || Bool(x, "compilationRequested") || Text(x, "phase") != "refresh_returned")
-                        throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh compilation dispatch state is invalid.");
-                    x["compilationRequested"] = true; x["compileDispatchSequence"] = dispatchSequence; x["compilePhase"] = "dispatching";
-                });
-                var confirmed = UnityCliActiveOperation.Load("refresh");
-                if (confirmed == null || Text(confirmed, "requestId") != requestId || Text(confirmed, "requestDigest") != requestDigest
-                    || Text(confirmed, "compilePhase") != "dispatching" || !UnityCliReloadOperation.HasExactEffectFence("refresh", confirmed, "compile-dispatch"))
-                    throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh compilation post-fence state cannot be confirmed.");
-                if (!UnityCliSessionMutationLease.IsOwnedBy(requestId, requestDigest)) throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Refresh lost its exact lease before compilation dispatch.");
-                CompilationPipeline.RequestScriptCompilation();
-                UpdateRefresh(requestId, requestDigest, x => { if (Text(x, "compilePhase") == "dispatching") x["compilePhase"] = "awaiting_started"; });
-            }
             internal static void OnCompilationStarted(long cycle, long sequence, DateTime startedAt)
             {
-                operation.OnCompilationStarted(cycle, startedAt);
-                UpdateRefresh(null, null, x =>
+                operation.OnCompilationStarted(cycle, sequence, startedAt);
+                UpdateRefresh(x =>
                 {
                     var phase = Text(x, "compilePhase");
-                    if (Bool(x, "compile") && Bool(x, "compilationRequested")
-                        && (phase == "dispatching" || phase == "awaiting_started")
-                        && sequence > Long(x, "compileDispatchSequence"))
+                    if (Bool(x, "compile") && Bool(x, "compilationObservationStarted")
+                        && phase == "awaiting_started"
+                        && sequence > Long(x, "compileObservationSequence"))
                     {
                         x["compileStartedCycle"] = cycle; x["compileStartedSequence"] = sequence;
-                        x["compilePhase"] = "compiling"; x["compilationObserved"] = true;
+                        x["compilePhase"] = "compiling"; x["compilationObserved"] = true; x["stableFrames"] = 0L;
                     }
                 });
             }
             internal static void OnAssemblyCompilationFinished(long cycle, long sequence, string assembly, List<Dictionary<string, object>> diagnostics)
             {
                 operation.OnAssemblyCompilationFinished(cycle, diagnostics);
-                UpdateRefresh(null, null, x =>
+                UpdateRefresh(x =>
                 {
                     if (Text(x, "compilePhase") == "compiling" && Long(x, "compileStartedCycle") == cycle
                         && sequence > Long(x, "compileStartedSequence"))
@@ -182,19 +191,17 @@ namespace UnityCli
             internal static void OnCompilationFinished(long cycle, long sequence, DateTime finishedAt)
             {
                 operation.OnCompilationFinished(cycle, finishedAt);
-                UpdateRefresh(null, null, x =>
+                UpdateRefresh(x =>
                 {
                     if (Text(x, "compilePhase") == "compiling" && Long(x, "compileStartedCycle") == cycle
                         && sequence > Long(x, "compileStartedSequence"))
                     { x["compileFinishedSequence"] = sequence; x["compilePhase"] = "cycle_finished"; }
                 });
             }
-            private static void UpdateRefresh(string id, string digest, Action<Dictionary<string, object>> action)
+            private static void UpdateRefresh(Action<Dictionary<string, object>> action)
             {
                 if (!UnityCliActiveOperation.Exists("refresh")) return;
                 var root = UnityCliActiveOperation.Load("refresh");
-                if (id != null && Text(root, "requestId") != id) return;
-                if (digest != null && Text(root, "requestDigest") != digest) throw new BridgeCommandException("E_REQUEST_ID_REUSED", "Refresh request identity changed during compilation dispatch.");
                 if (!UnityCliSessionMutationLease.IsOwnedBy(Text(root, "requestId"), Text(root, "requestDigest"))) return;
                 action(root);
                 UnityCliActiveOperation.Save("refresh", root);
@@ -264,7 +271,7 @@ namespace UnityCli
             private static string Text(IDictionary<string, object> value, string key) { object item; return value != null && value.TryGetValue(key, out item) && item != null ? Convert.ToString(item, CultureInfo.InvariantCulture) : string.Empty; }
             private static bool Bool(IDictionary<string, object> value, string key) { object item; return value != null && value.TryGetValue(key, out item) && item is bool && (bool)item; }
             private static long Long(IDictionary<string, object> value, string key) { long result; return long.TryParse(Text(value, key), out result) ? result : 0; }
-            private sealed class StartArgs { public bool? Refresh { get; set; } public string Path { get; set; } public bool? ForceUpdate { get; set; } public bool? ImportRecursive { get; set; } public bool? IncludeWarnings { get; set; } public string ExpectedEditorSessionId { get; set; } }
+            private sealed class StartArgs { public string Path { get; set; } public bool? ForceUpdate { get; set; } public bool? ImportRecursive { get; set; } public bool? IncludeWarnings { get; set; } public string ExpectedEditorSessionId { get; set; } }
         }
     }
 }

package/unitypkg/Editor/Infrastructure/UnityCliJson.cs

@@ -12,24 +12,6 @@ namespace UnityCli
 {
     public static partial class UnityCliBridge
     {
-        private static List<object> CapabilitiesData()
-        {
-            return new List<object> {
-                CapabilityData("camera", CameraCommands), CapabilityData("scene", SceneCommands), CapabilityData("go", GameObjectCommands), CapabilityData("asset", AssetCommands),
-                CapabilityData("screenshot", ScreenshotCommands), CapabilityData("prefab", PrefabCommands), CapabilityData("ui", UiCommands),
-                CapabilityData("material", MaterialCommands), CapabilityData("graphics", GraphicsCommands), CapabilityData("physics", PhysicsCommands), CapabilityData("scriptable-object", ScriptableObjectCommands),
-                CapabilityData("profiler", ProfilerCommands), CapabilityData("animation", AnimationCommands), CapabilityData("shader", ShaderCommands), CapabilityData("texture", TextureCommands),
-                CapabilityData("editor", EditorCommands), CapabilityData("code", CodeCommands), CapabilityData("project-tool", ProjectToolCommands), CapabilityData("runtime-tool", RuntimeToolCommands)
-            };
-        }
-
-        private static bool IsMutatingCommand(string command) => CommandRegistry.IsMutating(command);
-
-        private static Dictionary<string, object> CapabilityData(string domain, string[] commands)
-        {
-            return new Dictionary<string, object> { { "domain", domain }, { "route", "POST /bridge/execute" }, { "commands", (commands ?? Array.Empty<string>()).Cast<object>().ToList() } };
-        }
-
         private static string HierarchyPath(GameObject gameObject)
         {
             var names = new Stack<string>();

package/unitypkg/Editor/Infrastructure/UnityCliLiveRefreshCoordinator.cs

@@ -47,14 +47,18 @@ namespace UnityCli
                 {
                     ValidateRootContract(root, new[]
                     {
-                        "compile", "compilationRequested", "compilationObserved", "compilePhase", "compileDispatchSequence", "compileStartedSequence", "compileFinishedSequence", "compileStartedCycle",
+                        "compile", "compilationObservationStarted", "compilationObserved", "compilePhase", "compileObservationSequence", "compileStartedSequence", "compileFinishedSequence", "compileStartedCycle",
                         "compileDiagnostics", "compileErrorCount", "compileWarningCount", "compileInfoCount", "compileDiagnosticsTruncated", "stableFrames",
                         "beforeDependencyGeneration", "beforeProcessedGeneration", "importObserved", "reloadObserved", "rootContractDigest"
                     }, "queued", "prepared", "dispatching", "refresh_returned", "waiting_stable");
-                    object compile; object requested; object observed; object diagnostics; object errorCount; object warningCount; object infoCount; object truncated; object stableFrames;
+                    object compile; object observationStarted; object observed; object sequence; object diagnostics; object errorCount; object warningCount; object infoCount; object truncated; object stableFrames;
                     if (!root.TryGetValue("compile", out compile) || !(compile is bool)
-                        || !root.TryGetValue("compilationRequested", out requested) || !(requested is bool)
+                        || !root.TryGetValue("compilationObservationStarted", out observationStarted) || !(observationStarted is bool)
                         || !root.TryGetValue("compilationObserved", out observed) || !(observed is bool)
+                        || !root.TryGetValue("compileObservationSequence", out sequence) || !(sequence is long) || (long)sequence < 0L
+                        || !root.TryGetValue("compileStartedSequence", out sequence) || !(sequence is long) || (long)sequence < 0L
+                        || !root.TryGetValue("compileFinishedSequence", out sequence) || !(sequence is long) || (long)sequence < 0L
+                        || !root.TryGetValue("compileStartedCycle", out sequence) || !(sequence is long) || (long)sequence < 0L
                         || !root.TryGetValue("compileDiagnostics", out diagnostics) || !(diagnostics is List<object>)
                         || !root.TryGetValue("compileErrorCount", out errorCount) || !(errorCount is long) || (long)errorCount < 0L || (long)errorCount > 1000000L
                         || !root.TryGetValue("compileWarningCount", out warningCount) || !(warningCount is long) || (long)warningCount < 0L || (long)warningCount > 1000000L
@@ -68,14 +72,16 @@ namespace UnityCli
                     if (!string.Equals(Text(root, "rootContractDigest"), RefreshRootContractDigest(root), StringComparison.Ordinal)) throw new InvalidDataException("Refresh immutable root contract changed.");
                     UnityCliCompileCoordinator.ValidateBoundedDiagnostics(root, "compileDiagnostics", "compileErrorCount", "compileWarningCount", "compileInfoCount", "compileDiagnosticsTruncated", true);
                     var compilePhase = Text(root, "compilePhase");
-                    if (Array.IndexOf(new[] { "idle", "dispatching", "awaiting_started", "compiling", "cycle_finished" }, compilePhase) < 0) throw new InvalidDataException("Refresh compile phase is invalid.");
+                    if (Array.IndexOf(new[] { "idle", "awaiting_started", "compiling", "cycle_finished" }, compilePhase) < 0) throw new InvalidDataException("Refresh compile phase is invalid.");
                     var refreshFenced = HasExactEffectFence("refresh", root, "refresh-dispatch");
                     var phase = Text(root, "phase");
                     if ((phase == "queued" || phase == "prepared") == refreshFenced) throw new InvalidDataException("Refresh effect fence is inconsistent with phase.");
-                    var compileFenced = HasExactEffectFence("refresh", root, "compile-dispatch");
-                    if ((compilePhase == "idle") == compileFenced) throw new InvalidDataException("Refresh compile fence is inconsistent with phase.");
-                    if (Bool(root, "compilationObserved") && (Long(root, "compileStartedCycle") <= 0L || Long(root, "compileStartedSequence") <= Long(root, "compileDispatchSequence")))
+                    if ((bool)observationStarted != ((bool)compile && compilePhase != "idle")) throw new InvalidDataException("Refresh compile observation state is inconsistent.");
+                    if ((bool)observed != (compilePhase == "compiling" || compilePhase == "cycle_finished")) throw new InvalidDataException("Refresh compile observed state is inconsistent with phase.");
+                    if ((bool)observed && (Long(root, "compileStartedCycle") <= 0L || Long(root, "compileStartedSequence") <= Long(root, "compileObservationSequence")))
                         throw new InvalidDataException("Refresh compile attribution is invalid.");
+                    if (compilePhase == "cycle_finished" && Long(root, "compileFinishedSequence") <= Long(root, "compileStartedSequence"))
+                        throw new InvalidDataException("Refresh compile finish attribution is invalid.");
                 }
 
                 private static string RefreshRootContractDigest(Dictionary<string, object> root)
@@ -101,8 +107,8 @@ namespace UnityCli
                     var root = new Dictionary<string, object>
                     {
                         { "requestId", request.RequestId }, { "editorSessionId", EditorSessionId() }, { "requestDigest", digest }, { "deadline", request.Execution.AbsoluteDeadlineUtc },
-                        { "phase", "queued" }, { "compile", args.Compile }, { "compilationRequested", false }, { "compilationObserved", false }, { "compilePhase", "idle" },
-                        { "compileDispatchSequence", 0L }, { "compileStartedSequence", 0L }, { "compileFinishedSequence", 0L }, { "compileStartedCycle", 0L },
+                        { "phase", "queued" }, { "compile", args.Compile }, { "compilationObservationStarted", false }, { "compilationObserved", false }, { "compilePhase", "idle" },
+                        { "compileObservationSequence", 0L }, { "compileStartedSequence", 0L }, { "compileFinishedSequence", 0L }, { "compileStartedCycle", 0L },
                         { "compileDiagnostics", new List<object>() }, { "compileErrorCount", 0L }, { "compileWarningCount", 0L }, { "compileInfoCount", 0L }, { "compileDiagnosticsTruncated", 0L },
                         { "stableFrames", 0L }, { "beforeDependencyGeneration", before.DependencyGeneration }, { "beforeProcessedGeneration", before.ProcessedGeneration },
                         { "importObserved", false }, { "reloadObserved", false }
@@ -119,24 +125,22 @@ namespace UnityCli
                     if (phase == "queued") { if (BusyEditor()) return; Update(value => value["phase"] = "prepared"); return; }
                     if (phase == "prepared")
                     {
+                        if (Bool(root, "compile"))
+                        {
+                            var observationSequence = UnityCliCompilationEventBroker.CurrentCompilationEventSequence();
+                            if (UnityCliCompilationEventBroker.SequenceCorrupt) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh compilation event sequence is corrupt; attributed outcome is unknown."); return; }
+                            Update(value => { value["compilationObservationStarted"] = true; value["compileObservationSequence"] = observationSequence; value["compilePhase"] = "awaiting_started"; value["stableFrames"] = 0L; });
+                            root["compilationObservationStarted"] = true; root["compileObservationSequence"] = observationSequence; root["compilePhase"] = "awaiting_started";
+                        }
                         root = CrossEffectFence(root, "refresh-dispatch", "dispatching");
                         try { AssetDatabase.Refresh(); Update(value => value["phase"] = "refresh_returned"); }
                         catch (Exception exception) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh result cannot be confirmed: " + exception.Message + "; inspect asset state."); }
                         return;
                     }
-                    if (phase == "refresh_returned")
-                    {
-                        if (Bool(root, "compile") && !Bool(root, "compilationObserved") && !Bool(root, "compilationRequested"))
-                        {
-                            if (BusyEditor()) return;
-                            UnityCliCompileCoordinator.RequestRefreshCompilation(Text(root, "requestId"), Text(root, "requestDigest"));
-                            return;
-                        }
-                        Update(value => value["phase"] = "waiting_stable");
-                        return;
-                    }
+                    if (phase == "refresh_returned") { Update(value => value["phase"] = "waiting_stable"); return; }
                     if (phase != "waiting_stable" || BusyEditor()) return;
-                    if (Bool(root, "compile") && (!Bool(root, "compilationObserved") || Text(root, "compilePhase") != "cycle_finished"))
+                    var compilePhase = Text(root, "compilePhase");
+                    if (Bool(root, "compile") && compilePhase != "awaiting_started" && compilePhase != "cycle_finished")
                     {
                         Fail(root, "E_EXECUTION_TIMEOUT", "Refresh compilation result cannot be confirmed; inspect editor.state and compile diagnostics.");
                         return;
@@ -152,6 +156,7 @@ namespace UnityCli
                         return;
                     }
                     var frames = Long(root, "stableFrames") + 1L;
+                    root["stableFrames"] = frames;
                     Update(value => value["stableFrames"] = frames);
                     if (frames >= 3L) Succeed(root);
                 }

package/unitypkg/Editor/Infrastructure/UnityCliObjectPatch.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     public static partial class UnityCliBridge
     {
         /// <summary>
-        /// object.modify 与 component.modify 共用的 verified SerializedProperty patch 引擎。
+        /// serialized-object.patch 与 component.modify 共用的 verified SerializedProperty patch 引擎。
         /// 公开契约只允许非空 direct replace，不保留 reflection merge/add/remove 旁路。
         /// </summary>
         internal static class ObjectPatch

package/unitypkg/Editor/Infrastructure/UnityCliObjectRef.cs

@@ -99,7 +99,7 @@ namespace UnityCli
 
                 throw new BridgeCommandException("E_OBJECTREF_REQUIRED",
                     "Object reference required: pass instanceId, assetPath/guid, or path/name.",
-                    "Run object.get-data --input '{\"instanceId\":12345}' or '{\"assetPath\":\"Assets/Mat.mat\"}'.");
+                    "Run serialized-object.read --input '{\"instanceId\":12345}' or '{\"assetPath\":\"Assets/Mat.mat\"}'.");
             }
 
             /// <summary>解析 GameObject 引用。</summary>
@@ -127,12 +127,12 @@ namespace UnityCli
                     if (go != null) return go;
                     throw new BridgeCommandException("E_OBJECTREF_GAMEOBJECT_REQUIRED",
                         "No GameObject matched path/name '" + path + "' in any loaded scene.",
-                        "Run go.find to locate the GameObject and obtain its instanceId, then pass that instanceId.");
+                        "Run game-object.find to locate the GameObject and obtain its instanceId, then pass that instanceId.");
                 }
 
                 throw new BridgeCommandException("E_OBJECTREF_GAMEOBJECT_REQUIRED",
                     "GameObject reference required: pass instanceId or path/name.",
-                    "Run go.find to locate the GameObject and obtain its instanceId.");
+                    "Run game-object.find to locate the GameObject and obtain its instanceId.");
             }
 
             /// <summary>
@@ -282,7 +282,7 @@ namespace UnityCli
                 var secondPath = UnityCliHierarchyPager.Path(second, budget);
                 throw new BridgeCommandException("E_OBJECTREF_AMBIGUOUS",
                     "Path '" + path + "' matches multiple GameObjects: " + firstPath + ", " + secondPath,
-                    "Pass the instanceId from go.find to disambiguate objects in different loaded scenes.");
+                    "Pass the instanceId from game-object.find to disambiguate objects in different loaded scenes.");
             }
 
             /// <summary>
@@ -373,7 +373,7 @@ namespace UnityCli
                 }
                 throw new BridgeCommandException("E_OBJECTREF_AMBIGUOUS",
                     "Path '" + path + "' matches " + matches.Count + " GameObjects: " + string.Join(", ", candidates),
-                    "Pass the full hierarchy path from a scene root, or use go.find to obtain the instanceId.");
+                    "Pass the full hierarchy path from a scene root, or use game-object.find to obtain the instanceId.");
             }
         }
     }