@ramarivera/chofi 0.1.0

package/dist/drivers/expo.d.ts

@@ -0,0 +1,14 @@
+import type { ProcessSpawner, ProcessResult } from "../spawn.js";
+import type { Driver, ToolStatus } from "./types.js";
+export declare class ExpoDriver implements Driver {
+    private readonly spawner;
+    readonly name = "expo";
+    constructor(spawner?: ProcessSpawner);
+    check(): Promise<ToolStatus>;
+    prebuild(cwd: string, platform?: "ios" | "android"): Promise<ProcessResult>;
+    runIos(cwd: string, device?: string): Promise<ProcessResult>;
+    runAndroid(cwd: string, device?: string): Promise<ProcessResult>;
+    start(cwd: string): Promise<ProcessResult>;
+    doctor(cwd: string): Promise<ProcessResult>;
+}
+//# sourceMappingURL=expo.d.ts.map

package/dist/drivers/expo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../../src/drivers/expo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,UAAW,YAAW,MAAM;IAG3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,UAAU;gBAEM,OAAO,GAAE,cAA+B;IAE/D,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAW5B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAM3E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM5D,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMhE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGlD"}

package/dist/drivers/expo.js

@@ -0,0 +1,42 @@
+import { defaultSpawner } from "../spawn.js";
+export class ExpoDriver {
+    spawner;
+    name = "expo";
+    constructor(spawner = defaultSpawner) {
+        this.spawner = spawner;
+    }
+    async check() {
+        const result = await this.spawner.run("npx", ["expo", "--version"]);
+        if (result.exitCode !== 0) {
+            return { status: "missing", reason: "expo-cli not available" };
+        }
+        return {
+            status: "available",
+            version: result.stdout.trim().split("\n")[0]
+        };
+    }
+    async prebuild(cwd, platform) {
+        const args = ["expo", "prebuild"];
+        if (platform)
+            args.push("--platform", platform);
+        return this.spawner.run("npx", args, { cwd });
+    }
+    async runIos(cwd, device) {
+        const args = ["expo", "run:ios"];
+        if (device)
+            args.push("--device", device);
+        return this.spawner.run("npx", args, { cwd });
+    }
+    async runAndroid(cwd, device) {
+        const args = ["expo", "run:android"];
+        if (device)
+            args.push("--device", device);
+        return this.spawner.run("npx", args, { cwd });
+    }
+    async start(cwd) {
+        return this.spawner.run("npx", ["expo", "start"], { cwd });
+    }
+    async doctor(cwd) {
+        return this.spawner.run("npx", ["expo-doctor"], { cwd });
+    }
+}

package/dist/drivers/idb.d.ts

@@ -0,0 +1,38 @@
+import type { ProcessSpawner, ProcessResult } from "../spawn.js";
+export interface IdbAccessibilityElement {
+    readonly type?: string;
+    readonly label?: string;
+    readonly value?: string;
+    readonly identifier?: string;
+    readonly frame?: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly traits?: readonly string[];
+    readonly children?: readonly IdbAccessibilityElement[];
+}
+export interface IdbCrashLog {
+    readonly name: string;
+    readonly process: string;
+    readonly date: string;
+}
+export declare class IdbDriver {
+    private readonly spawner;
+    constructor(spawner: ProcessSpawner);
+    available(): Promise<boolean>;
+    describeAll(udid: string): Promise<ProcessResult>;
+    describePoint(udid: string, x: number, y: number): Promise<ProcessResult>;
+    tap(udid: string, x: number, y: number): Promise<ProcessResult>;
+    swipe(udid: string, x1: number, y1: number, x2: number, y2: number): Promise<ProcessResult>;
+    pressButton(udid: string, button: string): Promise<ProcessResult>;
+    inputText(udid: string, text: string): Promise<ProcessResult>;
+    listCrashes(udid: string): Promise<ProcessResult>;
+    showCrash(udid: string, name: string): Promise<ProcessResult>;
+    deleteCrash(udid: string, name: string): Promise<ProcessResult>;
+    approve(udid: string, bundleId: string, permissions: readonly string[]): Promise<ProcessResult>;
+    setLocation(udid: string, latitude: number, longitude: number): Promise<ProcessResult>;
+    focus(udid: string): Promise<ProcessResult>;
+}
+//# sourceMappingURL=idb.d.ts.map

