@usercase/mcp 0.2.3 → 0.2.4-next.0

package/src/run/diag.js

@@ -1,67 +1,67 @@
-"use strict";
-/**
- * 진단 — 가상 사용자가 사이트에서 **하지 못한 것**을 모아 어닝버드 서버로 보낸다. 도구를 고치려고 받는다.
- *
- * 사이트마다 다른 이유로 막힌다(회전 배너를 밀 수 없어서, 화면 밖으로 잘려서, 덮개 때문에 …).
- * bluetags 하나로는 다 못 찾는다(10/15 — 스와이프가 없어서 배너 끝 카드를 못 눌렀다).
- *
- * 실패의 종류와 요소의 생김새(태그·역할·아이콘인지·회전 배너 안인지·고정 위치인지·대화상자 안인지·크기)에 더해
- * 그 순간의 페이지 경로·요소 주변 HTML·화면을 보낸다(10/22 — 종류만으로는 무한 배너 복사본 같은 원인을 못 찾았다).
- * 우리만 본다 — 고객 대시보드에는 안 보인다. 고객 방문 기록(/agent/visits)과 따로 간다.
- * 도구가 못 한 것뿐 아니라 잘못 본 것도 — 방문자의 다음 말과 도구 판단이 엇갈리면(visit.js checkLastJudgement)
- * 기본으로 켜져 있고 USERCASE_DIAGNOSTICS=off 로 끈다. API 키가 있을 때만 간다(키가 프로젝트를 정한다).
- */
-
-const OFF = /^(0|off|false|no)$/i;
-const enabled = () => !OFF.test(String(process.env.USERCASE_DIAGNOSTICS || "").trim());
-
-/** 방문자에게 간 말 → 실패 종류. 도구가 만든 말이라 사이트 글자는 섞이지 않는다 */
-function kindOf(skipped) {
-  const s = String(skipped || "");
-  if (/cut off at the edge|off the edge of the screen/.test(s)) return "cut_off";
-  if (/slid (away|out of sight) as you went to tap it/.test(s)) return "moving";
-  if (/survey card is on top/.test(s)) return "covered_by_card";
-  if (/on top of it/.test(s)) return "covered";
-  if (/greyed out/.test(s)) return "disabled";
-  if (/not visible on the screen/.test(s)) return "not_visible";
-  if (/no longer there/.test(s)) return "stale";
-  if (/get into that field/.test(s)) return "field_unreachable";
-  if (/nothing happened when you clicked/.test(s)) return "no_effect";
-  if (/not on the screen/.test(s)) return "bad_index";
-  return null; // 정책으로 막은 것(결제·로그아웃 등)은 도구 실패가 아니다
-}
-
-/** 요소의 생김새 — 글자 없이. 페이지 안에서 돈다 */
-async function shapeOf(el) {
-  if (!el) return null;
-  return el
-    .evaluate((n) => {
-      const r = n.getBoundingClientRect();
-      let carousel = false;
-      let fixed = false;
-      let dialog = false;
-      for (let p = n, d = 0; p && p !== document.body && d < 25; p = p.parentElement, d++) {
-        const cs = getComputedStyle(p);
-        if (cs.overflowX !== "visible" && p.scrollWidth > p.clientWidth + 2) carousel = true;
-        if (cs.position === "fixed" || cs.position === "sticky") fixed = true;
-        if (p.matches('[role="dialog"],[role="alertdialog"],dialog,[aria-modal="true"]')) dialog = true;
-      }
-      let react = false;
-      for (const k in n) if (k.startsWith("__reactProps") && n[k] && typeof n[k].onClick === "function") react = true;
-      return {
-        tag: n.tagName.toLowerCase(),
-        role: n.getAttribute("role") || undefined,
-        icon: !(n.innerText || "").trim(),
-        svg: n.tagName.toLowerCase() === "svg" || !!n.querySelector("svg"),
-        carousel,
-        fixed,
-        dialog,
-        react,
-        w: Math.round(r.width),
-        h: Math.round(r.height),
-      };
-    })
-    .catch(() => null);
-}
-
-module.exports = { enabled, kindOf, shapeOf };
+"use strict";
+/**
+ * 진단 — 가상 사용자가 사이트에서 **하지 못한 것**을 모아 어닝버드 서버로 보낸다. 도구를 고치려고 받는다.
+ *
+ * 사이트마다 다른 이유로 막힌다(회전 배너를 밀 수 없어서, 화면 밖으로 잘려서, 덮개 때문에 …).
+ * bluetags 하나로는 다 못 찾는다(10/15 — 스와이프가 없어서 배너 끝 카드를 못 눌렀다).
+ *
+ * 실패의 종류와 요소의 생김새(태그·역할·아이콘인지·회전 배너 안인지·고정 위치인지·대화상자 안인지·크기)에 더해
+ * 그 순간의 페이지 경로·요소 주변 HTML·화면을 보낸다(10/22 — 종류만으로는 무한 배너 복사본 같은 원인을 못 찾았다).
+ * 우리만 본다 — 고객 대시보드에는 안 보인다. 고객 방문 기록(/agent/visits)과 따로 간다.
+ * 도구가 못 한 것뿐 아니라 잘못 본 것도 — 방문자의 다음 말과 도구 판단이 엇갈리면(visit.js checkLastJudgement)
+ * 기본으로 켜져 있고 USERCASE_DIAGNOSTICS=off 로 끈다. API 키가 있을 때만 간다(키가 프로젝트를 정한다).
+ */
+
+const OFF = /^(0|off|false|no)$/i;
+const enabled = () => !OFF.test(String(process.env.USERCASE_DIAGNOSTICS || "").trim());
+
+/** 방문자에게 간 말 → 실패 종류. 도구가 만든 말이라 사이트 글자는 섞이지 않는다 */
+function kindOf(skipped) {
+  const s = String(skipped || "");
+  if (/cut off at the edge|off the edge of the screen/.test(s)) return "cut_off";
+  if (/slid (away|out of sight) as you went to tap it/.test(s)) return "moving";
+  if (/survey card is on top/.test(s)) return "covered_by_card";
+  if (/on top of it/.test(s)) return "covered";
+  if (/greyed out/.test(s)) return "disabled";
+  if (/not visible on the screen/.test(s)) return "not_visible";
+  if (/no longer there/.test(s)) return "stale";
+  if (/get into that field/.test(s)) return "field_unreachable";
+  if (/nothing happened when you clicked/.test(s)) return "no_effect";
+  if (/not on the screen/.test(s)) return "bad_index";
+  return null; // 정책으로 막은 것(결제·로그아웃 등)은 도구 실패가 아니다
+}
+
+/** 요소의 생김새 — 글자 없이. 페이지 안에서 돈다 */
+async function shapeOf(el) {
+  if (!el) return null;
+  return el
+    .evaluate((n) => {
+      const r = n.getBoundingClientRect();
+      let carousel = false;
+      let fixed = false;
+      let dialog = false;
+      for (let p = n, d = 0; p && p !== document.body && d < 25; p = p.parentElement, d++) {
+        const cs = getComputedStyle(p);
+        if (cs.overflowX !== "visible" && p.scrollWidth > p.clientWidth + 2) carousel = true;
+        if (cs.position === "fixed" || cs.position === "sticky") fixed = true;
+        if (p.matches('[role="dialog"],[role="alertdialog"],dialog,[aria-modal="true"]')) dialog = true;
+      }
+      let react = false;
+      for (const k in n) if (k.startsWith("__reactProps") && n[k] && typeof n[k].onClick === "function") react = true;
+      return {
+        tag: n.tagName.toLowerCase(),
+        role: n.getAttribute("role") || undefined,
+        icon: !(n.innerText || "").trim(),
+        svg: n.tagName.toLowerCase() === "svg" || !!n.querySelector("svg"),
+        carousel,
+        fixed,
+        dialog,
+        react,
+        w: Math.round(r.width),
+        h: Math.round(r.height),
+      };
+    })
+    .catch(() => null);
+}
+
+module.exports = { enabled, kindOf, shapeOf };