dev3000 0.0.186 → 0.0.187

package/dist/cli.js

@@ -1,1370 +1,2 @@
-#!/usr/bin/env bun
-function getRunnablePath(searchPath) {
-    if (!existsSync(searchPath)) {
-        return null;
-    }
-    if (process.platform === "win32") {
-        return searchPath;
-    }
-    try {
-        accessSync(searchPath, constants.X_OK);
-        return searchPath;
-    }
-    catch {
-        try {
-            chmodSync(searchPath, 0o755);
-            accessSync(searchPath, constants.X_OK);
-            return searchPath;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-function ensureCommandPath(env) {
-    if (!env.PATH || env.PATH === "") {
-        env.PATH = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin";
-    }
-}
-function findAgentBrowser() {
-    const os = process.platform === "darwin" ? "darwin" : process.platform === "win32" ? "win32" : "linux";
-    const arch = process.arch === "arm64" ? "arm64" : "x64";
-    const nativeName = `agent-browser-${os}-${arch}`;
-    const platformPkg = `${os}-${arch}`;
-    const cwd = process.cwd();
-    const home = homedir();
-    const searchPaths = [
-        join(home, ".bun", "install", "global", "node_modules", "@d3k", platformPkg, "node_modules", ".bin", nativeName),
-        join(home, ".bun", "install", "global", "node_modules", "agent-browser", "bin", nativeName),
-        join(home, ".bun", "install", "global", "node_modules", "dev3000", "node_modules", ".bin", nativeName),
-        join(cwd, "node_modules", ".bin", nativeName),
-        join(cwd, "node_modules", "agent-browser", "bin", nativeName),
-        join(home, ".bun", "install", "global", "node_modules", "@d3k", platformPkg, "node_modules", ".bin", "agent-browser"),
-        join(home, ".bun", "install", "global", "node_modules", "dev3000", "node_modules", ".bin", "agent-browser"),
-        join(home, ".bun", "install", "global", "node_modules", ".bin", "agent-browser"),
-        join(home, ".bun", "install", "global", "node_modules", "agent-browser", "bin", "agent-browser.js"),
-        join(cwd, "node_modules", ".bin", "agent-browser"),
-        join(cwd, "node_modules", "agent-browser", "bin", "agent-browser.js")
-    ];
-    const globalNodeModules = [
-        join("/usr", "local", "lib", "node_modules"),
-        join("/opt", "homebrew", "lib", "node_modules")
-    ];
-    for (const root of globalNodeModules) {
-        searchPaths.push(join(root, "dev3000", "node_modules", ".bin", nativeName));
-        searchPaths.push(join(root, "dev3000", "node_modules", ".bin", "agent-browser"));
-        searchPaths.push(join(root, "agent-browser", "bin", nativeName));
-        searchPaths.push(join(root, "agent-browser", "bin", "agent-browser.js"));
-    }
-    for (const p of searchPaths) {
-        const runnablePath = getRunnablePath(p);
-        if (runnablePath)
-            return runnablePath;
-    }
-    return "agent-browser";
-}
-function getSessionCdpPort() {
-    const session = findCurrentSession();
-    return getSessionCdpPortForSession(session);
-}
-function getSessionCdpPortForSession(session) {
-    const cdpUrl = session?.cdpUrl;
-    if (!cdpUrl) {
-        return null;
-    }
-    try {
-        const parsed = new URL(cdpUrl);
-        if (/^\d+$/.test(parsed.port)) {
-            return parsed.port;
-        }
-    }
-    catch {
-        const match = cdpUrl.match(/:(\d+)/);
-        if (match) {
-            return match[1];
-        }
-    }
-    return null;
-}
-function printUnsafeAgentBrowserOpenError(reason, hasActiveSession) {
-    const sessionHint = hasActiveSession
-        ? "The active d3k session has no usable d3k-managed browser. This usually means d3k was started with --servers-only, browser startup failed, or the session is stale."
-        : "No active d3k session with a managed browser was found.";
-    console.error([
-        "Refusing to run `d3k agent-browser open` because it would create or use an agent-browser-managed browser instead of d3k's active browser.",
-        "",
-        reason,
-        sessionHint,
-        "",
-        "For OAuth/auth debugging, start d3k normally so it launches the app and browser together:",
-        '  d3k --command "<dev command>" --port <port> --startup-timeout <seconds> --app-url "<url>"',
-        "",
-        "Then navigate the d3k-managed browser with:",
-        '  d3k agent-browser --require-d3k-browser open "<url>"',
-        "",
-        "For an explicit non-auth standalone/fresh-profile browser, pass:",
-        '  d3k agent-browser --allow-new-browser open "<url>"'
-    ].join("\n"));
-}
-function runLocalBrowserTool(args) {
-    const env = { ...process.env };
-    ensureCommandPath(env);
-    const invocation = parseAgentBrowserInvocationArgs(args);
-    const toolArgs = invocation.args;
-    const subcommand = invocation.subcommand;
-    const hasExplicitCdp = hasAgentBrowserOption(toolArgs, "--cdp");
-    const hasProfile = hasAgentBrowserOption(toolArgs, "--profile") || hasAgentBrowserOption(toolArgs, "--profile-dir");
-    if (subcommand === "errors") {
-        console.log("\x1b[33m💡 Tip: Using `d3k errors` instead (shows browser + server errors)\x1b[0m\n");
-        const d3kBin = process.argv[1];
-        const result = spawnSync(d3kBin, ["errors"], { stdio: "inherit", shell: false });
-        process.exit(result.status ?? 0);
-    }
-    if (subcommand === "console") {
-        console.log("\x1b[33m💡 Tip: Using `d3k logs` instead (shows browser + server logs)\x1b[0m\n");
-        const d3kBin = process.argv[1];
-        const result = spawnSync(d3kBin, ["logs", "--type", "browser"], { stdio: "inherit", shell: false });
-        process.exit(result.status ?? 0);
-    }
-    const binaryPath = findAgentBrowser();
-    const openNeedsD3kBrowser = isAgentBrowserOpenCommand(subcommand) && !invocation.allowNewBrowser && !hasExplicitCdp;
-    if (invocation.allowNewBrowser && invocation.requireD3kBrowser) {
-        console.error("`--allow-new-browser` and `--require-d3k-browser` cannot be used together.");
-        process.exit(1);
-    }
-    if (invocation.requireD3kBrowser && hasExplicitCdp) {
-        console.error("`--require-d3k-browser` uses the active d3k session. Remove `--cdp` or use `--allow-new-browser`.");
-        process.exit(1);
-    }
-    const activeSession = findCurrentSession();
-    const sessionCdpPort = getSessionCdpPortForSession(activeSession);
-    const needsD3kBrowser = invocation.requireD3kBrowser || openNeedsD3kBrowser;
-    if (needsD3kBrowser && hasProfile) {
-        printUnsafeAgentBrowserOpenError("`--profile` and `--profile-dir` make agent-browser use its own browser profile instead of d3k's active browser.", activeSession !== null);
-        process.exit(1);
-    }
-    if (needsD3kBrowser && !sessionCdpPort) {
-        printUnsafeAgentBrowserOpenError("Opening a URL without a d3k-managed browser would launch a new automation browser, which can break Google OAuth/Supabase auth with `This browser or app may not be secure`.", activeSession !== null);
-        process.exit(1);
-    }
-    if (subcommand !== "connect" && subcommand !== "close" && !hasExplicitCdp && !hasProfile) {
-        if (sessionCdpPort) {
-            const connectResult = spawnSync(binaryPath, ["connect", sessionCdpPort], { stdio: "pipe", env, shell: false });
-            if (needsD3kBrowser && connectResult.status !== 0) {
-                printUnsafeAgentBrowserOpenError("d3k found a browser session, but agent-browser could not connect to it.", activeSession !== null);
-                process.exit(connectResult.status ?? 1);
-            }
-        }
-    }
-    const result = spawnSync(binaryPath, toolArgs, {
-        stdio: "pipe",
-        env,
-        shell: false
-    });
-    if (result.stdout?.length > 0) {
-        process.stdout.write(result.stdout);
-    }
-    if (result.stderr?.length > 0) {
-        process.stderr.write(result.stderr);
-    }
-    if (result.error) {
-        console.error(`\nError spawning agent-browser: ${result.error.message}`);
-        console.error(`Binary path: ${binaryPath}`);
-        process.exit(1);
-    }
-    process.exit(result.status ?? 1);
-}
-import { getBrowserCommandInvocation, hasAgentBrowserOption, isAgentBrowserOpenCommand, parseAgentBrowserInvocationArgs } from "./utils/browser-command-argv.js";
-const browserCommandInvocation = getBrowserCommandInvocation(process.argv.slice(2));
-if (browserCommandInvocation && (process.argv[1]?.includes("d3k") || process.argv[1]?.includes("dev3000"))) {
-    runLocalBrowserTool(browserCommandInvocation.args);
-}
-import chalk from "chalk";
-import { execSync, spawnSync } from "child_process";
-import { Command } from "commander";
-import { accessSync, appendFileSync, chmodSync, constants, existsSync, readFileSync } from "fs";
-import { homedir } from "os";
-import { detect } from "package-manager-detector";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
-import { createPersistentLogFile, findAvailablePort, startDevEnvironment } from "./dev-environment.js";
-import { getPortlessProxyStatus, installPortlessService } from "./portless.js";
-import { getSkill, getSkillsInfo, listAvailableSkills } from "./skills/index.js";
-import { detectAIAgent } from "./utils/agent-detection.js";
-import { getAvailableAgents, getSkillsAgentId } from "./utils/agent-selection.js";
-import { validateDateTimeOption, validatePortOption, validatePositiveIntegerOption, validateScriptOption } from "./utils/cli-options.js";
-import { ensureD3kHomeDir } from "./utils/d3k-dir.js";
-import { ensureD3kSkill } from "./utils/d3k-skill-installer.js";
-import { readProjectAgentName } from "./utils/project-metadata.js";
-import { getProjectDir, getProjectDisplayName } from "./utils/project-name.js";
-import { findCurrentSession } from "./utils/session.js";
-import { checkForSkillUpdates, getApplicablePackages, getSkillsPathForLocation, installSkillPackage, isPackageInstalled, updateSkills } from "./utils/skill-installer.js";
-import { DEFAULT_TMUX_CONFIG, generateSessionName, generateTmuxCommands, getTmuxInstallInstructions, isTmuxInstalled } from "./utils/tmux-helpers.js";
-import { loadUserConfig, saveUserConfig } from "./utils/user-config.js";
-import { checkForUpdates, getUpgradeCommand, performUpgrade } from "./utils/version-check.js";
-// Global error handlers to log crashes
-const crashLogPath = join(ensureD3kHomeDir(), "crash.log");
-function logCrash(type, error) {
-    try {
-        ensureD3kHomeDir();
-        const timestamp = new Date().toISOString();
-        const errorStr = error instanceof Error ? `${error.message}\n${error.stack}` : String(error);
-        const logEntry = `[${timestamp}] ${type}: ${errorStr}\n\n`;
-        appendFileSync(crashLogPath, logEntry);
-        console.error(chalk.red(`\n💥 d3k crashed: ${error instanceof Error ? error.message : error}`));
-        console.error(chalk.gray(`   Details logged to: ${crashLogPath}`));
-    }
-    catch {
-        // If we can't log, at least print to stderr
-        console.error(`d3k crashed: ${error}`);
-    }
-}
-function triggerEmergencyShutdown(reason, error) {
-    const handler = globalThis.__d3kEmergencyShutdown;
-    if (typeof handler === "function") {
-        try {
-            handler(reason, error);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    return false;
-}
-function setTerminalTitle(rootDir) {
-    const safeRootDir = rootDir
-        .split("\u001b")
-        .join("")
-        .split("\u0007")
-        .join("")
-        .replace(/[\r\n]+/g, " ")
-        .trim();
-    const title = `d3k ${safeRootDir}`;
-    // Some terminals prefer process.title over OSC escape sequences.
-    process.title = title;
-    if (!process.stdout.isTTY)
-        return;
-    process.stdout.write(`\u001b]0;${title}\u0007\u001b]2;${title}\u0007`);
-}
-process.on("uncaughtException", (error) => {
-    logCrash("Uncaught Exception", error);
-    if (!triggerEmergencyShutdown("uncaughtException", error)) {
-        process.exit(1);
-    }
-});
-process.on("unhandledRejection", (reason) => {
-    logCrash("Unhandled Promise Rejection", reason);
-    if (!triggerEmergencyShutdown("unhandledRejection", reason)) {
-        process.exit(1);
-    }
-});
-function shellQuote(value) {
-    return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-/**
- * Build the d3k command string with forwarded options.
- */
-function buildD3kCommandWithOptions(options) {
-    const d3kBase = process.argv[1].endsWith("d3k") ? "d3k" : "dev3000";
-    const args = [shellQuote(d3kBase)];
-    // Forward options that were explicitly set
-    if (options.port)
-        args.push("--port", shellQuote(options.port));
-    if (options.script)
-        args.push("--script", shellQuote(options.script));
-    if (options.command)
-        args.push("--command", shellQuote(options.command));
-    if (options.startupTimeout)
-        args.push("--startup-timeout", shellQuote(options.startupTimeout));
-    if (options.browserNavigationTimeout) {
-        args.push("--browser-navigation-timeout", shellQuote(options.browserNavigationTimeout));
-    }
-    if (options.profileDir)
-        args.push("--profile-dir", shellQuote(options.profileDir));
-    if (options.browserTool)
-        args.push("--browser-tool", shellQuote(options.browserTool));
-    if (options.browser)
-        args.push("--browser", shellQuote(options.browser));
-    if (options.appUrl)
-        args.push("--app-url", shellQuote(options.appUrl));
-    if (options.externalCdpBase)
-        args.push("--external-cdp-base", shellQuote(options.externalCdpBase));
-    if (options.serversOnly)
-        args.push("--servers-only");
-    if (options.headless)
-        args.push("--headless");
-    if (options.dateTime)
-        args.push("--date-time", shellQuote(options.dateTime));
-    if (options.pluginReactScan)
-        args.push("--plugin-react-scan");
-    if (options.agentName)
-        args.push("--agent-name", shellQuote(options.agentName));
-    if (options.portless === false)
-        args.push("--no-portless");
-    return args.join(" ");
-}
-/**
- * Launch d3k with an agent using tmux for proper terminal multiplexing.
- * This creates a split-screen with the agent on the left and d3k logs on the right.
- */
-async function launchWithTmux(agentCommand, forwardedOptions = {}) {
-    const { execSync } = await import("child_process");
-    const { appendFileSync, writeFileSync } = await import("fs");
-    // Log file for debugging crashes
-    const d3kDir = ensureD3kHomeDir();
-    const crashLogPath = join(d3kDir, "crash.log");
-    const logCrash = (message, error) => {
-        const timestamp = new Date().toISOString();
-        const errorStr = error instanceof Error ? `${error.message}\n${error.stack}` : String(error || "");
-        const logEntry = `[${timestamp}] ${message}${errorStr ? `\n${errorStr}` : ""}\n`;
-        try {
-            appendFileSync(crashLogPath, logEntry);
-        }
-        catch {
-            // Ignore write errors
-        }
-        console.error(chalk.red(message));
-        if (error)
-            console.error(error);
-    };
-    // Check if tmux is installed
-    if (!(await isTmuxInstalled())) {
-        console.error(chalk.red("\n❌ tmux is not installed."));
-        console.error(chalk.yellow("\nThe --with-agent flag requires tmux for split-screen mode."));
-        console.error(chalk.cyan("\nTo install tmux:"));
-        for (const instruction of getTmuxInstallInstructions()) {
-            console.error(chalk.gray(`  ${instruction}`));
-        }
-        console.error(chalk.yellow("\nAlternatively, run d3k and your agent in separate terminal tabs.\n"));
-        process.exit(1);
-    }
-    // Generate a unique session name
-    const sessionName = generateSessionName();
-    const agentPaneLogPath = join(d3kDir, "tmux-last-agent.log");
-    const d3kPaneLogPath = join(d3kDir, "tmux-last-d3k.log");
-    // Build d3k command with forwarded options
-    const d3kCommand = buildD3kCommandWithOptions(forwardedOptions);
-    // Generate tmux commands using the helper
-    const commands = generateTmuxCommands({
-        sessionName,
-        d3kCommand,
-        agentCommand,
-        paneWidthPercent: DEFAULT_TMUX_CONFIG.paneWidthPercent,
-        d3kLogPath: d3kPaneLogPath,
-        agentLogPath: agentPaneLogPath
-    });
-    // Create a shell script that sets up tmux and attaches
-    // This ensures clean terminal state by exec'ing into tmux
-    const scriptPath = join(d3kDir, "launch-tmux.sh");
-    // Get the first command (new-session) and remaining commands
-    const [newSessionCmd, ...remainingCommands] = commands;
-    // Modify new-session to include terminal dimensions (detected at runtime)
-    // This ensures the 80/20 split ratio is maintained when the window is resized on attach
-    const newSessionWithSize = newSessionCmd.replace("tmux new-session -d", "tmux new-session -d -x $COLS -y $LINES");
-    const scriptContent = `#!/bin/bash
-set -euo pipefail
-
-# Reset terminal state
-stty sane 2>/dev/null || true
-reset 2>/dev/null || true
-
-# Get terminal dimensions for proper pane sizing
-COLS=$(tput cols)
-LINES=$(tput lines)
-
-# Setup tmux session with actual terminal size
-${newSessionWithSize} && \\
-${remainingCommands.join(" && \\\n")}
-
-# Verify split setup succeeded before attaching.
-PANE_COUNT=$(tmux list-panes -t "${sessionName}" 2>/dev/null | wc -l | tr -d ' ')
-if [ "\${PANE_COUNT}" -lt 2 ]; then
-  echo "❌ Failed to initialize split panes (expected 2, got \${PANE_COUNT})."
-  tmux kill-session -t "${sessionName}" 2>/dev/null || true
-  exit 1
-fi
-
-# Replace this process with tmux attach
-exec tmux attach-session -t "${sessionName}"
-`;
-    try {
-        const tmuxStartTime = Date.now();
-        // Write the launch script
-        writeFileSync(scriptPath, scriptContent, { mode: 0o755 });
-        // Spawn bash with the script, inheriting stdio
-        // The script will exec into tmux, replacing bash
-        const { spawnSync } = await import("child_process");
-        const result = spawnSync("bash", [scriptPath], {
-            stdio: "inherit",
-            shell: false
-        });
-        const tmuxDurationMs = Date.now() - tmuxStartTime;
-        const exitCode = result.status ?? (result.error ? 1 : 0);
-        // Clean up session on exit
-        try {
-            execSync(`tmux kill-session -t "${sessionName}" 2>/dev/null`, { stdio: "ignore" });
-        }
-        catch {
-            // Session might already be killed
-        }
-        // If tmux exits quickly, surface diagnostics to avoid a "silent crash" experience.
-        if (exitCode !== 0 || tmuxDurationMs < 15_000) {
-            console.error("");
-            if (exitCode !== 0) {
-                console.error(chalk.red(`❌ tmux session exited with code ${exitCode}`));
-            }
-            else {
-                console.error(chalk.yellow("⚠️ tmux session exited quickly"));
-            }
-            console.error(chalk.gray(`Agent pane log: ${agentPaneLogPath}`));
-            console.error(chalk.gray(`d3k pane log:   ${d3kPaneLogPath}`));
-            console.error(chalk.gray(`Crash log:      ${crashLogPath}`));
-            console.error("");
-        }
-        // Clear screen only on clean, long-running sessions.
-        if (exitCode === 0 && tmuxDurationMs >= 15_000) {
-            process.stdout.write("\x1b[2J\x1b[H\x1b[3J");
-            console.log(chalk.gray("Thanks for using d3k!"));
-        }
-        process.exit(exitCode);
-    }
-    catch (error) {
-        logCrash("Failed to start tmux session", error);
-        process.exit(1);
-    }
-}
-/**
- * Show interactive agent selection prompt using Ink.
- * Returns the selected agent config, or null if user chose "No agent".
- */
-async function promptAgentSelection(defaultAgentName) {
-    const { render } = await import("ink");
-    const React = await import("react");
-    const { AgentSelector } = await import("./components/AgentSelector.js");
-    const agents = getAvailableAgents();
-    // Store the result to return after Ink exits
-    let selectedResult = null;
-    try {
-        const { unmount, waitUntilExit, clear } = render(React.createElement(AgentSelector, {
-            agents,
-            defaultAgentName,
-            onComplete: (result) => {
-                selectedResult = result.agent;
-                // Always save the selection for next time
-                try {
-                    if (result.agent) {
-                        saveUserConfig({ defaultAgent: result.agent });
-                    }
-                    else {
-                        // User chose "No agent" - clear the saved default
-                        saveUserConfig({ defaultAgent: undefined });
-                    }
-                }
-                catch (_error) {
-                    console.warn(chalk.yellow("Warning: Could not save agent preference"));
-                }
-                // Clear the Ink output and unmount
-                clear();
-                unmount();
-            }
-        }));
-        // Wait for Ink to fully exit
-        await waitUntilExit();
-        // Clear terminal and scrollback to remove any Ink artifacts
-        process.stdout.write("\x1b[2J\x1b[H\x1b[3J");
-    }
-    catch (error) {
-        console.error(chalk.red("Error in agent selection:"), error);
-        return null;
-    }
-    return selectedResult;
-}
-/**
- * Show interactive skill selection prompt using Ink.
- * Returns the selected skills and install location, or empty array if user skipped.
- */
-async function promptPackageSelection(packages, agentId) {
-    const { render } = await import("ink");
-    const React = await import("react");
-    const { PackageSelector } = await import("./components/PackageSelector.js");
-    let selectedPackages = [];
-    let installLocation = "project";
-    try {
-        const { unmount, waitUntilExit, clear } = render(React.createElement(PackageSelector, {
-            packages,
-            agentId,
-            onComplete: (selected, location) => {
-                selectedPackages = selected;
-                installLocation = location;
-                clear();
-                unmount();
-            },
-            onSkip: () => {
-                clear();
-                unmount();
-            }
-        }));
-        await waitUntilExit();
-        // Clear terminal and scrollback to remove any Ink artifacts
-        process.stdout.write("\x1b[2J\x1b[H\x1b[3J");
-    }
-    catch (error) {
-        console.error(chalk.red("Error in package selection:"), error);
-        return { packages: [], location: "project" };
-    }
-    return { packages: selectedPackages, location: installLocation };
-}
-function detectPythonCommand(debug = false) {
-    // Check if we're in a virtual environment
-    if (process.env.VIRTUAL_ENV) {
-        if (debug) {
-            console.log(`[DEBUG] Virtual environment detected: ${process.env.VIRTUAL_ENV}`);
-            console.log(`[DEBUG] Using activated python command`);
-        }
-        return "python";
-    }
-    // Check if python3 is available and prefer it
-    try {
-        execSync("python3 --version", { stdio: "ignore" });
-        if (debug) {
-            console.log(`[DEBUG] python3 is available, using python3`);
-        }
-        return "python3";
-    }
-    catch {
-        if (debug) {
-            console.log(`[DEBUG] python3 not available, falling back to python`);
-        }
-        return "python";
-    }
-}
-async function detectProjectType(debug = false) {
-    // Helper to check if package.json has a dev script (indicates Node.js project)
-    const hasNodeDevScript = () => {
-        try {
-            if (existsSync("package.json")) {
-                const packageJson = JSON.parse(readFileSync("package.json", "utf-8"));
-                return !!packageJson.scripts?.dev;
-            }
-        }
-        catch {
-            // Ignore parse errors
-        }
-        return false;
-    };
-    // Check for Node.js project FIRST if package.json has a dev script
-    // This takes priority over Python/Rails detection for hybrid projects
-    const detected = await detect();
-    if (detected && hasNodeDevScript()) {
-        if (debug) {
-            console.log(`[DEBUG] Node.js project detected (package.json with dev script takes priority)`);
-        }
-        // Continue to Node.js detection below
-    }
-    else {
-        // Check for Python project (only if no Node.js dev script)
-        if (existsSync("requirements.txt") || existsSync("pyproject.toml")) {
-            if (debug) {
-                console.log(`[DEBUG] Python project detected (found requirements.txt or pyproject.toml)`);
-            }
-            return {
-                type: "python",
-                defaultScript: "main.py",
-                defaultPort: "8000", // Common Python web server port
-                pythonCommand: detectPythonCommand(debug)
-            };
-        }
-        // Check for Rails project
-        if (existsSync("Gemfile") && existsSync("config/application.rb")) {
-            if (debug) {
-                console.log(`[DEBUG] Rails project detected (found Gemfile and config/application.rb)`);
-            }
-            return {
-                type: "rails",
-                defaultScript: "server",
-                defaultPort: "3000" // Rails default port
-            };
-        }
-    }
-    // Helper to detect framework for Node.js projects
-    const detectFramework = () => {
-        // Check for Next.js
-        const nextConfigFiles = ["next.config.js", "next.config.ts", "next.config.mjs", "next.config.cjs"];
-        if (nextConfigFiles.some((file) => existsSync(file))) {
-            if (debug) {
-                console.log(`[DEBUG] Next.js framework detected`);
-            }
-            return "nextjs";
-        }
-        // Check for Svelte - look for svelte.config.js or svelte dependency
-        if (existsSync("svelte.config.js")) {
-            if (debug) {
-                console.log(`[DEBUG] Svelte framework detected (svelte.config.js)`);
-            }
-            return "svelte";
-        }
-        // Check package.json for svelte dependency
-        try {
-            if (existsSync("package.json")) {
-                const packageJson = JSON.parse(readFileSync("package.json", "utf-8"));
-                const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-                if (deps.svelte || deps["@sveltejs/kit"]) {
-                    if (debug) {
-                        console.log(`[DEBUG] Svelte framework detected (package.json dependency)`);
-                    }
-                    return "svelte";
-                }
-            }
-        }
-        catch {
-            // Ignore parse errors
-        }
-        return "other";
-    };
-    if (detected) {
-        const framework = detectFramework();
-        if (debug) {
-            console.log(`[DEBUG] Node.js project detected with ${detected.agent} package manager and ${framework} framework`);
-        }
-        return {
-            type: "node",
-            framework,
-            packageManager: detected.agent,
-            defaultScript: "dev",
-            defaultPort: "3000"
-        };
-    }
-    // Check if this is a valid project directory
-    // If we get here, no lock files or project markers were found
-    // Check if package.json exists - if not, this isn't a valid project directory
-    if (!existsSync("package.json")) {
-        if (debug) {
-            console.log(`[DEBUG] No project files detected - not a valid project directory`);
-        }
-        return {
-            type: "node",
-            framework: "other",
-            packageManager: "npm",
-            defaultScript: "dev",
-            defaultPort: "3000",
-            noProjectDetected: true // Flag to indicate no project was found
-        };
-    }
-    // Fallback to npm for Node.js (package.json exists but no lock file)
-    const framework = detectFramework();
-    if (debug) {
-        console.log(`[DEBUG] Node.js project detected (package.json exists, no lock file), defaulting to npm and ${framework} framework`);
-    }
-    return {
-        type: "node",
-        framework,
-        packageManager: "npm",
-        defaultScript: "dev",
-        defaultPort: "3000"
-    };
-}
-// Read version from package.json or use compile-time injected version
-function getVersion() {
-    // Check for compile-time injected version first (for standalone binaries)
-    if (typeof __D3K_VERSION__ !== "undefined") {
-        return __D3K_VERSION__;
-    }
-    try {
-        const currentFile = fileURLToPath(import.meta.url);
-        const packageRoot = dirname(dirname(currentFile)); // Go up from dist/ to package root
-        const packageJsonPath = join(packageRoot, "package.json");
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
-        let version = packageJson.version;
-        // Use git to detect if we're in the dev3000 source repository
-        try {
-            const gitRemote = execSync("git remote get-url origin 2>/dev/null", {
-                cwd: packageRoot,
-                encoding: "utf8"
-            }).trim();
-            if (gitRemote.includes("vercel-labs/dev3000") && !version.includes("canary")) {
-                version += "-local";
-            }
-        }
-        catch {
-            // Not in git repo or no git - use version as-is
-        }
-        return version;
-    }
-    catch (_error) {
-        return "0.0.0"; // fallback
-    }
-}
-// Check if installed globally before proceeding
-function checkGlobalInstall() {
-    const currentFile = fileURLToPath(import.meta.url);
-    const packageRoot = dirname(dirname(currentFile));
-    // Check common global install paths
-    const globalPaths = [
-        "/usr/local/lib/node_modules",
-        "/usr/lib/node_modules",
-        process.env.NPM_CONFIG_PREFIX && join(process.env.NPM_CONFIG_PREFIX, "lib/node_modules"),
-        process.env.PNPM_HOME,
-        process.platform === "win32" && process.env.APPDATA && join(process.env.APPDATA, "npm/node_modules"),
-        process.env.HOME && join(process.env.HOME, ".npm-global/lib/node_modules"),
-        process.env.HOME && join(process.env.HOME, ".pnpm"),
-        process.env.HOME && join(process.env.HOME, ".yarn/global/node_modules")
-    ].filter(Boolean);
-    // Check if our package path contains any of these global paths
-    for (const globalPath of globalPaths) {
-        if (packageRoot.includes(globalPath)) {
-            return true;
-        }
-    }
-    // Additional check: if we're in node_modules but not in a project's node_modules
-    if (packageRoot.includes("node_modules") && !existsSync(join(packageRoot, "..", "..", "..", "package.json"))) {
-        return true;
-    }
-    // If we're in dev (running from source), that's fine
-    if (!packageRoot.includes("node_modules")) {
-        return true;
-    }
-    return false;
-}
-// Perform the check
-if (!checkGlobalInstall()) {
-    console.error(chalk.red("\n❌ Error: dev3000 must be installed globally.\n"));
-    console.error(chalk.white("This package won't work correctly as a local dependency.\n"));
-    console.error(chalk.cyan("To install globally, use one of these commands:"));
-    console.error(chalk.gray("  pnpm install -g dev3000"));
-    console.error(chalk.gray("  npm install -g dev3000"));
-    console.error(chalk.gray("  yarn global add dev3000\n"));
-    console.error(chalk.white("Then run 'd3k' or 'dev3000' from any project directory.\n"));
-    process.exit(1);
-}
-const program = new Command();
-program
-    .name("dev3000")
-    .description("Agent-first local web debugging runtime with a managed browser")
-    .version(getVersion());
-program
-    .description("Agent-first local web debugging runtime with a managed browser")
-    .option("-p, --port <port>", "Development server port (auto-detected by project type)")
-    .option("-s, --script <script>", "Script to run (e.g. dev, main.py) - auto-detected by project type")
-    .option("-c, --command <command>", "Custom command to run (overrides auto-detection and --script)")
-    .option("--startup-timeout <seconds>", "Seconds to wait for your app server to become reachable", "30")
-    .option("--browser-navigation-timeout <seconds>", "Seconds to wait for browser-initiated page navigation commands", "60")
-    .option("--profile-dir <dir>", "Chrome profile directory")
-    .option("--data-dir <dir>", "Override the per-project data directory (default: ~/.d3k/<project>/). Holds session.json, logs, screenshots, and the Chrome profile.")
-    .option("--log-file <path>", "Override the consolidated log file path (default: <data-dir>/logs/<timestamp>.log)")
-    .option("--screenshots-dir <dir>", "Override the screenshots directory (default: <data-dir>/screenshots)")
-    .option("--browser-tool <tool>", "Preferred local browser CLI: 'agent-browser'", "agent-browser")
-    .option("--browser <path>", "Full path to browser executable (e.g. for Arc: '/Applications/Arc.app/Contents/MacOS/Arc')")
-    .option("--app-url <url>", "URL to open in the monitored browser instead of the local app URL")
-    .option("--external-cdp-base <url>", "Existing CDP HTTP endpoint to connect to instead of launching Chrome")
-    .option("--servers-only", "Run servers only, skip browser launch")
-    .option("--debug", "Enable debug logging to console (automatically disables TUI)")
-    .option("-t, --tail", "Output consolidated logfile to terminal (like tail -f)")
-    .option("--tui", "Enable the interactive TUI dashboard (off by default)", false)
-    .option("--portless", "Use stable Portless URLs (default)", true)
-    .option("--no-portless", "Use a direct localhost URL instead of Portless")
-    .option("--date-time <format>", "Timestamp format: 'local' (default, e.g. 12:54:03 PM) or 'utc' (ISO string)", "local")
-    .option("--plugin-react-scan", "Enable react-scan performance monitoring for React applications")
-    .option("--headless", "Run Chrome in headless mode (for serverless/CI environments)")
-    .option("--auto-skills", "Automatically install recommended skills without prompts (headless-safe, installs to project skills dir)")
-    .option("--no-skills", "Disable skill installation and update checks")
-    .option("--with-agent <command>", 'Run an agent (e.g. claude) in split-screen mode using tmux. Example: --with-agent "claude"')
-    .option("--agent-name <name>", "Selected agent name (internal)")
-    .option("--no-agent", "Skip agent selection prompt and run d3k standalone")
-    .action(async (options) => {
-    if (options.dataDir) {
-        process.env.D3K_DATA_DIR = resolve(options.dataDir);
-    }
-    const projectName = getProjectDisplayName();
-    setTerminalTitle(projectName);
-    try {
-        if (options.port) {
-            options.port = validatePortOption(options.port);
-        }
-        if (options.script) {
-            options.script = validateScriptOption(options.script);
-        }
-        options.startupTimeout = validatePositiveIntegerOption("--startup-timeout", options.startupTimeout);
-        options.browserNavigationTimeout = validatePositiveIntegerOption("--browser-navigation-timeout", options.browserNavigationTimeout);
-        if (options.browserTool && options.browserTool !== "agent-browser") {
-            throw new Error("--browser-tool must be 'agent-browser'.");
-        }
-        options.browserTool = "agent-browser";
-        options.dateTime = validateDateTimeOption(options.dateTime || "local");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`\n❌ ${message}\n`));
-        process.exit(1);
-    }
-    // Load user config early so it can be used for --with-agent and agent selection flows
-    const userConfig = loadUserConfig();
-    const agentDetection = detectAIAgent();
-    // Apply browser default from user config if not explicitly provided via CLI
-    const browserOption = options.browser || userConfig.browser;
-    // Handle --with-agent by spawning tmux with split panes
-    if (options.withAgent) {
-        await launchWithTmux(options.withAgent, {
-            port: options.port,
-            script: options.script,
-            command: options.command,
-            startupTimeout: options.startupTimeout,
-            browserNavigationTimeout: options.browserNavigationTimeout,
-            profileDir: options.profileDir,
-            browserTool: options.browserTool,
-            browser: browserOption,
-            appUrl: options.appUrl,
-            externalCdpBase: options.externalCdpBase,
-            serversOnly: options.serversOnly,
-            headless: options.headless,
-            dateTime: options.dateTime,
-            pluginReactScan: options.pluginReactScan,
-            agentName: options.agentName,
-            portless: options.portless
-        });
-        return;
-    }
-    // Handle agent selection for split-screen mode (explicit with --tui)
-    // Skip unless --tui is provided, or if already inside tmux (to avoid nested prompts)
-    const insideTmux = !!process.env.TMUX;
-    let selectedAgent = null;
-    let didPromptAgentSelection = false;
-    let skillsAgentId = options.agentName
-        ? getSkillsAgentId(options.agentName)
-        : agentDetection.agentId || null;
-    if (agentDetection.isAgent) {
-        if (options.tui) {
-            if (options.debug) {
-                console.log(`[DEBUG] AI agent detected: ${agentDetection.agentName} (${agentDetection.reason}), auto-disabling TUI`);
-            }
-            options.tui = false;
-        }
-        if (agentDetection.agentId && options.skills !== false && !options.autoSkills) {
-            if (options.debug) {
-                console.log(`[DEBUG] AI agent detected: ${agentDetection.agentName} (${agentDetection.reason}), auto-enabling project skill installs`);
-            }
-            options.autoSkills = true;
-        }
-    }
-    if (process.stdin.isTTY && options.agent !== false && options.tui === true && !options.debug && !insideTmux) {
-        // Clear the terminal so d3k UI starts at the top of the screen
-        process.stdout.write("\x1B[2J\x1B[0f");
-        // Check if tmux is available before showing prompt
-        const tmuxAvailable = await isTmuxInstalled();
-        if (!tmuxAvailable) {
-            console.warn(chalk.yellow("⚠️ tmux not installed - agent split-screen mode unavailable"));
-            console.warn(chalk.gray("  Install tmux to enable: brew install tmux (macOS)"));
-            // Continue with normal startup
-        }
-        else {
-            // Always show prompt, pre-selecting the last-used option
-            const preferredAgentName = readProjectAgentName() || userConfig.defaultAgent?.name;
-            selectedAgent = await promptAgentSelection(preferredAgentName);
-            didPromptAgentSelection = true;
-            if (selectedAgent) {
-                if (selectedAgent.name === "debug") {
-                    // User chose debug mode - enable debug and continue with normal startup
-                    options.debug = true;
-                }
-            }
-            else if (options.debug) {
-                console.log("[DEBUG] No agent selected, continuing with normal startup");
-            }
-            // User chose "No agent" or "debug" - continue with normal startup
-        }
-        const skillsAgentName = selectedAgent?.name && selectedAgent.name !== "debug"
-            ? selectedAgent.name
-            : !didPromptAgentSelection
-                ? userConfig.defaultAgent?.name
-                : undefined;
-        skillsAgentId = getSkillsAgentId(skillsAgentName);
-        if (skillsAgentId && options.skills !== false) {
-            const resolvedSkillsAgentId = skillsAgentId;
-            // Check for skill updates and offer new packages
-            try {
-                // Show loading message
-                process.stdout.write(chalk.gray(" Checking for skills...\r"));
-                // 1. Check for updates to existing skills
-                const { hasUpdates } = await checkForSkillUpdates();
-                // Clear the loading message line
-                process.stdout.write("\x1B[2K\r");
-                if (hasUpdates) {
-                    // Show which packages have updates (use applicable packages since lock file may not exist)
-                    const applicablePackages = getApplicablePackages();
-                    console.log(chalk.cyan("📦 Skill updates available"));
-                    for (const pkg of applicablePackages) {
-                        console.log(chalk.gray(`   • ${pkg.repo}`));
-                    }
-                    const { default: readline } = await import("readline");
-                    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-                    const answer = await new Promise((resolve) => {
-                        rl.question(chalk.white("   Update now? (Y/n) "), resolve);
-                    });
-                    rl.close();
-                    if (answer.toLowerCase() !== "n") {
-                        console.log(chalk.gray("   Updating skills..."));
-                        const updateResult = await updateSkills();
-                        if (updateResult.success) {
-                            console.log(chalk.green("   ✓ Skills updated"));
-                        }
-                        else {
-                            console.log(chalk.yellow("   ⚠ Some skills failed to update"));
-                        }
-                    }
-                    console.log("");
-                }
-                // 2. Show all applicable packages with install status
-                // Skip if we just handled updates
-                if (!hasUpdates) {
-                    const applicablePackages = getApplicablePackages();
-                    const packagesWithStatus = applicablePackages.map((pkg) => ({
-                        ...pkg,
-                        installed: isPackageInstalled(pkg, resolvedSkillsAgentId)
-                    }));
-                    const hasUninstalled = packagesWithStatus.some((p) => !p.installed);
-                    // Only show package selector if there are packages to install
-                    if (packagesWithStatus.length > 0 && hasUninstalled) {
-                        const { packages: selectedPackages, location } = await promptPackageSelection(packagesWithStatus, resolvedSkillsAgentId);
-                        if (selectedPackages.length > 0) {
-                            const locationLabel = location === "global" ? "globally" : "to project";
-                            const targetPath = getSkillsPathForLocation(resolvedSkillsAgentId, location);
-                            if (targetPath) {
-                                const displayPath = targetPath.path.replace(process.env.HOME || "", "~");
-                                console.log(chalk.cyan(`Installing ${selectedPackages.length} skill package(s) ${locationLabel} → ${displayPath}...`));
-                            }
-                            else {
-                                console.log(chalk.cyan(`Installing ${selectedPackages.length} skill package(s) ${locationLabel}...`));
-                            }
-                            const results = { success: [], failed: [] };
-                            for (let i = 0; i < selectedPackages.length; i++) {
-                                const pkg = selectedPackages[i];
-                                console.log(chalk.gray(`  [${i + 1}/${selectedPackages.length}] ${pkg.displayName}...`));
-                                const result = await installSkillPackage(pkg, location, resolvedSkillsAgentId);
-                                if (result.success) {
-                                    results.success.push(pkg.displayName);
-                                }
-                                else {
-                                    results.failed.push(pkg.displayName);
-                                }
-                            }
-                            if (results.success.length > 0) {
-                                console.log(chalk.green(`✓ Installed: ${results.success.join(", ")}`));
-                            }
-                            if (results.failed.length > 0) {
-                                console.log(chalk.yellow(`⚠ Failed: ${results.failed.join(", ")}`));
-                            }
-                            console.log("");
-                        }
-                        else {
-                            // User skipped package installation, show skills are up to date
-                            console.log(chalk.green("✓ Skills up to date"));
-                            console.log("");
-                        }
-                    }
-                    else {
-                        // No updates and no new packages - show success
-                        console.log(chalk.green("✓ Skills up to date"));
-                        console.log("");
-                    }
-                }
-            }
-            catch {
-                // Show error briefly, then continue
-                console.log(chalk.yellow("⚠ Could not check for skill updates"));
-                console.log("");
-            }
-        }
-        if (tmuxAvailable && selectedAgent && selectedAgent.name !== "debug") {
-            // User selected an agent - launch with tmux after skills install
-            if (options.debug) {
-                console.log(`[DEBUG] Launching tmux with agent command: ${selectedAgent.command}`);
-            }
-            if (skillsAgentId === "claude-code" && options.skills !== false) {
-                ensureD3kSkill("claude-code");
-            }
-            // Clear screen and scrollback before launching tmux so when tmux exits, terminal is clean
-            process.stdout.write("\x1b[2J\x1b[H\x1b[3J");
-            await launchWithTmux(selectedAgent.command, {
-                port: options.port,
-                script: options.script,
-                command: options.command,
-                startupTimeout: options.startupTimeout,
-                browserNavigationTimeout: options.browserNavigationTimeout,
-                profileDir: options.profileDir,
-                browserTool: options.browserTool,
-                browser: browserOption,
-                appUrl: options.appUrl,
-                externalCdpBase: options.externalCdpBase,
-                serversOnly: options.serversOnly,
-                headless: options.headless,
-                dateTime: options.dateTime,
-                pluginReactScan: options.pluginReactScan,
-                agentName: selectedAgent.name,
-                portless: options.portless
-            });
-            return;
-        }
-    }
-    if (options.autoSkills && options.skills !== false && !skillsAgentId) {
-        skillsAgentId = agentDetection.agentId || "codex";
-    }
-    // Detect project type and configuration
-    const projectConfig = await detectProjectType(options.debug);
-    // Check if we're in a valid project directory
-    if (projectConfig.noProjectDetected) {
-        console.error(chalk.red("\n❌ No project detected in current directory.\n"));
-        console.error(chalk.white("dev3000 requires a project with one of these files:"));
-        console.error(chalk.gray("  • package.json (Node.js/JavaScript)"));
-        console.error(chalk.gray("  • requirements.txt or pyproject.toml (Python)"));
-        console.error(chalk.gray("  • Gemfile + config/application.rb (Rails)\n"));
-        console.error(chalk.cyan("💡 To get started:"));
-        console.error(chalk.gray("  • Navigate to an existing project directory, or"));
-        console.error(chalk.gray("  • Create a new project (e.g., 'npx create-next-app@latest'), or"));
-        console.error(chalk.gray("  • Use --command to run a custom command:\n"));
-        console.error(chalk.yellow(`    d3k --command "node server.js" -p 3000\n`));
-        process.exit(1);
-    }
-    // Use defaults from project detection if not explicitly provided
-    const port = options.port || projectConfig.defaultPort;
-    const script = options.script || projectConfig.defaultScript;
-    const userSetPort = options.port !== undefined;
-    const startupTimeoutSeconds = Number.parseInt(options.startupTimeout, 10);
-    const browserNavigationTimeoutSeconds = Number.parseInt(options.browserNavigationTimeout, 10);
-    const browserTool = "agent-browser";
-    if (Number.isNaN(startupTimeoutSeconds) || startupTimeoutSeconds <= 0) {
-        console.error(chalk.red("\n❌ --startup-timeout must be a positive integer (seconds).\n"));
-        process.exit(1);
-    }
-    if (Number.isNaN(browserNavigationTimeoutSeconds) || browserNavigationTimeoutSeconds <= 0) {
-        console.error(chalk.red("\n❌ --browser-navigation-timeout must be a positive integer (seconds).\n"));
-        process.exit(1);
-    }
-    // Generate server command based on custom command or project type
-    let serverCommand;
-    if (options.command) {
-        // Use custom command if provided - this overrides everything
-        serverCommand = options.command;
-        if (options.debug) {
-            console.log(`[DEBUG] Using custom command: ${serverCommand}`);
-        }
-    }
-    else if (projectConfig.type === "python") {
-        serverCommand = `${projectConfig.pythonCommand} ${script}`;
-        // Python frameworks typically use --port or -p, but it varies by framework
-        // For now, we'll let users handle Python port config manually
-    }
-    else if (projectConfig.type === "rails") {
-        serverCommand = `bundle exec rails ${script}`;
-        // Append port for Rails when user explicitly sets it
-        if (userSetPort) {
-            serverCommand += ` -p ${port}`;
-        }
-    }
-    else {
-        // Node.js project
-        serverCommand = `${projectConfig.packageManager} run ${script}`;
-        // Append port for Node.js projects when user explicitly sets it
-        if (userSetPort) {
-            // Different frameworks need different port argument syntax
-            // Note: We don't use -- separator as it conflicts with scripts that already have args
-            if (projectConfig.framework === "nextjs") {
-                // Next.js uses -p or --port flag
-                serverCommand += ` -p ${port}`;
-            }
-            else {
-                // Other frameworks (Vite, etc.) typically use --port
-                serverCommand += ` --port ${port}`;
-            }
-        }
-    }
-    // Check for circular dependency - detect if the script would invoke dev3000 itself
-    // Skip this check if using a custom command
-    if (projectConfig.type === "node" && !options.command) {
-        try {
-            const packageJson = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf-8"));
-            const scriptContent = packageJson.scripts?.[script];
-            // Check if the script invokes dev3000 or d3k
-            if (scriptContent && (scriptContent.includes("dev3000") || /\bd3k\b/.test(scriptContent))) {
-                console.error(chalk.red(`\n❌ Circular dependency detected!`));
-                console.error(chalk.yellow(`   The "${script}" script in package.json calls dev3000, which would create an infinite loop.`));
-                console.error(chalk.yellow(`   Current script content: "${scriptContent}"`));
-                console.error(chalk.yellow(`\n💡 Fix this by either:`));
-                console.error(chalk.yellow(`   1. Change the "${script}" script to call your actual dev server`));
-                console.error(chalk.yellow(`   2. Use dev3000 globally (run 'd3k' directly) instead of via package.json scripts`));
-                console.error(chalk.yellow(`   3. Use a different script name that doesn't invoke dev3000 (e.g., '${script === "dev" ? "dev:next" : "dev:server"}')`));
-                process.exit(1);
-            }
-        }
-        catch (_error) {
-            // Ignore errors reading package.json
-        }
-    }
-    if (options.debug) {
-        console.log(`[DEBUG] Project type: ${projectConfig.type}`);
-        console.log(`[DEBUG] Port: ${port} (${options.port ? "explicit" : "auto-detected"})`);
-        console.log(`[DEBUG] Script: ${script} (${options.script ? "explicit" : "auto-detected"})`);
-        console.log(`[DEBUG] Server command: ${serverCommand}`);
-    }
-    // Detect which command name was used (dev3000 or d3k)
-    const executablePath = process.argv[1];
-    const commandName = executablePath.endsWith("/d3k") || executablePath.includes("/d3k") ? "d3k" : "dev3000";
-    try {
-        const portlessEnabled = options.portless !== false;
-        if (portlessEnabled) {
-            const portlessStatus = getPortlessProxyStatus();
-            if (portlessStatus.setupRequired) {
-                console.log(chalk.cyan("Canonical Portless HTTPS routing is not ready; setting it up now..."));
-                const setupResult = await installPortlessService();
-                if (!setupResult.success) {
-                    throw new Error(setupResult.error || "Portless setup failed");
-                }
-            }
-        }
-        // Create persistent log file
-        const logFile = createPersistentLogFile(options.logFile);
-        // Use a per-project Chrome profile by default so concurrent d3k sessions
-        // don't fight over the same browser state. Honor explicit overrides.
-        const profileDir = options.profileDir || join(getProjectDir(), "chrome-profile");
-        // Find available Chrome debug port (starting from 9222)
-        // Each d3k instance needs its own debug port to avoid conflicts
-        const debugPort = await findAvailablePort(9222);
-        await startDevEnvironment({
-            ...options,
-            browser: browserOption,
-            browserTool,
-            appUrl: options.appUrl,
-            externalCdpBase: options.externalCdpBase,
-            port,
-            debugPort: Number.parseInt(debugPort, 10),
-            defaultPort: projectConfig.defaultPort,
-            framework: projectConfig.framework,
-            userSetPort,
-            logFile,
-            profileDir,
-            serverCommand,
-            debug: options.debug,
-            serversOnly: options.serversOnly,
-            commandName,
-            startupTimeoutSeconds,
-            browserNavigationTimeoutSeconds,
-            tail: options.tail,
-            // TUI is opt-in now; only enable when explicitly requested and not in debug
-            tui: options.tui === true && !options.debug,
-            portless: portlessEnabled,
-            customServerCommand: Boolean(options.command),
-            dateTimeFormat: options.dateTime || "local",
-            pluginReactScan: options.pluginReactScan || false,
-            agentName: options.agentName || undefined,
-            skillsAgentId: skillsAgentId || undefined,
-            autoSkills: options.skills !== false ? options.autoSkills || false : false,
-            installSkills: options.skills !== false,
-            screenshotsDir: options.screenshotsDir
-        });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`❌ Failed to start development environment: ${message}`));
-        process.exit(1);
-    }
-});
-const portlessCommand = program.command("portless").description("Set up the canonical port-free Portless proxy");
-portlessCommand
-    .command("status")
-    .description("Check whether canonical Portless HTTPS routing is ready")
-    .option("--json", "Output machine-readable Portless status")
-    .action((options) => {
-    const status = getPortlessProxyStatus();
-    if (options.json) {
-        console.log(JSON.stringify(status, null, 2));
-        return;
-    }
-    console.log(status.canonical
-        ? chalk.green("Canonical Portless HTTPS routing is ready.")
-        : chalk.yellow("Portless setup is required."));
-    if (status.target)
-        console.log(chalk.gray(`Proxy target: ${status.target}`));
-    console.log(chalk.gray(`Startup service: ${status.serviceInstalled ? "installed" : "not installed"}`));
-    if (status.setupRequired)
-        console.log(chalk.cyan("Run `d3k portless setup` once before starting d3k."));
-    process.exitCode = status.setupRequired ? 1 : 0;
-});
-portlessCommand
-    .command("setup")
-    .description("Install the HTTPS Portless proxy as an OS startup service on port 443")
-    .action(async () => {
-    console.log(chalk.cyan("Installing the Portless HTTPS service on port 443..."));
-    const result = await installPortlessService();
-    if (!result.success) {
-        console.error(chalk.red(`Portless service setup failed: ${result.error || "unknown error"}`));
-        process.exit(1);
-    }
-    console.log(chalk.green("Portless is ready. d3k will now use URLs such as https://my-app.localhost."));
-});
-// Upgrade command
-program
-    .command("upgrade")
-    .description("Upgrade dev3000 to the latest version")
-    .option("--check", "Only check for updates without upgrading")
-    .action(async (options) => {
-    console.log(chalk.cyan("Checking for updates...\n"));
-    const versionInfo = await checkForUpdates();
-    console.log(chalk.white(`Current version: ${chalk.yellow(versionInfo.currentVersion)}`));
-    if (versionInfo.latestVersion) {
-        console.log(chalk.white(`Latest version:  ${chalk.green(versionInfo.latestVersion)}`));
-    }
-    else {
-        console.log(chalk.gray("Could not fetch latest version from npm registry"));
-    }
-    if (!versionInfo.updateAvailable) {
-        console.log(chalk.green("\n✓ You're already on the latest version!"));
-        process.exit(0);
-    }
-    console.log(chalk.yellow(`\n↑ Update available: ${versionInfo.currentVersion} → ${versionInfo.latestVersion}`));
-    if (options.check) {
-        const upgradeCmd = getUpgradeCommand(versionInfo.packageManager);
-        console.log(chalk.cyan(`\nTo upgrade, run: ${chalk.white(upgradeCmd)}`));
-        console.log(chalk.gray(`Or run: ${chalk.white("d3k upgrade")}`));
-        process.exit(0);
-    }
-    console.log("");
-    const result = performUpgrade();
-    if (result.success) {
-        console.log(chalk.green("\n✓ Upgrade completed successfully!"));
-        console.log(chalk.gray("Run 'd3k --version' to verify the new version."));
-    }
-    else {
-        console.error(chalk.red(`\n✗ Upgrade failed: ${result.error}`));
-        const upgradeCmd = getUpgradeCommand(versionInfo.packageManager);
-        console.log(chalk.yellow(`\nTry running manually: ${chalk.white(upgradeCmd)}`));
-        process.exit(1);
-    }
-});
-// Agent-browser command - registered for --help display only
-// Actual handling happens at the top of the file before Commander runs
-program
-    .command("agent-browser [args...]")
-    .description("Run the bundled agent-browser CLI. `open` requires d3k's managed browser unless --allow-new-browser is passed.")
-    .allowUnknownOption(true);
-// Skill command - get skill content for use in prompts/workflows
-program
-    .command("skill [name]")
-    .description("Get skill content or list available skills")
-    .option("-l, --list", "List all available skills")
-    .option("-v, --verbose", "Show detailed skill information")
-    .action(async (name, options) => {
-    // List skills if --list flag or no name provided
-    if (options.list || !name) {
-        if (options.verbose) {
-            const skills = getSkillsInfo();
-            if (skills.length === 0) {
-                console.log(chalk.yellow("No skills found."));
-                console.log(chalk.gray("\nSkills are loaded from:"));
-                console.log(chalk.gray("  • .agents/skills/ (project-local)"));
-                console.log(chalk.gray("  • d3k built-in skills"));
-                process.exit(0);
-            }
-            console.log(chalk.cyan("Available skills:\n"));
-            for (const skill of skills) {
-                console.log(chalk.white(`  ${chalk.bold(skill.name)}`));
-                console.log(chalk.gray(`    ${skill.description}`));
-                console.log(chalk.gray(`    Path: ${skill.path}\n`));
-            }
-        }
-        else {
-            const skills = listAvailableSkills();
-            if (skills.length === 0) {
-                console.log(chalk.yellow("No skills found."));
-                process.exit(0);
-            }
-            console.log(chalk.cyan("Available skills:"));
-            for (const skill of skills) {
-                console.log(chalk.white(`  • ${skill}`));
-            }
-            console.log(chalk.gray("\nUse 'd3k skill <name>' to get skill content"));
-            console.log(chalk.gray("Use 'd3k skill --list --verbose' for details"));
-        }
-        process.exit(0);
-    }
-    // Get specific skill content
-    const result = getSkill(name);
-    if (!result.found) {
-        console.error(chalk.red(`Error: ${result.error}`));
-        if (result.availableSkills && result.availableSkills.length > 0) {
-            console.log(chalk.yellow("\nAvailable skills:"));
-            for (const skill of result.availableSkills) {
-                console.log(chalk.gray(`  • ${skill}`));
-            }
-        }
-        process.exit(1);
-    }
-    // Output skill content to stdout (no formatting, for piping/parsing)
-    console.log(result.content);
-});
-// Errors command - quick view of recent errors
-program
-    .command("errors")
-    .description("Show recent errors from d3k logs (browser + server)")
-    .option("-n, --count <count>", "Number of errors to show", "10")
-    .option("-a, --all", "Show all errors, not just recent")
-    .option("-c, --context", "Show interactions before each error (for replay)")
-    .option("--json", "Output as JSON for parsing")
-    .action(async (options) => {
-    const { showErrors } = await import("./commands/errors.js");
-    await showErrors(options);
-});
-// Logs command - view recent logs
-program
-    .command("logs")
-    .description("Show recent logs from d3k (browser + server)")
-    .option("-n, --count <count>", "Number of lines to show", "50")
-    .option("-t, --type <type>", "Filter by type: browser, server, network, all", "all")
-    .option("--json", "Output as JSON for parsing")
-    .action(async (options) => {
-    const { showLogs } = await import("./commands/logs.js");
-    await showLogs(options);
-});
-// Fix command - diagnose application errors from logs
-program
-    .command("fix")
-    .description("Diagnose application errors from d3k logs")
-    .option("-f, --focus <area>", "Focus area: build, runtime, network, ui, all", "all")
-    .option("-t, --time <minutes>", "Minutes to analyze back", "10")
-    .option("--json", "Output as JSON for parsing")
-    .action(async (options) => {
-    const { fixMyApp } = await import("./commands/fix.js");
-    await fixMyApp(options);
-});
-// Crawl command - discover app URLs
-program
-    .command("crawl")
-    .description("Discover URLs by crawling the app")
-    .option("-d, --depth <depth>", "Crawl depth (1, 2, 3, or 'all')", "1")
-    .option("-l, --limit <limit>", "Max links per page to follow", "3")
-    .action(async (options) => {
-    const { crawlApp } = await import("./commands/crawl.js");
-    await crawlApp(options);
-});
-program
-    .command("resume")
-    .description("Resume the last supported AI agent session for this project")
-    .action(async () => {
-    const { resumeLastAgent } = await import("./commands/resume.js");
-    await resumeLastAgent();
-});
-program
-    .command("status")
-    .description("Show whether this project's d3k runtime is ready")
-    .option("--json", "Output machine-readable runtime details")
-    .action(async (options) => {
-    const { printD3kStatus } = await import("./commands/status.js");
-    process.exitCode = printD3kStatus(options);
-});
-// CDP port command - get the CDP port from the session file
-program
-    .command("cdp-port")
-    .description("Output the CDP port for the current d3k session (for use in scripts)")
-    .action(() => {
-    console.log(getSessionCdpPort() || "9222");
-});
-program.parse();
+import "./runtime/cli.js";
 //# sourceMappingURL=cli.js.map