package/dist/drivers/idb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.d.ts","sourceRoot":"","sources":["../../src/drivers/idb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7G,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAE9C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAO7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMzE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM7D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM/D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAM/F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMtF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGlD"}

package/dist/drivers/idb.js

@@ -0,0 +1,52 @@
+export class IdbDriver {
+    spawner;
+    constructor(spawner) {
+        this.spawner = spawner;
+    }
+    async available() {
+        const result = await this.spawner.run("idb", ["--version"]);
+        return result.exitCode === 0;
+    }
+    // === Accessibility ===
+    async describeAll(udid) {
+        return this.spawner.run("idb", ["ui", "describe-all", "--udid", udid]);
+    }
+    async describePoint(udid, x, y) {
+        return this.spawner.run("idb", ["ui", "describe-point", String(x), String(y), "--udid", udid]);
+    }
+    // === HID / UI Interactions ===
+    async tap(udid, x, y) {
+        return this.spawner.run("idb", ["ui", "tap", String(x), String(y), "--udid", udid]);
+    }
+    async swipe(udid, x1, y1, x2, y2) {
+        return this.spawner.run("idb", ["ui", "swipe", String(x1), String(y1), String(x2), String(y2), "--udid", udid]);
+    }
+    async pressButton(udid, button) {
+        return this.spawner.run("idb", ["ui", "button", button, "--udid", udid]);
+    }
+    async inputText(udid, text) {
+        return this.spawner.run("idb", ["ui", "text", text, "--udid", udid]);
+    }
+    // === Crash Logs ===
+    async listCrashes(udid) {
+        return this.spawner.run("idb", ["crash", "list", "--udid", udid]);
+    }
+    async showCrash(udid, name) {
+        return this.spawner.run("idb", ["crash", "show", name, "--udid", udid]);
+    }
+    async deleteCrash(udid, name) {
+        return this.spawner.run("idb", ["crash", "delete", name, "--udid", udid]);
+    }
+    // === Settings / Permissions ===
+    async approve(udid, bundleId, permissions) {
+        return this.spawner.run("idb", ["approve", bundleId, ...permissions, "--udid", udid]);
+    }
+    // === Location ===
+    async setLocation(udid, latitude, longitude) {
+        return this.spawner.run("idb", ["set-location", String(latitude), String(longitude), "--udid", udid]);
+    }
+    // === Focus ===
+    async focus(udid) {
+        return this.spawner.run("idb", ["focus", "--udid", udid]);
+    }
+}

package/dist/drivers/maestro.d.ts

@@ -0,0 +1,37 @@
+import type { ProcessSpawner, ProcessResult } from "../spawn.js";
+import type { Driver, ToolStatus } from "./types.js";
+export declare class MaestroDriver implements Driver {
+    private readonly spawner;
+    readonly name = "maestro";
+    constructor(spawner?: ProcessSpawner);
+    check(): Promise<ToolStatus>;
+    test(flowPath: string, options: {
+        cwd: string;
+        device?: string;
+        platform?: "ios" | "android";
+        format?: "junit" | "json";
+        output?: string;
+    }): Promise<ProcessResult>;
+    hierarchy(options: {
+        cwd: string;
+        device?: string;
+    }): Promise<ProcessResult>;
+    record(options: {
+        cwd: string;
+        flowPath: string;
+        device?: string;
+    }): Promise<ProcessResult>;
+    testContinuous(options: {
+        cwd: string;
+        flowPath: string;
+        device?: string;
+        platform?: "ios" | "android";
+    }): Promise<ProcessResult>;
+    driverSetup(cwd: string): Promise<ProcessResult>;
+    startDevice(options: {
+        cwd: string;
+        platform?: "ios" | "android" | undefined;
+        device?: string | undefined;
+    }): Promise<ProcessResult>;
+}
+//# sourceMappingURL=maestro.d.ts.map

