@unotest/mobile 0.1.0

package/dist/runner/doctor.js

@@ -0,0 +1,158 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/runner/init/environment-check.ts
+import { execFileSync } from "child_process";
+var ExecError = class extends Error {
+  constructor(cmd, args) {
+    super(`${cmd} ${args.join(" ")} failed`);
+    this.cmd = cmd;
+    this.args = args;
+  }
+  cmd;
+  args;
+  static {
+    __name(this, "ExecError");
+  }
+};
+function defaultExec(cmd, args) {
+  try {
+    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+  } catch {
+    throw new ExecError(cmd, args);
+  }
+}
+__name(defaultExec, "defaultExec");
+function runEnvironmentChecks(opts = {}) {
+  const results = [];
+  const platform = opts.platform ?? process.platform;
+  const nodeVersion = opts.nodeVersion ?? process.versions.node;
+  const exec = opts.exec ?? defaultExec;
+  if (platform !== "darwin") {
+    results.push({
+      name: "platform",
+      severity: opts.allowNonMacos ? "warning" : "error",
+      message: `macOS required (got "${platform}"). iOS simulators only run on macOS (Apple licensing).`,
+      detail: opts.allowNonMacos ? "Continuing with --allow-non-macos. Tests cannot run without a macOS host." : "Re-run with --allow-non-macos if you only need to scaffold files (e.g. preparing a macOS CI runner)."
+    });
+    if (!opts.allowNonMacos) return results;
+  } else {
+    results.push({ name: "platform", severity: "ok", message: "macOS detected" });
+  }
+  const major = Number.parseInt(nodeVersion.split(".")[0] ?? "0", 10);
+  if (major < 20) {
+    results.push({
+      name: "node",
+      severity: "error",
+      message: `Node 20+ required (got ${nodeVersion}).`,
+      detail: "Upgrade via nvm/fnm/volta."
+    });
+    return results;
+  }
+  results.push({ name: "node", severity: "ok", message: `Node ${nodeVersion}` });
+  if (platform !== "darwin") return results;
+  try {
+    const xcodePath = exec("xcode-select", ["-p"]).trim();
+    results.push({ name: "xcode-cli", severity: "ok", message: `Xcode CLI tools at ${xcodePath}` });
+  } catch {
+    results.push({
+      name: "xcode-cli",
+      severity: "error",
+      message: "Xcode Command Line Tools not found.",
+      detail: "Install: `xcode-select --install`"
+    });
+    return results;
+  }
+  try {
+    exec("xcrun", ["simctl", "help"]);
+    results.push({ name: "simctl", severity: "ok", message: "xcrun simctl available" });
+  } catch {
+    results.push({
+      name: "simctl",
+      severity: "error",
+      message: "xcrun simctl not available.",
+      detail: "Install full Xcode (from Mac App Store), not just Command Line Tools."
+    });
+    return results;
+  }
+  try {
+    const json = exec("xcrun", ["simctl", "list", "devices", "available", "--json"]);
+    const parsed = JSON.parse(json);
+    const total = Object.values(parsed.devices).reduce((sum, list) => sum + list.length, 0);
+    if (total === 0) {
+      results.push({
+        name: "simulators",
+        severity: "warning",
+        message: "No iOS simulators found.",
+        detail: "Create one in Xcode \u2192 Window \u2192 Devices and Simulators \u2192 '+'."
+      });
+    } else {
+      results.push({ name: "simulators", severity: "ok", message: `${total} simulators available` });
+    }
+  } catch {
+    results.push({
+      name: "simulators",
+      severity: "warning",
+      message: "Could not enumerate simulators."
+    });
+  }
+  try {
+    const pkgRaw = exec("cat", ["package.json"]);
+    const pkg = JSON.parse(pkgRaw);
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const isRn = "react-native" in deps || "expo" in deps;
+    if (!isRn) {
+      results.push({
+        name: "rn-project",
+        severity: "warning",
+        message: "package.json doesn't declare react-native or expo.",
+        detail: "unotest-mobile is iOS RN/Expo-focused. Continuing \u2014 but make sure this is intentional."
+      });
+    } else {
+      results.push({ name: "rn-project", severity: "ok", message: "React Native / Expo detected" });
+    }
+  } catch {
+    results.push({
+      name: "rn-project",
+      severity: "warning",
+      message: "No readable package.json in current directory.",
+      detail: "Run init from your project's root."
+    });
+  }
+  return results;
+}
+__name(runEnvironmentChecks, "runEnvironmentChecks");
+
+// src/runner/doctor.ts
+function symbol(severity) {
+  return severity === "ok" ? "\u2713" : severity === "warning" ? "\u26A0" : "\u2717";
+}
+__name(symbol, "symbol");
+function main() {
+  const argv = process.argv.slice(2);
+  const allowNonMacos = argv.includes("--allow-non-macos");
+  console.log("unotest-mobile doctor\n");
+  const checks = runEnvironmentChecks({ allowNonMacos });
+  let hardFailed = false;
+  let warnings = 0;
+  for (const c of checks) {
+    console.log(`${symbol(c.severity)} ${c.name}: ${c.message}`);
+    if (c.detail) console.log(`    ${c.detail}`);
+    if (c.severity === "error") hardFailed = true;
+    if (c.severity === "warning") warnings++;
+  }
+  if (hardFailed) {
+    console.error("\nEnvironment not ready.");
+    return 1;
+  }
+  if (warnings > 0) {
+    console.log(`
+${warnings} warning(s). Tests may still work, but review them.`);
+    return 0;
+  }
+  console.log("\nEnvironment OK.");
+  return 0;
+}
+__name(main, "main");
+process.exit(main());
+//# sourceMappingURL=doctor.js.map

