@ahnseungchan/device-farm 0.0.0-stage → 0.1.0

package/dist/chunk-AXQNUPGC.js

@@ -0,0 +1,416 @@
+import {
+  homeAttempts,
+  markStaleScript,
+  samePath,
+  staleMarkKey
+} from "./chunk-NLX3V7ZJ.js";
+
+// packages/devices/src/exec.ts
+import { execFile } from "child_process";
+var execFileText = (command, args) => new Promise((resolve, reject) => {
+  execFile(command, [...args], { maxBuffer: 64 * 1024 * 1024 }, (error, stdout, stderr) => {
+    if (!error) {
+      resolve(stdout);
+      return;
+    }
+    const firstLine = String(stderr).split("\n").find((line) => line.trim()) ?? error.message;
+    reject(new Error(firstLine));
+  });
+});
+
+// packages/devices/src/android-driver.ts
+import { execFile as execFile2 } from "child_process";
+import { promisify } from "util";
+import { setTimeout as wait2 } from "timers/promises";
+import { chromium } from "playwright";
+
+// packages/core/src/device/deep-link.ts
+function deepLinkUrl(path, deepLink) {
+  if (!deepLink.scheme) throw new Error("\uC571 \uC124\uC815\uC5D0 deepLink.scheme\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. farm.config.ts\uC5D0 \uB525\uB9C1\uD06C \uC2A4\uD0B4\uC744 \uB123\uC5B4 \uC8FC\uC138\uC694.");
+  const trimmed = path.replace(/^\/+/, "");
+  if (trimmed === "" || trimmed.startsWith("?")) return `${deepLink.scheme}://${deepLink.homeHost}${trimmed}`;
+  return `${deepLink.scheme}://${trimmed}`;
+}
+
+// packages/devices/src/ios-driver.ts
+import { setTimeout as wait } from "timers/promises";
+var nativeContext = "NATIVE_APP";
+var webViewPrefix = "WEBVIEW";
+var textPollMs = 250;
+var contextWaitMs = 1e4;
+var stackSettleMs = 600;
+var hasTextScript = "var squash = function (v) { return String(v).replace(/\\s+/g, ' ').trim(); }; return squash(document.body && document.body.innerText || '').includes(squash(arguments[0]));";
+var clickTargetHelpers = `const nameOf = (el) => {
+  const label = el.getAttribute("aria-label");
+  if (label) return label.trim();
+  const ids = (el.getAttribute("aria-labelledby") || "").split(/\\s+/).filter(Boolean);
+  if (ids.length) return ids.map((id) => (document.getElementById(id) || {}).textContent || "").join(" ").trim();
+  return (el.innerText || el.textContent || "").trim();
+};
+const selectors = { button: 'button, [role="button"], input[type="button"], input[type="submit"]', link: 'a[href], [role="link"]' };`;
+var clickButtonScript = `
+// \uC904\uBC14\uAFC8\xB7\uC5F0\uC18D \uACF5\uBC31\uC740 \uD55C \uCE78\uC73C\uB85C \uBCF8\uB2E4(\u300C1\uC77C\uCC28\u21B5\uC624\uB298\u300D). \uBC84\uD2BC \uBAA9\uB85D(explore listActionsScript)\uACFC \uAC19\uC740 \uADDC\uCE59.
+const squash = (value) => String(value || "").replace(/\\s+/g, " ").trim();
+const name = squash(arguments[0]);
+const role = arguments[1] || "button";
+const prefix = arguments[2] === "prefix";
+const matches = (value) => (prefix ? value.startsWith(name) : value === name);
+${clickTargetHelpers}
+const candidates = document.querySelectorAll(selectors[role]);
+// \uAC19\uC740 \uC774\uB984\uC758 \uC228\uC740 \uBC84\uD2BC(\uC811\uD78C \uD0ED\xB7\uCE90\uB7EC\uC140 \uBCF5\uC81C\uBCF8)\uC744 \uB204\uB974\uC9C0 \uC54A\uAC8C \uD654\uBA74\uC5D0 \uADF8\uB824\uC9C4 \uAC83\uB9CC \uBCF8\uB2E4.
+const visible = (el) => el.getClientRects().length > 0 && getComputedStyle(el).visibility !== "hidden";
+// \uAC19\uC740 \uC774\uB984\uC774 \uC5EC\uB7FF\uC774\uBA74 \uB9C8\uC9C0\uB9C9(\uAC00\uC7A5 \uC704\uC5D0 \uB72C \uD31D\uC5C5\xB7\uC2DC\uD2B8\uB294 body \uB05D\uC5D0 \uBD99\uB294\uB2E4). \uC608: \uD480\uD31D\uC5C5 \u300C\uCDA9\uC804 \uCDE8\uC18C\uD558\uAE30\u300D CTA\uC640 \uD655\uC778 \uD31D\uC5C5 \uBC84\uD2BC.
+const target = Array.from(candidates).filter((el) => visible(el) && matches(squash(el.tagName === "INPUT" ? el.value : nameOf(el)))).at(-1);
+if (!target) return false;
+target.click();
+return true;
+`;
+function contextName(context) {
+  if (typeof context === "string") return context;
+  if (typeof context === "object" && context !== null && "id" in context && typeof context.id === "string") return context.id;
+  return null;
+}
+async function findWebView(session, except = []) {
+  const deadline = Date.now() + contextWaitMs;
+  let latest;
+  while (Date.now() < deadline) {
+    const webViews = (await session.getContexts()).map(contextName).filter((name) => Boolean(name?.startsWith(webViewPrefix)));
+    latest = webViews.at(-1);
+    const fresh = webViews.filter((name) => !except.includes(name)).at(-1);
+    if (fresh) return fresh;
+    if (latest && except.length === 0) return latest;
+    await wait(textPollMs);
+  }
+  if (latest) return latest;
+  throw new Error("iOS \uC571\uC5D0\uC11C WebView \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
+}
+async function webViewNames(session) {
+  return (await session.getContexts()).map(contextName).filter((name) => Boolean(name?.startsWith(webViewPrefix)));
+}
+function openIosDriver(session, appId, app) {
+  const { homeTabName, inPageBackNames } = app;
+  const resetStack = async () => {
+    if (app.webview.stackResetScript) await session.execute(`${app.webview.stackResetScript}; return true;`).catch(() => void 0);
+  };
+  const isTabRoot = (path) => path === "/" || Object.values(app.tabPaths).includes(path);
+  const inWebView = async () => {
+    await session.switchContext(await findWebView(session));
+  };
+  const leaveInPageScreen = async () => {
+    await inWebView().catch(() => void 0);
+    for (const name of inPageBackNames) {
+      if (await session.execute(clickButtonScript, name, "button").catch(() => false) === true) break;
+    }
+    await wait(stackSettleMs);
+  };
+  const hasText = async (text) => {
+    await inWebView();
+    return Boolean(await session.execute(hasTextScript, text));
+  };
+  return {
+    app,
+    navigate: async (path) => {
+      await inWebView();
+      await resetStack();
+      await wait(stackSettleMs);
+      await session.execute(`${markStaleScript}; return true;`).catch(() => void 0);
+      const before = await webViewNames(session);
+      await session.execute("mobile: deepLink", { url: deepLinkUrl(path, app.deepLink), bundleId: appId });
+      await session.switchContext(await findWebView(session, isTabRoot(path) ? [] : before));
+    },
+    clickButton: async (name, role = "button", match = "exact") => {
+      await inWebView();
+      const clicked = await session.execute(clickButtonScript, name, role, match);
+      if (clicked !== true) throw new Error(`"${name}" ${role === "link" ? "\uB9C1\uD06C\uB97C" : "\uBC84\uD2BC\uC744"} \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.`);
+    },
+    goHome: async () => {
+      let lastError;
+      for (let attempt = 0; attempt < homeAttempts; attempt += 1) {
+        try {
+          for (const name of await webViewNames(session)) {
+            await session.switchContext(name);
+            await resetStack();
+          }
+          await wait(stackSettleMs);
+          await session.switchContext(await findWebView(session));
+          const clicked = await session.execute(clickButtonScript, homeTabName, "link");
+          if (clicked !== true) throw new Error(`\uD558\uB2E8 \u300C${homeTabName}\u300D \uD0ED\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.`);
+          return;
+        } catch (error) {
+          lastError = error;
+          await leaveInPageScreen();
+        }
+      }
+      throw lastError;
+    },
+    expectText: async (text, timeoutMs) => {
+      const deadline = Date.now() + timeoutMs;
+      while (!await hasText(text)) {
+        if (Date.now() >= deadline) throw new Error(`"${text}" \uBB38\uAD6C\uAC00 ${timeoutMs}ms \uC548\uC5D0 \uB098\uC624\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
+        await wait(textPollMs);
+      }
+    },
+    currentPath: async () => {
+      await inWebView();
+      return new URL(await session.getUrl()).pathname;
+    },
+    hasText,
+    screenshot: async () => {
+      await session.switchContext(nativeContext);
+      return Buffer.from(await session.takeScreenshot(), "base64");
+    },
+    evaluate: async (script) => {
+      await inWebView();
+      return await session.execute(`return (${script});`);
+    },
+    close: async () => {
+      await session.switchContext(nativeContext);
+    }
+  };
+}
+
+// packages/devices/src/android-driver.ts
+var devtoolsWaitMs = 3e4;
+var pageWaitMs = 1e4;
+var pollMs = 250;
+var clickMarkAttribute = "data-device-farm-click";
+var markButtonScript = clickButtonScript.replace(
+  "target.click();",
+  `document.querySelectorAll("[${clickMarkAttribute}]").forEach((el) => el.removeAttribute("${clickMarkAttribute}")); target.setAttribute("${clickMarkAttribute}", "");`
+);
+if (markButtonScript === clickButtonScript) throw new Error("clickButtonScript\uC5D0 target.click()\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+var clickWaitMs = 1e4;
+var stackSettleMs2 = 600;
+var execFileBuffer = promisify(execFile2);
+var webViewBoundsPattern = /class="android\.webkit\.WebView"[^>]*bounds="\[(\d+),(\d+)\]/;
+async function hideKeyboard(exec, serial) {
+  const state = await exec("adb", ["-s", serial, "shell", "dumpsys", "input_method"]).catch(() => "");
+  if (!state.includes("mInputShown=true")) return;
+  await exec("adb", ["-s", serial, "shell", "input", "keyevent", "KEYCODE_BACK"]);
+  await wait2(stackSettleMs2);
+}
+var nativeBackAttempts = 3;
+function isAppNativeScreen(windowDump, appId, mainActivity) {
+  const focus = /mCurrentFocus=Window\{[^}]* ([\w.]+)\/([\w.$]+)\}/.exec(windowDump);
+  return focus !== null && focus[1] === appId && focus[2] !== mainActivity;
+}
+async function leaveNativeScreens(exec, serial, appId, mainActivity) {
+  if (!mainActivity) return;
+  for (let attempt = 0; attempt < nativeBackAttempts; attempt += 1) {
+    const dump = await exec("adb", ["-s", serial, "shell", "dumpsys", "window"]).catch(() => "");
+    if (!isAppNativeScreen(dump, appId, mainActivity)) return;
+    await exec("adb", ["-s", serial, "shell", "input", "keyevent", "KEYCODE_BACK"]);
+    await wait2(stackSettleMs2);
+  }
+}
+var adValidatorDismissPattern = /text="Dismiss"[^>]*bounds="\[(\d+),(\d+)\]\[(\d+),(\d+)\]"/;
+var adValidatorTopRatio = 0.6;
+var linkTapHeightRatio = 0.75;
+var linkArriveWaitMs = 5e3;
+var linkTapAttempts = 2;
+var sheetCloseAttempts = 3;
+async function dumpScreen(exec, serial, allWindows) {
+  const dumpPath = "/sdcard/device-farm-ui.xml";
+  await exec("adb", ["-s", serial, "shell", "uiautomator", "dump", ...allWindows ? ["--windows"] : [], dumpPath]);
+  return exec("adb", ["-s", serial, "shell", "cat", dumpPath]);
+}
+function webViewOrigin(screen) {
+  const match = webViewBoundsPattern.exec(screen);
+  if (!match) throw new Error("\uD654\uBA74\uC5D0\uC11C WebView \uC704\uCE58\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(uiautomator).");
+  return { x: Number(match[1]), y: Number(match[2]) };
+}
+async function dismissAdValidator(exec, serial, screen) {
+  const match = adValidatorDismissPattern.exec(screen);
+  if (!match) return;
+  const [left, top, right, bottom] = match.slice(1).map(Number);
+  await exec("adb", ["-s", serial, "shell", "input", "tap", String(Math.round((left + right) / 2)), String(Math.round((top + bottom) / 2))]);
+  await wait2(stackSettleMs2);
+}
+async function devtoolsSocket(exec, serial, appId) {
+  const deadline = Date.now() + devtoolsWaitMs;
+  while (Date.now() < deadline) {
+    const pid = (await exec("adb", ["-s", serial, "shell", "pidof", appId]).catch(() => "")).trim().split(/\s+/)[0];
+    const name = `webview_devtools_remote_${pid}`;
+    if (pid && (await exec("adb", ["-s", serial, "shell", "cat", "/proc/net/unix"])).includes(`@${name}`)) return name;
+    await wait2(pollMs);
+  }
+  throw new Error(`${appId} WebView \uB514\uBC84\uAE45 \uC18C\uCF13\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. WebView \uB514\uBC84\uAE45\uC744 \uCF20 \uBE4C\uB4DC\uC778\uC9C0 \uD655\uC778\uD558\uC138\uC694.`);
+}
+async function connect(exec, serial, appId) {
+  const socket = await devtoolsSocket(exec, serial, appId);
+  const port = (await exec("adb", ["-s", serial, "forward", "tcp:0", `localabstract:${socket}`])).trim();
+  return chromium.connectOverCDP(`http://127.0.0.1:${port}`);
+}
+function appPages(context, origin) {
+  return context.pages().filter((page) => !page.isClosed() && page.url().startsWith(origin));
+}
+var pathOf = (page) => new URL(page.url()).pathname;
+function createPageTracker(context, origin) {
+  let pinned = null;
+  let known = new Set(context.pages());
+  const pin = (page) => {
+    pinned = page;
+    known = new Set(context.pages());
+    return page;
+  };
+  const current = () => {
+    const pages = appPages(context, origin);
+    const fresh = pages.filter((page) => !known.has(page)).at(-1);
+    if (fresh) return pin(fresh);
+    if (pinned && !pinned.isClosed()) return pinned;
+    const last = pages.at(-1);
+    if (last) return pin(last);
+    throw new Error("Android \uC571\uC5D0\uC11C \uC6F9 \uD654\uBA74\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB85C\uADF8\uC544\uC6C3\uB3FC \uB124\uC774\uD2F0\uBE0C \uB85C\uADF8\uC778 \uD654\uBA74\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
+  };
+  const arrive = async (path, waitMs = pageWaitMs) => {
+    const deadline = Date.now() + waitMs;
+    while (Date.now() < deadline) {
+      const pages = appPages(context, origin);
+      const fresh = pages.filter((page) => !known.has(page)).at(-1);
+      if (fresh) return pin(fresh);
+      const tab = pages.find((page) => samePath(path, pathOf(page)));
+      if (tab) {
+        await tab.evaluate(`delete window.${staleMarkKey}`).catch(() => void 0);
+        return pin(tab);
+      }
+      await wait2(pollMs);
+    }
+    return current();
+  };
+  const forget = () => {
+    known = new Set(context.pages());
+  };
+  return { current, arrive, forget };
+}
+async function openAndroidDriver(serial, appId, webOrigin, app, exec = execFileText) {
+  const { homeTabName, inPageBackNames } = app;
+  const { stackResetScript, sheetCloseName } = app.webview;
+  const browser = await connect(exec, serial, appId);
+  const context = browser.contexts()[0];
+  if (!context) {
+    await browser.close();
+    throw new Error("Android WebView \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  }
+  const origin = new URL(webOrigin).origin;
+  const deadline = Date.now() + pageWaitMs;
+  while (appPages(context, origin).length === 0 && Date.now() < deadline) await wait2(pollMs);
+  const pages = createPageTracker(context, origin);
+  const squash = (value) => value.replace(/\s+/g, " ").trim();
+  const hasText = async (text) => squash(await pages.current().locator("body").innerText()).includes(squash(text));
+  let webViewTopLeft = null;
+  const locate = async (page, name, role, match = "exact") => {
+    const script = `(function () {
+      if (!(function () { ${markButtonScript} }).apply(null, [${JSON.stringify(name)}, ${JSON.stringify(role)}, ${JSON.stringify(match)}])) return null;
+      const el = document.querySelector("[${clickMarkAttribute}]");
+      // \uAC00\uC6B4\uB370\uB85C \uC62C\uB9B0\uB2E4. \uD654\uBA74 \uC544\uB798 \uB05D\uC5D0 \uB450\uBA74 \uB5A0 \uC788\uB294 \uD558\uC704 \uBA54\uB274 \uBC11\uC5D0 \uAE54\uB824 \uD0ED\uC774 \uADF8\uCABD\uC5D0 \uAC04\uB2E4.
+      el.scrollIntoView({ block: "center", inline: "nearest" });
+      const rect = el.getBoundingClientRect();
+      return { x: rect.x + rect.width / 2, y: rect.y + rect.height * ${role === "link" ? linkTapHeightRatio : 0.5}, ratio: window.devicePixelRatio, viewHeight: window.innerHeight, href: el.getAttribute("href") };
+    })()`;
+    return page.evaluate(script).catch(() => null);
+  };
+  const tapAt = async (point, forcePopupCheck) => {
+    const inPopupArea = point.y > point.viewHeight * adValidatorTopRatio;
+    webViewTopLeft ??= webViewOrigin(await dumpScreen(exec, serial, false));
+    if (inPopupArea || forcePopupCheck) {
+      const screen = await dumpScreen(exec, serial, true).catch(() => "");
+      await dismissAdValidator(exec, serial, screen);
+    }
+    const x = Math.round(webViewTopLeft.x + point.x * point.ratio);
+    const y = Math.round(webViewTopLeft.y + point.y * point.ratio);
+    await exec("adb", ["-s", serial, "shell", "input", "tap", String(x), String(y)]);
+  };
+  const followLink = async (point, name, path) => {
+    for (let attempt = 0; attempt < linkTapAttempts; attempt += 1) {
+      if (attempt > 0) await tapAt(point, true);
+      if (samePath(path, pathOf(await pages.arrive(path, linkArriveWaitMs)))) return;
+    }
+    throw new Error(`\u300C${name}\u300D \uB9C1\uD06C\uB97C \uB20C\uB800\uC9C0\uB9CC ${path}\uB85C \uAC00\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
+  };
+  const closeSheets = async () => {
+    for (let attempt = 0; attempt < sheetCloseAttempts; attempt += 1) {
+      const point = await locate(pages.current(), sheetCloseName, "button");
+      if (!point) return;
+      await tapAt(point, false);
+      await wait2(stackSettleMs2);
+    }
+  };
+  const leaveInPageScreen = async () => {
+    for (const name of inPageBackNames) {
+      const point = await locate(pages.current(), name, "button");
+      if (!point) continue;
+      await tapAt(point, false);
+      await wait2(stackSettleMs2);
+      return;
+    }
+  };
+  const clickButton = async (name, role = "button", match = "exact") => {
+    const deadline2 = Date.now() + clickWaitMs;
+    for (; ; ) {
+      const page = pages.current();
+      const point = await locate(page, name, role, match);
+      if (point) {
+        await tapAt(point, false);
+        if (point.href) await followLink(point, name, new URL(point.href, page.url()).pathname);
+        return;
+      }
+      if (Date.now() >= deadline2) throw new Error(`"${name}" ${role === "link" ? "\uB9C1\uD06C\uB97C" : "\uBC84\uD2BC\uC744"} \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.`);
+      await wait2(pollMs);
+    }
+  };
+  const resetStack = (page) => stackResetScript ? page.evaluate(stackResetScript).catch(() => void 0) : Promise.resolve(void 0);
+  return {
+    app,
+    context,
+    navigate: async (path) => {
+      await hideKeyboard(exec, serial);
+      await resetStack(pages.current());
+      await wait2(stackSettleMs2);
+      await pages.current().evaluate(markStaleScript).catch(() => void 0);
+      pages.forget();
+      await exec("adb", ["-s", serial, "shell", "am", "start", "-W", "-a", "android.intent.action.VIEW", "-d", `'${deepLinkUrl(path, app.deepLink)}'`, appId]);
+      await pages.arrive(path);
+    },
+    clickButton,
+    goHome: async () => {
+      let lastError;
+      for (let attempt = 0; attempt < homeAttempts; attempt += 1) {
+        try {
+          await leaveNativeScreens(exec, serial, appId, app.android.mainActivity);
+          await hideKeyboard(exec, serial);
+          await Promise.all(appPages(context, origin).map(resetStack));
+          await wait2(stackSettleMs2);
+          pages.forget();
+          await closeSheets();
+          await clickButton(homeTabName, "link");
+          return;
+        } catch (error) {
+          lastError = error;
+          await leaveInPageScreen();
+        }
+      }
+      throw lastError;
+    },
+    expectText: async (text, timeoutMs) => {
+      const deadline2 = Date.now() + timeoutMs;
+      while (!await hasText(text).catch(() => false)) {
+        if (Date.now() >= deadline2) throw new Error(`"${text}" \uBB38\uAD6C\uAC00 ${timeoutMs}ms \uC548\uC5D0 \uB098\uC624\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
+        await wait2(pollMs);
+      }
+    },
+    currentPath: async () => pathOf(pages.current()),
+    hasText,
+    screenshot: async () => (await execFileBuffer("adb", ["-s", serial, "exec-out", "screencap", "-p"], { encoding: "buffer", maxBuffer: 64 * 1024 * 1024 })).stdout,
+    evaluate: async (script) => pages.current().evaluate(script),
+    close: () => browser.close()
+  };
+}
+
+export {
+  execFileText,
+  nativeContext,
+  clickTargetHelpers,
+  openIosDriver,
+  appPages,
+  openAndroidDriver
+};

package/dist/chunk-F4TMB4WY.js

@@ -0,0 +1,54 @@
+import {
+  normalizePath
+} from "./chunk-NLX3V7ZJ.js";
+
+// packages/engine/src/screen-map-store.ts
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
+import path from "path";
+
+// packages/core/src/device/screen-map.ts
+function edgeKind(result) {
+  if (result.status === "skipped") return null;
+  if (result.status === "reacted") return result.to ? "navigate" : "popup";
+  return result.status;
+}
+function edgesFrom(from, results, seenAt) {
+  return results.flatMap((result) => {
+    const kind = edgeKind(result);
+    if (!kind) return [];
+    const edge = { from: normalizePath(from), role: result.role, name: result.name, kind, seenAt };
+    if (result.to) edge.to = normalizePath(result.to);
+    if (result.texts && result.texts.length > 0) edge.texts = result.texts;
+    if (kind === "error" && result.message) edge.message = result.message;
+    return [edge];
+  });
+}
+var edgeKey = (edge) => `${edge.from}\0${edge.role}\0${edge.name}`;
+function mergeEdges(current, next) {
+  const merged = new Map(current.map((edge) => [edgeKey(edge), edge]));
+  for (const edge of next) merged.set(edgeKey(edge), edge);
+  return [...merged.values()].sort((a, b) => edgeKey(a) < edgeKey(b) ? -1 : edgeKey(a) > edgeKey(b) ? 1 : 0);
+}
+
+// packages/engine/src/screen-map-store.ts
+var screenMapFile = path.resolve("test-results/screen-map.json");
+function readScreenMap(file = screenMapFile) {
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return { edges: [] };
+  }
+}
+function recordScreenMap(from, results, file = screenMapFile, now = /* @__PURE__ */ new Date()) {
+  const edges = mergeEdges(readScreenMap(file).edges, edgesFrom(from, results, now.toISOString()));
+  mkdirSync(path.dirname(file), { recursive: true });
+  const temp = `${file}.tmp`;
+  writeFileSync(temp, `${JSON.stringify({ edges }, null, 2)}
+`);
+  renameSync(temp, file);
+}
+
+export {
+  readScreenMap,
+  recordScreenMap
+};

package/dist/chunk-F6PZOBU6.js

@@ -0,0 +1,167 @@
+// packages/core/src/policy/snapshot.ts
+var emptySnapshot = { checkedAt: "", pages: {} };
+function diffSnapshots(previous, next) {
+  const changes = [];
+  for (const page of Object.values(next.pages)) {
+    const before = previous.pages[page.id];
+    if (!before) changes.push({ kind: "added", page });
+    else if (before.hash !== page.hash) changes.push({ kind: "changed", page, before });
+  }
+  for (const page of Object.values(previous.pages)) {
+    if (!next.pages[page.id]) changes.push({ kind: "removed", page });
+  }
+  return changes.sort((a, b) => a.page.title.localeCompare(b.page.title, "ko"));
+}
+var recentPolicyDays = 14;
+var dayMs = 864e5;
+function isRecentlyChanged(page, now = Date.now()) {
+  const modified = Date.parse(page.modifiedAt);
+  return Number.isFinite(modified) && now - modified < recentPolicyDays * dayMs;
+}
+
+// packages/core/src/policy/rules.ts
+var squash = (text) => text.replace(/\s+/g, "");
+var entities = { nbsp: " ", amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+function storageToText(storage) {
+  return storage.replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|h[1-6]|li|tr|div)>/gi, "\n").replace(/<\/(td|th)>/gi, " | ").replace(/<[^>]+>/g, "").replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (whole, code) => {
+    if (code.startsWith("#x") || code.startsWith("#X")) return String.fromCodePoint(parseInt(code.slice(2), 16));
+    if (code.startsWith("#")) return String.fromCodePoint(Number(code.slice(1)));
+    return entities[code.toLowerCase()] ?? whole;
+  }).replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+var numbersIn = (text) => text.match(/\d[\d,.]*/g)?.map((value) => value.replace(/[,.]$/, "")) ?? [];
+function rejectReason(candidate, bodyText) {
+  const evidence = squash(candidate.evidence);
+  if (!evidence) return "\uADFC\uAC70 \uC778\uC6A9\uC774 \uBE44\uC5C8\uC2B5\uB2C8\uB2E4.";
+  if (!squash(bodyText).includes(evidence)) return "\uADFC\uAC70 \uC778\uC6A9\uC774 \uC815\uCC45 \uBCF8\uBB38\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  if (candidate.kind === "copy" && (!candidate.expected || !evidence.includes(squash(candidate.expected)))) {
+    return "\uC548\uB0B4 \uBB38\uAD6C\uAC00 \uADFC\uAC70 \uC778\uC6A9\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  }
+  if (candidate.kind === "value") {
+    const missing = numbersIn(candidate.expected ?? candidate.statement).filter((value) => !evidence.includes(squash(value)));
+    if (missing.length > 0) return `\uAC12 ${missing.join(", ")}\uC774 \uADFC\uAC70 \uC778\uC6A9\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.`;
+  }
+  return null;
+}
+function screenMatches(pattern, path) {
+  const clean = (value) => value.split("?")[0].replace(/\/+$/, "") || "/";
+  const parts = clean(pattern).split("/");
+  const target = clean(path).split("/");
+  return parts.length === target.length && parts.every((part, index) => part === "*" || part === target[index]);
+}
+function shortHash(text) {
+  let hash = 2166136261;
+  for (let index = 0; index < text.length; index += 1) {
+    hash ^= text.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function ruleId(pageId, candidate) {
+  return `${pageId}-${candidate.kind}-${shortHash(`${squash(candidate.evidence)}\0${squash(candidate.expected ?? candidate.statement)}`)}`;
+}
+function buildPageRules(page, bodyText, candidates, previous) {
+  const sinceOf = new Map(previous.map((rule) => [rule.id, rule.since]));
+  const rules = /* @__PURE__ */ new Map();
+  const dropped = [];
+  for (const candidate of candidates) {
+    const reason = rejectReason(candidate, bodyText);
+    if (reason) {
+      dropped.push({ statement: candidate.statement, reason });
+      continue;
+    }
+    const id = ruleId(page.id, candidate);
+    rules.set(id, { ...candidate, id, pageId: page.id, pageTitle: page.title, pageHash: page.hash, since: sinceOf.get(id) ?? page.modifiedAt });
+  }
+  return { rules: [...rules.values()], dropped };
+}
+var kinds = ["copy", "value", "behavior"];
+var isString = (value) => typeof value === "string";
+function toCandidate(value) {
+  if (!value || typeof value !== "object") return null;
+  const item = value;
+  if (!kinds.includes(item.kind) || !isString(item.statement) || !isString(item.evidence)) return null;
+  return {
+    kind: item.kind,
+    section: isString(item.section) ? item.section : "",
+    statement: item.statement,
+    expected: isString(item.expected) && item.expected.trim() ? item.expected : void 0,
+    evidence: item.evidence,
+    screens: Array.isArray(item.screens) ? item.screens.filter(isString) : [],
+    visibleOnOpen: item.visibleOnOpen === true
+  };
+}
+function parseJsonObject(text) {
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  if (start < 0 || end <= start) throw new Error("\uC751\uB2F5\uC5D0 JSON\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const parsed = JSON.parse(text.slice(start, end + 1));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("\uC751\uB2F5 JSON\uC774 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4.");
+  return parsed;
+}
+function parseExtraction(text) {
+  const parsed = parseJsonObject(text);
+  const screens = Array.isArray(parsed.screens) ? parsed.screens.filter(isString) : [];
+  const candidates = Array.isArray(parsed.rules) ? parsed.rules.map(toCandidate).filter((item) => item !== null) : [];
+  return { screens, candidates };
+}
+var maxPolicyChars = 6e4;
+function extractPrompt(title, bodyText, knownScreens, appName = "\uB300\uC0C1") {
+  return [
+    `${appName} \uC571\uC758 \uC815\uCC45 \uBB38\uC11C \u300C${title}\u300D\uC5D0\uC11C \uC571 \uD654\uBA74\uC73C\uB85C \uD655\uC778\uD560 \uC218 \uC788\uB294 \uADDC\uCE59\uC744 \uBF51\uC544 JSON \uD558\uB098\uB85C\uB9CC \uB2F5\uD558\uC138\uC694.`,
+    "",
+    "\uADDC\uCE59 \uC885\uB958:",
+    '- "copy": \uACE0\uAC1D\uC5D0\uAC8C \uBCF4\uC774\uB294 \uC548\uB0B4 \uBB38\uAD6C. expected\uC5D0 \uBB38\uAD6C\uB97C \uC815\uCC45\uC5D0 \uC801\uD78C \uADF8\uB300\uB85C \uB123\uB294\uB2E4.',
+    '- "value": \uAE08\uC561\xB7\uD69F\uC218\xB7\uAE30\uAC04\xB7\uBE44\uC728\uCC98\uB7FC \uD654\uBA74\uC5D0 \uBCF4\uC774\uB294 \uAC12. expected\uC5D0 \uD654\uBA74\uC5D0 \uBCF4\uC77C \uAE00\uC790(\uC608: "1,000\uC6D0")\uB97C \uB123\uB294\uB2E4.',
+    '- "behavior": \uC0C1\uD0DC\uC5D0 \uB530\uB77C \uBC84\uD2BC\xB7\uBB38\uAD6C\uAC00 \uBCF4\uC774\uAC70\uB098 \uC228\uB294 \uAC83\uCC98\uB7FC \uD654\uBA74\uC744 \uBD10\uC57C \uD310\uB2E8\uD560 \uC218 \uC788\uB294 \uAC83.',
+    "",
+    "\uC9C0\uD0AC \uAC83:",
+    "- evidence\uC5D0\uB294 \uC815\uCC45 \uBCF8\uBB38\uC758 \uBB38\uC7A5\uC774\uB098 \uD45C \uD55C \uC904\uC744 \uD55C \uAE00\uC790\uB3C4 \uBC14\uAFB8\uC9C0 \uB9D0\uACE0 \uADF8\uB300\uB85C \uBCF5\uC0AC\uD55C\uB2E4. \uC694\uC57D\xB7\uBC88\uC5ED\xB7\uB744\uC5B4\uC4F0\uAE30 \uC218\uC815 \uAE08\uC9C0. \uBCF8\uBB38\uC5D0 \uC5C6\uB294 \uADDC\uCE59\uC740 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.",
+    "- \uC5B4\uB4DC\uBBFC\uC5D0\uC11C \uBC14\uAFC0 \uC218 \uC788\uB2E4\uACE0 \uC801\uD78C \uAC12\uC740 value\uB85C \uBF51\uC9C0 \uC54A\uB294\uB2E4.",
+    "- screens\uB294 \uC544\uB798 \uD654\uBA74 \uBAA9\uB85D\uC5D0\uC11C\uB9CC \uACE0\uB978\uB2E4. \uACBD\uB85C \uD55C \uB9C8\uB514\uB97C *\uB85C \uC4F8 \uC218 \uC788\uB2E4. \uB9DE\uB294 \uD654\uBA74\uC774 \uC5C6\uC73C\uBA74 \uBE48 \uBC30\uC5F4.",
+    "- visibleOnOpen\uC740 \uADF8 \uD654\uBA74\uC744 \uC5F4\uAE30\uB9CC \uD574\uB3C4 \uBCF4\uC774\uBA74 true, \uD1A0\uC2A4\uD2B8\xB7\uBAA8\uB2EC\xB7\uC624\uB958\xB7\uD2B9\uC815 \uC0C1\uD0DC\uC5D0\uC11C\uB9CC \uBCF4\uC774\uBA74 false.",
+    "- \uCD5C\uC0C1\uC704 screens\uC5D0\uB294 \uC774 \uC815\uCC45\uC774 \uB2E4\uB8E8\uB294 \uD654\uBA74\uC744 \uB123\uB294\uB2E4.",
+    "",
+    '\uD615\uC2DD: {"screens": ["/path"], "rules": [{"kind": "copy", "section": "\uC139\uC158 \uC81C\uBAA9", "statement": "\uADDC\uCE59 \uD55C \uC904", "expected": "\uD654\uBA74 \uAE00\uC790", "evidence": "\uBCF8\uBB38 \uADF8\uB300\uB85C", "screens": ["/path"], "visibleOnOpen": true}]}',
+    "",
+    "\uD654\uBA74 \uBAA9\uB85D:",
+    ...knownScreens.map((screen) => `- ${screen}`),
+    "",
+    "\uC815\uCC45 \uBCF8\uBB38:",
+    bodyText.slice(0, maxPolicyChars)
+  ].join("\n");
+}
+var findingLabels = {
+  "pending-app": "\uC571 \uBC18\uC601 \uC804",
+  "app-changed": "\uBB38\uC11C \uAC31\uC2E0 \uB204\uB77D \uB610\uB294 \uBC84\uADF8",
+  "policy-outdated": "\uC815\uCC45 \uBB38\uC11C\uAC00 \uB4A4\uCC98\uC9D0",
+  "docs-mismatch": "\uBB38\uC11C\uB07C\uB9AC \uC5B4\uAE0B\uB0A8",
+  "bug-candidate": "\uBC84\uADF8 \uD6C4\uBCF4"
+};
+var dayMs2 = 864e5;
+function classifyFinding(rule, screenChanged, now) {
+  const since = Date.parse(rule.since);
+  if (Number.isFinite(since) && now - since < recentPolicyDays * dayMs2) return "pending-app";
+  return screenChanged ? "app-changed" : "bug-candidate";
+}
+function classifyWithFigma(rule, figmaAgreesWithPolicy, screenChanged, now) {
+  if (figmaAgreesWithPolicy === null) return classifyFinding(rule, screenChanged, now);
+  if (!figmaAgreesWithPolicy) return "policy-outdated";
+  return classifyFinding(rule, false, now);
+}
+
+export {
+  emptySnapshot,
+  diffSnapshots,
+  isRecentlyChanged,
+  squash,
+  storageToText,
+  screenMatches,
+  shortHash,
+  buildPageRules,
+  parseJsonObject,
+  parseExtraction,
+  extractPrompt,
+  findingLabels,
+  classifyWithFigma
+};