package/dist/drivers/maestro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/drivers/maestro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,aAAc,YAAW,MAAM;IAG9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,aAAa;gBAEG,OAAO,GAAE,cAA+B;IAE/D,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAW5B,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC7B,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,aAAa,CAAC;IAUnB,SAAS,CAAC,OAAO,EAAE;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpB,MAAM,CAAC,OAAO,EAAE;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,aAAa,CAAC;IAOpB,cAAc,CAAC,OAAO,EAAE;QAC5B,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;KAC9B,GAAG,OAAO,CAAC,aAAa,CAAC;IAQpB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhD,WAAW,CAAC,OAAO,EAAE;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;QACzC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GAAG,OAAO,CAAC,aAAa,CAAC;CAM3B"}

package/dist/drivers/maestro.js

@@ -0,0 +1,64 @@
+import { defaultSpawner } from "../spawn.js";
+export class MaestroDriver {
+    spawner;
+    name = "maestro";
+    constructor(spawner = defaultSpawner) {
+        this.spawner = spawner;
+    }
+    async check() {
+        const result = await this.spawner.run("maestro", ["--version"]);
+        if (result.exitCode !== 0) {
+            return { status: "missing", reason: result.stderr || "maestro not on PATH" };
+        }
+        return {
+            status: "available",
+            version: result.stdout.trim().split("\n")[0]
+        };
+    }
+    async test(flowPath, options) {
+        const args = ["test"];
+        if (options.device)
+            args.push("--device", options.device);
+        if (options.platform)
+            args.push("--platform", options.platform);
+        if (options.format)
+            args.push("--format", options.format);
+        if (options.output)
+            args.push("--output", options.output);
+        args.push(flowPath);
+        return this.spawner.run("maestro", args, { cwd: options.cwd });
+    }
+    async hierarchy(options) {
+        const args = ["hierarchy"];
+        if (options.device)
+            args.push("--device", options.device);
+        return this.spawner.run("maestro", args, { cwd: options.cwd });
+    }
+    async record(options) {
+        const args = ["record"];
+        if (options.device)
+            args.push("--device", options.device);
+        args.push(options.flowPath);
+        return this.spawner.run("maestro", args, { cwd: options.cwd });
+    }
+    async testContinuous(options) {
+        const args = ["test", "-c"];
+        if (options.device)
+            args.push("--device", options.device);
+        if (options.platform)
+            args.push("--platform", options.platform);
+        args.push(options.flowPath);
+        return this.spawner.run("maestro", args, { cwd: options.cwd });
+    }
+    async driverSetup(cwd) {
+        return this.spawner.run("maestro", ["driver-setup"], { cwd });
+    }
+    async startDevice(options) {
+        const args = ["start-device"];
+        if (options.platform)
+            args.push("--platform", options.platform);
+        if (options.device)
+            args.push("--device", options.device);
+        return this.spawner.run("maestro", args, { cwd: options.cwd });
+    }
+}

package/dist/drivers/types.d.ts

