@codeyam/codeyam-cli 0.1.0-staging.d3e886e → 0.1.0-staging.d4f25c3

package/codeyam-cli/src/data/techStacks.js

@@ -0,0 +1,77 @@
+export const APP_FORMATS = [
+    {
+        id: 'mobile-responsive-web-app',
+        label: 'Mobile-Responsive Web App',
+        description: 'A web application designed for desktop AND mobile — must look great on all screen sizes',
+    },
+    {
+        id: 'desktop-app',
+        label: 'Desktop App',
+        description: 'A native desktop application for macOS, Windows, or Linux',
+    },
+    {
+        id: 'mobile-app',
+        label: 'Mobile App',
+        description: 'A native or hybrid mobile application for iOS and/or Android',
+    },
+    {
+        id: 'chrome-extension',
+        label: 'Chrome Extension',
+        description: 'A browser extension for Google Chrome with popup, options, or content scripts',
+    },
+];
+export const TECH_STACKS = [
+    {
+        id: 'nextjs-prisma-sqlite',
+        name: 'Next.js',
+        templateDir: 'nextjs-prisma-sqlite',
+        description: "A full-stack web application with server-side rendering, API routes, and a local SQLite database. Zero setup required — upgrade to a hosted database (Supabase, etc.) when you're ready for production.",
+        technologies: [
+            'Next.js 15 (App Router + Turbopack)',
+            'React 19',
+            'TypeScript 5',
+            'Tailwind CSS 4',
+            'Prisma 7 (ORM)',
+            'SQLite (local, upgradeable)',
+        ],
+        supportedFormats: ['mobile-responsive-web-app'],
+        recommended: true,
+    },
+    {
+        id: 'chrome-extension-react',
+        name: 'Chrome Extension + React',
+        templateDir: 'chrome-extension-react',
+        description: 'A Chrome Extension with a React popup UI, background service worker, and local storage. Develop the popup as a regular web page with hot reload.',
+        technologies: [
+            'React 19',
+            'TypeScript 5',
+            'Vite 6',
+            'Tailwind CSS 4',
+            'Chrome Manifest V3',
+            'chrome.storage (with localStorage fallback for dev)',
+        ],
+        supportedFormats: ['chrome-extension'],
+        recommended: true,
+    },
+    {
+        id: 'expo-react-native',
+        name: 'Expo + React Native',
+        templateDir: 'expo-react-native',
+        description: 'A cross-platform mobile app with Expo and React Native. Develop in the browser with Expo Web, deploy to iOS and Android. Uses Expo Router for navigation and NativeWind for Tailwind styling.',
+        technologies: [
+            'Expo SDK 55',
+            'React Native',
+            'React 19',
+            'TypeScript 5',
+            'Expo Router (file-based navigation)',
+            'NativeWind (Tailwind CSS)',
+            'AsyncStorage',
+        ],
+        supportedFormats: ['mobile-app'],
+        recommended: true,
+    },
+];
+export function getStacksForFormats(selectedFormats) {
+    return TECH_STACKS.filter((stack) => selectedFormats.some((format) => stack.supportedFormats.includes(format)));
+}
+//# sourceMappingURL=techStacks.js.map

