@unotest/mobile 0.8.3 → 0.10.0

package/dist/runner/doctor.js

@@ -15,9 +15,9 @@ var ExecError = class extends Error {
     __name(this, "ExecError");
   }
 };
-function defaultExec(cmd, args) {
+function defaultExec(cmd, args, cwd) {
   try {
-    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], cwd });
   } catch {
     throw new ExecError(cmd, args);
   }
@@ -27,7 +27,8 @@ function runEnvironmentChecks(opts = {}) {
   const results = [];
   const platform = opts.platform ?? process.platform;
   const nodeVersion = opts.nodeVersion ?? process.versions.node;
-  const exec = opts.exec ?? defaultExec;
+  const cwd = opts.cwd ?? process.cwd();
+  const exec = opts.exec ?? ((cmd, args) => defaultExec(cmd, args, cwd));
   if (platform !== "darwin") {
     results.push({
       name: "platform",

package/dist/runner/init.js

@@ -20,9 +20,9 @@ var ExecError = class extends Error {
     __name(this, "ExecError");
   }
 };
-function defaultExec(cmd, args) {
+function defaultExec(cmd, args, cwd) {
   try {
-    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], cwd });
   } catch {
     throw new ExecError(cmd, args);
   }
@@ -32,7 +32,8 @@ function runEnvironmentChecks(opts = {}) {
   const results = [];
   const platform = opts.platform ?? process.platform;
   const nodeVersion = opts.nodeVersion ?? process.versions.node;
-  const exec = opts.exec ?? defaultExec;
+  const cwd = opts.cwd ?? process.cwd();
+  const exec = opts.exec ?? ((cmd, args) => defaultExec(cmd, args, cwd));
   if (platform !== "darwin") {
     results.push({
       name: "platform",
@@ -130,12 +131,12 @@ __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
+  smokeWelcome: `// First-run sanity: harness reaches sim, WDA, and app launch handshake
 function test_smoke_welcome() {
-  setDevice("A");
-  appLaunch(true);
+  step("launch the app", () => {
+    setDevice("A");
+    appLaunch(true);
+  });
 }
 `,
   // Canonical syntax reference for AI agents writing new scenarios. The
@@ -146,50 +147,60 @@ function test_smoke_welcome() {
   e2eTemplateExample: `// unotest-mobile JS-DSL \u2014 NOT Node.js.
 //
 // Bare top-level functions only. NO \`import\`/\`export\`/\`async\`/\`await\`/
-// \`const\`/\`let\`/\`var\`/arrow-functions. Assignments are bare-name: \`x = expr;\`.
+// \`const\`/\`let\`/\`var\`. Assignments are bare-name: \`x = expr;\`.
 // Member access (\`obj.field\`) and object literals (\`{key: value}\`) are
-// forbidden \u2014 payloads are passed as JSON strings.
+// forbidden \u2014 payloads are passed as JSON strings. Every statement in a
+// test_* body lives inside step("description", () => { ... }) \u2014 the only
+// place an arrow function appears.
 //
 // After editing any scenario in this directory:
 //   npx unotest-mobile lint
 //
 // Below: minimal valid example. Copy its shape when writing new scenarios.
 
-// id-example-001
 // Example sign-in flow
-// #4a90e2
 function test_example() {
-  setDevice("A");
-  appLaunch(true);
+  step("launch the app", () => {
+    setDevice("A");
+    appLaunch(true);
+  });
 
-  type(getByTestId("email-input"), "user@example.com");
-  type(getByTestId("password-input"), "secret123");
-  tap(getByTestId("signin-button"));
+  step("sign in with valid credentials", () => {
+    type(getByTestId("email-input"), "user@example.com");
+    type(getByTestId("password-input"), "secret123");
+    tap(getByTestId("signin-button"));
+  });
 
-  waitFor(getByTestId("home-screen"), 15000);
+  step("home screen appears", () => {
+    waitFor(getByTestId("home-screen"), 15000);
+  });
 }
 `,
-  scenarioTemplate: `// id-<your-scenario-id>
-// <one-line description>
-// #888888
+  scenarioTemplate: `// <one-line description>
 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");
+  step("seed fixtures", () => {
+    // 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);
+  step("bring the app to its initial 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"));
+  step("<the 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");
+  step("<what proves it worked>", () => {
+    // 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
@@ -199,9 +210,9 @@ 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)
+- \`unotest/e2e-mobile/\` \u2014 scenarios (one \`test_*\` entry function per file)
+- \`unotest/e2e-mobile/_helpers/\` \u2014 project-specific helpers, visible to all scenarios
+- \`unotest/e2e-mobile/<feature>/\` \u2014 feature-scoped subfolders (recommended)
 
 ## How to write a test
 
@@ -212,7 +223,7 @@ 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 e2e <name>\` \u2014 run \`unotest/e2e-mobile/<name>.js\`
 - \`npx @unotest/mobile lint\` \u2014 static check of all scenarios
 - \`npx @unotest/mobile doctor\` \u2014 re-check environment
 
@@ -280,8 +291,8 @@ WDA_PORTS=A=8100,B=8101
 
 # --- Artifacts / sessions / paused-runtime TTL -----------------------------
 # Defaults are sensible \u2014 uncomment only to override.
-# SESSION_LOG_PATH=unotest/sessions/current.jsonl
-# ARTIFACTS_DIR=unotest/artifacts
+# SESSION_LOG_PATH=unotest/.sessions-mobile/current.jsonl
+# ARTIFACTS_DIR=unotest/.artifacts-mobile
 # PAUSED_RUNTIME_TTL_MS=1800000  # 30 min before paused-on-failure auto-abort
 
 # --- Expo dev-client (reserved for future use) -----------------------------
@@ -292,8 +303,12 @@ WDA_PORTS=A=8100,B=8101
     "",
     "# unotest-mobile",
     "unotest/.env",
-    "unotest/artifacts/",
-    "unotest/sessions/"
+    "unotest/.env-mobile",
+    "unotest/.secrets-mobile",
+    "unotest/.runs-mobile/",
+    "unotest/.artifacts-mobile/",
+    "unotest/.sessions-mobile/",
+    "unotest/.debug-mobile/"
   ],
   /**
    * Build the `.mcp.json` entry for this package, pinned to the supplied
@@ -351,28 +366,7 @@ function mergeMcpConfig(existingSource, serverName, serverConfig, options = {})
 __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");
+import { appendUniqueLines } from "@unotest/core";
 
 // src/runner/init/run.ts
 var here = dirname(fileURLToPath(import.meta.url));
@@ -438,20 +432,20 @@ function runInit(argv = process.argv.slice(2)) {
   }
   console.log("\nFiles:");
   const summary = [];
-  ensureDir(join(target, "unotest/e2e/_helpers"));
-  ensureDir(join(target, "unotest/e2e/_template"));
+  ensureDir(join(target, "unotest/e2e-mobile/_helpers"));
+  ensureDir(join(target, "unotest/e2e-mobile/_template"));
   summary.push({
-    path: "unotest/e2e/smoke-welcome.js",
-    status: writeIfNeeded(join(target, "unotest/e2e/smoke-welcome.js"), templates.smokeWelcome, opts.force)
+    path: "unotest/e2e-mobile/smoke-welcome.js",
+    status: writeIfNeeded(join(target, "unotest/e2e-mobile/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)
+    path: "unotest/e2e-mobile/_template.js",
+    status: writeIfNeeded(join(target, "unotest/e2e-mobile/_template.js"), templates.scenarioTemplate, opts.force)
   });
   summary.push({
-    path: "unotest/e2e/_template/example.js",
+    path: "unotest/e2e-mobile/_template/example.js",
     status: writeIfNeeded(
-      join(target, "unotest/e2e/_template/example.js"),
+      join(target, "unotest/e2e-mobile/_template/example.js"),
       templates.e2eTemplateExample,
       opts.force
     )

package/dist/runner/install.js

@@ -2,21 +2,30 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/runner/install.ts
-import { config as loadDotenv2 } from "dotenv";
 import { existsSync as existsSync4 } from "fs";
 import { resolve as resolve3 } from "path";
+import { pathToFileURL } from "url";
 
 // src/config/env.ts
-import { config as loadDotenv } from "dotenv";
+import { applyEnvLayers as applyCoreEnvLayers } from "@unotest/core";
 import { z } from "zod";
+
+// src/runner/scenarios-dir.ts
+import { runsDirFor, testDirFor, UNOTEST_DIR } from "@unotest/protocol";
+var MOBILE_SUFFIX = "-mobile";
+var MOBILE_TEST_DIR = testDirFor(MOBILE_SUFFIX);
+var MOBILE_SCENARIOS_DIR = `${UNOTEST_DIR}/${MOBILE_TEST_DIR}`;
+var MOBILE_RUNS_DIR = `${UNOTEST_DIR}/${runsDirFor(MOBILE_SUFFIX)}`;
+
+// src/config/env.ts
 var ENV_FILE_PATH = "unotest/.env";
 var loaded = false;
-function ensureLoaded() {
+function applyEnvLayers() {
   if (loaded) return;
-  loadDotenv({ path: ENV_FILE_PATH });
+  applyCoreEnvLayers(process.cwd(), MOBILE_SUFFIX);
   loaded = true;
 }
-__name(ensureLoaded, "ensureLoaded");
+__name(applyEnvLayers, "applyEnvLayers");
 var EnvSchema = z.object({
   // APP_BUNDLE_ID — required at appLaunch / install time. We let the schema
   // accept it as optional so commands that don't touch the app (`doctor`,
@@ -63,7 +72,10 @@ var EnvSchema = z.object({
   // `exp+<APP_URL_SCHEME>://expo-development-client/?url=<METRO_URL>` after
   // `app_launch clean: true` to bypass the launcher. (Flow not yet wired.)
   EXPO_DEV_CLIENT: z.string().optional().transform((v) => v === "true" || v === "1"),
-  SESSION_LOG_PATH: z.string().default("unotest/sessions/current.jsonl"),
+  // Dot-prefixed + target-suffixed per the M-10 artifact convention
+  // (`.sessions-mobile`, like `.runs-mobile`): one `.gitignore` wildcard
+  // covers all runtime debris, and web/mobile artifacts never mix.
+  SESSION_LOG_PATH: z.string().default("unotest/.sessions-mobile/current.jsonl"),
   // Explicit kill-switch for session recording. When "1"/"true", or when
   // SESSION_LOG_PATH is empty, buildApp wires a NoopSessionRecorder. Used
   // by evals harness and any consumer that wants the MCP server to make
@@ -72,10 +84,10 @@ var EnvSchema = z.object({
   // When true, recorder writes the FULL tool result alongside the
   // truncated preview. Off by default — snapshots can be megabytes.
   SESSION_LOG_FULL: z.string().optional().transform((v) => v === "1" || v === "true"),
-  ARTIFACTS_DIR: z.string().default("unotest/artifacts"),
+  ARTIFACTS_DIR: z.string().default("unotest/.artifacts-mobile"),
   // Where ExplorationService persists per-session JSONL recording logs.
   // Default: <ARTIFACTS_DIR>/explorations. Folded into the gitignored
-  // `unotest/artifacts/` tree by the init template.
+  // `unotest/.artifacts-mobile/` tree by the init template.
   EXPLORATIONS_DIR: z.string().optional(),
   // WDA per-slot port mapping (D-13 parallel multi-device). Stored as a
   // comma-separated `slot=port` list, e.g. "A=8100,B=8101". Each slot present
@@ -99,7 +111,7 @@ var EnvSchema = z.object({
 var cached = null;
 function loadEnv() {
   if (cached) return cached;
-  ensureLoaded();
+  applyEnvLayers();
   const parsed = EnvSchema.safeParse(process.env);
   if (!parsed.success) {
     const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
@@ -457,6 +469,16 @@ var SimctlAdapter = class {
   }
 };
 
+// src/runner/install/permissions.ts
+function permissionsFromEnv(env) {
+  const envValue = env.APP_PERMISSIONS;
+  if (envValue && envValue.trim().length > 0) {
+    return envValue.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  }
+  return void 0;
+}
+__name(permissionsFromEnv, "permissionsFromEnv");
+
 // src/util/cli-entry.ts
 function runMain(main2, errorExitCode) {
   main2().then(
@@ -689,9 +711,9 @@ var ExecError = class extends Error {
     __name(this, "ExecError");
   }
 };
-function defaultExec(cmd, args) {
+function defaultExec(cmd, args, cwd) {
   try {
-    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], cwd });
   } catch {
     throw new ExecError(cmd, args);
   }
@@ -701,7 +723,8 @@ function runEnvironmentChecks(opts = {}) {
   const results = [];
   const platform = opts.platform ?? process.platform;
   const nodeVersion = opts.nodeVersion ?? process.versions.node;
-  const exec4 = opts.exec ?? defaultExec;
+  const cwd = opts.cwd ?? process.cwd();
+  const exec4 = opts.exec ?? ((cmd, args) => defaultExec(cmd, args, cwd));
   if (platform !== "darwin") {
     results.push({
       name: "platform",
@@ -799,12 +822,12 @@ __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
+  smokeWelcome: `// First-run sanity: harness reaches sim, WDA, and app launch handshake
 function test_smoke_welcome() {
-  setDevice("A");
-  appLaunch(true);
+  step("launch the app", () => {
+    setDevice("A");
+    appLaunch(true);
+  });
 }
 `,
   // Canonical syntax reference for AI agents writing new scenarios. The
@@ -815,50 +838,60 @@ function test_smoke_welcome() {
   e2eTemplateExample: `// unotest-mobile JS-DSL \u2014 NOT Node.js.
 //
 // Bare top-level functions only. NO \`import\`/\`export\`/\`async\`/\`await\`/
-// \`const\`/\`let\`/\`var\`/arrow-functions. Assignments are bare-name: \`x = expr;\`.
+// \`const\`/\`let\`/\`var\`. Assignments are bare-name: \`x = expr;\`.
 // Member access (\`obj.field\`) and object literals (\`{key: value}\`) are
-// forbidden \u2014 payloads are passed as JSON strings.
+// forbidden \u2014 payloads are passed as JSON strings. Every statement in a
+// test_* body lives inside step("description", () => { ... }) \u2014 the only
+// place an arrow function appears.
 //
 // After editing any scenario in this directory:
 //   npx unotest-mobile lint
 //
 // Below: minimal valid example. Copy its shape when writing new scenarios.
 
-// id-example-001
 // Example sign-in flow
-// #4a90e2
 function test_example() {
-  setDevice("A");
-  appLaunch(true);
+  step("launch the app", () => {
+    setDevice("A");
+    appLaunch(true);
+  });
 
-  type(getByTestId("email-input"), "user@example.com");
-  type(getByTestId("password-input"), "secret123");
-  tap(getByTestId("signin-button"));
+  step("sign in with valid credentials", () => {
+    type(getByTestId("email-input"), "user@example.com");
+    type(getByTestId("password-input"), "secret123");
+    tap(getByTestId("signin-button"));
+  });
 
-  waitFor(getByTestId("home-screen"), 15000);
+  step("home screen appears", () => {
+    waitFor(getByTestId("home-screen"), 15000);
+  });
 }
 `,
-  scenarioTemplate: `// id-<your-scenario-id>
-// <one-line description>
-// #888888
+  scenarioTemplate: `// <one-line description>
 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");
+  step("seed fixtures", () => {
+    // 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);
+  step("bring the app to its initial 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"));
+  step("<the 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");
+  step("<what proves it worked>", () => {
+    // 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
@@ -868,9 +901,9 @@ 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)
+- \`unotest/e2e-mobile/\` \u2014 scenarios (one \`test_*\` entry function per file)
+- \`unotest/e2e-mobile/_helpers/\` \u2014 project-specific helpers, visible to all scenarios
+- \`unotest/e2e-mobile/<feature>/\` \u2014 feature-scoped subfolders (recommended)
 
 ## How to write a test
 
@@ -881,7 +914,7 @@ 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 e2e <name>\` \u2014 run \`unotest/e2e-mobile/<name>.js\`
 - \`npx @unotest/mobile lint\` \u2014 static check of all scenarios
 - \`npx @unotest/mobile doctor\` \u2014 re-check environment
 
@@ -949,8 +982,8 @@ WDA_PORTS=A=8100,B=8101
 
 # --- Artifacts / sessions / paused-runtime TTL -----------------------------
 # Defaults are sensible \u2014 uncomment only to override.
-# SESSION_LOG_PATH=unotest/sessions/current.jsonl
-# ARTIFACTS_DIR=unotest/artifacts
+# SESSION_LOG_PATH=unotest/.sessions-mobile/current.jsonl
+# ARTIFACTS_DIR=unotest/.artifacts-mobile
 # PAUSED_RUNTIME_TTL_MS=1800000  # 30 min before paused-on-failure auto-abort
 
 # --- Expo dev-client (reserved for future use) -----------------------------
@@ -961,8 +994,12 @@ WDA_PORTS=A=8100,B=8101
     "",
     "# unotest-mobile",
     "unotest/.env",
-    "unotest/artifacts/",
-    "unotest/sessions/"
+    "unotest/.env-mobile",
+    "unotest/.secrets-mobile",
+    "unotest/.runs-mobile/",
+    "unotest/.artifacts-mobile/",
+    "unotest/.sessions-mobile/",
+    "unotest/.debug-mobile/"
   ],
   /**
    * Build the `.mcp.json` entry for this package, pinned to the supplied
@@ -1020,28 +1057,7 @@ function mergeMcpConfig(existingSource, serverName, serverConfig, options = {})
 __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");
+import { appendUniqueLines } from "@unotest/core";
 
 // src/runner/init/run.ts
 var here = dirname(fileURLToPath(import.meta.url));
@@ -1107,20 +1123,20 @@ function runInit(argv = process.argv.slice(2)) {
   }
   console.log("\nFiles:");
   const summary = [];
-  ensureDir(join(target, "unotest/e2e/_helpers"));
-  ensureDir(join(target, "unotest/e2e/_template"));
+  ensureDir(join(target, "unotest/e2e-mobile/_helpers"));
+  ensureDir(join(target, "unotest/e2e-mobile/_template"));
   summary.push({
-    path: "unotest/e2e/smoke-welcome.js",
-    status: writeIfNeeded(join(target, "unotest/e2e/smoke-welcome.js"), templates.smokeWelcome, opts.force)
+    path: "unotest/e2e-mobile/smoke-welcome.js",
+    status: writeIfNeeded(join(target, "unotest/e2e-mobile/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)
+    path: "unotest/e2e-mobile/_template.js",
+    status: writeIfNeeded(join(target, "unotest/e2e-mobile/_template.js"), templates.scenarioTemplate, opts.force)
   });
   summary.push({
-    path: "unotest/e2e/_template/example.js",
+    path: "unotest/e2e-mobile/_template/example.js",
     status: writeIfNeeded(
-      join(target, "unotest/e2e/_template/example.js"),
+      join(target, "unotest/e2e-mobile/_template/example.js"),
       templates.e2eTemplateExample,
       opts.force
     )
@@ -1678,11 +1694,7 @@ __name(parseArgs, "parseArgs");
 function resolveCliPermissions(opts, env) {
   if (opts.permissionsFlag !== void 0) return opts.permissionsFlag;
   if (opts.noPermissions) return [];
-  const envValue = env.APP_PERMISSIONS;
-  if (envValue && envValue.trim().length > 0) {
-    return envValue.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-  }
-  return void 0;
+  return permissionsFromEnv(env);
 }
 __name(resolveCliPermissions, "resolveCliPermissions");
 function shouldPersistPermissions(resolved, currentEnvValue) {
@@ -1725,7 +1737,7 @@ Examples:
 }
 __name(printHelp, "printHelp");
 async function ensureSimsResolved(opts) {
-  loadDotenv2({ path: ENV_FILE_PATH });
+  applyEnvLayers();
   const currentPoolStr = process.env.SIM_POOL ?? "A,B";
   const currentPool = currentPoolStr.split(",").map((s) => s.trim()).filter(Boolean);
   const simBySlot = {};
@@ -2014,7 +2026,9 @@ Or set APP_PATH in unotest/.env to skip the argument.
   return 0;
 }
 __name(main, "main");
-runMain(main, 1);
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  runMain(main, 1);
+}
 export {
   parseArgs,
   resolveCliPermissions,

package/dist/runner/mobile-runner-adapter.d.ts

@@ -0,0 +1,6 @@
+import { IRunnerAdapter } from '@unotest/protocol';
+
+/** Singleton — the adapter is purely a function bag. */
+declare const mobileRunnerAdapter: IRunnerAdapter;
+
+export { mobileRunnerAdapter as default, mobileRunnerAdapter };