dev3000 0.0.167 → 0.0.168

package/dist/dev-environment.d.ts

@@ -38,6 +38,7 @@ export declare function gracefulKillProcess(options: GracefulKillOptions): Promi
 interface DevEnvironmentOptions {
     port: string;
     serverCommand: string;
+    startupTimeoutSeconds: number;
     profileDir: string;
     logFile: string;
     debug?: boolean;
@@ -125,12 +126,18 @@ export declare class DevEnvironment {
     private isSessionCwdOwned;
     private isPidRunning;
     private killServerPidIfOwned;
+    private killTrackedChromePids;
     private cleanupOrphanedServer;
     private acquireLock;
     private releaseLock;
     private detectPortChange;
     private debugLog;
     private showRecentLogs;
+    private getRecentLogLines;
+    private simplifyLogLine;
+    private inferStartupFailureHint;
+    private getStartupContextLines;
+    private writeStartupFailureContext;
     private checkForCommonIssues;
     private waitForServer;
     private initializeD3KLog;

package/dist/dev-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-environment.d.ts","sourceRoot":"","sources":["../src/dev-environment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev-environment.d.ts","sourceRoot":"","sources":["../src/dev-environment.ts"],"names":[],"mappings":"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"}

package/dist/dev-environment.js

@@ -2,10 +2,12 @@ import chalk from "chalk";
 import { spawn } from "child_process";
 import { appendFileSync, copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "fs";
 import https from "https";
+import { createServer } from "net";
 import ora from "ora";
 import { homedir, tmpdir } from "os";
 import { dirname, join, resolve, sep } from "path";
 import { fileURLToPath } from "url";
+import { stripVTControlCharacters } from "util";
 import { CDPMonitor } from "./cdp-monitor.js";
 import { ScreencastManager } from "./screencast-manager.js";
 import { NextJsErrorDetector, OutputProcessor, StandardLogParser } from "./services/parsers/index.js";
@@ -163,51 +165,27 @@ export function countActiveD3kInstances(excludeCurrentPid = false) {
 /**
  * Check if a port is available for binding (no process is listening on it).
  * Used for finding available ports before starting servers.
- * In sandbox environments, skips checking since lsof often doesn't exist.
  */
 async function isPortAvailable(port) {
-    // In sandboxed environments, skip port checking - lsof often doesn't exist
-    // and port conflicts are rare due to process isolation
-    if (isInSandbox()) {
-        return true;
+    const portNumber = Number.parseInt(port, 10);
+    if (!Number.isInteger(portNumber) || portNumber < 0 || portNumber > 65535) {
+        return false;
     }
-    // Regular environment - do proper port checking with lsof
-    try {
-        // Check if lsof command exists first
-        const checkCmd = process.platform === "win32" ? "where" : "which";
-        try {
-            await new Promise((resolve, reject) => {
-                const check = spawn(checkCmd, ["lsof"], { stdio: "pipe" });
-                check.on("error", reject);
-                check.on("exit", (code) => {
-                    if (code === 0)
-                        resolve();
-                    else
-                        reject(new Error("lsof not found"));
-                });
-            });
-        }
-        catch {
-            // lsof doesn't exist, assume port is available
-            return true;
-        }
-        // lsof exists, use it to check the port
-        const result = await new Promise((resolve, reject) => {
-            const proc = spawn("lsof", ["-ti", `:${port}`], { stdio: "pipe" });
-            let output = "";
-            proc.on("error", (err) => {
-                reject(err);
-            });
-            proc.stdout?.on("data", (data) => {
-                output += data.toString();
-            });
-            proc.on("exit", () => resolve(output.trim()));
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once("error", (error) => {
+            // EADDRINUSE/EACCES both mean we cannot bind this port.
+            if (error.code === "EADDRINUSE" || error.code === "EACCES") {
+                resolve(false);
+                return;
+            }
+            resolve(true);
         });
-        return !result; // If no output, port is available
-    }
-    catch {
-        return true; // Assume port is available if check fails
-    }
+        server.once("listening", () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(portNumber);
+    });
 }
 export async function isServerListening(port) {
     // Try HTTP first
@@ -859,11 +837,13 @@ export class DevEnvironment {
             await this.tui.updateStatus("Waiting for app...");
             const serverStarted = await this.waitForServer();
             if (!serverStarted) {
+                this.writeStartupFailureContext(`App did not become reachable within ${this.options.startupTimeoutSeconds} seconds.`, 30);
                 await this.tui.updateStatus("❌ Server failed to start");
-                console.error(chalk.red("\n❌ Your app server failed to start after 30 seconds."));
+                console.error(chalk.red(`\n❌ Your app server failed to start after ${this.options.startupTimeoutSeconds} seconds.`));
                 console.error(chalk.yellow(`Check the logs at ~/.d3k/${getProjectName()}/logs/ for errors.`));
                 console.error(chalk.yellow("Exiting without launching browser."));
-                process.exit(1);
+                await this.gracefulShutdown();
+                return;
             }
             // Update TUI with confirmed port (may have changed during server startup)
             this.tui.updateAppPort(this.options.port);
@@ -918,11 +898,13 @@ export class DevEnvironment {
             this.spinner.text = "Waiting for app...";
             const serverStarted = await this.waitForServer();
             if (!serverStarted) {
+                this.writeStartupFailureContext(`App did not become reachable within ${this.options.startupTimeoutSeconds} seconds.`, 30);
                 this.spinner.fail("Server failed to start");
-                console.error(chalk.red("\n❌ Your app server failed to start after 30 seconds."));
+                console.error(chalk.red(`\n❌ Your app server failed to start after ${this.options.startupTimeoutSeconds} seconds.`));
                 console.error(chalk.yellow(`Check the logs at ~/.d3k/${getProjectName()}/logs/ for errors.`));
                 console.error(chalk.yellow("Exiting without launching browser."));
-                process.exit(1);
+                await this.gracefulShutdown();
+                return;
             }
             // Legacy server removed - using CLI commands instead
             // await this.waitForMcpServer()
@@ -1034,6 +1016,7 @@ export class DevEnvironment {
                 const nodeModulesExists = existsSync(join(process.cwd(), "node_modules"));
                 // If it's an early exit and node_modules doesn't exist, show helpful message
                 if (isEarlyExit && !nodeModulesExists) {
+                    this.writeStartupFailureContext(`Server exited early with code ${code}.`, 30);
                     if (this.spinner?.isSpinning) {
                         this.spinner.fail("Server script failed to start - missing dependencies");
                     }
@@ -1048,6 +1031,7 @@ export class DevEnvironment {
                 }
                 // If it's an early exit but node_modules exists, it's still likely a configuration issue
                 if (isEarlyExit) {
+                    this.writeStartupFailureContext(`Server exited early with code ${code}.`, 30);
                     if (this.spinner?.isSpinning) {
                         this.spinner.fail(`Server script failed to start (exited with code ${code})`);
                     }
@@ -1067,6 +1051,7 @@ export class DevEnvironment {
                 // - Code 143: SIGTERM
                 const isFatalExit = code !== 0 && code !== 130 && code !== 143;
                 if (isFatalExit) {
+                    this.writeStartupFailureContext(`Server process exited with code ${code}.`, 30);
                     // Stop spinner and show error for fatal exits
                     if (this.spinner?.isSpinning) {
                         this.spinner.fail(`Server process exited with code ${code}`);
@@ -1157,6 +1142,26 @@ export class DevEnvironment {
             }
         }
     }
+    killTrackedChromePids(chromePids, reason) {
+        if (chromePids.length === 0)
+            return;
+        this.debugLog(`Killing tracked Chrome PIDs (${reason}): [${chromePids.join(", ")}]`);
+        for (const pid of chromePids) {
+            try {
+                process.kill(pid, "SIGTERM");
+            }
+            catch {
+                // Ignore - process may already be dead
+            }
+            try {
+                process.kill(pid, 0);
+                process.kill(pid, "SIGKILL");
+            }
+            catch {
+                // Ignore - process may already be dead
+            }
+        }
+    }
     cleanupOrphanedServer() {
         const projectName = getProjectName();
         const sessionInfo = getSessionInfo(projectName);
@@ -1310,6 +1315,79 @@ export class DevEnvironment {
             console.log(chalk.yellow(`💡 Check logs for details: ${this.options.logFile}`));
         }
     }
+    getRecentLogLines(limit = 30) {
+        try {
+            if (!existsSync(this.options.logFile))
+                return [];
+            const logContent = readFileSync(this.options.logFile, "utf8");
+            return logContent
+                .split("\n")
+                .map((line) => line.trimEnd())
+                .filter((line) => line.trim() && !line.includes("[STARTUP_FAILURE]") && !line.includes("[STARTUP_CONTEXT]"))
+                .slice(-limit);
+        }
+        catch {
+            return [];
+        }
+    }
+    simplifyLogLine(line) {
+        // Strip ANSI escapes + non-printables, then remove "[time] [source]" prefix.
+        const noAnsi = stripVTControlCharacters(line).replace(/[^\t\r\n -~]/g, "");
+        return noAnsi.replace(/^\[[^\]]+\]\s+\[[^\]]+\]\s+/, "");
+    }
+    inferStartupFailureHint(logLines) {
+        const joined = logLines.join("\n");
+        if (/ERR_PNPM_NO_SCRIPT/i.test(joined) || /Missing script:\s*dev/i.test(joined)) {
+            return "Missing package script. Pass --script or --command for this project.";
+        }
+        if (/EADDRINUSE|port .* in use/i.test(joined)) {
+            return "Port conflict detected. Try another --port or stop the process using that port.";
+        }
+        if (/Cannot find module|MODULE_NOT_FOUND|ENOENT/i.test(joined)) {
+            return "Dependency or path issue detected. Verify installs and command paths.";
+        }
+        if (/permission denied|EACCES/i.test(joined)) {
+            return "Permission issue detected. Check executable permissions and environment access.";
+        }
+        if (/\/\/:dev:ts:/i.test(joined) && !/vercel-site:dev:|Local:\s+http|Ready in/i.test(joined)) {
+            return "Background typegen/typecheck is running, but app server has not started yet. Use a longer timeout or run the app-specific dev command.";
+        }
+        if (/Starting compilation in watch mode/i.test(joined) && !/Local:\s+http|Ready in|listening on/i.test(joined)) {
+            return "Compiler watch mode started, but no app port was detected yet. This may need a longer startup timeout.";
+        }
+        return null;
+    }
+    getStartupContextLines(limit = 30) {
+        const recentLines = this.getRecentLogLines(200);
+        if (recentLines.length === 0)
+            return [];
+        const errorPattern = /(^|[\s:])(error|failed|fatal|exception|unhandled rejection|err_|eaddrinuse|module_not_found|missing script|not found|timeout)([\s:.,]|$)/i;
+        const ignorePattern = /Found 0 errors/i;
+        const errorLines = recentLines.filter((line) => errorPattern.test(line) && !ignorePattern.test(line));
+        // Prefer error-focused context when available; otherwise fall back to the latest lines.
+        if (errorLines.length > 0) {
+            const focused = errorLines.slice(-20);
+            const tail = recentLines.slice(-10);
+            return [...focused, ...tail].slice(-limit);
+        }
+        return recentLines.slice(-limit);
+    }
+    writeStartupFailureContext(reason, contextLines = 30) {
+        const context = this.getStartupContextLines(contextLines);
+        const hint = this.inferStartupFailureHint(context);
+        this.logger.log("server", `[STARTUP_FAILURE] ${reason}`);
+        this.logger.log("server", `[STARTUP_FAILURE] Command: ${this.options.serverCommand}`);
+        this.logger.log("server", `[STARTUP_FAILURE] Full logs: ${this.options.logFile}`);
+        if (hint) {
+            this.logger.log("server", `[STARTUP_HINT] ${hint}`);
+        }
+        if (context.length > 0) {
+            this.logger.log("server", `[STARTUP_CONTEXT] Selected ${context.length} relevant log lines:`);
+            for (const line of context) {
+                this.logger.log("server", `[STARTUP_CONTEXT] ${this.simplifyLogLine(line)}`);
+            }
+        }
+    }
     checkForCommonIssues() {
         try {
             if (!existsSync(this.options.logFile))
@@ -1337,7 +1415,7 @@ export class DevEnvironment {
         }
     }
     async waitForServer() {
-        const maxAttempts = 30;
+        const maxAttempts = this.options.startupTimeoutSeconds;
         let attempts = 0;
         const startTime = Date.now();
         this.debugLog(`Waiting for server to report its port...`);
@@ -1410,9 +1488,23 @@ export class DevEnvironment {
         }
         catch (error) {
             console.error(chalk.red("⚠️ CDP monitoring setup failed:"), error);
-            // CDP monitoring is critical - shutdown if it fails
-            this.gracefulShutdown();
-            throw error;
+            this.logger.log("browser", `[CDP] Monitoring startup failed: ${error}`);
+            this.logger.log("browser", "[CDP] Browser monitoring disabled; app server will continue running.");
+            if (this.tui) {
+                this.tui.updateStatus("⚠ Browser monitoring failed; continuing with server logs only");
+            }
+            // Best-effort cleanup of partially initialized monitor, but keep d3k running.
+            if (this.cdpMonitor) {
+                try {
+                    this.cdpMonitor.prepareShutdown();
+                    await this.cdpMonitor.shutdown();
+                }
+                catch {
+                    // Ignore cleanup errors; monitoring is already disabled
+                }
+                this.cdpMonitor = null;
+            }
+            this.debugLog(`CDP monitoring disabled due to startup failure: ${error instanceof Error ? error.message : error}`);
         }
     }
     async startCDPMonitoring() {
@@ -1573,6 +1665,8 @@ export class DevEnvironment {
         if (sessionInfo?.serverPid) {
             this.killServerPidIfOwned(sessionInfo.serverPid, sessionInfo.cwd, "graceful shutdown");
         }
+        // Always kill tracked Chrome processes, even if cdpMonitor is unavailable.
+        this.killTrackedChromePids(sessionInfo?.chromePids ?? [], "graceful shutdown");
         // Shutdown CDP monitor if it was started
         if (this.cdpMonitor) {
             try {
@@ -1813,8 +1907,6 @@ export class DevEnvironment {
                 }
                 // Fallback: force kill any remaining Chrome processes for THIS instance only
                 try {
-                    const projectName = getProjectName();
-                    const sessionInfo = getSessionInfo(projectName);
                     const chromePids = sessionInfo?.chromePids ?? [];
                     if (chromePids.length > 0) {
                         this.debugLog(`Fallback cleanup: killing Chrome PIDs for this instance: [${chromePids.join(", ")}]`);
@@ -1840,6 +1932,8 @@ export class DevEnvironment {
                 }
             }
         }
+        // Safety net: ensure tracked Chrome processes are always terminated on shutdown.
+        this.killTrackedChromePids(sessionInfo?.chromePids ?? [], "handleShutdown");
         // REMOVED: No longer clean up CLI config files on shutdown
         // This was causing Claude Code instances to crash when dev3000 was killed
         // Config file cleanup removed; keep user config files untouched on shutdown