@codeyam/codeyam-cli 0.1.0-staging.eb21b2f → 0.1.0-staging.f777668

package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js

@@ -0,0 +1,50 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Guard against database path mismatches in the editor template.
+ *
+ * The nextjs-prisma-sqlite template has multiple files that reference the
+ * SQLite database path. If any file uses a different path (e.g.
+ * `file:./prisma/dev.db` vs `file:./dev.db`), the seed adapter will write
+ * to the wrong database and scenario screenshots will be blank.
+ *
+ * This test caught a real bug: seed-adapter.ts used `file:./prisma/dev.db`
+ * while every other file used `file:./dev.db`.
+ */
+describe('nextjs-prisma-sqlite template', () => {
+    const templateDir = path.resolve(__dirname, '../../../templates/nextjs-prisma-sqlite');
+    it('all files referencing database path should use file:./dev.db', () => {
+        const filesToCheck = [
+            'app/lib/prisma.ts',
+            'prisma/seed.ts',
+            'seed-adapter.ts',
+        ];
+        const dbPathPattern = /file:\.\/[a-zA-Z/]*dev\.db/g;
+        for (const relPath of filesToCheck) {
+            const fullPath = path.join(templateDir, relPath);
+            expect(fs.existsSync(fullPath)).toBe(true);
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const matches = content.match(dbPathPattern);
+            if (matches) {
+                for (const match of matches) {
+                    expect({ file: relPath, path: match }).toEqual({
+                        file: relPath,
+                        path: 'file:./dev.db',
+                    });
+                }
+            }
+        }
+    });
+    it('seed-adapter.ts should use the same database path as prisma.ts', () => {
+        const prismaContent = fs.readFileSync(path.join(templateDir, 'app/lib/prisma.ts'), 'utf-8');
+        const seedAdapterContent = fs.readFileSync(path.join(templateDir, 'seed-adapter.ts'), 'utf-8');
+        // Extract the PrismaBetterSqlite3 url from both files
+        const urlPattern = /PrismaBetterSqlite3\(\{\s*url:\s*['"]([^'"]+)['"]/;
+        const prismaMatch = prismaContent.match(urlPattern);
+        const seedAdapterMatch = seedAdapterContent.match(urlPattern);
+        expect(prismaMatch).not.toBeNull();
+        expect(seedAdapterMatch).not.toBeNull();
+        expect(seedAdapterMatch[1]).toBe(prismaMatch[1]);
+    });
+});
+//# sourceMappingURL=templateConsistency.test.js.map

package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateConsistency.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/templateConsistency.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAC9B,SAAS,EACT,yCAAyC,CAC1C,CAAC;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,YAAY,GAAG;YACnB,mBAAmB;YACnB,gBAAgB;YAChB,iBAAiB;SAClB,CAAC;QAEF,MAAM,aAAa,GAAG,6BAA6B,CAAC;QAEpD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAE7C,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;wBAC7C,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,eAAe;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,EAC3C,OAAO,CACR,CAAC;QACF,MAAM,kBAAkB,GAAG,EAAE,CAAC,YAAY,CACxC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,EACzC,OAAO,CACR,CAAC;QAEF,sDAAsD;QACtD,MAAM,UAAU,GAAG,mDAAmD,CAAC;QAEvE,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE9D,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAExC,MAAM,CAAC,gBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -10,18 +10,28 @@ export async function startBackgroundServer(options) {
     const { port, rootPath, project, branch, processName = 'server' } = options;
     const url = `http://localhost:${port}`;
     // 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
+        // (e.g. a server from a different project on the same port).
+        // Kill them all to avoid port conflicts.
+        console.log(`Found ${pids.length} orphaned codeyam-server process(es), killing...`);
+        killServer();
+        isRestart = true;
+    }
     // Bootstrap new background server process
     const serverScriptPath = path.join(__dirname, '..', 'webserver', 'bootstrap.js');
     // Create log files for debugging
@@ -35,6 +45,8 @@ export async function startBackgroundServer(options) {
         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 }
             : {}),
@@ -46,7 +58,7 @@ export async function startBackgroundServer(options) {
     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', [serverScriptPath], {
+        const child = spawn('node', ['--max-old-space-size=8192', serverScriptPath], {
             detached: true,
             stdio: ['ignore', outLog, errLog],
             env: { ...process.env, ...serverEnv },
@@ -55,7 +67,8 @@ export async function startBackgroundServer(options) {
         childPid = child.pid;
     }
     // Poll health endpoint until server is ready (includes FileWatcher initial sync)
-    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 startTime = Date.now();
@@ -64,6 +77,8 @@ export async function startBackgroundServer(options) {
             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;
             }
         }
@@ -75,6 +90,7 @@ export async function startBackgroundServer(options) {
     // 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] Check logs at: ${path.join(logDir, 'background-server.log')}`);
     }
     // Save server state
     const serverState = {
@@ -116,7 +132,7 @@ async function spawnServerWindows(serverScriptPath, serverEnv, logDir) {
         `$env:CODEYAM_LOG_DIR = '${psEscape(logDir)}'`,
         // Start node with bootstrap.js in a hidden window
         `$bootstrapPath = '${psEscape(serverScriptPath)}'`,
-        `$p = Start-Process -FilePath "node" -ArgumentList ('"{0}"' -f $bootstrapPath) -WindowStyle Hidden -PassThru`,
+        `$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

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

@@ -1 +1 @@
-{"version":3,"file":"backgroundServer.js","sourceRoot":"","sources":["../../../../src/utils/backgroundServer.ts"],"names":[],"mappings":"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"}
+{"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":"AAAA;;;;;;GAMG;AAQH,MAAM,cAAc,GAA2D;IAC7E,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,uBAAuB;QACjC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,0BAA0B;KACrC,CAAC;IAEF,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,0BAA0B;KACrC,CAAC;IAEF,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,oBAAoB;QAC9B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,2BAA2B;QACrC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,4BAA4B;QACtC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;QAChC,QAAQ,EAAE,wBAAwB;QAClC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,qBAAqB;KAChC,CAAC;IAEF,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACtB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,2BAA2B;KACtC,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,OAAgB;IAEhB,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAyB,EACzB,IAAY;IAEZ,MAAM,GAAG,GAAG,oBAAoB,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACxD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,OAAO,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC"}

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

@@ -0,0 +1,159 @@
+/**
+ * Pure logic for `codeyam editor audit` — zero I/O, fully testable.
+ *
+ * Cross-references glossary entries against registered scenarios (components)
+ * and test files (functions) to detect gaps Claude may have missed.
+ */
+// ─── Logic ───────────────────────────────────────────────────────────
+const COMPONENT_RETURN_PATTERNS = ['JSX', 'React', 'Element', 'ReactNode'];
+/**
+ * Returns true when the entry's returnType indicates a React component
+ * (contains "JSX", "React", "Element", or "ReactNode").
+ */
+export function isComponent(entry) {
+    if (!entry.returnType)
+        return false;
+    return COMPONENT_RETURN_PATTERNS.some((pat) => entry.returnType.includes(pat));
+}
+/**
+ * Split glossary entries into components (JSX-returning) and functions (everything else).
+ */
+export function classifyGlossaryEntries(entries) {
+    const components = [];
+    const functions = [];
+    for (const entry of entries) {
+        if (isComponent(entry)) {
+            components.push(entry);
+        }
+        else {
+            functions.push(entry);
+        }
+    }
+    return { components, functions };
+}
+/**
+ * Given classified entries and coverage data, produce a structured audit result.
+ *
+ * @param components  - Glossary entries classified as components
+ * @param functions   - Glossary entries classified as functions
+ * @param scenarioCounts - Map of component_name → number of registered scenarios
+ * @param testFileExistence - Map of testFile path → whether the file exists on disk
+ */
+export function computeAudit({ components, functions, scenarioCounts, testFileExistence, testResults, clientErrors, }) {
+    const componentResults = components.map((c) => {
+        const count = scenarioCounts[c.name] || 0;
+        const errors = clientErrors?.[c.name];
+        const hasErrors = count > 0 && errors && errors.length > 0;
+        let status;
+        if (count === 0) {
+            status = 'missing';
+        }
+        else if (hasErrors) {
+            status = 'has_errors';
+        }
+        else {
+            status = 'ok';
+        }
+        return {
+            name: c.name,
+            filePath: c.filePath,
+            scenarioCount: count,
+            status,
+            ...(hasErrors ? { clientErrors: errors } : {}),
+        };
+    });
+    const functionResults = functions.map((f) => {
+        const exists = f.testFile
+            ? (testFileExistence[f.testFile] ?? false)
+            : false;
+        if (!exists) {
+            return {
+                name: f.name,
+                filePath: f.filePath,
+                testFile: f.testFile,
+                testFileExists: false,
+                status: 'missing',
+            };
+        }
+        // If we have test results for this file, use them for deeper status
+        const tr = f.testFile && testResults ? testResults[f.testFile] : undefined;
+        if (!tr) {
+            // No test results available — fall back to existence-only check
+            return {
+                name: f.name,
+                filePath: f.filePath,
+                testFile: f.testFile,
+                testFileExists: true,
+                status: 'ok',
+            };
+        }
+        let status;
+        if (!tr.passing) {
+            status = 'failing';
+        }
+        else if (!tr.hasEntityNameDescribe) {
+            status = 'name_mismatch';
+        }
+        else {
+            status = 'ok';
+        }
+        return {
+            name: f.name,
+            filePath: f.filePath,
+            testFile: f.testFile,
+            testFileExists: true,
+            testsPassing: tr.passing,
+            testsVisibleInUi: tr.hasEntityNameDescribe,
+            status,
+        };
+    });
+    const componentsOk = componentResults.filter((c) => c.status === 'ok').length;
+    const componentsWithErrors = componentResults.filter((c) => c.status === 'has_errors').length;
+    const componentsMissing = componentResults.filter((c) => c.status === 'missing').length;
+    const functionsOk = functionResults.filter((f) => f.status === 'ok').length;
+    const functionsFailing = functionResults.filter((f) => f.status === 'failing').length;
+    const functionsNameMismatch = functionResults.filter((f) => f.status === 'name_mismatch').length;
+    const functionsMissing = functionResults.filter((f) => f.status === 'missing').length;
+    return {
+        components: componentResults,
+        functions: functionResults,
+        summary: {
+            totalComponents: componentResults.length,
+            componentsOk,
+            componentsMissing,
+            componentsWithErrors,
+            totalFunctions: functionResults.length,
+            functionsOk,
+            functionsMissing,
+            functionsFailing,
+            functionsNameMismatch,
+            allPassing: componentsMissing === 0 &&
+                componentsWithErrors === 0 &&
+                functionsFailing === 0 &&
+                functionsNameMismatch === 0 &&
+                functionsMissing === 0,
+        },
+    };
+}
+/**
+ * Filter glossary entries to only those whose entities are new, edited, or impacted
+ * in the current working session. When entityChangeStatus is empty or undefined,
+ * falls back to returning all entries (no filtering).
+ *
+ * Matches by entity name first, then by filePath as a fallback.
+ */
+export function filterGlossaryByChangeStatus(entries, entityChangeStatus) {
+    if (!entityChangeStatus || Object.keys(entityChangeStatus).length === 0) {
+        return entries;
+    }
+    return entries.filter((entry) => {
+        // Match by entity name
+        if (entityChangeStatus[entry.name])
+            return true;
+        // Match by file path (entity names in changeStatus may be file-path keyed)
+        if (entityChangeStatus[entry.filePath])
+            return true;
+        return false;
+    });
+}
+//# sourceMappingURL=editorAudit.js.map

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

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

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

@@ -0,0 +1,102 @@
+/**
+ * Capture script resolution and execution utilities for the editor.
+ *
+ * Extracted from duplicated inline logic in api.editor-register-scenario.ts
+ * and api.editor-capture-scenario.ts.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Resolve the webserver root directory from an import.meta.url.
+ *
+ * Walks up from the route file's directory to find the 'webserver' ancestor.
+ * Works for both dev (app/routes/) and installed (build/server/) layouts.
+ */
+export function resolveWebserverDir(importMetaUrl) {
+    const routeDir = path.dirname(new URL(importMetaUrl).pathname);
+    let dir = routeDir;
+    for (let i = 0; i < 5; i++) {
+        const parent = path.dirname(dir);
+        if (path.basename(parent) === 'webserver' ||
+            path.basename(dir) === 'webserver') {
+            return path.basename(dir) === 'webserver' ? dir : parent;
+        }
+        dir = parent;
+    }
+    return dir;
+}
+/**
+ * Resolve the journalCapture.ts script path.
+ *
+ * The script lives in different locations depending on context:
+ * - Installed package: webserverDir/scripts/journalCapture.ts
+ * - Dev (codeyam repo): webserverDir/app/lib/journalCapture.ts
+ * - Dev via codeyamRoot (monorepo): codeyamRoot/codeyam-cli/src/webserver/app/lib/journalCapture.ts
+ *
+ * Returns the first path that exists, or the first candidate as fallback.
+ */
+export async function resolveCaptureScript(webserverDir, codeyamRoot) {
+    const possiblePaths = [
+        // Installed package: scripts/ directory (standalone copy)
+        path.join(webserverDir, 'scripts', 'journalCapture.ts'),
+        // Dev: source file in app/lib/
+        path.join(webserverDir, 'app', 'lib', 'journalCapture.ts'),
+        // Dev via codeyamRoot (monorepo)
+        path.join(codeyamRoot, 'codeyam-cli', 'src', 'webserver', 'app', 'lib', 'journalCapture.ts'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            await fs.access(p);
+            return p;
+        }
+        catch {
+            // Try next path
+        }
+    }
+    // Return the most likely path for error reporting
+    return possiblePaths[0];
+}
+/**
+ * Run a capture script via shell and return the result.
+ *
+ * For the Playwright-based journalCapture.ts, this would typically be called as:
+ *   runCaptureScript(scriptPath, JSON.stringify(captureArgs), cwd)
+ *
+ * For shell scripts (used in tests), runs directly. For .ts files, runs via `npx tsx`.
+ */
+export function runCaptureScript(scriptPath, captureArgs, cwd) {
+    return new Promise((resolve) => {
+        const isTsFile = scriptPath.endsWith('.ts');
+        const command = isTsFile ? 'npx' : scriptPath;
+        const args = isTsFile ? ['tsx', scriptPath, captureArgs] : [captureArgs];
+        const child = spawn(command, args, {
+            cwd,
+            env: { ...process.env },
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({ success: true, output: stdout });
+            }
+            else {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: stderr || `Process exited with code ${code}`,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            resolve({ success: false, output: '', error: err.message });
+        });
+    });
+}
+//# sourceMappingURL=editorCapture.js.map