@@ -0,0 +1,23 @@
+export interface DriverResult {
+    readonly durationMs: number;
+    readonly exitCode: number;
+    readonly stderr: string;
+    readonly stdout: string;
+}
+export interface Driver {
+    readonly name: string;
+    check(): Promise<ToolStatus>;
+}
+export type ToolStatus = {
+    readonly status: "available";
+    readonly version?: string | undefined;
+} | {
+    readonly status: "missing";
+    readonly reason?: string | undefined;
+};
+export interface SimDevice {
+    readonly name: string;
+    readonly state: "Booted" | "Shutdown" | string;
+    readonly udid: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/drivers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/drivers/types.js

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

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+export declare class ChofiError extends Error {
+    readonly code: string;
+    readonly recoverySuggestion?: string | undefined;
+    constructor(message: string, code: string, recoverySuggestion?: string | undefined);
+}
+export declare class SimulatorNotFoundError extends ChofiError {
+    constructor(target: string, detail?: string);
+}
+export declare class SimulatorStateError extends ChofiError {
+    constructor(udid: string, requiredState: string, actualState: string);
+}
+export declare class AppNotInstalledError extends ChofiError {
+    constructor(bundleId: string, udid: string);
+}
+export declare class AppNotRunningError extends ChofiError {
+    constructor(bundleId: string, udid: string);
+}
+export declare class BuildFailedError extends ChofiError {
+    constructor(stderr: string);
+}
+export declare class TestsFailedError extends ChofiError {
+    constructor(stderr: string);
+}
+export declare class ConfigParseError extends ChofiError {
+    constructor(path: string, reason: string);
+}
+export declare class ToolOutputError extends ChofiError {
+    constructor(tool: string, stderr: string);
+}
+export declare function classifyError(error: unknown): ChofiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IAGjC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,YAAA;CAKvC;AAED,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO5C;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAOrE;AAED,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO3C;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO3C;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,MAAM,EAAE,MAAM;CAO3B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,MAAM,EAAE,MAAM;CAO3B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOzC;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOzC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAQxD"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+export class ChofiError extends Error {
+    code;
+    recoverySuggestion;
+    constructor(message, code, recoverySuggestion) {
+        super(message);
+        this.code = code;
+        this.recoverySuggestion = recoverySuggestion;
+        this.name = "ChofiError";
+    }
+}
+export class SimulatorNotFoundError extends ChofiError {
+    constructor(target, detail) {
+        super(detail || `Simulator not found: ${target}`, "SIMULATOR_NOT_FOUND", "Run 'chofi sim list --json' to see available simulators.");
+    }
+}
+export class SimulatorStateError extends ChofiError {
+    constructor(udid, requiredState, actualState) {
+        super(`Simulator ${udid} is ${actualState}, but ${requiredState} is required`, "SIMULATOR_STATE_INVALID", `Use 'chofi sim boot ${udid} --json' to boot, or 'chofi sim shutdown ${udid} --json' to shutdown.`);
+    }
+}
+export class AppNotInstalledError extends ChofiError {
+    constructor(bundleId, udid) {
+        super(`App ${bundleId} is not installed on ${udid}`, "APP_NOT_INSTALLED", `Use 'chofi app install ${udid} <appPath> --json' to install the app first.`);
+    }
+}
+export class AppNotRunningError extends ChofiError {
+    constructor(bundleId, udid) {
+        super(`App ${bundleId} is not running on ${udid}`, "APP_NOT_RUNNING", `Use 'chofi app launch ${udid} ${bundleId} --json' to launch the app first.`);
+    }
+}
+export class BuildFailedError extends ChofiError {
+    constructor(stderr) {
+        super(`Build failed: ${stderr.slice(0, 200)}`, "BUILD_FAILED", "Check the build output for compile errors. Use 'chofi clean --json --scheme <scheme>' if needed.");
+    }
+}
+export class TestsFailedError extends ChofiError {
+    constructor(stderr) {
+        super(`Tests failed: ${stderr.slice(0, 200)}`, "TESTS_FAILED", "Check test output for failures. Use 'chofi test --json --scheme <scheme>' to re-run.");
+    }
+}
+export class ConfigParseError extends ChofiError {
+    constructor(path, reason) {
+        super(`Failed to parse config at ${path}: ${reason}`, "CONFIG_PARSE_ERROR", "Fix the JSON syntax in .chofi.json or delete it to reset.");
+    }
+}
+export class ToolOutputError extends ChofiError {
+    constructor(tool, stderr) {
+        super(`${tool} failed: ${stderr.slice(0, 200)}`, "TOOL_EXECUTION_FAILED", "Check that the tool is installed and the arguments are valid.");
+    }
+}
+export function classifyError(error) {
+    if (error instanceof ChofiError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new ChofiError(error.message, "UNKNOWN_ERROR");
+    }
+    return new ChofiError(String(error), "UNKNOWN_ERROR");
+}

package/dist/events.d.ts

