dominus-cli 0.5.0 → 0.5.2

package/dist/index.js

@@ -19,6 +19,7 @@ import { randomBytes } from 'crypto';
 import Spinner from 'ink-spinner';
 import OpenAI from 'openai';
 import https from 'https';
+import { fileURLToPath } from 'url';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -628,6 +629,66 @@ var init_ws_client = __esm({
   }
 });
 
+// src/agent/internal-memory.ts
+var INTERNAL_MEMORY;
+var init_internal_memory = __esm({
+  "src/agent/internal-memory.ts"() {
+    INTERNAL_MEMORY = `## Internal Memory \u2014 Known Quirks & Lessons
+
+These are built-in lessons that ship with Dominus. Follow them exactly.
+
+### create_ui \u2014 property format
+- Each node accepts properties in **either** of two shapes:
+  - **Flattened (preferred)**: props as top-level keys next to \`ClassName\`, \`Name\`, \`Children\`.
+    \`\`\`json
+    { "ClassName": "TextButton", "Name": "Btn", "Text": "OK", "Size": [0, 100, 0, 40] }
+    \`\`\`
+  - **Nested bag**: props grouped under \`properties\` / \`Properties\` / \`props\` / \`Props\`.
+    \`\`\`json
+    { "ClassName": "TextButton", "Name": "Btn",
+      "properties": { "Text": "OK", "Size": [0, 100, 0, 40] } }
+    \`\`\`
+- Do NOT mix a nested \`properties\` bag with flattened props of the same name \u2014 the bag wins.
+- Reserved keys (never treated as instance properties): \`ClassName\`, \`className\`, \`Name\`, \`name\`, \`Children\`, \`children\`, \`properties\`, \`Properties\`, \`props\`, \`Props\`.
+
+### build_multiple \u2014 schema is strict
+- Top-level keys only: \`name\`, \`className\`, \`position\`, \`size\`, \`color\`, \`material\`, \`anchored\`, \`shape\`, \`transparency\`, \`parent\`, \`canCollide\`.
+- Does NOT accept a nested \`properties\` bag. For anything outside those fields use \`insert_instance\` + \`set_properties\`.
+- \`shape\` values: \`Block\`, \`Ball\`, \`Cylinder\`, \`Wedge\`.
+
+### Color formats (accepted everywhere)
+- Hex: \`"#RRGGBB"\`
+- RGB string: \`"rgb(255, 128, 0)"\`
+- BrickColor name: \`"Bright red"\`, \`"Institutional white"\`, \`"Really black"\`, etc.
+- Array: \`[r, g, b]\` (0\u20131 floats) or \`[255, 128, 0]\` (auto-detected if any value > 1)
+
+### UDim2 / UDim / Vector2 / Color3 coercion (create_ui)
+- UDim2: \`[xScale, xOffset, yScale, yOffset]\` or \`{XScale, XOffset, YScale, YOffset}\`.
+- UDim: \`[scale, offset]\` or a plain number (treated as pixels).
+- Vector2 (e.g. \`AnchorPoint\`): \`[x, y]\` or \`{x, y}\`.
+- 2-element arrays are auto-disambiguated by property name (\`AnchorPoint\` \u2192 Vector2, \`CornerRadius\` \u2192 UDim).
+
+### Common GUI property names
+- GUI uses \`Size\`/\`Position\` as **UDim2** \u2014 never Vector3.
+- \`BackgroundColor3\`, \`TextColor3\`, \`BorderColor3\`, \`ImageColor3\` \u2192 Color3.
+- \`Font\` accepts a string enum name like \`"GothamBold"\`, \`"SourceSans"\`.
+- Enum properties take the string name: \`"Center"\`, \`"Left"\`, \`"Fit"\`.
+
+### Tool selection cheat-sheet
+- Single 3D part \u2192 \`create_part\`
+- Many 3D parts (tree, building, vehicle) \u2192 \`build_multiple\` with \`groupName\`
+- Full UI tree \u2192 \`create_ui\` (one call, never loop \`insert_instance\` for UI)
+- Adjusting an existing instance \u2192 \`set_properties\` (not \`run_code\`)
+- Anything exotic or procedural \u2192 \`run_code\` as last resort
+
+### Verification habits
+- After a build, call \`get_explorer\` or \`get_selection\` to confirm the tree looks right.
+- After editing a script, read it back.
+- After \`run_code\`, check \`get_output\` for errors.
+`;
+  }
+});
+
 // src/memory/store.ts
 var store_exports = {};
 __export(store_exports, {
@@ -1517,7 +1578,7 @@ 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} (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.'
+            description: 'The root UI node. Each node has: ClassName (string), Name (string), Children (array of child nodes), and properties. Properties may be specified either flattened at the top level of the node, OR nested under a "properties" / "Properties" / "props" key \u2014 both work. 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",
@@ -2498,6 +2559,8 @@ async function startMcpServer() {
   const mcp = new McpServer({
     name: "dominus",
     version: "0.2.1"
+  }, {
+    instructions: INTERNAL_MEMORY
   });
   mcp.tool(
     "read_script",
@@ -2950,6 +3013,7 @@ var init_server = __esm({
     init_protocol();
     init_store();
     init_config();
+    init_internal_memory();
   }
 });
 var CROWN_ART = `    \u25C6       \u25C6       \u25C6
@@ -4131,6 +4195,7 @@ function toolToOpenAI(tool29) {
 }
 
 // src/agent/system-prompt.ts
+init_internal_memory();
 function buildSystemPrompt(opts) {
   const parts = [];
   parts.push(`You are Dominus, an expert AI agent for Roblox Studio development.
@@ -4289,7 +4354,9 @@ The \`get_class_info\` tool queries Roblox's ReflectionService to return the com
 - All events with parameter types
 - Superclass, creatability, serialization info
 
-Use it whenever you're unsure about property names or types. It's fast and cached.`);
+Use it whenever you're unsure about property names or types. It's fast and cached.
+
+${INTERNAL_MEMORY}`);
   return parts.join("\n");
 }
 
@@ -4751,7 +4818,62 @@ function formatUpdateMessage(info) {
     ""
   ].join("\n");
 }
-var VERSION = "0.2.1";
+async function autoUpdate(currentVersion) {
+  const info = await checkForUpdate(currentVersion);
+  if (!info?.updateAvailable) {
+    return { success: true, from: currentVersion, to: currentVersion };
+  }
+  const managers = [
+    { name: "pnpm", check: "pnpm list -g dominus-cli", cmd: "pnpm add -g dominus-cli@latest" },
+    { name: "npm", check: "npm list -g dominus-cli", cmd: "npm install -g dominus-cli@latest" },
+    { name: "yarn", check: "yarn global list --pattern dominus-cli", cmd: "yarn global add dominus-cli@latest" }
+  ];
+  let installCmd = null;
+  for (const mgr of managers) {
+    try {
+      const out = execSync(mgr.check, { stdio: "pipe", timeout: 1e4 }).toString();
+      if (out.includes("dominus-cli")) {
+        installCmd = mgr.cmd;
+        break;
+      }
+    } catch {
+    }
+  }
+  if (!installCmd) {
+    try {
+      const out = execSync("pnpm list -g dominus-cli", { stdio: "pipe", timeout: 1e4 }).toString();
+      if (out.includes("link:")) {
+        const pkgPath = path4.resolve(__dirname$1, "..");
+        if (fs5.existsSync(path4.join(pkgPath, ".git"))) {
+          try {
+            execSync("git pull", { cwd: pkgPath, stdio: "pipe", timeout: 3e4 });
+            execSync("pnpm install", { cwd: pkgPath, stdio: "pipe", timeout: 6e4 });
+            execSync("pnpm build", { cwd: pkgPath, stdio: "pipe", timeout: 6e4 });
+            execSync("pnpm build:plugin", { cwd: pkgPath, stdio: "pipe", timeout: 3e4 });
+            return { success: true, from: currentVersion, to: info.latestVersion };
+          } catch (err) {
+            return { success: false, from: currentVersion, to: info.latestVersion, error: `Git pull/rebuild failed: ${err}` };
+          }
+        }
+        return { success: false, from: currentVersion, to: info.latestVersion, error: 'Linked install without git \u2014 run "pnpm build" manually in the repo' };
+      }
+    } catch {
+    }
+  }
+  if (!installCmd) {
+    installCmd = `npm install -g ${NPM_PACKAGE}@latest`;
+  }
+  try {
+    execSync(installCmd, { stdio: "pipe", timeout: 12e4 });
+    writeCache({ lastCheck: 0, latestVersion: null });
+    return { success: true, from: currentVersion, to: info.latestVersion };
+  } catch (err) {
+    return { success: false, from: currentVersion, to: info.latestVersion, error: `Update command failed: ${err}` };
+  }
+}
+var __dirname$1 = path4.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, "$1"));
+var __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
+var VERSION = JSON.parse(fs5.readFileSync(path4.join(__dirname2, "..", "package.json"), "utf-8")).version;
 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) => {
@@ -4863,9 +4985,24 @@ rulesCmd.command("list").description("List all rules").action(() => {
   }
   console.log("");
 });
+program.command("update").description("Auto-update Dominus to the latest version").action(async () => {
+  console.log(`  Current version: ${VERSION}`);
+  console.log("  Checking for updates...");
+  const result = await autoUpdate(VERSION);
+  if (result.from === result.to && result.success) {
+    console.log("  Already on the latest version.");
+    return;
+  }
+  if (result.success) {
+    console.log(`  \u2714 Updated: ${result.from} \u2192 ${result.to}`);
+    console.log("  Restart dominus to use the new version.");
+  } else {
+    console.error(`  \u2718 Update failed: ${result.error}`);
+  }
+});
 program.command("install-plugin").description("Build & install the Dominus plugin into Roblox Studio").action(async () => {
-  const { execSync: execSync2 } = await import('child_process');
-  const packageRoot = path4.resolve(import.meta.dirname ?? __dirname, "..");
+  const { execSync: execSync3 } = await import('child_process');
+  const packageRoot = path4.resolve(import.meta.dirname ?? __dirname2, "..");
   const pluginDir = path4.join(packageRoot, "plugin");
   const pluginProject = path4.join(pluginDir, "default.project.json");
   const studioPlugins = path4.join(
@@ -4886,14 +5023,14 @@ program.command("install-plugin").description("Build & install the Dominus plugi
   }
   let rojoAvailable = false;
   try {
-    execSync2("rojo --version", { stdio: "pipe" });
+    execSync3("rojo --version", { stdio: "pipe" });
     rojoAvailable = true;
   } catch {
   }
   if (rojoAvailable) {
     try {
       console.log("  Building plugin with Rojo...");
-      execSync2(`rojo build "${pluginDir}" -o "${destFile}"`, { stdio: "pipe" });
+      execSync3(`rojo build "${pluginDir}" -o "${destFile}"`, { stdio: "pipe" });
       console.log(`  \u2714 Plugin built and installed to: ${destFile}`);
       console.log("  Restart Roblox Studio to load the plugin.");
     } catch (err) {