@ceraph/react-native-mcp 0.3.3 → 0.4.5

package/dist/init/url-scheme.js

@@ -1,187 +0,0 @@
-import { readFile, writeFile, access } from "node:fs/promises";
-import { join } from "node:path";
-export const CERAPH_SCHEME = "ceraph";
-async function defaultExists(p) {
-    try {
-        await access(p);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function ensureCeraphUrlScheme(projectDir, deps = {}) {
-    const exists = deps.fileExists ?? defaultExists;
-    const read = deps.readFile ?? ((p) => readFile(p, "utf-8"));
-    const write = deps.writeFile ?? ((p, c) => writeFile(p, c, "utf-8"));
-    const appJsonPath = join(projectDir, "app.json");
-    const appConfigJs = join(projectDir, "app.config.js");
-    const appConfigTs = join(projectDir, "app.config.ts");
-    const iosDir = join(projectDir, "ios");
-    const androidDir = join(projectDir, "android");
-    const hasAppConfigJs = await exists(appConfigJs);
-    const hasAppConfigTs = await exists(appConfigTs);
-    if (hasAppConfigJs || hasAppConfigTs) {
-        return {
-            kind: "expo-config-needs-manual",
-            path: hasAppConfigTs ? appConfigTs : appConfigJs,
-        };
-    }
-    if (await exists(appJsonPath)) {
-        const raw = await read(appJsonPath);
-        const parsed = parseAppJson(raw);
-        if (!parsed.ok) {
-            return { kind: "expo-config-needs-manual", path: appJsonPath };
-        }
-        const result = injectSchemeIntoAppJson(parsed.parsed, CERAPH_SCHEME);
-        if (result.action === "already") {
-            return {
-                kind: "expo-json-already-registered",
-                scheme: result.scheme,
-                path: appJsonPath,
-            };
-        }
-        await write(appJsonPath, serialiseAppJson(parsed.parsed, raw));
-        return {
-            kind: "expo-json-added",
-            previousScheme: result.previousScheme,
-            nextScheme: result.nextScheme,
-            path: appJsonPath,
-        };
-    }
-    if ((await exists(iosDir)) || (await exists(androidDir))) {
-        return { kind: "bare-rn-needs-manual" };
-    }
-    return { kind: "no-rn-project" };
-}
-function parseAppJson(raw) {
-    try {
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-            return { ok: false, parsed: {} };
-        }
-        return { ok: true, parsed: parsed };
-    }
-    catch {
-        return { ok: false, parsed: {} };
-    }
-}
-function serialiseAppJson(parsed, original) {
-    const indentMatch = original.match(/\n(\s+)"/);
-    const indent = indentMatch?.[1] ?? "  ";
-    const hadTrailingNewline = original.endsWith("\n");
-    const output = JSON.stringify(parsed, null, indent);
-    return hadTrailingNewline ? output + "\n" : output;
-}
-export function injectSchemeIntoAppJson(parsed, schemeToAdd) {
-    if (!parsed.expo || typeof parsed.expo !== "object") {
-        parsed.expo = {};
-    }
-    const expo = parsed.expo;
-    const current = expo.scheme;
-    if (typeof current === "string" && current === schemeToAdd) {
-        return {
-            action: "already",
-            scheme: current,
-            previousScheme: current,
-            nextScheme: [current],
-        };
-    }
-    if (Array.isArray(current) && current.includes(schemeToAdd)) {
-        return {
-            action: "already",
-            scheme: current,
-            previousScheme: current,
-            nextScheme: [...current],
-        };
-    }
-    if (current === undefined) {
-        expo.scheme = schemeToAdd;
-        return {
-            action: "added",
-            scheme: schemeToAdd,
-            previousScheme: undefined,
-            nextScheme: [schemeToAdd],
-        };
-    }
-    if (typeof current === "string") {
-        const next = [current, schemeToAdd];
-        expo.scheme = next;
-        return {
-            action: "added",
-            scheme: next,
-            previousScheme: current,
-            nextScheme: next,
-        };
-    }
-    if (Array.isArray(current)) {
-        const next = [...current, schemeToAdd];
-        expo.scheme = next;
-        return {
-            action: "added",
-            scheme: next,
-            previousScheme: current,
-            nextScheme: next,
-        };
-    }
-    expo.scheme = schemeToAdd;
-    return {
-        action: "added",
-        scheme: schemeToAdd,
-        previousScheme: current,
-        nextScheme: [schemeToAdd],
-    };
-}
-export function bareRnInstructions() {
-    return `
-Add Ceraph's custom URL scheme so deep links (ceraph://test-image,
-ceraph://reload, ceraph://reset) reach the running app.
-
-iOS — edit ios/<YourApp>/Info.plist:
-
-  <key>CFBundleURLTypes</key>
-  <array>
-    <dict>
-      <key>CFBundleURLName</key>
-      <string>com.yourcompany.yourapp</string>
-      <key>CFBundleURLSchemes</key>
-      <array>
-        <string>ceraph</string>
-      </array>
-    </dict>
-  </array>
-
-Android — edit android/app/src/main/AndroidManifest.xml inside the
-MainActivity <activity> block:
-
-  <intent-filter>
-    <action android:name="android.intent.action.VIEW" />
-    <category android:name="android.intent.category.DEFAULT" />
-    <category android:name="android.intent.category.BROWSABLE" />
-    <data android:scheme="ceraph" />
-  </intent-filter>
-
-Then rebuild the native app (pod install + xcodebuild on iOS, ./gradlew
-assembleDebug on Android). Existing JS-only reloads do not pick up
-native config changes.
-`.trimStart();
-}
-export function expoDynamicConfigInstructions(configPath) {
-    return `
-Your project uses ${configPath} (dynamic Expo config) — we can't
-safely auto-edit a JS/TS file. Add Ceraph's URL scheme manually:
-
-  export default ({ config }) => ({
-    ...config,
-    scheme: Array.isArray(config.scheme)
-      ? [...config.scheme, "ceraph"]
-      : config.scheme
-        ? [config.scheme, "ceraph"]
-        : "ceraph",
-    // ... rest of your expo config
-  });
-
-Then re-run \`expo prebuild --clean\` if you've ejected, or just
-restart the dev client.
-`.trimStart();
-}

package/dist/init/walkthrough.d.ts

@@ -1,76 +0,0 @@
-import { type PackageManager } from "./package-manager.js";
-import { type StoredAuth } from "./oauth.js";
-import { type RootComponentTarget } from "./ast-layout.js";
-import { type PromptDeps } from "./prompt.js";
-import { type MonorepoDetectionResult } from "./monorepo.js";
-import { type SchemeAction } from "./url-scheme.js";
-import { type LanIpCandidate } from "./lan-ip.js";
-import { type WriteSignalHostEnvResult } from "./shell-profile.js";
-export interface WalkthroughDeps extends PromptDeps {
-    agentMode?: boolean;
-    installPackage?: (input: {
-        bin: string;
-        args: string[];
-        cwd: string;
-    }) => Promise<{
-        exitCode: number;
-    }>;
-    authenticate?: () => Promise<StoredAuth>;
-    loadAuth?: () => Promise<StoredAuth | null>;
-    runPreflight?: () => Promise<{
-        ok: boolean;
-        summary: string;
-        passedCount: number;
-        totalCount: number;
-    }>;
-    skipInstall?: boolean;
-    detectMonorepo?: (projectDir: string) => Promise<MonorepoDetectionResult>;
-    ensureUrlScheme?: (projectDir: string) => Promise<SchemeAction>;
-    detectLanIpCandidates?: () => LanIpCandidate[];
-    writeSignalHostEnv?: (ip: string) => Promise<WriteSignalHostEnvResult>;
-}
-export interface WalkthroughResult {
-    packageInstalled: boolean;
-    packageManager: PackageManager;
-    authLogin: string | null;
-    cameraEdits: {
-        filesEdited: string[];
-        totalReplacements: number;
-    };
-    layoutInjection: {
-        applied: boolean;
-        target: RootComponentTarget | null;
-        reason?: string;
-    };
-    cameraRegistrySync: {
-        state: "written" | "unchanged" | "missing-dir";
-        registered: number;
-    };
-    preflight: {
-        ok: boolean;
-        summary: string;
-        passedCount: number;
-        totalCount: number;
-    } | null;
-    workingDir: string;
-    urlScheme: SchemeAction | null;
-    signalHost: {
-        ip: string;
-        kind: LanIpCandidate["kind"];
-        interfaceName: string;
-        profile: WriteSignalHostEnvResult;
-        otherCandidates: LanIpCandidate[];
-    } | null;
-    agentHint: AgentInitHint | null;
-}
-export interface AgentInitHint {
-    cameras: Array<{
-        file: string;
-        line: number;
-        suggestedKey: string;
-    }>;
-    setupRequired: boolean;
-    hintText: string;
-}
-export declare const AGENT_HINT_SENTINEL = "CERAPH_INIT_AGENT_HINT=";
-export declare function runWalkthrough(projectDir: string, deps?: WalkthroughDeps): Promise<WalkthroughResult>;

package/dist/init/walkthrough.js

@@ -1,340 +0,0 @@
-import { spawn } from "node:child_process";
-import { join } from "node:path";
-import { detectPackageManager, installArgv, isPackageInstalled, } from "./package-manager.js";
-import { readExistingAuth, pollUntilToken, } from "./oauth.js";
-import { scanCameraViews, applyCameraEdits, snapshotFile, restoreFile, } from "./ast-camera.js";
-import { detectRootComponent, injectInstallCeraph, snapshotLayout, restoreLayout, } from "./ast-layout.js";
-import { confirm, chooseFromList, print, } from "./prompt.js";
-import { syncCameraRegistry, relativeRegistryPath, } from "../camera-registry-sync.js";
-import { detectMonorepoSubpackages, } from "./monorepo.js";
-import { ensureCeraphUrlScheme, bareRnInstructions, expoDynamicConfigInstructions, } from "./url-scheme.js";
-import { detectMacLanIpCandidates, } from "./lan-ip.js";
-import { writeSignalHostEnv, } from "./shell-profile.js";
-export const AGENT_HINT_SENTINEL = "CERAPH_INIT_AGENT_HINT=";
-function defaultInstallPackage(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 }));
-    });
-}
-function fmt(line) {
-    return `  ${line}\n`;
-}
-export async function runWalkthrough(projectDir, deps = {}) {
-    const say = (msg) => print(msg, deps);
-    say("\n@ceraph/react-native-mcp init\n\n");
-    const workingDir = await resolveWorkingDir(projectDir, deps);
-    const pm = await detectPackageManager(workingDir);
-    const alreadyInstalled = await isPackageInstalled(workingDir);
-    let packageInstalled = alreadyInstalled;
-    if (!alreadyInstalled && !deps.skipInstall) {
-        const argv = installArgv(pm);
-        const ok = await confirm(`Install @ceraph/react-native-mcp with ${pm}?`, { ...deps, defaultYes: true });
-        if (ok) {
-            say(fmt(`Running: ${argv.bin} ${argv.args.join(" ")}`));
-            const installer = deps.installPackage ?? defaultInstallPackage;
-            const res = await installer({
-                bin: argv.bin,
-                args: argv.args,
-                cwd: workingDir,
-            });
-            if (res.exitCode !== 0) {
-                throw new Error(`${pm} install exited with code ${res.exitCode}. ` +
-                    `Fix the error above and re-run \`npx @ceraph/react-native-mcp init\`.`);
-            }
-            packageInstalled = true;
-        }
-        else {
-            say(fmt(`Skipped install — add @ceraph/react-native-mcp manually later.`));
-        }
-    }
-    else if (alreadyInstalled) {
-        say(fmt(`@ceraph/react-native-mcp already in package.json`));
-    }
-    const loadAuth = deps.loadAuth ?? readExistingAuth;
-    const existing = await loadAuth();
-    let auth = existing;
-    if (existing) {
-        say(fmt(`Authenticated as ${existing.githubUser.login} (GitHub) [cached]`));
-    }
-    else {
-        say(fmt(`GitHub authentication required. Starting device flow…`));
-        const authenticate = deps.authenticate ?? defaultAuthenticate;
-        auth = await authenticate();
-        say(fmt(`Authenticated as ${auth.githubUser.login} (GitHub)`));
-    }
-    const scan = await scanCameraViews(workingDir);
-    const fileSnapshots = new Map();
-    let cameraEdits = { filesEdited: [], totalReplacements: 0 };
-    if (scan.edits.length === 0) {
-        say(fmt(`No <CameraView> usages found in app/, src/, screens/, App.tsx`));
-    }
-    else {
-        say(fmt(`Replacing ${scan.edits.length} <CameraView> usage(s) across ${scan.filesScanned} file(s):`));
-        for (const edit of scan.edits) {
-            say(fmt(`  - ${edit.relPath}:${edit.line} → <CeraphCamera />${edit.alreadyHasImageKey ? " (existing imageKey preserved)" : ""}`));
-        }
-        cameraEdits = await applyEditsWithSnapshot(workingDir, scan.edits, fileSnapshots, deps, { omitImageKey: true });
-    }
-    const target = await detectRootComponent(workingDir);
-    let layoutInjection = {
-        applied: false,
-        target,
-    };
-    if (!target) {
-        say(fmt(`Could not find app/_layout.tsx or App.tsx. ` +
-            `Add \`useEffect(() => { installCeraph(); }, [])\` to your root component manually.`));
-    }
-    else {
-        const ok = await confirm(`Wire installCeraph() into ${displayPath(workingDir, target.filePath)}?`, { ...deps, defaultYes: true });
-        if (ok) {
-            const snapshot = await snapshotLayout(target);
-            try {
-                const result = await injectInstallCeraph(target);
-                layoutInjection = {
-                    applied: result.applied,
-                    target,
-                    reason: result.reason,
-                };
-                if (result.applied) {
-                    say(fmt(`installCeraph() wired in ${displayPath(workingDir, target.filePath)}`));
-                }
-                else {
-                    say(fmt(`Skipped (auto-injection): ${result.reason ?? "unknown reason"}`));
-                }
-            }
-            catch (err) {
-                if (snapshot != null)
-                    await restoreLayout(target, snapshot);
-                throw err;
-            }
-        }
-        else {
-            say(fmt(`Skipped installCeraph() injection.`));
-        }
-    }
-    let urlScheme = null;
-    const detectUrlScheme = deps.ensureUrlScheme ?? ensureCeraphUrlScheme;
-    const schemeResult = await detectUrlScheme(workingDir);
-    urlScheme = schemeResult;
-    switch (schemeResult.kind) {
-        case "expo-json-added": {
-            const prev = schemeResult.previousScheme;
-            const prevDisplay = prev === undefined
-                ? "(none)"
-                : Array.isArray(prev)
-                    ? `[${prev.join(", ")}]`
-                    : prev;
-            say(fmt(`Registered ceraph:// URL scheme in ${displayPath(workingDir, schemeResult.path)} (was: ${prevDisplay})`));
-            break;
-        }
-        case "expo-json-already-registered":
-            say(fmt(`ceraph:// URL scheme already registered in ${displayPath(workingDir, schemeResult.path)}`));
-            break;
-        case "expo-config-needs-manual":
-            say(fmt(`Detected ${displayPath(workingDir, schemeResult.path)} (dynamic Expo config).`));
-            say(expoDynamicConfigInstructions(displayPath(workingDir, schemeResult.path)));
-            break;
-        case "bare-rn-needs-manual":
-            say(fmt(`Detected bare React Native project (ios/ and/or android/).`));
-            say(bareRnInstructions());
-            break;
-        case "no-rn-project":
-            break;
-    }
-    const detectCandidates = deps.detectLanIpCandidates ?? detectMacLanIpCandidates;
-    const writeSignalHost = deps.writeSignalHostEnv ?? writeSignalHostEnv;
-    let signalHost = null;
-    try {
-        const candidates = detectCandidates();
-        if (candidates.length === 0) {
-            say(fmt(`Could not auto-detect a LAN IP for CERAPH_SIGNAL_HOST. ` +
-                `Real-device signals from the shim need the Mac's reachable IP — ` +
-                `set it manually with: export CERAPH_SIGNAL_HOST=<your-mac-ip>`));
-        }
-        else {
-            const picked = candidates[0];
-            if (candidates.length > 1) {
-                const summary = candidates
-                    .map((c) => `${c.interfaceName} ${c.address} (${c.kind})`)
-                    .join(", ");
-                say(fmt(`Multiple LAN interfaces detected (${summary}). ` +
-                    `Using ${picked.interfaceName} ${picked.address} as CERAPH_SIGNAL_HOST.`));
-            }
-            const profile = await writeSignalHost(picked.address);
-            signalHost = {
-                ip: picked.address,
-                kind: picked.kind,
-                interfaceName: picked.interfaceName,
-                profile,
-                otherCandidates: candidates.slice(1),
-            };
-            if (profile.state === "unchanged") {
-                say(fmt(`CERAPH_SIGNAL_HOST already set to ${picked.address} in ${profile.path}.`));
-            }
-            else if (profile.state === "added") {
-                say(fmt(`Wrote CERAPH_SIGNAL_HOST=${picked.address} to ${profile.path} ` +
-                    `(${profile.shell}). Restart your shell or run \`source ${profile.path}\` to pick it up.`));
-            }
-            else {
-                say(fmt(`Updated CERAPH_SIGNAL_HOST to ${picked.address} in ${profile.path}. ` +
-                    `Restart your shell or run \`source ${profile.path}\` to pick it up.`));
-            }
-        }
-    }
-    catch (err) {
-        say(fmt(`Could not write CERAPH_SIGNAL_HOST: ${err instanceof Error ? err.message : String(err)}. ` +
-            `Set it manually with: export CERAPH_SIGNAL_HOST=<your-mac-ip>`));
-    }
-    let cameraRegistrySync = {
-        state: "missing-dir",
-        registered: 0,
-    };
-    if (cameraEdits.totalReplacements > 0) {
-        const sync = await syncCameraRegistry(workingDir);
-        cameraRegistrySync = {
-            state: sync.writtenOrUnchanged,
-            registered: sync.registered.length,
-        };
-        if (sync.writtenOrUnchanged === "missing-dir") {
-            say(fmt(`Test images: call \`ceraph_add_camera_image\` (writes + auto-syncs the registry), or drop files into ${join(".ceraph", "camera-images")}/ and call \`rn_sync_camera_registry\` to regenerate.`));
-        }
-        else {
-            say(fmt(`Test image registry ${sync.writtenOrUnchanged} (${sync.registered.length} image(s)) at ${relativeRegistryPath(workingDir, sync.registryPath)}.`));
-        }
-    }
-    let preflight = null;
-    if (deps.runPreflight) {
-        preflight = await deps.runPreflight();
-        say(fmt(`Preflight: ${preflight.passedCount}/${preflight.totalCount} ${preflight.ok ? "passed" : "failed"}`));
-        if (preflight.summary)
-            say(preflight.summary);
-    }
-    say("\nNext: ask Claude Code (or your MCP client):\n");
-    say(`  \"Run ceraph_init to confirm the project is wired up, then run rn_preflight.\"\n\n`);
-    const cameras = scan.edits.map((e) => ({
-        file: e.relPath,
-        line: e.line,
-        suggestedKey: e.suggestedKey,
-    }));
-    const agentHint = deps.agentMode
-        ? {
-            cameras,
-            setupRequired: cameras.length > 0,
-            hintText: cameras.length === 0
-                ? "No <CeraphCamera> components detected. No camera-setup conversation needed; proceed with the rest of the project work."
-                : "For each <CeraphCamera> below, ask the user which scenario this " +
-                    "camera serves and call ceraph_init_replace_camera with the " +
-                    "chosen imageKey. Three options: " +
-                    "(A) imageKey=\"default\" — bundled black PNG fallback. Right " +
-                    "answer when the test doesn't care about image content (most " +
-                    "form-submit / file-upload flows). " +
-                    "(B) imageKey=\"<key>\" — a specific test image. Ask the user " +
-                    "for a descriptive lowercase-dashes name AND drop the file at " +
-                    ".ceraph/camera-images/<key>.{jpg,png,webp}, then call " +
-                    "rn_sync_camera_registry. " +
-                    "(C) imageKey=\"@runtime\" — the camera serves multiple " +
-                    "scenarios per flow; the planner picks the image per-step at " +
-                    "runtime. Use when one camera screen feeds different outcomes.",
-        }
-        : null;
-    if (deps.agentMode && agentHint) {
-        say(`${AGENT_HINT_SENTINEL}${JSON.stringify(agentHint)}\n`);
-    }
-    return {
-        packageInstalled,
-        packageManager: pm,
-        authLogin: auth?.githubUser.login ?? null,
-        cameraEdits,
-        layoutInjection,
-        cameraRegistrySync,
-        preflight,
-        workingDir,
-        urlScheme,
-        signalHost,
-        agentHint,
-    };
-}
-async function resolveWorkingDir(projectDir, deps) {
-    const detect = deps.detectMonorepo ?? detectMonorepoSubpackages;
-    const detection = await detect(projectDir);
-    if (detection.kind === "none") {
-        if (detection.isMonorepo && !detection.rootIsRnApp) {
-            throw new Error("Detected a monorepo at the current directory but could not find " +
-                "a React Native or Expo subpackage. Re-run `npx @ceraph/react-native-mcp init` " +
-                "from inside the RN/Expo app folder, or add the app to your workspaces.");
-        }
-        return projectDir;
-    }
-    if (detection.kind === "single") {
-        const match = detection.matches[0];
-        if (!match)
-            return projectDir;
-        print(fmt(`Detected React Native app at ${match.relPath}/ — working from there`), deps);
-        process.chdir(match.absPath);
-        return match.absPath;
-    }
-    print(fmt(`Multiple React Native subpackages detected:`), deps);
-    const options = detection.matches.map((m) => `${m.relPath}/  [${m.signals.join(", ")}]`);
-    const picked = await chooseFromList(`Which one should init configure?`, options, deps);
-    if (picked == null) {
-        throw new Error("No valid selection. Re-run init and pick a numbered option.");
-    }
-    const choice = detection.matches[picked];
-    if (!choice) {
-        throw new Error("Picked index out of range.");
-    }
-    print(fmt(`Working from ${choice.relPath}/`), deps);
-    process.chdir(choice.absPath);
-    return choice.absPath;
-}
-function displayPath(projectDir, absPath) {
-    if (absPath.startsWith(projectDir)) {
-        const rel = absPath.slice(projectDir.length + 1);
-        return rel.length > 0 ? rel : absPath;
-    }
-    return absPath;
-}
-async function defaultAuthenticate() {
-    let printedTick = false;
-    return pollUntilToken({
-        onPrompt: (codes) => {
-            print(fmt(`Visit ${codes.verificationUri}`));
-            print(fmt(`Enter code: ${codes.userCode}`));
-        },
-        onTick: (remaining) => {
-            if (!printedTick && remaining < 60) {
-                printedTick = true;
-                print(fmt(`(Authorization pending — ~${remaining}s left)`));
-            }
-        },
-    });
-}
-async function applyEditsWithSnapshot(projectDir, edits, fileSnapshots, deps, options = {}) {
-    for (const e of edits) {
-        if (!fileSnapshots.has(e.filePath)) {
-            fileSnapshots.set(e.filePath, await snapshotFile(e.filePath));
-        }
-    }
-    try {
-        const res = await applyCameraEdits(projectDir, edits, options);
-        print(fmt(`Replaced ${res.totalReplacements} <CameraView> → <CeraphCamera> across ${res.filesEdited.length} file(s)`), deps);
-        return res;
-    }
-    catch (err) {
-        for (const [filePath, snap] of fileSnapshots) {
-            if (snap != null) {
-                try {
-                    await restoreFile(filePath, snap);
-                }
-                catch {
-                }
-            }
-        }
-        throw err;
-    }
-}

package/dist/init.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-export declare function setupJsonMcp(configPath: string, label: string): Promise<boolean>;
-export declare function setupClaudeHook(projectDir?: string): Promise<void>;
-export declare function setupMcpClients(): Promise<void>;
-export interface RunInitOptions {
-    agentMode?: boolean;
-}
-export declare function runInit(opts?: RunInitOptions): Promise<void>;