remodex-cli 1.0.0

package/dist/doctor.js

@@ -0,0 +1,670 @@
+/**
+ * Bridge Server doctor command.
+ *
+ * Checks the health of all dependencies and provides actionable guidance
+ * when issues are found — similar to `flutter doctor`.
+ */
+import { execFile, execSync } from "node:child_process";
+import { accessSync, constants as fsConstants, existsSync, } from "node:fs";
+import net from "node:net";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+function execQuiet(cmd) {
+    return execSync(cmd, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+}
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+export async function checkNodeVersion() {
+    const version = process.version; // e.g. "v22.5.0"
+    const major = parseInt(version.slice(1), 10);
+    if (major >= 18) {
+        return { name: "Node.js", status: "pass", message: version };
+    }
+    return {
+        name: "Node.js",
+        status: "fail",
+        message: `${version} (requires >=18.0.0)`,
+        remediation: "Install Node.js >=18.0.0: https://nodejs.org/",
+    };
+}
+export async function checkGit() {
+    try {
+        const out = execQuiet("git --version"); // "git version 2.44.0"
+        const version = out.replace("git version ", "");
+        return { name: "Git", status: "pass", message: `v${version}` };
+    }
+    catch {
+        return {
+            name: "Git",
+            status: "fail",
+            message: "Not installed",
+            remediation: "Install Git: https://git-scm.com/downloads",
+        };
+    }
+}
+/** Check both Claude Code CLI and Codex CLI. At least one must be installed. */
+export async function checkCliProviders() {
+    const providers = [];
+    // --- Claude Code CLI ---
+    {
+        let installed = false;
+        let version;
+        let authenticated = false;
+        let authMessage;
+        let remediation;
+        try {
+            const out = execQuiet("claude --version");
+            installed = true;
+            version = out.trim().split("\n")[0];
+            // Check auth
+            try {
+                const authOut = execQuiet("claude auth status");
+                // If exit code 0, authenticated
+                if (authOut.toLowerCase().includes("not logged in") || authOut.toLowerCase().includes("unauthenticated")) {
+                    authenticated = false;
+                    authMessage = "Not authenticated";
+                    remediation = "Run: claude auth login";
+                }
+                else {
+                    authenticated = true;
+                }
+            }
+            catch {
+                // auth command failed — treat as unauthenticated
+                authenticated = false;
+                authMessage = "Not authenticated";
+                remediation = "Run: claude auth login";
+            }
+        }
+        catch {
+            remediation = "Install Claude Code: https://docs.anthropic.com/en/docs/claude-code/getting-started";
+        }
+        providers.push({
+            name: "Claude Code CLI",
+            installed,
+            version,
+            authenticated,
+            authMessage,
+            remediation,
+        });
+    }
+    // --- Codex CLI ---
+    {
+        let installed = false;
+        let version;
+        let authenticated = false;
+        let authMessage;
+        let remediation;
+        try {
+            const out = execQuiet("codex --version");
+            installed = true;
+            version = out.trim().split("\n")[0];
+            // Codex authenticates via OPENAI_API_KEY env var or ~/.codex/auth.json
+            if (process.env.OPENAI_API_KEY) {
+                authenticated = true;
+            }
+            else {
+                const authFile = join(homedir(), ".codex", "auth.json");
+                if (existsSync(authFile)) {
+                    authenticated = true;
+                }
+                else {
+                    authenticated = false;
+                    authMessage = "Not authenticated";
+                    remediation = "Run: codex login";
+                }
+            }
+        }
+        catch {
+            remediation = "Install Codex CLI: https://github.com/openai/codex";
+        }
+        providers.push({
+            name: "Codex CLI",
+            installed,
+            version,
+            authenticated,
+            authMessage,
+            remediation,
+        });
+    }
+    const installedCount = providers.filter((p) => p.installed).length;
+    const total = providers.length;
+    if (installedCount === 0) {
+        return {
+            name: "CLI providers",
+            status: "fail",
+            message: "No CLI providers installed",
+            remediation: "Install at least one: https://docs.anthropic.com/en/docs/claude-code/getting-started  OR  https://github.com/openai/codex",
+            providers,
+        };
+    }
+    // At least one installed — check if any auth warnings
+    const hasAuthWarn = providers.some((p) => p.installed && !p.authenticated);
+    return {
+        name: "CLI providers",
+        status: hasAuthWarn ? "warn" : "pass",
+        message: `${installedCount} of ${total} available`,
+        providers,
+    };
+}
+export async function checkDependencies() {
+    // In monorepo setups, node_modules may be hoisted to the workspace root.
+    // Use import.meta.resolve() to check if packages are resolvable.
+    const requiredPackages = [
+        "ws",
+        "@anthropic-ai/claude-agent-sdk",
+        "bonjour-service",
+    ];
+    const missing = [];
+    for (const pkg of requiredPackages) {
+        try {
+            import.meta.resolve(pkg);
+        }
+        catch {
+            missing.push(pkg);
+        }
+    }
+    if (missing.length > 0) {
+        return {
+            name: "npm dependencies",
+            status: "fail",
+            message: `Missing: ${missing.join(", ")}`,
+            remediation: "Run: npm install",
+        };
+    }
+    return { name: "npm dependencies", status: "pass", message: "All packages available" };
+}
+export async function checkPortAvailable(port) {
+    if (port === 0) {
+        return {
+            name: "Port availability",
+            status: "pass",
+            message: "An available ephemeral port can be allocated",
+        };
+    }
+    return new Promise((resolve) => {
+        let resolved = false;
+        const timeout = setTimeout(() => {
+            try {
+                server.close();
+            }
+            catch { /* ignore */ }
+            done({
+                name: "Port availability",
+                status: "warn",
+                message: `Port ${port} check timed out`,
+            });
+        }, 3000);
+        const done = (result) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timeout);
+            resolve(result);
+        };
+        const server = net.createServer();
+        server.once("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                done({
+                    name: "Port availability",
+                    status: "warn",
+                    message: `Port ${port} is in use`,
+                    remediation: `Another Bridge may be running, or set BRIDGE_PORT to a different port`,
+                });
+            }
+            else {
+                done({
+                    name: "Port availability",
+                    status: "warn",
+                    message: `Port ${port} check failed: ${err.code}`,
+                });
+            }
+        });
+        server.listen(port, "127.0.0.1", () => {
+            server.close(() => {
+                done({
+                    name: "Port availability",
+                    status: "pass",
+                    message: `Port ${port} is available`,
+                });
+            });
+        });
+    });
+}
+/** Resolve the tailscale CLI binary path (may be inside macOS .app bundle). */
+function tailscaleCmd() {
+    // Try bare command first (Linux, Homebrew install, etc.)
+    try {
+        execQuiet("tailscale version");
+        return "tailscale";
+    }
+    catch { /* not in PATH */ }
+    // macOS: Tailscale.app bundles the CLI inside the app
+    const macPath = "/Applications/Tailscale.app/Contents/MacOS/Tailscale";
+    if (existsSync(macPath))
+        return macPath;
+    throw new Error("tailscale not found");
+}
+export async function checkTailscale() {
+    let cmd;
+    try {
+        cmd = tailscaleCmd();
+    }
+    catch {
+        return {
+            name: "Tailscale",
+            status: "skip",
+            message: "Not installed (optional for remote access)",
+            remediation: "Install: https://tailscale.com/download",
+        };
+    }
+    try {
+        const out = execQuiet(`${cmd} status`);
+        // Extract the Tailscale IP (first IPv4 in output)
+        const ipMatch = out.match(/(\d+\.\d+\.\d+\.\d+)/);
+        const ip = ipMatch ? ipMatch[1] : "";
+        return {
+            name: "Tailscale",
+            status: "pass",
+            message: ip ? `Connected (${ip})` : "Connected",
+        };
+    }
+    catch {
+        return {
+            name: "Tailscale",
+            status: "warn",
+            message: "Installed but not connected",
+            remediation: "Run: tailscale up",
+        };
+    }
+}
+export async function checkFirebaseConnectivity() {
+    // Use a read-only endpoint to avoid creating anonymous accounts as a side effect
+    const FIREBASE_API_KEY = "AIzaSyAptNnokWPqJIgv2Lr3I8ETN6bqZb5BGvc";
+    const url = `https://identitytoolkit.googleapis.com/v1/accounts:lookup?key=${FIREBASE_API_KEY}`;
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({}),
+            signal: AbortSignal.timeout(5000),
+        });
+        // Any response (even 400) means the API is reachable
+        if (response.status < 500) {
+            return {
+                name: "Firebase connectivity",
+                status: "pass",
+                message: "Firebase Auth API reachable",
+            };
+        }
+        return {
+            name: "Firebase connectivity",
+            status: "warn",
+            message: `Firebase Auth API returned ${response.status}`,
+            remediation: "Push notifications may not work. Check network connectivity.",
+        };
+    }
+    catch {
+        return {
+            name: "Firebase connectivity",
+            status: "warn",
+            message: "Unreachable",
+            remediation: "Push notifications will be disabled. Check network connectivity.",
+        };
+    }
+}
+export async function checkDataDirectory() {
+    const dir = join(homedir(), ".remodex");
+    if (!existsSync(dir)) {
+        return {
+            name: "Data directory",
+            status: "pass",
+            message: "~/.remodex/ will be created on first run",
+        };
+    }
+    try {
+        accessSync(dir, fsConstants.R_OK | fsConstants.W_OK);
+        return {
+            name: "Data directory",
+            status: "pass",
+            message: "~/.remodex/ exists",
+        };
+    }
+    catch {
+        return {
+            name: "Data directory",
+            status: "warn",
+            message: "~/.remodex/ is not writable",
+            remediation: "Fix permissions: chmod u+rw ~/.remodex",
+        };
+    }
+}
+export async function checkLaunchdService() {
+    if (process.platform !== "darwin") {
+        return {
+            name: "launchd service",
+            status: "skip",
+            message: "macOS only",
+        };
+    }
+    try {
+        const out = execSync("launchctl list", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (out.includes("com.remodex.bridge")) {
+            return {
+                name: "launchd service",
+                status: "pass",
+                message: "Registered",
+            };
+        }
+        return {
+            name: "launchd service",
+            status: "skip",
+            message: "Not registered",
+            remediation: "Register with: remodex-cli setup",
+        };
+    }
+    catch {
+        return {
+            name: "launchd service",
+            status: "skip",
+            message: "Unable to check",
+        };
+    }
+}
+export async function checkSystemdService() {
+    if (process.platform !== "linux") {
+        return {
+            name: "systemd service",
+            status: "skip",
+            message: "Linux only",
+        };
+    }
+    try {
+        const out = execSync("systemctl --user is-active remodex-cli.service", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (out.trim() === "active") {
+            return {
+                name: "systemd service",
+                status: "pass",
+                message: "Active",
+            };
+        }
+        return {
+            name: "systemd service",
+            status: "skip",
+            message: `Status: ${out.trim()}`,
+            remediation: "Register with: remodex-cli setup",
+        };
+    }
+    catch {
+        return {
+            name: "systemd service",
+            status: "skip",
+            message: "Not registered",
+            remediation: "Register with: remodex-cli setup",
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// macOS permission checks
+// ---------------------------------------------------------------------------
+/**
+ * Swift inline script to check Screen Recording permission.
+ * CGWindowListCopyWindowInfo returns window names only when the process has
+ * Screen Recording permission. Without it, kCGWindowName is always empty.
+ * We check if *any* on-screen window has a non-empty name.
+ */
+const CHECK_SCREEN_RECORDING_SWIFT = `
+import CoreGraphics
+
+let windowList = CGWindowListCopyWindowInfo(
+    [.optionOnScreenOnly, .excludeDesktopElements],
+    kCGNullWindowID
+) as? [[String: Any]] ?? []
+
+var hasName = false
+for w in windowList {
+    guard let layer = w[kCGWindowLayer as String] as? Int, layer == 0 else { continue }
+    if let name = w[kCGWindowName as String] as? String, !name.isEmpty {
+        hasName = true
+        break
+    }
+}
+print(hasName ? "granted" : "denied")
+`;
+export async function checkScreenRecording() {
+    if (process.platform !== "darwin") {
+        return { name: "Screen Recording", status: "skip", message: "macOS only" };
+    }
+    return new Promise((resolve) => {
+        execFile("swift", ["-e", CHECK_SCREEN_RECORDING_SWIFT], { timeout: 15_000 }, (err, stdout) => {
+            if (err) {
+                resolve({
+                    name: "Screen Recording",
+                    status: "warn",
+                    message: "Unable to check (swift not available)",
+                    remediation: "Install Xcode Command Line Tools: xcode-select --install",
+                });
+                return;
+            }
+            const result = stdout.trim();
+            if (result === "granted") {
+                resolve({
+                    name: "Screen Recording",
+                    status: "pass",
+                    message: "Permission granted",
+                });
+            }
+            else {
+                resolve({
+                    name: "Screen Recording",
+                    status: "warn",
+                    message: "Permission not granted (screenshots will fail)",
+                    remediation: "System Settings > Privacy & Security > Screen Recording > enable your terminal app",
+                });
+            }
+        });
+    });
+}
+/**
+ * Check if Claude Code credentials are available.
+ *
+ * Checks ~/.claude/.credentials.json first, then falls back to
+ * macOS Keychain ("Claude Code-credentials" service).
+ */
+export async function checkKeychainAccess() {
+    const credPath = join(homedir(), ".claude", ".credentials.json");
+    if (existsSync(credPath)) {
+        return {
+            name: "Keychain access",
+            status: "pass",
+            message: "Claude Code credentials found (~/.claude/.credentials.json)",
+        };
+    }
+    // Fallback: check macOS Keychain
+    if (process.platform === "darwin") {
+        try {
+            const { execFileSync } = await import("node:child_process");
+            execFileSync("security", ["find-generic-password", "-s", "Claude Code-credentials"], { stdio: "ignore" });
+            return {
+                name: "Keychain access",
+                status: "pass",
+                message: "Claude Code credentials found (macOS Keychain)",
+            };
+        }
+        catch {
+            // Not in Keychain either
+        }
+    }
+    return {
+        name: "Keychain access",
+        status: "skip",
+        message: "No Claude Code credentials stored",
+        remediation: "Run: claude auth login (if using Claude Code)",
+    };
+}
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+function getAllChecks() {
+    const port = parseInt(process.env.BRIDGE_PORT ?? "8765", 10);
+    return [
+        // Required
+        { name: "Node.js", category: "required", run: checkNodeVersion },
+        { name: "Git", category: "required", run: checkGit },
+        { name: "CLI providers", category: "required", run: checkCliProviders },
+        { name: "npm dependencies", category: "required", run: checkDependencies },
+        {
+            name: "Port availability",
+            category: "required",
+            run: () => checkPortAvailable(port),
+        },
+        // Optional — macOS permissions
+        {
+            name: "Screen Recording",
+            category: "optional",
+            run: checkScreenRecording,
+        },
+        {
+            name: "Keychain access",
+            category: "optional",
+            run: checkKeychainAccess,
+        },
+        // Optional — connectivity & services
+        { name: "Tailscale", category: "optional", run: checkTailscale },
+        {
+            name: "Firebase connectivity",
+            category: "optional",
+            run: checkFirebaseConnectivity,
+        },
+        { name: "Data directory", category: "optional", run: checkDataDirectory },
+        // Platform-specific service checks
+        ...(process.platform === "darwin"
+            ? [{ name: "launchd service", category: "optional", run: checkLaunchdService }]
+            : []),
+        ...(process.platform === "linux"
+            ? [{ name: "systemd service", category: "optional", run: checkSystemdService }]
+            : []),
+    ];
+}
+export async function runDoctor() {
+    const checks = getAllChecks();
+    const results = [];
+    for (const check of checks) {
+        const result = await check.run();
+        results.push({ ...result, category: check.category });
+    }
+    const allRequiredPassed = results
+        .filter((r) => r.category === "required")
+        .every((r) => r.status === "pass" || r.status === "warn");
+    return { results, allRequiredPassed };
+}
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+const SYMBOLS_TTY = {
+    pass: "\x1b[32m✓\x1b[0m",
+    fail: "\x1b[31m✗\x1b[0m",
+    warn: "\x1b[33m!\x1b[0m",
+    skip: "\x1b[90m-\x1b[0m",
+};
+const SYMBOLS_PLAIN = {
+    pass: "[OK]",
+    fail: "[FAIL]",
+    warn: "[WARN]",
+    skip: "[SKIP]",
+};
+function providerStatusIcon(p, sym) {
+    if (!p.installed)
+        return sym.skip;
+    if (!p.authenticated)
+        return sym.warn;
+    return sym.pass;
+}
+function providerStatusMessage(p) {
+    if (!p.installed)
+        return "Not installed";
+    const parts = [];
+    if (p.version)
+        parts.push(p.version);
+    if (p.authenticated) {
+        parts.push("(authenticated)");
+    }
+    else if (p.authMessage) {
+        parts.push(`(${p.authMessage})`);
+    }
+    return parts.join(" ") || "Installed";
+}
+export function printReport(report) {
+    const isTTY = process.stdout.isTTY ?? false;
+    const sym = isTTY ? SYMBOLS_TTY : SYMBOLS_PLAIN;
+    const NAME_WIDTH = 22;
+    console.log("");
+    console.log("remodex-cli doctor");
+    console.log("======================");
+    // Required checks
+    const required = report.results.filter((r) => r.category === "required");
+    if (required.length > 0) {
+        console.log("");
+        console.log("Required:");
+        for (const r of required) {
+            const icon = sym[r.status];
+            const nameCol = r.name.padEnd(NAME_WIDTH);
+            console.log(`  ${icon} ${nameCol} ${r.message}`);
+            // Print provider sub-items for CLI providers check
+            if (r.providers) {
+                for (const p of r.providers) {
+                    const pIcon = providerStatusIcon(p, sym);
+                    const pName = p.name.padEnd(NAME_WIDTH);
+                    console.log(`      ${pIcon} ${pName} ${providerStatusMessage(p)}`);
+                    if (p.remediation) {
+                        console.log(`          → ${p.remediation}`);
+                    }
+                }
+            }
+            else if (r.remediation && (r.status === "fail" || r.status === "warn")) {
+                console.log(`      → ${r.remediation}`);
+            }
+        }
+    }
+    // Optional checks
+    const optional = report.results.filter((r) => r.category === "optional");
+    if (optional.length > 0) {
+        console.log("");
+        console.log("Optional:");
+        for (const r of optional) {
+            const icon = sym[r.status];
+            const nameCol = r.name.padEnd(NAME_WIDTH);
+            console.log(`  ${icon} ${nameCol} ${r.message}`);
+            if (r.remediation && (r.status === "fail" || r.status === "warn" || r.status === "skip")) {
+                console.log(`      → ${r.remediation}`);
+            }
+        }
+    }
+    // Summary
+    console.log("");
+    const failCount = report.results.filter((r) => r.status === "fail").length;
+    const warnCount = report.results.filter((r) => r.status === "warn").length;
+    if (report.allRequiredPassed) {
+        const msg = "All required checks passed.";
+        console.log(isTTY ? `\x1b[32m${msg}\x1b[0m` : msg);
+    }
+    else {
+        const msg = `${failCount} required check(s) failed.`;
+        console.log(isTTY ? `\x1b[31m${msg}\x1b[0m` : msg);
+    }
+    if (warnCount > 0) {
+        console.log(`${warnCount} warning(s).`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=doctor.js.map