@codeyam/codeyam-cli 0.1.0-staging.8df382d → 0.1.0-staging.a890816

package/codeyam-cli/src/webserver/build/server/index.js

@@ -1 +1 @@
-import{Y as H,Z as I,M as J,N as K,W as L,O as _,R as $,T as rr,V as tr,U as or,X as ir,Q as pr}from"./assets/server-build-69rRZnZo.js";import"react/jsx-runtime";import"node:stream";import"@react-router/node";import"react-router";import"isbot";import"react-dom/server";import"react";import"lucide-react";import"fetch-retry";import"better-sqlite3";import"pg";import"fs";import"path";import"kysely";import"kysely/helpers/sqlite";import"kysely/helpers/postgres";import"typescript";import"fs/promises";import"os";import"prompts";import"chalk";import"crypto";import"child_process";import"url";import"util";import"dotenv";import"events";import"uuid";import"openai";import"p-queue";import"p-retry";import"@aws-sdk/client-dynamodb";import"lru-cache";import"pluralize";import"piscina";import"json5";import"@aws-sdk/util-dynamodb";import"v8";import"react-syntax-highlighter";import"react-syntax-highlighter/dist/cjs/styles/prism/index.js";import"node:crypto";import"minimatch";import"react-markdown";import"remark-gfm";import"react-diff-viewer-continued";export{H as allowedActionOrigins,I as assets,J as assetsBuildDirectory,K as basename,L as entry,_ as future,$ as isSpaMode,rr as prerender,tr as publicPath,or as routeDiscovery,ir as routes,pr as ssr};
+import{Z as K,_ as L,N as $,O as rr,X as tr,Q as or,T as ir,U as pr,W as mr,V as sr,Y as ar,R as er}from"./assets/server-build-OdUocH6P.js";import"react/jsx-runtime";import"node:stream";import"@react-router/node";import"react-router";import"isbot";import"react-dom/server";import"react";import"lucide-react";import"fetch-retry";import"better-sqlite3";import"pg";import"fs";import"path";import"kysely";import"kysely/helpers/sqlite";import"kysely/helpers/postgres";import"typescript";import"fs/promises";import"os";import"prompts";import"chalk";import"crypto";import"child_process";import"url";import"util";import"dotenv";import"events";import"uuid";import"http";import"net";import"ws";import"node-pty";import"openai";import"p-queue";import"p-retry";import"@aws-sdk/client-dynamodb";import"lru-cache";import"pluralize";import"piscina";import"json5";import"@aws-sdk/util-dynamodb";import"v8";import"react-syntax-highlighter";import"react-syntax-highlighter/dist/cjs/styles/prism/index.js";import"node:crypto";import"minimatch";import"react-markdown";import"remark-gfm";import"react-diff-viewer-continued";export{K as allowedActionOrigins,L as assets,$ as assetsBuildDirectory,rr as basename,tr as entry,or as future,ir as isSpaMode,pr as prerender,mr as publicPath,sr as routeDiscovery,ar as routes,er as ssr};

package/codeyam-cli/src/webserver/build-info.json

@@ -1,7 +1,7 @@
 {
-  "buildTimestamp": "2026-02-24T16:13:21.451Z",
-  "buildTime": 1771949601451,
-  "buildNumber": 694,
-  "semanticVersion": "0.1.694",
-  "version": "0.1.694 (2026-02-24T16:13)"
+  "buildTimestamp": "2026-03-02T01:13:38.736Z",
+  "buildTime": 1772414018736,
+  "buildNumber": 831,
+  "semanticVersion": "0.1.831",
+  "version": "0.1.831 (2026-03-02T01:13)"
 }

package/codeyam-cli/src/webserver/devServer.js

@@ -6,7 +6,10 @@ import { AnalysisQueue } from "../utils/queue/manager.js";
 import { ProxyQueue } from "../utils/queue/proxyQueue.js";
 import { detectRunningServer } from "../utils/queue/serverDetection.js";
 import { dbNotifier } from "./app/lib/dbNotifier.js";
