unity-agentic-tools 0.4.2 → 0.4.3

package/dist/cli.js

@@ -2299,7 +2299,7 @@ var require_package = __commonJS((exports2, module2) => {
   module2.exports = {
     name: "unity-agentic-tools",
     packageManager: "bun@latest",
-    version: "0.4.2",
+    version: "0.4.3",
     description: "Fast, token-efficient Unity YAML parser for AI agents",
     exports: {
       ".": {
@@ -2595,8 +2595,8 @@ function removeDirectoryRecursive(dir) {
 }
 
 // src/cmd-create.ts
-var import_fs17 = require("fs");
-var import_path7 = require("path");
+var import_fs18 = require("fs");
+var import_path10 = require("path");
 var import_crypto2 = require("crypto");
 
 // src/utils.ts
@@ -2809,6 +2809,19 @@ function build_guid_cache(project_path, raw) {
         }
       }
       return substringMatch;
+    },
+    find_all_by_name_exact(name, extension) {
+      const nameLower = name.toLowerCase().replace(/\.[^.]+$/, "");
+      const matches = [];
+      for (const [guid, assetPath] of Object.entries(raw)) {
+        if (extension && !assetPath.endsWith(extension))
+          continue;
+        const fileName = import_path5.basename(assetPath, import_path5.extname(assetPath)).toLowerCase();
+        if (fileName === nameLower) {
+          matches.push({ guid, path: assetPath });
+        }
+      }
+      return matches;
     }
   };
 }
@@ -2907,15 +2920,14 @@ var UNITY_CLASS_IDS = {
   114: "MonoBehaviour",
   115: "MonoScript",
   117: "Texture3D",
-  119: "NewAnimationTrack",
-  120: "Projector",
-  121: "LineRenderer",
-  122: "Flare",
-  123: "Halo",
-  124: "LensFlare",
-  125: "FlareLayer",
-  126: "HaloLayer",
-  127: "NavMeshProjectSettings",
+  118: "NewAnimationTrack",
+  119: "Projector",
+  120: "LineRenderer",
+  121: "Flare",
+  122: "Halo",
+  123: "LensFlare",
+  124: "FlareLayer",
+  126: "NavMeshProjectSettings",
   128: "Font",
   129: "PlayerSettings",
   130: "NamedObject",
@@ -2942,6 +2954,7 @@ var UNITY_CLASS_IDS = {
   164: "AudioReverbFilter",
   165: "AudioHighPassFilter",
   166: "AudioChorusFilter",
+  1660057539: "SceneRoots",
   167: "AudioReverbZone",
   168: "AudioEchoFilter",
   169: "AudioLowPassFilter",
@@ -3012,29 +3025,41 @@ var UNITY_CLASS_IDS = {
   257: "TargetJoint2D",
   258: "LightProbes",
   259: "LightProbeProxyVolume",
-  260: "SampleClip",
-  261: "AudioMixerSnapshot",
-  262: "AudioMixerGroup",
+  260: "SampleClipLegacy",
+  261: "AudioMixerSnapshotLegacy",
+  262: "AudioMixerGroupLegacy",
   265: "NScreenBridge",
-  271: "AssetBundleManifest",
+  271: "SampleClip",
   272: "UnityAdsManager",
-  273: "RuntimeInitializeOnLoadManager",
-  280: "UnityConnectSettings",
-  281: "AvatarMask",
-  290: "PlayableDirector",
-  292: "VideoPlayer",
-  293: "VideoClip",
-  294: "ParticleSystemForceField",
-  298: "SpriteMask",
+  273: "AudioMixerGroup",
+  280: "UnityConnectSettingsLegacy",
+  281: "AvatarMaskLegacy",
+  290: "AssetBundleManifest",
+  292: "VideoPlayerLegacy",
+  293: "VideoClipLegacy",
+  294: "ParticleSystemForceFieldLegacy",
+  298: "SpriteMaskLegacy",
   300: "WorldAnchor",
-  301: "OcclusionCullingData",
-  310: "PrefabInstance",
-  319: "TextureImporter",
-  363: "Preset",
+  301: "OcclusionCullingDataLegacy",
+  310: "UnityConnectSettings",
+  1001: "PrefabInstance",
+  319: "AvatarMask",
+  320: "PlayableDirector",
+  328: "VideoPlayer",
+  329: "VideoClip",
+  330: "ParticleSystemForceField",
+  331: "SpriteMask",
+  363: "OcclusionCullingData",
+  1006: "TextureImporter",
+  181963792: "Preset",
   687078895: "SpriteAtlas",
+  156049354: "Grid",
+  1742807556: "GridLayout",
   1839735485: "Tilemap",
-  1839735486: "TilemapCollider2D",
-  1839735487: "TilemapRenderer"
+  19719996: "TilemapCollider2D",
+  483693784: "TilemapRenderer",
+  1839735486: "TilemapCollider2DLegacy",
+  1839735487: "TilemapRendererLegacy"
 };
 var UNITY_CLASS_NAMES = Object.fromEntries(Object.entries(UNITY_CLASS_IDS).map(([id, name]) => [name, parseInt(id, 10)]));
 function get_class_id_name(class_id) {
@@ -3100,8 +3125,12 @@ function resolve_source_prefab(doc, file_path, project_path) {
     prefab_instance_block: pi_block
   };
 }
-function resolveScriptGuid(script, projectPath) {
+function resolveScriptGuid(script, projectPath, options) {
+  const strictExactName = options?.strict_exact_name === true;
   if (/^[a-f0-9]{32}$/i.test(script)) {
+    if (/^0{32}$/i.test(script)) {
+      throw new Error(`Invalid script GUID "${script}": all-zero GUID is not allowed. Provide a real script GUID from a .meta file.`);
+    }
     return { guid: script.toLowerCase(), path: null };
   }
   if (script.endsWith(".cs")) {
@@ -3126,9 +3155,20 @@ function resolveScriptGuid(script, projectPath) {
   if (projectPath) {
     const guidCache = load_guid_cache(projectPath);
     if (guidCache) {
-      const result = guidCache.find_by_name(script, ".cs");
-      if (result)
-        return result;
+      if (strictExactName) {
+        const exactMatches = guidCache.find_all_by_name_exact(script, ".cs");
+        if (exactMatches.length === 1) {
+          return exactMatches[0];
+        }
+        if (exactMatches.length > 1) {
+          const paths = exactMatches.map((m) => m.path).join(", ");
+          throw new Error(`Ambiguous type "${script}": found ${exactMatches.length} exact script name matches (${paths}). ` + 'Use a qualified name (e.g., "Namespace.TypeName") or provide the full script path.');
+        }
+      } else {
+        const result = guidCache.find_by_name(script, ".cs");
+        if (result)
+          return result;
+      }
     }
     const registryPath = path.join(projectPath, ".unity-agentic", "type-registry.json");
     if (import_fs6.existsSync(registryPath)) {
@@ -3279,15 +3319,30 @@ function resolveScriptGuid(script, projectPath) {
         continue;
       try {
         const cache = JSON.parse(import_fs6.readFileSync(cachePath, "utf-8"));
+        const exactMatches = [];
         for (const [guid, assetPath] of Object.entries(cache)) {
           if (!assetPath.endsWith(".cs"))
             continue;
           const fileName = path.basename(assetPath, ".cs").toLowerCase();
           if (fileName === scriptNameLower || classNameOnly && fileName === classNameOnly) {
-            return { guid, path: assetPath };
+            exactMatches.push({ guid, path: assetPath });
           }
         }
-      } catch {}
+        if (exactMatches.length === 1) {
+          return exactMatches[0];
+        }
+        if (exactMatches.length > 1) {
+          const paths = exactMatches.map((m) => m.path).join(", ");
+          throw new Error(`Ambiguous type "${script}": found ${exactMatches.length} exact script name matches (${paths}). ` + 'Use a qualified name (e.g., "Namespace.TypeName") or provide the full script path.');
+        }
+      } catch (err) {
+        if (err instanceof Error && err.message.startsWith("Ambiguous type")) {
+          throw err;
+        }
+      }
+    }
+    if (strictExactName) {
+      return null;
     }
     try {
       const assetsDir = path.join(projectPath, "Assets");
@@ -3358,19 +3413,38 @@ function resolveAssetPathToPPtr(value, file_path, project_path) {
     return null;
   return `{fileID: ${mapping.fileID}, guid: ${guid}, type: ${mapping.type}}`;
 }
-function resolve_script_with_fields(script, project_path) {
-  const resolved = resolveScriptGuid(script, project_path);
+function detect_abstract_class_in_source(file_path, class_name) {
+  try {
+    const source = import_fs6.readFileSync(file_path, "utf-8");
+    const escaped_name = class_name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`(^|[^\\w])abstract\\s+class\\s+${escaped_name}(?=$|[^\\w])`, "m");
+    return pattern.test(source);
+  } catch {
+    return false;
+  }
+}
+function resolve_script_with_fields(script, project_path, options) {
+  const resolved = resolveScriptGuid(script, project_path, options);
   if (!resolved)
     return null;
   const result = {
     guid: resolved.guid,
     path: resolved.path
   };
+  if (resolved.path && resolved.path.endsWith(".cs")) {
+    const full_path = path.isAbsolute(resolved.path) ? resolved.path : project_path ? path.join(project_path, resolved.path) : resolved.path;
+    if (import_fs6.existsSync(full_path)) {
+      const class_name = script.includes(".") ? script.split(".").pop() : script;
+      if (class_name.length > 0) {
+        result.is_abstract = detect_abstract_class_in_source(full_path, class_name);
+      }
+    }
+  }
   if (!project_path)
     return result;
   if (resolved.path) {
     try {
-      const full_path = resolved.path.startsWith("/") ? resolved.path : path.join(project_path, resolved.path);
+      const full_path = path.isAbsolute(resolved.path) ? resolved.path : path.join(project_path, resolved.path);
       if (!import_fs6.existsSync(full_path)) {
         result.extraction_error = `Script file not found at resolved path: ${full_path}`;
       } else if (resolved.path.endsWith(".cs")) {
@@ -3384,6 +3458,10 @@ function resolve_script_with_fields(script, project_path) {
             result.fields = chosen.fields;
             result.base_class = chosen.baseClass ?? undefined;
             result.kind = chosen.kind;
+            result.class_name = chosen.name;
+            if (chosen.name) {
+              result.is_abstract = detect_abstract_class_in_source(full_path, chosen.name);
+            }
           }
         } else {
           result.extraction_error = "Native extractSerializedFields function not available";
@@ -4483,7 +4561,21 @@ class UnityDocument {
         }
       }
     }
-    return transform_ids;
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const name_pattern = new RegExp(`propertyPath: m_Name\\s*\\n\\s*value:\\s*${escaped}\\s*$`, "m");
+    for (const block of this._blocks) {
+      if ((block.class_id === 1001 || block.class_id === 310) && name_pattern.test(block.raw)) {
+        const pi_id = block.file_id;
+        const pi_ref_pattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${pi_id}\\}`);
+        const stripped_transform = this._blocks.find((b) => (b.class_id === 4 || b.class_id === 224) && b.is_stripped && pi_ref_pattern.test(b.raw));
+        if (stripped_transform) {
+          transform_ids.push(stripped_transform.file_id);
+        } else {
+          transform_ids.push(pi_id);
+        }
+      }
+    }
+    return Array.from(new Set(transform_ids));
   }
   require_unique_game_object(name_or_id) {
     if (/^-?\d+$/.test(name_or_id)) {
@@ -4512,10 +4604,7 @@ class UnityDocument {
       if (!block) {
         return { error: `Block with fileID ${name_or_id} not found` };
       }
-      if (block.class_id === 4) {
-        return block;
-      }
-      if (block.class_id === 224) {
+      if (block.class_id === 4 || block.class_id === 224 || block.class_id === 1001 || block.class_id === 310) {
         return block;
       }
       if (block.class_id === 1) {
@@ -4528,15 +4617,40 @@ class UnityDocument {
         }
         return { error: `Transform for GameObject fileID ${name_or_id} not found` };
       }
-      return { error: `fileID ${name_or_id} is not a GameObject or Transform (class ${block.class_id})` };
+      return { error: `fileID ${name_or_id} is not a GameObject, Transform, or PrefabInstance (class ${block.class_id})` };
     }
     const transform_ids = this.find_transforms_by_name(name_or_id);
     if (transform_ids.length === 0) {
-      return { error: `GameObject "${name_or_id}" not found` };
+      return { error: `Object "${name_or_id}" not found` };
     }
     if (transform_ids.length > 1) {
-      const go_ids = this.find_game_objects_by_name(name_or_id).map((b) => b.file_id).join(", ");
-      return { error: `Multiple GameObjects named "${name_or_id}" found (fileIDs: ${go_ids}). Use numeric fileID to specify which one.` };
+      const entity_ids = [];
+      for (const tid of transform_ids) {
+        const block = this.find_by_file_id(tid);
+        if (block) {
+          if (block.class_id === 4 || block.class_id === 224) {
+            const go_match = block.raw.match(/m_GameObject:\s*\{fileID:\s*(-?\d+)\}/);
+            if (go_match) {
+              entity_ids.push(go_match[1]);
+            } else {
+              entity_ids.push(tid);
+            }
+          } else if (block.class_id === 1001 || block.class_id === 310) {
+            entity_ids.push(tid);
+          } else if (block.is_stripped) {
+            const pi_match = block.raw.match(/m_PrefabInstance:\s*\{fileID:\s*(-?\d+)\}/);
+            if (pi_match) {
+              entity_ids.push(pi_match[1]);
+            } else {
+              entity_ids.push(tid);
+            }
+          } else {
+            entity_ids.push(tid);
+          }
+        }
+      }
+      const ids_str = Array.from(new Set(entity_ids)).join(", ");
+      return { error: `Multiple GameObjects/PrefabInstances named "${name_or_id}" found (fileIDs: ${ids_str}). Use numeric fileID to specify which one.` };
     }
     const transform = this.find_by_file_id(transform_ids[0]);
     if (!transform) {
@@ -4564,7 +4678,7 @@ class UnityDocument {
           if (t_block.class_id === 4 && t_block.is_stripped) {
             let name = "Variant";
             for (const pi_block of this._blocks) {
-              if (pi_block.class_id === 1001) {
+              if (pi_block.class_id === 1001 || pi_block.class_id === 310) {
                 const name_mod = pi_block.raw.match(/propertyPath: m_Name\s*\n\s*value:\s*(.+)/);
                 if (name_mod) {
                   name = name_mod[1].trim();
@@ -4717,7 +4831,7 @@ class UnityDocument {
   }
   add_child_to_parent(parent_id, child_id) {
     const parent = this.find_by_file_id(parent_id);
-    if (!parent || parent.class_id !== 4)
+    if (!parent || parent.class_id !== 4 && parent.class_id !== 224)
       return false;
     let raw = parent.raw;
     const inline_empty = /m_Children:\s*\[\]/;
@@ -4753,7 +4867,7 @@ class UnityDocument {
   }
   remove_child_from_parent(parent_id, child_id) {
     const parent = this.find_by_file_id(parent_id);
-    if (!parent || parent.class_id !== 4)
+    if (!parent || parent.class_id !== 4 && parent.class_id !== 224)
       return false;
     let raw = parent.raw;
     const child_line = new RegExp(`\\n[ \\t]*- \\{fileID: ${child_id}\\}`);
@@ -4774,7 +4888,49 @@ class UnityDocument {
   }
   _collect_hierarchy_recursive(transform_id, result) {
     const transform = this.find_by_file_id(transform_id);
-    if (!transform || transform.class_id !== 4)
+    if (!transform)
+      return;
+    if (transform.class_id === 1001 || transform.class_id === 310) {
+      const pi_id = transform.file_id;
+      const pi_ref_pattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${pi_id}\\}`);
+      for (const block of this._blocks) {
+        if (block.is_stripped && pi_ref_pattern.test(block.raw)) {
+          result.add(block.file_id);
+          if (block.class_id === 4 || block.class_id === 224) {
+            this._collect_hierarchy_recursive(block.file_id, result);
+          }
+        }
+      }
+      const added_go_matches = transform.raw.matchAll(/addedObject:[ \t]*\{[^}]*fileID:[ \t]*(-?\d+)\}/g);
+      for (const match of added_go_matches) {
+        const added_id = match[1];
+        if (added_id !== "0" && !result.has(added_id)) {
+          result.add(added_id);
+          const added_block = this.find_by_file_id(added_id);
+          if (added_block && added_block.class_id === 1) {
+            const comp_matches = added_block.raw.matchAll(/component:[ \t]*\{fileID:[ \t]*(-?\d+)\}/g);
+            for (const cm of comp_matches) {
+              const comp_block = this.find_by_file_id(cm[1]);
+              if (comp_block && (comp_block.class_id === 4 || comp_block.class_id === 224)) {
+                if (!result.has(cm[1])) {
+                  result.add(cm[1]);
+                  this._collect_hierarchy_recursive(cm[1], result);
+                }
+                break;
+              }
+            }
+          }
+        }
+      }
+      const added_comp_matches = transform.raw.matchAll(/addedObject:[ \t]*\{[^}]*fileID:[ \t]*(-?\d+)\}/g);
+      for (const match of added_comp_matches) {
+        const added_id = match[1];
+        if (added_id !== "0")
+          result.add(added_id);
+      }
+      return;
+    }
+    if (transform.class_id !== 4 && transform.class_id !== 224)
       return;
     const children_section = transform.raw.match(/m_Children:[\s\S]*?(?=\s*m_Father:)/);
     if (!children_section)
@@ -4809,14 +4965,21 @@ class UnityDocument {
     if (parent_id === "0") {
       let count = 0;
       for (const block of this._blocks) {
-        if (block.class_id === 4 && /m_Father:\s*\{fileID:\s*0\}/.test(block.raw)) {
+        if ((block.class_id === 4 || block.class_id === 224) && /m_Father:\s*\{fileID:\s*0\}/.test(block.raw)) {
           count++;
+        } else if ((block.class_id === 1001 || block.class_id === 310) && /m_TransformParent:\s*\{fileID:\s*0\}/.test(block.raw)) {
+          const pi_id = block.file_id;
+          const pi_ref_pattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${pi_id}\\}`);
+          const has_stripped = this._blocks.some((b) => (b.class_id === 4 || b.class_id === 224) && b.is_stripped && pi_ref_pattern.test(b.raw));
+          if (!has_stripped) {
+            count++;
+          }
         }
       }
       return count;
     }
     const parent = this.find_by_file_id(parent_id);
-    if (!parent || parent.class_id !== 4)
+    if (!parent || parent.class_id !== 4 && parent.class_id !== 224)
       return 0;
     const children_match = parent.raw.match(/m_Children:[\s\S]*?(?=\s*m_Father:)/);
     if (children_match) {
@@ -4849,19 +5012,97 @@ ${new_children}`);
     }
     return false;
   }
+  add_root_to_scene_roots(root_id) {
+    const pi_block = this.find_by_file_id(root_id);
+    if (pi_block && (pi_block.class_id === 1001 || pi_block.class_id === 310)) {
+      const pi_ref_pattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${root_id}\\}`);
+      const stripped_root = this._blocks.find((b) => (b.class_id === 4 || b.class_id === 224) && b.is_stripped && pi_ref_pattern.test(b.raw) && /m_Father:\s*\{fileID:\s*0\}/.test(b.raw));
+      if (stripped_root) {
+        root_id = stripped_root.file_id;
+      }
+    }
+    const sr_blocks = [...this.find_by_class_id(166), ...this.find_by_class_id(1660057539)];
+    if (sr_blocks.length === 0)
+      return false;
+    const sr_block = sr_blocks[0];
+    let raw = sr_block.raw;
+    const roots_pattern = /(m_Roots:\s*\n(?:\s*-\s*\{fileID:\s*-?\d+\}\s*\n)*)/;
+    if (roots_pattern.test(raw)) {
+      raw = raw.replace(roots_pattern, `$1  - {fileID: ${root_id}}
+`);
+      sr_block.replace_raw(raw);
+      return true;
+    }
+    const empty_roots = /m_Roots:\s*\[\]/;
+    if (empty_roots.test(raw)) {
+      raw = raw.replace(empty_roots, `m_Roots:
+  - {fileID: ${root_id}}`);
+      sr_block.replace_raw(raw);
+      return true;
+    }
+    return false;
+  }
+  remove_root_from_scene_roots(root_id) {
+    const pi_block = this.find_by_file_id(root_id);
+    if (pi_block && (pi_block.class_id === 1001 || pi_block.class_id === 310)) {
+      const pi_ref_pattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${root_id}\\}`);
+      const stripped_root = this._blocks.find((b) => (b.class_id === 4 || b.class_id === 224) && b.is_stripped && pi_ref_pattern.test(b.raw));
+      if (stripped_root) {
+        this._remove_id_from_scene_roots(stripped_root.file_id);
+      }
+    }
+    return this._remove_id_from_scene_roots(root_id);
+  }
+  _remove_id_from_scene_roots(id) {
+    const sr_blocks = [...this.find_by_class_id(166), ...this.find_by_class_id(1660057539)];
+    if (sr_blocks.length === 0)
+      return false;
+    const sr_block = sr_blocks[0];
+    let raw = sr_block.raw;
+    const root_line = new RegExp(`\\n[ \\t]*- \\{fileID: ${id}\\}`);
+    if (!root_line.test(raw))
+      return false;
+    raw = raw.replace(root_line, "");
+    sr_block.replace_raw(raw);
+    return true;
+  }
   reorder_entities(ordered_transform_ids) {
     const entity_groups = [];
     for (const transform_id of ordered_transform_ids) {
-      const transform = this.find_by_file_id(transform_id);
-      if (!transform)
+      const block = this.find_by_file_id(transform_id);
+      if (!block)
+        continue;
+      let pi_block = null;
+      if (block.class_id === 1001 || block.class_id === 310) {
+        pi_block = block;
+      } else if (block.is_stripped) {
+        const pi_match = block.raw.match(/m_PrefabInstance:\s*\{fileID:\s*(-?\d+)\}/);
+        if (pi_match) {
+          const found = this.find_by_file_id(pi_match[1]);
+          if (found && (found.class_id === 1001 || found.class_id === 310)) {
+            pi_block = found;
+          }
+        }
+      }
+      if (pi_block) {
+        const group = [pi_block.file_id];
+        const hierarchy = this.collect_hierarchy(pi_block.file_id);
+        for (const id of hierarchy)
+          group.push(id);
+        entity_groups.push(group);
         continue;
-      const go_match = transform.raw.match(/m_GameObject:\s*\{fileID:\s*(-?\d+)\}/);
-      if (!go_match)
+      }
+      const go_match = block.raw.match(/m_GameObject:\s*\{fileID:\s*(-?\d+)\}/);
+      if (!go_match) {
+        entity_groups.push([transform_id]);
         continue;
+      }
       const go_id = go_match[1];
       const go = this.find_by_file_id(go_id);
-      if (!go)
+      if (!go) {
+        entity_groups.push([transform_id]);
         continue;
+      }
       const comp_ids = [];
       const comp_matches = go.raw.matchAll(/component:\s*\{fileID:\s*(-?\d+)\}/g);
       for (const m of comp_matches) {
@@ -6589,6 +6830,9 @@ function createScriptableObject(options) {
   if (resolved.kind === "enum" || resolved.kind === "interface") {
     return { success: false, output_path, error: `"${script}" is ${resolved.kind === "enum" ? "an enum" : "an interface"}, not a ScriptableObject.` };
   }
+  if (resolved.is_abstract) {
+    return { success: false, output_path, error: `"${script}" is abstract and cannot be instantiated as a ScriptableObject asset.` };
+  }
   if (resolved.base_class && resolved.base_class !== "ScriptableObject") {
     return { success: false, output_path, error: `"${script}" extends ${resolved.base_class}, not ScriptableObject. Cannot create as a ScriptableObject asset.` };
   }
@@ -6872,6 +7116,13 @@ function addComponent(options) {
   }
   const gameObjectId = gameObjectIdStr;
   const classId = get_class_id(component_type);
+  if (classId === 114 && component_type.toLowerCase() === "monobehaviour") {
+    return {
+      success: false,
+      file_path,
+      error: '"MonoBehaviour" is a base class, not a concrete component script. Provide a script type/path/GUID (for example, "PlayerController", "Assets/Scripts/PlayerController.cs", or a 32-char GUID).'
+    };
+  }
   let duplicateWarning;
   const goBlock = doc.find_by_file_id(gameObjectIdStr);
   if (goBlock && classId !== null) {
@@ -6896,7 +7147,7 @@ function addComponent(options) {
   } else {
     let resolved;
     try {
-      resolved = resolve_script_with_fields(component_type, project_path);
+      resolved = resolve_script_with_fields(component_type, project_path, { strict_exact_name: true });
     } catch (e) {
       return {
         success: false,
@@ -6934,6 +7185,13 @@ function addComponent(options) {
         error: `"${component_type}" is ${resolved.kind === "enum" ? "an enum" : "an interface"}, not a MonoBehaviour. Cannot add as a component.`
       };
     }
+    if (resolved.is_abstract) {
+      return {
+        success: false,
+        file_path,
+        error: `"${component_type}" is abstract and cannot be added as a component.`
+      };
+    }
     if (resolved.base_class && !COMPONENT_BASE_CLASSES.has(resolved.base_class) && !is_valid_component_base(resolved.base_class, project_path)) {
       const warn = `"${component_type}" extends ${resolved.base_class}, which does not inherit from MonoBehaviour. Adding anyway, but ensure the script is a valid component. (Re-run "setup" if the inheritance graph is stale).`;
       if (!extractionError)
@@ -7766,6 +8024,56 @@ function validate_value_type(current_value, new_value) {
   }
   return null;
 }
+function findStrippedTransformForPrefabInstance(doc, prefabInstanceId) {
+  const piRefPattern = new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${prefabInstanceId}\\}`);
+  for (const block of doc.blocks) {
+    if ((block.class_id === 4 || block.class_id === 224) && block.is_stripped && piRefPattern.test(block.raw)) {
+      return block;
+    }
+  }
+  return null;
+}
+function resolvePrefabRootOrderTarget(prefabInstanceBlock) {
+  const modificationPattern = /- target:\s*(\{[^}]+\})\s*\n\s*propertyPath:\s*('?)([^\n']+)\2/gm;
+  const transformPropertyPattern = /^m_(?:RootOrder|LocalPosition|LocalRotation|LocalScale|ConstrainProportionsScale)(?:\.|$)/;
+  let transformTarget = null;
+  for (const match of prefabInstanceBlock.raw.matchAll(modificationPattern)) {
+    const targetRef = match[1];
+    const propertyPath = match[3].trim();
+    if (propertyPath === "m_RootOrder") {
+      return targetRef;
+    }
+    if (!transformTarget && transformPropertyPattern.test(propertyPath)) {
+      transformTarget = targetRef;
+    }
+  }
+  return transformTarget;
+}
+function upsertPrefabRootOrderOverride(prefabInstanceBlock, newRootOrder) {
+  const existingRootOrderPattern = /(- target:\s*\{[^}]+\}\s*\n\s*propertyPath:\s*'?m_RootOrder'?\s*\n\s*value:\s*)([^\n]*)(\s*\n\s*objectReference:\s*\{[^}]+\})/m;
+  if (existingRootOrderPattern.test(prefabInstanceBlock.raw)) {
+    prefabInstanceBlock.replace_raw(prefabInstanceBlock.raw.replace(existingRootOrderPattern, `$1${newRootOrder}$3`));
+    return true;
+  }
+  const targetRef = resolvePrefabRootOrderTarget(prefabInstanceBlock) ?? "{fileID: 400000}";
+  const rootOrderOverride = `    - target: ${targetRef}
+` + `      propertyPath: m_RootOrder
+` + `      value: ${newRootOrder}
+` + "      objectReference: {fileID: 0}";
+  const removedPattern = /(\n\s*m_RemovedComponents:)/m;
+  if (removedPattern.test(prefabInstanceBlock.raw)) {
+    prefabInstanceBlock.replace_raw(prefabInstanceBlock.raw.replace(removedPattern, `
+${rootOrderOverride}$1`));
+    return true;
+  }
+  const modsPattern = /(m_Modifications:\s*\n)/;
+  if (modsPattern.test(prefabInstanceBlock.raw)) {
+    prefabInstanceBlock.replace_raw(prefabInstanceBlock.raw.replace(modsPattern, `$1${rootOrderOverride}
+`));
+    return true;
+  }
+  return false;
+}
 function isAncestor(doc, childTransformId, candidateAncestorTransformId) {
   let currentId = candidateAncestorTransformId;
   const visited = new Set;
@@ -7776,17 +8084,34 @@ function isAncestor(doc, childTransformId, candidateAncestorTransformId) {
       return false;
     visited.add(currentId);
     const block = doc.find_by_file_id(currentId);
-    if (!block || block.class_id !== 4)
+    if (!block)
+      break;
+    if (block.class_id === 1001 || block.class_id === 310) {
+      const parentMatch = block.raw.match(/m_TransformParent:\s*\{fileID:\s*(-?\d+)\}/);
+      currentId = parentMatch ? parentMatch[1] : "0";
+    } else if (block.class_id === 4 || block.class_id === 224) {
+      const fatherMatch = block.raw.match(/m_Father:\s*\{fileID:\s*(-?\d+)\}/);
+      currentId = fatherMatch ? fatherMatch[1] : "0";
+    } else {
       break;
-    const fatherMatch = block.raw.match(/m_Father:\s*\{fileID:\s*(-?\d+)\}/);
-    currentId = fatherMatch ? fatherMatch[1] : "0";
+    }
   }
   return false;
 }
 function resolveTransformByGameObjectId(doc, gameObjectFileId) {
   const found = doc.find_by_file_id(gameObjectFileId);
-  if (!found || found.class_id !== 1) {
-    return { error: `GameObject with fileID ${gameObjectFileId} not found` };
+  if (!found) {
+    return { error: `Block with fileID ${gameObjectFileId} not found` };
+  }
+  if (found.class_id === 4 || found.class_id === 224) {
+    return { id: gameObjectFileId };
+  }
+  if (found.class_id === 1001 || found.class_id === 310) {
+    const strippedTransform = findStrippedTransformForPrefabInstance(doc, gameObjectFileId);
+    return { id: strippedTransform ? strippedTransform.file_id : gameObjectFileId };
+  }
+  if (found.class_id !== 1) {
+    return { error: `fileID ${gameObjectFileId} is not a GameObject, Transform, or PrefabInstance (class ${found.class_id})` };
   }
   const componentMatch = found.raw.match(/m_Component:\s*\n\s*-\s*component:\s*\{fileID:\s*(-?\d+)\}/);
   if (!componentMatch) {
@@ -7979,7 +8304,7 @@ function editComponentByFileId(options) {
   }
   const targetBlock = doc.find_by_file_id(file_id);
   if (!targetBlock) {
-    const hasPrefabInstance = doc.find_by_class_id(1001).length > 0;
+    const hasPrefabInstance = doc.find_by_class_id(1001).length > 0 || doc.find_by_class_id(310).length > 0;
     if (hasPrefabInstance) {
       return {
         success: false,
@@ -8444,10 +8769,26 @@ function reparentGameObject(options) {
   }
   const childBlock = doc.find_by_file_id(childTransformId);
   if (!childBlock) {
-    return { success: false, file_path, error: `Transform ${childTransformId} not found` };
+    return { success: false, file_path, error: `Transform or PrefabInstance ${childTransformId} not found` };
+  }
+  const childHierarchyTransformId = (() => {
+    if (childBlock.class_id === 4 || childBlock.class_id === 224) {
+      return childBlock.file_id;
+    }
+    if (childBlock.class_id === 1001 || childBlock.class_id === 310) {
+      const stripped = findStrippedTransformForPrefabInstance(doc, childBlock.file_id);
+      return stripped ? stripped.file_id : null;
+    }
+    return null;
+  })();
+  let oldParentTransformId = "0";
+  if (childBlock.class_id === 1001 || childBlock.class_id === 310) {
+    const parentMatch = childBlock.raw.match(/m_TransformParent:\s*\{fileID:\s*(-?\d+)\}/);
+    oldParentTransformId = parentMatch ? parentMatch[1] : "0";
+  } else {
+    const fatherMatch = childBlock.raw.match(/m_Father:\s*\{fileID:\s*(-?\d+)\}/);
+    oldParentTransformId = fatherMatch ? fatherMatch[1] : "0";
   }
-  const fatherMatch = childBlock.raw.match(/m_Father:\s*\{fileID:\s*(-?\d+)\}/);
-  const oldParentTransformId = fatherMatch ? fatherMatch[1] : "0";
   let newParentTransformId = "0";
   if (new_parent.toLowerCase() !== "root") {
     if (by_id || /^-?\d+$/.test(new_parent)) {
@@ -8474,11 +8815,55 @@ function reparentGameObject(options) {
     }
   }
   if (oldParentTransformId !== "0") {
-    doc.remove_child_from_parent(oldParentTransformId, childTransformId);
+    if (childHierarchyTransformId) {
+      doc.remove_child_from_parent(oldParentTransformId, childHierarchyTransformId);
+    } else {
+      doc.remove_child_from_parent(oldParentTransformId, childBlock.file_id);
+    }
+  } else {
+    if (childHierarchyTransformId) {
+      doc.remove_root_from_scene_roots(childHierarchyTransformId);
+    } else {
+      doc.remove_root_from_scene_roots(childBlock.file_id);
+    }
+  }
+  if (childBlock.class_id === 1001 || childBlock.class_id === 310) {
+    const tpPattern = new RegExp(`(m_TransformParent:\\s*)\\{fileID:\\s*(-?\\d+)\\}`);
+    if (tpPattern.test(childBlock.raw)) {
+      let updatedChildRaw = childBlock.raw.replace(tpPattern, `$1{fileID: ${newParentTransformId}}`);
+      childBlock.replace_raw(updatedChildRaw);
+    } else {
+      const modPattern = /(m_Modification:\s*\n)/;
+      const modIndentMatch = childBlock.raw.match(/^([ \t]*)m_Modification:/m);
+      const indent = modIndentMatch ? modIndentMatch[1] : "";
+      let updatedChildRaw = childBlock.raw.replace(modPattern, `$1${indent}  m_TransformParent: {fileID: ${newParentTransformId}}
+`);
+      childBlock.replace_raw(updatedChildRaw);
+    }
+  } else {
+    const fatherPattern = new RegExp(`(m_Father:\\s*)\\{fileID:\\s*\\d+\\}`);
+    if (fatherPattern.test(childBlock.raw)) {
+      let updatedChildRaw = childBlock.raw.replace(fatherPattern, `$1{fileID: ${newParentTransformId}}`);
+      childBlock.replace_raw(updatedChildRaw);
+    } else {
+      const anchorPattern = /^([ \t]*(?:m_GameObject|m_CorrespondingSourceObject|m_PrefabInstance):[ \t]*\{fileID:[ \t]*(-?\d+)[^}]*\}.*)/m;
+      const headerPattern = /(^--- !u!(?:4|224) &-?\d+ stripped\n(?:Rect)?Transform:)/m;
+      if (anchorPattern.test(childBlock.raw)) {
+        let updatedChildRaw = childBlock.raw.replace(anchorPattern, `$1
+  m_Father: {fileID: ${newParentTransformId}}`);
+        childBlock.replace_raw(updatedChildRaw);
+      } else if (headerPattern.test(childBlock.raw)) {
+        let updatedChildRaw = childBlock.raw.replace(headerPattern, `$1
+  m_Father: {fileID: ${newParentTransformId}}`);
+        childBlock.replace_raw(updatedChildRaw);
+      } else {
+        let updatedChildRaw = childBlock.raw.trimEnd() + `
+  m_Father: {fileID: ${newParentTransformId}}
+`;
+        childBlock.replace_raw(updatedChildRaw);
+      }
+    }
   }
-  const fatherPattern = new RegExp(`(m_Father:\\s*)\\{fileID:\\s*\\d+\\}`);
-  let updatedChildRaw = childBlock.raw.replace(fatherPattern, `$1{fileID: ${newParentTransformId}}`);
-  childBlock.replace_raw(updatedChildRaw);
   {
     let newRootOrder;
     if (newParentTransformId === "0") {
@@ -8486,10 +8871,25 @@ function reparentGameObject(options) {
     } else {
       newRootOrder = doc.calculate_root_order(newParentTransformId);
     }
-    childBlock.set_property("m_RootOrder", String(newRootOrder));
+    if (childBlock.class_id === 1001 || childBlock.class_id === 310) {
+      const stripped = doc.blocks.find((b) => (b.class_id === 4 || b.class_id === 224) && b.is_stripped && new RegExp(`m_PrefabInstance:[ \\t]*\\{fileID:[ \\t]*${childTransformId}\\}`).test(b.raw));
+      if (stripped) {
+        stripped.set_property("m_RootOrder", String(newRootOrder));
+      } else {
+        upsertPrefabRootOrderOverride(childBlock, newRootOrder);
+      }
+    } else {
+      childBlock.set_property("m_RootOrder", String(newRootOrder));
+    }
   }
   if (newParentTransformId !== "0") {
-    doc.add_child_to_parent(newParentTransformId, childTransformId);
+    if (childHierarchyTransformId) {
+      doc.add_child_to_parent(newParentTransformId, childHierarchyTransformId);
+    }
+  } else {
+    if (childHierarchyTransformId) {
+      doc.add_root_to_scene_roots(childHierarchyTransformId);
+    }
   }
   if (!doc.validate()) {
     return { success: false, file_path, error: "Validation failed after reparent" };
@@ -8508,9 +8908,9 @@ function reparentGameObject(options) {
 }
 function findPrefabInstanceBlock(doc, identifier) {
   const asId = doc.find_by_file_id(identifier);
-  if (asId && asId.class_id === 1001)
+  if (asId && (asId.class_id === 1001 || asId.class_id === 310))
     return asId;
-  const piBlocks = doc.find_by_class_id(1001);
+  const piBlocks = [...doc.find_by_class_id(1001), ...doc.find_by_class_id(310)];
   const escaped = identifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const namePattern = new RegExp(`propertyPath:\\s*m_Name\\s+value:\\s*${escaped}\\s`);
   for (const block of piBlocks) {
@@ -9312,6 +9712,7 @@ ${fieldIndent}  - rid: ${nextRid}`;
 }
 // src/editor/delete.ts
 var import_fs13 = require("fs");
+var import_path6 = require("path");
 
 // src/project-search.ts
 init_scanner();
@@ -10261,6 +10662,70 @@ function deletePrefabInstance(options) {
     deleted_count: allToRemove.size
   };
 }
+function deleteAssetFile(options) {
+  const { file_path } = options;
+  const pathError = validate_file_path(file_path, "write");
+  if (pathError) {
+    return { success: false, file_path, error: pathError };
+  }
+  if (!import_fs13.existsSync(file_path)) {
+    return { success: false, file_path, error: `File not found: ${file_path}` };
+  }
+  const supportedExtensions = new Set([
+    ".unity",
+    ".prefab",
+    ".mat",
+    ".anim",
+    ".controller",
+    ".inputactions",
+    ".asset"
+  ]);
+  const extension = import_path6.extname(file_path).toLowerCase();
+  if (!supportedExtensions.has(extension)) {
+    return {
+      success: false,
+      file_path,
+      error: `Unsupported asset type "${extension}". Supported extensions: .unity, .prefab, .mat, .anim, .controller, .inputactions, .asset`
+    };
+  }
+  const metaPath = `${file_path}.meta`;
+  const hasMeta = import_fs13.existsSync(metaPath);
+  try {
+    import_fs13.unlinkSync(file_path);
+  } catch (err) {
+    return {
+      success: false,
+      file_path,
+      error: `Failed to delete file: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+  if (hasMeta) {
+    try {
+      import_fs13.unlinkSync(metaPath);
+      return {
+        success: true,
+        file_path,
+        deleted_file: true,
+        deleted_meta: true
+      };
+    } catch (err) {
+      return {
+        success: true,
+        file_path,
+        deleted_file: true,
+        deleted_meta: false,
+        warning: `Deleted asset file but failed to delete .meta file: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+  return {
+    success: true,
+    file_path,
+    deleted_file: true,
+    deleted_meta: false,
+    warning: `Asset file deleted, but no .meta file found at ${metaPath}`
+  };
+}
 // src/editor/duplicate.ts
 var import_fs14 = require("fs");
 var path6 = __toESM(require("path"));
@@ -10905,9 +11370,9 @@ function move_scene(projectPath, scenePath, newPosition) {
 
 // src/packages.ts
 var import_fs15 = require("fs");
-var import_path6 = require("path");
+var import_path7 = require("path");
 function load_manifest(project_path) {
-  const manifest_path = import_path6.join(project_path, "Packages", "manifest.json");
+  const manifest_path = import_path7.join(project_path, "Packages", "manifest.json");
   if (!import_fs15.existsSync(manifest_path)) {
     return { error: `manifest.json not found at ${manifest_path}` };
   }
@@ -11101,27 +11566,384 @@ function remove_control_scheme(data, name) {
   return data;
 }
 
-// src/cmd-create.ts
-function build_create_command() {
-  const cmd = new Command("create").description("Create Unity objects (GameObjects, scenes, prefabs, components)");
-  cmd.command("gameobject <file> [name]").description("Create a new GameObject in a Unity file").option("-p, --parent <name|id>", "Parent GameObject name or Transform fileID").option("-n, --name <name>", "GameObject name (alternative to positional arg)").option("-j, --json", "Output as JSON").action((file, name_positional, options) => {
-    const name = name_positional || options.name;
-    if (!name) {
-      console.log(JSON.stringify({
-        success: false,
-        error: "Missing required name. Provide as positional argument or --name flag.",
-        correct_usage: [
-          "unity-agentic-tools create gameobject <file> <name>",
-          "unity-agentic-tools create gameobject <file> --name <name>"
-        ]
-      }, null, 2));
-      process.exitCode = 1;
-      return;
+// src/loaded-protection.ts
+var import_path9 = require("path");
+
+// src/editor-client.ts
+var import_fs17 = require("fs");
+var import_path8 = require("path");
+function read_editor_config(project_path) {
+  const config_path = import_path8.join(project_path, ".unity-agentic", "editor.json");
+  if (!import_fs17.existsSync(config_path)) {
+    return { error: `Editor bridge not found at ${config_path}. Is the Unity Editor running with the bridge package installed?` };
+  }
+  let config;
+  try {
+    const raw = import_fs17.readFileSync(config_path, "utf-8");
+    config = JSON.parse(raw);
+  } catch (err) {
+    return { error: `Failed to parse editor.json: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  if (typeof config.port !== "number" || typeof config.pid !== "number") {
+    return { error: "Invalid editor.json: missing port or pid" };
+  }
+  if (!is_pid_alive(config.pid)) {
+    return { error: `Unity Editor process (PID ${config.pid}) is not running. The editor may have been closed.` };
+  }
+  return config;
+}
+var RETRYABLE_CODES = new Set([-32000, -32002, -32003]);
+var RETRY_DELAYS = [500, 1000, 2000];
+async function call_editor(options) {
+  const maxRetries = options.retries ?? 2;
+  let lastResponse;
+  for (let attempt = 0;attempt <= maxRetries; attempt++) {
+    lastResponse = await call_editor_once(options);
+    if (!lastResponse.error || !RETRYABLE_CODES.has(lastResponse.error.code)) {
+      return lastResponse;
     }
-    const ext = file.toLowerCase().split(".").pop();
-    if (!ext || !["unity", "prefab", "asset"].includes(ext)) {
-      console.log(JSON.stringify({ success: false, error: `Invalid file type ".${ext}". create gameobject only works with .unity, .prefab, or .asset files` }, null, 2));
-      process.exitCode = 1;
+    if (attempt < maxRetries) {
+      const delay = RETRY_DELAYS[Math.min(attempt, RETRY_DELAYS.length - 1)];
+      await new Promise((r) => setTimeout(r, delay));
+    }
+  }
+  return lastResponse;
+}
+function call_editor_once(options) {
+  const { method, params, timeout = 1e4, no_wait } = options;
+  const config = resolve_config(options);
+  if ("error" in config) {
+    return Promise.resolve({
+      jsonrpc: "2.0",
+      id: "0",
+      error: { code: -32000, message: config.error }
+    });
+  }
+  const url = `ws://127.0.0.1:${config.port}/unity-agentic`;
+  const request_id = generate_id();
+  const wire_params = { ...params };
+  if (timeout !== 1e4)
+    wire_params._timeout = timeout;
+  if (no_wait)
+    wire_params.no_wait = true;
+  const request = {
+    jsonrpc: "2.0",
+    id: request_id,
+    method,
+    ...Object.keys(wire_params).length > 0 ? { params: wire_params } : {}
+  };
+  return new Promise((resolve5) => {
+    let resolved = false;
+    let ws;
+    const timer = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        try {
+          ws?.close();
+        } catch {}
+        resolve5({
+          jsonrpc: "2.0",
+          id: request_id,
+          error: { code: -32001, message: `Timeout after ${timeout}ms waiting for response to ${method}` }
+        });
+      }
+    }, timeout);
+    try {
+      ws = new WebSocket(url);
+      ws.onopen = () => {
+        ws.send(JSON.stringify(request));
+        if (no_wait && !resolved) {
+          resolved = true;
+          clearTimeout(timer);
+          setTimeout(() => {
+            try {
+              ws.close();
+            } catch {}
+          }, 200);
+          resolve5({
+            jsonrpc: "2.0",
+            id: request_id,
+            result: { queued: true }
+          });
+        }
+      };
+      ws.onmessage = (event) => {
+        try {
+          const data = JSON.parse(String(event.data));
+          if (data.id === request_id) {
+            if (!resolved) {
+              resolved = true;
+              clearTimeout(timer);
+              ws.close();
+              resolve5(data);
+            }
+          }
+        } catch {}
+      };
+      ws.onerror = () => {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timer);
+          resolve5({
+            jsonrpc: "2.0",
+            id: request_id,
+            error: { code: -32002, message: `WebSocket connection failed to ${url}. Is the Unity Editor running?` }
+          });
+        }
+      };
+      ws.onclose = () => {
+        if (!resolved) {
+          resolved = true;
+          clearTimeout(timer);
+          resolve5({
+            jsonrpc: "2.0",
+            id: request_id,
+            error: { code: -32003, message: "WebSocket connection closed before response received" }
+          });
+        }
+      };
+    } catch (err) {
+      if (!resolved) {
+        resolved = true;
+        clearTimeout(timer);
+        resolve5({
+          jsonrpc: "2.0",
+          id: request_id,
+          error: { code: -32002, message: `Failed to connect: ${err instanceof Error ? err.message : String(err)}` }
+        });
+      }
+    }
+  });
+}
+async function stream_editor(options) {
+  const { method, params, timeout = 30000, on_event } = options;
+  const config = resolve_config(options);
+  if ("error" in config) {
+    throw new Error(config.error);
+  }
+  const MAX_RECONNECTS = 5;
+  let reconnect_count = 0;
+  let stopped = false;
+  return new Promise((resolve5, reject) => {
+    let resolved = false;
+    function connect(url) {
+      const ws = new WebSocket(url);
+      const request_id = generate_id();
+      const request = {
+        jsonrpc: "2.0",
+        id: request_id,
+        method,
+        ...params ? { params } : {}
+      };
+      let connected = false;
+      const timer = !resolved ? setTimeout(() => {
+        if (!connected && !resolved) {
+          reject(new Error(`Timeout connecting to ${url}`));
+        }
+      }, timeout) : null;
+      ws.onopen = () => {
+        connected = true;
+        if (timer)
+          clearTimeout(timer);
+        reconnect_count = 0;
+        ws.send(JSON.stringify(request));
+        if (!resolved) {
+          resolved = true;
+          resolve5({ close: () => {
+            stopped = true;
+            ws.close();
+          } });
+        }
+      };
+      ws.onmessage = (event) => {
+        try {
+          const data = JSON.parse(String(event.data));
+          if ("method" in data && !("id" in data)) {
+            on_event(data);
+          }
+        } catch {}
+      };
+      ws.onerror = () => {
+        if (!connected && !resolved) {
+          if (timer)
+            clearTimeout(timer);
+          reject(new Error(`WebSocket connection failed to ${url}`));
+        }
+      };
+      ws.onclose = () => {
+        if (stopped)
+          return;
+        if (!connected && !resolved)
+          return;
+        if (reconnect_count >= MAX_RECONNECTS)
+          return;
+        reconnect_count++;
+        const delay = Math.min(500 * reconnect_count, 3000);
+        setTimeout(() => {
+          if (stopped)
+            return;
+          const fresh_config = resolve_config(options);
+          if ("error" in fresh_config)
+            return;
+          connect(`ws://127.0.0.1:${fresh_config.port}/unity-agentic`);
+        }, delay);
+      };
+    }
+    connect(`ws://127.0.0.1:${config.port}/unity-agentic`);
+  });
+}
+async function ping_editor(port, timeout_ms = 2000) {
+  return new Promise((resolve5) => {
+    const timer = setTimeout(() => {
+      resolve5({ reachable: false, error: `Timeout after ${timeout_ms}ms` });
+    }, timeout_ms);
+    try {
+      const ws = new WebSocket(`ws://127.0.0.1:${port}/unity-agentic`);
+      ws.onopen = () => {
+        clearTimeout(timer);
+        try {
+          ws.close();
+        } catch {}
+        resolve5({ reachable: true });
+      };
+      ws.onerror = (err) => {
+        clearTimeout(timer);
+        resolve5({ reachable: false, error: String(err) });
+      };
+    } catch (err) {
+      clearTimeout(timer);
+      resolve5({ reachable: false, error: String(err) });
+    }
+  });
+}
+function resolve_config(options) {
+  if (options.port) {
+    return { port: options.port, pid: 0, version: "unknown" };
+  }
+  return read_editor_config(options.project_path);
+}
+function is_pid_alive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function generate_id() {
+  return `${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+}
+
+// src/loaded-protection.ts
+function normalize_slashes(value) {
+  return value.replace(/\\/g, "/");
+}
+function to_project_asset_path(file_path, project_path) {
+  const abs_file = import_path9.resolve(file_path);
+  const abs_project = import_path9.resolve(project_path);
+  const rel = import_path9.relative(abs_project, abs_file);
+  if (!rel || rel.startsWith("..") || rel.includes(`..${import_path9.sep}`)) {
+    if (/^Assets[\\/]/.test(file_path)) {
+      return normalize_slashes(file_path);
+    }
+    return null;
+  }
+  return normalize_slashes(rel);
+}
+function normalize_loaded_paths(paths) {
+  return new Set(paths.map((p) => normalize_slashes(p)));
+}
+async function get_loaded_state(project_path) {
+  const config = read_editor_config(project_path);
+  if ("error" in config)
+    return null;
+  const ping = await ping_editor(config.port, 1200);
+  if (!ping.reachable)
+    return null;
+  const response = await call_editor({
+    project_path,
+    method: "editor.scene.loaded",
+    timeout: 2500
+  });
+  if (response.error || !response.result || typeof response.result !== "object") {
+    return null;
+  }
+  const result = response.result;
+  const loaded = Array.isArray(result.loaded_scene_paths) ? result.loaded_scene_paths.filter((v) => typeof v === "string") : [];
+  return {
+    loaded_scene_paths: loaded,
+    active_scene_path: typeof result.active_scene_path === "string" ? result.active_scene_path : undefined,
+    prefab_stage_path: typeof result.prefab_stage_path === "string" ? result.prefab_stage_path : undefined
+  };
+}
+async function is_editor_connected_for_project(project_path) {
+  const resolved_project = resolve_project_path(project_path);
+  const config = read_editor_config(resolved_project);
+  if ("error" in config)
+    return false;
+  const ping = await ping_editor(config.port, 1200);
+  return ping.reachable;
+}
+async function enforce_loaded_edit_protection(file_path, bypass, project_path) {
+  if (bypass)
+    return { allowed: true };
+  const ext = file_path.toLowerCase().split(".").pop();
+  if (!ext || ext !== "unity" && ext !== "prefab") {
+    return { allowed: true };
+  }
+  const inferred_project = project_path ? resolve_project_path(project_path) : find_unity_project_root(import_path9.dirname(import_path9.resolve(file_path))) || process.cwd();
+  const loaded_state = await get_loaded_state(inferred_project);
+  if (!loaded_state) {
+    return { allowed: true };
+  }
+  const target_asset_path = to_project_asset_path(file_path, inferred_project);
+  if (!target_asset_path) {
+    return { allowed: true };
+  }
+  const loaded_scenes = normalize_loaded_paths(loaded_state.loaded_scene_paths);
+  const active_scene = loaded_state.active_scene_path ? normalize_slashes(loaded_state.active_scene_path) : "";
+  const prefab_stage = loaded_state.prefab_stage_path ? normalize_slashes(loaded_state.prefab_stage_path) : "";
+  if (target_asset_path.endsWith(".unity")) {
+    if (loaded_scenes.has(target_asset_path)) {
+      const reason = active_scene === target_asset_path ? "it is currently the active scene in the Unity Editor" : "it is currently loaded in the Unity Editor";
+      return {
+        allowed: false,
+        error: `Refusing to edit ${target_asset_path}: ${reason}. Use --bypass-loaded-protection to force file-based edits while editor is connected.`
+      };
+    }
+  }
+  if (target_asset_path.endsWith(".prefab")) {
+    if (prefab_stage === target_asset_path) {
+      return {
+        allowed: false,
+        error: `Refusing to edit ${target_asset_path}: it is currently open in Prefab Mode. Use --bypass-loaded-protection to force file-based edits while editor is connected.`
+      };
+    }
+  }
+  return { allowed: true };
+}
+
+// src/cmd-create.ts
+function build_create_command() {
+  const cmd = new Command("create").description("Create Unity objects (GameObjects, scenes, prefabs, components)");
+  cmd.command("gameobject <file> [name]").description("Create a new GameObject in a Unity file").option("-p, --parent <name|id>", "Parent GameObject name or Transform fileID").option("-n, --name <name>", "GameObject name (alternative to positional arg)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, name_positional, options) => {
+    const name = name_positional || options.name;
+    if (!name) {
+      console.log(JSON.stringify({
+        success: false,
+        error: "Missing required name. Provide as positional argument or --name flag.",
+        correct_usage: [
+          "unity-agentic-tools create gameobject <file> <name>",
+          "unity-agentic-tools create gameobject <file> --name <name>"
+        ]
+      }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
+    const ext = file.toLowerCase().split(".").pop();
+    if (!ext || !["unity", "prefab", "asset"].includes(ext)) {
+      console.log(JSON.stringify({ success: false, error: `Invalid file type ".${ext}". create gameobject only works with .unity, .prefab, or .asset files` }, null, 2));
+      process.exitCode = 1;
       return;
     }
     let parent;
@@ -11129,6 +11951,12 @@ function build_create_command() {
       const asNumber = parseInt(options.parent, 10);
       parent = isNaN(asNumber) ? options.parent : asNumber;
     }
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = createGameObject({
       file_path: file,
       name,
@@ -11157,7 +11985,7 @@ function build_create_command() {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("prefab-instance <scene_file> <prefab_path>").description("Instantiate a prefab into a scene file").option("-n, --name <name>", "Instance name (defaults to prefab filename)").option("-p, --parent <name|id>", "Parent GameObject name or Transform fileID").option("--position <x,y,z>", "Local position (default: 0,0,0)").option("-j, --json", "Output as JSON").action((scene_file, prefab_path_arg, options) => {
+  cmd.command("prefab-instance <scene_file> <prefab_path>").description("Instantiate a prefab into a scene file").option("-n, --name <name>", "Instance name (defaults to prefab filename)").option("-p, --parent <name|id>", "Parent GameObject name or Transform fileID").option("--position <x,y,z>", "Local position (default: 0,0,0)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (scene_file, prefab_path_arg, options) => {
     let position;
     if (options.position) {
       const parts = options.position.split(",").map(Number);
@@ -11176,6 +12004,12 @@ function build_create_command() {
       const asNumber = parseInt(options.parent, 10);
       parent = isNaN(asNumber) ? options.parent : asNumber;
     }
+    const guard = await enforce_loaded_edit_protection(scene_file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: scene_file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = createPrefabInstance({
       scene_path: scene_file,
       prefab_path: prefab_path_arg,
@@ -11216,12 +12050,18 @@ function build_create_command() {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("component <file> <object_name> <component>").description("Add a Unity component (e.g., MeshRenderer, Animator, Rigidbody) or custom script").option("-p, --project <path>", "Unity project path (for script GUID lookup)").option("-j, --json", "Output as JSON").action((file, object_name, component, options) => {
+  cmd.command("component <file> <object_name> <component>").description("Add a Unity component (e.g., MeshRenderer, Animator, Rigidbody) or custom script").option("-p, --project <path>", "Unity project path (for script GUID lookup)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, object_name, component, options) => {
     if (!component || component.trim() === "") {
       console.log(JSON.stringify({ success: false, file_path: file, error: "Component name must not be empty" }, null, 2));
       process.exitCode = 1;
       return;
     }
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection, options.project);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = addComponent({
       file_path: file,
       game_object_name: object_name,
@@ -11232,7 +12072,13 @@ function build_create_command() {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("component-copy <file> <source_file_id> <target_object_name>").description("Copy a component to a target GameObject").option("-j, --json", "Output as JSON").action((file, source_file_id, target_object_name, _options) => {
+  cmd.command("component-copy <file> <source_file_id> <target_object_name>").description("Copy a component to a target GameObject").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, source_file_id, target_object_name, options) => {
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = copyComponent({
       file_path: file,
       source_file_id,
@@ -11260,7 +12106,7 @@ function build_create_command() {
       console.log(JSON.stringify({ success: false, error: "--shader <guid> is required" }, null, 2));
       process.exit(1);
     }
-    if (import_fs17.existsSync(output_path)) {
+    if (import_fs18.existsSync(output_path)) {
       console.log(JSON.stringify({ success: false, error: `File already exists: ${output_path}` }, null, 2));
       process.exit(1);
     }
@@ -11333,7 +12179,7 @@ Material:
   m_BuildTextureStacks: []
 `;
     ensure_parent_dir(output_path);
-    import_fs17.writeFileSync(output_path, mat_content, "utf-8");
+    import_fs18.writeFileSync(output_path, mat_content, "utf-8");
     const guid = import_crypto2.randomBytes(16).toString("hex");
     const meta_content = `fileFormatVersion: 2
 guid: ${guid}
@@ -11344,7 +12190,7 @@ NativeFormatImporter:
   assetBundleName:
   assetBundleVariant:
 `;
-    import_fs17.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
+    import_fs18.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
     console.log(JSON.stringify({
       success: true,
       file: output_path,
@@ -11375,7 +12221,7 @@ NativeFormatImporter:
       process.exitCode = 1;
       return;
     }
-    if (import_fs17.existsSync(output_path)) {
+    if (import_fs18.existsSync(output_path)) {
       console.log(JSON.stringify({ success: false, error: `File already exists: ${output_path}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -11402,7 +12248,7 @@ ScriptedImporter:
   wrapperClassName:
   wrapperCodeNamespace:
 `;
-    import_fs17.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
+    import_fs18.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
     console.log(JSON.stringify({
       success: true,
       file: output_path,
@@ -11417,8 +12263,8 @@ ScriptedImporter:
       process.exitCode = 1;
       return;
     }
-    const name = name_arg || import_path7.basename(output_path).replace(/\.anim$/i, "");
-    if (import_fs17.existsSync(output_path)) {
+    const name = name_arg || import_path10.basename(output_path).replace(/\.anim$/i, "");
+    if (import_fs18.existsSync(output_path)) {
       console.log(JSON.stringify({ success: false, error: `File already exists: ${output_path}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -11486,7 +12332,7 @@ AnimationClip:
   m_Events: []
 `;
     ensure_parent_dir(output_path);
-    import_fs17.writeFileSync(output_path, anim_content, "utf-8");
+    import_fs18.writeFileSync(output_path, anim_content, "utf-8");
     const guid = import_crypto2.randomBytes(16).toString("hex");
     const meta_content = `fileFormatVersion: 2
 guid: ${guid}
@@ -11497,7 +12343,7 @@ NativeFormatImporter:
   assetBundleName:
   assetBundleVariant:
 `;
-    import_fs17.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
+    import_fs18.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
     console.log(JSON.stringify({
       success: true,
       file: output_path,
@@ -11509,13 +12355,13 @@ NativeFormatImporter:
     }, null, 2));
   });
   cmd.command("animator <output_path> [name]").description("Create a blank .controller AnimatorController file (name defaults to filename without extension)").option("--layer <name>", 'Name of the initial layer (default: "Base Layer")', "Base Layer").option("-j, --json", "Output as JSON").action((output_path, name_arg, options) => {
-    const name = name_arg || import_path7.basename(output_path).replace(/\.controller$/i, "");
+    const name = name_arg || import_path10.basename(output_path).replace(/\.controller$/i, "");
     if (!output_path.toLowerCase().endsWith(".controller")) {
       console.log(JSON.stringify({ success: false, error: "Output path must end with .controller" }, null, 2));
       process.exitCode = 1;
       return;
     }
-    if (import_fs17.existsSync(output_path)) {
+    if (import_fs18.existsSync(output_path)) {
       console.log(JSON.stringify({ success: false, error: `File already exists: ${output_path}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -11566,7 +12412,7 @@ AnimatorStateMachine:
   m_DefaultState: {fileID: 0}
 `;
     ensure_parent_dir(output_path);
-    import_fs17.writeFileSync(output_path, ctrl_content, "utf-8");
+    import_fs18.writeFileSync(output_path, ctrl_content, "utf-8");
     const guid = import_crypto2.randomBytes(16).toString("hex");
     const meta_content = `fileFormatVersion: 2
 guid: ${guid}
@@ -11577,7 +12423,7 @@ NativeFormatImporter:
   assetBundleName:
   assetBundleVariant:
 `;
-    import_fs17.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
+    import_fs18.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
     console.log(JSON.stringify({
       success: true,
       file: output_path,
@@ -11588,13 +12434,13 @@ NativeFormatImporter:
     }, null, 2));
   });
   cmd.command("prefab <output_path> [name]").description("Create a blank .prefab file (name defaults to filename without extension)").option("-j, --json", "Output as JSON").action((output_path, name_arg) => {
-    const name = name_arg || import_path7.basename(output_path).replace(/\.prefab$/i, "");
+    const name = name_arg || import_path10.basename(output_path).replace(/\.prefab$/i, "");
     if (!output_path.toLowerCase().endsWith(".prefab")) {
       console.log(JSON.stringify({ success: false, error: "Output path must end with .prefab" }, null, 2));
       process.exitCode = 1;
       return;
     }
-    if (import_fs17.existsSync(output_path)) {
+    if (import_fs18.existsSync(output_path)) {
       console.log(JSON.stringify({ success: false, error: `File already exists: ${output_path}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -11634,7 +12480,7 @@ Transform:
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
 `;
     ensure_parent_dir(output_path);
-    import_fs17.writeFileSync(output_path, prefab_content, "utf-8");
+    import_fs18.writeFileSync(output_path, prefab_content, "utf-8");
     const guid = import_crypto2.randomBytes(16).toString("hex");
     const meta_content = `fileFormatVersion: 2
 guid: ${guid}
@@ -11644,7 +12490,7 @@ PrefabImporter:
   assetBundleName:
   assetBundleVariant:
 `;
-    import_fs17.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
+    import_fs18.writeFileSync(`${output_path}.meta`, meta_content, "utf-8");
     console.log(JSON.stringify({
       success: true,
       file: output_path,
@@ -11658,8 +12504,8 @@ PrefabImporter:
 
 // src/cmd-read.ts
 init_scanner();
-var import_fs18 = require("fs");
-var import_path8 = require("path");
+var import_fs19 = require("fs");
+var import_path11 = require("path");
 var import_os = require("os");
 function parse_unity_ref(ref_text) {
   const file_id_match = ref_text.match(/fileID:[ \t]*(-?\d+)/i);
@@ -11969,7 +12815,7 @@ function parse_material_yaml(content) {
   return result;
 }
 function categorize_asset(filePath) {
-  const ext = import_path8.extname(filePath).toLowerCase();
+  const ext = import_path11.extname(filePath).toLowerCase();
   const categories = {
     ".cs": "script",
     ".mat": "material",
@@ -12013,12 +12859,12 @@ function categorize_asset(filePath) {
   return categories[ext] || "other";
 }
 function find_project_root_from_file(filePath) {
-  let dir = import_path8.dirname(import_path8.resolve(filePath));
+  let dir = import_path11.dirname(import_path11.resolve(filePath));
   for (let i = 0;i < 20; i++) {
-    if (import_fs18.existsSync(import_path8.join(dir, "Assets")) && import_fs18.existsSync(import_path8.join(dir, "ProjectSettings"))) {
+    if (import_fs19.existsSync(import_path11.join(dir, "Assets")) && import_fs19.existsSync(import_path11.join(dir, "ProjectSettings"))) {
       return dir;
     }
-    const parent = import_path8.dirname(dir);
+    const parent = import_path11.dirname(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -12028,13 +12874,13 @@ function find_project_root_from_file(filePath) {
 function get_editor_log_path() {
   const p = import_os.platform();
   if (p === "darwin")
-    return import_path8.join(import_os.homedir(), "Library", "Logs", "Unity", "Editor.log");
+    return import_path11.join(import_os.homedir(), "Library", "Logs", "Unity", "Editor.log");
   if (p === "win32") {
-    const localAppData = process.env.LOCALAPPDATA || import_path8.join(import_os.homedir(), "AppData", "Local");
-    return import_path8.join(localAppData, "Unity", "Editor", "Editor.log");
+    const localAppData = process.env.LOCALAPPDATA || import_path11.join(import_os.homedir(), "AppData", "Local");
+    return import_path11.join(localAppData, "Unity", "Editor", "Editor.log");
   }
   if (p === "linux")
-    return import_path8.join(import_os.homedir(), ".config", "unity3d", "Editor.log");
+    return import_path11.join(import_os.homedir(), ".config", "unity3d", "Editor.log");
   return null;
 }
 function parse_log_line_timestamp(line) {
@@ -12365,19 +13211,19 @@ function walk_files(dir, extensions) {
     const current = stack.pop();
     let entries;
     try {
-      entries = import_fs18.readdirSync(current);
+      entries = import_fs19.readdirSync(current);
     } catch {
       continue;
     }
     for (const entry of entries) {
       if (entry.startsWith("."))
         continue;
-      const full = import_path8.join(current, entry);
+      const full = import_path11.join(current, entry);
       try {
-        const stat = import_fs18.statSync(full);
+        const stat = import_fs19.statSync(full);
         if (stat.isDirectory()) {
           stack.push(full);
-        } else if (extensions.has(import_path8.extname(full).toLowerCase())) {
+        } else if (extensions.has(import_path11.extname(full).toLowerCase())) {
           results.push(full);
         }
       } catch {
@@ -12388,7 +13234,7 @@ function walk_files(dir, extensions) {
   return results;
 }
 function validate_unity_yaml(file) {
-  if (!import_fs18.existsSync(file)) {
+  if (!import_fs19.existsSync(file)) {
     return `File not found: ${file}`;
   }
   try {
@@ -12484,7 +13330,7 @@ function build_read_command(getScanner) {
           if (strippedGoCount > 0) {
             variantDetected = true;
           }
-          const projectPath = find_unity_project_root(import_path8.dirname(file));
+          const projectPath = find_unity_project_root(import_path11.dirname(file));
           const resolved = resolve_source_prefab(doc, file, projectPath ?? undefined);
           if (resolved) {
             const sourceResult = getScanner().inspect_all_paginated({
@@ -12527,7 +13373,7 @@ function build_read_command(getScanner) {
       }
       if (result.total === 0) {
         try {
-          const fileSize = import_fs18.statSync(file).size;
+          const fileSize = import_fs19.statSync(file).size;
           if (fileSize > 100) {
             if (variantDetected && !variantResolvedFromSource) {
               const variantWarning = "PrefabVariant detected but source prefab hierarchy could not be resolved (missing project context or GUID cache). Use --project or run setup to resolve source hierarchy.";
@@ -12645,7 +13491,7 @@ function build_read_command(getScanner) {
       console.log(JSON.stringify({ error: matValidationError }, null, 2));
       process.exit(1);
     }
-    const content = import_fs18.readFileSync(file, "utf-8");
+    const content = import_fs19.readFileSync(file, "utf-8");
     if (!content.includes("Material:")) {
       console.log(JSON.stringify({ error: `File "${file}" does not contain a Material block. Use 'read asset' for generic Unity YAML files.` }, null, 2));
       process.exit(1);
@@ -12687,13 +13533,13 @@ function build_read_command(getScanner) {
     }, null, 2));
   });
   cmd.command("dependencies <file>").description("List asset dependencies (GUIDs referenced by this file)").option("--project <path>", "Unity project root (for GUID resolution)").option("--unresolved", "Show only GUIDs that could not be resolved").option("--recursive [depth]", "Follow dependency chain N levels deep (default: 3)").option("-j, --json", "Output as JSON").action((file, options) => {
-    if (!import_fs18.existsSync(file)) {
+    if (!import_fs19.existsSync(file)) {
       console.log(JSON.stringify({ error: `File not found: ${file}` }, null, 2));
       process.exit(1);
     }
     let content;
     try {
-      content = import_fs18.readFileSync(file, "utf-8");
+      content = import_fs19.readFileSync(file, "utf-8");
     } catch {
       console.log(JSON.stringify({ error: `Cannot read file: ${file}` }, null, 2));
       process.exit(1);
@@ -12734,7 +13580,7 @@ function build_read_command(getScanner) {
         const result = [];
         let fileContent;
         try {
-          fileContent = import_fs18.readFileSync(filePath, "utf-8");
+          fileContent = import_fs19.readFileSync(filePath, "utf-8");
         } catch {
           return [];
         }
@@ -12751,7 +13597,7 @@ function build_read_command(getScanner) {
           const rAbsPath = cache.resolve_absolute(g);
           const rType = rPath ? categorize_asset(rPath) : "unknown";
           const dep = { guid: g, path: rPath, type: rType, depth };
-          if (rAbsPath && depth < max_depth && import_fs18.existsSync(rAbsPath)) {
+          if (rAbsPath && depth < max_depth && import_fs19.existsSync(rAbsPath)) {
             const subs = traverse_file(rAbsPath, depth + 1);
             if (subs.length > 0)
               dep.sub_dependencies = subs;
@@ -12780,7 +13626,7 @@ function build_read_command(getScanner) {
         const rDep = { guid: dep.guid, path: dep.path, type: dep.type, depth: 0 };
         if (dep.path) {
           const absPath = cache.resolve_absolute(dep.guid);
-          if (absPath && import_fs18.existsSync(absPath)) {
+          if (absPath && import_fs19.existsSync(absPath)) {
             const subs = traverse_file(absPath, 1);
             if (subs.length > 0)
               rDep.sub_dependencies = subs;
@@ -12979,7 +13825,7 @@ function build_read_command(getScanner) {
   });
   cmd.command("target <file> <gameobject_name> [component_type]").description("Build a --target reference string for prefab override commands").option("-p, --project <path>", "Unity project path").option("-j, --json", "Output as JSON").action((file, gameobject_name, component_type, options) => {
     try {
-      if (!import_fs18.existsSync(file)) {
+      if (!import_fs19.existsSync(file)) {
         console.log(JSON.stringify({ error: `File not found: ${file}` }, null, 2));
         process.exit(1);
       }
@@ -13040,12 +13886,12 @@ function build_read_command(getScanner) {
             if (classId === null && compBlock.class_id === 114) {
               const scriptMatch = compBlock.raw.match(/m_Script:[ \t]*\{[^}]*guid:[ \t]*([a-f0-9]{32})/);
               if (scriptMatch) {
-                const project = options.project || find_unity_project_root(import_path8.dirname(file));
+                const project = options.project || find_unity_project_root(import_path11.dirname(file));
                 if (project) {
                   const cache = load_guid_cache(project);
                   if (cache) {
                     const scriptPath = cache.resolve(scriptMatch[1]);
-                    if (scriptPath && import_path8.basename(scriptPath, ".cs").toLowerCase() === component_type.toLowerCase().replace(/\.cs$/, "")) {
+                    if (scriptPath && import_path11.basename(scriptPath, ".cs").toLowerCase() === component_type.toLowerCase().replace(/\.cs$/, "")) {
                       targetFileId = refId;
                       compFound = true;
                       break;
@@ -13060,7 +13906,7 @@ function build_read_command(getScanner) {
             process.exit(1);
           }
         } else {
-          const project = options.project || find_unity_project_root(import_path8.dirname(file));
+          const project = options.project || find_unity_project_root(import_path11.dirname(file));
           const resolved = resolve_source_prefab(doc, file, project ?? undefined);
           if (resolved) {
             const sourceDoc = UnityDocument.from_file(resolved.source_path);
@@ -13099,7 +13945,7 @@ function build_read_command(getScanner) {
     }
   });
   cmd.command("script <file>").description("Extract C# type declarations from a .cs file or .NET DLL").option("-j, --json", "Output as JSON").action((file, _options) => {
-    if (!import_fs18.existsSync(file)) {
+    if (!import_fs19.existsSync(file)) {
       console.log(JSON.stringify({ error: `File not found: ${file}` }, null, 2));
       process.exit(1);
     }
@@ -13135,7 +13981,7 @@ function build_read_command(getScanner) {
       console.log(JSON.stringify({ error: "Native module not available" }, null, 2));
       process.exit(1);
     }
-    const projectPath = import_path8.resolve(options.project);
+    const projectPath = import_path11.resolve(options.project);
     const validSources = ["assets", "packages", "dlls", "all"];
     if (!validSources.includes(options.source)) {
       console.log(JSON.stringify({ error: `Invalid --source "${options.source}". Valid values: ${validSources.join(", ")}` }, null, 2));
@@ -13186,15 +14032,15 @@ function build_read_command(getScanner) {
   });
   cmd.command("log").description("Read and filter the Unity Editor.log").option("--path <file>", "Path to Editor.log (auto-detected if omitted)").option("--project <path>", "Filter to log entries from a specific Unity project session").option("--tail <n>", "Show last N lines (default 50)", "50").option("--errors", "Show only error entries").option("--warnings", "Show only warning entries").option("--compile-errors", "Show only C# compilation errors").option("--import-errors", "Show only asset import errors").option("--since <timestamp>", "Filter entries after this timestamp (YYYY-MM-DD or HH:MM:SS)").option("--search <pattern>", "Regex filter on log content").option("-j, --json", "Output as JSON").action((options) => {
     const logPath = options.path || get_editor_log_path();
-    if (!logPath || !import_fs18.existsSync(logPath)) {
+    if (!logPath || !import_fs19.existsSync(logPath)) {
       console.log(JSON.stringify({ error: `Editor.log not found${logPath ? `: ${logPath}` : ". Could not detect platform log path."}` }, null, 2));
       process.exit(1);
     }
-    const content = import_fs18.readFileSync(logPath, "utf-8");
+    const content = import_fs19.readFileSync(logPath, "utf-8");
     let lines = content.split(/\r?\n/);
     if (options.project) {
-      const projectPath = import_path8.resolve(options.project);
-      const projectName = import_path8.basename(projectPath);
+      const projectPath = import_path11.resolve(options.project);
+      const projectName = import_path11.basename(projectPath);
       const escapedPath = projectPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       const escapedName = projectName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       const session_markers = [
@@ -13315,11 +14161,11 @@ function build_read_command(getScanner) {
   });
   cmd.command("meta <file>").description("Read a Unity .meta file and show importer settings").option("--summary", "Show importer type and key settings only").option("-j, --json", "Output as JSON").action((file, options) => {
     const metaPath = file.endsWith(".meta") ? file : `${file}.meta`;
-    if (!import_fs18.existsSync(metaPath)) {
+    if (!import_fs19.existsSync(metaPath)) {
       console.log(JSON.stringify({ error: `Meta file not found: ${metaPath}` }, null, 2));
       process.exit(1);
     }
-    const content = import_fs18.readFileSync(metaPath, "utf-8");
+    const content = import_fs19.readFileSync(metaPath, "utf-8");
     const lines = content.split(/\r?\n/);
     let guid = "";
     let importer_type = "Unknown";
@@ -13407,7 +14253,7 @@ function build_read_command(getScanner) {
       console.log(JSON.stringify({ error: animValidationError }, null, 2));
       process.exit(1);
     }
-    const content = import_fs18.readFileSync(file, "utf-8");
+    const content = import_fs19.readFileSync(file, "utf-8");
     const clip = parse_animation_yaml(content, options.curves === true);
     if (!clip) {
       console.log(JSON.stringify({ error: `No AnimationClip found in "${file}". Is this an .anim file?` }, null, 2));
@@ -13468,7 +14314,7 @@ function build_read_command(getScanner) {
       console.log(JSON.stringify({ error: ctrlValidationError }, null, 2));
       process.exit(1);
     }
-    const content = import_fs18.readFileSync(file, "utf-8");
+    const content = import_fs19.readFileSync(file, "utf-8");
     const blocks = split_yaml_blocks(content);
     const controller_block = blocks.find((b) => b.class_id === 91);
     if (!controller_block) {
@@ -13659,7 +14505,7 @@ function build_read_command(getScanner) {
     if (options.summary) {
       console.log(JSON.stringify({
         file,
-        name: yaml_field(controller_block.raw, "m_Name") || import_path8.basename(file),
+        name: yaml_field(controller_block.raw, "m_Name") || import_path11.basename(file),
         parameter_count: params.length,
         layer_count: layers.length,
         state_count: states.length,
@@ -13672,7 +14518,7 @@ function build_read_command(getScanner) {
       default_state_names[s.file_id] = s.name;
     const default_out = {
       file,
-      name: yaml_field(controller_block.raw, "m_Name") || import_path8.basename(file),
+      name: yaml_field(controller_block.raw, "m_Name") || import_path11.basename(file),
       parameters: params,
       layers: layers.map((l) => l.name),
       states: states.map((s) => ({
@@ -13698,8 +14544,8 @@ function build_read_command(getScanner) {
       process.exit(1);
     }
     const project_path = resolve_project_path(options.project);
-    const assetsDir = import_path8.join(import_path8.resolve(project_path), "Assets");
-    if (!import_fs18.existsSync(assetsDir)) {
+    const assetsDir = import_path11.join(import_path11.resolve(project_path), "Assets");
+    if (!import_fs19.existsSync(assetsDir)) {
       console.log(JSON.stringify({ error: `Assets directory not found in "${project_path}"` }, null, 2));
       process.exit(1);
     }
@@ -13728,9 +14574,9 @@ function build_read_command(getScanner) {
     const guid_pattern = `guid: ${guid}`;
     for (const f of files) {
       try {
-        const fc = import_fs18.readFileSync(f, "utf-8");
+        const fc = import_fs19.readFileSync(f, "utf-8");
         if (fc.includes(guid_pattern)) {
-          const rel = import_path8.relative(import_path8.resolve(project_path), f);
+          const rel = import_path11.relative(import_path11.resolve(project_path), f);
           const ftype = categorize_asset(f);
           referencing.push({ path: rel, type: ftype });
         }
@@ -13749,7 +14595,7 @@ function build_read_command(getScanner) {
       by_type[r.type].push(r.path);
     }
     console.log(JSON.stringify({
-      project_path: import_path8.resolve(project_path),
+      project_path: import_path11.resolve(project_path),
       guid,
       total_references: filtered.length,
       by_type
@@ -13757,8 +14603,8 @@ function build_read_command(getScanner) {
   });
   cmd.command("unused").description("Find potentially unused assets (zero inbound GUID references)").option("-p, --project <path>", "Unity project path (defaults to cwd)").option("--type <type>", "Filter to specific asset types").option("--ignore <glob>", "Exclude paths matching this pattern").option("--max <n>", "Maximum results to return (default 200)", "200").option("-j, --json", "Output as JSON").action((options) => {
     const resolvedProject = resolve_project_path(options.project);
-    const assetsDir = import_path8.join(resolvedProject, "Assets");
-    if (!import_fs18.existsSync(assetsDir)) {
+    const assetsDir = import_path11.join(resolvedProject, "Assets");
+    if (!import_fs19.existsSync(assetsDir)) {
       console.log(JSON.stringify({ error: `Assets directory not found in "${resolvedProject}"` }, null, 2));
       process.exit(1);
     }
@@ -13786,7 +14632,7 @@ function build_read_command(getScanner) {
     const guid_re = /guid:\s*([a-f0-9]{32})/g;
     for (const f of files) {
       try {
-        const fc = import_fs18.readFileSync(f, "utf-8");
+        const fc = import_fs19.readFileSync(f, "utf-8");
         let gm;
         while ((gm = guid_re.exec(fc)) !== null) {
           referenced_guids.add(gm[1]);
@@ -13795,10 +14641,10 @@ function build_read_command(getScanner) {
         continue;
       }
     }
-    const buildSettingsPath = import_path8.join(resolvedProject, "ProjectSettings", "EditorBuildSettings.asset");
+    const buildSettingsPath = import_path11.join(resolvedProject, "ProjectSettings", "EditorBuildSettings.asset");
     const build_scene_guids = new Set;
-    if (import_fs18.existsSync(buildSettingsPath)) {
-      const bsc = import_fs18.readFileSync(buildSettingsPath, "utf-8");
+    if (import_fs19.existsSync(buildSettingsPath)) {
+      const bsc = import_fs19.readFileSync(buildSettingsPath, "utf-8");
       let bm;
       while ((bm = guid_re.exec(bsc)) !== null) {
         build_scene_guids.add(bm[1]);
@@ -13819,7 +14665,7 @@ function build_read_command(getScanner) {
         continue;
       if (ignore_pattern && ignore_pattern.test(asset_path))
         continue;
-      if (import_path8.extname(asset_path) === "")
+      if (import_path11.extname(asset_path) === "")
         continue;
       const asset_type = categorize_asset(asset_path);
       if (options.type && asset_type !== options.type)
@@ -13921,8 +14767,8 @@ function build_read_command(getScanner) {
 }
 
 // src/cmd-update.ts
-var import_fs19 = require("fs");
-var import_path9 = require("path");
+var import_fs20 = require("fs");
+var import_path12 = require("path");
 
 // src/animator-utils.ts
 function split_yaml_blocks2(content) {
@@ -14051,7 +14897,13 @@ function parseVector(str) {
   }
   return { x: parts[0], y: parts[1], z: parts[2] };
 }
-function resolve_transform_id(scanner, file, identifier) {
+function resolve_transform_id(scanner, file, identifier, by_id = false) {
+  if (by_id) {
+    if (!/^-?\d+$/.test(identifier)) {
+      return { error: `Invalid fileID: "${identifier}" \u2014 expected a numeric value when using --by-id` };
+    }
+    return { transform_id: identifier };
+  }
   let resolved_id = identifier;
   if (!/^-?\d+$/.test(identifier)) {
     const matches = scanner.find_by_name(file, identifier, false);
@@ -14076,7 +14928,17 @@ function resolve_transform_id(scanner, file, identifier) {
 }
 function build_update_command(getScanner) {
   const cmd = new Command("update").description("Update Unity object properties, transforms, settings, and hierarchy");
-  cmd.command("gameobject <file> <object_name> <property> <value>").description("Edit GameObject property value safely").option("-j, --json", "Output as JSON").option("-p, --project <path>", "Unity project path (for tag validation)").action((file, object_name, property, value, options) => {
+  async function check_loaded_edit_protection(file, bypass, project_path) {
+    const guard = await enforce_loaded_edit_protection(file, bypass, project_path);
+    if (guard.allowed)
+      return true;
+    console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+    process.exitCode = 1;
+    return false;
+  }
+  cmd.command("gameobject <file> <object_name> <property> <value>").description("Edit GameObject property value safely").option("-j, --json", "Output as JSON").option("-p, --project <path>", "Unity project path (for tag validation)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, object_name, property, value, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection, options.project))
+      return;
     const result = editProperty({
       file_path: file,
       object_name,
@@ -14088,7 +14950,7 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("component <file> <file_id> <property> <value>").description("Edit any component property by file ID. Supports dotted paths (m_LocalPosition.x) and array paths (m_Materials.Array.data[0]). Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("-j, --json", "Output as JSON").option("-p, --project <path>", "Unity project path (for asset reference resolution)").action((file, file_id, property, value, options) => {
+  cmd.command("component <file> <file_id> <property> <value>").description("Edit any component property by file ID. Supports dotted paths (m_LocalPosition.x) and array paths (m_Materials.Array.data[0]). Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("-j, --json", "Output as JSON").option("-p, --project <path>", "Unity project path (for asset reference resolution)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, file_id, property, value, options) => {
     if (property === "m_RootOrder") {
       const num = Number(value);
       if (!Number.isInteger(num) || num < 0) {
@@ -14097,6 +14959,8 @@ function build_update_command(getScanner) {
         return;
       }
     }
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection, options.project))
+      return;
     const result = editComponentByFileId({
       file_path: file,
       file_id,
@@ -14108,7 +14972,7 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("transform <file> <identifier>").description("Edit Transform by GameObject name or transform fileID").option("-p, --position <x,y,z>", "Set local position").option("-r, --rotation <x,y,z>", "Set local rotation (Euler angles in degrees)").option("-s, --scale <x,y,z>", "Set local scale").option("-j, --json", "Output as JSON").action((file, identifier, options) => {
+  cmd.command("transform <file> <identifier>").description("Edit Transform by GameObject name or transform fileID. Use --by-id to force numeric fileID mode").option("-p, --position <x,y,z>", "Set local position").option("-r, --rotation <x,y,z>", "Set local rotation (Euler angles in degrees)").option("-s, --scale <x,y,z>", "Set local scale").option("--by-id", "Treat identifier as a numeric fileID instead of name lookup").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, identifier, options) => {
     if (!options.position && !options.rotation && !options.scale) {
       console.log(JSON.stringify({
         success: false,
@@ -14118,7 +14982,9 @@ function build_update_command(getScanner) {
       process.exitCode = 1;
       return;
     }
-    const resolved = resolve_transform_id(getScanner(), file, identifier);
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
+    const resolved = resolve_transform_id(getScanner(), file, identifier, options.byId);
     if ("error" in resolved) {
       console.log(JSON.stringify({
         success: false,
@@ -14227,7 +15093,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("parent <file> <object_name> <new_parent>").description('Move a GameObject under a new parent. Use "root" to move to scene root. Use --by-id to specify fileIDs instead of names').option("-j, --json", "Output as JSON").option("--by-id", "Treat object_name and new_parent as numeric fileIDs instead of names").action((file, object_name, new_parent, options) => {
+  cmd.command("parent <file> <object_name> <new_parent>").description('Move a GameObject under a new parent. Use "root" to move to scene root. Use --by-id to specify fileIDs instead of names').option("-j, --json", "Output as JSON").option("--by-id", "Treat object_name and new_parent as numeric fileIDs instead of names").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, object_name, new_parent, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = reparentGameObject({
       file_path: file,
       object_name,
@@ -14239,7 +15107,9 @@ function build_update_command(getScanner) {
       process.exitCode = 1;
   });
   const prefab_cmd = new Command("prefab").description("Prefab operations (unpack, override, remove-override, remove/restore component/gameobject)");
-  prefab_cmd.command("unpack <file> <prefab_instance>").description("Unpack a PrefabInstance into standalone GameObjects").option("-p, --project <path>", "Unity project path (for GUID cache lookup)").option("-j, --json", "Output as JSON").action((file, prefab_instance, options) => {
+  prefab_cmd.command("unpack <file> <prefab_instance>").description("Unpack a PrefabInstance into standalone GameObjects").option("-p, --project <path>", "Unity project path (for GUID cache lookup)").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection, options.project))
+      return;
     const result = unpackPrefab({
       file_path: file,
       prefab_instance,
@@ -14249,7 +15119,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("override <file> <prefab_instance> <property_path> <value>").description("Edit or add a property override in a PrefabInstance m_Modifications list. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--object-reference <ref>", "Object reference value (default: {fileID: 0})").option("--managed-reference <id>", "Managed reference ID -- placed in value: field, forces objectReference: {fileID: 0}").option("--target <target>", 'Target reference for new entries (e.g., "{fileID: 400000, guid: abc, type: 3}")').option("-j, --json", "Output as JSON").action((file, prefab_instance, property_path, value, options) => {
+  prefab_cmd.command("override <file> <prefab_instance> <property_path> <value>").description("Edit or add a property override in a PrefabInstance m_Modifications list. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--object-reference <ref>", "Object reference value (default: {fileID: 0})").option("--managed-reference <id>", "Managed reference ID -- placed in value: field, forces objectReference: {fileID: 0}").option("--target <target>", 'Target reference for new entries (e.g., "{fileID: 400000, guid: abc, type: 3}")').option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, property_path, value, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     if (options.objectReference && !/^\{fileID:/.test(options.objectReference)) {
       console.error(`Warning: --object-reference "${options.objectReference}" does not look like a Unity object reference ({fileID: ...}). For managed reference IDs, use --managed-reference instead or pass the ID as the <value> argument.`);
     }
@@ -14266,7 +15138,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("batch-overrides <file> <prefab_instance> <edits_json>").description('Batch edit multiple property overrides in a PrefabInstance. JSON format: [{"property_path":"...","value":"...","target":"...","object_reference":"..."}]').option("-j, --json", "Output as JSON").action((file, prefab_instance, edits_json, _options) => {
+  prefab_cmd.command("batch-overrides <file> <prefab_instance> <edits_json>").description('Batch edit multiple property overrides in a PrefabInstance. JSON format: [{"property_path":"...","value":"...","target":"...","object_reference":"..."}]').option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, edits_json, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     let raw_edits;
     try {
       const parsed = JSON.parse(edits_json);
@@ -14305,7 +15179,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("managed-reference <file> <prefab_instance> <field_path> <type_name>").description("Add a [SerializeReference] managed reference to a prefab override. Auto-generates rid and creates type/data/version override entries.").requiredOption("--target <ref>", 'Target reference (e.g., "{fileID: 400000, guid: ..., type: 3}")').option("--index <n>", "Array index (default: 0)", "0").option("-p, --project <path>", "Unity project path (for type registry)").option("-j, --json", "Output as JSON").action((file, prefab_instance, field_path, type_name, options) => {
+  prefab_cmd.command("managed-reference <file> <prefab_instance> <field_path> <type_name>").description("Add a [SerializeReference] managed reference to a prefab override. Auto-generates rid and creates type/data/version override entries.").requiredOption("--target <ref>", 'Target reference (e.g., "{fileID: 400000, guid: ..., type: 3}")').option("--index <n>", "Array index (default: 0)", "0").option("-p, --project <path>", "Unity project path (for type registry)").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, field_path, type_name, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection, options.project))
+      return;
     const result = addPrefabManagedReference({
       file_path: file,
       prefab_instance,
@@ -14346,7 +15222,7 @@ function build_update_command(getScanner) {
       process.exitCode = 1;
     }
   });
-  cmd.command("array <file> <file_id> <array_property> <action> [args...]").description("Insert, append, or remove array elements in a component. Insert: <index> <value> or <value> --index <n>. Append: <value>. Remove: <index> or --index <n>. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--index <n>", "Index for insert/remove").option("-j, --json", "Output as JSON").action((file, file_id, array_property, action, args, options) => {
+  cmd.command("array <file> <file_id> <array_property> <action> [args...]").description("Insert, append, or remove array elements in a component. Insert: <index> <value> or <value> --index <n>. Append: <value>. Remove: <index> or --index <n>. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--index <n>", "Index for insert/remove").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, file_id, array_property, action, args, options) => {
     if (action !== "insert" && action !== "append" && action !== "remove") {
       console.log(JSON.stringify({ success: false, error: 'Action must be "insert", "append", or "remove"' }, null, 2));
       process.exit(1);
@@ -14387,6 +15263,8 @@ function build_update_command(getScanner) {
         }
       }
     }
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = editArray({
       file_path: file,
       file_id,
@@ -14399,7 +15277,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("batch <file> <edits_json>").description('Batch edit multiple GameObject properties in a single file operation. JSON format: [{"object_name":"...","property":"...","value":"..."}]').option("-j, --json", "Output as JSON").action((file, edits_json, _options) => {
+  cmd.command("batch <file> <edits_json>").description('Batch edit multiple GameObject properties in a single file operation. JSON format: [{"object_name":"...","property":"...","value":"..."}]').option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, edits_json, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     let raw_edits;
     try {
       const parsed = JSON.parse(edits_json);
@@ -14440,7 +15320,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("batch-components <file> <edits_json>").description('Batch edit multiple component properties by fileID in a single operation. JSON format: [{"file_id":"...","property":"...","value":"..."}]').option("-j, --json", "Output as JSON").action((file, edits_json, _options) => {
+  cmd.command("batch-components <file> <edits_json>").description('Batch edit multiple component properties by fileID in a single operation. JSON format: [{"file_id":"...","property":"...","value":"..."}]').option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, edits_json, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     let raw_edits;
     try {
       const parsed = JSON.parse(edits_json);
@@ -14481,7 +15363,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("remove-override <file> <prefab_instance> <property_path>").description("Remove a property override from a PrefabInstance. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--target <ref>", "Target reference to match (for disambiguation)").option("-j, --json", "Output as JSON").action((file, prefab_instance, property_path, options) => {
+  prefab_cmd.command("remove-override <file> <prefab_instance> <property_path>").description("Remove a property override from a PrefabInstance. Quote paths with brackets or use dot notation (data.0) to avoid shell glob expansion").option("--target <ref>", "Target reference to match (for disambiguation)").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, property_path, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = removePrefabOverride({
       file_path: file,
       prefab_instance,
@@ -14492,7 +15376,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("remove-component <file> <prefab_instance> <component_ref>").description("Add a component to the PrefabInstance m_RemovedComponents list").option("-j, --json", "Output as JSON").action((file, prefab_instance, component_ref, _options) => {
+  prefab_cmd.command("remove-component <file> <prefab_instance> <component_ref>").description("Add a component to the PrefabInstance m_RemovedComponents list").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, component_ref, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = addRemovedComponent({
       file_path: file,
       prefab_instance,
@@ -14502,7 +15388,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("restore-component <file> <prefab_instance> <component_ref>").description("Remove a component from the PrefabInstance m_RemovedComponents list (restore it)").option("-j, --json", "Output as JSON").action((file, prefab_instance, component_ref, _options) => {
+  prefab_cmd.command("restore-component <file> <prefab_instance> <component_ref>").description("Remove a component from the PrefabInstance m_RemovedComponents list (restore it)").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, component_ref, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = removeRemovedComponent({
       file_path: file,
       prefab_instance,
@@ -14512,7 +15400,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("remove-gameobject <file> <prefab_instance> <gameobject_ref>").description("Add a GameObject to the PrefabInstance m_RemovedGameObjects list").option("-j, --json", "Output as JSON").action((file, prefab_instance, gameobject_ref, _options) => {
+  prefab_cmd.command("remove-gameobject <file> <prefab_instance> <gameobject_ref>").description("Add a GameObject to the PrefabInstance m_RemovedGameObjects list").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, gameobject_ref, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = addRemovedGameObject({
       file_path: file,
       prefab_instance,
@@ -14522,7 +15412,9 @@ function build_update_command(getScanner) {
     if (!result.success)
       process.exitCode = 1;
   });
-  prefab_cmd.command("restore-gameobject <file> <prefab_instance> <gameobject_ref>").description("Remove a GameObject from the PrefabInstance m_RemovedGameObjects list (restore it)").option("-j, --json", "Output as JSON").action((file, prefab_instance, gameobject_ref, _options) => {
+  prefab_cmd.command("restore-gameobject <file> <prefab_instance> <gameobject_ref>").description("Remove a GameObject from the PrefabInstance m_RemovedGameObjects list (restore it)").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, prefab_instance, gameobject_ref, options) => {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
     const result = removeRemovedGameObject({
       file_path: file,
       prefab_instance,
@@ -14542,11 +15434,11 @@ function build_update_command(getScanner) {
       }
     }
   }).action((file, options) => {
-    if (!import_fs19.existsSync(file)) {
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exit(1);
     }
-    let content = import_fs19.readFileSync(file, "utf-8");
+    let content = import_fs20.readFileSync(file, "utf-8");
     const changes = [];
     if (options.shader) {
       const guid = options.shader;
@@ -14695,7 +15587,7 @@ ${lm[1]}  - ${kw}
       process.exitCode = 1;
       return;
     }
-    import_fs19.writeFileSync(file, content, "utf-8");
+    import_fs20.writeFileSync(file, content, "utf-8");
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
   cmd.command("meta [file]").description("Edit Unity .meta file importer settings").option("--set <key=value>", "Set an importer setting (e.g., isReadable=1)", (v, p) => [...p, v], []).option("--max-size <n>", "Set TextureImporter maxTextureSize").option("--compression <type>", "Set textureCompression (0=None, 1=LowQuality, 2=Normal, 3=HighQuality)").option("--filter-mode <mode>", "Set filterMode (0=Point, 1=Bilinear, 2=Trilinear)").option("--read-write", "Enable isReadable").option("--no-read-write", "Disable isReadable").option("--batch <glob>", "Apply to all matching files").option("--dry-run", "Preview changes without writing").option("-j, --json", "Output as JSON").action((file, options) => {
@@ -14751,14 +15643,14 @@ ${lm[1]}  - ${kw}
       const glob_pattern = options.batch;
       const pattern = glob_pattern.endsWith(".meta") ? glob_pattern : `${glob_pattern}.meta`;
       const first_glob = pattern.search(/[*?[\]{}]/);
-      const dir_part = first_glob >= 0 ? pattern.slice(0, pattern.lastIndexOf("/", first_glob)) : import_path9.dirname(pattern);
-      const dir = import_path9.resolve(dir_part);
-      const suffix = import_path9.basename(pattern).replace(/^\*+/, "");
+      const dir_part = first_glob >= 0 ? pattern.slice(0, pattern.lastIndexOf("/", first_glob)) : import_path12.dirname(pattern);
+      const dir = import_path12.resolve(dir_part);
+      const suffix = import_path12.basename(pattern).replace(/^\*+/, "");
       const meta_files = [];
       const scan = (d) => {
-        for (const entry of import_fs19.readdirSync(d)) {
-          const full = import_path9.join(d, entry);
-          if (import_fs19.statSync(full).isDirectory()) {
+        for (const entry of import_fs20.readdirSync(d)) {
+          const full = import_path12.join(d, entry);
+          if (import_fs20.statSync(full).isDirectory()) {
             if (pattern.includes("**"))
               scan(full);
           } else if (entry.endsWith(suffix)) {
@@ -14766,7 +15658,7 @@ ${lm[1]}  - ${kw}
           }
         }
       };
-      if (import_fs19.existsSync(dir))
+      if (import_fs20.existsSync(dir))
         scan(dir);
       if (meta_files.length === 0) {
         console.log(JSON.stringify({ success: false, error: `No files matched pattern: ${glob_pattern}` }, null, 2));
@@ -14774,7 +15666,7 @@ ${lm[1]}  - ${kw}
       }
       const results = [];
       for (const mf of meta_files) {
-        let mc = import_fs19.readFileSync(mf, "utf-8");
+        let mc = import_fs20.readFileSync(mf, "utf-8");
         const file_changes = [];
         for (const edit of edits) {
           const re = new RegExp(`^(\\s*${edit.key}:)[ \\t]*.*$`, "m");
@@ -14785,7 +15677,7 @@ ${lm[1]}  - ${kw}
         }
         if (file_changes.length > 0) {
           if (!options.dryRun)
-            import_fs19.writeFileSync(mf, mc, "utf-8");
+            import_fs20.writeFileSync(mf, mc, "utf-8");
           results.push({ file: mf, changes: file_changes });
         }
       }
@@ -14798,11 +15690,11 @@ ${lm[1]}  - ${kw}
       }, null, 2));
       return;
     }
-    if (!import_fs19.existsSync(metaPath)) {
+    if (!import_fs20.existsSync(metaPath)) {
       console.log(JSON.stringify({ success: false, error: `Meta file not found: ${metaPath}` }, null, 2));
       process.exit(1);
     }
-    let content = import_fs19.readFileSync(metaPath, "utf-8");
+    let content = import_fs20.readFileSync(metaPath, "utf-8");
     const changes = [];
     for (const edit of edits) {
       const re = new RegExp(`^(\\s*${edit.key}:)[ \\t]*.*$`, "m");
@@ -14817,11 +15709,11 @@ ${lm[1]}  - ${kw}
       console.log(JSON.stringify({ success: true, dry_run: true, file: metaPath, changes }, null, 2));
       return;
     }
-    import_fs19.writeFileSync(metaPath, content, "utf-8");
+    import_fs20.writeFileSync(metaPath, content, "utf-8");
     console.log(JSON.stringify({ success: true, file: metaPath, changes }, null, 2));
   });
   cmd.command("animation <file>").description("Edit AnimationClip settings and events").option("--set <property=value>", "Set a clip property (e.g., wrap-mode=2 for Loop)", (v, p) => [...p, v], []).option("--add-event <time,function[,data]>", "Add an animation event (e.g., 0.5,OnFootstep,left)", (v, p) => [...p, v], []).option("--remove-event <index>", "Remove an animation event by index (0-based)").option("-j, --json", "Output as JSON").action((file, options) => {
-    if (!import_fs19.existsSync(file)) {
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exit(1);
     }
@@ -14829,7 +15721,7 @@ ${lm[1]}  - ${kw}
       console.log(JSON.stringify({ success: false, error: `File is not an AnimationClip (.anim): ${file}` }, null, 2));
       process.exit(1);
     }
-    let content = import_fs19.readFileSync(file, "utf-8");
+    let content = import_fs20.readFileSync(file, "utf-8");
     const changes = [];
     const property_map = {
       "wrap-mode": "m_WrapMode",
@@ -14990,16 +15882,16 @@ ${event_yaml}
       process.exitCode = 1;
       return;
     }
-    import_fs19.writeFileSync(file, content, "utf-8");
+    import_fs20.writeFileSync(file, content, "utf-8");
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
   const PARAM_TYPE_MAP = { float: 1, int: 3, bool: 4, trigger: 9 };
   cmd.command("animator <file>").description("Edit AnimatorController parameters").option("--add-parameter <name>", "Add a new parameter").option("--type <float|int|bool|trigger>", "Parameter type (required with --add-parameter)").option("--remove-parameter <name>", "Remove a parameter by name").option("--set-default <param=value>", "Set parameter default value (e.g., Speed=1.5)", (v, p) => [...p, v], []).option("-j, --json", "Output as JSON").action((file, options) => {
-    if (!import_fs19.existsSync(file)) {
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exit(1);
     }
-    let content = import_fs19.readFileSync(file, "utf-8");
+    let content = import_fs20.readFileSync(file, "utf-8");
     const had_crlf = content.includes(`\r
 `);
     if (had_crlf)
@@ -15101,17 +15993,19 @@ $1`);
     if (had_crlf)
       content = content.replace(/\n/g, `\r
 `);
-    import_fs19.writeFileSync(file, content, "utf-8");
+    import_fs20.writeFileSync(file, content, "utf-8");
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
-  cmd.command("sibling-index <file> <object_name> <index>").description("Set the sibling index of a GameObject, renumbering all siblings").option("-j, --json", "Output as JSON").action((file, object_name, index_str, _options) => {
+  cmd.command("sibling-index <file> <object_name> <index>").description("Set the sibling index of a GameObject, renumbering all siblings").option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, object_name, index_str, options) => {
     const target_index = parseInt(index_str, 10);
     if (!Number.isFinite(target_index) || target_index < 0) {
       console.log(JSON.stringify({ success: false, error: "Index must be a non-negative integer" }, null, 2));
       process.exitCode = 1;
       return;
     }
-    if (!import_fs19.existsSync(file)) {
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection))
+      return;
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -15306,7 +16200,7 @@ $1`);
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
   cmd.command("animation-curves <file>").description("Add, remove, or modify animation curves in an .anim file").option("--add-curve <json>", 'Add a curve (JSON: {"type":"float","path":"Body","attribute":"m_Alpha","classID":23,"keyframes":[{"time":0,"value":1}]})').option("--remove-curve <spec>", "Remove a curve by path:attribute (e.g., Body/Mesh:m_Alpha)").option("--set-keyframes <json>", 'Replace keyframes (JSON: {"curve":"path:attribute","keyframes":[{"time":0,"value":10}]})').option("-j, --json", "Output as JSON").action((file, options) => {
-    if (!import_fs19.existsSync(file)) {
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exitCode = 1;
       return;
@@ -15316,7 +16210,7 @@ $1`);
       process.exitCode = 1;
       return;
     }
-    let content = import_fs19.readFileSync(file, "utf-8");
+    let content = import_fs20.readFileSync(file, "utf-8");
     const had_crlf = content.includes(`\r
 `);
     if (had_crlf)
@@ -15614,16 +16508,16 @@ ${curve_yaml}`);
     if (had_crlf)
       content = content.replace(/\n/g, `\r
 `);
-    import_fs19.writeFileSync(file, content, "utf-8");
+    import_fs20.writeFileSync(file, content, "utf-8");
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
   cmd.command("animator-state <file>").description("Add/remove states and transitions in an AnimatorController").option("--add-state <name>", "Add a new AnimatorState").option("--motion <guid-or-path>", "Motion clip GUID or file path (companion to --add-state)").option("--layer <name>", "Target layer name (default: first layer)").option("--speed <n>", "State speed (companion to --add-state, default: 1)").option("--remove-state <name>", "Remove a state and all its transitions").option("--add-transition <src:dst>", 'Add a transition (use "any" for AnyState source)').option("--condition <param,mode,threshold>", "Transition condition (repeatable)", (v, p) => [...p, v], []).option("--has-exit-time", "Enable exit time on transition").option("--exit-time <n>", "Exit time value (default: 0.75)").option("--duration <n>", "Transition duration (default: 0.25)").option("--remove-transition <src:dst>", "Remove a transition by source:destination state names").option("--set-default-state <name>", "Set the default state in the state machine").option("-j, --json", "Output as JSON").action((file, options) => {
-    if (!import_fs19.existsSync(file)) {
+    if (!import_fs20.existsSync(file)) {
       console.log(JSON.stringify({ success: false, error: `File not found: ${file}` }, null, 2));
       process.exitCode = 1;
       return;
     }
-    let content = import_fs19.readFileSync(file, "utf-8");
+    let content = import_fs20.readFileSync(file, "utf-8");
     const had_crlf = content.includes(`\r
 `);
     if (had_crlf)
@@ -15962,11 +16856,11 @@ $1`);
     if (had_crlf)
       content = content.replace(/\n/g, `\r
 `);
-    import_fs19.writeFileSync(file, content, "utf-8");
+    import_fs20.writeFileSync(file, content, "utf-8");
     console.log(JSON.stringify({ success: true, file, changes }, null, 2));
   });
   cmd.addCommand(prefab_cmd);
-  cmd.command("managed-reference <file> <component_id> <field_path> <type_name>").description('Add a managed reference (SerializeReference) to a component field. Type can be "Namespace.ClassName" (registry lookup) or "Assembly Namespace.ClassName" (manual).').option("-p, --project <path>", "Unity project path (for type registry)").option("--append", "Append to array (do not update field rid)").option("--properties <json>", `JSON object of initial field values for the data block (e.g. '{"damage": "10"}')`).option("-j, --json", "Output as JSON").action((file, component_id, field_path, type_name, options) => {
+  cmd.command("managed-reference <file> <component_id> <field_path> <type_name>").description('Add a managed reference (SerializeReference) to a component field. Type can be "Namespace.ClassName" (registry lookup) or "Assembly Namespace.ClassName" (manual).').option("-p, --project <path>", "Unity project path (for type registry)").option("--append", "Append to array (do not update field rid)").option("--properties <json>", `JSON object of initial field values for the data block (e.g. '{"damage": "10"}')`).option("-j, --json", "Output as JSON").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").action(async (file, component_id, field_path, type_name, options) => {
     let initial_values;
     if (options.properties) {
       try {
@@ -15977,6 +16871,8 @@ $1`);
         return;
       }
     }
+    if (!await check_loaded_edit_protection(file, options.bypassLoadedProtection, options.project))
+      return;
     const result = editManagedReference({
       file_path: file,
       file_id: component_id,
@@ -15996,7 +16892,13 @@ $1`);
 // src/cmd-delete.ts
 function build_delete_command() {
   const cmd = new Command("delete").description("Delete Unity objects (GameObjects, components)");
-  cmd.command("gameobject <file> <object_name>").description("Delete a GameObject and its hierarchy from a Unity file").option("-j, --json", "Output as JSON").action((file, object_name, _options) => {
+  cmd.command("gameobject <file> <object_name>").description("Delete a GameObject and its hierarchy from a Unity file").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, object_name, options) => {
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = deleteGameObject({
       file_path: file,
       object_name
@@ -16005,10 +16907,22 @@ function build_delete_command() {
     if (!result.success)
       process.exitCode = 1;
   });
-  cmd.command("component <file_or_project> <component>").description('Remove a component by file ID or type name (e.g., "Rigidbody", "StandaloneInputModule")').option("--on <game_object>", "Scope to a specific GameObject (name or fileID)").option("-p, --project <path>", "Unity project path (for script GUID lookup)").option("--all", "Remove from all scenes and prefabs in the project (first arg becomes project path)").option("-j, --json", "Output as JSON").action((file_or_project, component, options) => {
+  cmd.command("component <file_or_project> <component>").description('Remove a component by file ID or type name (e.g., "Rigidbody", "StandaloneInputModule")').option("--on <game_object>", "Scope to a specific GameObject (name or fileID)").option("-p, --project <path>", "Unity project path (for script GUID lookup)").option("--all", "Remove from all scenes and prefabs in the project (first arg becomes project path)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file_or_project, component, options) => {
     if (options.all) {
+      const resolvedProjectPath = resolve_project_path(file_or_project);
+      if (!options.bypassLoadedProtection) {
+        const connected = await is_editor_connected_for_project(resolvedProjectPath);
+        if (connected) {
+          console.log(JSON.stringify({
+            success: false,
+            error: "Refusing to run project-wide delete while editor is connected. Use --bypass-loaded-protection to force file-based edits."
+          }, null, 2));
+          process.exitCode = 1;
+          return;
+        }
+      }
       const result = removeComponentBatch({
-        project_path: file_or_project,
+        project_path: resolvedProjectPath,
         component_type: component,
         game_object: options.on
       });
@@ -16016,6 +16930,12 @@ function build_delete_command() {
       if (!result.success)
         process.exitCode = 1;
     } else {
+      const guard = await enforce_loaded_edit_protection(file_or_project, options.bypassLoadedProtection, options.project);
+      if (!guard.allowed) {
+        console.log(JSON.stringify({ success: false, file_path: file_or_project, error: guard.error }, null, 2));
+        process.exitCode = 1;
+        return;
+      }
       const result = removeComponent({
         file_path: file_or_project,
         file_id: component,
@@ -16039,7 +16959,13 @@ function build_delete_command() {
       process.exitCode = 1;
     }
   });
-  cmd.command("prefab <file> <prefab_instance>").description("Delete a PrefabInstance and all its stripped/added blocks from a Unity file").option("-j, --json", "Output as JSON").action((file, prefab_instance, _options) => {
+  cmd.command("prefab <file> <prefab_instance>").description("Delete a PrefabInstance and all its stripped/added blocks from a Unity file").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, prefab_instance, options) => {
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
     const result = deletePrefabInstance({
       file_path: file,
       prefab_instance
@@ -16048,6 +16974,18 @@ function build_delete_command() {
     if (!result.success)
       process.exitCode = 1;
   });
+  cmd.command("asset <file>").description("Delete an asset file and its .meta sidecar (missing .meta => warning)").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, options) => {
+    const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+    if (!guard.allowed) {
+      console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+      process.exitCode = 1;
+      return;
+    }
+    const result = deleteAssetFile({ file_path: file });
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.success)
+      process.exitCode = 1;
+  });
   cmd.command("package <name>").description("Remove a package from Packages/manifest.json").option("-p, --project <path>", "Unity project path (defaults to cwd)").option("-j, --json", "Output as JSON").action((name, options) => {
     try {
       const resolvedProjectPath = resolve_project_path(options.project);
@@ -16067,274 +17005,7 @@ function build_delete_command() {
 }
 
 // src/cmd-editor.ts
-var import_path11 = require("path");
-
-// src/editor-client.ts
-var import_fs20 = require("fs");
-var import_path10 = require("path");
-function read_editor_config(project_path) {
-  const config_path = import_path10.join(project_path, ".unity-agentic", "editor.json");
-  if (!import_fs20.existsSync(config_path)) {
-    return { error: `Editor bridge not found at ${config_path}. Is the Unity Editor running with the bridge package installed?` };
-  }
-  let config;
-  try {
-    const raw = import_fs20.readFileSync(config_path, "utf-8");
-    config = JSON.parse(raw);
-  } catch (err) {
-    return { error: `Failed to parse editor.json: ${err instanceof Error ? err.message : String(err)}` };
-  }
-  if (typeof config.port !== "number" || typeof config.pid !== "number") {
-    return { error: "Invalid editor.json: missing port or pid" };
-  }
-  if (!is_pid_alive(config.pid)) {
-    return { error: `Unity Editor process (PID ${config.pid}) is not running. The editor may have been closed.` };
-  }
-  return config;
-}
-var RETRYABLE_CODES = new Set([-32000, -32002, -32003]);
-var RETRY_DELAYS = [500, 1000, 2000];
-async function call_editor(options) {
-  const maxRetries = options.retries ?? 2;
-  let lastResponse;
-  for (let attempt = 0;attempt <= maxRetries; attempt++) {
-    lastResponse = await call_editor_once(options);
-    if (!lastResponse.error || !RETRYABLE_CODES.has(lastResponse.error.code)) {
-      return lastResponse;
-    }
-    if (attempt < maxRetries) {
-      const delay = RETRY_DELAYS[Math.min(attempt, RETRY_DELAYS.length - 1)];
-      await new Promise((r) => setTimeout(r, delay));
-    }
-  }
-  return lastResponse;
-}
-function call_editor_once(options) {
-  const { method, params, timeout = 1e4, no_wait } = options;
-  const config = resolve_config(options);
-  if ("error" in config) {
-    return Promise.resolve({
-      jsonrpc: "2.0",
-      id: "0",
-      error: { code: -32000, message: config.error }
-    });
-  }
-  const url = `ws://127.0.0.1:${config.port}/unity-agentic`;
-  const request_id = generate_id();
-  const wire_params = { ...params };
-  if (timeout !== 1e4)
-    wire_params._timeout = timeout;
-  if (no_wait)
-    wire_params.no_wait = true;
-  const request = {
-    jsonrpc: "2.0",
-    id: request_id,
-    method,
-    ...Object.keys(wire_params).length > 0 ? { params: wire_params } : {}
-  };
-  return new Promise((resolve7) => {
-    let resolved = false;
-    let ws;
-    const timer = setTimeout(() => {
-      if (!resolved) {
-        resolved = true;
-        try {
-          ws?.close();
-        } catch {}
-        resolve7({
-          jsonrpc: "2.0",
-          id: request_id,
-          error: { code: -32001, message: `Timeout after ${timeout}ms waiting for response to ${method}` }
-        });
-      }
-    }, timeout);
-    try {
-      ws = new WebSocket(url);
-      ws.onopen = () => {
-        ws.send(JSON.stringify(request));
-        if (no_wait && !resolved) {
-          resolved = true;
-          clearTimeout(timer);
-          setTimeout(() => {
-            try {
-              ws.close();
-            } catch {}
-          }, 200);
-          resolve7({
-            jsonrpc: "2.0",
-            id: request_id,
-            result: { queued: true }
-          });
-        }
-      };
-      ws.onmessage = (event) => {
-        try {
-          const data = JSON.parse(String(event.data));
-          if (data.id === request_id) {
-            if (!resolved) {
-              resolved = true;
-              clearTimeout(timer);
-              ws.close();
-              resolve7(data);
-            }
-          }
-        } catch {}
-      };
-      ws.onerror = () => {
-        if (!resolved) {
-          resolved = true;
-          clearTimeout(timer);
-          resolve7({
-            jsonrpc: "2.0",
-            id: request_id,
-            error: { code: -32002, message: `WebSocket connection failed to ${url}. Is the Unity Editor running?` }
-          });
-        }
-      };
-      ws.onclose = () => {
-        if (!resolved) {
-          resolved = true;
-          clearTimeout(timer);
-          resolve7({
-            jsonrpc: "2.0",
-            id: request_id,
-            error: { code: -32003, message: "WebSocket connection closed before response received" }
-          });
-        }
-      };
-    } catch (err) {
-      if (!resolved) {
-        resolved = true;
-        clearTimeout(timer);
-        resolve7({
-          jsonrpc: "2.0",
-          id: request_id,
-          error: { code: -32002, message: `Failed to connect: ${err instanceof Error ? err.message : String(err)}` }
-        });
-      }
-    }
-  });
-}
-async function stream_editor(options) {
-  const { method, params, timeout = 30000, on_event } = options;
-  const config = resolve_config(options);
-  if ("error" in config) {
-    throw new Error(config.error);
-  }
-  const MAX_RECONNECTS = 5;
-  let reconnect_count = 0;
-  let stopped = false;
-  return new Promise((resolve7, reject) => {
-    let resolved = false;
-    function connect(url) {
-      const ws = new WebSocket(url);
-      const request_id = generate_id();
-      const request = {
-        jsonrpc: "2.0",
-        id: request_id,
-        method,
-        ...params ? { params } : {}
-      };
-      let connected = false;
-      const timer = !resolved ? setTimeout(() => {
-        if (!connected && !resolved) {
-          reject(new Error(`Timeout connecting to ${url}`));
-        }
-      }, timeout) : null;
-      ws.onopen = () => {
-        connected = true;
-        if (timer)
-          clearTimeout(timer);
-        reconnect_count = 0;
-        ws.send(JSON.stringify(request));
-        if (!resolved) {
-          resolved = true;
-          resolve7({ close: () => {
-            stopped = true;
-            ws.close();
-          } });
-        }
-      };
-      ws.onmessage = (event) => {
-        try {
-          const data = JSON.parse(String(event.data));
-          if ("method" in data && !("id" in data)) {
-            on_event(data);
-          }
-        } catch {}
-      };
-      ws.onerror = () => {
-        if (!connected && !resolved) {
-          if (timer)
-            clearTimeout(timer);
-          reject(new Error(`WebSocket connection failed to ${url}`));
-        }
-      };
-      ws.onclose = () => {
-        if (stopped)
-          return;
-        if (!connected && !resolved)
-          return;
-        if (reconnect_count >= MAX_RECONNECTS)
-          return;
-        reconnect_count++;
-        const delay = Math.min(500 * reconnect_count, 3000);
-        setTimeout(() => {
-          if (stopped)
-            return;
-          const fresh_config = resolve_config(options);
-          if ("error" in fresh_config)
-            return;
-          connect(`ws://127.0.0.1:${fresh_config.port}/unity-agentic`);
-        }, delay);
-      };
-    }
-    connect(`ws://127.0.0.1:${config.port}/unity-agentic`);
-  });
-}
-async function ping_editor(port, timeout_ms = 2000) {
-  return new Promise((resolve7) => {
-    const timer = setTimeout(() => {
-      resolve7({ reachable: false, error: `Timeout after ${timeout_ms}ms` });
-    }, timeout_ms);
-    try {
-      const ws = new WebSocket(`ws://127.0.0.1:${port}/unity-agentic`);
-      ws.onopen = () => {
-        clearTimeout(timer);
-        try {
-          ws.close();
-        } catch {}
-        resolve7({ reachable: true });
-      };
-      ws.onerror = (err) => {
-        clearTimeout(timer);
-        resolve7({ reachable: false, error: String(err) });
-      };
-    } catch (err) {
-      clearTimeout(timer);
-      resolve7({ reachable: false, error: String(err) });
-    }
-  });
-}
-function resolve_config(options) {
-  if (options.port) {
-    return { port: options.port, pid: 0, version: "unknown" };
-  }
-  return read_editor_config(options.project_path);
-}
-function is_pid_alive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function generate_id() {
-  return `${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
-}
-
-// src/cmd-editor.ts
+var import_path13 = require("path");
 var BRIDGE_PACKAGE_NAME = "com.unity-agentic-tools.editor-bridge";
 var BRIDGE_PACKAGE_VERSION = "https://github.com/taconotsandwich/unity-agentic-tools.git?path=unity-package";
 function get_common_options(cmd) {
@@ -16352,7 +17023,7 @@ function get_common_options(cmd) {
       port_str = opts.port;
     current = current.parent;
   }
-  const project_path = import_path11.resolve(project || process.cwd());
+  const project_path = import_path13.resolve(project || process.cwd());
   const timeout = parseInt(timeout_str || "10000", 10);
   const port = port_str ? parseInt(port_str, 10) : undefined;
   return { project_path, timeout, port };
@@ -16767,7 +17438,13 @@ program.addCommand(build_read_command(getScanner));
 program.addCommand(build_update_command(getScanner));
 program.addCommand(build_delete_command());
 program.addCommand(build_editor_command());
-program.command("clone <file> <object_name>").description("Duplicate a GameObject and its hierarchy").option("-n, --name <new_name>", "Name for the duplicated object").option("-j, --json", "Output as JSON").action((file, object_name, options) => {
+program.command("clone <file> <object_name>").description("Duplicate a GameObject and its hierarchy").option("-n, --name <new_name>", "Name for the duplicated object").option("--bypass-loaded-protection", "Allow editing files currently loaded in Unity Editor").option("-j, --json", "Output as JSON").action(async (file, object_name, options) => {
+  const guard = await enforce_loaded_edit_protection(file, options.bypassLoadedProtection);
+  if (!guard.allowed) {
+    console.log(JSON.stringify({ success: false, file_path: file, error: guard.error }, null, 2));
+    process.exitCode = 1;
+    return;
+  }
   const result = duplicateGameObject({
     file_path: file,
     object_name,