@ahnseungchan/device-farm 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,192 @@
+/**
+ * 화면 데이터 QA: 화면이 부르는 GET API 응답과 화면 글자로 "값이 맞게 조회·표시됐는가"를 본다.
+ * 사람 QA가 하던 확인(합계가 맞는지, 받은 값이 화면에 그대로 보이는지)을 규칙으로 적는다. 판정에 LLM을 쓰지 않는다.
+ * 화면·규칙 목록은 앱 설정(`AppConfig.qa.screens`)에서 받는다. 여기는 틀과 도우미만 둔다.
+ * 브라우저에서도 읽을 수 있게 node 모듈을 쓰지 않는다.
+ */
+/** 화면 하나가 조회하는 API. `{userId}`는 로그인 세션의 사용자 id로 바꾼다. */
+type ScreenApis = Record<string, string>;
+interface QaContext {
+    /** API 이름 → 파싱한 응답 본문 */
+    responses: Record<string, unknown>;
+    /** 화면에 보이는 글자(document.body.innerText) */
+    text: string;
+}
+interface QaCheck {
+    id: string;
+    title: string;
+    ok: boolean;
+    message?: string;
+}
+interface QaRule {
+    id: string;
+    title: string;
+    /** 통과면 null, 아니면 사람이 읽을 사유 */
+    check(context: QaContext): string | null;
+}
+interface QaScreen {
+    path: string;
+    name: string;
+    apis: ScreenApis;
+    rules: QaRule[];
+}
+/** 원 단위 금액 표기: 989946088 → "989,946,088" */
+declare function formatWon(value: number): string;
+declare function textHas(text: string, expected: string): boolean;
+/** 응답에서 점 경로로 값을 꺼낸다. 없으면 undefined. */
+declare function pick(source: unknown, path: string): unknown;
+/** 금액 비교 규칙에서 쓰는 사유 문장. 같으면 null */
+declare const equalWon: (label: string, actual: number, expected: number) => string | null;
+/** 응답 점 경로의 숫자. 숫자가 아니면 throw해 규칙 실패 사유가 된다 */
+declare function numberAt(context: QaContext, api: string, path: string): number;
+
+type BuildKind = "dev" | "prod";
+
+/** 고정 주소 화면 하나. 목록은 앱 설정(`AppConfig.scenarios`)에서 받는다. */
+type ScreenScenario = {
+    path: string;
+    name: string;
+    when: string;
+    then: string;
+};
+
+/**
+ * 점검 대상 앱 설정. 앱마다 다른 값(패키지 id·웹 주소·탭·금지어·시나리오…)은 전부 여기서만 받는다.
+ * 사용자 프로젝트 루트의 `farm.config.ts`(또는 `FARM_CONFIG` 경로)가 `defineAppConfig()`로 내보낸다.
+ * 브라우저(apps/web)도 읽으므로 node 모듈을 쓰지 않는다. 전역으로 들고 있지 않고 인자로 넘긴다.
+ */
+
+type GuardMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+/** 가드가 금지어보다 먼저 통과시키는 쓰기 요청. `{x}`는 슬래시 없는 한 칸 */
+interface AllowedRequest {
+    method: GuardMethod;
+    path: string;
+}
+/** 하단 탭·홈·뒤로처럼 화면 이동 규칙. 지도 빌더(브라우저)·드라이버·카오스가 같이 쓴다 */
+interface AppNavigation {
+    /** 홈 탭을 누르면 도착하는 경로. 플로우의 시작점 */
+    homePath: string;
+    /** 하단 탭바(웹 링크)의 홈 탭 이름 */
+    homeTabName: string;
+    /** 하단 탭 이름 → 도착 경로. 홈 탭을 포함한다 */
+    tabPaths: Record<string, string>;
+    /** 앱 화면 상단 뒤로 버튼 이름(aria-label 등) */
+    inPageBackNames: string[];
+}
+interface GuardConfig {
+    /** 탐색·버튼 눌러보기·카오스가 누르지 않는 버튼 낱말(부분 일치, 공백 무시) */
+    forbiddenButtonWords: string[];
+    /** 플로우 스텝으로 쓸 수 없는 버튼 이름(정확히 일치) */
+    forbiddenClickNames: string[];
+    /** 허용 목록에 allow로 있어도 막는 쓰기 API 경로 */
+    forbiddenApiPatterns: RegExp[];
+    /** 앱이 켜질 때마다 보내는 요청(푸시 토큰 저장 등). 금지어보다 먼저 통과시킨다 */
+    pushTokenRequests: AllowedRequest[];
+    /** 카오스·탐색이 누르지 않는 광고·외부 링크 이름 */
+    avoidedNamePattern: RegExp;
+    /** 누르지 않고 나가기만 하는 경로(비밀번호·PIN) */
+    noPressPathPattern: RegExp;
+}
+interface ConfluencePolicySource {
+    /** api.atlassian.com/ex/confluence/<cloudId> 게이트웨이용 */
+    cloudId: string;
+    spaceKey: string;
+    /** 제목에 이 말이 든 페이지를 정책 정본으로 본다 */
+    titleQuery: string;
+    /** 사람이 열어 볼 위키 주소(`https://<site>.atlassian.net/wiki`) */
+    siteUrl: string;
+}
+interface FigmaConfig {
+    /** 화면 → 피그마 노드를 뽑을 프론트 체크아웃(Next.js App Router). 비면 `FLOW_PRD_ROOT` */
+    frontRepo?: string;
+    /** 앱이 실제로 배포되는 원격 브랜치 */
+    ref: string;
+    /** 라우트 폴더(App Router `app`) */
+    appDir: string;
+}
+type InstallSourceKind = "firebase" | "testflight";
+interface InstallConfig {
+    /** 빌드를 어디서 받나. 비면 전부 firebase */
+    sources?: Partial<Record<"android" | "ios", Partial<Record<BuildKind, InstallSourceKind>>>>;
+    /** Firebase App Distribution 앱 id. 비면 `FIREBASE_APP_<PLATFORM>_<KIND>` 환경 변수 */
+    firebase?: Partial<Record<"android" | "ios", Partial<Record<BuildKind, string>>>>;
+    /** TestFlight 앱 목록에 보이는 dev 앱 이름(이전 빌드 설치에 쓴다) */
+    testflightDevAppName?: string;
+}
+interface AppConfig extends AppNavigation {
+    name: string;
+    /** Android 패키지 = iOS 번들 id. 플랫폼마다 다르면 `iosBundleIds`로 덮는다 */
+    appIds: Record<BuildKind, string>;
+    iosBundleIds?: Partial<Record<BuildKind, string>>;
+    /** 앱 WebView가 여는 웹 주소. 비우면 `FARM_WEB_ORIGIN_DEV`·`FARM_WEB_ORIGIN_PROD` */
+    web: Record<BuildKind, string>;
+    /** API 호스트가 웹과 다르면 넣는다. 탐색이 내부로 본다 */
+    apiOrigin: string;
+    /** 로그인 화면 경로. 여기로 튕기면 로그인이 풀린 것으로 본다 */
+    loginPaths: string[];
+    /** 화면에 보이면 앱 오류로 보는 문구 */
+    appErrorText: string;
+    /** 시나리오 경로 → `scheme://path` 딥링크. 경로가 `/`면 `scheme://<homeHost>` */
+    deepLink: {
+        scheme: string;
+        homeHost: string;
+    };
+    android: {
+        /** 앱 WebView가 사는 액티비티. 다른 액티비티(네이티브 화면)가 위면 뒤로 키로 닫는다. 비면 닫지 않는다 */
+        mainActivity?: string;
+    };
+    webview: {
+        /** 열린 스택 화면을 전부 닫는 페이지 스크립트(앱 브리지). 비면 닫지 않는다 */
+        stackResetScript?: string;
+        /** 탭 화면에 뜬 바텀시트·팝업 닫기 버튼 이름 */
+        sheetCloseName: string;
+    };
+    guard: GuardConfig;
+    /** 고정 주소 화면 점검 목록 */
+    scenarios: ScreenScenario[];
+    /** 앞 단계가 있어야 의미 있는 화면(완료·중간 단계). 점검에서 뺀다 */
+    excludedScenarioPaths: string[];
+    /** 화면 데이터 QA. `sessionPath`는 로그인 세션(`{ user: { id, accessToken } }`)을 주는 웹 경로 */
+    qa: {
+        screens: QaScreen[];
+        sessionPath: string;
+    };
+    policy: {
+        confluence?: ConfluencePolicySource;
+    };
+    figma: FigmaConfig;
+    install: InstallConfig;
+    ios: {
+        /** WDA 서명 팀. 비면 `IOS_TEAM_ID` */
+        teamId?: string;
+        /** WDA 번들 id. 비면 `IOS_WDA_BUNDLE_ID`, 그것도 비면 `com.example.WebDriverAgentRunner` */
+        wdaBundleId?: string;
+    };
+    /** 디바이스팜 화면에 들어올 수 있는 Tailscale 계정 도메인. 비면 로컬 접속만 */
+    access: {
+        allowedDomains: string[];
+    };
+}
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends RegExp | unknown[] ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** `farm.config.ts`가 적는 모양. 필수는 이름·앱 id·홈·탭뿐이다 */
+type AppConfigInput = Pick<AppConfig, "name" | "appIds" | "homePath" | "homeTabName" | "tabPaths"> & DeepPartial<Omit<AppConfig, "name" | "appIds" | "homePath" | "homeTabName" | "tabPaths" | "guard">> & {
+    /** 기본 금지어·금지 경로에 덧붙인다(기본을 지우지 않는다) */
+    guard?: Partial<Pick<GuardConfig, "pushTokenRequests" | "avoidedNamePattern" | "noPressPathPattern">> & {
+        extraForbiddenButtonWords?: string[];
+        extraForbiddenClickNames?: string[];
+        extraForbiddenApiPatterns?: RegExp[];
+    };
+};
+/** 되돌릴 수 없는 돈·계정 동작. 앱과 상관없이 누르지 않는다 (작성자 판단) */
+declare const defaultForbiddenButtonWords: readonly ["구매", "결제", "매도", "매수", "송금", "출금", "탈퇴", "배송 신청", "주문", "환불", "해지", "삭제", "인출", "선물", "충전", "로그아웃", "공유하기", "Buy", "Pay", "Checkout", "Delete account", "Log out", "Sign out"];
+declare const defaultForbiddenClickNames: readonly ["신청", "신청하기", "결제", "결제하기", "구매하기", "판매하기", "출금", "탈퇴", "탈퇴하기", "본인인증", "송금", "이체"];
+/**
+ * 주문·결제·매도·송금·출금·계좌·탈퇴·배송 신청 경로. 부분 문자열, 대소문자 무시.
+ * 일부러 넓게 잡았다. 과하게 막히면 탐색이 덜 될 뿐 사고는 나지 않는다.
+ */
+declare const defaultForbiddenApiPatterns: readonly RegExp[];
+declare function defineAppConfig(input: AppConfigInput): AppConfig;
+
+export { type AllowedRequest, type AppConfig, type AppConfigInput, type AppNavigation, type BuildKind, type ConfluencePolicySource, type FigmaConfig, type GuardConfig, type GuardMethod, type InstallConfig, type InstallSourceKind, type QaCheck, type QaContext, type QaRule, type QaScreen, type ScreenApis, type ScreenScenario, defaultForbiddenApiPatterns, defaultForbiddenButtonWords, defaultForbiddenClickNames, defineAppConfig, equalWon, formatWon, numberAt, pick, textHas };