+import { initializeEnvironment } from "../utils/database.js";
+import { updateProjectMetadata } from "../../../packages/database/index.js";
 import path from 'path';
+import fs from 'fs';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -24,6 +27,28 @@ console.log('⏳ Waiting for initial build to complete...');
 // }
 console.log('✅ Build found, starting server...');
 console.log(`🚀 Starting Remix dev server on port ${port}...`);
+// Auto-enable labs + simulations in dev mode so developers don't need to unlock manually
+async function enableLabsForDev() {
+    try {
+        const configPath = path.join(rootPath, '.codeyam', 'config.json');
+        const config = JSON.parse(await fs.promises.readFile(configPath, 'utf8'));
+        const projectSlug = config.projectSlug;
+        if (!projectSlug)
+            return;
+        await initializeEnvironment();
+        await updateProjectMetadata({
+            projectSlug,
+            metadataUpdate: {
+                labs: { accessGranted: true, simulations: true },
+            },
+        });
+        console.log('🔓 Labs & Simulations auto-enabled for dev mode');
+    }
+    catch (error) {
+        // Non-fatal — dev server works fine without this
+        console.warn('⚠️  Could not auto-enable labs:', error);
+    }
+}
 // Initialize queue - either proxy to background server or local queue
 async function initializeQueue() {
     // Check if a background server is already running
@@ -45,13 +70,17 @@ async function initializeQueue() {
     }
 }
 initializeQueue()