@@ -0,0 +1,33 @@
+export declare const chofiSchemaVersion = "0.1.0";
+export declare const chofiToolName = "chofi";
+export type ChofiEventName = "command_completed" | "command_failed" | "command_started" | "plan" | "summary" | "tool_checked";
+export type ChofiStatus = "available" | "failed" | "missing" | "passed" | "planned";
+export interface ChofiEvent<TData = unknown> {
+    readonly data: TData;
+    readonly errorType?: string;
+    readonly event: ChofiEventName;
+    readonly phase: string;
+    readonly schemaVersion: typeof chofiSchemaVersion;
+    readonly status?: ChofiStatus;
+    readonly timestamp: string;
+    readonly tool: typeof chofiToolName;
+}
+export type Clock = () => Date;
+export declare function createChofiEvent<TData>(input: {
+    readonly clock?: Clock | undefined;
+    readonly data: TData;
+    readonly errorType?: string | undefined;
+    readonly event: ChofiEventName;
+    readonly phase: string;
+    readonly status?: ChofiStatus | undefined;
+}): ChofiEvent<TData>;
+export declare function serializeNdjsonEvent(event: ChofiEvent): string;
+export interface EventWriter {
+    write(event: ChofiEvent): void;
+}
+export declare class NdjsonEventWriter implements EventWriter {
+    private readonly output;
+    constructor(output?: NodeJS.WritableStream);
+    write(event: ChofiEvent): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAC1C,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,MAAM,GACN,SAAS,GACT,cAAc,CAAC;AAEnB,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,kBAAkB,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,aAAa,CAAC;CACrC;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC;AAE/B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C,GAAG,UAAU,CAAC,KAAK,CAAC,CAWpB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,iBAAkB,YAAW,WAAW;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,MAAM,CAAC,cAA+B;IAGjE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAG/B"}

package/dist/events.js

@@ -0,0 +1,26 @@
+export const chofiSchemaVersion = "0.1.0";
+export const chofiToolName = "chofi";
+export function createChofiEvent(input) {
+    return {
+        schemaVersion: chofiSchemaVersion,
+        tool: chofiToolName,
+        event: input.event,
+        phase: input.phase,
+        ...(input.status === undefined ? {} : { status: input.status }),
+        ...(input.errorType === undefined ? {} : { errorType: input.errorType }),
+        timestamp: (input.clock ?? (() => new Date()))().toISOString(),
+        data: input.data
+    };
+}
+export function serializeNdjsonEvent(event) {
+    return `${JSON.stringify(event)}\n`;
+}
+export class NdjsonEventWriter {
+    output;
+    constructor(output = process.stdout) {
+        this.output = output;
+    }
+    write(event) {
+        this.output.write(serializeNdjsonEvent(event));
+    }
+}

package/dist/executor.d.ts

@@ -0,0 +1,11 @@
+import type { ProcessSpawner, ProcessResult } from "./spawn.js";
+import type { CommandPlan } from "./planning.js";
+export type CommandExecutionResult = ProcessResult;
+export type CommandRunner = (command: CommandPlan) => Promise<CommandExecutionResult>;
+export declare function createCommandRunner(spawner?: ProcessSpawner): CommandRunner;
+export declare const nodeCommandRunner: CommandRunner;
+export declare function summarizeOutput(output: string): {
+    readonly bytes: number;
+    readonly tail: string;
+};
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,cAA+B,GACvC,aAAa,CAOf;AAED,eAAO,MAAM,iBAAiB,EAAE,aAAqC,CAAC;AAEtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAMA"}

package/dist/executor.js

@@ -0,0 +1,17 @@
+import { defaultSpawner } from "./spawn.js";
+export function createCommandRunner(spawner = defaultSpawner) {
+    return async (command) => {
+        const result = await spawner.run(command.command, command.args, {
+            cwd: command.cwd
+        });
+        return result;
+    };
+}
+export const nodeCommandRunner = createCommandRunner();
+export function summarizeOutput(output) {
+    const trimmed = output.trim();
+    return {
+        bytes: Buffer.byteLength(output),
+        tail: trimmed.length <= 2_000 ? trimmed : trimmed.slice(-2_000)
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./cli.js";
+export * from "./config.js";
+export * from "./discovery.js";
+export * from "./events.js";
+export * from "./executor.js";
+export * from "./planning.js";
+export * from "./runtime.js";
+export * from "./safety.js";
+export * from "./spawn.js";
+export * from "./drivers/apple.js";
+export * from "./drivers/expo.js";
+export * from "./drivers/maestro.js";
+export * from "./drivers/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./cli.js";
+export * from "./config.js";
+export * from "./discovery.js";
+export * from "./events.js";
+export * from "./executor.js";
+export * from "./planning.js";
+export * from "./runtime.js";
+export * from "./safety.js";
+export * from "./spawn.js";
+export * from "./drivers/apple.js";
+export * from "./drivers/expo.js";
+export * from "./drivers/maestro.js";
+export * from "./drivers/types.js";

package/dist/planning.d.ts

@@ -0,0 +1,18 @@
+import type { MobileProjectContext } from "./discovery.js";
+export interface CommandPlan {
+    readonly args: readonly string[];
+    readonly command: string;
+    readonly cwd: string;
+    readonly name: string;
+    readonly optional?: boolean | undefined;
+}
+export interface PlanResult {
+    readonly commands: readonly CommandPlan[];
+    readonly notes: readonly string[];
+    readonly phase: string;
+    readonly status: "planned";
+}
+export declare function createIosRunPlan(context: MobileProjectContext): PlanResult;
+export declare function createMaestroPlan(context: MobileProjectContext): PlanResult;
+export declare function doctorChecks(context: MobileProjectContext): readonly CommandPlan[];
+//# sourceMappingURL=planning.d.ts.map

package/dist/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAgC1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CA2B3E;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,oBAAoB,GAC5B,SAAS,WAAW,EAAE,CAexB"}

package/dist/planning.js

@@ -0,0 +1,75 @@
+export function createIosRunPlan(context) {
+    return {
+        phase: "plan.run.ios",
+        status: "planned",
+        commands: [
+            {
+                name: "doctor preflight",
+                command: "pnpm",
+                args: ["--filter", context.mobilePackageName, "run", "doctor"],
+                cwd: context.repoRoot,
+                optional: true
+            },
+            {
+                name: "expo native project sync",
+                command: "pnpm",
+                args: ["--filter", context.mobilePackageName, "run", "prebuild"],
+                cwd: context.repoRoot,
+                optional: true
+            },
+            {
+                name: "run ios",
+                command: "pnpm",
+                args: ["--filter", context.mobilePackageName, "run", "ios"],
+                cwd: context.repoRoot
+            }
+        ],
+        notes: [
+            "This is a plan only; no command was executed.",
+            "The actual iOS run launches or focuses simulator processes and requires an explicit user request.",
+            "Run doctor/typecheck before launch when checking environment health."
+        ]
+    };
+}
+export function createMaestroPlan(context) {
+    const flows = context.maestroFlows.length === 0
+        ? [".maestro/smoke.yaml"]
+        : context.maestroFlows;
+    return {
+        phase: "plan.maestro",
+        status: "planned",
+        commands: flows.map((flow) => ({
+            name: context.maestroFlows.length === 0 ? "proposed maestro flow" : flow,
+            command: "maestro",
+            args: ["test", flow],
+            cwd: context.repoRoot,
+            optional: context.maestroFlows.length === 0
+        })),
+        notes: [
+            "This is a plan only; no Maestro flow was executed.",
+            "Maestro must be installed locally before execution; chofi does not install it.",
+            "Maestro Cloud is not required.",
+            ...(context.maestroFlows.length === 0
+                ? [
+                    "No .maestro/*.yaml flows were found; author .maestro/smoke.yaml before running the proposed command."
+                ]
+                : [])
+        ]
+    };
+}
+export function doctorChecks(context) {
+    return [
+        {
+            name: "expo-doctor",
+            command: "pnpm",
+            args: ["--filter", context.mobilePackageName, "run", "doctor"],
+            cwd: context.repoRoot
+        },
+        {
+            name: "typecheck",
+            command: "pnpm",
+            args: ["--filter", context.mobilePackageName, "run", "typecheck"],
+            cwd: context.repoRoot
+        }
+    ];
+}