@autifyhq/aximo-cli 0.3.0 → 0.5.0

package/dist/commands/device/unregister.js

@@ -1,49 +1,44 @@
+import { existsSync, unlinkSync } from "node:fs";
 import { defineCommand } from "citty";
-import { existsSync, unlinkSync, readFileSync } from "node:fs";
 import { request } from "../../client.js";
 import { handleApiError } from "../../errors.js";
-import { formatSuccess, formatError, printResult } from "../../output.js";
+import { formatError, formatSuccess, printResult } from "../../output.js";
+import { readDeviceConfig } from "./device-config.js";
 import { getDeviceConfigPath } from "./paths.js";
+function isNotFound(err) {
+    return typeof err === "object" && err !== null && err.status === 404;
+}
 export async function runDeviceUnregister(options, deps) {
-    let deviceId = options.deviceId;
-    if (!deviceId && existsSync(getDeviceConfigPath())) {
-        try {
-            const config = JSON.parse(readFileSync(getDeviceConfigPath(), "utf-8"));
-            if (config &&
-                typeof config === "object" &&
-                typeof config.deviceId === "string") {
-                deviceId = config.deviceId;
-            }
-            else {
-                return formatError("validation_error", "Device config is malformed: missing deviceId", false);
-            }
-        }
-        catch {
-            return formatError("validation_error", "Failed to read device config", false);
-        }
-    }
+    const local = readDeviceConfig();
+    const deviceId = options.deviceId ?? local?.deviceId;
     if (!deviceId) {
+        if (existsSync(getDeviceConfigPath())) {
+            return formatError("validation_error", "Local device config is unreadable. Pass a device ID, or clear it with: aximo device reset --device", false);
+        }
         return formatError("validation_error", "No device ID provided and no local device config found. " +
             "Pass a device ID or register first with: aximo device register", false);
     }
+    let serverDeleted = true;
     try {
         await request(`/api/devices/user/${deviceId}`, { method: "DELETE" }, deps ?? {});
-        if (existsSync(getDeviceConfigPath())) {
-            try {
-                const config = JSON.parse(readFileSync(getDeviceConfigPath(), "utf-8"));
-                if (config.deviceId === deviceId) {
-                    unlinkSync(getDeviceConfigPath());
-                }
-            }
-            catch {
-                // non-fatal
-            }
-        }
-        return formatSuccess({ success: true });
     }
     catch (err) {
-        return handleApiError(err);
+        // Already gone server-side — local cleanup is still the goal, so clear the
+        // file and report success. Re-surface any other error.
+        if (!isNotFound(err))
+            return handleApiError(err);
+        serverDeleted = false;
+    }
+    // Remove the local registration when it matches the device we just unregistered.
+    if (local && local.deviceId === deviceId && existsSync(getDeviceConfigPath())) {
+        try {
+            unlinkSync(getDeviceConfigPath());
+        }
+        catch {
+            // non-fatal
+        }
     }
+    return formatSuccess({ success: true, serverDeleted });
 }
 export default defineCommand({
     meta: { name: "unregister", description: "Unregister a device" },
@@ -55,6 +50,10 @@ export default defineCommand({
     },
     async run({ args }) {
         const deviceId = args["device-id"];
-        printResult(await runDeviceUnregister(deviceId ? { deviceId } : {}));
+        const result = await runDeviceUnregister(deviceId ? { deviceId } : {});
+        printResult(result);
+        if (result.ok && !result.data.serverDeleted) {
+            console.error("\nNote: the device was already absent on the server; cleared the local registration.");
+        }
     },
 });

package/dist/commands/device/unregister.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/device/unregister.test.js

@@ -0,0 +1,73 @@
+import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { HttpResponse, http, server, TEST_BASE_URL } from "../../test-utils.js";
+import { runDeviceUnregister } from "./unregister.js";
+let tempHome;
+beforeAll(() => {
+    tempHome = mkdtempSync(join(tmpdir(), "aximo-unregister-"));
+    process.env["AXIMO_HOME"] = tempHome;
+    process.env["AXIMO_BASE_URL"] = TEST_BASE_URL;
+    process.env["AXIMO_API_KEY"] = "test-key";
+    server.listen();
+});
+afterAll(() => {
+    delete process.env["AXIMO_HOME"];
+    delete process.env["AXIMO_BASE_URL"];
+    delete process.env["AXIMO_API_KEY"];
+    server.close();
+    rmSync(tempHome, { recursive: true, force: true });
+});
+beforeEach(() => {
+    rmSync(tempHome, { recursive: true, force: true });
+    mkdirSync(tempHome, { recursive: true });
+});
+afterEach(() => server.resetHandlers());
+function devicePath() {
+    return join(tempHome, "device.json");
+}
+function seedDevice(cfg) {
+    writeFileSync(devicePath(), JSON.stringify(cfg), { mode: 0o600 });
+}
+describe("runDeviceUnregister", () => {
+    it("deletes the server device and removes the local file", async () => {
+        seedDevice({ deviceId: "dev-1", deviceToken: "t", name: "x" });
+        server.use(http.delete(`${TEST_BASE_URL}/api/devices/user/dev-1`, () => HttpResponse.json({ success: true })));
+        const result = await runDeviceUnregister({});
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.data.serverDeleted).toBe(true);
+        expect(existsSync(devicePath())).toBe(false);
+    });
+    it("clears the local file even when the server returns 404", async () => {
+        seedDevice({ deviceId: "dev-gone", deviceToken: "t", name: "x" });
+        server.use(http.delete(`${TEST_BASE_URL}/api/devices/user/dev-gone`, () => HttpResponse.json({ error: "not found" }, { status: 404 })));
+        const result = await runDeviceUnregister({});
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.data.serverDeleted).toBe(false);
+        expect(existsSync(devicePath())).toBe(false);
+    });
+    it("keeps the local file and errors on a non-404 server error", async () => {
+        seedDevice({ deviceId: "dev-1", deviceToken: "t", name: "x" });
+        server.use(http.delete(`${TEST_BASE_URL}/api/devices/user/dev-1`, () => HttpResponse.json({ error: "boom" }, { status: 500 })));
+        const result = await runDeviceUnregister({});
+        expect(result.ok).toBe(false);
+        expect(existsSync(devicePath())).toBe(true);
+    });
+    it("errors when no device id is given and no local config exists", async () => {
+        const result = await runDeviceUnregister({});
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.code).toBe("validation_error");
+    });
+    it("uses an explicit device id without removing a differing local file", async () => {
+        seedDevice({ deviceId: "local-1", deviceToken: "t", name: "x" });
+        server.use(http.delete(`${TEST_BASE_URL}/api/devices/user/other-2`, () => HttpResponse.json({ success: true })));
+        const result = await runDeviceUnregister({ deviceId: "other-2" });
+        expect(result.ok).toBe(true);
+        // The local registration is for a different device, so it stays.
+        expect(existsSync(devicePath())).toBe(true);
+    });
+});

