@ceraph/react-native-mcp 0.3.3 → 0.4.6

package/dist/target.js

@@ -1,267 +0,0 @@
-import { spawn } from "node:child_process";
-function runCommand(cmd, args, opts = {}) {
-    return new Promise((resolve) => {
-        let stdout = "";
-        let stderr = "";
-        let child;
-        try {
-            child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
-        }
-        catch (err) {
-            resolve({
-                code: 127,
-                stdout: "",
-                stderr: err instanceof Error ? err.message : String(err),
-            });
-            return;
-        }
-        const timer = setTimeout(() => {
-            try {
-                child.kill("SIGKILL");
-            }
-            catch {
-            }
-        }, opts.timeoutMs ?? 8000);
-        child.stdout?.on("data", (d) => {
-            stdout += d.toString();
-        });
-        child.stderr?.on("data", (d) => {
-            stderr += d.toString();
-        });
-        let settled = false;
-        child.on("error", (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            resolve({
-                code: 127,
-                stdout,
-                stderr: stderr + (err.message ?? String(err)),
-            });
-        });
-        child.on("exit", (code) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            resolve({ code: code ?? 1, stdout, stderr });
-        });
-    });
-}
-export function preferenceFromEnv(raw) {
-    const v = (raw ?? "").trim().toLowerCase();
-    if (v === "device")
-        return "device";
-    if (v === "simulator" || v === "sim")
-        return "simulator";
-    return "auto";
-}
-export async function listBootedSimulators() {
-    const res = await runCommand("xcrun", [
-        "simctl",
-        "list",
-        "devices",
-        "booted",
-        "-j",
-    ]);
-    if (res.code !== 0)
-        return [];
-    try {
-        const parsed = JSON.parse(res.stdout);
-        const out = [];
-        const devices = parsed.devices ?? {};
-        for (const [runtimeKey, list] of Object.entries(devices)) {
-            const isIos = runtimeKey.toLowerCase().includes("ios") ||
-                runtimeKey.toLowerCase().includes("iphone");
-            if (!isIos)
-                continue;
-            if (!Array.isArray(list))
-                continue;
-            for (const dev of list) {
-                if (!dev.udid)
-                    continue;
-                if ((dev.state ?? "").toLowerCase() !== "booted")
-                    continue;
-                out.push({
-                    udid: dev.udid,
-                    name: dev.name ?? dev.udid,
-                    runtime: dev.runtime ?? runtimeKey,
-                });
-            }
-        }
-        return out;
-    }
-    catch {
-        return [];
-    }
-}
-export function parseWdaPort(stdout) {
-    const re = /ServerURLHere->https?:\/\/[^:/\s]+:(\d{2,5})<-ServerURLHere/;
-    const m = re.exec(stdout);
-    if (!m)
-        return null;
-    const port = Number(m[1]);
-    if (!Number.isFinite(port) || port < 1 || port > 65535)
-        return null;
-    return port;
-}
-export const DEFAULT_DEVICE_WDA_BASE_URL = "http://localhost:8100";
-export function simulatorWdaBaseUrl(port) {
-    return `http://localhost:${port}`;
-}
-export class TargetResolver {
-    apps;
-    readPreference;
-    cached = null;
-    cachedAt = 0;
-    cacheTtlMs;
-    inflight = null;
-    stateVersion = 0;
-    simulatorWdaPort = null;
-    simulatorWdaUdid = null;
-    constructor(opts = {}) {
-        this.apps = opts.apps ?? null;
-        this.readPreference = opts.readPreference ?? (() => preferenceFromEnv(process.env.CERAPH_TARGET));
-        this.cacheTtlMs = opts.cacheTtlMs ?? 5_000;
-    }
-    setAppLifecycle(apps) {
-        this.apps = apps;
-        this.cached = null;
-        this.stateVersion++;
-    }
-    setSimulatorWdaPort(port, udid) {
-        this.simulatorWdaPort = port;
-        this.simulatorWdaUdid = udid;
-        this.cached = null;
-        this.stateVersion++;
-    }
-    clearSimulatorWdaPort() {
-        this.simulatorWdaPort = null;
-        this.simulatorWdaUdid = null;
-        this.cached = null;
-        this.stateVersion++;
-    }
-    getSimulatorWdaPort() {
-        return this.simulatorWdaPort;
-    }
-    getSimulatorWdaUdid() {
-        return this.simulatorWdaUdid;
-    }
-    invalidate() {
-        this.cached = null;
-        this.stateVersion++;
-    }
-    async getBaseUrl() {
-        const info = await this.resolve();
-        return info.baseUrl;
-    }
-    async getTarget() {
-        const info = await this.resolve();
-        return info.target;
-    }
-    async resolve() {
-        if (this.cached &&
-            this.cacheTtlMs > 0 &&
-            Date.now() - this.cachedAt < this.cacheTtlMs) {
-            return this.cached;
-        }
-        if (this.inflight)
-            return this.inflight;
-        const versionAtStart = this.stateVersion;
-        const work = (async () => {
-            const pref = this.readPreference();
-            if (pref === "device") {
-                const udid = (await this.apps?.getUdid()) ?? null;
-                return {
-                    target: "device",
-                    udid,
-                    baseUrl: DEFAULT_DEVICE_WDA_BASE_URL,
-                    wdaReady: true,
-                    reason: "env-override-device",
-                };
-            }
-            if (pref === "simulator") {
-                const sims = await listBootedSimulators();
-                const picked = this.simulatorWdaUdid
-                    ? sims.find((s) => s.udid === this.simulatorWdaUdid) ?? sims[0]
-                    : sims[0];
-                const pickedUdid = picked?.udid ?? this.simulatorWdaUdid ?? null;
-                const wdaHostStillBooted = this.simulatorWdaUdid !== null &&
-                    sims.some((s) => s.udid === this.simulatorWdaUdid);
-                const portMatchesSim = this.simulatorWdaPort !== null &&
-                    this.simulatorWdaUdid !== null &&
-                    wdaHostStillBooted &&
-                    pickedUdid === this.simulatorWdaUdid;
-                return {
-                    target: "simulator",
-                    udid: pickedUdid,
-                    baseUrl: portMatchesSim
-                        ? simulatorWdaBaseUrl(this.simulatorWdaPort)
-                        : DEFAULT_DEVICE_WDA_BASE_URL,
-                    wdaReady: portMatchesSim,
-                    reason: "env-override-simulator",
-                };
-            }
-            const [deviceUdid, sims] = await Promise.all([
-                this.apps?.getUdid() ?? Promise.resolve(null),
-                listBootedSimulators(),
-            ]);
-            if (deviceUdid) {
-                return {
-                    target: "device",
-                    udid: deviceUdid,
-                    baseUrl: DEFAULT_DEVICE_WDA_BASE_URL,
-                    wdaReady: true,
-                    reason: "auto-prefer-device",
-                };
-            }
-            if (sims.length > 0) {
-                const picked = this.simulatorWdaUdid
-                    ? sims.find((s) => s.udid === this.simulatorWdaUdid) ?? sims[0]
-                    : sims[0];
-                const wdaHostStillBooted = this.simulatorWdaUdid !== null &&
-                    sims.some((s) => s.udid === this.simulatorWdaUdid);
-                const portMatchesSim = this.simulatorWdaPort !== null &&
-                    this.simulatorWdaUdid !== null &&
-                    wdaHostStillBooted &&
-                    picked.udid === this.simulatorWdaUdid;
-                return {
-                    target: "simulator",
-                    udid: picked.udid,
-                    baseUrl: portMatchesSim
-                        ? simulatorWdaBaseUrl(this.simulatorWdaPort)
-                        : DEFAULT_DEVICE_WDA_BASE_URL,
-                    wdaReady: portMatchesSim,
-                    reason: "auto-only-simulator",
-                };
-            }
-            return {
-                target: "device",
-                udid: null,
-                baseUrl: DEFAULT_DEVICE_WDA_BASE_URL,
-                wdaReady: true,
-                reason: "auto-no-target-found",
-            };
-        })();
-        this.inflight = work;
-        try {
-            const info = await work;
-            if (this.stateVersion === versionAtStart) {
-                this.cached = info;
-                this.cachedAt = Date.now();
-            }
-            return info;
-        }
-        finally {
-            this.inflight = null;
-        }
-    }
-    reset() {
-        this.cached = null;
-        this.inflight = null;
-        this.simulatorWdaPort = null;
-        this.simulatorWdaUdid = null;
-        this.stateVersion++;
-    }
-}