package/dist/runner/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runner/init/environment-check.ts","../../src/runner/doctor.ts"],"sourcesContent":["// Environment validation for `unotest-mobile init` and `doctor`. Each check\n// is small + injectable (exec function) for unit testing without touching\n// the host environment.\n\nimport { execFileSync } from \"node:child_process\";\n\nexport type CheckSeverity = \"ok\" | \"warning\" | \"error\";\n\nexport interface CheckResult {\n  name: string;\n  severity: CheckSeverity;\n  message: string;\n  detail?: string;\n}\n\nexport interface EnvironmentCheckOptions {\n  allowNonMacos?: boolean;\n  // Injectable for tests:\n  platform?: NodeJS.Platform;\n  nodeVersion?: string;\n  exec?: (cmd: string, args: string[]) => string;\n}\n\nclass ExecError extends Error {\n  constructor(public readonly cmd: string, public readonly args: string[]) {\n    super(`${cmd} ${args.join(\" \")} failed`);\n  }\n}\n\nfunction defaultExec(cmd: string, args: string[]): string {\n  try {\n    return execFileSync(cmd, args, { encoding: \"utf8\", stdio: [\"ignore\", \"pipe\", \"ignore\"] });\n  } catch {\n    throw new ExecError(cmd, args);\n  }\n}\n\nexport function runEnvironmentChecks(opts: EnvironmentCheckOptions = {}): CheckResult[] {\n  const results: CheckResult[] = [];\n  const platform = opts.platform ?? process.platform;\n  const nodeVersion = opts.nodeVersion ?? process.versions.node;\n  const exec = opts.exec ?? defaultExec;\n\n  // 1. Platform — hard requirement for iOS Simulator (Apple-only).\n  if (platform !== \"darwin\") {\n    results.push({\n      name: \"platform\",\n      severity: opts.allowNonMacos ? \"warning\" : \"error\",\n      message: `macOS required (got \"${platform}\"). iOS simulators only run on macOS (Apple licensing).`,\n      detail: opts.allowNonMacos\n        ? \"Continuing with --allow-non-macos. Tests cannot run without a macOS host.\"\n        : \"Re-run with --allow-non-macos if you only need to scaffold files (e.g. preparing a macOS CI runner).\",\n    });\n    if (!opts.allowNonMacos) return results;\n  } else {\n    results.push({ name: \"platform\", severity: \"ok\", message: \"macOS detected\" });\n  }\n\n  // 2. Node version.\n  const major = Number.parseInt(nodeVersion.split(\".\")[0] ?? \"0\", 10);\n  if (major < 20) {\n    results.push({\n      name: \"node\",\n      severity: \"error\",\n      message: `Node 20+ required (got ${nodeVersion}).`,\n      detail: \"Upgrade via nvm/fnm/volta.\",\n    });\n    return results;\n  }\n  results.push({ name: \"node\", severity: \"ok\", message: `Node ${nodeVersion}` });\n\n  // Mac-only checks below.\n  if (platform !== \"darwin\") return results;\n\n  // 3. Xcode CLI tools.\n  try {\n    const xcodePath = exec(\"xcode-select\", [\"-p\"]).trim();\n    results.push({ name: \"xcode-cli\", severity: \"ok\", message: `Xcode CLI tools at ${xcodePath}` });\n  } catch {\n    results.push({\n      name: \"xcode-cli\",\n      severity: \"error\",\n      message: \"Xcode Command Line Tools not found.\",\n      detail: \"Install: `xcode-select --install`\",\n    });\n    return results;\n  }\n\n  // 4. xcrun simctl.\n  try {\n    exec(\"xcrun\", [\"simctl\", \"help\"]);\n    results.push({ name: \"simctl\", severity: \"ok\", message: \"xcrun simctl available\" });\n  } catch {\n    results.push({\n      name: \"simctl\",\n      severity: \"error\",\n      message: \"xcrun simctl not available.\",\n      detail: \"Install full Xcode (from Mac App Store), not just Command Line Tools.\",\n    });\n    return results;\n  }\n\n  // 5. iOS simulators present.\n  try {\n    const json = exec(\"xcrun\", [\"simctl\", \"list\", \"devices\", \"available\", \"--json\"]);\n    const parsed = JSON.parse(json) as { devices: Record<string, unknown[]> };\n    const total = Object.values(parsed.devices).reduce((sum, list) => sum + list.length, 0);\n    if (total === 0) {\n      results.push({\n        name: \"simulators\",\n        severity: \"warning\",\n        message: \"No iOS simulators found.\",\n        detail: \"Create one in Xcode → Window → Devices and Simulators → '+'.\",\n      });\n    } else {\n      results.push({ name: \"simulators\", severity: \"ok\", message: `${total} simulators available` });\n    }\n  } catch {\n    results.push({\n      name: \"simulators\",\n      severity: \"warning\",\n      message: \"Could not enumerate simulators.\",\n    });\n  }\n\n  // 6. Project type — soft warning if not RN/Expo.\n  try {\n    const pkgRaw = exec(\"cat\", [\"package.json\"]);\n    const pkg = JSON.parse(pkgRaw) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n    const isRn = \"react-native\" in deps || \"expo\" in deps;\n    if (!isRn) {\n      results.push({\n        name: \"rn-project\",\n        severity: \"warning\",\n        message: \"package.json doesn't declare react-native or expo.\",\n        detail: \"unotest-mobile is iOS RN/Expo-focused. Continuing — but make sure this is intentional.\",\n      });\n    } else {\n      results.push({ name: \"rn-project\", severity: \"ok\", message: \"React Native / Expo detected\" });\n    }\n  } catch {\n    results.push({\n      name: \"rn-project\",\n      severity: \"warning\",\n      message: \"No readable package.json in current directory.\",\n      detail: \"Run init from your project's root.\",\n    });\n  }\n\n  return results;\n}\n","// `unotest-mobile doctor` — re-run environment checks without touching files.\n// Useful when init was run earlier but something changed (Xcode updated,\n// sims deleted, etc.).\n\nimport { runEnvironmentChecks } from \"./init/environment-check.ts\";\n\nfunction symbol(severity: \"ok\" | \"warning\" | \"error\"): string {\n  return severity === \"ok\" ? \"✓\" : severity === \"warning\" ? \"⚠\" : \"✗\";\n}\n\nfunction main(): number {\n  const argv = process.argv.slice(2);\n  const allowNonMacos = argv.includes(\"--allow-non-macos\");\n\n  console.log(\"unotest-mobile doctor\\n\");\n  const checks = runEnvironmentChecks({ allowNonMacos });\n\n  let hardFailed = false;\n  let warnings = 0;\n  for (const c of checks) {\n    console.log(`${symbol(c.severity)} ${c.name}: ${c.message}`);\n    if (c.detail) console.log(`    ${c.detail}`);\n    if (c.severity === \"error\") hardFailed = true;\n    if (c.severity === \"warning\") warnings++;\n  }\n\n  if (hardFailed) {\n    console.error(\"\\nEnvironment not ready.\");\n    return 1;\n  }\n  if (warnings > 0) {\n    console.log(`\\n${warnings} warning(s). Tests may still work, but review them.`);\n    return 0;\n  }\n  console.log(\"\\nEnvironment OK.\");\n  return 0;\n}\n\nprocess.exit(main());\n"],"mappings":";;;;AAIA,SAAS,oBAAoB;AAmB7B,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC5B,YAA4B,KAA6B,MAAgB;AACvE,UAAM,GAAG,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,SAAS;AADb;AAA6B;AAAA,EAEzD;AAAA,EAF4B;AAAA,EAA6B;AAAA,EAxB3D,OAuB8B;AAAA;AAAA;AAI9B;AAEA,SAAS,YAAY,KAAa,MAAwB;AACxD,MAAI;AACF,WAAO,aAAa,KAAK,MAAM,EAAE,UAAU,QAAQ,OAAO,CAAC,UAAU,QAAQ,QAAQ,EAAE,CAAC;AAAA,EAC1F,QAAQ;AACN,UAAM,IAAI,UAAU,KAAK,IAAI;AAAA,EAC/B;AACF;AANS;AAQF,SAAS,qBAAqB,OAAgC,CAAC,GAAkB;AACtF,QAAM,UAAyB,CAAC;AAChC,QAAM,WAAW,KAAK,YAAY,QAAQ;AAC1C,QAAM,cAAc,KAAK,eAAe,QAAQ,SAAS;AACzD,QAAM,OAAO,KAAK,QAAQ;AAG1B,MAAI,aAAa,UAAU;AACzB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU,KAAK,gBAAgB,YAAY;AAAA,MAC3C,SAAS,wBAAwB,QAAQ;AAAA,MACzC,QAAQ,KAAK,gBACT,8EACA;AAAA,IACN,CAAC;AACD,QAAI,CAAC,KAAK,cAAe,QAAO;AAAA,EAClC,OAAO;AACL,YAAQ,KAAK,EAAE,MAAM,YAAY,UAAU,MAAM,SAAS,iBAAiB,CAAC;AAAA,EAC9E;AAGA,QAAM,QAAQ,OAAO,SAAS,YAAY,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AAClE,MAAI,QAAQ,IAAI;AACd,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,0BAA0B,WAAW;AAAA,MAC9C,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AACA,UAAQ,KAAK,EAAE,MAAM,QAAQ,UAAU,MAAM,SAAS,QAAQ,WAAW,GAAG,CAAC;AAG7E,MAAI,aAAa,SAAU,QAAO;AAGlC,MAAI;AACF,UAAM,YAAY,KAAK,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK;AACpD,YAAQ,KAAK,EAAE,MAAM,aAAa,UAAU,MAAM,SAAS,sBAAsB,SAAS,GAAG,CAAC;AAAA,EAChG,QAAQ;AACN,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AAGA,MAAI;AACF,SAAK,SAAS,CAAC,UAAU,MAAM,CAAC;AAChC,YAAQ,KAAK,EAAE,MAAM,UAAU,UAAU,MAAM,SAAS,yBAAyB,CAAC;AAAA,EACpF,QAAQ;AACN,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AAGA,MAAI;AACF,UAAM,OAAO,KAAK,SAAS,CAAC,UAAU,QAAQ,WAAW,aAAa,QAAQ,CAAC;AAC/E,UAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,UAAM,QAAQ,OAAO,OAAO,OAAO,OAAO,EAAE,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,QAAQ,CAAC;AACtF,QAAI,UAAU,GAAG;AACf,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,QACT,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,KAAK,EAAE,MAAM,cAAc,UAAU,MAAM,SAAS,GAAG,KAAK,wBAAwB,CAAC;AAAA,IAC/F;AAAA,EACF,QAAQ;AACN,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAGA,MAAI;AACF,UAAM,SAAS,KAAK,OAAO,CAAC,cAAc,CAAC;AAC3C,UAAM,MAAM,KAAK,MAAM,MAAM;AAI7B,UAAM,OAAO,EAAE,GAAG,IAAI,cAAc,GAAG,IAAI,gBAAgB;AAC3D,UAAM,OAAO,kBAAkB,QAAQ,UAAU;AACjD,QAAI,CAAC,MAAM;AACT,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,QACT,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,KAAK,EAAE,MAAM,cAAc,UAAU,MAAM,SAAS,+BAA+B,CAAC;AAAA,IAC9F;AAAA,EACF,QAAQ;AACN,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AArHgB;;;AC/BhB,SAAS,OAAO,UAA8C;AAC5D,SAAO,aAAa,OAAO,WAAM,aAAa,YAAY,WAAM;AAClE;AAFS;AAIT,SAAS,OAAe;AACtB,QAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,QAAM,gBAAgB,KAAK,SAAS,mBAAmB;AAEvD,UAAQ,IAAI,yBAAyB;AACrC,QAAM,SAAS,qBAAqB,EAAE,cAAc,CAAC;AAErD,MAAI,aAAa;AACjB,MAAI,WAAW;AACf,aAAW,KAAK,QAAQ;AACtB,YAAQ,IAAI,GAAG,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,KAAK,EAAE,OAAO,EAAE;AAC3D,QAAI,EAAE,OAAQ,SAAQ,IAAI,OAAO,EAAE,MAAM,EAAE;AAC3C,QAAI,EAAE,aAAa,QAAS,cAAa;AACzC,QAAI,EAAE,aAAa,UAAW;AAAA,EAChC;AAEA,MAAI,YAAY;AACd,YAAQ,MAAM,0BAA0B;AACxC,WAAO;AAAA,EACT;AACA,MAAI,WAAW,GAAG;AAChB,YAAQ,IAAI;AAAA,EAAK,QAAQ,qDAAqD;AAC9E,WAAO;AAAA,EACT;AACA,UAAQ,IAAI,mBAAmB;AAC/B,SAAO;AACT;AA1BS;AA4BT,QAAQ,KAAK,KAAK,CAAC;","names":[]}

