dominus-cli 2.1.0 → 2.2.0

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.
@@ -30,8 +30,8 @@ Official references:
 
 1. MCP host starts `dominus-mcp` over stdio.
 2. Dominus owns or securely relays to one loopback WebSocket bridge on port 18088.
-3. The Studio plugin authenticates with a persistent random bridge token. First
-   use requires a six-digit pairing code displayed inside Studio.
+3. The installer embeds a persistent random bridge token into that user's local
+   Studio plugin, allowing automatic authentication without a manual pairing flow.
 4. Every Studio window receives a unique connection ID. MCP callers select that
    ID, so two windows editing the same place cannot overwrite each other's target.
 5. Studio instances are returned as session-scoped instance references with path
@@ -40,16 +40,20 @@ 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
 
-- `dominus_status`, `dominus_pair_studio`, `dominus_select_studio`
+- `dominus_status`, `dominus_select_studio`
 - `studio_get_tree`, `studio_inspect`, `studio_get_selection`
 - `studio_read_script`, `studio_update_script`
 - `studio_apply`, `studio_delete_instances`
 - `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,12 +66,14 @@ 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.
 
 ## Verification
 
-- Transport tests cover authentication, pairing, wrong-target responses,
+- Transport tests cover authentication, credential rejection, wrong-target responses,
   disconnect isolation, duplicate place sessions, and payload rejection.
 - Protocol and MCP tests cover schema validation and structured result shapes.
 - Static plugin checks plus `rojo build` verify the packaged plugin model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominus-cli",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Dominus 2: a secure, MCP-native Roblox Studio engineering agent bridge.",
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "dev": "tsx src/mcp/index.ts",
     "dev:mcp": "tsx src/mcp/index.ts",
     "build": "tsup",
-    "build:plugin": "rojo build plugin/default.project.json -o plugin/Dominus.rbxm",
+    "build:plugin": "rojo build plugin/default.project.json -o plugin/Dominus.rbxmx",
     "start": "node dist/mcp.js",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -55,7 +55,9 @@
   },
   "files": [
     "dist",
-    "plugin",
+    "plugin/default.project.json",
+    "plugin/Dominus.rbxmx",
+    "plugin/src",
     "CHANGELOG.md",
     "docs/DOMINUS_2_PLAN.md"
   ],