@usercase/mcp 0.2.8-next.5 → 0.2.8

package/agents/new-research.md

@@ -70,7 +70,7 @@ One research is **one flow a participant can walk in one sitting**: 1–4 tasks,
 The results tell who went straight from who took a detour only when a task has an expected path: the route the site was built for. Work it out now, from the code, for every task with a page or click to reach (tasks done by staying on a page have none):
 - **where it starts**: the first task starts on the invite page; every later task starts where the previous one ended;
 - **the clicks a participant must make**, in order — the main route the UI offers, not a shortcut only you know;
-- **where it ends**: the page or the click that counts as done. It must agree with the task's success condition.
+- **where it ends**: the page or the click that counts as done. It must agree with the task's success condition. When participants could reach any item of a kind (a project, a post, a product), the task's page is the route's pattern with `:name` for that part — never the item you happened to open — and while recording, `path_pattern` turns that page into the same pattern.
 - what the route needs: a signed-in demo account, or a write the safety guard does not send (the last click is then recorded without pressing it).
 
 ## 7. Show the user everything at once

package/mcp/server.js

@@ -23,7 +23,7 @@ const ws = require("./workspace.js");
 const persona = require("../src/persona/persona.js");
 const report = require("./report.js");
 const peopleRules = require("../src/persona/people.js");
-const { PathRecorder } = require("./path.js");
+const { PathRecorder, patternOf } = require("./path.js");
 
 const hub = new Hub();
 const server = new McpServer({ name: "usercase", version: require("../package.json").version });
@@ -715,7 +715,27 @@ server.registerTool(
   wrap(async (args) => {
     // 참여자는 초대를 수락한 페이지에서 첫 과제를 시작한다(SDK 는 다른 데로 데려가지 않는다).
     // 첫 과제 경로가 다른 페이지에서 시작하면 첫 단계를 아무도 못 지난다 — 저장 전에 막는다. :이름 은 이름과 상관없이 같은 칸
+    // 녹화는 걸은 주소 그대로(/project/zksync)다. 과제에 적은 패턴(/project/:slug)에 맞는 주소는 그 패턴으로 —
+    // 안 그러면 그 항목을 고른 사람만 성공·바로 감으로 잡힌다(10/29 bluetags). 에이전트가 path_pattern 을 빠뜨려도 여기서 맞춘다
+    const toPattern = (body, pat) => {
+      if (!pat || !pat.includes(":")) return false;
+      const re = patternOf(pat);
+      const fit = (u) => u && u !== pat && !u.includes(":") && re.test(u);
+      let hit = false;
+      for (const s of body.steps) if (fit(s.url)) (s.url = pat), (hit = true);
+      const sc = body.success;
+      if (sc && fit(sc.targetUrl)) (sc.targetUrl = pat), (hit = true);
+      if (sc && fit(sc.xpathUrl)) (sc.xpathUrl = pat), (hit = true);
+      return hit;
+    };
+    const patternNotes = [];
+    for (const [n, p] of recorder.planned) {
+      const t = (args.tasks || [])[n - 1];
+      const pat = t && (t.success_condition === "element_click" ? t.xpath_url : t.target_url);
+      if (t && toPattern(p.body, pat)) patternNotes.push(`- task ${n}: recorded pages matching ${pat} now use that pattern`);
+    }
     const first = recorder.planned.get(1);
+    if (args.invite && first && toPattern(first.body, args.invite.page)) patternNotes.push(`- task 1: its start page now uses the invite's pattern ${args.invite.page}`);
     if (args.invite && first) {
       const kind = (p) => String(p || "").trim().replace(/:[A-Za-z_]\w*/g, ":x").replace(/\/+$/, "") || "/";
       const start = first.body.steps[0].url;
@@ -749,6 +769,7 @@ server.registerTool(
         `Saved as a draft${r.findings ? `, linked to ${r.findings} finding${r.findings > 1 ? "s" : ""}` : ""}.`,
         `Open it in the Inbox to review and create it: ${report.dashboardUrl(r.inboxPath)}`,
         ...(lines.length ? ["", "Expected paths saved with it:", ...lines] : []),
+        ...(patternNotes.length ? ["", "Item pages were recorded with the item you opened; they now match any item of that kind:", ...patternNotes] : []),
         ...(missing.length
           ? ["", "Tasks without an expected path:", ...missing.map((t) => `- ${t.title} (record later with path_start draft:${r.draftId}:${t.index})`)]
           : []),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usercase/mcp",
-  "version": "0.2.8-next.5",
+  "version": "0.2.8",
   "description": "Virtual users that browse your website and tell you what they thought — an MCP server for Claude Code",
   "license": "UNLICENSED",
   "homepage": "https://usercase.io",