package/dist/commands/mcp/server.test.js

@@ -24,7 +24,7 @@ async function connect() {
     };
 }
 describe("createMcpServer wiring", () => {
-    it("exposes all 15 tools through tools/list with valid JSON Schema", async () => {
+    it("exposes all 16 tools through tools/list with valid JSON Schema", async () => {
         const { client, cleanup } = await connect();
         try {
             const { tools } = await client.listTools();
@@ -40,6 +40,7 @@ describe("createMcpServer wiring", () => {
                 "aximo_list_projects",
                 "aximo_list_sessions",
                 "aximo_create_case",
+                "aximo_delete_case",
                 "aximo_create_plan",
                 "aximo_add_case_to_plan",
                 "aximo_remove_case_from_plan",

package/dist/commands/mcp/tools.js

@@ -212,6 +212,17 @@ export function defineTools(deps = {}) {
                 return await request("/api/cases", { method: "POST", body: input }, deps);
             }),
         },
+        {
+            name: "aximo_delete_case",
+            title: "Delete test case",
+            description: "Permanently delete a test case. It is removed from any plans it belongs to; past run sessions are kept but detached. This cannot be undone.",
+            inputSchema: {
+                caseId: z.string().uuid(),
+            },
+            handler: async ({ caseId }) => call(async () => {
+                return await request(`/api/cases/${encodeURIComponent(caseId)}`, { method: "DELETE" }, deps);
+            }),
+        },
         {
             name: "aximo_create_plan",
             title: "Create test plan",

package/dist/commands/mcp/tools.test.js

@@ -32,6 +32,7 @@ describe("defineTools", () => {
             "aximo_list_cases",
             "aximo_get_case",
             "aximo_create_case",
+            "aximo_delete_case",
             "aximo_create_plan",
             "aximo_add_case_to_plan",
             "aximo_remove_case_from_plan",
@@ -255,6 +256,17 @@ describe("write tools", () => {
         expect(parsePayload(result)).toEqual({ success: true });
         expect(method).toBe("DELETE");
     });
+    it("aximo_delete_case DELETEs the case path", async () => {
+        let method = null;
+        server.use(http.delete(`${TEST_BASE_URL}/api/cases/c1`, ({ request: req }) => {
+            method = req.method;
+            return HttpResponse.json({ success: true });
+        }));
+        const tool = byName(defineTools(), "aximo_delete_case");
+        const result = await tool.handler({ caseId: "c1" });
+        expect(parsePayload(result)).toEqual({ success: true });
+        expect(method).toBe("DELETE");
+    });
     it("aximo_save_session_as_case POSTs to the save-as-case path without the id in the body", async () => {
         let body;
         server.use(http.post(`${TEST_BASE_URL}/api/sessions/s1/save-as-case`, async ({ request: req }) => {

package/dist/commands/mobile/connect-core.d.ts

@@ -0,0 +1,12 @@
+import type { ErrorEnvelope } from "../../types.js";
+import type { MobileController } from "../../mobile-control/controller.js";
+import { type MobileDeviceConfig } from "./paths.js";
+export declare function getTunnelOrigin(): string;
+interface ConfigOk {
+    ok: true;
+    config: MobileDeviceConfig;
+}
+export declare function resolveDeviceConfig(deviceId: string | undefined): ConfigOk | ErrorEnvelope;
+export declare function buildController(config: MobileDeviceConfig, endpoint: string): MobileController;
+export declare function connectWithConfig(config: MobileDeviceConfig): Promise<void>;
+export {};

package/dist/commands/mobile/connect-core.js

@@ -0,0 +1,74 @@
+import { getBaseUrl } from "../../client.js";
+import { formatError } from "../../output.js";
+import { AppiumController } from "../../mobile-control/appium-controller.js";
+import { startAppiumServer } from "../../mobile-control/appium-server.js";
+import { runControlTunnel } from "../../mobile-control/tunnel.js";
+import { runMobileDoctor } from "./doctor.js";
+import { listMobileDeviceConfigs, readMobileDeviceConfig, } from "./paths.js";
+export function getTunnelOrigin() {
+    return getBaseUrl().replace(/^http/, "ws");
+}
+export function resolveDeviceConfig(deviceId) {
+    if (deviceId) {
+        const config = readMobileDeviceConfig(deviceId);
+        if (!config) {
+            return formatError("not_found", `No registered device with id '${deviceId}'.`, false);
+        }
+        return { ok: true, config };
+    }
+    const all = listMobileDeviceConfigs();
+    if (all.length === 0) {
+        return formatError("validation_error", 'No registered devices. Register one first: aximo mobile register --name "My Pixel" --platform android', false);
+    }
+    if (all.length > 1) {
+        return formatError("validation_error", `Multiple devices registered; pass --device-id. Registered: ${all
+            .map((c) => `${c.name} (${c.deviceId})`)
+            .join(", ")}`, false);
+    }
+    const only = all[0];
+    if (!only) {
+        return formatError("validation_error", "No registered devices.", false);
+    }
+    return { ok: true, config: only };
+}
+export function buildController(config, endpoint) {
+    return new AppiumController({ endpoint, platform: config.platform, target: config.target });
+}
+// A blocking check is any hard failure, plus a missing UiAutomator2 driver
+// (only a warning for `doctor`, but a hard prerequisite for connecting).
+function isBlockingCheck(check) {
+    if (check.status === "fail")
+        return true;
+    return check.name === "uiautomator2 driver" && check.status === "warn";
+}
+async function assertAndroidPrerequisites() {
+    const report = await runMobileDoctor({ platform: "android" });
+    const checks = report.ok ? report.data.checks : [];
+    const blockers = checks.filter(isBlockingCheck);
+    if (blockers.length === 0)
+        return;
+    const lines = blockers.map((c) => `  - ${c.message}${c.hint ? `\n      ${c.hint}` : ""}`);
+    throw new Error(`Missing Appium prerequisites:\n${lines.join("\n")}\n` +
+        "Run `aximo mobile setup` and/or fix the above, then re-run. " +
+        "(`aximo mobile doctor` for details.)");
+}
+export async function connectWithConfig(config) {
+    if (config.platform === "android") {
+        await assertAndroidPrerequisites();
+    }
+    const useDrivers = config.platform === "ios" ? ["xcuitest"] : ["uiautomator2"];
+    const server = await startAppiumServer({ useDrivers });
+    const controller = buildController(config, server.endpoint);
+    try {
+        await runControlTunnel({
+            wsUrl: getTunnelOrigin(),
+            deviceToken: config.deviceToken,
+            deviceName: config.name,
+            controller,
+        });
+    }
+    finally {
+        await controller.close();
+        await server.stop();
+    }
+}

package/dist/commands/mobile/connect.d.ts

@@ -0,0 +1,9 @@
+import type { MobileDeviceConfig } from "./paths.js";
+export declare function iosPhysicalWarning(config: MobileDeviceConfig): string | null;
+declare const _default: import("citty").CommandDef<{
+    readonly "device-id": {
+        readonly type: "string";
+        readonly description: "Registered device id (required if multiple)";
+    };
+}>;
+export default _default;

package/dist/commands/mobile/connect.js

@@ -0,0 +1,35 @@
+import { defineCommand } from "citty";
+import { formatError, printResult } from "../../output.js";
+import { connectWithConfig, resolveDeviceConfig } from "./connect-core.js";
+const IOS_PHYSICAL_WARNING = "Driving a physical iPhone goes through Appium's XCUITest driver, which builds and " +
+    "installs a WebDriverAgent runner on the device. The device must have Developer Mode " +
+    "enabled (Settings → Privacy & Security) and be trusted, and WDA needs an Apple Developer " +
+    "signing identity; if control fails, run `aximo mobile doctor` for guidance.";
+export function iosPhysicalWarning(config) {
+    return config.platform === "ios" ? IOS_PHYSICAL_WARNING : null;
+}
+export default defineCommand({
+    meta: {
+        name: "connect",
+        description: "Connect a registered phone to Aximo via a CLI-managed Appium server",
+    },
+    args: {
+        "device-id": { type: "string", description: "Registered device id (required if multiple)" },
+    },
+    async run({ args }) {
+        const resolved = resolveDeviceConfig(args["device-id"]);
+        if (!resolved.ok) {
+            printResult(resolved);
+            return;
+        }
+        const warning = iosPhysicalWarning(resolved.config);
+        if (warning)
+            console.error(warning);
+        try {
+            await connectWithConfig(resolved.config);
+        }
+        catch (error) {
+            printResult(formatError("api_error", error instanceof Error ? error.message : String(error), true));
+        }
+    },
+});

package/dist/commands/mobile/connect.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/mobile/connect.test.js

@@ -0,0 +1,87 @@
+import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { resolveDeviceConfig } from "./connect-core.js";
+import { iosPhysicalWarning } from "./connect.js";
+import { writeMobileDeviceConfig } from "./paths.js";
+let tempHome;
+beforeAll(() => {
+    tempHome = mkdtempSync(join(tmpdir(), "aximo-mob-connect-"));
+    process.env["AXIMO_HOME"] = tempHome;
+});
+afterAll(() => {
+    delete process.env["AXIMO_HOME"];
+    rmSync(tempHome, { recursive: true, force: true });
+});
+beforeEach(() => {
+    rmSync(tempHome, { recursive: true, force: true });
+    mkdirSync(tempHome, { recursive: true });
+});
+describe("iosPhysicalWarning", () => {
+    it("returns an Appium/WDA guidance warning for iOS configs", () => {
+        const warning = iosPhysicalWarning({
+            deviceId: "d1",
+            deviceToken: "t",
+            name: "iPhone",
+            platform: "ios",
+            target: "udid",
+        });
+        expect(warning).toContain("WebDriverAgent");
+        expect(warning).toContain("Developer Mode");
+    });
+    it("returns null for android configs (no warning)", () => {
+        const warning = iosPhysicalWarning({
+            deviceId: "d2",
+            deviceToken: "t",
+            name: "Pixel",
+            platform: "android",
+            target: "serial",
+        });
+        expect(warning).toBeNull();
+    });
+});
+describe("resolveDeviceConfig", () => {
+    it("returns validation_error when none are registered", () => {
+        const result = resolveDeviceConfig(undefined);
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.code).toBe("validation_error");
+    });
+    it("auto-selects the only registered device", () => {
+        writeMobileDeviceConfig({
+            deviceId: "only-1",
+            deviceToken: "t",
+            name: "Solo",
+            platform: "android",
+            target: "serial-1",
+        });
+        const result = resolveDeviceConfig(undefined);
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.config.deviceId).toBe("only-1");
+    });
+    it("requires --device-id when multiple are registered", () => {
+        for (const id of ["a", "b"]) {
+            writeMobileDeviceConfig({
+                deviceId: id,
+                deviceToken: "t",
+                name: id,
+                platform: "android",
+                target: `serial-${id}`,
+            });
+        }
+        const ambiguous = resolveDeviceConfig(undefined);
+        expect(ambiguous.ok).toBe(false);
+        const picked = resolveDeviceConfig("b");
+        expect(picked.ok).toBe(true);
+        if (picked.ok)
+            expect(picked.config.deviceId).toBe("b");
+    });
+    it("returns not_found for an unknown device id", () => {
+        const result = resolveDeviceConfig("ghost");
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.code).toBe("not_found");
+    });
+});

package/dist/commands/mobile/doctor.d.ts

@@ -0,0 +1,28 @@
+import type { Envelope } from "../../types.js";
+export type CheckStatus = "pass" | "warn" | "fail" | "info";
+export interface Check {
+    name: string;
+    status: CheckStatus;
+    message: string;
+    hint?: string;
+}
+export interface MobileDoctorReport {
+    checks: Check[];
+    summary: {
+        pass: number;
+        warn: number;
+        fail: number;
+        info: number;
+    };
+}
+export interface RunMobileDoctorOptions {
+    platform?: "ios" | "android" | undefined;
+}
+export declare function runMobileDoctor(options?: RunMobileDoctorOptions): Promise<Envelope<MobileDoctorReport>>;
+declare const _default: import("citty").CommandDef<{
+    readonly platform: {
+        readonly type: "string";
+        readonly description: "Limit checks to ios | android";
+    };
+}>;
+export default _default;

package/dist/commands/mobile/doctor.js

@@ -0,0 +1,143 @@
+import { defineCommand } from "citty";
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { platform } from "node:os";
+import { join } from "node:path";
+import { formatSuccess, printResult } from "../../output.js";
+import { importAppium } from "../../mobile-control/appium-import.js";
+import { getAppiumHome, resolveAndroidSdk } from "../../mobile-control/appium-server.js";
+function which(cmd) {
+    const probe = platform() === "win32" ? "where" : "which";
+    const result = spawnSync(probe, [cmd], { encoding: "utf-8" });
+    return result.status === 0 ? (result.stdout || "").split("\n")[0]?.trim() || cmd : null;
+}
+function driverInstalled(driver) {
+    return existsSync(join(getAppiumHome(), "node_modules", `appium-${driver}-driver`));
+}
+function adbInstallHint() {
+    switch (platform()) {
+        case "darwin":
+            return "Install Android platform-tools (brew install --cask android-platform-tools).";
+        case "linux":
+            return "Install Android platform-tools (apt install android-tools-adb, or your distro's adb package).";
+        case "win32":
+            return "Install platform-tools via the Android Studio SDK Manager.";
+        default:
+            return "Install Android platform-tools (adb).";
+    }
+}
+async function checkAppium() {
+    try {
+        const mod = await importAppium();
+        if (typeof mod.main === "function") {
+            return { name: "appium", status: "pass", message: "bundled Appium server is importable" };
+        }
+        return {
+            name: "appium",
+            status: "fail",
+            message: "appium is installed but exposes no programmatic `main`",
+        };
+    }
+    catch (err) {
+        return {
+            name: "appium",
+            status: "fail",
+            message: err instanceof Error ? err.message : String(err),
+            hint: "Reinstall the CLI; the bundled Appium dependency appears to be missing.",
+        };
+    }
+}
+function checkAndroid() {
+    const checks = [];
+    checks.push(driverInstalled("uiautomator2")
+        ? { name: "uiautomator2 driver", status: "pass", message: "installed" }
+        : {
+            name: "uiautomator2 driver",
+            status: "warn",
+            message: "Appium UiAutomator2 driver not installed",
+            hint: "Run `aximo mobile setup` to install Appium drivers.",
+        });
+    const adb = which("adb");
+    checks.push(adb
+        ? { name: "adb", status: "pass", message: adb }
+        : {
+            name: "adb",
+            status: "fail",
+            message: "adb not found in PATH",
+            hint: `${adbInstallHint()} Appium delegates to adb.`,
+        });
+    const sdk = resolveAndroidSdk();
+    checks.push(sdk
+        ? { name: "android sdk", status: "pass", message: sdk }
+        : {
+            name: "android sdk",
+            status: "fail",
+            message: "Android SDK not found (ANDROID_HOME/ANDROID_SDK_ROOT unset)",
+            hint: "Set ANDROID_HOME to your Android SDK — Appium's UiAutomator2 driver requires it even though adb is on PATH — or install it via Android Studio.",
+        });
+    return checks;
+}
+function checkIos() {
+    if (platform() !== "darwin") {
+        return [
+            { name: "ios", status: "info", message: "iOS device control is only available on macOS" },
+        ];
+    }
+    const checks = [];
+    checks.push(driverInstalled("xcuitest")
+        ? { name: "xcuitest driver", status: "pass", message: "installed" }
+        : {
+            name: "xcuitest driver",
+            status: "warn",
+            message: "Appium XCUITest driver not installed",
+            hint: "Run `aximo mobile setup` to install Appium drivers.",
+        });
+    const xcrun = which("xcrun");
+    checks.push(xcrun
+        ? { name: "xcrun", status: "pass", message: xcrun }
+        : {
+            name: "xcrun",
+            status: "warn",
+            message: "xcrun not found",
+            hint: "Install Xcode command line tools: xcode-select --install. Appium's XCUITest driver delegates to Xcode.",
+        });
+    checks.push({
+        name: "ios webdriveragent",
+        status: "info",
+        message: "Physical iPhones are driven via Appium's XCUITest driver, which builds and installs a WebDriverAgent runner on the device.",
+        hint: "WDA needs an Apple Developer signing identity; enable Developer Mode (Settings → Privacy & Security) and trust the device.",
+    });
+    return checks;
+}
+export async function runMobileDoctor(options = {}) {
+    const checks = [await checkAppium()];
+    if (options.platform !== "ios") {
+        checks.push(...checkAndroid());
+    }
+    if (options.platform !== "android") {
+        checks.push(...checkIos());
+    }
+    const summary = { pass: 0, warn: 0, fail: 0, info: 0 };
+    for (const c of checks)
+        summary[c.status]++;
+    return formatSuccess({ checks, summary });
+}
+export default defineCommand({
+    meta: {
+        name: "doctor",
+        description: "Diagnose Appium prerequisites (bundled server, drivers, adb/Xcode delegates)",
+    },
+    args: {
+        platform: { type: "string", description: "Limit checks to ios | android" },
+    },
+    async run({ args }) {
+        const options = {};
+        if (args.platform === "ios" || args.platform === "android")
+            options.platform = args.platform;
+        const result = await runMobileDoctor(options);
+        printResult(result);
+        if (result.ok && result.data.summary.fail > 0) {
+            process.exitCode = 1;
+        }
+    },
+});

package/dist/commands/mobile/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("citty").CommandDef<import("citty").ArgsDef>;
+export default _default;

package/dist/commands/mobile/index.js

@@ -0,0 +1,15 @@
+import { defineCommand } from "citty";
+export default defineCommand({
+    meta: {
+        name: "mobile",
+        description: "Register and connect a phone to Aximo via a CLI-managed Appium server",
+    },
+    subCommands: {
+        list: () => import("./list.js").then((m) => m.default),
+        register: () => import("./register.js").then((m) => m.default),
+        unregister: () => import("./unregister.js").then((m) => m.default),
+        connect: () => import("./connect.js").then((m) => m.default),
+        setup: () => import("./setup.js").then((m) => m.default),
+        doctor: () => import("./doctor.js").then((m) => m.default),
+    },
+});

package/dist/commands/mobile/list.d.ts

@@ -0,0 +1,10 @@
+import type { Envelope } from "../../types.js";
+import { type AndroidDevice, type IosPhysicalDevice } from "../../mobile-control/devices.js";
+import type { ExecFn } from "../../mobile-control/exec.js";
+export interface MobileListResult {
+    androidDevices: AndroidDevice[];
+    iosDevices: IosPhysicalDevice[];
+}
+export declare function runMobileList(exec?: ExecFn): Promise<Envelope<MobileListResult>>;
+declare const _default: import("citty").CommandDef<{}>;
+export default _default;