@codeyam/codeyam-cli 0.1.0-staging.8421896 → 0.1.0-staging.8778565

package/codeyam-cli/src/utils/backgroundServer.js

@@ -1,27 +1,44 @@
-import { spawn } from 'child_process';
+import { spawn, execSync } from 'child_process';
 import * as path from 'path';
 import * as fs from 'fs';
 import { fileURLToPath } from 'url';
-import { isServerRunning, saveServerState, killServer } from "./serverState.js";
+import { isServerRunning, saveServerState, killServer, findFreePort, checkPortFree, } from "./serverState.js";
 import { cliVersion } from "./versionInfo.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export async function startBackgroundServer(options) {
-    const { port, rootPath, project, branch, processName = 'server' } = options;
-    const url = `http://localhost:${port}`;
+    let port = options.port;
+    const { rootPath, project, branch, processName = 'server' } = options;
     // Check if server is already running
-    const { running, state } = isServerRunning();
+    let isRestart = false;
+    const { running, state, pids } = isServerRunning();
     if (running && state) {
         // Check for version mismatch - restart if CLI was updated
         if (state.cliVersion !== cliVersion) {
             console.log(`CLI version mismatch (server: ${state.cliVersion ?? 'unknown'} → CLI: ${cliVersion}), restarting server...`);
-            killServer();
+            killServer(); // Waits up to 5s for old process to exit
+            isRestart = true;
             // Fall through to spawn new server
         }
         else {
             return { url: state.url, pid: state.pid, wasAlreadyRunning: true };
         }
     }
+    else if (running && pids && pids.length > 0) {
+        // Found codeyam-server processes without a state file for this project.
+        // These likely belong to another project — don't kill them.
+        // Instead, find a free port so both projects can run simultaneously.
+        if (!checkPortFree(port)) {
+            console.log(`[BackgroundServer] Port ${port} is in use by another project's server, finding a free port...`);
+            port = findFreePort(port, checkPortFree);
+            console.log(`[BackgroundServer] Using port ${port} instead`);
+        }
+        else {
+            // Port is free but there are orphaned processes (on other ports) — safe to proceed
+            console.log(`[BackgroundServer] Found ${pids.length} codeyam-server process(es) on other ports, port ${port} is free`);
+        }
+    }
+    const url = `http://localhost:${port}`;
     // Bootstrap new background server process
     const serverScriptPath = path.join(__dirname, '..', 'webserver', 'bootstrap.js');
     // Create log files for debugging