-    .then((queue) => {
+    .then(async (queue) => {
     console.log('[Dev Server] Queue initialized');
+    await enableLabsForDev();
     startRemixServer({
         port,
         analysisQueue: queue, // ProxyQueue implements same interface
     })
-        .then(({ url, server }) => {
+        .then(async ({ url, server }) => {
+        // Attach WebSocket terminal server for dev mode embedded Claude Code
+        const { attachTerminalServer } = await import('./terminalServer.js');
+        attachTerminalServer(server);
         console.log(`✅ Remix server running at ${url}`);
         console.log(`📁 Root path: ${rootPath}`);
         // Show additional info if using proxy queue
@@ -73,16 +102,21 @@ initializeQueue()
         process.exit(1);
     });
     // Handle graceful shutdown
-    const shutdown = () => {
+    const shutdown = async () => {
         console.log('\n📴 Remix server shutting down...');
+        try {
+            const { cleanupAllTerminalSessions } = await import('./terminalServer.js');
+            cleanupAllTerminalSessions();
+        }
+        catch { }
         // Clean up proxy queue file watcher if applicable
         if (queue instanceof ProxyQueue) {
             queue.stop();
         }
         process.exit(0);
     };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', () => void shutdown());
+    process.on('SIGTERM', () => void shutdown());
 })
     .catch((error) => {
     console.error('❌ Failed to initialize queue:', error);

package/codeyam-cli/src/webserver/devServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../../../src/webserver/devServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../../../src/webserver/devServer.ts"],"names":[],"mappings":";AAEA,iDAAiD;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,6DAA6D;AAC7D,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,aAAa,CAAC;AAErC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC;AAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAEhE,oDAAoD;AACpD,cAAc,CAAC,QAAQ,CAAC,CAAC;AAEzB,iDAAiD;AACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACtE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC1D,sCAAsC;AACtC,4DAA4D;AAC5D,IAAI;AACJ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAEjD,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,KAAK,CAAC,CAAC;AAE/D,yFAAyF;AACzF,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,qBAAqB,EAAE,CAAC;QAC9B,MAAM,qBAAqB,CAAC;YAC1B,WAAW;YACX,cAAc,EAAE;gBACd,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;aACjD;SACF,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iDAAiD;QACjD,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,KAAK,UAAU,eAAe;IAC5B,kDAAkD;IAClD,MAAM,aAAa,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE1D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACT,4CAA4C,aAAa,CAAC,GAAG,UAAU,aAAa,CAAC,GAAG,GAAG,CAC5F,CAAC;QACF,OAAO,CAAC,GAAG,CACT,iEAAiE,CAClE,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE;YAC9D,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9D,aAAa,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED,eAAe,EAAE;KACd,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAE9C,MAAM,gBAAgB,EAAE,CAAC;IAEzB,gBAAgB,CAAC;QACf,IAAI;QACJ,aAAa,EAAE,KAAsB,EAAE,uCAAuC;KAC/E,CAAC;SACC,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,qEAAqE;QACrE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACrE,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAEzC,4CAA4C;QAC5C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,mCAAmC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,8DAA8D;QAC9D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,WAAW,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,EAAE,0BAA0B,EAAE,GAClC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACtC,0BAA0B,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,kDAAkD;QAClD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/webserver/editorProxy.js

@@ -0,0 +1,272 @@
+import http from 'http';
+import net from 'net';
+import fs from 'fs';
+import path from 'path';
+import { getProjectRoot } from "../state.js";
+// Global key so the proxy survives HMR
+const GLOBAL_KEY = '__codeyam_editor_proxy__';
+const CACHE_TTL_MS = 500;
+let scenarioCache = { data: null, timestamp: 0 };
+function getProxyState() {
+    return globalThis[GLOBAL_KEY] ?? null;
+}
+function setProxyState(state) {
+    globalThis[GLOBAL_KEY] = state;
+}
+/**
+ * Get the proxy URL if the proxy is running.
+ */
+export function getProxyUrl() {
+    const state = getProxyState();
+    if (!state)
+        return null;
+    return `http://localhost:${state.port}`;
+}
+/**
+ * Read the active scenario's mock data from disk, with brief caching.
+ */
+function readScenarioData() {
+    const now = Date.now();
+    if (scenarioCache.data !== null &&
+        now - scenarioCache.timestamp < CACHE_TTL_MS) {
+        return scenarioCache.data;
+    }
+    const projectRoot = getProjectRoot() || process.env.CODEYAM_ROOT_PATH || process.cwd();
+    const activeScenarioPath = path.join(projectRoot, '.codeyam', 'active-scenario.json');
+    try {
+        if (!fs.existsSync(activeScenarioPath)) {
+            scenarioCache = { data: null, timestamp: now };
+            return null;
+        }
+        const active = JSON.parse(fs.readFileSync(activeScenarioPath, 'utf-8'));
+        const scenarioId = active.scenarioId;
+        if (!scenarioId) {
+            scenarioCache = { data: null, timestamp: now };
+            return null;
+        }
+        const dataFilePath = path.join(projectRoot, '.codeyam', 'editor-scenarios', `${scenarioId}.json`);
+        if (!fs.existsSync(dataFilePath)) {
+            console.log(`[editorProxy] Scenario data file not found: ${dataFilePath}`);
+            scenarioCache = { data: null, timestamp: now };
+            return null;
+        }
+        const data = JSON.parse(fs.readFileSync(dataFilePath, 'utf-8'));
+        scenarioCache = { data, timestamp: now };
+        return data;
+    }
+    catch (err) {
+        console.warn('[editorProxy] Error reading scenario data:', err);
+        scenarioCache = { data: null, timestamp: now };
+        return null;
+    }
+}
+/**
+ * Find a matching route in the scenario data.
+ *
+ * Supports two formats:
+ * - New route-keyed: { "routes": { "/api/drinks": { "body": [...] } } }
+ * - Legacy key-based: { "drinks": [...] } → matches /api/drinks
+ */
+export function findMatchingRoute(pathname, scenarioData) {
+    // New format: check routes map
+    const routes = scenarioData.routes;
+    if (routes && typeof routes === 'object') {
+        const routeEntry = routes[pathname];
+        if (routeEntry && typeof routeEntry === 'object') {
+            const entry = routeEntry;
+            return {
+                body: entry.body ?? routeEntry,
+                status: typeof entry.status === 'number' ? entry.status : 200,
+            };
+        }
+    }
+    // Legacy format: key "drinks" matches "/api/drinks"
+    // Extract the last segment of the path after /api/
+    const apiMatch = pathname.match(/^\/api\/(.+)$/);
+    if (apiMatch) {
+        const key = apiMatch[1];
+        if (key in scenarioData && key !== 'routes') {
+            return { body: scenarioData[key], status: 200 };
+        }
+    }
+    return null;
+}
+/**
+ * Forward an HTTP request to the target dev server.
+ */
+function forwardRequest(req, res, targetUrl) {
+    const target = new URL(targetUrl);
+    const options = {
+        hostname: target.hostname,
+        port: target.port,
+        path: req.url,
+        method: req.method,
+        headers: { ...req.headers, host: `${target.hostname}:${target.port}` },
+    };
+    const proxyReq = http.request(options, (proxyRes) => {
+        res.writeHead(proxyRes.statusCode || 200, proxyRes.headers);
+        proxyRes.pipe(res, { end: true });
+    });
+    proxyReq.on('error', (err) => {
+        console.warn(`[editorProxy] Forward error for ${req.method} ${req.url}: ${err.message}`);
+        if (!res.headersSent) {
+            res.writeHead(502, { 'Content-Type': 'text/plain' });
+            res.end('Bad Gateway — dev server unreachable');
+        }
+    });
+    req.pipe(proxyReq, { end: true });
+}
+/**
+ * Handle WebSocket upgrade by piping to the target dev server.
+ */
+function handleUpgrade(req, socket, head, targetUrl) {
+    const target = new URL(targetUrl);
+    const port = parseInt(target.port, 10) || 80;
+    console.log(`[editorProxy] WebSocket upgrade: ${req.url} → ${target.hostname}:${port}`);
+    const proxySocket = net.connect(port, target.hostname, () => {
+        // Reconstruct the HTTP upgrade request
+        const requestLine = `${req.method} ${req.url} HTTP/${req.httpVersion}\r\n`;
+        const headers = Object.entries(req.headers)
+            .filter(([, v]) => v != null)
+            .map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(', ') : v}`)
+            .join('\r\n');
+        proxySocket.write(requestLine + headers + '\r\n\r\n');
+        if (head.length > 0) {
+            proxySocket.write(head);
+        }
+        // Pipe both directions
+        proxySocket.pipe(socket, { end: true });
+        socket.pipe(proxySocket, { end: true });
+    });
+    proxySocket.on('error', (err) => {
+        console.warn(`[editorProxy] WebSocket proxy error: ${err.message}`);
+        socket.destroy();
+    });
+    socket.on('error', () => {
+        proxySocket.destroy();
+    });
+}
+/**
+ * Start the editor proxy server.
+ * Intercepts GET requests to API routes matching the active scenario, forwards everything else.
+ */
+export async function startEditorProxy(options) {
+    // Stop existing proxy first
+    await stopEditorProxy();
+    const { targetUrl } = options;
+    let port = options.port;
+    console.log(`[editorProxy] Starting proxy (requested port ${port}, target ${targetUrl})`);
+    const server = http.createServer((req, res) => {
+        const parsedUrl = new URL(req.url || '/', `http://localhost:${port}`);
+        const pathname = parsedUrl.pathname;
+        // Only intercept GET requests
+        if (req.method === 'GET') {
+            const scenarioData = readScenarioData();
+            if (scenarioData) {
+                const match = findMatchingRoute(pathname, scenarioData);
+                if (match) {
+                    console.log(`[editorProxy] Intercepted ${req.method} ${pathname} → scenario data (status ${match.status})`);
+                    res.writeHead(match.status, {
+                        'Content-Type': 'application/json',
+                        'Access-Control-Allow-Origin': '*',
+                        'X-CodeYam-Proxy': 'scenario-data',
+                    });
+                    res.end(JSON.stringify(match.body));
+                    return;
+                }
+            }
+        }
+        // Forward everything else to the dev server
+        forwardRequest(req, res, targetUrl);
+    });
+    // Handle WebSocket upgrades (for HMR)
+    server.on('upgrade', (req, socket, head) => {
+        handleUpgrade(req, socket, head, targetUrl);
+    });
+    // Try to bind, with port fallback
+    const maxAttempts = 10;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const currentPort = port + attempt;
+        try {
+            await new Promise((resolve, reject) => {
+                server.once('error', reject);
+                server.listen(currentPort, '0.0.0.0', () => {
+                    server.removeListener('error', reject);
+                    resolve();
+                });
+            });
+            port = currentPort;
+            const state = { server, port, targetUrl };
+            setProxyState(state);
+            console.log(`[editorProxy] Proxy started on port ${port}, forwarding to ${targetUrl}`);
+            return { port };
+        }
+        catch (err) {
+            if (err?.code === 'EADDRINUSE' && attempt < maxAttempts - 1) {
+                console.log(`[editorProxy] Port ${currentPort} in use, trying ${currentPort + 1}`);
+                continue;
+            }
+            console.error(`[editorProxy] Failed to start proxy:`, err);
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Stop the editor proxy server.
+ */
+export async function stopEditorProxy() {
+    const state = getProxyState();
+    if (!state)
+        return;
+    console.log(`[editorProxy] Stopping proxy on port ${state.port}`);
+    return new Promise((resolve) => {
+        state.server.close(() => {
+            console.log('[editorProxy] Proxy stopped');
+            resolve();
+        });
+        setProxyState(null);
+        // Force-close after 2s if graceful close doesn't happen
+        setTimeout(resolve, 2000);
+    });
+}
+/**
+ * Invalidate the scenario data cache (e.g., after writing a new active-scenario.json).
+ */
+export function invalidateScenarioCache() {
+    scenarioCache = { data: null, timestamp: 0 };
+}
+/**
+ * Ensure the proxy is running. If it's not, start it using the current dev server URL.
+ * Returns the proxy URL once ready, or null if it can't be started.
+ *
+ * Used by capture flows to guarantee the proxy is listening before Playwright navigates.
+ */
+export async function ensureProxyRunning() {
+    // Already running?
+    const existing = getProxyUrl();
+    if (existing) {
+        console.log(`[editorProxy] Proxy already running at ${existing}`);
+        return existing;
+    }
+    // Try to start it — we need the dev server URL
+    const devServer = globalThis.__codeyam_editor_dev_server__;
+    if (!devServer || devServer.status !== 'running' || !devServer.url) {
+        console.log('[editorProxy] Cannot start proxy — dev server not running');
+        return null;
+    }
+    const codeyamPort = parseInt(process.env.CODEYAM_PORT || '3111', 10);
+    console.log(`[editorProxy] Proxy not running, starting on-demand (port ${codeyamPort + 1}, target ${devServer.url})`);
+    const result = await startEditorProxy({
+        port: codeyamPort + 1,
+        targetUrl: devServer.url,
+    });
+    if (result) {
+        const url = `http://localhost:${result.port}`;
+        console.log(`[editorProxy] On-demand proxy started at ${url}`);
+        return url;
+    }
+    console.error('[editorProxy] Failed to start on-demand proxy');
+    return null;
+}
+//# sourceMappingURL=editorProxy.js.map

package/codeyam-cli/src/webserver/editorProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorProxy.js","sourceRoot":"","sources":["../../../../src/webserver/editorProxy.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,uCAAuC;AACvC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAa9C,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,IAAI,aAAa,GAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAEhE,SAAS,aAAa;IACpB,OAAQ,UAAkB,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,KAAwB;IAC5C,UAAkB,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IACE,aAAa,CAAC,IAAI,KAAK,IAAI;QAC3B,GAAG,GAAG,aAAa,CAAC,SAAS,GAAG,YAAY,EAC5C,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GACf,cAAc,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrE,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAClC,WAAW,EACX,UAAU,EACV,sBAAsB,CACvB,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACvC,aAAa,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,aAAa,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,GAAG,UAAU,OAAO,CACrB,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CACT,+CAA+C,YAAY,EAAE,CAC9D,CAAC;YACF,aAAa,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,aAAa,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;QAChE,aAAa,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,YAAqC;IAErC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,MAA6C,CAAC;IAC1E,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,UAAqC,CAAC;YACpD,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;gBAC9B,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,mDAAmD;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,GAAyB,EACzB,GAAwB,EACxB,SAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,OAAO,GAAwB;QACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,GAAG,CAAC,GAAG;QACb,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE;KACvE,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QAClD,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5D,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC3B,OAAO,CAAC,IAAI,CACV,mCAAmC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAC3E,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;YACrD,GAAG,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,GAAyB,EACzB,MAAkB,EAClB,IAAY,EACZ,SAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAE7C,OAAO,CAAC,GAAG,CACT,oCAAoC,GAAG,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAC3E,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE;QAC1D,uCAAuC;QACvC,MAAM,WAAW,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,WAAW,MAAM,CAAC;QAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,WAAW,CAAC,KAAK,CAAC,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,uBAAuB;QACvB,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC9B,OAAO,CAAC,IAAI,CAAC,wCAAwC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,WAAW,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAGtC;IACC,4BAA4B;IAC5B,MAAM,eAAe,EAAE,CAAC;IAExB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9B,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAExB,OAAO,CAAC,GAAG,CACT,gDAAgD,IAAI,YAAY,SAAS,GAAG,CAC7E,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAEpC,8BAA8B;QAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;YACxC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBACxD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,GAAG,CACT,6BAA6B,GAAG,CAAC,MAAM,IAAI,QAAQ,4BAA4B,KAAK,CAAC,MAAM,GAAG,CAC/F,CAAC;oBACF,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE;wBAC1B,cAAc,EAAE,kBAAkB;wBAClC,6BAA6B,EAAE,GAAG;wBAClC,iBAAiB,EAAE,eAAe;qBACnC,CAAC,CAAC;oBACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;oBACpC,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACzC,aAAa,CAAC,GAAG,EAAE,MAAoB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE;oBACzC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBACvC,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,GAAG,WAAW,CAAC;YACnB,MAAM,KAAK,GAAe,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YACtD,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,CAAC,GAAG,CACT,uCAAuC,IAAI,mBAAmB,SAAS,EAAE,CAC1E,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,EAAE,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;gBAC5D,OAAO,CAAC,GAAG,CACT,sBAAsB,WAAW,mBAAmB,WAAW,GAAG,CAAC,EAAE,CACtE,CAAC;gBACF,SAAS;YACX,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAElE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,wDAAwD;QACxD,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,aAAa,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,mBAAmB;IACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,MAAM,SAAS,GAAI,UAAkB,CAAC,6BAA6B,CAAC;IACpE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CACT,6DAA6D,WAAW,GAAG,CAAC,YAAY,SAAS,CAAC,GAAG,GAAG,CACzG,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;QACpC,IAAI,EAAE,WAAW,GAAG,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC,GAAG;KACzB,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,4CAA4C,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/codeyam-cli/src/webserver/scripts/journalCapture.ts

@@ -0,0 +1,140 @@
+#!/usr/bin/env npx tsx
+/**
+ * Lightweight Playwright script for journal screenshots.
+ * No DB lookups, no mock data regeneration — just navigate and screenshot.
+ *
+ * Usage: npx tsx journalCapture.ts '<json-args>'
+ * Args: { url, outputPath, viewportWidth?, viewportHeight? }
+ */
+
+import { chromium } from 'playwright';
+
+interface CaptureArgs {
+  url: string;
+  outputPath: string;
+  viewportWidth?: number;
+  viewportHeight?: number;
+  /** CSS selector for element-level screenshot (e.g. '#codeyam-capture').
+   *  If provided, screenshots just that element instead of the full page. */
+  selector?: string;
+}
+
+const MAX_RETRIES = 2;
+const GOTO_TIMEOUT_MS = 15_000;
+const SETTLE_DELAY_MS = 500;
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length < 1) {
+    console.error('Usage: journalCapture.ts <json-args>');
+    process.exit(1);
+  }
+
+  const config: CaptureArgs = JSON.parse(args[0]);
+  const {
+    url,
+    outputPath,
+    viewportWidth = 1280,
+    viewportHeight = 720,
+    selector,
+  } = config;
+
+  console.log(`[JournalCapture] URL: ${url}`);
+  console.log(`[JournalCapture] Output: ${outputPath}`);
+  console.log(`[JournalCapture] Viewport: ${viewportWidth}x${viewportHeight}`);
+
+  const browser = await chromium.launch({ headless: true });
+
+  try {
+    const context = await browser.newContext({
+      viewport: { width: viewportWidth, height: viewportHeight },
+    });
+    const page = await context.newPage();
+
+    // Log console messages from the page for debugging
+    page.on('console', (msg) => {
+      if (msg.type() === 'error') {
+        console.log(`[JournalCapture] Page console.error: ${msg.text()}`);
+      }
+    });
+
+    // Log failed network requests
+    page.on('requestfailed', (request) => {
+      console.log(
+        `[JournalCapture] Network failed: ${request.method()} ${request.url()} — ${request.failure()?.errorText || 'unknown'}`,
+      );
+    });
+
+    let lastError: Error | null = null;
+
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+      try {
+        console.log(
+          `[JournalCapture] Navigating (attempt ${attempt}/${MAX_RETRIES})...`,
+        );
+
+        const response = await page.goto(url, {
+          waitUntil: 'networkidle',
+          timeout: GOTO_TIMEOUT_MS,
+        });
+
+        if (response) {
+          console.log(
+            `[JournalCapture] Page loaded: status=${response.status()}, url=${response.url()}`,
+          );
+        }
+
+        // Brief settle time for any client-side rendering/animations
+        await page.waitForTimeout(SETTLE_DELAY_MS);
+
+        if (selector) {
+          // Element-level screenshot — captures just the wrapper element
+          const element = page.locator(selector);
+          try {
+            await element.waitFor({ state: 'visible', timeout: 5000 });
+            await element.screenshot({ path: outputPath });
+            console.log(
+              `[JournalCapture] Element screenshot: selector=${selector}`,
+            );
+          } catch {
+            // Selector not found — fall back to full-page screenshot
+            console.warn(
+              `[JournalCapture] Selector "${selector}" not found, falling back to full page`,
+            );
+            await page.screenshot({ path: outputPath, fullPage: true });
+          }
+        } else {
+          await page.screenshot({ path: outputPath, fullPage: true });
+        }
+
+        console.log(
+          `[JournalCapture] RESULT:${JSON.stringify({ success: true, path: outputPath })}`,
+        );
+        return; // Success
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        console.warn(
+          `[JournalCapture] Attempt ${attempt} failed: ${lastError.message}`,
+        );
+
+        if (attempt < MAX_RETRIES) {
+          // Wait a bit before retrying (server might still be starting)
+          const backoffMs = attempt * 2000;
+          console.log(`[JournalCapture] Retrying in ${backoffMs}ms...`);
+          await new Promise((r) => setTimeout(r, backoffMs));
+        }
+      }
+    }
+
+    // All retries exhausted
+    const message = lastError?.message || 'Unknown error';
+    console.error(
+      `[JournalCapture] All ${MAX_RETRIES} attempts failed: ${message}`,
+    );
+    process.exit(1);
+  } finally {
+    await browser.close();
+  }
+}
+
+void main();