@codeyam/codeyam-cli 0.1.0-staging.c5503ac → 0.1.0-staging.c85943e

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

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

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

@@ -0,0 +1,121 @@
+import { transformScenarioMarkers, createMarkerTransformer, } from "../scenarioMarkers.js";
+const PORT = '3111';
+describe('scenarioMarkers', () => {
+    describe('transformScenarioMarkers', () => {
+        it('should transform a simple marker into an OSC 8 hyperlink', () => {
+            const input = '{{scenario:Default:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('\x1b]8;;');
+            expect(result).toContain('http://localhost:3111/editor?scenario=abc-123&ref=link');
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should transform a marker with spaces in the name', () => {
+            const input = '{{scenario:Long Name:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('Long Name');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should transform multiple markers in one string', () => {
+            const input = '| DrinkCard | {{scenario:Default:id1}} |\n| | {{scenario:Dark Mode:id2}} |';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).not.toContain('{{scenario:');
+            expect(result).toContain('Default');
+            expect(result).toContain('Dark Mode');
+        });
+        it('should return input unchanged when no markers present', () => {
+            const input = 'Hello world, no markers here';
+            expect(transformScenarioMarkers(input, PORT)).toBe(input);
+        });
+        it('should handle markers with ANSI escape codes interleaved', () => {
+            // Claude Code's renderer inserts ANSI styling within marker text
+            const input = '\x1b[33m{{scenario:\x1b[1mDefault\x1b[22m:\x1b[0mabc-123\x1b[33m}}\x1b[0m';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should pad the replacement to maintain table alignment', () => {
+            const input = '{{scenario:Tea:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            // The original marker is 24 chars visible, "Tea" is 3 chars → 21 spaces of padding
+            const linkEnd = '\x1b]8;;\x07';
+            const afterLink = result.slice(result.lastIndexOf(linkEnd) + linkEnd.length);
+            // Should have padding spaces
+            expect(afterLink.length).toBeGreaterThan(0);
+        });
+    });
+    describe('createMarkerTransformer (cross-chunk buffering)', () => {
+        it('should handle a marker split across two chunks', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('before {{scenario:Def');
+            const out2 = transform('ault:abc-123}} after');
+            const combined = out1 + out2;
+            expect(combined).toContain('Default');
+            expect(combined).not.toContain('{{scenario:');
+            expect(combined).toContain('before');
+            expect(combined).toContain('after');
+        });
+        it('should handle a marker split across three chunks', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('│ {{scenario:');
+            const out2 = transform('Long Name:');
+            const out3 = transform('abc-123}} │');
+            const combined = out1 + out2 + out3;
+            expect(combined).toContain('Long Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle complete markers in a single chunk', () => {
+            const transform = createMarkerTransformer(PORT);
+            const result = transform('│ {{scenario:Default:abc-123}} │');
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should handle multiple complete markers in a single chunk', () => {
+            const transform = createMarkerTransformer(PORT);
+            const result = transform('{{scenario:A:id1}} and {{scenario:B:id2}}');
+            expect(result).not.toContain('{{scenario:');
+            expect(result).toContain('A');
+            expect(result).toContain('B');
+        });
+        it('should discard stale buffer on carriage return (Ink line rewrite)', () => {
+            const transform = createMarkerTransformer(PORT);
+            // Ink renders partial: "│ {{scenario:Lo"
+            const out1 = transform('│ {{scenario:Lo');
+            // Ink rewrites the line with more content
+            const out2 = transform('\r\x1b[K│ {{scenario:Long Na');
+            // Ink completes the line
+            const out3 = transform('me:abc-123}} │\n');
+            const combined = out1 + out2 + out3;
+            // The final output should have the transformed marker, not the raw one
+            expect(combined).toContain('Long Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle carriage return mid-buffer without losing the new marker', () => {
+            const transform = createMarkerTransformer(PORT);
+            // Buffer has partial marker, then line gets rewritten with a complete marker
+            const out1 = transform('{{scenario:Te');
+            const out2 = transform('\r\x1b[K{{scenario:Tea:id1}} │');
+            const combined = out1 + out2;
+            expect(combined).toContain('Tea');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle ANSI codes within a split marker', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('\x1b[33m{{scenario:\x1b[1mDef');
+            const out2 = transform('ault\x1b[22m:abc-123\x1b[0m}}');
+            const combined = out1 + out2;
+            expect(combined).toContain('Default');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should flush stale partial on carriage return even without \\x1b[K', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('│ {{scenario:Partia');
+            // Just \r, no erase sequence — Ink sometimes does this
+            const out2 = transform('\r│ {{scenario:Full Name:id1}} │');
+            const combined = out1 + out2;
+            expect(combined).toContain('Full Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+    });
+});
+//# sourceMappingURL=scenarioMarkers.test.js.map

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

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

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

@@ -0,0 +1,493 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { scanScenarioFiles, writeScenarioMetadata, deleteScenarioFiles, syncScenarioFilesToDatabase, backfillScenarioMetadata, migrateScenarioFormats, } from "../scenariosManifest.js";
+function makeTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'manifest-test-'));
+}
+function makeMetadata(overrides = {}) {
+    return {
+        name: 'Test Scenario',
+        description: null,
+        componentName: null,
+        componentPath: null,
+        url: '/',
+        type: 'application',
+        screenshotPath: null,
+        viewportWidth: null,
+        viewportHeight: null,
+        createdAt: '2024-01-01T00:00:00.000Z',
+        updatedAt: '2024-01-01T00:00:00.000Z',
+        ...overrides,
+    };
+}
+function writeScenarioFile(tmp, id, data, metadata) {
+    const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+    fs.mkdirSync(dir, { recursive: true });
+    const content = metadata ? { _metadata: metadata, ...data } : data;
+    fs.writeFileSync(path.join(dir, `${id}.json`), JSON.stringify(content, null, 2));
+}
+// ─── scanScenarioFiles ────────────────────────────────────────────
+describe('scanScenarioFiles', () => {
+    it('should find scenario files with _metadata', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'abc-123', { seed: {} }, makeMetadata({ name: 'Home Page' }));
+        writeScenarioFile(tmp, 'def-456', { seed: {} }, makeMetadata({ name: 'About Page' }));
+        const results = scanScenarioFiles(tmp);
+        expect(results).toHaveLength(2);
+        const names = results.map((r) => r.metadata.name).sort();
+        expect(names).toEqual(['About Page', 'Home Page']);
+    });
+    it('should skip files without _metadata', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'with-meta', { seed: {} }, makeMetadata());
+        writeScenarioFile(tmp, 'no-meta', { seed: {} }); // no metadata
+        const results = scanScenarioFiles(tmp);
+        expect(results).toHaveLength(1);
+        expect(results[0].id).toBe('with-meta');
+    });
+    it('should skip .seed.json files', () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        writeScenarioFile(tmp, 'abc', { seed: {} }, makeMetadata());
+        // Write a .seed.json file that has _metadata (shouldn't happen but be safe)
+        fs.writeFileSync(path.join(dir, 'abc.seed.json'), JSON.stringify({ _metadata: makeMetadata() }));
+        const results = scanScenarioFiles(tmp);
+        expect(results).toHaveLength(1);
+        expect(results[0].id).toBe('abc');
+    });
+    it('should skip client-errors.json', () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        writeScenarioFile(tmp, 'abc', { seed: {} }, makeMetadata());
+        fs.writeFileSync(path.join(dir, 'client-errors.json'), JSON.stringify({ _metadata: makeMetadata() }));
+        const results = scanScenarioFiles(tmp);
+        expect(results).toHaveLength(1);
+    });
+    it('should return empty array for missing directory', () => {
+        const tmp = makeTmpDir();
+        expect(scanScenarioFiles(tmp)).toEqual([]);
+    });
+    it('should extract id from filename', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'my-uuid-here', { seed: {} }, makeMetadata());
+        const results = scanScenarioFiles(tmp);
+        expect(results[0].id).toBe('my-uuid-here');
+    });
+});
+// ─── writeScenarioMetadata ────────────────────────────────────────
+describe('writeScenarioMetadata', () => {
+    it('should add _metadata to existing scenario file', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'abc', { type: 'application', seed: { users: [] } });
+        writeScenarioMetadata(tmp, 'abc', makeMetadata({ name: 'Updated' }));
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'abc.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.name).toBe('Updated');
+        expect(content.type).toBe('application'); // original data preserved
+        expect(content.seed).toEqual({ users: [] }); // original data preserved
+    });
+    it('should update existing _metadata', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'abc', { seed: {} }, makeMetadata({ name: 'Old' }));
+        writeScenarioMetadata(tmp, 'abc', makeMetadata({ name: 'New' }));
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'abc.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.name).toBe('New');
+    });
+    it('should not create file if it does not exist', () => {
+        const tmp = makeTmpDir();
+        writeScenarioMetadata(tmp, 'nonexistent', makeMetadata());
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'nonexistent.json');
+        expect(fs.existsSync(filePath)).toBe(false);
+    });
+});
+// ─── deleteScenarioFiles ──────────────────────────────────────────
+describe('deleteScenarioFiles', () => {
+    it('should delete both .json and .seed.json', () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'abc.json'), '{}');
+        fs.writeFileSync(path.join(dir, 'abc.seed.json'), '{}');
+        deleteScenarioFiles(tmp, 'abc');
+        expect(fs.existsSync(path.join(dir, 'abc.json'))).toBe(false);
+        expect(fs.existsSync(path.join(dir, 'abc.seed.json'))).toBe(false);
+    });
+    it('should not throw for missing files', () => {
+        const tmp = makeTmpDir();
+        expect(() => deleteScenarioFiles(tmp, 'nonexistent')).not.toThrow();
+    });
+});
+// ─── backfillScenarioMetadata ─────────────────────────────────────
+describe('backfillScenarioMetadata', () => {
+    it('should add _metadata to files that lack it', () => {
+        const tmp = makeTmpDir();
+        // Write a file WITHOUT _metadata (legacy)
+        writeScenarioFile(tmp, 'abc-123', {
+            type: 'application',
+            seed: { users: [] },
+        });
+        const updated = backfillScenarioMetadata(tmp, [
+            {
+                id: 'abc-123',
+                name: 'Home Page',
+                description: 'Default view',
+                component_name: null,
+                component_path: null,
+                url: '/',
+                type: 'application',
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-02T00:00:00.000Z',
+            },
+        ]);
+        expect(updated).toBe(1);
+        // Verify _metadata was written
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'abc-123.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.name).toBe('Home Page');
+        expect(content._metadata.url).toBe('/');
+        // Original data preserved
+        expect(content.type).toBe('application');
+        expect(content.seed).toEqual({ users: [] });
+    });
+    it('should skip files that already have _metadata', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'abc-123', { seed: {} }, makeMetadata({ name: 'Existing' }));
+        const updated = backfillScenarioMetadata(tmp, [
+            {
+                id: 'abc-123',
+                name: 'From DB',
+                description: null,
+                component_name: null,
+                component_path: null,
+                url: '/',
+                type: 'application',
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-01T00:00:00.000Z',
+            },
+        ]);
+        expect(updated).toBe(0);
+        // Verify original _metadata preserved
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'abc-123.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.name).toBe('Existing');
+    });
+    it('should skip DB rows with no matching file', () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        const updated = backfillScenarioMetadata(tmp, [
+            {
+                id: 'nonexistent',
+                name: 'Ghost',
+                description: null,
+                component_name: null,
+                component_path: null,
+                url: '/',
+                type: null,
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-01T00:00:00.000Z',
+            },
+        ]);
+        expect(updated).toBe(0);
+    });
+    it('should preserve dimensions, screenshotPaths, and pageFilePath from DB rows', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'dim-1', {
+            type: 'application',
+            seed: { items: [] },
+        });
+        const updated = backfillScenarioMetadata(tmp, [
+            {
+                id: 'dim-1',
+                name: 'Multi-Dimension',
+                description: null,
+                component_name: 'Dashboard',
+                component_path: 'app/components/Dashboard.tsx',
+                url: '/',
+                type: 'application',
+                screenshot_path: 'screenshots/dim-1.png',
+                viewport_width: 1440,
+                viewport_height: 900,
+                dimensions: JSON.stringify(['Desktop', 'Mobile']),
+                screenshot_paths: JSON.stringify({
+                    Desktop: 'screenshots/dim-1.png',
+                    Mobile: 'screenshots/dim-1-mobile.png',
+                }),
+                page_file_path: 'app/page.tsx',
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-02T00:00:00.000Z',
+            },
+        ]);
+        expect(updated).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'dim-1.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.dimensions).toEqual(['Desktop', 'Mobile']);
+        expect(content._metadata.screenshotPaths).toEqual({
+            Desktop: 'screenshots/dim-1.png',
+            Mobile: 'screenshots/dim-1-mobile.png',
+        });
+        expect(content._metadata.pageFilePath).toBe('app/page.tsx');
+    });
+    it('should handle mix of files with and without _metadata', () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'has-meta', { seed: {} }, makeMetadata());
+        writeScenarioFile(tmp, 'no-meta', { type: 'application', seed: {} });
+        const updated = backfillScenarioMetadata(tmp, [
+            {
+                id: 'has-meta',
+                name: 'A',
+                description: null,
+                component_name: null,
+                component_path: null,
+                url: '/',
+                type: null,
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-01T00:00:00.000Z',
+            },
+            {
+                id: 'no-meta',
+                name: 'B',
+                description: null,
+                component_name: null,
+                component_path: null,
+                url: '/about',
+                type: 'application',
+                created_at: '2024-01-01T00:00:00.000Z',
+                updated_at: '2024-01-01T00:00:00.000Z',
+            },
+        ]);
+        expect(updated).toBe(1); // Only no-meta was updated
+    });
+});
+// ─── syncScenarioFilesToDatabase ──────────────────────────────────
+describe('syncScenarioFilesToDatabase', () => {
+    it('should insert scenarios from _metadata files', async () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'new-1', { seed: {} }, makeMetadata({ name: 'New Scenario' }));
+        const insertedRows = [];
+        const result = await syncScenarioFilesToDatabase(tmp, 'project-1', [], (row) => {
+            insertedRows.push(row);
+        }, () => { });
+        expect(result.inserted).toBe(1);
+        expect(insertedRows[0].id).toBe('new-1');
+        expect(insertedRows[0].name).toBe('New Scenario');
+        expect(insertedRows[0].project_id).toBe('project-1');
+        expect(insertedRows[0].type).toBe('application');
+    });
+    it('should sync type, screenshot_path, and viewport from _metadata', async () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'full-1', { seed: {} }, makeMetadata({
+            name: 'Full Scenario',
+            type: 'user',
+            screenshotPath: 'screenshots/full-1.png',
+            viewportWidth: 1280,
+            viewportHeight: 720,
+        }));
+        const insertedRows = [];
+        await syncScenarioFilesToDatabase(tmp, 'project-1', [], (row) => {
+            insertedRows.push(row);
+        }, () => { });
+        expect(insertedRows[0].type).toBe('user');
+        expect(insertedRows[0].screenshot_path).toBe('screenshots/full-1.png');
+        expect(insertedRows[0].viewport_width).toBe(1280);
+        expect(insertedRows[0].viewport_height).toBe(720);
+    });
+    it('should skip scenarios already in DB with same updatedAt', async () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'existing-1', { seed: {} }, makeMetadata({ updatedAt: '2024-01-01T00:00:00.000Z' }));
+        const result = await syncScenarioFilesToDatabase(tmp, 'project-1', [{ id: 'existing-1', updated_at: '2024-01-01T00:00:00.000Z' }], () => { }, () => { });
+        expect(result.skipped).toBe(1);
+        expect(result.inserted).toBe(0);
+        expect(result.updated).toBe(0);
+    });
+    it('should update scenarios newer than DB row', async () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'existing-1', { seed: {} }, makeMetadata({ name: 'Updated', updatedAt: '2024-02-01T00:00:00.000Z' }));
+        const updatedRows = [];
+        const result = await syncScenarioFilesToDatabase(tmp, 'project-1', [{ id: 'existing-1', updated_at: '2024-01-01T00:00:00.000Z' }], () => { }, (id, row) => {
+            updatedRows.push({ id, ...row });
+        });
+        expect(result.updated).toBe(1);
+        expect(updatedRows[0].name).toBe('Updated');
+    });
+    it('should handle empty directory', async () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        const result = await syncScenarioFilesToDatabase(tmp, 'project-1', [], () => { }, () => { });
+        expect(result.inserted).toBe(0);
+    });
+    it('should handle mixed insert/update/skip', async () => {
+        const tmp = makeTmpDir();
+        writeScenarioFile(tmp, 'new-1', { seed: {} }, makeMetadata({ name: 'New', updatedAt: '2024-01-01T00:00:00.000Z' }));
+        writeScenarioFile(tmp, 'updated-1', { seed: {} }, makeMetadata({ name: 'Updated', updatedAt: '2024-02-01T00:00:00.000Z' }));
+        writeScenarioFile(tmp, 'current-1', { seed: {} }, makeMetadata({ name: 'Current', updatedAt: '2024-01-01T00:00:00.000Z' }));
+        const result = await syncScenarioFilesToDatabase(tmp, 'project-1', [
+            { id: 'updated-1', updated_at: '2024-01-01T00:00:00.000Z' },
+            { id: 'current-1', updated_at: '2024-01-01T00:00:00.000Z' },
+        ], () => { }, () => { });
+        expect(result.inserted).toBe(1);
+        expect(result.updated).toBe(1);
+        expect(result.skipped).toBe(1);
+    });
+});
+// ─── migrateScenarioFormats ──────────────────────────────────────
+describe('migrateScenarioFormats', () => {
+    function writeConfigWithSizes(tmp, screenSizes, defaultScreenSize) {
+        const dir = path.join(tmp, '.codeyam');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'config.json'), JSON.stringify({
+            ...(defaultScreenSize ? { defaultScreenSize } : {}),
+            ...(Object.keys(screenSizes).length > 0 ? { screenSizes } : {}),
+        }));
+    }
+    it('should resolve null viewport using project defaultScreenSize', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, { Desktop: { width: 1440, height: 900 } }, { name: 'Desktop', width: 1440, height: 900 });
+        writeScenarioFile(tmp, 'null-vp', { seed: {} }, makeMetadata({
+            name: 'Home Page',
+            viewportWidth: null,
+            viewportHeight: null,
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'null-vp.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.viewportWidth).toBe(1440);
+        expect(content._metadata.viewportHeight).toBe(900);
+    });
+    it('should wrap single dimension into dimensions array', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, { Mobile: { width: 375, height: 667 } });
+        writeScenarioFile(tmp, 'single-dim', { seed: {} }, makeMetadata({
+            name: 'Mobile View',
+            dimension: 'Mobile',
+            viewportWidth: 375,
+            viewportHeight: 667,
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'single-dim.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.dimensions).toEqual(['Mobile']);
+        // Legacy dimension property should be stripped
+        expect(content._metadata.dimension).toBeUndefined();
+    });
+    it('should build screenshotPaths from single screenshotPath + dimension', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, { Desktop: { width: 1440, height: 900 } });
+        writeScenarioFile(tmp, 'single-ss', { seed: {} }, makeMetadata({
+            name: 'Dashboard',
+            dimension: 'Desktop',
+            screenshotPath: 'screenshots/single-ss.png',
+            viewportWidth: 1440,
+            viewportHeight: 900,
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'single-ss.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.screenshotPaths).toEqual({
+            Desktop: 'screenshots/single-ss.png',
+        });
+    });
+    it('should skip files that are already in the correct format', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, { Desktop: { width: 1440, height: 900 } });
+        writeScenarioFile(tmp, 'good-fmt', { seed: {} }, makeMetadata({
+            name: 'Good Scenario',
+            viewportWidth: 1440,
+            viewportHeight: 900,
+            dimensions: ['Desktop'],
+            screenshotPaths: { Desktop: 'screenshots/good-fmt.png' },
+            screenshotPath: 'screenshots/good-fmt.png',
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(0);
+        expect(result.scanned).toBe(1);
+    });
+    it('should fix multiple issues in a single file', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, { Tablet: { width: 768, height: 1024 } }, { name: 'Tablet', width: 768, height: 1024 });
+        // File has null viewport, dimension set but no dimensions array, screenshotPath but no map
+        writeScenarioFile(tmp, 'multi-fix', { seed: {} }, makeMetadata({
+            name: 'Tablet View',
+            dimension: 'Tablet',
+            viewportWidth: null,
+            viewportHeight: null,
+            screenshotPath: 'screenshots/multi-fix.png',
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'multi-fix.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        // Null viewport resolved via dimension name lookup
+        expect(content._metadata.viewportWidth).toBe(768);
+        expect(content._metadata.viewportHeight).toBe(1024);
+        // dimensions array created from single dimension
+        expect(content._metadata.dimensions).toEqual(['Tablet']);
+        // screenshotPaths map created from single screenshotPath
+        expect(content._metadata.screenshotPaths).toEqual({
+            Tablet: 'screenshots/multi-fix.png',
+        });
+    });
+    it('should use hardcoded fallback (1280x720) when no project config exists', () => {
+        const tmp = makeTmpDir();
+        // No config.json at all
+        writeScenarioFile(tmp, 'no-config', { seed: {} }, makeMetadata({
+            name: 'Bare Scenario',
+            viewportWidth: null,
+            viewportHeight: null,
+        }));
+        const result = migrateScenarioFormats(tmp);
+        expect(result.fixed).toBe(1);
+        const filePath = path.join(tmp, '.codeyam', 'editor-scenarios', 'no-config.json');
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        expect(content._metadata.viewportWidth).toBe(1280);
+        expect(content._metadata.viewportHeight).toBe(720);
+    });
+    it('should handle empty scenarios directory', () => {
+        const tmp = makeTmpDir();
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        const result = migrateScenarioFormats(tmp);
+        expect(result.scanned).toBe(0);
+        expect(result.fixed).toBe(0);
+    });
+    it('should handle missing scenarios directory', () => {
+        const tmp = makeTmpDir();
+        const result = migrateScenarioFormats(tmp);
+        expect(result.scanned).toBe(0);
+        expect(result.fixed).toBe(0);
+    });
+    it('should preserve all non-metadata data in the file', () => {
+        const tmp = makeTmpDir();
+        writeConfigWithSizes(tmp, {}, { name: 'Desktop', width: 1440, height: 900 });
+        // Write file with extra data alongside _metadata
+        const dir = path.join(tmp, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(dir, { recursive: true });
+        const fileContent = {
+            _metadata: makeMetadata({
+                name: 'With Data',
+                viewportWidth: null,
+                viewportHeight: null,
+            }),
+            type: 'application',
+            seed: { users: [{ id: 1, name: 'Alice' }] },
+            session: { cookieValue: 'abc123' },
+        };
+        fs.writeFileSync(path.join(dir, 'with-data.json'), JSON.stringify(fileContent, null, 2));
+        migrateScenarioFormats(tmp);
+        const content = JSON.parse(fs.readFileSync(path.join(dir, 'with-data.json'), 'utf8'));
+        expect(content.type).toBe('application');
+        expect(content.seed).toEqual({ users: [{ id: 1, name: 'Alice' }] });
+        expect(content.session).toEqual({ cookieValue: 'abc123' });
+        // And metadata was fixed
+        expect(content._metadata.viewportWidth).toBe(1440);
+    });
+});
+//# sourceMappingURL=scenariosManifest.test.js.map