package/dist/index.js

@@ -0,0 +1,24 @@
+import {
+  equalWon,
+  formatWon,
+  numberAt,
+  pick,
+  textHas
+} from "./chunk-OUNLQI2N.js";
+import {
+  defaultForbiddenApiPatterns,
+  defaultForbiddenButtonWords,
+  defaultForbiddenClickNames,
+  defineAppConfig
+} from "./chunk-NJNTEWXE.js";
+export {
+  defaultForbiddenApiPatterns,
+  defaultForbiddenButtonWords,
+  defaultForbiddenClickNames,
+  defineAppConfig,
+  equalWon,
+  formatWon,
+  numberAt,
+  pick,
+  textHas
+};

package/dist/init-QFFEOJWY.js

@@ -0,0 +1,29 @@
+// apps/cli/src/init.ts
+import { copyFileSync, existsSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var templates = [
+  { from: "farm.config.ts", to: "farm.config.ts" },
+  { from: "env.example", to: ".env.example" }
+];
+function init(cwd = process.cwd()) {
+  const dir = fileURLToPath(new URL("./templates", import.meta.url));
+  for (const template of templates) {
+    const target = path.join(cwd, template.to);
+    if (existsSync(target)) {
+      console.log(`\uAC74\uB108\uB700  ${template.to} (\uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4)`);
+      continue;
+    }
+    copyFileSync(path.join(dir, template.from), target);
+    console.log(`\uB9CC\uB4E6    ${template.to}`);
+  }
+  console.log(`
+\uB2E4\uC74C \uB2E8\uACC4
+  1. farm.config.ts\uB97C \uB0B4 \uC571 \uAC12(appIds\xB7web\xB7homePath\xB7tabPaths\u2026)\uC73C\uB85C \uBC14\uAFC9\uB2C8\uB2E4.
+  2. \uBE44\uBC00 \uAC12\uC774 \uD544\uC694\uD558\uBA74 .env.example\uC744 .env\uB85C \uBCF5\uC0AC\uD574 \uCC44\uC6C1\uB2C8\uB2E4.
+  3. .gitignore\uC5D0 .env\xB7test-results/\uB97C \uB123\uC2B5\uB2C8\uB2E4.
+  4. npx device-farm dev \uB85C \uD654\uBA74\uC744 \uC5FD\uB2C8\uB2E4.`);
+}
+export {
+  init
+};

package/dist/policy-check-AUWGFNHZ.js

@@ -0,0 +1,75 @@
+import {
+  checkPolicyScreen,
+  policyScreens
+} from "./chunk-WTTCWFOX.js";
+import {
+  askClaude,
+  farmScenarios,
+  readAllPageRules,
+  readFigmaCache,
+  readFrontFigmaMap,
+  readIgnores
+} from "./chunk-VGPCTMUA.js";
+import "./chunk-UAHWEUDI.js";
+import {
+  findingLabels
+} from "./chunk-F6PZOBU6.js";
+import {
+  readScreenMap
+} from "./chunk-F4TMB4WY.js";
+import {
+  openDriver
+} from "./chunk-PZZQWRSU.js";
+import "./chunk-S6GHOP4B.js";
+import {
+  listDevices
+} from "./chunk-JZDYF3HL.js";
+import {
+  cliApp
+} from "./chunk-7OJDY276.js";
+import {
+  execFileText
+} from "./chunk-AXQNUPGC.js";
+import "./chunk-NLX3V7ZJ.js";
+import {
+  appIdFor
+} from "./chunk-NJNTEWXE.js";
+
+// apps/cli/src/policy-check.ts
+function option(name) {
+  const index = process.argv.indexOf(`--${name}`);
+  return index >= 0 ? process.argv[index + 1] : void 0;
+}
+async function main() {
+  const app = await cliApp();
+  const deviceId = option("device");
+  const device = (await listDevices(execFileText, app.appIds.dev, app.iosBundleIds?.dev)).find((item) => item.id === deviceId);
+  if (!device) throw new Error(`\uC5F0\uACB0\uB41C \uAE30\uAE30\uAC00 \uC544\uB2D9\uB2C8\uB2E4: ${deviceId ?? "(--device \uC5C6\uC74C)"}`);
+  const edges = readScreenMap().edges;
+  const known = [.../* @__PURE__ */ new Set([...farmScenarios(app).map((scenario) => scenario.path), ...edges.map((edge) => edge.from)])];
+  const path = option("path");
+  const screens = policyScreens(readAllPageRules(), known, readFigmaCache(), readFrontFigmaMap()?.routes).filter((screen) => !path || screen.path === path);
+  if (screens.length === 0) throw new Error("\uC815\uCC45 \uADDC\uCE59\uC774 \uAC78\uB9B0 \uD654\uBA74\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const driver = await openDriver(app, device, appIdFor(app, "dev", device.platform));
+  let bugs = 0;
+  try {
+    for (const screen of screens) {
+      const report = await checkPolicyScreen(driver, screen, { ask: askClaude, ignores: readIgnores() });
+      console.log(`
+${screen.path} \xB7 \uADDC\uCE59 ${screen.rules.length}\uAC1C \xB7 \uD53C\uADF8\uB9C8 \uBB38\uAD6C ${screen.figma?.texts.length ?? 0}\uAC1C${report.cached ? " \xB7 \uD310\uC815 \uCE90\uC2DC" : ""}`);
+      if (report.judgeError) console.log(`  \uD310\uC815 \uC2E4\uD328: ${report.judgeError}`);
+      for (const check of report.checks.filter((item) => !item.ok)) {
+        console.log(`  ${check.finding ? findingLabels[check.finding] : "\uD53C\uADF8\uB9C8 \uCC28\uC774"}${check.ignored ? "(\uBB34\uC2DC)" : ""} ${check.title} \u2014 ${check.message ?? ""}`);
+        if (check.finding === "bug-candidate" && !check.ignored) bugs += 1;
+      }
+      console.log(`  \uD1B5\uACFC ${report.checks.filter((item) => item.ok && !item.message).length}\uAC1C \xB7 \uD310\uB2E8 \uBD88\uAC00 ${report.checks.filter((item) => item.ok && item.message).length}\uAC1C \xB7 \uC0C1\uD669 \uD544\uC694 ${report.situational}\uAC1C`);
+    }
+  } finally {
+    await driver.close();
+  }
+  process.exitCode = bugs > 0 ? 1 : 0;
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/dist/policy-watch-QPHI2P7Z.js

@@ -0,0 +1,66 @@
+import {
+  confluenceConfigFromEnv,
+  extractPage,
+  fetchPolicySnapshot,
+  refreshFigma,
+  refreshFrontFigma
+} from "./chunk-PYZWMVJ6.js";
+import {
+  askClaude,
+  farmScenarios,
+  readPageRules,
+  readSources,
+  recordSnapshot
+} from "./chunk-VGPCTMUA.js";
+import {
+  isRecentlyChanged
+} from "./chunk-F6PZOBU6.js";
+import {
+  readScreenMap
+} from "./chunk-F4TMB4WY.js";
+import {
+  cliApp
+} from "./chunk-7OJDY276.js";
+import "./chunk-NLX3V7ZJ.js";
+import "./chunk-NJNTEWXE.js";
+
+// apps/cli/src/policy-watch.ts
+var kindLabels = { added: "\uCD94\uAC00", changed: "\uBCC0\uACBD", removed: "\uC0AD\uC81C" };
+function knownScreens(app) {
+  const edges = readScreenMap().edges;
+  return [.../* @__PURE__ */ new Set([...farmScenarios(app).map((scenario) => scenario.path), ...edges.map((edge) => edge.from), ...edges.flatMap((edge) => edge.to ? [edge.to] : [])])].sort();
+}
+async function extractOne(app, config, pageId) {
+  await extractPage(pageId, { config, ask: askClaude, fetchImpl: (url, init) => fetch(url, init), knownScreens: knownScreens(app), appName: app.name, log: console.log });
+  const rules = readPageRules(pageId);
+  for (const rule of rules?.rules ?? []) console.log(`  ${rule.kind} ${rule.visibleOnOpen ? "\uC5F4\uBA74 \uBCF4\uC784" : "\uC0C1\uD669 \uD544\uC694"} ${rule.statement}${rule.expected ? ` \u300C${rule.expected}\u300D` : ""} \u2192 ${rule.screens.join(", ") || "\uD654\uBA74 \uC5C6\uC74C"}`);
+  for (const item of rules?.dropped ?? []) console.log(`  \uBC84\uB9BC ${item.statement} \u2014 ${item.reason}`);
+  console.log(`  \uD654\uBA74 ${rules?.screens.join(", ") || "\uC5C6\uC74C"} \xB7 \uD53C\uADF8\uB9C8 ${rules?.figma.join(", ") || "\uC5C6\uC74C"}`);
+}
+async function main() {
+  const app = await cliApp();
+  if (process.argv.includes("--figma")) {
+    refreshFrontFigma(app.figma, console.log);
+    return refreshFigma((url, init) => fetch(url, init), console.log);
+  }
+  const config = confluenceConfigFromEnv(app.policy.confluence);
+  if (!config) throw new Error("CONFLUENCE_EMAIL\xB7CONFLUENCE_API_TOKEN(.env)\uACFC policy.confluence(farm.config.ts)\uC758 cloudId\xB7spaceKey\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");
+  const extractIndex = process.argv.indexOf("--extract");
+  if (extractIndex >= 0) return extractOne(app, config, process.argv[extractIndex + 1] ?? "");
+  const registered = readSources().pages.map((page) => page.pageId);
+  const { snapshot, failed } = await fetchPolicySnapshot(config, registered, (url, init) => fetch(url, init));
+  const changes = recordSnapshot(snapshot);
+  const pages = Object.values(snapshot.pages);
+  console.log(`\uC815\uCC45 ${pages.length}\uAC1C \uD655\uC778 (${snapshot.checkedAt}) \xB7 \uCD5C\uADFC 14\uC77C \uC548 \uC218\uC815 ${pages.filter((page) => isRecentlyChanged(page)).length}\uAC1C`);
+  if (changes.length === 0) console.log("\uBC14\uB010 \uC815\uCC45 \uC5C6\uC74C");
+  for (const change of changes) {
+    const version = change.before ? `v${change.before.version} \u2192 v${change.page.version}` : `v${change.page.version}`;
+    console.log(`  ${kindLabels[change.kind]} ${change.page.title} (${version}, ${change.page.modifiedAt.slice(0, 10)}) ${change.page.webUrl}`);
+  }
+  for (const item of failed) console.log(`  \uC77D\uAE30 \uC2E4\uD328 ${item.id}: ${item.message}`);
+  process.exitCode = failed.length > 0 ? 1 : 0;
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/dist/qa-run-5LLQMLAM.js

@@ -0,0 +1,59 @@
+import {
+  runScreenQa
+} from "./chunk-3GCH6TN3.js";
+import {
+  openDriver
+} from "./chunk-PZZQWRSU.js";
+import "./chunk-OUNLQI2N.js";
+import "./chunk-S6GHOP4B.js";
+import {
+  listDevices
+} from "./chunk-JZDYF3HL.js";
+import {
+  cliApp
+} from "./chunk-7OJDY276.js";
+import {
+  execFileText
+} from "./chunk-AXQNUPGC.js";
+import {
+  apiOrigin
+} from "./chunk-NLX3V7ZJ.js";
+import {
+  appIdFor
+} from "./chunk-NJNTEWXE.js";
+
+// apps/cli/src/qa-run.ts
+function option(name) {
+  const index = process.argv.indexOf(`--${name}`);
+  return index >= 0 ? process.argv[index + 1] : void 0;
+}
+async function main() {
+  const app = await cliApp();
+  const apiOrigin2 = apiOrigin(app);
+  if (!apiOrigin2) throw new Error("API \uC8FC\uC18C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. farm.config.ts\uC758 apiOrigin\uC774\uB098 FARM_API_ORIGIN\uC744 \uB123\uC5B4 \uC8FC\uC138\uC694.");
+  const deviceId = option("device");
+  const device = (await listDevices(execFileText, app.appIds.dev, app.iosBundleIds?.dev)).find((item) => item.id === deviceId);
+  if (!device) throw new Error(`\uC5F0\uACB0\uB41C \uAE30\uAE30\uAC00 \uC544\uB2D9\uB2C8\uB2E4: ${deviceId ?? "(--device \uC5C6\uC74C)"}`);
+  const path = option("path");
+  const screens = app.qa.screens.filter((screen) => !path || screen.path === path);
+  if (screens.length === 0) throw new Error(`QA \uADDC\uCE59\uC774 \uC5C6\uB294 \uD654\uBA74\uC785\uB2C8\uB2E4: ${path}`);
+  const driver = await openDriver(app, device, appIdFor(app, "dev", device.platform));
+  let failed = 0;
+  try {
+    for (const screen of screens) {
+      const report = await runScreenQa(driver, screen, { apiOrigin: apiOrigin2 });
+      console.log(`
+${report.name} (${report.path})`);
+      for (const api of report.apis) console.log(`  API ${api.status} ${api.durationMs}ms ${api.path}${api.error ? ` \xB7 ${api.error}` : ""}`);
+      for (const check of report.checks) console.log(`  ${check.ok ? "\uD1B5\uACFC" : "\uC2E4\uD328"} ${check.title}${check.message ? ` \u2014 ${check.message}` : ""}`);
+      failed += report.checks.filter((check) => !check.ok).length;
+    }
+  } finally {
+    await driver.close();
+  }
+  process.exitCode = failed > 0 ? 1 : 0;
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/dist/record-EGHVQFR7.js

@@ -0,0 +1,152 @@
+import {
+  buildRecording
+} from "./chunk-JD2L6T7E.js";
+import {
+  addCandidate,
+  mapRulesOf,
+  readReady
+} from "./chunk-PLMSQ5KF.js";
+import {
+  recordScreenMap
+} from "./chunk-F4TMB4WY.js";
+import {
+  screenTextsScript,
+  stepsOf
+} from "./chunk-SWW42KTA.js";
+import {
+  cliApp
+} from "./chunk-7OJDY276.js";
+import {
+  appPages,
+  clickTargetHelpers,
+  openAndroidDriver
+} from "./chunk-AXQNUPGC.js";
+import {
+  webOrigin
+} from "./chunk-NLX3V7ZJ.js";
+import "./chunk-NJNTEWXE.js";
+
+// apps/cli/src/record.ts
+import { createHash } from "crypto";
+
+// packages/devices/src/recorder.ts
+import { setTimeout as sleep } from "timers/promises";
+var recordPollMs = 500;
+var recordSettleMs = 1500;
+var bufferKey = "__deviceFarmRecord";
+var installRecorderScript = `(() => {
+  if (window.${bufferKey}) return true;
+  window.${bufferKey} = [];
+  ${clickTargetHelpers}
+  const squash = (value) => String(value || "").replace(/\\s+/g, " ").trim();
+  document.addEventListener("click", (event) => {
+    const el = event.target instanceof Element ? event.target.closest(selectors.button + ", " + selectors.link) : null;
+    if (!el) return;
+    const role = el.matches(selectors.link) ? "link" : "button";
+    const name = squash(el.tagName === "INPUT" ? el.value : nameOf(el));
+    if (name) window.${bufferKey}.push({ at: Date.now(), path: location.pathname, role, name });
+  }, true);
+  return true;
+})()`;
+var drainScript = `(window.${bufferKey} || []).splice(0)`;
+async function startRecorder(driver, origin, now = Date.now) {
+  const startPath = await driver.currentPath();
+  const events = [];
+  const pending = [];
+  let lastPath = startPath;
+  let stopped = false;
+  const drainAll = async () => {
+    for (const page of appPages(driver.context, origin)) {
+      await page.evaluate(installRecorderScript).catch(() => void 0);
+      const clicks = await page.evaluate(drainScript).catch(() => []);
+      pending.push(...clicks);
+    }
+    pending.sort((a, b) => a.at - b.at);
+  };
+  const settle = async () => {
+    const click = pending[0];
+    if (!click || now() - click.at < recordSettleMs) return false;
+    pending.shift();
+    const to = await driver.currentPath().catch(() => lastPath);
+    const texts = await driver.evaluate(screenTextsScript).catch(() => []);
+    events.push({ type: "click", at: click.at, from: click.path, role: click.role, name: click.name, to, texts });
+    lastPath = to;
+    return true;
+  };
+  const tick = async () => {
+    await drainAll();
+    if (await settle()) return;
+    if (pending.length > 0) return;
+    const path = await driver.currentPath().catch(() => lastPath);
+    if (path !== lastPath) events.push({ type: "jump", at: now(), from: lastPath, to: path });
+    lastPath = path;
+  };
+  const loop = (async () => {
+    while (!stopped) {
+      await tick().catch(() => void 0);
+      await sleep(recordPollMs);
+    }
+  })();
+  return {
+    startPath,
+    count: () => events.length,
+    stop: async () => {
+      stopped = true;
+      await loop;
+      await drainAll().catch(() => void 0);
+      while (pending.length > 0) {
+        const wait = recordSettleMs - (now() - pending[0].at);
+        if (wait > 0) await sleep(wait);
+        await settle().catch(() => pending.shift());
+      }
+      return events;
+    }
+  };
+}
+
+// apps/cli/src/record.ts
+var defaultSeconds = 300;
+var recordIdHashLength = 8;
+function option(name) {
+  const index = process.argv.indexOf(`--${name}`);
+  return index >= 0 ? process.argv[index + 1] : void 0;
+}
+async function main() {
+  const app = await cliApp();
+  const serial = option("device");
+  if (!serial) throw new Error("--device <Android serial>\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");
+  const seconds = Number(option("seconds") ?? defaultSeconds);
+  const origin = webOrigin(app, "dev");
+  const driver = await openAndroidDriver(serial, app.appIds.dev, origin, app);
+  try {
+    if (!driver.goHome) throw new Error("\uD648\uC73C\uB85C \uAC08 \uC218 \uC5C6\uB294 \uB4DC\uB77C\uC774\uBC84\uC785\uB2C8\uB2E4.");
+    await driver.goHome();
+    const recorder = await startRecorder(driver, origin);
+    console.log(`\uAE30\uB85D \uC2DC\uC791 (${recorder.startPath}). ${seconds}\uCD08 \uB4A4 \uB610\uB294 Ctrl+C\uB85C \uB05D\uB0C5\uB2C8\uB2E4.`);
+    await new Promise((resolve) => {
+      const timer = setTimeout(resolve, seconds * 1e3);
+      process.once("SIGINT", () => (clearTimeout(timer), resolve()));
+    });
+    const events = await recorder.stop();
+    const result = buildRecording(events, recorder.startPath, mapRulesOf(app));
+    for (const screen of result.screens) recordScreenMap(screen.from, screen.buttons);
+    console.log(`
+\uC774\uBCA4\uD2B8 ${events.length}\uAC1C \xB7 \uC9C0\uB3C4 \uD654\uBA74 ${result.screens.length}\uAC1C\uC5D0 \uD569\uCE68`);
+    for (const event of events) console.log(event.type === "click" ? `  \uB204\uB974\uAE30 ${event.from} \u300C${event.name}\u300D \u2192 ${event.to}${event.texts[0] ? ` (${event.texts[0]})` : ""}` : `  \uC774\uB3D9 ${event.from} \u2192 ${event.to}`);
+    if (result.cut) console.log(`\uC2A4\uD15D\uC744 \uC5EC\uAE30\uC11C \uB04A\uC74C: ${result.cut}`);
+    const steps = stepsOf(result.steps, app.guard.forbiddenClickNames);
+    if (typeof steps === "string") return console.log(`\uD50C\uB85C\uC6B0 \uD6C4\uBCF4\uB85C \uC62C\uB9AC\uC9C0 \uC54A\uC74C: ${steps}`);
+    const id = `rec-${createHash("sha256").update(JSON.stringify(steps)).digest("hex").slice(0, recordIdHashLength)}`;
+    const name = option("name") ?? `\uAE30\uB85D ${(/* @__PURE__ */ new Date()).toLocaleString("ko-KR")}`;
+    const proposal = readReady().some((flow2) => flow2.id === id) ? "update" : "create";
+    const flow = { id, name, source: "recorded", status: "generated", prd: "\uC870\uC791 \uAE30\uB85D", requirement: `\uAE30\uB85D\uD55C \uC2A4\uD15D ${steps.length}\uAC1C`, proposal, steps };
+    addCandidate(flow);
+    console.log(`\uD50C\uB85C\uC6B0 \uD6C4\uBCF4 \u300C${name}\u300D(${id})\uB97C \uC62C\uB838\uC2B5\uB2C8\uB2E4. \uB514\uBC14\uC774\uC2A4\uD31C \uD50C\uB85C\uC6B0 \uD0ED\uC5D0\uC11C \uD655\uC815\uD558\uC138\uC694.`);
+  } finally {
+    await driver.close();
+  }
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});