package/dist/runner/init.js

@@ -0,0 +1,453 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/runner/init.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+
+// src/runner/init/environment-check.ts
+import { execFileSync } from "child_process";
+var ExecError = class extends Error {
+  constructor(cmd, args) {
+    super(`${cmd} ${args.join(" ")} failed`);
+    this.cmd = cmd;
+    this.args = args;
+  }
+  cmd;
+  args;
+  static {
+    __name(this, "ExecError");
+  }
+};
+function defaultExec(cmd, args) {
+  try {
+    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+  } catch {
+    throw new ExecError(cmd, args);
+  }
+}
+__name(defaultExec, "defaultExec");
+function runEnvironmentChecks(opts = {}) {
+  const results = [];
+  const platform = opts.platform ?? process.platform;
+  const nodeVersion = opts.nodeVersion ?? process.versions.node;
+  const exec = opts.exec ?? defaultExec;
+  if (platform !== "darwin") {
+    results.push({
+      name: "platform",
+      severity: opts.allowNonMacos ? "warning" : "error",
+      message: `macOS required (got "${platform}"). iOS simulators only run on macOS (Apple licensing).`,
+      detail: opts.allowNonMacos ? "Continuing with --allow-non-macos. Tests cannot run without a macOS host." : "Re-run with --allow-non-macos if you only need to scaffold files (e.g. preparing a macOS CI runner)."
+    });
+    if (!opts.allowNonMacos) return results;
+  } else {
+    results.push({ name: "platform", severity: "ok", message: "macOS detected" });
+  }
+  const major = Number.parseInt(nodeVersion.split(".")[0] ?? "0", 10);
+  if (major < 20) {
+    results.push({
+      name: "node",
+      severity: "error",
+      message: `Node 20+ required (got ${nodeVersion}).`,
+      detail: "Upgrade via nvm/fnm/volta."
+    });
+    return results;
+  }
+  results.push({ name: "node", severity: "ok", message: `Node ${nodeVersion}` });
+  if (platform !== "darwin") return results;
+  try {
+    const xcodePath = exec("xcode-select", ["-p"]).trim();
+    results.push({ name: "xcode-cli", severity: "ok", message: `Xcode CLI tools at ${xcodePath}` });
+  } catch {
+    results.push({
+      name: "xcode-cli",
+      severity: "error",
+      message: "Xcode Command Line Tools not found.",
+      detail: "Install: `xcode-select --install`"
+    });
+    return results;
+  }
+  try {
+    exec("xcrun", ["simctl", "help"]);
+    results.push({ name: "simctl", severity: "ok", message: "xcrun simctl available" });
+  } catch {
+    results.push({
+      name: "simctl",
+      severity: "error",
+      message: "xcrun simctl not available.",
+      detail: "Install full Xcode (from Mac App Store), not just Command Line Tools."
+    });
+    return results;
+  }
+  try {
+    const json = exec("xcrun", ["simctl", "list", "devices", "available", "--json"]);
+    const parsed = JSON.parse(json);
+    const total = Object.values(parsed.devices).reduce((sum, list) => sum + list.length, 0);
+    if (total === 0) {
+      results.push({
+        name: "simulators",
+        severity: "warning",
+        message: "No iOS simulators found.",
+        detail: "Create one in Xcode \u2192 Window \u2192 Devices and Simulators \u2192 '+'."
+      });
+    } else {
+      results.push({ name: "simulators", severity: "ok", message: `${total} simulators available` });
+    }
+  } catch {
+    results.push({
+      name: "simulators",
+      severity: "warning",
+      message: "Could not enumerate simulators."
+    });
+  }
+  try {
+    const pkgRaw = exec("cat", ["package.json"]);
+    const pkg = JSON.parse(pkgRaw);
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const isRn = "react-native" in deps || "expo" in deps;
+    if (!isRn) {
+      results.push({
+        name: "rn-project",
+        severity: "warning",
+        message: "package.json doesn't declare react-native or expo.",
+        detail: "unotest-mobile is iOS RN/Expo-focused. Continuing \u2014 but make sure this is intentional."
+      });
+    } else {
+      results.push({ name: "rn-project", severity: "ok", message: "React Native / Expo detected" });
+    }
+  } catch {
+    results.push({
+      name: "rn-project",
+      severity: "warning",
+      message: "No readable package.json in current directory.",
+      detail: "Run init from your project's root."
+    });
+  }
+  return results;
+}
+__name(runEnvironmentChecks, "runEnvironmentChecks");
+
+// src/runner/init/file-templates.ts
+var templates = {
+  smokeWelcome: `// id-smoke-welcome
+// First-run sanity: harness reaches sim, WDA, and app launch handshake
+// #00aa00
+function test_smoke_welcome() {
+  setDevice("A");
+  appLaunch(true);
+}
+`,
+  scenarioTemplate: `// id-<your-scenario-id>
+// <one-line description>
+// #888888
+function test_<your_name>() {
+  // 1. SETUP \u2014 DB / API fixtures (helpers from _helpers/)
+  //    wipe_e2e_users();
+  //    user_id = seed_user("e2e@example.com", "e2e-pass");
+
+  // 2. ENTER \u2014 bring app to initial UI state
+  setDevice("A");
+  appLaunch(true);
+  waitFor(getByTestId("screen-welcome"), 15000);
+
+  // 3. ACT \u2014 actions you're testing
+  //    signin("e2e@example.com", "e2e-pass");
+  //    tap(getByTestId("btn-something"));
+
+  // 4. ASSERT \u2014 UI + DB / API checks
+  //    assertVisible(getByTestId("screen-target"));
+  //    count = dbQuery("SELECT count(*)::text FROM x WHERE ...");
+  //    assertEqual(count, "1");
+}
+`,
+  agentsMd: `# AI Agents: how to write e2e tests for this project
+
+This project uses [\`@unotest/mobile\`](https://www.npmjs.com/package/@unotest/mobile)
+for end-to-end testing of iOS React Native flows.
+
+## Layout
+
+- \`unotest/e2e/\` \u2014 scenarios (one \`test_*\` entry function per file)
+- \`unotest/e2e/_helpers/\` \u2014 project-specific helpers, visible to all scenarios
+- \`unotest/e2e/<feature>/\` \u2014 feature-scoped subfolders (recommended)
+
+## How to write a test
+
+The full guide \u2014 DSL functions, scenario shape, helper rules, linter codes,
+debugging \u2014 is the \`write-e2e-test\` Claude Code skill at
+\`.claude/skills/write-e2e-test.md\`. It is the single source of truth for
+both Claude Code and other AI agents. Read it before writing tests.
+
+## Running
+
+- \`npx @unotest/mobile e2e <name>\` \u2014 run \`unotest/e2e/<name>.js\`
+- \`npx @unotest/mobile lint\` \u2014 static check of all scenarios
+- \`npx @unotest/mobile doctor\` \u2014 re-check environment
+
+Inside Claude Code, prefer the MCP \`run_test\` tool with
+\`pauseOnFailure: true\` \u2014 it pauses on the failed step so you can
+\`inspect_runtime\`, fix the scenario, and \`resume\`.
+`,
+  envExample: `# unotest-mobile \u2014 copied to unotest/.env by \`init\`. Fill in below.
+
+# --- App under test --------------------------------------------------------
+APP_BUNDLE_ID=com.example.myapp
+APP_URL_SCHEME=myapp
+INVITE_DEEPLINK_PREFIX=myapp://invite/
+
+# --- Backend ---------------------------------------------------------------
+API_BASE_URL=http://localhost:3000/api
+# Optional. Absolute path used as default cwd for the \`shell(...)\` DSL
+# primitive. Set if your scenarios shell out to project-local CLIs
+# (pnpm cli, rails runner, etc.) that must run from the project root.
+PROJECT_ROOT=
+
+# --- Database --------------------------------------------------------------
+# Pick the driver matching your backend. Install peer-deps only as needed:
+#   npm i -D pg @types/pg                 # for postgresql://
+#   npm i -D mysql2                       # for mysql://
+# (SQLite via better-sqlite3 is bundled \u2014 no separate install.)
+#
+# Docker-compose Postgres/MySQL \u2014 ensure host port is exposed
+# (\`ports: ["5432:5432"]\`). Native clients connect from the host, not from
+# inside the compose network.
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/myapp_test
+
+# --- Simulators ------------------------------------------------------------
+# Names must match \`xcrun simctl list devices\`.
+SIM_A_NAME=iPhone 15
+SIM_B_NAME=iPhone 15 Plus
+SIM_POOL=A,B
+
+# --- Dev tooling -----------------------------------------------------------
+METRO_URL=http://localhost:8081
+# Expo dev-client: auto-open dev-client deep link after a clean launch.
+EXPO_DEV_CLIENT=false
+SESSION_LOG_PATH=sessions/current.jsonl
+ARTIFACTS_DIR=artifacts
+
+# --- WebDriverAgent --------------------------------------------------------
+# Per-slot WDA ports. Each slot in SIM_POOL needs one. Format: "slot=port".
+WDA_PORTS=A=8100,B=8101
+WDA_DEFAULT_ACTION_WAIT_MS=2000
+WDA_DEFAULT_WAITFOR_TIMEOUT_MS=10000
+
+# --- D-17 paused-runtime TTL ----------------------------------------------
+# How long a paused-on-failure runtime stays alive before auto-abort (ms).
+# Default 30 minutes. Inspecting the runtime resets the timer.
+PAUSED_RUNTIME_TTL_MS=1800000
+`,
+  gitignoreLines: [
+    "",
+    "# unotest-mobile",
+    "unotest/.env",
+    "unotest/artifacts/",
+    "unotest/sessions/"
+  ],
+  mcpServerEntry: {
+    command: "npx",
+    args: ["-y", "@unotest/mobile"]
+  }
+};
+
+// src/runner/init/mcp-config-merger.ts
+var McpJsonParseError = class extends Error {
+  static {
+    __name(this, "McpJsonParseError");
+  }
+  constructor(message) {
+    super(message);
+    this.name = "McpJsonParseError";
+  }
+};
+function mergeMcpConfig(existingSource, serverName, serverConfig, options = {}) {
+  if (existingSource === null) {
+    const content2 = JSON.stringify({ mcpServers: { [serverName]: serverConfig } }, null, 2) + "\n";
+    return { action: "created", newContent: content2 };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(existingSource);
+  } catch (e) {
+    throw new McpJsonParseError(
+      `Failed to parse .mcp.json as JSON: ${e.message}. Fix or remove the file and re-run init.`
+    );
+  }
+  if (!parsed.mcpServers || typeof parsed.mcpServers !== "object") {
+    parsed.mcpServers = {};
+  }
+  const alreadyPresent = serverName in parsed.mcpServers;
+  if (alreadyPresent && !options.force) {
+    return { action: "already-present", newContent: existingSource };
+  }
+  parsed.mcpServers[serverName] = serverConfig;
+  const content = JSON.stringify(parsed, null, 2) + "\n";
+  return {
+    action: alreadyPresent ? "force-overwrote" : "added",
+    newContent: content
+  };
+}
+__name(mergeMcpConfig, "mergeMcpConfig");
+
+// src/runner/init/gitignore-updater.ts
+function appendUniqueLines(existingContent, linesToAdd) {
+  const existing = existingContent ?? "";
+  const existingLines = new Set(existing.split("\n").map((l) => l.trim()));
+  const added = [];
+  const alreadyPresent = [];
+  for (const line of linesToAdd) {
+    const trimmed = line.trim();
+    if (trimmed === "" || existingLines.has(trimmed)) {
+      if (trimmed !== "") alreadyPresent.push(line);
+      continue;
+    }
+    added.push(line);
+    existingLines.add(trimmed);
+  }
+  if (added.length === 0) {
+    return { added, alreadyPresent, newContent: existing };
+  }
+  const sep = existing === "" ? "" : existing.endsWith("\n") ? "" : "\n";
+  const newContent = existing + sep + added.join("\n") + "\n";
+  return { added, alreadyPresent, newContent };
+}
+__name(appendUniqueLines, "appendUniqueLines");
+
+// src/runner/init.ts
+var here = dirname(fileURLToPath(import.meta.url));
+var packageRoot = resolve(here, "..", "..");
+function parseArgs(argv) {
+  return {
+    force: argv.includes("--force"),
+    allowNonMacos: argv.includes("--allow-non-macos")
+  };
+}
+__name(parseArgs, "parseArgs");
+function symbol(severity) {
+  return severity === "ok" ? "\u2713" : severity === "warning" ? "\u26A0" : "\u2717";
+}
+__name(symbol, "symbol");
+function ensureDir(p) {
+  if (!existsSync(p)) mkdirSync(p, { recursive: true });
+}
+__name(ensureDir, "ensureDir");
+function writeIfNeeded(filePath, content, force) {
+  const exists = existsSync(filePath);
+  if (exists && !force) return "skipped";
+  ensureDir(dirname(filePath));
+  writeFileSync(filePath, content);
+  return exists ? "overwrote" : "created";
+}
+__name(writeIfNeeded, "writeIfNeeded");
+function readPackageFile(relativePath) {
+  const abs = resolve(packageRoot, relativePath);
+  if (!existsSync(abs)) return null;
+  return readFileSync(abs, "utf8");
+}
+__name(readPackageFile, "readPackageFile");
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  const target = process.cwd();
+  console.log("unotest-mobile init \u2014 bootstrapping project\n");
+  console.log("Environment:");
+  const checks = runEnvironmentChecks({ allowNonMacos: opts.allowNonMacos });
+  let hardFailed = false;
+  for (const c of checks) {
+    console.log(`  ${symbol(c.severity)} ${c.name}: ${c.message}`);
+    if (c.detail) console.log(`      ${c.detail}`);
+    if (c.severity === "error") hardFailed = true;
+  }
+  if (hardFailed) {
+    console.error("\nFix the errors above and re-run.");
+    return 1;
+  }
+  console.log("\nFiles:");
+  const summary = [];
+  ensureDir(join(target, "unotest/e2e/_helpers"));
+  summary.push({
+    path: "unotest/e2e/smoke-welcome.js",
+    status: writeIfNeeded(join(target, "unotest/e2e/smoke-welcome.js"), templates.smokeWelcome, opts.force)
+  });
+  summary.push({
+    path: "unotest/e2e/_template.js",
+    status: writeIfNeeded(join(target, "unotest/e2e/_template.js"), templates.scenarioTemplate, opts.force)
+  });
+  summary.push({
+    path: "unotest/AGENTS.md",
+    status: writeIfNeeded(join(target, "unotest/AGENTS.md"), templates.agentsMd, opts.force)
+  });
+  const skillSrc = readPackageFile(".claude/skills/write-e2e-test.md");
+  if (skillSrc !== null) {
+    summary.push({
+      path: ".claude/skills/write-e2e-test.md",
+      status: writeIfNeeded(join(target, ".claude/skills/write-e2e-test.md"), skillSrc, opts.force)
+    });
+  } else {
+    summary.push({ path: ".claude/skills/write-e2e-test.md", status: "missing-in-package" });
+  }
+  const mcpPath = join(target, ".mcp.json");
+  try {
+    const existing = existsSync(mcpPath) ? readFileSync(mcpPath, "utf8") : null;
+    const merge = mergeMcpConfig(
+      existing,
+      "unotest-mobile",
+      {
+        command: templates.mcpServerEntry.command,
+        args: [...templates.mcpServerEntry.args]
+      },
+      { force: opts.force }
+    );
+    if (merge.action !== "already-present") {
+      writeFileSync(mcpPath, merge.newContent);
+    }
+    summary.push({ path: ".mcp.json", status: merge.action });
+  } catch (e) {
+    if (e instanceof McpJsonParseError) {
+      console.error(`
+\u2717 .mcp.json: ${e.message}`);
+      return 1;
+    }
+    throw e;
+  }
+  const envExamplePath = join(target, "unotest/.env.example");
+  summary.push({
+    path: "unotest/.env.example",
+    status: writeIfNeeded(envExamplePath, templates.envExample, true)
+  });
+  const envDst = join(target, "unotest/.env");
+  if (!existsSync(envDst)) {
+    writeFileSync(envDst, templates.envExample);
+    summary.push({ path: "unotest/.env", status: "created" });
+  } else {
+    summary.push({ path: "unotest/.env", status: "skipped (exists \u2014 fill in manually)" });
+  }
+  const gitignorePath = join(target, ".gitignore");
+  const gitignoreExisting = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf8") : null;
+  const giUpdate = appendUniqueLines(gitignoreExisting, [...templates.gitignoreLines]);
+  if (giUpdate.added.length > 0) {
+    writeFileSync(gitignorePath, giUpdate.newContent);
+    summary.push({ path: ".gitignore", status: `added ${giUpdate.added.length} line(s)` });
+  } else {
+    summary.push({ path: ".gitignore", status: "already up-to-date" });
+  }
+  for (const item of summary) {
+    const symbolForStatus = item.status === "created" || item.status.startsWith("added") ? "\u2713" : item.status === "skipped" || item.status.startsWith("already") ? "\xB7" : item.status === "overwrote" || item.status === "force-overwrote" ? "\u21BB" : "?";
+    console.log(`  ${symbolForStatus} ${item.path} \u2014 ${item.status}`);
+  }
+  console.log(`
+Next:
+  1. Edit ${relative(target, envDst) || "unotest/.env"} with your project's values
+     (DATABASE_URL, SIM_A_NAME, APP_BUNDLE_ID, ...)
+  2. Boot iOS simulators matching SIM_A_NAME / SIM_B_NAME (Xcode \u2192 Devices)
+  3. Open Claude Code in this directory \u2014 MCP server auto-registers via
+     .mcp.json. Ask the agent to write a test.
+  4. CLI: \`npx @unotest/mobile e2e smoke-welcome\` to run the starter.
+
+Re-check environment anytime: \`npx @unotest/mobile doctor\`
+`);
+  return 0;
+}
+__name(main, "main");
+process.exit(main());
+//# sourceMappingURL=init.js.map