package/dist/uninstall/cli-runner.d.ts

@@ -1,32 +0,0 @@
-import { type PromptDeps } from "../init/prompt.js";
-import { type UninstallStep, type UninstallWalkthroughResult } from "./walkthrough.js";
-export interface CliRunnerOpts extends PromptDeps {
-    argv: string[];
-    cwd?: string;
-    spawnRemove?: (input: {
-        bin: string;
-        args: string[];
-        cwd: string;
-    }) => Promise<{
-        exitCode: number;
-    }>;
-}
-export interface CliRunnerResult {
-    exitCode: 0 | 1;
-    walkthrough: UninstallWalkthroughResult | null;
-    parsedFlags: ParsedFlags;
-}
-interface ParsedFlags {
-    yes: boolean;
-    purgeImages: boolean;
-    global: boolean;
-    dryRun: boolean;
-    projectDir: string | null;
-    help: boolean;
-    unknown: string[];
-}
-export declare function runUninstallCli(opts: CliRunnerOpts): Promise<CliRunnerResult>;
-export declare function formatStepLine(step: UninstallStep): string;
-export declare function formatSummary(result: UninstallWalkthroughResult): string;
-export declare function parseArgs(argv: string[]): ParsedFlags;
-export {};

package/dist/uninstall/cli-runner.js

