@genclass/mcp 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genclass/mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "mcpName": "io.github.genclass-dev/genclass",
   "description": "GenClass for coding agents: an MCP server that sees what happens inside your app's pages (clicks, requests, the order responses arrived, state writes, errors), re-runs them with the network answering in different orders to find race conditions, and replays one exact order to prove a fix. Local only, no dependencies.",
   "type": "module",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genclass",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "See what happens inside your app's pages in causal order, find race conditions by replaying different response orders, reproduce a bug exactly and prove the fix with a generated Playwright test. Local only.",
   "author": {
     "name": "GenClass",

package/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@genclass/mcp@0.2.0"
+        "@genclass/mcp@0.2.1"
       ]
     }
   }

package/plugin/README.md

@@ -20,9 +20,9 @@ page of the dev server. The page side needs `@genclass/runtime` 0.3.0-beta.1 or
 
 | part | file | what it does |
 |---|---|---|
-| MCP server `genclass` | `.mcp.json` | runs `npx -y @genclass/mcp@0.2.0`: nine tools (`genclass_status`, `genclass_findings`, `genclass_explain`, `genclass_explore`, `genclass_replay`, `genclass_analytics`, `genclass_setup`, `genclass_scan`, `genclass_clear`) and a bridge on 127.0.0.1:47357 that your app's pages connect to |
-| `UserPromptSubmit` hook | `hooks/hooks.json` | runs `npx -y @genclass/mcp@0.2.0 hook` before each prompt: up to five findings recorded since the last prompt are added to the prompt as context |
-| skill `genclass` | `skills/genclass/SKILL.md` | tells Claude when to use the tools (an intermittent frontend bug; after changing code that fetches, submits, autosaves, polls or debounces) and how to confirm a fix |
+| MCP server `genclass` | `.mcp.json` | runs `npx -y @genclass/mcp@0.2.1`: nine tools (`genclass_status`, `genclass_findings`, `genclass_explain`, `genclass_explore`, `genclass_replay`, `genclass_analytics`, `genclass_setup`, `genclass_scan`, `genclass_clear`) and a bridge on 127.0.0.1:47357 that your app's pages connect to |
+| `UserPromptSubmit` hook | `hooks/hooks.json` | runs `npx -y @genclass/mcp@0.2.1 hook` before each prompt: up to five findings recorded since the last prompt are added to the prompt as context |
+| skill `genclass` | `skills/genclass/SKILL.md` | the procedure once Claude reaches for the tools (the explore arguments and Playwright pairing, how to read a report, what to say when done, what to do when the tools are missing); its description carries the triggers (an intermittent frontend bug; after changing code that fetches, submits, autosaves, polls or debounces; before calling a UI change done), as do the server's instructions. Without the plugin, `npx -y @genclass/mcp@0.2.1 init` writes the same file to `.claude/skills/genclass/SKILL.md` |
 
 The launcher is pinned to the plugin's version, so the plugin runs the exact release it was reviewed with.
 `plugin.json` and `mcp.json` at this folder's root are the same server in the
@@ -55,7 +55,7 @@ diagnostics, which `GenClass.init({ telemetry: false })` turns off ([PRIVACY.md]
 
 - Everything: `/plugin disable genclass@genclass` (or `/plugin uninstall genclass@genclass`).
 - Only the hook: Claude Code has no switch for one plugin hook; uninstall the plugin and add the server alone
-  (`claude mcp add genclass -- npx -y @genclass/mcp@0.2.0`), or set `"disableAllHooks": true` in your settings, which
+  (`claude mcp add genclass -- npx -y @genclass/mcp@0.2.1`), or set `"disableAllHooks": true` in your settings, which
   turns off every hook.
 - In the app: remove the `connectAgent(rt)` line; the page then never talks to the bridge.
 

package/plugin/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @genclass/mcp@0.2.0 hook",
+            "command": "npx -y @genclass/mcp@0.2.1 hook",
             "timeout": 30
           }
         ]

package/plugin/mcp.json

@@ -6,7 +6,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@genclass/mcp@0.2.0"
+        "@genclass/mcp@0.2.1"
       ]
     }
   }

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "genclass",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "See what happens inside your app's pages in causal order, find race conditions by replaying different response orders, reproduce a bug exactly and prove the fix with a generated Playwright test. Local only.",
   "author": {
     "name": "GenClass",

package/plugin/skills/genclass/SKILL.md

@@ -1,20 +1,22 @@
 ---
 name: genclass
-description: Find, reproduce and prove fixes for web-app bugs that depend on timing (race conditions, stale or flickering results, lost edits, double submits, errors that happen "sometimes", "only in production" or "on slow connections") with the GenClass MCP tools. Use when the user reports an intermittent frontend bug, and after you change code that fetches, submits, autosaves, polls, debounces, paginates or listens to a socket, before you call the change done.
+description: Find, reproduce and prove fixes for web-app bugs that depend on timing or layout with the GenClass MCP tools. Use when the user says something happens "sometimes", "randomly", "only in production" or "on slow connections", when a value "flips back", and for stale or old results, lost edits, double submits or a page that scrolls sideways on a phone; also after you change code that fetches, submits, autosaves, polls, debounces, paginates or listens to a socket, and before you call a page or UI change done.
 ---
 
 # GenClass: see the race, replay it, prove the fix
 
 GenClass records what happens inside the app's pages on this machine (each click, request, the order responses
 were delivered, what each response wrote into the state, uncaught errors with the click and request behind them),