@@ -29,58 +46,137 @@ export async function startBackgroundServer(options) {
     if (!fs.existsSync(logDir)) {
         fs.mkdirSync(logDir, { recursive: true });
     }
-    const outLog = fs.openSync(path.join(logDir, 'background-server.log'), 'a');
-    const errLog = fs.openSync(path.join(logDir, 'background-server-error.log'), 'a');
-    const child = spawn('node', [serverScriptPath], {
-        // On Windows, detached:true creates a visible console window even with
-        // windowsHide:true due to how CREATE_NEW_PROCESS_GROUP interacts with
-        // CREATE_NO_WINDOW. Without detached, the child shares the parent's console
-        // (with stdio redirected to files) and no new window appears.
-        // The server still runs independently via child.unref().
-        detached: process.platform !== 'win32',
-        windowsHide: true,
-        stdio: ['ignore', outLog, errLog],
-        env: {
-            ...process.env,
-            CODEYAM_PORT: port.toString(),
-            CODEYAM_ROOT_PATH: rootPath,
-            CODEYAM_PROJECT: project ? JSON.stringify(project) : '',
-            CODEYAM_BRANCH: branch ? JSON.stringify(branch) : '',
-            CODEYAM_PROCESS_NAME: `codeyam-${processName}`,
-            // Explicitly pass through tracing env var for debugging
-            ...(process.env.CODEYAM_TRACE_TRANSFORMS
-                ? { CODEYAM_TRACE_TRANSFORMS: process.env.CODEYAM_TRACE_TRANSFORMS }
-                : {}),
-        },
-    });
-    // Detach the child process so it can run independently
-    child.unref();
+    const serverEnv = {
+        CODEYAM_PORT: port.toString(),
+        CODEYAM_ROOT_PATH: rootPath,
+        CODEYAM_PROJECT: project ? JSON.stringify(project) : '',
+        CODEYAM_BRANCH: branch ? JSON.stringify(branch) : '',
+        CODEYAM_PROCESS_NAME: `codeyam-${processName}`,
+        // On restart, tell bootstrap to wait for the old process to release the port
+        ...(isRestart ? { CODEYAM_WAIT_FOR_PORT: 'true' } : {}),
+        ...(process.env.CODEYAM_TRACE_TRANSFORMS
+            ? { CODEYAM_TRACE_TRANSFORMS: process.env.CODEYAM_TRACE_TRANSFORMS }
+            : {}),
+    };
+    let childPid;
+    if (process.platform === 'win32') {
+        childPid = await spawnServerWindows(serverScriptPath, serverEnv, logDir);
+    }
+    else {
+        const outLog = fs.openSync(path.join(logDir, 'background-server.log'), 'a');
+        const errLog = fs.openSync(path.join(logDir, 'background-server-error.log'), 'a');
+        const child = spawn('node', ['--max-old-space-size=8192', serverScriptPath], {
+            detached: true,
+            stdio: ['ignore', outLog, errLog],
+            env: { ...process.env, ...serverEnv },
+        });
+        child.unref();
+        childPid = child.pid;
+    }
+    // Verify the port is free before polling
+    try {
+        const portCheck = execSync(`lsof -ti:${port}`, { encoding: 'utf8' }).trim();
+        if (portCheck) {
+            const portPids = portCheck.split('\n');
+            const ownPid = portPids.find((p) => p === String(childPid));
+            const otherPids = portPids.filter((p) => p !== String(childPid));
+            if (otherPids.length > 0) {
+                console.warn(`[BackgroundServer] Port ${port} still held by other PID(s): ${otherPids.join(', ')} (server PID: ${childPid})`);
+            }
+            if (ownPid) {
+                console.log(`[BackgroundServer] Server PID ${childPid} is listening on port ${port}`);
+            }
+        }
+    }
+    catch {
+        // No process on port — expected during early startup
+    }
     // Poll health endpoint until server is ready (includes FileWatcher initial sync)
-    // This replaces the old arbitrary 1-second wait with actual readiness detection
-    const healthUrl = `${url}/api/health`;
+    // Use 127.0.0.1 instead of localhost to avoid IPv6 resolution issues with fetch
+    const healthUrl = `http://127.0.0.1:${port}/api/health`;
     const maxWaitMs = 60000; // 60 second timeout (initial sync can take time for large projects)
-    const pollIntervalMs = 200;
+    const pollIntervalMs = 500;
     const startTime = Date.now();
+    let lastError = '';
+    let progressLogged = false;
     while (Date.now() - startTime < maxWaitMs) {
+        // Check if the server process is still alive
+        try {
+            process.kill(childPid, 0); // Signal 0 = just check if process exists
+        }
+        catch {
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            console.error(`[BackgroundServer] Server process (PID ${childPid}) died after ${elapsed}s`);
+            // Show last few lines of the log
+            const logPath = path.join(logDir, 'background-server.log');
+            try {
+                const log = fs.readFileSync(logPath, 'utf8');
+                const lines = log.trim().split('\n');
+                const tail = lines.slice(-15).join('\n');
+                console.error(`[BackgroundServer] Last log lines:\n${tail}`);
+            }
+            catch {
+                console.error(`[BackgroundServer] Could not read log at: ${logPath}`);
+            }
+            // Also show error log
+            const errLogPath = path.join(logDir, 'background-server-error.log');
+            try {
+                const errLog = fs.readFileSync(errLogPath, 'utf8');
+                const errLines = errLog.trim().split('\n');
+                const errTail = errLines.slice(-15).join('\n');
+                if (errTail) {
+                    console.error(`[BackgroundServer] Error log:\n${errTail}`);
+                }
+            }
+            catch {
+                // No error log
+            }
+            break;
+        }
         try {
             const response = await fetch(healthUrl);
             if (response.ok) {
                 // Server is ready - health endpoint only available after full initialization
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                console.log(`[BackgroundServer] Server ready after ${elapsed}s`);
                 break;
             }
+            lastError = `HTTP ${response.status}`;
         }
-        catch {
-            // Connection refused or other error - server not ready yet
+        catch (err) {
+            lastError =
+                err instanceof Error ? err.message.split('\n')[0] : String(err);
+        }
+        // Log progress every 10 seconds so the user knows it's not stuck
+        const elapsed = Date.now() - startTime;
+        if (elapsed >= 10000 && !progressLogged) {
+            console.log(`[BackgroundServer] Still waiting for server... (${(elapsed / 1000).toFixed(0)}s, last: ${lastError})`);
+            progressLogged = true;
+        }
+        else if (elapsed >= 20000 && elapsed % 10000 < pollIntervalMs) {
+            console.log(`[BackgroundServer] Still waiting... (${(elapsed / 1000).toFixed(0)}s, last: ${lastError})`);
         }
         await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
     }
     // Check if we timed out
     if (Date.now() - startTime >= maxWaitMs) {
         console.warn(`[BackgroundServer] Warning: Server did not become ready within ${maxWaitMs / 1000}s`);
+        console.warn(`[BackgroundServer] Last error: ${lastError}`);
+        // Show log tail on timeout too
+        const logPath = path.join(logDir, 'background-server.log');
+        try {
+            const log = fs.readFileSync(logPath, 'utf8');
+            const lines = log.trim().split('\n');
+            const tail = lines.slice(-15).join('\n');
+            console.warn(`[BackgroundServer] Last log lines:\n${tail}`);
+        }
+        catch {
+            console.warn(`[BackgroundServer] Could not read log at: ${logPath}`);
+        }
     }
     // Save server state
     const serverState = {
-        pid: child.pid,
+        pid: childPid,
         port,
         url,
         startTime: Date.now(),
@@ -89,6 +185,69 @@ export async function startBackgroundServer(options) {
         cliVersion,
     };
     saveServerState(serverState);
-    return { url, pid: child.pid, wasAlreadyRunning: false };
+    return { url, pid: childPid, wasAlreadyRunning: false };
+}
+/**
+ * On Windows, Node's spawn with detached:true uses DETACHED_PROCESS |
+ * CREATE_NEW_PROCESS_GROUP flags, and windowsHide adds CREATE_NO_WINDOW.
+ * These flags conflict — the result is neither properly hidden nor properly
+ * detached (the process still gets killed by the parent's Job Object).
+ *
+ * Instead, we use PowerShell's Start-Process which creates a truly independent
+ * process with a hidden window via -WindowStyle Hidden.
+ *
+ * Flow: write .ps1 script that sets env vars and starts node directly →
+ * run PowerShell hidden → capture the node PID from stdout.
+ *
+ * Log redirection is handled by bootstrap.ts via the CODEYAM_LOG_DIR env var
+ * (since Start-Process -WindowStyle Hidden can't use -RedirectStandardOutput).
+ */
+async function spawnServerWindows(serverScriptPath, serverEnv, logDir) {
+    // Escape single quotes for PowerShell single-quoted strings (' → '')
+    const psEscape = (s) => s.replace(/'/g, "''");
+    // Build PowerShell script that sets env vars and starts node hidden
+    const psScriptPath = path.join(logDir, 'start-server.ps1');
+    const envLines = Object.entries(serverEnv).map(([key, val]) => `$env:${key} = '${psEscape(val)}'`);
+    fs.writeFileSync(psScriptPath, [
+        ...envLines,
+        // Tell bootstrap.ts to redirect stdout/stderr to log files
+        `$env:CODEYAM_LOG_DIR = '${psEscape(logDir)}'`,
+        // Start node with bootstrap.js in a hidden window
+        `$bootstrapPath = '${psEscape(serverScriptPath)}'`,
+        `$p = Start-Process -FilePath "node" -ArgumentList ('--max-old-space-size=8192', '"{0}"' -f $bootstrapPath) -WindowStyle Hidden -PassThru`,
+        `Write-Output $p.Id`,
+    ].join('\n'));
+    // Run PowerShell hidden to start the server and get the PID
+    return new Promise((resolve, reject) => {
+        const ps = spawn('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', psScriptPath], {
+            windowsHide: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        ps.stdout.on('data', (d) => {
+            stdout += d.toString();
+        });
+        ps.stderr.on('data', (d) => {
+            stderr += d.toString();
+        });
+        const timeout = setTimeout(() => {
+            ps.kill();
+            reject(new Error('Timed out waiting for PowerShell to start server (30s)'));
+        }, 30000);
+        ps.on('close', (code) => {
+            clearTimeout(timeout);
+            if (code !== 0) {
+                reject(new Error(`Failed to start server via PowerShell (exit ${code}): ${stderr}`));
+                return;
+            }
+            const pid = parseInt(stdout.trim(), 10);
+            if (isNaN(pid)) {
+                reject(new Error(`Failed to parse server PID from PowerShell output: ${stdout}`));
+                return;
+            }
+            resolve(pid);
+        });
+    });
 }
 //# sourceMappingURL=backgroundServer.js.map

package/codeyam-cli/src/utils/backgroundServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundServer.js","sourceRoot":"","sources":["../../../../src/utils/backgroundServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAU3C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgC;IAEhC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAEvC,qCAAqC;IACrC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,CAAC;IAC7C,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,0DAA0D;QAC1D,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CACT,iCAAiC,KAAK,CAAC,UAAU,IAAI,SAAS,WAAW,UAAU,yBAAyB,CAC7G,CAAC;YACF,UAAU,EAAE,CAAC;YACb,mCAAmC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,SAAS,EACT,IAAI,EACJ,WAAW,EACX,cAAc,CACf,CAAC;IAEF,iCAAiC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CACxB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,6BAA6B,CAAC,EAChD,GAAG,CACJ,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE;QAC9C,uEAAuE;QACvE,sEAAsE;QACtE,4EAA4E;QAC5E,8DAA8D;QAC9D,yDAAyD;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;QACtC,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE;YAC7B,iBAAiB,EAAE,QAAQ;YAC3B,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YACvD,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YACpD,oBAAoB,EAAE,WAAW,WAAW,EAAE;YAC9C,wDAAwD;YACxD,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB;gBACtC,CAAC,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE;gBACpE,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC,CAAC;IAEH,uDAAuD;IACvD,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,iFAAiF;IACjF,gFAAgF;IAChF,MAAM,SAAS,GAAG,GAAG,GAAG,aAAa,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,oEAAoE;IAC7F,MAAM,cAAc,GAAG,GAAG,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;YACxC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,6EAA6E;gBAC7E,MAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CACV,kEAAkE,SAAS,GAAG,IAAI,GAAG,CACtF,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG;QAClB,GAAG,EAAE,KAAK,CAAC,GAAI;QACf,IAAI;QACJ,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM;QACN,UAAU;KACX,CAAC;IAEF,eAAe,CAAC,WAAW,CAAC,CAAC;IAE7B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"backgroundServer.js","sourceRoot":"","sources":["../../../../src/utils/backgroundServer.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/utils/buildFlags.js

@@ -0,0 +1,4 @@
+export const IS_INTERNAL_BUILD = typeof false !== 'undefined'
+    ? false
+    : false;
+//# sourceMappingURL=buildFlags.js.map

package/codeyam-cli/src/utils/buildFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildFlags.js","sourceRoot":"","sources":["../../../../src/utils/buildFlags.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,0BAA0B,KAAK,WAAW;IAC/C,CAAC,CAAC,0BAA0B;IAC5B,CAAC,CAAC,KAAK,CAAC"}

package/codeyam-cli/src/utils/devModeEvents.js

@@ -0,0 +1,40 @@
+import { EventEmitter } from 'events';
+/**
+ * Shared event emitter for dev mode file sync events.
+ * The InteractiveSyncWatcher emits events to this, and the
+ * SSE endpoint (api.dev-mode-events.ts) streams them to the browser.
+ *
+ * Uses a global variable to ensure the CLI's job runner and the Vite SSR
+ * webserver routes share the exact same singleton instance, even though
+ * they're compiled by different bundlers.
+ */
+class DevModeEventEmitter extends EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(20);
+    }
+    emitFileSynced(fileName, filePath) {
+        this.emit('event', {
+            type: 'file-synced',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+    emitError(fileName, filePath) {
+        this.emit('event', {
+            type: 'sync-error',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+}
+// Use a global singleton to ensure the same instance is shared between
+// the CLI's TypeScript compilation and Vite's SSR compilation
+const GLOBAL_KEY = '__codeyam_dev_mode_event_emitter__';
+if (!globalThis[GLOBAL_KEY]) {
+    globalThis[GLOBAL_KEY] = new DevModeEventEmitter();
+}
+export const devModeEventEmitter = globalThis[GLOBAL_KEY];
+//# sourceMappingURL=devModeEvents.js.map

package/codeyam-cli/src/utils/devModeEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devModeEvents.js","sourceRoot":"","sources":["../../../../src/utils/devModeEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,mBAAoB,SAAQ,YAAY;IAC5C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,QAAgB;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,QAAgB;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,YAAY;YAClB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAED,uEAAuE;AACvE,8DAA8D;AAC9D,MAAM,UAAU,GAAG,oCAAoC,CAAC;AACxD,IAAI,CAAE,UAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;IACpC,UAAkB,CAAC,UAAU,CAAC,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAyB,UAAkB,CACzE,UAAU,CACX,CAAC"}

package/codeyam-cli/src/utils/devServerState.js

@@ -0,0 +1,71 @@
+/**
+ * Pure state transition logic for the editor dev server.
+ *
+ * Extracted from the inline polling effect in editor.tsx so the
+ * state machine can be unit-tested without React or network concerns.
+ */
+/**
+ * Given the current dev server state and an API poll response, compute
+ * the next state. This is a pure function with no side effects.
+ */
+export function computeDevServerTransition(current, response) {
+    if (response.status === 'error') {
+        return {
+            url: null,
+            proxyUrl: null,
+            isStarting: false,
+            error: response.errorMessage || 'Dev server crashed',
+            canStartServer: current.canStartServer,
+            autoStartAttempted: current.autoStartAttempted,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.url) {
+        return {
+            url: response.url,
+            proxyUrl: response.proxyUrl || null,
+            isStarting: false,
+            error: null,
+            canStartServer: true,
+            autoStartAttempted: current.autoStartAttempted,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.status === 'starting') {
+        return {
+            ...current,
+            isStarting: true,
+            error: null,
+            canStartServer: true,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.status === 'stopped') {
+        if (current.url) {
+            // Server was running but now stopped unexpectedly
+            return {
+                ...current,
+                url: null,
+                isStarting: false,
+                shouldAutoStart: false,
+            };
+        }
+        if (!current.autoStartAttempted) {
+            // First load with no server running — signal auto-start
+            return {
+                ...current,
+                autoStartAttempted: true,
+                shouldAutoStart: true,
+            };
+        }
+        // Already attempted — ensure spinner is off
+        return {
+            ...current,
+            isStarting: false,
+            shouldAutoStart: false,
+        };
+    }
+    // Unknown status — no changes
+    return { ...current, shouldAutoStart: false };
+}
+//# sourceMappingURL=devServerState.js.map

package/codeyam-cli/src/utils/devServerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServerState.js","sourceRoot":"","sources":["../../../../src/utils/devServerState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB,EACvB,QAA8B;IAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,QAAQ,CAAC,YAAY,IAAI,oBAAoB;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACnC,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,kDAAkD;YAClD,OAAO;gBACL,GAAG,OAAO;gBACV,GAAG,EAAE,IAAI;gBACT,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,KAAK;aACvB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAChC,wDAAwD;YACxD,OAAO;gBACL,GAAG,OAAO;gBACV,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;aACtB,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}

package/codeyam-cli/src/utils/editorApi.js

@@ -0,0 +1,73 @@
+/**
+ * Editor API request builder.
+ *
+ * Maps editor subcommand names + optional JSON args to API request descriptors.
+ * Used by `codeyam editor <subcommand>` to avoid raw curl calls,
+ * which lets Claude Code auto-approve these operations.
+ */
+const SUBCOMMAND_MAP = {
+    preview: (jsonArg) => ({
+        method: 'POST',
+        endpoint: '/api/dev-mode-preview',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'show-results': () => ({
+        method: 'POST',
+        endpoint: '/api/editor-show-results',
+    }),
+    'hide-results': () => ({
+        method: 'POST',
+        endpoint: '/api/editor-hide-results',
+    }),
+    commit: (jsonArg) => ({
+        method: 'POST',
+        endpoint: '/api/editor-commit',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    journal: (jsonArg) => ({
+        method: 'POST',
+        endpoint: '/api/editor-journal-entry',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'journal-update': (jsonArg) => ({
+        method: 'PATCH',
+        endpoint: '/api/editor-journal-update',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'dev-server': (jsonArg) => ({
+        method: jsonArg ? 'POST' : 'GET',
+        endpoint: '/api/editor-dev-server',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'journal-list': () => ({
+        method: 'GET',
+        endpoint: '/api/editor-journal',
+    }),
+    'client-errors': () => ({
+        method: 'GET',
+        endpoint: '/api/editor-client-errors',
+    }),
+};
+export function buildEditorApiRequest(subcommand, jsonArg) {
+    const builder = SUBCOMMAND_MAP[subcommand];
+    if (!builder) {
+        throw new Error(`Unknown editor subcommand: ${subcommand}`);
+    }
+    return builder(jsonArg);
+}
+/**
+ * Execute an editor API request against the local server.
+ */
+export async function callEditorApi(request, port) {
+    const url = `http://localhost:${port}${request.endpoint}`;
+    const options = { method: request.method };
+    if (request.body) {
+        options.headers = { 'Content-Type': 'application/json' };
+        options.body = JSON.stringify(request.body);
+    }
+    const res = await fetch(url, options);
+    const data = await res.json().catch(() => null);
+    return { ok: res.ok, status: res.status, data };
+}
+export const EDITOR_API_SUBCOMMANDS = Object.keys(SUBCOMMAND_MAP);
+//# sourceMappingURL=editorApi.js.map

package/codeyam-cli/src/utils/editorApi.js.map

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