dominus-cli 0.2.0 → 0.5.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import fs4, { existsSync, readFileSync, unlinkSync } from 'fs';
-import path3, { join } from 'path';
-import os2, { tmpdir } from 'os';
+import fs5, { existsSync, readFileSync, unlinkSync } from 'fs';
+import path4, { join } from 'path';
+import os3, { tmpdir } from 'os';
 import { nanoid } from 'nanoid';
 import { WebSocket, WebSocketServer } from 'ws';
 import { EventEmitter } from 'events';
@@ -18,6 +18,7 @@ import { execSync } from 'child_process';
 import { randomBytes } from 'crypto';
 import Spinner from 'ink-spinner';
 import OpenAI from 'openai';
+import https from 'https';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -55,14 +56,14 @@ function resolveProviderSettings(config) {
   };
 }
 function ensureDir() {
-  if (!fs4.existsSync(DOMINUS_DIR)) {
-    fs4.mkdirSync(DOMINUS_DIR, { recursive: true });
+  if (!fs5.existsSync(DOMINUS_DIR)) {
+    fs5.mkdirSync(DOMINUS_DIR, { recursive: true });
   }
 }
 function readJson(filePath, defaults) {
   try {
-    if (fs4.existsSync(filePath)) {
-      const raw = fs4.readFileSync(filePath, "utf-8");
+    if (fs5.existsSync(filePath)) {
+      const raw = fs5.readFileSync(filePath, "utf-8");
       return { ...defaults, ...JSON.parse(raw) };
     }
   } catch {
@@ -71,7 +72,7 @@ function readJson(filePath, defaults) {
 }
 function writeJson(filePath, data) {
   ensureDir();
-  fs4.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+  fs5.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
 }
 function loadConfig() {
   ensureDir();
@@ -123,10 +124,10 @@ function createConfigAccess() {
 var DOMINUS_DIR, CONFIG_PATH, DB_PATH, RULES_PATH, PROVIDERS, DEFAULTS, DEFAULT_RULES;
 var init_config = __esm({
   "src/config/config.ts"() {
-    DOMINUS_DIR = path3.join(os2.homedir(), ".dominus");
-    CONFIG_PATH = path3.join(DOMINUS_DIR, "config.json");
-    DB_PATH = path3.join(DOMINUS_DIR, "dominus.db");
-    RULES_PATH = path3.join(DOMINUS_DIR, "rules.json");
+    DOMINUS_DIR = path4.join(os3.homedir(), ".dominus");
+    CONFIG_PATH = path4.join(DOMINUS_DIR, "config.json");
+    DB_PATH = path4.join(DOMINUS_DIR, "dominus.db");
+    RULES_PATH = path4.join(DOMINUS_DIR, "rules.json");
     PROVIDERS = {
       openai: {
         name: "OpenAI",
@@ -220,6 +221,7 @@ var init_protocol = __esm({
       SET_SCRIPT: "cli:set:script",
       RUN_CODE: "cli:run",
       GET_PROPERTIES: "cli:get:properties",
+      GET_DESCENDANTS_PROPERTIES: "cli:get:descendants:properties",
       SET_PROPERTIES: "cli:set:properties",
       INSERT_INSTANCE: "cli:insert",
       DELETE_INSTANCE: "cli:delete",
@@ -233,7 +235,13 @@ var init_protocol = __esm({
       END_TEST: "cli:test:end",
       BUILD_UI: "cli:build:ui",
       GET_REFLECTION: "cli:get:reflection",
-      UPLOAD_ASSET: "cli:upload:asset"
+      UPLOAD_ASSET: "cli:upload:asset",
+      SERIALIZE_UI: "cli:serialize:ui",
+      MOVE_INSTANCE: "cli:move:instance",
+      UNDO: "cli:undo",
+      REDO: "cli:redo",
+      BULK_SET_PROPERTIES: "cli:bulk:set:properties",
+      FIND_REPLACE_SCRIPTS: "cli:find:replace:scripts"
     };
   }
 });
@@ -641,14 +649,14 @@ __export(store_exports, {
 function persist() {
   if (!db) return;
   const data = db.export();
-  fs4.writeFileSync(dbPath, Buffer.from(data));
+  fs5.writeFileSync(dbPath, Buffer.from(data));
 }
 async function initMemoryStore() {
   if (db) return;
   dbPath = getDbPath();
   const SQL = await initSqlJs();
-  if (fs4.existsSync(dbPath)) {
-    const buffer = fs4.readFileSync(dbPath);
+  if (fs5.existsSync(dbPath)) {
+    const buffer = fs5.readFileSync(dbPath);
     db = new SQL.Database(buffer);
   } else {
     db = new SQL.Database();
@@ -939,10 +947,10 @@ var init_read_script = __esm({
         if (!ctx.isStudioConnected()) {
           return { success: false, error: "Studio is not connected" };
         }
-        const path4 = params.path;
-        const response = await ctx.sendToStudio(CliMsg.GET_SCRIPT, { path: path4 });
+        const path5 = params.path;
+        const response = await ctx.sendToStudio(CliMsg.GET_SCRIPT, { path: path5 });
         if (!response.payload) {
-          return { success: false, error: `Script not found: ${path4}` };
+          return { success: false, error: `Script not found: ${path5}` };
         }
         return {
           success: true,
@@ -988,14 +996,14 @@ var init_edit_script = __esm({
         if (!ctx.isStudioConnected()) {
           return { success: false, error: "Studio is not connected" };
         }
-        const path4 = params.path;
+        const path5 = params.path;
         const source = params.source;
-        const response = await ctx.sendToStudio(CliMsg.SET_SCRIPT, { path: path4, source });
+        const response = await ctx.sendToStudio(CliMsg.SET_SCRIPT, { path: path5, source });
         const payload = response.payload;
         if (!payload.success) {
           return { success: false, error: payload.error ?? "Failed to edit script" };
         }
-        return { success: true, data: { path: path4, linesWritten: source.split("\n").length } };
+        return { success: true, data: { path: path5, linesWritten: source.split("\n").length } };
       }
     };
   }
@@ -1118,16 +1126,65 @@ var init_get_properties = __esm({
   }
 });
 
+// src/tools/studio/get-descendants-properties.ts
+var get_descendants_properties_exports = {};
+__export(get_descendants_properties_exports, {
+  tool: () => tool6
+});
+var tool6;
+var init_get_descendants_properties = __esm({
+  "src/tools/studio/get-descendants-properties.ts"() {
+    init_protocol();
+    tool6 = {
+      name: "get_descendants_properties",
+      description: "Easily get all descendants of a UI instance (or any instance) and all of their properties.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Full instance path (e.g., "Workspace.Part", "StarterGui.ScreenGui")'
+          },
+          outputFile: {
+            type: "string",
+            description: "Optional file path to write the JSON result to, useful for very large trees where context limits apply."
+          }
+        },
+        required: ["path"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(
+          CliMsg.GET_DESCENDANTS_PROPERTIES,
+          { path: params.path },
+          1e3 * 60 * 5
+          // 5 minute timeout since getting ALL descendants can take a very long time
+        );
+        if (params.outputFile && typeof params.outputFile === "string") {
+          const fs6 = await import('fs/promises');
+          const path5 = await import('path');
+          const outputPath = path5.resolve(process.cwd(), params.outputFile);
+          await fs6.writeFile(outputPath, JSON.stringify(response.payload, null, 2), "utf-8");
+          return { success: true, data: `Successfully saved descendants to ${outputPath}` };
+        }
+        return { success: true, data: response.payload };
+      }
+    };
+  }
+});
+
 // src/tools/studio/set-properties.ts
 var set_properties_exports = {};
 __export(set_properties_exports, {
-  tool: () => tool6
+  tool: () => tool7
 });
-var tool6;
+var tool7;
 var init_set_properties = __esm({
   "src/tools/studio/set-properties.ts"() {
     init_protocol();
-    tool6 = {
+    tool7 = {
       name: "set_properties",
       description: "Set properties on an instance in Roblox Studio.",
       parameters: {
@@ -1165,13 +1222,13 @@ var init_set_properties = __esm({
 // src/tools/studio/insert-instance.ts
 var insert_instance_exports = {};
 __export(insert_instance_exports, {
-  tool: () => tool7
+  tool: () => tool8
 });
-var tool7;
+var tool8;
 var init_insert_instance = __esm({
   "src/tools/studio/insert-instance.ts"() {
     init_protocol();
-    tool7 = {
+    tool8 = {
       name: "insert_instance",
       description: "Insert a new instance into the Roblox Studio DataModel.",
       parameters: {
@@ -1219,13 +1276,13 @@ var init_insert_instance = __esm({
 // src/tools/studio/delete-instance.ts
 var delete_instance_exports = {};
 __export(delete_instance_exports, {
-  tool: () => tool8
+  tool: () => tool9
 });
-var tool8;
+var tool9;
 var init_delete_instance = __esm({
   "src/tools/studio/delete-instance.ts"() {
     init_protocol();
-    tool8 = {
+    tool9 = {
       name: "delete_instance",
       description: "Delete an instance from the Roblox Studio DataModel by path.",
       parameters: {
@@ -1256,13 +1313,13 @@ var init_delete_instance = __esm({
 // src/tools/studio/get-output.ts
 var get_output_exports = {};
 __export(get_output_exports, {
-  tool: () => tool9
+  tool: () => tool10
 });
-var tool9;
+var tool10;
 var init_get_output = __esm({
   "src/tools/studio/get-output.ts"() {
     init_protocol();
-    tool9 = {
+    tool10 = {
       name: "get_output",
       description: "Get recent output log entries from Roblox Studio (prints, warnings, errors).",
       parameters: {
@@ -1297,13 +1354,13 @@ var init_get_output = __esm({
 // src/tools/studio/get-selection.ts
 var get_selection_exports = {};
 __export(get_selection_exports, {
-  tool: () => tool10
+  tool: () => tool11
 });
-var tool10;
+var tool11;
 var init_get_selection = __esm({
   "src/tools/studio/get-selection.ts"() {
     init_protocol();
-    tool10 = {
+    tool11 = {
       name: "get_selection",
       description: "Get the currently selected instances in Roblox Studio.",
       parameters: {
@@ -1324,13 +1381,13 @@ var init_get_selection = __esm({
 // src/tools/studio/search-scripts.ts
 var search_scripts_exports = {};
 __export(search_scripts_exports, {
-  tool: () => tool11
+  tool: () => tool12
 });
-var tool11;
+var tool12;
 var init_search_scripts = __esm({
   "src/tools/studio/search-scripts.ts"() {
     init_protocol();
-    tool11 = {
+    tool12 = {
       name: "search_scripts",
       description: "Search across all scripts in Roblox Studio for a text pattern. Returns matching lines with context.",
       parameters: {
@@ -1365,13 +1422,13 @@ var init_search_scripts = __esm({
 // src/tools/studio/run-tests.ts
 var run_tests_exports = {};
 __export(run_tests_exports, {
-  tool: () => tool12
+  tool: () => tool13
 });
-var tool12;
+var tool13;
 var init_run_tests = __esm({
   "src/tools/studio/run-tests.ts"() {
     init_protocol();
-    tool12 = {
+    tool13 = {
       name: "run_tests",
       description: "Run tests in Roblox Studio using StudioTestService. Can run all tests or a specific test by name.",
       parameters: {
@@ -1405,13 +1462,13 @@ var init_run_tests = __esm({
 // src/tools/studio/get-class-info.ts
 var get_class_info_exports = {};
 __export(get_class_info_exports, {
-  tool: () => tool13
+  tool: () => tool14
 });
-var tool13;
+var tool14;
 var init_get_class_info = __esm({
   "src/tools/studio/get-class-info.ts"() {
     init_protocol();
-    tool13 = {
+    tool14 = {
       name: "get_class_info",
       description: "Look up the full schema of a Roblox class using ReflectionService. Returns all properties (with their types), methods (with parameters), and events. ALWAYS call this before creating or modifying GUI/UI elements (Frame, TextLabel, ImageLabel, etc.) to know the correct property names and expected types (e.g., Size is UDim2 for GUI, Vector3 for Parts).",
       parameters: {
@@ -1442,13 +1499,13 @@ var init_get_class_info = __esm({
 // src/tools/studio/create-ui.ts
 var create_ui_exports = {};
 __export(create_ui_exports, {
-  tool: () => tool14
+  tool: () => tool15
 });
-var tool14;
+var tool15;
 var init_create_ui = __esm({
   "src/tools/studio/create-ui.ts"() {
     init_protocol();
-    tool14 = {
+    tool15 = {
       name: "create_ui",
       description: 'Create an entire UI tree in Roblox Studio in a SINGLE call. Pass a declarative JSON tree with ClassName, Name, properties, and Children. All types are auto-coerced natively in Luau \u2014 UDim2, Color3, Font, enums all work. This is 10x faster than run_code for UI because it handles everything in one round-trip with no Luau syntax issues. Replaces any existing instance with the same name.\n\nExample: create a pastel hello world screen:\n{\n  "parent": "StarterGui",\n  "tree": {\n    "ClassName": "ScreenGui",\n    "Name": "HelloWorld",\n    "ResetOnSpawn": false,\n    "Children": [{\n      "ClassName": "Frame",\n      "Name": "Background",\n      "Size": [1, 0, 1, 0],\n      "BackgroundColor3": "#F0E6FF",\n      "Children": [\n        { "ClassName": "UICorner", "CornerRadius": [0, 12] },\n        { "ClassName": "TextLabel", "Name": "Title", "Text": "Hello World!",\n          "Size": [0.5, 0, 0.1, 0], "Position": [0.25, 0, 0.45, 0],\n          "BackgroundTransparency": 1, "TextColor3": "#6C5CE7",\n          "TextScaled": true, "Font": "GothamBold" }\n      ]\n    }]\n  }\n}',
       parameters: {
@@ -1460,7 +1517,11 @@ var init_create_ui = __esm({
           },
           tree: {
             type: "object",
-            description: 'The root UI node. Each node has: ClassName (string), Name (string), any properties as key-value pairs, and Children (array of child nodes). Property values are auto-coerced:\n  UDim2: [xScale, xOffset, yScale, yOffset] or {XScale, XOffset, YScale, YOffset}\n  Color3: "#hex", "rgb(r,g,b)", [r,g,b], or BrickColor name\n  UDim: [scale, offset] or number\n  Vector2: {x, y} or [x, y]\n  Font: "GothamBold", "SourceSans", etc. (Enum.Font names)\n  Enums: string name like "Center", "Left", "Fit"\n  FontFace: {Family, Weight, Style}'
+            description: 'The root UI node. Each node has: ClassName (string), Name (string), any properties as key-value pairs, and Children (array of child nodes). Property values are auto-coerced:\n  UDim2: [xScale, xOffset, yScale, yOffset] or {XScale, XOffset, YScale, YOffset}\n  Color3: "#hex", "rgb(r,g,b)", [r,g,b], or BrickColor name\n  UDim: [scale, offset] or number\n  Vector2: [x, y] or {x, y} (auto-disambiguated from UDim by property name)\n  NumberRange: [min, max] or number\n  Rect: [minX, minY, maxX, maxY] or {MinX, MinY, MaxX, MaxY}\n  Font: "GothamBold", "SourceSans", etc. (Enum.Font names)\n  Enums: string name like "Center", "Left", "Fit"\n  FontFace: {Family, Weight, Style}\n  2-element arrays are auto-disambiguated: AnchorPoint\u2192Vector2, CornerRadius/Padding\u2192UDim, etc.'
+          },
+          animate: {
+            type: "boolean",
+            description: "If true, task.wait() will be injected between creation of nodes so that the UI writes out dynamically."
           }
         },
         required: ["tree"]
@@ -1471,6 +1532,7 @@ var init_create_ui = __esm({
         }
         const response = await ctx.sendToStudio(CliMsg.BUILD_UI, {
           parent: params.parent ?? "StarterGui",
+          animate: params.animate,
           tree: params.tree
         });
         const payload = response.payload;
@@ -1489,13 +1551,13 @@ var init_create_ui = __esm({
 // src/tools/studio/execute-run-test.ts
 var execute_run_test_exports = {};
 __export(execute_run_test_exports, {
-  tool: () => tool15
+  tool: () => tool16
 });
-var tool15;
+var tool16;
 var init_execute_run_test = __esm({
   "src/tools/studio/execute-run-test.ts"() {
     init_protocol();
-    tool15 = {
+    tool16 = {
       name: "execute_run_test",
       description: "Start a Run mode test session in Roblox Studio using StudioTestService:ExecuteRunModeAsync(). Passes args that server scripts can retrieve via GetTestArgs(). Yields until the session ends (via EndTest or manual stop). Returns the value passed to EndTest(). Use this for headless automated tests \u2014 no player character, just server scripts running.",
       parameters: {
@@ -1534,13 +1596,13 @@ var init_execute_run_test = __esm({
 // src/tools/studio/execute-play-test.ts
 var execute_play_test_exports = {};
 __export(execute_play_test_exports, {
-  tool: () => tool16
+  tool: () => tool17
 });
-var tool16;
+var tool17;
 var init_execute_play_test = __esm({
   "src/tools/studio/execute-play-test.ts"() {
     init_protocol();
-    tool16 = {
+    tool17 = {
       name: "execute_play_test",
       description: "Start a solo Play mode test session in Roblox Studio using StudioTestService:ExecutePlayModeAsync(). Passes args that server scripts can retrieve via GetTestArgs(). Yields until the session ends (via EndTest or manual stop). Returns the value passed to EndTest(). Use this for tests that need a player character and full client-server simulation.",
       parameters: {
@@ -1579,13 +1641,13 @@ var init_execute_play_test = __esm({
 // src/tools/studio/create-part.ts
 var create_part_exports = {};
 __export(create_part_exports, {
-  tool: () => tool17
+  tool: () => tool18
 });
-var tool17;
+var tool18;
 var init_create_part = __esm({
   "src/tools/studio/create-part.ts"() {
     init_protocol();
-    tool17 = {
+    tool18 = {
       name: "create_part",
       description: "Create a Part in Roblox Studio with position, size, color, material and more \u2014 all in one call. Much faster than insert_instance + set_properties separately.",
       parameters: {
@@ -1678,11 +1740,11 @@ var init_create_part = __esm({
 // src/tools/studio/clone-instance.ts
 var clone_instance_exports = {};
 __export(clone_instance_exports, {
-  tool: () => tool18
+  tool: () => tool19
 });
 function buildCloneCode(params) {
-  const path4 = params.path;
-  const parts = path4.split(".");
+  const path5 = params.path;
+  const parts = path5.split(".");
   let resolve = "game";
   for (const p of parts) {
     resolve += `["${p}"]`;
@@ -1713,11 +1775,11 @@ function buildCloneCode(params) {
   lines.push(`print("Cloned: " .. clone:GetFullName())`);
   return lines.join("\n");
 }
-var tool18;
+var tool19;
 var init_clone_instance = __esm({
   "src/tools/studio/clone-instance.ts"() {
     init_protocol();
-    tool18 = {
+    tool19 = {
       name: "clone_instance",
       description: "Clone an existing instance in Roblox Studio and optionally reposition/rename it. Great for duplicating parts, models, or entire trees.",
       parameters: {
@@ -1753,13 +1815,13 @@ var init_clone_instance = __esm({
 // src/tools/studio/group-instances.ts
 var group_instances_exports = {};
 __export(group_instances_exports, {
-  tool: () => tool19
+  tool: () => tool20
 });
-var tool19;
+var tool20;
 var init_group_instances = __esm({
   "src/tools/studio/group-instances.ts"() {
     init_protocol();
-    tool19 = {
+    tool20 = {
       name: "group_instances",
       description: 'Group multiple instances under a new Model or Folder. Useful for organizing parts into objects (e.g., grouping trunk + leaves into a "Tree" model).',
       parameters: {
@@ -1819,12 +1881,12 @@ var init_group_instances = __esm({
 // src/tools/studio/build-multiple.ts
 var build_multiple_exports = {};
 __export(build_multiple_exports, {
-  tool: () => tool20
+  tool: () => tool21
 });
 function generateBatchCode(parts, groupName, groupParent) {
   const lines = [];
-  function resolveParent(path4) {
-    const segs = path4.split(".");
+  function resolveParent(path5) {
+    const segs = path5.split(".");
     let r = "game";
     for (const s of segs) r += `["${s}"]`;
     return r;
@@ -1878,11 +1940,11 @@ function generateBatchCode(parts, groupName, groupParent) {
   lines.push(`print("Built ${parts.length} parts${groupName ? ` in ${groupName}` : ""}")`);
   return lines.join("\n");
 }
-var tool20;
+var tool21;
 var init_build_multiple = __esm({
   "src/tools/studio/build-multiple.ts"() {
     init_protocol();
-    tool20 = {
+    tool21 = {
       name: "build_multiple",
       description: "Create multiple parts/instances in one batch call. Send an array of specs and they all get created in a single Studio round-trip. Ideal for building trees, houses, vehicles, terrain \u2014 anything composed of multiple parts.",
       parameters: {
@@ -1951,16 +2013,234 @@ var init_build_multiple = __esm({
   }
 });
 
+// src/tools/studio/serialize-ui.ts
+var serialize_ui_exports = {};
+__export(serialize_ui_exports, {
+  tool: () => tool22
+});
+var tool22;
+var init_serialize_ui = __esm({
+  "src/tools/studio/serialize-ui.ts"() {
+    init_protocol();
+    tool22 = {
+      name: "serialize_ui",
+      description: "Serialize an existing UI tree from Roblox Studio into create_ui-compatible JSON. This is the reverse of create_ui \u2014 read any instance and get back a declarative JSON tree you can modify and pass back to create_ui. Perfect for cloning, templating, or refactoring UIs.\n\nThe output includes ClassName, Name, all non-default properties (with values converted to JSON-friendly formats like [r,g,b] for Color3, [xS,xO,yS,yO] for UDim2, etc.), and Children.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Instance path to serialize (e.g. "StarterGui.MyScreenGui")'
+          },
+          maxDepth: {
+            type: "number",
+            description: "Maximum depth to serialize (default: 50)"
+          }
+        },
+        required: ["path"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.SERIALIZE_UI, {
+          path: params.path,
+          maxDepth: params.maxDepth ?? 50
+        }, 1e3 * 60 * 2);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Serialization failed" };
+        }
+        return { success: true, data: payload.tree };
+      }
+    };
+  }
+});
+
+// src/tools/studio/move-instance.ts
+var move_instance_exports = {};
+__export(move_instance_exports, {
+  tool: () => tool23
+});
+var tool23;
+var init_move_instance = __esm({
+  "src/tools/studio/move-instance.ts"() {
+    init_protocol();
+    tool23 = {
+      name: "move_instance",
+      description: "Move (reparent) an instance to a new parent in Roblox Studio. This preserves the instance and all its descendants \u2014 much better than delete + recreate. Sets a ChangeHistoryService waypoint so the move can be undone.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Full path of the instance to move (e.g. "Workspace.OldFolder.MyPart")'
+          },
+          newParent: {
+            type: "string",
+            description: 'Full path of the new parent (e.g. "Workspace.NewFolder")'
+          }
+        },
+        required: ["path", "newParent"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.MOVE_INSTANCE, {
+          path: params.path,
+          newParent: params.newParent
+        });
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Move failed" };
+        }
+        return { success: true, data: { newPath: payload.newPath } };
+      }
+    };
+  }
+});
+
+// src/tools/studio/bulk-set-properties.ts
+var bulk_set_properties_exports = {};
+__export(bulk_set_properties_exports, {
+  tool: () => tool24
+});
+var tool24;
+var init_bulk_set_properties = __esm({
+  "src/tools/studio/bulk-set-properties.ts"() {
+    init_protocol();
+    tool24 = {
+      name: "bulk_set_properties",
+      description: 'Set properties on multiple instances at once in a single call. Much faster than calling set_properties repeatedly. Supports two modes:\n1. Explicit paths: provide an array of {path, properties} objects\n2. By class filter: provide a root path, className filter, and properties to apply to all matches\n\nExample (explicit): [{"path": "StarterGui.HUD.Title", "properties": {"TextColor3": "#fff"}}, ...]\nExample (filter): root="StarterGui.HUD", className="TextLabel", properties={"Font": "GothamBold"}',
+      parameters: {
+        type: "object",
+        properties: {
+          targets: {
+            type: "array",
+            description: "Array of {path, properties} objects for explicit mode.",
+            items: {
+              type: "object",
+              description: "A target with path and properties to set."
+            }
+          },
+          root: {
+            type: "string",
+            description: "Root instance path to search under (filter mode)"
+          },
+          className: {
+            type: "string",
+            description: "Only apply to instances of this ClassName (filter mode)"
+          },
+          properties: {
+            type: "object",
+            description: "Properties to set on all matched instances (filter mode)"
+          }
+        }
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.BULK_SET_PROPERTIES, {
+          targets: params.targets,
+          root: params.root,
+          className: params.className,
+          properties: params.properties
+        }, 1e3 * 60);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Bulk set failed" };
+        }
+        return {
+          success: true,
+          data: {
+            modified: payload.modified,
+            errors: payload.errors?.length ? payload.errors : void 0
+          }
+        };
+      }
+    };
+  }
+});
+
+// src/tools/studio/find-replace-scripts.ts
+var find_replace_scripts_exports = {};
+__export(find_replace_scripts_exports, {
+  tool: () => tool25
+});
+var tool25;
+var init_find_replace_scripts = __esm({
+  "src/tools/studio/find-replace-scripts.ts"() {
+    init_protocol();
+    tool25 = {
+      name: "find_replace_scripts",
+      description: 'Find and replace text across all scripts in the game (or under a root path). Supports plain text and Lua pattern matching. Returns a list of modified scripts with match counts.\n\nUse dryRun=true to preview changes without applying them.\nExample: find="workspace" replace="Workspace" root="ServerScriptService"',
+      parameters: {
+        type: "object",
+        properties: {
+          find: {
+            type: "string",
+            description: "Text or Lua pattern to search for"
+          },
+          replace: {
+            type: "string",
+            description: "Replacement text (supports Lua pattern captures like %1, %2)"
+          },
+          root: {
+            type: "string",
+            description: "Root path to limit search scope (optional, searches entire game if omitted)"
+          },
+          usePattern: {
+            type: "boolean",
+            description: "If true, treat find/replace as Lua patterns. Default: false (plain text)"
+          },
+          dryRun: {
+            type: "boolean",
+            description: "If true, report matches but do not modify scripts. Default: false"
+          }
+        },
+        required: ["find", "replace"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.FIND_REPLACE_SCRIPTS, {
+          find: params.find,
+          replace: params.replace,
+          root: params.root,
+          usePattern: params.usePattern ?? false,
+          dryRun: params.dryRun ?? false
+        }, 1e3 * 60 * 5);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Find/replace failed" };
+        }
+        return {
+          success: true,
+          data: {
+            totalFiles: payload.totalFiles,
+            totalMatches: payload.totalMatches,
+            modified: payload.modified,
+            dryRun: params.dryRun ?? false
+          }
+        };
+      }
+    };
+  }
+});
+
 // src/tools/memory/recall.ts
 var recall_exports = {};
 __export(recall_exports, {
-  tool: () => tool21
+  tool: () => tool26
 });
-var tool21;
+var tool26;
 var init_recall = __esm({
   "src/tools/memory/recall.ts"() {
     init_store();
-    tool21 = {
+    tool26 = {
       name: "recall_memory",
       description: "Search your memory for previously learned facts about the current project. Use this to recall architecture decisions, patterns, known bugs, or user preferences.",
       parameters: {
@@ -1999,13 +2279,13 @@ var init_recall = __esm({
 // src/tools/memory/remember.ts
 var remember_exports = {};
 __export(remember_exports, {
-  tool: () => tool22
+  tool: () => tool27
 });
-var tool22;
+var tool27;
 var init_remember = __esm({
   "src/tools/memory/remember.ts"() {
     init_store();
-    tool22 = {
+    tool27 = {
       name: "remember",
       description: "Store a fact about the current project in persistent memory. Use this to remember architecture decisions, patterns, bugs found, or user preferences so you can recall them in future sessions.",
       parameters: {
@@ -2045,12 +2325,12 @@ var init_remember = __esm({
 // src/tools/cloud/upload-asset.ts
 var upload_asset_exports = {};
 __export(upload_asset_exports, {
-  tool: () => tool23
+  tool: () => tool28
 });
-var tool23;
+var tool28;
 var init_upload_asset = __esm({
   "src/tools/cloud/upload-asset.ts"() {
-    tool23 = {
+    tool28 = {
       name: "upload_asset",
       description: "Upload a local file (image, model, audio) to Roblox via the Open Cloud API. Requires an Open Cloud API key configured in dominus.",
       parameters: {
@@ -2088,11 +2368,11 @@ var init_upload_asset = __esm({
         const assetType = params.assetType;
         const name = params.name;
         const description = params.description ?? "";
-        if (!fs4.existsSync(filePath)) {
+        if (!fs5.existsSync(filePath)) {
           return { success: false, error: `File not found: ${filePath}` };
         }
-        const fileBuffer = fs4.readFileSync(filePath);
-        const fileName = path3.basename(filePath);
+        const fileBuffer = fs5.readFileSync(filePath);
+        const fileName = path4.basename(filePath);
         const typeMapping = {
           Image: "Decal",
           Audio: "Audio",
@@ -2146,6 +2426,57 @@ var init_upload_asset = __esm({
   }
 });
 
+// src/tools/studio/undo-redo.ts
+var undo_redo_exports = {};
+__export(undo_redo_exports, {
+  redoTool: () => redoTool,
+  undoTool: () => undoTool
+});
+var undoTool, redoTool;
+var init_undo_redo = __esm({
+  "src/tools/studio/undo-redo.ts"() {
+    init_protocol();
+    undoTool = {
+      name: "undo",
+      description: "Undo the last action in Roblox Studio using ChangeHistoryService. Works just like Ctrl+Z. Use this to roll back mistakes.",
+      parameters: {
+        type: "object",
+        properties: {}
+      },
+      async execute(_params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.UNDO, {});
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Undo failed" };
+        }
+        return { success: true, data: "Undo performed" };
+      }
+    };
+    redoTool = {
+      name: "redo",
+      description: "Redo the last undone action in Roblox Studio using ChangeHistoryService. Works just like Ctrl+Y.",
+      parameters: {
+        type: "object",
+        properties: {}
+      },
+      async execute(_params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.REDO, {});
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Redo failed" };
+        }
+        return { success: true, data: "Redo performed" };
+      }
+    };
+  }
+});
+
 // src/mcp/server.ts
 var server_exports = {};
 __export(server_exports, {
@@ -2166,15 +2497,15 @@ async function startMcpServer() {
   }
   const mcp = new McpServer({
     name: "dominus",
-    version: "0.2.0"
+    version: "0.2.1"
   });
   mcp.tool(
     "read_script",
     "Read the source code of a script in Roblox Studio",
     { path: z.string().describe('Full instance path, e.g. "ServerScriptService.GameManager"') },
-    async ({ path: path4 }) => {
+    async ({ path: path5 }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.GET_SCRIPT, { path: path4 });
+      const res = await bridge.sendRequest(CliMsg.GET_SCRIPT, { path: path5 });
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
   );
@@ -2185,9 +2516,9 @@ async function startMcpServer() {
       path: z.string().describe("Full instance path"),
       source: z.string().describe("New complete source code")
     },
-    async ({ path: path4, source }) => {
+    async ({ path: path5, source }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.SET_SCRIPT, { path: path4, source });
+      const res = await bridge.sendRequest(CliMsg.SET_SCRIPT, { path: path5, source });
       return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
     }
   );
@@ -2221,9 +2552,22 @@ async function startMcpServer() {
     "get_properties",
     "Get all properties of an instance in Roblox Studio",
     { path: z.string().describe("Full instance path") },
-    async ({ path: path4 }) => {
+    async ({ path: path5 }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.GET_PROPERTIES, { path: path4 });
+      const res = await bridge.sendRequest(CliMsg.GET_PROPERTIES, { path: path5 });
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "get_descendants_properties",
+    "Easily get all descendants of a UI instance (or any instance) and all of their properties.",
+    {
+      path: z.string().describe('Full instance path (e.g., "Workspace.Part", "StarterGui.ScreenGui")'),
+      outputFile: z.string().optional().describe("Optional file path to write to prevent limit errors/timeouts")
+    },
+    async ({ path: path5, outputFile }) => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.GET_DESCENDANTS_PROPERTIES, { path: path5, outputFile }, 1e3 * 60 * 5);
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
   );
@@ -2234,9 +2578,9 @@ async function startMcpServer() {
       path: z.string().describe("Full instance path"),
       properties: z.record(z.unknown()).describe("Key-value pairs of properties to set")
     },
-    async ({ path: path4, properties }) => {
+    async ({ path: path5, properties }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.SET_PROPERTIES, { path: path4, properties });
+      const res = await bridge.sendRequest(CliMsg.SET_PROPERTIES, { path: path5, properties });
       return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
     }
   );
@@ -2264,9 +2608,9 @@ async function startMcpServer() {
     "delete_instance",
     "Delete an instance from the Roblox Studio DataModel",
     { path: z.string().describe("Full instance path to delete") },
-    async ({ path: path4 }) => {
+    async ({ path: path5 }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.DELETE_INSTANCE, { path: path4 });
+      const res = await bridge.sendRequest(CliMsg.DELETE_INSTANCE, { path: path5 });
       return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
     }
   );
@@ -2326,13 +2670,14 @@ async function startMcpServer() {
       parent: z.string().optional().describe('Parent: "StarterGui", "PlayerGui", or path. Default: StarterGui'),
       tree: z.record(z.unknown()).describe(
         'Root UI node: {ClassName, Name, properties..., Children: [{...}, ...]}. UDim2 as [xScale, xOffset, yScale, yOffset], Color3 as "#hex", Font as "GothamBold"'
-      )
+      ),
+      animate: z.boolean().optional().describe("If true, task.wait() will be injected between creation of nodes so that the UI writes out dynamically.")
     },
-    async ({ parent, tree }) => {
+    async ({ parent, tree, animate }) => {
       assertConnected();
       const res = await bridge.sendRequest(
         CliMsg.BUILD_UI,
-        { parent: parent ?? "StarterGui", tree }
+        { parent: parent ?? "StarterGui", tree, animate }
       );
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
@@ -2463,8 +2808,8 @@ async function startMcpServer() {
       const parentParts = parent.split(".");
       let parentResolve = "game";
       for (const p of parentParts) parentResolve += `["${p}"]`;
-      const resolves = params.paths.map((path4) => {
-        const parts = path4.split(".");
+      const resolves = params.paths.map((path5) => {
+        const parts = path5.split(".");
         let r = "game";
         for (const part of parts) r += `["${part}"]`;
         return r;
@@ -2504,8 +2849,8 @@ async function startMcpServer() {
       const parts = params.parts;
       const groupName = params.groupName;
       const groupParent = params.groupParent ?? "Workspace";
-      function resolveP(path4) {
-        const segs = path4.split(".");
+      function resolveP(path5) {
+        const segs = path5.split(".");
         let r = "game";
         for (const s of segs) r += `["${s}"]`;
         return r;
@@ -3774,13 +4119,13 @@ var AIProvider = class {
     yield { type: "done" };
   }
 };
-function toolToOpenAI(tool24) {
+function toolToOpenAI(tool29) {
   return {
     type: "function",
     function: {
-      name: tool24.name,
-      description: tool24.description,
-      parameters: tool24.parameters
+      name: tool29.name,
+      description: tool29.description,
+      parameters: tool29.parameters
     }
   };
 }
@@ -4236,11 +4581,11 @@ var AgentLoop = class {
 // src/tools/registry.ts
 var ToolRegistry = class {
   tools = /* @__PURE__ */ new Map();
-  register(tool24) {
-    if (this.tools.has(tool24.name)) {
-      throw new Error(`Tool already registered: ${tool24.name}`);
+  register(tool29) {
+    if (this.tools.has(tool29.name)) {
+      throw new Error(`Tool already registered: ${tool29.name}`);
     }
-    this.tools.set(tool24.name, tool24);
+    this.tools.set(tool29.name, tool29);
   }
   get(name) {
     return this.tools.get(name);
@@ -4252,12 +4597,12 @@ var ToolRegistry = class {
     return this.getAll();
   }
   async execute(call, ctx) {
-    const tool24 = this.tools.get(call.name);
-    if (!tool24) {
+    const tool29 = this.tools.get(call.name);
+    if (!tool29) {
       return { success: false, error: `Unknown tool: ${call.name}` };
     }
     try {
-      return await tool24.execute(call.arguments, ctx);
+      return await tool29.execute(call.arguments, ctx);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       return { success: false, error: message };
@@ -4275,6 +4620,7 @@ function createDefaultRegistry() {
     Promise.resolve().then(() => (init_run_code(), run_code_exports)),
     Promise.resolve().then(() => (init_get_explorer(), get_explorer_exports)),
     Promise.resolve().then(() => (init_get_properties(), get_properties_exports)),
+    Promise.resolve().then(() => (init_get_descendants_properties(), get_descendants_properties_exports)),
     Promise.resolve().then(() => (init_set_properties(), set_properties_exports)),
     Promise.resolve().then(() => (init_insert_instance(), insert_instance_exports)),
     Promise.resolve().then(() => (init_delete_instance(), delete_instance_exports)),
@@ -4290,6 +4636,10 @@ function createDefaultRegistry() {
     Promise.resolve().then(() => (init_clone_instance(), clone_instance_exports)),
     Promise.resolve().then(() => (init_group_instances(), group_instances_exports)),
     Promise.resolve().then(() => (init_build_multiple(), build_multiple_exports)),
+    Promise.resolve().then(() => (init_serialize_ui(), serialize_ui_exports)),
+    Promise.resolve().then(() => (init_move_instance(), move_instance_exports)),
+    Promise.resolve().then(() => (init_bulk_set_properties(), bulk_set_properties_exports)),
+    Promise.resolve().then(() => (init_find_replace_scripts(), find_replace_scripts_exports)),
     Promise.resolve().then(() => (init_recall(), recall_exports)),
     Promise.resolve().then(() => (init_remember(), remember_exports)),
     Promise.resolve().then(() => (init_upload_asset(), upload_asset_exports))
@@ -4300,13 +4650,108 @@ function createDefaultRegistry() {
       if (m.tool) registry.register(m.tool);
     })
   );
+  void Promise.resolve().then(() => (init_undo_redo(), undo_redo_exports)).then((m) => {
+    registry.register(m.undoTool);
+    registry.register(m.redoTool);
+  });
   return registry;
 }
 
 // src/index.tsx
 init_store();
 init_config();
-var VERSION = "0.2.0";
+var CACHE_DIR = path4.join(os3.homedir(), ".dominus");
+var CACHE_FILE = path4.join(CACHE_DIR, "update-check.json");
+var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
+var NPM_PACKAGE = "dominus-cli";
+function readCache() {
+  try {
+    if (fs5.existsSync(CACHE_FILE)) {
+      return JSON.parse(fs5.readFileSync(CACHE_FILE, "utf-8"));
+    }
+  } catch {
+  }
+  return { lastCheck: 0, latestVersion: null };
+}
+function writeCache(cache) {
+  try {
+    if (!fs5.existsSync(CACHE_DIR)) fs5.mkdirSync(CACHE_DIR, { recursive: true });
+    fs5.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf-8");
+  } catch {
+  }
+}
+function fetchLatestVersion() {
+  return new Promise((resolve) => {
+    const req = https.get(
+      `https://registry.npmjs.org/${NPM_PACKAGE}/latest`,
+      { headers: { Accept: "application/json" }, timeout: 5e3 },
+      (res) => {
+        if (res.statusCode !== 200) {
+          resolve(null);
+          res.resume();
+          return;
+        }
+        let body = "";
+        res.on("data", (c) => body += c);
+        res.on("end", () => {
+          try {
+            resolve(JSON.parse(body).version ?? null);
+          } catch {
+            resolve(null);
+          }
+        });
+      }
+    );
+    req.on("error", () => resolve(null));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve(null);
+    });
+  });
+}
+function compareVersions(current, latest) {
+  const a = current.split(".").map(Number);
+  const b = latest.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((b[i] ?? 0) > (a[i] ?? 0)) return 1;
+    if ((b[i] ?? 0) < (a[i] ?? 0)) return -1;
+  }
+  return 0;
+}
+async function checkForUpdate(currentVersion) {
+  try {
+    const cache = readCache();
+    const now = Date.now();
+    if (now - cache.lastCheck < CHECK_INTERVAL_MS && cache.latestVersion) {
+      if (compareVersions(currentVersion, cache.latestVersion) > 0) {
+        return { updateAvailable: true, currentVersion, latestVersion: cache.latestVersion };
+      }
+      return null;
+    }
+    const latest = await fetchLatestVersion();
+    writeCache({ lastCheck: now, latestVersion: latest });
+    if (latest && compareVersions(currentVersion, latest) > 0) {
+      return { updateAvailable: true, currentVersion, latestVersion: latest };
+    }
+  } catch {
+  }
+  return null;
+}
+function formatUpdateMessage(info) {
+  const line1 = `Update available: ${info.currentVersion} \u2192 ${info.latestVersion}`;
+  const line2 = `Run: npm i -g ${NPM_PACKAGE}`;
+  const width = Math.max(line1.length, line2.length) + 4;
+  const pad = (s) => `  \u2502  ${s}${" ".repeat(width - s.length - 4)}  \u2502`;
+  return [
+    "",
+    `  \u256D${"\u2500".repeat(width)}\u256E`,
+    pad(line1),
+    pad(line2),
+    `  \u2570${"\u2500".repeat(width)}\u256F`,
+    ""
+  ].join("\n");
+}
+var VERSION = "0.2.1";
 var program = new Command();
 program.name("dominus").description("AI-powered autonomous agent for Roblox Studio development").version(VERSION);
 program.command("start", { isDefault: true }).description("Launch the Dominus TUI agent").option("-p, --port <port>", "WebSocket server port", "18088").action(async (opts) => {
@@ -4326,6 +4771,10 @@ program.command("start", { isDefault: true }).description("Launch the Dominus TU
       setConfigValue("userName", firstName);
     }
   }
+  checkForUpdate(VERSION).then((info) => {
+    if (info) process.stderr.write(formatUpdateMessage(info));
+  }).catch(() => {
+  });
   await launchApp(port);
 });
 var configCmd = program.command("config").description("Manage Dominus configuration");
@@ -4416,24 +4865,24 @@ rulesCmd.command("list").description("List all rules").action(() => {
 });
 program.command("install-plugin").description("Build & install the Dominus plugin into Roblox Studio").action(async () => {
   const { execSync: execSync2 } = await import('child_process');
-  const packageRoot = path3.resolve(import.meta.dirname ?? __dirname, "..");
-  const pluginDir = path3.join(packageRoot, "plugin");
-  const pluginProject = path3.join(pluginDir, "default.project.json");
-  const studioPlugins = path3.join(
-    os2.homedir(),
+  const packageRoot = path4.resolve(import.meta.dirname ?? __dirname, "..");
+  const pluginDir = path4.join(packageRoot, "plugin");
+  const pluginProject = path4.join(pluginDir, "default.project.json");
+  const studioPlugins = path4.join(
+    os3.homedir(),
     "AppData",
     "Local",
     "Roblox",
     "Plugins"
   );
-  const destFile = path3.join(studioPlugins, "Dominus.rbxm");
-  if (!fs4.existsSync(pluginProject)) {
+  const destFile = path4.join(studioPlugins, "Dominus.rbxm");
+  if (!fs5.existsSync(pluginProject)) {
     console.log("  \u2716 Plugin source not found.");
     console.log(`  Expected at: ${pluginDir}`);
     return;
   }
-  if (!fs4.existsSync(studioPlugins)) {
-    fs4.mkdirSync(studioPlugins, { recursive: true });
+  if (!fs5.existsSync(studioPlugins)) {
+    fs5.mkdirSync(studioPlugins, { recursive: true });
   }
   let rojoAvailable = false;
   try {
@@ -4460,49 +4909,49 @@ program.command("mcp").description("Start the Dominus MCP server (for Cursor, Cl
   await startMcpServer2();
 });
 function getMcpTargets() {
-  const home = os2.homedir();
-  const appData = process.env.APPDATA || path3.join(home, "AppData", "Roaming");
-  const localAppData = process.env.LOCALAPPDATA || path3.join(home, "AppData", "Local");
+  const home = os3.homedir();
+  const appData = process.env.APPDATA || path4.join(home, "AppData", "Roaming");
+  const localAppData = process.env.LOCALAPPDATA || path4.join(home, "AppData", "Local");
   const cwd = process.cwd();
   return [
     {
       name: "Cursor (project)",
-      configPath: path3.join(cwd, ".cursor", "mcp.json"),
+      configPath: path4.join(cwd, ".cursor", "mcp.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "Cursor (global)",
-      configPath: path3.join(home, ".cursor", "mcp.json"),
+      configPath: path4.join(home, ".cursor", "mcp.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "Claude Desktop",
-      configPath: path3.join(appData, "Claude", "claude_desktop_config.json"),
+      configPath: path4.join(appData, "Claude", "claude_desktop_config.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "Claude Code",
-      configPath: path3.join(home, ".claude.json"),
+      configPath: path4.join(home, ".claude.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "Windsurf (project)",
-      configPath: path3.join(cwd, ".windsurf", "mcp.json"),
+      configPath: path4.join(cwd, ".windsurf", "mcp.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "Windsurf (global)",
-      configPath: path3.join(home, ".codeium", "windsurf", "mcp_config.json"),
+      configPath: path4.join(home, ".codeium", "windsurf", "mcp_config.json"),
       keyPath: ["mcpServers"]
     },
     {
       name: "VS Code (project)",
-      configPath: path3.join(cwd, ".vscode", "mcp.json"),
+      configPath: path4.join(cwd, ".vscode", "mcp.json"),
       keyPath: ["servers"]
     },
     {
       name: "VS Code (global)",
-      configPath: path3.join(localAppData, "Code", "User", "settings.json"),
+      configPath: path4.join(localAppData, "Code", "User", "settings.json"),
       keyPath: ["mcp", "servers"]
     }
   ];
@@ -4514,9 +4963,9 @@ var dominusEntry = {
 };
 function injectMcpConfig(target) {
   let config = {};
-  if (fs4.existsSync(target.configPath)) {
+  if (fs5.existsSync(target.configPath)) {
     try {
-      config = JSON.parse(fs4.readFileSync(target.configPath, "utf-8"));
+      config = JSON.parse(fs5.readFileSync(target.configPath, "utf-8"));
     } catch {
       config = {};
     }
@@ -4532,12 +4981,12 @@ function injectMcpConfig(target) {
     return { status: "already" };
   }
   obj["dominus"] = { ...dominusEntry };
-  const dir = path3.dirname(target.configPath);
-  if (!fs4.existsSync(dir)) {
-    fs4.mkdirSync(dir, { recursive: true });
+  const dir = path4.dirname(target.configPath);
+  if (!fs5.existsSync(dir)) {
+    fs5.mkdirSync(dir, { recursive: true });
   }
-  fs4.writeFileSync(target.configPath, JSON.stringify(config, null, 2), "utf-8");
-  return { status: fs4.existsSync(target.configPath) ? "installed" : "created" };
+  fs5.writeFileSync(target.configPath, JSON.stringify(config, null, 2), "utf-8");
+  return { status: fs5.existsSync(target.configPath) ? "installed" : "created" };
 }
 program.command("mcp-install").description("Auto-install Dominus MCP into Cursor, VS Code, Claude Desktop, Windsurf, etc.").option("-a, --all", "Install to all detected editors").action(async (opts) => {
   const targets = getMcpTargets();
@@ -4559,7 +5008,7 @@ program.command("mcp-install").description("Auto-install Dominus MCP into Cursor
   }
   const detected = targets.map((t) => ({
     target: t,
-    exists: fs4.existsSync(path3.dirname(t.configPath))
+    exists: fs5.existsSync(path4.dirname(t.configPath))
   }));
   const toInstall = detected.filter((d) => d.exists);
   if (toInstall.length === 0) {
@@ -4632,23 +5081,23 @@ program.command("mcp-setup").description("Print MCP configuration for manual set
   console.log("");
 });
 function buildPluginXml(pluginDir, destFile) {
-  const srcDir = path3.join(pluginDir, "src");
-  if (!fs4.existsSync(srcDir)) {
+  const srcDir = path4.join(pluginDir, "src");
+  if (!fs5.existsSync(srcDir)) {
     console.log(`  \u2716 Plugin source directory not found: ${srcDir}`);
     return;
   }
-  const files = fs4.readdirSync(srcDir).filter((f) => f.endsWith(".lua"));
+  const files = fs5.readdirSync(srcDir).filter((f) => f.endsWith(".lua"));
   const mainFile = files.find((f) => f === "init.server.lua");
   const moduleFiles = files.filter((f) => f !== "init.server.lua");
   if (!mainFile) {
     console.log("  \u2716 init.server.lua not found in plugin source");
     return;
   }
-  const mainSource = fs4.readFileSync(path3.join(srcDir, mainFile), "utf-8");
+  const mainSource = fs5.readFileSync(path4.join(srcDir, mainFile), "utf-8");
   let moduleItems = "";
   for (const mf of moduleFiles) {
     const modName = mf.replace(".lua", "");
-    const modSource = fs4.readFileSync(path3.join(srcDir, mf), "utf-8");
+    const modSource = fs5.readFileSync(path4.join(srcDir, mf), "utf-8");
     moduleItems += `
       <Item class="ModuleScript" referent="${modName}">
         <Properties>
@@ -4666,7 +5115,7 @@ function buildPluginXml(pluginDir, destFile) {
     </Properties>${moduleItems}
   </Item>
 </roblox>`;
-  fs4.writeFileSync(destFile, rbxmx, "utf-8");
+  fs5.writeFileSync(destFile, rbxmx, "utf-8");
   console.log(`  \u2714 Plugin installed to: ${destFile}`);
   console.log("  Restart Roblox Studio to load the plugin.");
 }