@rolepod/uiproof 0.4.0 → 0.4.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rolepod-uiproof",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Multi-platform UI/mobile automation for AI agents — 4 shipped skills (verify-ui, audit-a11y, visual-diff, scaffold-e2e) + MCP server with 15 tools. v0.3 adds AppiumEngine scaffolding for iOS/Android, scope={ref} audit, replay CLI, ddmin minimization, doctor + install:mobile.",
   "author": {
     "name": "nuttaruj",
@@ -19,7 +19,7 @@
   "mcpServers": {
     "rolepod-uiproof": {
       "command": "npx",
-      "args": ["-y", "@rolepod/uiproof"],
+      "args": ["-y", "rolepod-uiproof"],
       "env": {}
     }
   }

package/.codex-plugin/plugin.json

@@ -21,13 +21,7 @@
     "visual-regression"
   ],
   "skills": "./skills/",
-  "mcp_servers": {
-    "rolepod-uiproof": {
-      "command": "npx",
-      "args": ["-y", "@rolepod/uiproof"],
-      "env": {}
-    }
-  },
+  "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "Rolepod UIProof",
     "shortDescription": "UI verification, a11y audits, visual diff, e2e scaffolding — for AI coding agents.",

package/.cursor/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "rolepod-uiproof": {
       "command": "npx",
-      "args": ["-y", "@rolepod/uiproof"],
+      "args": ["-y", "rolepod-uiproof"],
       "env": {}
     }
   }

package/CHANGELOG.md

@@ -7,6 +7,28 @@ release.
 
 ## [Unreleased]
 
+## [0.4.1] — 2026-05-27
+
+### Fixed
+
+- **MCP server failed to start via `npx -y @rolepod/uiproof`** — npx
+  resolves a scoped package's default executable by the *short* name
+  (`uiproof`, after the `/`), but our `bin` field only defined
+  `rolepod-uiproof`. The mismatch caused `sh: rolepod-uiproof: command
+  not found` and an MCP `-32000` reconnect error in Claude Code,
+  Cursor, etc. All `mcpServers` entries (`.mcp.json`, `.cursor/mcp.json`,
+  `.claude-plugin/plugin.json`, `plugins/rolepod-uiproof/.mcp.json`)
+  now invoke `npx -y rolepod-uiproof`, which npx resolves directly by
+  bin name from the registry.
+
+### Added
+
+- Tool `title` and `annotations` (`readOnlyHint` / `destructiveHint` /
+  `idempotentHint` / `openWorldHint`) on all 15 tools, per the MCP
+  2025-11-25 spec. Clients use these hints to render friendlier names
+  in the picker and to auto-approve read-only calls vs. prompting
+  harder on destructive ones.
+
 ## [0.4.0] — 2026-05-24
 
 **Breaking: project renamed `rolepod-mcp` → `rolepod-uiproof`.**

package/README.md

@@ -92,7 +92,7 @@ Use this when your tool reads a standard `mcpServers` config (most non-CLI MCP c
   "mcpServers": {
     "rolepod-uiproof": {
       "command": "npx",
-      "args": ["-y", "@rolepod/uiproof"]
+      "args": ["-y", "rolepod-uiproof"]
     }
   }
 }

package/dist/bin/rolepod-uiproof.js

@@ -2398,9 +2398,158 @@ var visualDiffTool = {
   }
 };
 
+// src/tools/metadata.ts
+var toolMetadata = {
+  // ---------- atomic ----------
+  [ToolNames.browserOpen]: {
+    title: "Open Browser/Mobile Session",
+    annotations: {
+      title: "Open Browser/Mobile Session",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserClose]: {
+    title: "Close Session",
+    annotations: {
+      title: "Close Session",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  [ToolNames.browserSnapshot]: {
+    title: "Capture Accessibility Snapshot",
+    annotations: {
+      title: "Capture Accessibility Snapshot",
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserClick]: {
+    title: "Click Element",
+    annotations: {
+      title: "Click Element",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserType]: {
+    title: "Type Text",
+    annotations: {
+      title: "Type Text",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserKey]: {
+    title: "Press Key",
+    annotations: {
+      title: "Press Key",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserScroll]: {
+    title: "Scroll Viewport",
+    annotations: {
+      title: "Scroll Viewport",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserWaitFor]: {
+    title: "Wait For Condition",
+    annotations: {
+      title: "Wait For Condition",
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserScreenshot]: {
+    title: "Take Screenshot",
+    annotations: {
+      title: "Take Screenshot",
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.browserNavigate]: {
+    title: "Navigate URL",
+    annotations: {
+      title: "Navigate URL",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  // ---------- composite ----------
+  [ToolNames.verifyUiFlow]: {
+    title: "Verify UI Flow",
+    annotations: {
+      title: "Verify UI Flow",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.auditA11y]: {
+    title: "Audit Accessibility (axe-core)",
+    annotations: {
+      title: "Audit Accessibility (axe-core)",
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.visualDiff]: {
+    title: "Visual Diff vs Baseline",
+    annotations: {
+      title: "Visual Diff vs Baseline",
+      // Writes to ./.rolepod-uiproof/{baselines,artifacts}/ but only adds files —
+      // never destroys an existing baseline silently.
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  [ToolNames.scaffoldE2e]: {
+    title: "Scaffold E2E Test File",
+    annotations: {
+      title: "Scaffold E2E Test File",
+      // Writes a test file to the local repo.
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: false
+    }
+  },
+  [ToolNames.extractUiState]: {
+    title: "Extract UI State (NL Query)",
+    annotations: {
+      title: "Extract UI State (NL Query)",
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }
+};
+
 // src/server.ts
 var SERVER_NAME = "rolepod-uiproof";
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.4.1";
 function buildServer(opts = {}) {
   const webEngine = createWebEngine();
   const registry = new SessionRegistry({ idleTimeoutMs: opts.idleTimeoutMs });
@@ -2436,9 +2585,15 @@ function buildServer(opts = {}) {
     extractUiStateTool
   ];
   for (const t of tools) {
+    const meta = toolMetadata[t.name];
     mcp.registerTool(
       t.name,
-      { description: t.description, inputSchema: t.inputShape },
+      {
+        title: meta?.title,
+        description: t.description,
+        inputSchema: t.inputShape,
+        annotations: meta?.annotations
+      },
       t.build(ctx)
     );
   }