@ceraph/react-native-mcp 0.3.3 → 0.4.6

package/dist/uninstall/footprint.js

@@ -1,288 +0,0 @@
-import { access, readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { detectMonorepoSubpackages } from "../init/monorepo.js";
-import { detectPackageManager, } from "./revert-package.js";
-import { detectRevertTarget } from "./revert-boot.js";
-import { userGlobalMcpClientPaths } from "./revert-mcp-clients.js";
-import { CLAUDE_SETTINGS_REL_PATHS, ERROR_HOOK_COMMAND, ERROR_HOOK_MATCHER, ERROR_HOOK_REL_PATH, FLOW_PROGRESS_HOOK_COMMAND, FLOW_PROGRESS_HOOK_MATCHER, FLOW_PROGRESS_HOOK_REL_PATH, } from "../init/claude-hook-constants.js";
-async function fileExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function readPackageJson(projectDir) {
-    try {
-        const raw = await readFile(join(projectDir, "package.json"), "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-async function detectGitignoreEntries(projectDir) {
-    const path = join(projectDir, ".gitignore");
-    let content;
-    try {
-        content = await readFile(path, "utf-8");
-    }
-    catch {
-        return [];
-    }
-    const TARGETS = [
-        ".rn-errors.json",
-        ".rn-flow-progress.json",
-        ".rn-mcp-cache/",
-        ".rn-mcp-cache",
-    ];
-    return TARGETS.filter((t) => content.split(/\r?\n/).some((line) => line.trim() === t));
-}
-async function detectSchemeRegistered(projectDir) {
-    const appJsonPath = join(projectDir, "app.json");
-    let raw;
-    try {
-        raw = await readFile(appJsonPath, "utf-8");
-    }
-    catch {
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-    const scheme = parsed.expo?.scheme;
-    if (typeof scheme === "string")
-        return scheme === "ceraph";
-    if (Array.isArray(scheme))
-        return scheme.includes("ceraph");
-    return false;
-}
-async function countCeraphCameraUsages(projectDir) {
-    const SCAN_ROOTS = ["app", "src", "screens"];
-    const SCAN_EXT = new Set([".tsx", ".jsx"]);
-    const SKIP_DIRS = new Set([
-        "node_modules",
-        "dist",
-        "build",
-        ".git",
-        ".ceraph",
-        ".rn-mcp-cache",
-        ".expo",
-        ".next",
-        "ios",
-        "android",
-    ]);
-    let count = 0;
-    const walk = async (dir) => {
-        let entries;
-        try {
-            const { readdir } = await import("node:fs/promises");
-            entries = await readdir(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            if (entry.isDirectory()) {
-                if (SKIP_DIRS.has(entry.name))
-                    continue;
-                await walk(join(dir, entry.name));
-                continue;
-            }
-            if (!entry.isFile())
-                continue;
-            const dot = entry.name.lastIndexOf(".");
-            if (dot < 0)
-                continue;
-            const ext = entry.name.slice(dot).toLowerCase();
-            if (!SCAN_EXT.has(ext))
-                continue;
-            try {
-                const raw = await readFile(join(dir, entry.name), "utf-8");
-                const matches = raw.match(/<CeraphCamera/g);
-                if (matches)
-                    count += matches.length;
-            }
-            catch {
-            }
-        }
-    };
-    for (const root of SCAN_ROOTS) {
-        await walk(join(projectDir, root));
-    }
-    for (const single of ["App.tsx", "App.jsx"]) {
-        try {
-            const raw = await readFile(join(projectDir, single), "utf-8");
-            const matches = raw.match(/<CeraphCamera/g);
-            if (matches)
-                count += matches.length;
-        }
-        catch {
-        }
-    }
-    return count;
-}
-async function detectMcpClientConfigured(projectDir, home) {
-    const hasEntry = async (path, kind) => {
-        try {
-            const raw = await readFile(path, "utf-8");
-            if (kind === "json") {
-                const parsed = JSON.parse(raw);
-                const servers = parsed.mcpServers ?? {};
-                return Boolean(servers["react-native-mcp"] || servers["mobile-mcp"]);
-            }
-            return (raw.includes("[mcp_servers.react-native-mcp]") ||
-                raw.includes("[mcp_servers.mobile-mcp]"));
-        }
-        catch {
-            return false;
-        }
-    };
-    const globals = userGlobalMcpClientPaths(home || undefined);
-    const byLabel = {};
-    for (const g of globals)
-        byLabel[g.label] = g.path;
-    return {
-        claudeCode: await hasEntry(join(projectDir, ".mcp.json"), "json"),
-        cursor: await hasEntry(join(projectDir, ".cursor", "mcp.json"), "json"),
-        codex: await hasEntry(join(projectDir, ".codex", "config.toml"), "toml"),
-        vscode: await hasEntry(join(projectDir, ".vscode", "mcp.json"), "json"),
-        windsurf: home
-            ? await hasEntry(byLabel.Windsurf ?? "", "json")
-            : false,
-        antigravity: home
-            ? await hasEntry(byLabel.Antigravity ?? "", "json")
-            : false,
-    };
-}
-async function detectClaudeHooksPresent(projectDir) {
-    const errorScript = await fileExists(join(projectDir, ...ERROR_HOOK_REL_PATH));
-    const flowProgressScript = await fileExists(join(projectDir, ...FLOW_PROGRESS_HOOK_REL_PATH));
-    let settingsEntries = false;
-    for (const relParts of CLAUDE_SETTINGS_REL_PATHS) {
-        const abs = join(projectDir, ...relParts);
-        let raw;
-        try {
-            raw = await readFile(abs, "utf-8");
-        }
-        catch {
-            continue;
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            continue;
-        }
-        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-            continue;
-        const hooks = parsed.hooks;
-        if (!hooks || typeof hooks !== "object" || Array.isArray(hooks))
-            continue;
-        const fc = hooks.FileChanged;
-        if (!Array.isArray(fc))
-            continue;
-        for (const entry of fc) {
-            if (!entry || typeof entry !== "object" || Array.isArray(entry))
-                continue;
-            const e = entry;
-            const matcher = e.matcher;
-            if (matcher !== ERROR_HOOK_MATCHER && matcher !== FLOW_PROGRESS_HOOK_MATCHER) {
-                continue;
-            }
-            const ourCommand = matcher === ERROR_HOOK_MATCHER
-                ? ERROR_HOOK_COMMAND
-                : FLOW_PROGRESS_HOOK_COMMAND;
-            const list = e.hooks;
-            if (!Array.isArray(list))
-                continue;
-            for (const raw2 of list) {
-                if (!raw2 || typeof raw2 !== "object" || Array.isArray(raw2))
-                    continue;
-                const cmd = raw2.command;
-                if (typeof cmd === "string" && cmd === ourCommand) {
-                    settingsEntries = true;
-                    break;
-                }
-            }
-            if (settingsEntries)
-                break;
-        }
-        if (settingsEntries)
-            break;
-    }
-    return { errorScript, flowProgressScript, settingsEntries };
-}
-export async function getInstalledFootprint(projectDir, deps = {}) {
-    const detect = deps.detectMonorepo ?? detectMonorepoSubpackages;
-    const detection = await detect(projectDir);
-    let workingDir = projectDir;
-    let monorepoConflict = null;
-    if (detection.kind === "single" && detection.matches[0]) {
-        workingDir = detection.matches[0].absPath;
-    }
-    else if (detection.kind === "multi") {
-        monorepoConflict = {
-            matches: detection.matches.map((m) => ({
-                relPath: m.relPath,
-                absPath: m.absPath,
-            })),
-        };
-    }
-    const home = deps.homeDir?.() ??
-        process.env.HOME ??
-        process.env.USERPROFILE ??
-        "";
-    const pkg = await readPackageJson(workingDir);
-    const allDeps = {
-        ...(pkg?.dependencies ?? {}),
-        ...(pkg?.devDependencies ?? {}),
-    };
-    const packageInstalled = Boolean(allDeps["@ceraph/react-native-mcp"]);
-    const appiumPresent = Boolean(allDeps["appium-webdriveragent"]);
-    const packageManager = await detectPackageManager(workingDir);
-    const gitignoreEntries = await detectGitignoreEntries(workingDir);
-    const schemeRegistered = await detectSchemeRegistered(workingDir);
-    const bootTarget = await detectRevertTarget(workingDir);
-    let bootInjected = null;
-    if (bootTarget) {
-        try {
-            const raw = await readFile(bootTarget.filePath, "utf-8");
-            bootInjected = raw.includes("installCeraph(");
-        }
-        catch {
-            bootInjected = null;
-        }
-    }
-    const ceraphCameraUsageCount = await countCeraphCameraUsages(workingDir);
-    const mcpClientsConfigured = await detectMcpClientConfigured(workingDir, home);
-    const claudeHooksPresent = await detectClaudeHooksPresent(workingDir);
-    const ceraphDirPresent = await fileExists(join(workingDir, ".ceraph"));
-    const authPresent = home
-        ? await fileExists(join(home, ".ceraph", "auth.json"))
-        : false;
-    return {
-        workingDir,
-        monorepoConflict,
-        packageInstalled,
-        packageManager,
-        appiumPresent,
-        gitignoreEntriesPresent: gitignoreEntries.length > 0,
-        gitignoreEntries,
-        schemeRegistered,
-        bootTargetPath: bootTarget?.filePath ?? null,
-        bootInjected,
-        ceraphCameraUsageCount,
-        mcpClientsConfigured,
-        claudeHooksPresent,
-        ceraphDirPresent,
-        authPresent,
-    };
-}

package/dist/uninstall/mcp-tools.d.ts

@@ -1,14 +0,0 @@
-import { z } from "zod";
-import { type UninstallWalkthroughResult } from "./walkthrough.js";
-interface RegisterServer {
-    tool: (name: string, description: string, schema: Record<string, z.ZodTypeAny>, handler: (args: Record<string, unknown>) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError?: true;
-    }>) => void;
-}
-export declare function compactWalkthroughResult(result: UninstallWalkthroughResult, maxBytes?: number): UninstallWalkthroughResult;
-export declare function registerUninstallTools(server: RegisterServer): void;
-export {};

package/dist/uninstall/mcp-tools.js

@@ -1,175 +0,0 @@
-import { spawn } from "node:child_process";
-import { z } from "zod";
-import { getInstalledFootprint } from "./footprint.js";
-import { runUninstallWalkthrough, } from "./walkthrough.js";
-const MAX_TOOL_PAYLOAD_BYTES = 64 * 1024;
-const MODULE_LOAD_CWD = process.cwd();
-function defaultCwd() {
-    return MODULE_LOAD_CWD;
-}
-function toolResult(payload) {
-    return {
-        content: [
-            { type: "text", text: JSON.stringify(payload, null, 2) },
-        ],
-    };
-}
-const MAX_STRING_FIELD_BYTES = 2 * 1024;
-function truncateString(s, max) {
-    if (s.length <= max)
-        return s;
-    const head = s.slice(0, Math.floor(max / 2) - 16);
-    const tail = s.slice(s.length - (Math.floor(max / 2) - 16));
-    return `${head} … <${s.length - max} bytes truncated> … ${tail}`;
-}
-export function compactWalkthroughResult(result, maxBytes = MAX_TOOL_PAYLOAD_BYTES) {
-    const full = JSON.stringify(result, null, 2);
-    if (full.length <= maxBytes)
-        return result;
-    const compactSteps = result.steps.map((step) => {
-        if (step.details === undefined)
-            return step;
-        const detailsJson = JSON.stringify(step.details);
-        return {
-            ...step,
-            details: {
-                truncated: true,
-                originalSize: detailsJson.length,
-            },
-        };
-    });
-    const afterPass1 = {
-        ...result,
-        steps: compactSteps,
-    };
-    const pass1Json = JSON.stringify(afterPass1, null, 2);
-    if (pass1Json.length <= maxBytes)
-        return afterPass1;
-    let lo = 32;
-    let hi = MAX_STRING_FIELD_BYTES;
-    let best = afterPass1;
-    while (lo <= hi) {
-        const mid = Math.floor((lo + hi) / 2);
-        const candidate = {
-            ...afterPass1,
-            workingDir: truncateString(afterPass1.workingDir, mid),
-            steps: afterPass1.steps.map((step) => ({
-                ...step,
-                remediation: step.remediation
-                    ? truncateString(step.remediation, mid)
-                    : step.remediation,
-            })),
-            summary: {
-                ...afterPass1.summary,
-                warnings: afterPass1.summary.warnings.map((w) => truncateString(w, mid)),
-                manualSteps: afterPass1.summary.manualSteps.map((m) => truncateString(m, mid)),
-            },
-        };
-        const size = JSON.stringify(candidate, null, 2).length;
-        if (size <= maxBytes) {
-            best = candidate;
-            lo = mid + 1;
-        }
-        else {
-            hi = mid - 1;
-        }
-    }
-    return best;
-}
-function toolError(toolName, err) {
-    return {
-        content: [
-            {
-                type: "text",
-                text: `${toolName} failed: ${err instanceof Error ? err.message : String(err)}`,
-            },
-        ],
-        isError: true,
-    };
-}
-function bufferedSpawnRemove(input) {
-    return new Promise((resolve) => {
-        const child = spawn(input.bin, input.args, {
-            cwd: input.cwd,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        child.stdout?.on("data", () => undefined);
-        child.stderr?.on("data", () => undefined);
-        child.on("error", () => resolve({ exitCode: 127 }));
-        child.on("exit", (code) => resolve({ exitCode: code ?? 1 }));
-    });
-}
-export function registerUninstallTools(server) {
-    server.tool("ceraph_uninstall_status", "Snapshot what Ceraph has installed in this project — package " +
-        "presence, gitignore entries, MCP-client configs, root-layout " +
-        "boot wiring, <CeraphCamera> usage count, and whether the user-" +
-        "global auth token is present. Use this BEFORE ceraph_uninstall_run " +
-        "to show the user what would change. Returns the footprint without " +
-        "mutating anything.", {
-        projectDir: z
-            .string()
-            .optional()
-            .describe("Project directory to inspect. Defaults to the MCP server's " +
-            "cwd. In a monorepo with multiple RN subpackages, the tool " +
-            "returns `monorepoConflict` listing each candidate — pass " +
-            "the chosen subpackage's path here to disambiguate."),
-    }, async (args) => {
-        try {
-            const projectDir = args.projectDir ?? defaultCwd();
-            const footprint = await getInstalledFootprint(projectDir);
-            return toolResult(footprint);
-        }
-        catch (err) {
-            return toolError("ceraph_uninstall_status", err);
-        }
-    });
-    server.tool("ceraph_uninstall_run", "Uninstall Ceraph from this project. Reverts source-tree edits " +
-        "(<CeraphCamera> → <CameraView>, installCeraph() boot wiring, " +
-        "ceraph URL scheme), strips MCP client configs, removes gitignore " +
-        "entries + the shell signal-host export, and uninstalls the " +
-        "package via the project's package manager. Default leaves " +
-        "`.ceraph/` (test images + snapshots) and `~/.ceraph/auth.json` " +
-        "(user-global OAuth token) untouched. Pass `purgeImages` and " +
-        "`global` to nuke those too. Always call with `dryRun: true` " +
-        "first to preview the step list before a real run.", {
-        projectDir: z
-            .string()
-            .optional()
-            .describe("Project directory to operate on. Defaults to the MCP " +
-            "server's cwd. Required to disambiguate monorepo " +
-            "multi-match."),
-        purgeImages: z
-            .boolean()
-            .optional()
-            .describe("If true, also delete `.ceraph/` (camera test images + " +
-            "design snapshots + run artifacts). Default false."),
-        global: z
-            .boolean()
-            .optional()
-            .describe("If true, also delete `~/.ceraph/auth.json` (the user-global " +
-            "OAuth token; this logs the user out of every Ceraph " +
-            "install on this machine). Default false."),
-        dryRun: z
-            .boolean()
-            .optional()
-            .describe("If true, return the step list as a preview without " +
-            "mutating anything. Use this first to show the user what " +
-            "would happen."),
-    }, async (args) => {
-        try {
-            const projectDir = args.projectDir ?? defaultCwd();
-            const result = await runUninstallWalkthrough({
-                projectDir,
-                purgeImages: args.purgeImages === true,
-                global: args.global === true,
-                dryRun: args.dryRun === true,
-                nonInteractive: true,
-                spawnRemove: bufferedSpawnRemove,
-            });
-            return toolResult(compactWalkthroughResult(result));
-        }
-        catch (err) {
-            return toolError("ceraph_uninstall_run", err);
-        }
-    });
-}

package/dist/uninstall/revert-auth.d.ts

@@ -1,22 +0,0 @@
-export type RevertAuthResult = {
-    status: "skipped";
-    path: string;
-    note: string;
-} | {
-    status: "deleted";
-    path: string;
-} | {
-    status: "already-reverted";
-    path: string;
-};
-export interface RevertAuthInput {
-    global: boolean;
-}
-export interface RevertAuthDeps {
-    unlink?: (p: string) => Promise<void>;
-    home?: string;
-}
-export declare function authJsonPath(deps?: {
-    home?: string;
-}): string;
-export declare function revertAuth(input: RevertAuthInput, deps?: RevertAuthDeps): Promise<RevertAuthResult>;

package/dist/uninstall/revert-auth.js

@@ -1,31 +0,0 @@
-import { unlink } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-export function authJsonPath(deps = {}) {
-    return join(deps.home ?? homedir(), ".ceraph", "auth.json");
-}
-export async function revertAuth(input, deps = {}) {
-    const path = authJsonPath({ home: deps.home });
-    const unlinkFn = deps.unlink ?? ((p) => unlink(p));
-    if (!input.global) {
-        return {
-            status: "skipped",
-            path,
-            note: "Pass global: true to remove ~/.ceraph/auth.json — the token is user-global and removing it logs you out of every Ceraph install.",
-        };
-    }
-    try {
-        await unlinkFn(path);
-        return { status: "deleted", path };
-    }
-    catch (err) {
-        const isMissing = typeof err === "object" &&
-            err !== null &&
-            "code" in err &&
-            err.code === "ENOENT";
-        if (isMissing) {
-            return { status: "already-reverted", path };
-        }
-        throw err;
-    }
-}

package/dist/uninstall/revert-boot.d.ts

@@ -1,24 +0,0 @@
-export type RevertBootTarget = {
-    kind: "expo-router";
-    filePath: string;
-} | {
-    kind: "bare-rn";
-    filePath: string;
-};
-export type RevertBootResult = {
-    status: "reverted";
-    target: RevertBootTarget;
-    removedUseEffect: boolean;
-    removedImport: boolean;
-} | {
-    status: "already-reverted";
-    target: RevertBootTarget;
-} | {
-    status: "skipped";
-    target: RevertBootTarget;
-    reason: string;
-} | {
-    status: "no-layout-found";
-};
-export declare function detectRevertTarget(projectDir: string): Promise<RevertBootTarget | null>;
-export declare function revertBoot(projectDir: string): Promise<RevertBootResult>;