-can run the page again with responses delivered in different orders, and can replay one exact order.
+can run the page again with responses delivered in different orders, and can replay one exact order. It needs
+Claude Code (or another MCP client) on the developer's machine, next to the app's dev server; the chat app cannot
+run it. The server's instructions say when to reach for it; this file is the procedure.
 
-## 0. Is it connected?
+## 0. Check the connection
 
 Call `genclass_status`. If no page is listed, call `genclass_setup` and add the two lines it shows to the app's
 browser entry (development builds only), then load a page of the dev server.
 
-## 1. A reported bug ("sometimes the results are wrong")
+## 1. From a finding to a proven fix
 
 1. `genclass_findings`, then `genclass_explain` on the most relevant finding. Read the causal chain (which click
    started which request, which response wrote over what).
@@ -26,25 +28,27 @@ browser entry (development builds only), then load a page of the dev server.
    not hide the symptom.
 4. Replay again: "not reproduced" (with the same steps) is the evidence. Add the regression test from
    `genclass_explain` to the repo's Playwright tests.
-5. Run `genclass_explore` once more to check other orders.
+5. Run explore once more (section 2) to check other orders.
 
 If nothing was recorded, reproduce it with explore (section 2), using the page and endpoint the user named
 (`route`, `focus: ["METHOD /path/:id"]`). For production-only reports, `genclass_analytics {source:"production"}`
 shows which pages and endpoints the GenClass dashboard flagged.
 
-## 2. After changing data-fetching or submit code
+## 2. Explore response orders
 
 1. `genclass_explore {action:"start", runs: 6, slow_ms: 600}` (add `route` to limit it to one page).
 2. Run the same scenario once per armed page load (2 baselines + 6), each a fresh load: with Playwright
    `--repeat-each 8 --workers 1`, or with a browser tool. After the steps, wait for
    `window.__GENCLASS_AGENT__.whenSettled()`.
-3. `genclass_explore {action:"report"}`. "No race found" for every scenario, with the reordered runs compared
-   ("Compared: 6 of 6"): done. "No verdict" or "0 compared": nothing was compared, so it is not a negative result; run
-   it again with `route` set and the same steps on every load. "RACE": `genclass_explain` the race finding and go to
-   section 1, step 3. "Internal state only" and "Along the way only" are not races: store values the page did not show
-   (a cache's own bookkeeping depends on arrival order by construction), and overwrites a later response repaired.
+3. `genclass_explore {action:"report"}` and read the verdict per scenario:
+   - "No race found" with the reordered runs compared ("Compared: 6 of 6"): done.
+   - "No verdict" or "0 compared": nothing was compared, so it is not a negative result; run it again with `route`
+     set and the same steps on every load.
+   - "RACE": `genclass_explain` the race finding and go to section 1, step 3.
+   - "Internal state only" and "Along the way only" are not races: store values the page did not show (a cache's
+     own bookkeeping depends on arrival order by construction), and overwrites a later response repaired.
 
-## 3. Before calling a page or UI change done
+## 3. Scan a page
 
 `genclass_scan {url}` (the dev server's page, e.g. `http://localhost:5173/pricing`) loads it headless at desktop and
 phone sizes and lists what the measured visual checks found: unreadable text, broken images, fonts and stylesheets,
@@ -62,3 +66,14 @@ Playwright's Chromium is missing, install it (`npx playwright install chromium`)
   model's detections are its opinion.
 - Report what you verified: say "reproduced", "not reproduced" or "no race in N orders", not "fixed", unless a replay
   or explore showed it.
+
+## Without the genclass_* tools
+
+The tools come from the GenClass MCP server, which runs on the developer's machine. When this session has none of
+them:
+
+- Add the server and restart the client. Claude Code: `claude mcp add genclass -- npx -y @genclass/mcp@0.2.1`
+  (other clients: `npx -y @genclass/mcp@0.2.1 config <client>` prints their lines).
+- For the visual checks alone, no server needed: `npx @genclass/runtime@beta scan <url> --json` in a terminal.
+- In a chat app with no terminal on that machine, say so and give the developer the install line; GenClass cannot
+  run there.

package/server.json

@@ -9,13 +9,13 @@
     "source": "github",
     "subfolder": "packages/mcp"
   },
-  "version": "0.2.0",
+  "version": "0.2.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@genclass/mcp",
-      "version": "0.2.0",
+      "version": "0.2.1",
       "transport": {
         "type": "stdio"
       }