@@ -1,223 +0,0 @@
-import { spawn } from "node:child_process";
-import { stat } from "node:fs/promises";
-import { join } from "node:path";
-import { confirm, print } from "../init/prompt.js";
-import { runUninstallWalkthrough, } from "./walkthrough.js";
-const USAGE = `Usage: npx @ceraph/react-native-mcp uninstall [flags]
-
-Removes Ceraph from the current React Native / Expo project. By default:
-- Reverts source-tree edits (CameraView, layout boot, ceraph URL scheme)
-- Strips MCP client configs (.mcp.json, .cursor/, .vscode/, .codex/)
-- Removes gitignore entries
-- Removes CERAPH_SIGNAL_HOST from your shell rc
-- Removes @ceraph/react-native-mcp from package.json
-- LEAVES .ceraph/ (test images, design snapshots) in place
-- LEAVES ~/.ceraph/auth.json in place (token is user-global)
-
-Flags:
-  -y, --yes              Skip confirmation prompts.
-      --purge-images     Also delete .ceraph/ (camera images + snapshots).
-      --global           Also delete ~/.ceraph/auth.json (logs you out of
-                         every Ceraph install on this machine).
-      --dry-run          Preview the revert without mutating anything.
-      --project-dir <p>  Operate on this subpackage. Required when a
-                         monorepo has more than one RN app.
-  -h, --help             Print this help and exit.
-`;
-export async function runUninstallCli(opts) {
-    const flags = parseArgs(opts.argv);
-    if (flags.help) {
-        print(USAGE, opts);
-        return { exitCode: 0, walkthrough: null, parsedFlags: flags };
-    }
-    if (flags.unknown.length > 0) {
-        print(`Unknown flag(s): ${flags.unknown.join(", ")}\n\n${USAGE}`, opts);
-        return { exitCode: 1, walkthrough: null, parsedFlags: flags };
-    }
-    const projectDir = flags.projectDir ?? opts.cwd ?? process.cwd();
-    if (flags.projectDir != null) {
-        const validation = await validateProjectDir(flags.projectDir);
-        if (validation !== null) {
-            print(`${validation}\n`, opts);
-            return { exitCode: 1, walkthrough: null, parsedFlags: flags };
-        }
-    }
-    let purgeImages = flags.purgeImages;
-    let global = flags.global;
-    if (!flags.yes && !flags.dryRun) {
-        print(`\n@ceraph/react-native-mcp uninstall\n`, opts);
-        print(`  Project: ${projectDir}\n`, opts);
-        print(`  Mode:    live (no --dry-run)\n`, opts);
-        print(`  Default-safe: leaves .ceraph/ and ~/.ceraph/auth.json untouched.\n\n`, opts);
-        const proceed = await confirm("Continue with uninstall?", {
-            ...opts,
-            defaultYes: false,
-        });
-        if (!proceed) {
-            print(`\nAborted — no changes made.\n`, opts);
-            return { exitCode: 0, walkthrough: null, parsedFlags: flags };
-        }
-        if (!purgeImages) {
-            purgeImages = await confirm("Also purge camera images + snapshots at .ceraph/?", { ...opts, defaultYes: false });
-        }
-        if (!global) {
-            global = await confirm("Also sign out (delete ~/.ceraph/auth.json)?", { ...opts, defaultYes: false });
-        }
-    }
-    if (flags.dryRun) {
-        print(`\n@ceraph/react-native-mcp uninstall — dry-run preview\n`, opts);
-        print(`  Project: ${projectDir}\n\n`, opts);
-    }
-    const walkthrough = await runUninstallWalkthrough({
-        projectDir,
-        purgeImages,
-        global,
-        dryRun: flags.dryRun,
-        nonInteractive: flags.yes,
-        spawnRemove: opts.spawnRemove ?? defaultSpawnRemove,
-        onStep: (step) => {
-            print(formatStepLine(step), opts);
-        },
-    });
-    print(formatSummary(walkthrough), opts);
-    const hasError = walkthrough.steps.some((s) => s.status === "error" || s.status === "manual");
-    return {
-        exitCode: hasError ? 1 : 0,
-        walkthrough,
-        parsedFlags: { ...flags, purgeImages, global },
-    };
-}
-export function formatStepLine(step) {
-    const icon = iconFor(step.status);
-    const summary = summaryFor(step);
-    return `  ${icon} ${step.name.padEnd(13)} ${summary}\n`;
-}
-function iconFor(status) {
-    switch (status) {
-        case "reverted":
-            return "[ok]";
-        case "already-reverted":
-            return "[--]";
-        case "skipped":
-            return "[--]";
-        case "warning":
-            return "[!]";
-        case "manual":
-            return "[!]";
-        case "error":
-            return "[X]";
-    }
-}
-function summaryFor(step) {
-    switch (step.status) {
-        case "reverted":
-            return `reverted${step.details?.dryRun ? " (preview)" : ""}`;
-        case "already-reverted":
-            return `nothing to do${step.details?.dryRun ? " (preview)" : ""}`;
-        case "skipped":
-            return `skipped — ${step.remediation ?? "gate closed"}`;
-        case "warning":
-            return `reverted with warning — ${step.remediation ?? ""}`;
-        case "manual":
-            return `manual action required — ${step.remediation ?? ""}`;
-        case "error":
-            return `error — ${step.remediation ?? step.details?.error ?? "see details"}`;
-    }
-}
-export function formatSummary(result) {
-    const { reverted, skipped, warnings, manualSteps } = result.summary;
-    const lines = ["\nSummary:\n"];
-    lines.push(`  Reverted:        ${reverted}\n`);
-    lines.push(`  Skipped/no-op:   ${skipped}\n`);
-    lines.push(`  Warnings:        ${warnings.length}\n`);
-    lines.push(`  Manual actions:  ${manualSteps.length}\n`);
-    if (warnings.length > 0) {
-        lines.push(`\nWarnings:\n`);
-        for (const w of warnings)
-            lines.push(`  - ${w}\n`);
-    }
-    if (manualSteps.length > 0) {
-        lines.push(`\nManual actions needed:\n`);
-        for (const m of manualSteps)
-            lines.push(`  - ${m}\n`);
-    }
-    return lines.join("");
-}
-export function parseArgs(argv) {
-    const flags = {
-        yes: false,
-        purgeImages: false,
-        global: false,
-        dryRun: false,
-        projectDir: null,
-        help: false,
-        unknown: [],
-    };
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        switch (arg) {
-            case "-y":
-            case "--yes":
-                flags.yes = true;
-                break;
-            case "--purge-images":
-                flags.purgeImages = true;
-                break;
-            case "--global":
-                flags.global = true;
-                break;
-            case "--dry-run":
-                flags.dryRun = true;
-                break;
-            case "--project-dir": {
-                const next = argv[i + 1];
-                if (next == null) {
-                    flags.unknown.push(`${arg} (missing value)`);
-                }
-                else {
-                    flags.projectDir = next;
-                    i++;
-                }
-                break;
-            }
-            case "-h":
-            case "--help":
-                flags.help = true;
-                break;
-            default:
-                if (arg !== undefined)
-                    flags.unknown.push(arg);
-        }
-    }
-    return flags;
-}
-async function validateProjectDir(path) {
-    let entryStat;
-    try {
-        entryStat = await stat(path);
-    }
-    catch {
-        return `Error: --project-dir does not exist: ${path}`;
-    }
-    if (!entryStat.isDirectory()) {
-        return `Error: --project-dir is not a directory: ${path}`;
-    }
-    try {
-        await stat(join(path, "package.json"));
-    }
-    catch {
-        return (`Error: --project-dir does not look like an npm/RN project ` +
-            `(no package.json at ${join(path, "package.json")})`);
-    }
-    return null;
-}
-function defaultSpawnRemove(input) {
-    return new Promise((resolve) => {
-        const child = spawn(input.bin, input.args, {
-            cwd: input.cwd,
-            stdio: "inherit",
-        });
-        child.on("error", () => resolve({ exitCode: 127 }));
-        child.on("exit", (code) => resolve({ exitCode: code ?? 1 }));
-    });
-}