package/codeyam-cli/src/data/techStacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"techStacks.js","sourceRoot":"","sources":["../../../../src/data/techStacks.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C;QACE,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,yFAAyF;KAC5F;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,2DAA2D;KACzE;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,8DAA8D;KAC5E;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,+EAA+E;KAClF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC;QACE,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sBAAsB;QACnC,WAAW,EACT,yMAAyM;QAC3M,YAAY,EAAE;YACZ,qCAAqC;YACrC,UAAU;YACV,cAAc;YACd,gBAAgB;YAChB,gBAAgB;YAChB,6BAA6B;SAC9B;QACD,gBAAgB,EAAE,CAAC,2BAA2B,CAAC;QAC/C,WAAW,EAAE,IAAI;KAClB;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,wBAAwB;QACrC,WAAW,EACT,kJAAkJ;QACpJ,YAAY,EAAE;YACZ,UAAU;YACV,cAAc;YACd,QAAQ;YACR,gBAAgB;YAChB,oBAAoB;YACpB,qDAAqD;SACtD;QACD,gBAAgB,EAAE,CAAC,kBAAkB,CAAC;QACtC,WAAW,EAAE,IAAI;KAClB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EACT,+LAA+L;QACjM,YAAY,EAAE;YACZ,aAAa;YACb,cAAc;YACd,UAAU;YACV,cAAc;YACd,qCAAqC;YACrC,2BAA2B;YAC3B,cAAc;SACf;QACD,gBAAgB,EAAE,CAAC,YAAY,CAAC;QAChC,WAAW,EAAE,IAAI;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,eAA4B;IAC9D,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAClC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC1E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,173 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { execSync } from 'child_process';
+// Mock child_process
+jest.mock('child_process', () => ({
+    execSync: jest.fn(),
+}));
+// Mock the analyzer template path to use a temp directory
+let templateDir;
+jest.mock('../analyzer', () => ({
+    getAnalyzerTemplatePath: () => templateDir,
+}));
+import { ensureAnalyzerFinalized } from "../analyzerFinalization.js";
+const mockExecSync = execSync;
+describe('ensureAnalyzerFinalized', () => {
+    beforeEach(() => {
+        templateDir = fs.mkdtempSync(path.join(os.tmpdir(), 'analyzer-finalization-test-'));
+        mockExecSync.mockReset();
+    });
+    afterEach(() => {
+        fs.rmSync(templateDir, { recursive: true, force: true });
+    });
+    it('runs all steps when template has no node_modules, no playwright, and no build', () => {
+        // Template exists but is completely fresh — no artifacts
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsRun).toContain('npm-install');
+        expect(result.stepsRun).toContain('playwright-install');
+        expect(result.stepsRun).toContain('build');
+        expect(result.stepsSkipped).toHaveLength(0);
+        expect(result.errors).toHaveLength(0);
+        // 4 calls: npm install, playwright dry-run check, playwright install, build
+        expect(mockExecSync).toHaveBeenCalledTimes(4);
+    });
+    it('skips npm install when node_modules already exists', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        fs.mkdirSync(path.join(templateDir, 'node_modules'));
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsSkipped).toContain('npm-install');
+        expect(result.stepsRun).not.toContain('npm-install');
+        // Should still run playwright and build
+        expect(result.stepsRun).toContain('playwright-install');
+        expect(result.stepsRun).toContain('build');
+    });
+    it('skips playwright install when chromium is already cached', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        // Simulate playwright listing installed browsers
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                // Dry-run output when chromium IS installed — no "chromium" in the "browsers to install" output
+                return Buffer.from('browser: firefox v123\n');
+            }
+            return Buffer.from('');
+        });
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsSkipped).toContain('playwright-install');
+        expect(result.stepsRun).not.toContain('playwright-install');
+    });
+    it('runs playwright install when chromium is NOT cached', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                // Dry-run lists chromium as needing install
+                return Buffer.from('browser: chromium v130\n');
+            }
+            return Buffer.from('');
+        });
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsRun).toContain('playwright-install');
+    });
+    it('skips build when dist directory already exists', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        fs.mkdirSync(path.join(templateDir, 'dist'));
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsSkipped).toContain('build');
+        expect(result.stepsRun).not.toContain('build');
+    });
+    it('skips everything when all artifacts exist', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        fs.mkdirSync(path.join(templateDir, 'node_modules'));
+        fs.mkdirSync(path.join(templateDir, 'dist'));
+        // Playwright check returns no chromium needed
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                return Buffer.from('');
+            }
+            return Buffer.from('');
+        });
+        const result = ensureAnalyzerFinalized();
+        expect(result.stepsRun).toHaveLength(0);
+        expect(result.needed).toBe(false);
+    });
+    it('returns needed=true when at least one step runs', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        // Only missing build
+        fs.mkdirSync(path.join(templateDir, 'node_modules'));
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                return Buffer.from('');
+            }
+            return Buffer.from('');
+        });
+        const result = ensureAnalyzerFinalized();
+        expect(result.needed).toBe(true);
+        expect(result.stepsRun).toEqual(['build']);
+    });
+    it('reports errors without stopping other steps', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        // npm install fails, but playwright and build should still be attempted
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' && cmd.includes('npm install')) {
+                throw new Error('npm ERR! network timeout');
+            }
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                return Buffer.from('browser: chromium v130\n');
+            }
+            return Buffer.from('');
+        });
+        const result = ensureAnalyzerFinalized();
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toMatchObject({
+            step: 'npm-install',
+            message: expect.stringContaining('npm ERR! network timeout'),
+        });
+        // Other steps should still have been attempted
+        expect(result.stepsRun).toContain('playwright-install');
+        expect(result.stepsRun).toContain('build');
+    });
+    it('returns needed=false when template directory does not exist', () => {
+        // Point to non-existent directory
+        templateDir = path.join(os.tmpdir(), 'nonexistent-analyzer-' + Date.now());
+        const result = ensureAnalyzerFinalized();
+        expect(result.needed).toBe(false);
+        expect(result.stepsRun).toHaveLength(0);
+        expect(result.stepsSkipped).toHaveLength(0);
+    });
+    it('calls onProgress before each step that needs to run', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        // node_modules exists so npm-install is skipped
+        fs.mkdirSync(path.join(templateDir, 'node_modules'));
+        const progressSteps = [];
+        ensureAnalyzerFinalized({
+            onProgress: (step) => progressSteps.push(step),
+        });
+        // npm-install was skipped, so only playwright-install and build should be reported
+        expect(progressSteps).toEqual(['playwright-install', 'build']);
+    });
+    it('does not call onProgress for skipped steps', () => {
+        fs.writeFileSync(path.join(templateDir, 'package.json'), JSON.stringify({ name: 'analyzer-template' }));
+        fs.mkdirSync(path.join(templateDir, 'node_modules'));
+        fs.mkdirSync(path.join(templateDir, 'dist'));
+        // Playwright check returns no chromium needed
+        mockExecSync.mockImplementation((cmd) => {
+            if (typeof cmd === 'string' &&
+                cmd.includes('npx playwright install --dry-run')) {
+                return Buffer.from('');
+            }
+            return Buffer.from('');
+        });
+        const progressSteps = [];
+        ensureAnalyzerFinalized({
+            onProgress: (step) => progressSteps.push(step),
+        });
+        expect(progressSteps).toEqual([]);
+    });
+});
+//# sourceMappingURL=analyzerFinalization.test.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { findFreePort } from "../serverState.js";
+describe('findFreePort', () => {
+    it('should return the desired port when it is free', () => {
+        const isPortFree = jest.fn().mockReturnValue(true);
+        expect(findFreePort(3111, isPortFree)).toBe(3111);
+        expect(isPortFree).toHaveBeenCalledWith(3111);
+    });
+    it('should skip to the next candidate when desired port is taken', () => {
+        const isPortFree = jest
+            .fn()
+            .mockReturnValueOnce(false) // 3111 taken
+            .mockReturnValueOnce(true); // 3121 free
+        expect(findFreePort(3111, isPortFree)).toBe(3121);
+        expect(isPortFree).toHaveBeenCalledWith(3111);
+        expect(isPortFree).toHaveBeenCalledWith(3121);
+    });
+    it('should skip multiple taken ports', () => {
+        const isPortFree = jest
+            .fn()
+            .mockReturnValueOnce(false) // 3111 taken
+            .mockReturnValueOnce(false) // 3121 taken
+            .mockReturnValueOnce(true); // 3131 free
+        expect(findFreePort(3111, isPortFree)).toBe(3131);
+    });
+    it('should use step=10 to leave room for proxy (+1) and dev server (+2)', () => {
+        const isPortFree = jest
+            .fn()
+            .mockReturnValueOnce(false)
+            .mockReturnValueOnce(true);
+        const result = findFreePort(3111, isPortFree);
+        // Verify the gap is 10, not 1 — prevents overlap with proxy/dev server ports
+        expect(result).toBe(3121);
+    });
+    it('should throw when no free port found within max attempts', () => {
+        const isPortFree = jest.fn().mockReturnValue(false);
+        expect(() => findFreePort(3111, isPortFree)).toThrow('Could not find a free port');
+    });
+    it('should respect custom step parameter', () => {
+        const isPortFree = jest
+            .fn()
+            .mockReturnValueOnce(false)
+            .mockReturnValueOnce(true);
+        expect(findFreePort(3111, isPortFree, 20)).toBe(3131);
+    });
+});
+//# sourceMappingURL=backgroundServer.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundServer.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/backgroundServer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,UAAU,GAAG,IAAI;aACpB,EAAE,EAAE;aACJ,mBAAmB,CAAC,KAAK,CAAC,CAAC,aAAa;aACxC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;QAC1C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,UAAU,GAAG,IAAI;aACpB,EAAE,EAAE;aACJ,mBAAmB,CAAC,KAAK,CAAC,CAAC,aAAa;aACxC,mBAAmB,CAAC,KAAK,CAAC,CAAC,aAAa;aACxC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;QAC1C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,UAAU,GAAG,IAAI;aACpB,EAAE,EAAE;aACJ,mBAAmB,CAAC,KAAK,CAAC;aAC1B,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9C,6EAA6E;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAClD,4BAA4B,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,UAAU,GAAG,IAAI;aACpB,EAAE,EAAE;aACJ,mBAAmB,CAAC,KAAK,CAAC;aAC1B,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,134 @@
+import { computeDevServerTransition, } from "../devServerState.js";
+describe('computeDevServerTransition', () => {
+    const baseState = {
+        url: null,
+        proxyUrl: null,
+        isStarting: false,
+        error: null,
+        canStartServer: true,
+        autoStartAttempted: false,
+    };
+    describe('error response', () => {
+        it('should clear URL and set error message', () => {
+            const response = {
+                status: 'error',
+                errorMessage: 'Dev server crashed',
+            };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result).toEqual({
+                url: null,
+                proxyUrl: null,
+                isStarting: false,
+                error: 'Dev server crashed',
+                canStartServer: true,
+                autoStartAttempted: false,
+                shouldAutoStart: false,
+            });
+        });
+        it('should use default message when errorMessage is missing', () => {
+            const response = { status: 'error' };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result.error).toBe('Dev server crashed');
+        });
+        it('should clear a previously running server on error', () => {
+            const running = {
+                ...baseState,
+                url: 'http://localhost:3000',
+                proxyUrl: 'http://localhost:4000',
+            };
+            const response = {
+                status: 'error',
+                errorMessage: 'Crash',
+            };
+            const result = computeDevServerTransition(running, response);
+            expect(result.url).toBeNull();
+            expect(result.proxyUrl).toBeNull();
+            expect(result.isStarting).toBe(false);
+        });
+    });
+    describe('running response (url present)', () => {
+        it('should set URL, proxyUrl, clear error and starting', () => {
+            const response = {
+                status: 'running',
+                url: 'http://localhost:3000',
+                proxyUrl: 'http://localhost:4000',
+            };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result).toEqual({
+                url: 'http://localhost:3000',
+                proxyUrl: 'http://localhost:4000',
+                isStarting: false,
+                error: null,
+                canStartServer: true,
+                autoStartAttempted: false,
+                shouldAutoStart: false,
+            });
+        });
+        it('should handle missing proxyUrl', () => {
+            const response = {
+                status: 'running',
+                url: 'http://localhost:3000',
+            };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result.url).toBe('http://localhost:3000');
+            expect(result.proxyUrl).toBeNull();
+        });
+    });
+    describe('starting response', () => {
+        it('should set isStarting, clear error, mark canStartServer', () => {
+            const response = { status: 'starting' };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result.isStarting).toBe(true);
+            expect(result.error).toBeNull();
+            expect(result.canStartServer).toBe(true);
+        });
+        it('should preserve existing URL while starting', () => {
+            const running = {
+                ...baseState,
+                url: 'http://localhost:3000',
+            };
+            const response = { status: 'starting' };
+            const result = computeDevServerTransition(running, response);
+            expect(result.url).toBe('http://localhost:3000');
+        });
+    });
+    describe('stopped response', () => {
+        it('should clear URL when server was previously running (unexpected stop)', () => {
+            const running = {
+                ...baseState,
+                url: 'http://localhost:3000',
+            };
+            const response = { status: 'stopped' };
+            const result = computeDevServerTransition(running, response);
+            expect(result.url).toBeNull();
+            expect(result.isStarting).toBe(false);
+            expect(result.shouldAutoStart).toBe(false);
+        });
+        it('should signal auto-start on first stopped when no URL and not yet attempted', () => {
+            const response = { status: 'stopped' };
+            const result = computeDevServerTransition(baseState, response);
+            expect(result.shouldAutoStart).toBe(true);
+            expect(result.autoStartAttempted).toBe(true);
+        });
+        it('should not signal auto-start when already attempted', () => {
+            const attempted = {
+                ...baseState,
+                autoStartAttempted: true,
+            };
+            const response = { status: 'stopped' };
+            const result = computeDevServerTransition(attempted, response);
+            expect(result.shouldAutoStart).toBe(false);
+            expect(result.isStarting).toBe(false);
+        });
+    });
+    describe('auto-start result', () => {
+        it('should set isStarting when auto-start succeeds', () => {
+            const response = { status: 'stopped' };
+            const transition = computeDevServerTransition(baseState, response);
+            // Caller would attempt auto-start, then apply the result:
+            expect(transition.shouldAutoStart).toBe(true);
+            expect(transition.autoStartAttempted).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=devServerState.test.js.map

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

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

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

@@ -0,0 +1,137 @@
+import { buildEditorApiRequest } from "../editorApi.js";
+describe('buildEditorApiRequest', () => {
+    describe('preview', () => {
+        it('should require dimension parameter', () => {
+            expect(() => buildEditorApiRequest('preview')).toThrow('dimension');
+        });
+        it('should reject path without dimension', () => {
+            expect(() => buildEditorApiRequest('preview', '{"path":"/drinks/1"}')).toThrow('dimension');
+        });
+        it('should reject scenarioId without dimension', () => {
+            expect(() => buildEditorApiRequest('preview', '{"scenarioId":"abc-123"}')).toThrow('dimension');
+        });
+        it('should accept dimension alone for refresh', () => {
+            const req = buildEditorApiRequest('preview', '{"dimension":"Desktop"}');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/dev-mode-preview',
+                body: { dimension: 'Desktop' },
+            });
+        });
+        it('should accept path with dimension', () => {
+            const req = buildEditorApiRequest('preview', '{"path":"/drinks/1","dimension":"Desktop"}');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/dev-mode-preview',
+                body: { path: '/drinks/1', dimension: 'Desktop' },
+            });
+        });
+        it('should accept scenarioId with dimension', () => {
+            const req = buildEditorApiRequest('preview', '{"scenarioId":"abc-123","dimension":"Mobile"}');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/dev-mode-preview',
+                body: { scenarioId: 'abc-123', dimension: 'Mobile' },
+            });
+        });
+    });
+    describe('show-results', () => {
+        it('should POST to editor-show-results', () => {
+            const req = buildEditorApiRequest('show-results');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/editor-show-results',
+            });
+        });
+    });
+    describe('hide-results', () => {
+        it('should POST to editor-hide-results', () => {
+            const req = buildEditorApiRequest('hide-results');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/editor-hide-results',
+            });
+        });
+    });
+    describe('commit', () => {
+        it('should POST to editor-commit with message body', () => {
+            const req = buildEditorApiRequest('commit', '{"message":"feat: Add drinks page"}');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/editor-commit',
+                body: { message: 'feat: Add drinks page' },
+            });
+        });
+    });
+    describe('journal', () => {
+        it('should POST to editor-journal-entry with full body', () => {
+            const body = {
+                title: 'Drink Pages',
+                type: 'feature',
+                description: 'Added detail pages',
+            };
+            const req = buildEditorApiRequest('journal', JSON.stringify(body));
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/editor-journal-entry',
+                body,
+            });
+        });
+    });
+    describe('journal-update', () => {
+        it('should PATCH to editor-journal-update with body', () => {
+            const body = {
+                time: '2026-03-06T01:20:16.065Z',
+                commitSha: 'abc123',
+                commitMessage: 'feat: drinks',
+            };
+            const req = buildEditorApiRequest('journal-update', JSON.stringify(body));
+            expect(req).toEqual({
+                method: 'PATCH',
+                endpoint: '/api/editor-journal-update',
+                body,
+            });
+        });
+    });
+    describe('dev-server', () => {
+        it('should POST to editor-dev-server with action body', () => {
+            const req = buildEditorApiRequest('dev-server', '{"action":"restart"}');
+            expect(req).toEqual({
+                method: 'POST',
+                endpoint: '/api/editor-dev-server',
+                body: { action: 'restart' },
+            });
+        });
+        it('should GET dev-server status with no body', () => {
+            const req = buildEditorApiRequest('dev-server');
+            expect(req).toEqual({
+                method: 'GET',
+                endpoint: '/api/editor-dev-server',
+            });
+        });
+    });
+    describe('journal-list', () => {
+        it('should GET editor-journal', () => {
+            const req = buildEditorApiRequest('journal-list');
+            expect(req).toEqual({
+                method: 'GET',
+                endpoint: '/api/editor-journal',
+            });
+        });
+    });
+    describe('client-errors', () => {
+        it('should GET editor-client-errors', () => {
+            const req = buildEditorApiRequest('client-errors');
+            expect(req).toEqual({
+                method: 'GET',
+                endpoint: '/api/editor-client-errors',
+            });
+        });
+    });
+    describe('unknown subcommand', () => {
+        it('should throw for unrecognized subcommand', () => {
+            expect(() => buildEditorApiRequest('unknown-thing')).toThrow('Unknown editor subcommand: unknown-thing');
+        });
+    });
+});
+//# sourceMappingURL=editorApi.test.js.map

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

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