dominus-cli 2.1.1 → 2.2.1

package/docs/DOMINUS_2_PLAN.md

@@ -13,8 +13,8 @@ set of Studio inspection, mutation, documentation, and verification tools.
   text fallbacks, `isError`, and accurate tool risk annotations.
 - Keep stdio as the MCP transport. It limits the MCP server itself to the process
   that launched it and avoids exposing another localhost HTTP endpoint.
-- Do not depend on legacy sampling, roots, or MCP logging. They are deprecated in
-  the 2026-07-28 release candidate.
+- Use optional MCP Sampling only for the explicit parallel coordinator. Detect the
+  client capability first and keep every normal Studio tool independent of it.
 - Do not adopt the legacy experimental Tasks API. Long Studio calls remain normal
   cancellable tool calls until the July Tasks extension is final and broadly
   supported by clients and the TypeScript SDK.
@@ -40,6 +40,9 @@ Official references:
    Failed batches are cancelled and automatically undone.
 7. Script writes require the revision hash returned by the read operation.
 8. There is no arbitrary Luau execution tool.
+9. Broad tasks can opt into an MCP-native coordinator. It partitions immediate
+   child branches, sends bounded read-only evidence to concurrent Sampling workers,
+   validates scoped proposals, and owns the only atomic Studio write.
 
 ## MCP tool surface
 
@@ -50,6 +53,7 @@ Official references:
 - `studio_build_ui`, `studio_snapshot_ui`
 - `studio_run_test`, `studio_get_output`
 - `roblox_search_api`, `roblox_get_api`
+- `run_parallel_task` for Sampling-capable MCP clients
 
 The intended agent loop is inspect, plan, apply, read back, test. Tool descriptions
 and the server prompt make that workflow explicit without embedding another LLM
@@ -62,6 +66,8 @@ inside the MCP server.
   tool arrays/depth/source lengths.
 - Dedicated mutation tools only; no `loadstring` or generic `run_code` path.
 - Explicit destructive tool for deletion.
+- Parallel workers are proposal-only; stable refs must match supplied evidence,
+  writes must remain in owned scopes, and overlapping proposals are rejected.
 - Atomic UI replacement: build and validate off-tree before replacing the live UI.
 - Output watcher filters every Dominus-prefixed message to prevent feedback loops.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominus-cli",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "description": "Dominus 2: a secure, MCP-native Roblox Studio engineering agent bridge.",
   "type": "module",
   "bin": {

package/plugin/Dominus.rbxmx

@@ -2,8 +2,12 @@
   <Item class="Script" referent="0">
     <Properties>
       <string name="Name">Dominus</string>
-      <token name="RunContext">0</token>
-      <string name="Source"><![CDATA[local HttpService = game:GetService("HttpService")
+      <token name="RunContext">3</token>
+      <string name="Source"><![CDATA[if script.RunContext ~= Enum.RunContext.Plugin then
+	return
+end
+
+local HttpService = game:GetService("HttpService")
 
 local EmbeddedBridgeToken = require(script.BridgeConfig)
 local CommandRouter = require(script.CommandRouter)
@@ -121,7 +125,7 @@ local function handleMessage(rawMessage)
 	end
 
 	if message.type == "server:auth_rejected" then
-		warn("[Dominus 2] Authentication failed. Run dominus-install-plugin and restart Studio.")
+		warn("[Dominus 2] Authentication failed. Run dominus-install-plugin to refresh the local plugin.")
 		WsClient.disconnect()
 		return
 	end
@@ -3384,7 +3388,7 @@ function ValueCodec.encode(value)
 end
 
 function ValueCodec.setProperty(instance, propertyName, value)
-	if propertyName == "Parent" or propertyName == "ClassName" then
+	if propertyName == "Parent" or propertyName == "ClassName" or propertyName == "Source" then
 		error("Property cannot be changed through setProperties: " .. propertyName)
 	end
 	local readOk, current = pcall(function()

package/plugin/default.project.json

@@ -1,6 +1,9 @@
 {
   "name": "Dominus",
   "tree": {
-    "$path": "src"
+    "$path": "src",
+    "$properties": {
+      "RunContext": "Plugin"
+    }
   }
 }

package/plugin/src/ValueCodec.lua

@@ -209,7 +209,7 @@ function ValueCodec.encode(value)
 end
 
 function ValueCodec.setProperty(instance, propertyName, value)
-	if propertyName == "Parent" or propertyName == "ClassName" then
+	if propertyName == "Parent" or propertyName == "ClassName" or propertyName == "Source" then
 		error("Property cannot be changed through setProperties: " .. propertyName)
 	end
 	local readOk, current = pcall(function()

package/plugin/src/init.server.lua

@@ -1,3 +1,7 @@
+if script.RunContext ~= Enum.RunContext.Plugin then
+	return
+end
+
 local HttpService = game:GetService("HttpService")
 
 local EmbeddedBridgeToken = require(script.BridgeConfig)
@@ -116,7 +120,7 @@ local function handleMessage(rawMessage)
 	end
 
 	if message.type == "server:auth_rejected" then
-		warn("[Dominus 2] Authentication failed. Run dominus-install-plugin and restart Studio.")
+		warn("[Dominus 2] Authentication failed. Run dominus-install-plugin to refresh the local plugin.")
 		WsClient.disconnect()
 		return
 	end