package/dist/uninstall/footprint.d.ts

@@ -1,40 +0,0 @@
-import { detectMonorepoSubpackages } from "../init/monorepo.js";
-import { type PackageManager } from "./revert-package.js";
-export interface InstalledFootprint {
-    workingDir: string;
-    monorepoConflict: {
-        matches: Array<{
-            relPath: string;
-            absPath: string;
-        }>;
-    } | null;
-    packageInstalled: boolean;
-    packageManager: PackageManager;
-    appiumPresent: boolean;
-    gitignoreEntriesPresent: boolean;
-    gitignoreEntries: string[];
-    schemeRegistered: boolean | null;
-    bootTargetPath: string | null;
-    bootInjected: boolean | null;
-    ceraphCameraUsageCount: number;
-    mcpClientsConfigured: {
-        claudeCode: boolean;
-        cursor: boolean;
-        codex: boolean;
-        vscode: boolean;
-        windsurf: boolean;
-        antigravity: boolean;
-    };
-    claudeHooksPresent: {
-        errorScript: boolean;
-        flowProgressScript: boolean;
-        settingsEntries: boolean;
-    };
-    ceraphDirPresent: boolean;
-    authPresent: boolean;
-}
-export interface FootprintDeps {
-    homeDir?: () => string;
-    detectMonorepo?: typeof detectMonorepoSubpackages;
-}
-export declare function getInstalledFootprint(projectDir: string, deps?: FootprintDeps): Promise<InstalledFootprint>;