@codeyam/codeyam-cli 0.1.0-staging.4c0c3c9 → 0.1.0-staging.54098fa

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

@@ -0,0 +1,381 @@
+import { groupScenarios, buildEntityShaMap, isEntityComplete, findBrokenEntities, resolveClientFocusedEntity, buildEntityNamesFromImportGraph, } from "../editorEntityHelpers.js";
+function makeScenario(overrides) {
+    return {
+        id: overrides.id || `id-${overrides.name}`,
+        name: overrides.name,
+        description: '',
+        componentName: null,
+        componentPath: null,
+        screenshotPath: null,
+        url: null,
+        type: null,
+        viewportWidth: null,
+        viewportHeight: null,
+        dimensions: null,
+        screenshotPaths: null,
+        pageFilePath: null,
+        entitySha: null,
+        displayName: null,
+        updatedAt: null,
+        ...overrides,
+    };
+}
+describe('groupScenarios', () => {
+    it('should group component scenarios by componentName', () => {
+        const scenarios = [
+            makeScenario({ name: 'NavBar - Active', componentName: 'NavBar' }),
+            makeScenario({ name: 'NavBar - Idle', componentName: 'NavBar' }),
+            makeScenario({ name: 'Button - Default', componentName: 'Button' }),
+        ];
+        const { pageGroups, componentGroups } = groupScenarios(scenarios);
+        expect(pageGroups.size).toBe(0);
+        expect(componentGroups.get('NavBar')?.length).toBe(2);
+        expect(componentGroups.get('Button')?.length).toBe(1);
+    });
+    it('should group page scenarios by displayName from DB', () => {
+        const scenarios = [
+            makeScenario({
+                name: 'Home - Default',
+                url: '/',
+                displayName: 'Home',
+            }),
+            makeScenario({
+                name: 'Home - Full',
+                url: '/',
+                displayName: 'Home',
+            }),
+        ];
+        const { pageGroups } = groupScenarios(scenarios);
+        expect(pageGroups.get('Home')?.length).toBe(2);
+    });
+    it('should fall back to pageNameFromUrl when displayName is null', () => {
+        const scenarios = [makeScenario({ name: 'Home - Default', url: '/' })];
+        const { pageGroups } = groupScenarios(scenarios);
+        expect(pageGroups.has('Home')).toBe(true);
+    });
+    it('should use routeDisplayName for Next.js pageFilePath', () => {
+        const scenarios = [
+            makeScenario({
+                name: 'About',
+                url: '/about',
+                pageFilePath: 'app/about/page.tsx',
+            }),
+        ];
+        const { pageGroups } = groupScenarios(scenarios);
+        expect(pageGroups.has('About')).toBe(true);
+    });
+    it('should not use pageFilePath for non-app/ files', () => {
+        const scenarios = [
+            makeScenario({
+                name: 'Home - Default',
+                url: '/',
+                pageFilePath: 'src/App.tsx',
+            }),
+        ];
+        const { pageGroups } = groupScenarios(scenarios);
+        // Should use pageNameFromUrl('/') = 'Home', not buildRoutePattern('src/App.tsx')
+        expect(pageGroups.has('Home')).toBe(true);
+    });
+    it('should group non-app/ pages by displayName, not collapse to Home', () => {
+        // Margo bug: Chrome extension has popup at "/" (src/popup/App.tsx) and
+        // full-page library at "/library.html" (src/library/FullPageLibrary.tsx).
+        // Without displayName, buildRoutePattern collapses both non-app/ paths to "/",
+        // so both end up under "Home". With displayName they should be separate groups.
+        const scenarios = [
+            makeScenario({
+                name: 'First Launch',
+                url: '/',
+                pageFilePath: 'src/popup/App.tsx',
+                displayName: 'Home',
+            }),
+            makeScenario({
+                name: 'Full Page Library',
+                url: '/library.html',
+                pageFilePath: 'src/library/FullPageLibrary.tsx',
+                displayName: 'Library',
+            }),
+        ];
+        const { pageGroups } = groupScenarios(scenarios);
+        expect(pageGroups.has('Home')).toBe(true);
+        expect(pageGroups.has('Library')).toBe(true);
+        expect(pageGroups.get('Home')?.length).toBe(1);
+        expect(pageGroups.get('Library')?.length).toBe(1);
+    });
+    it('should fall back to pageNameFromUrl for non-app/ files without displayName', () => {
+        // When displayName is not set, "/library.html" should still produce "Library"
+        // via pageNameFromUrl, not "Home" via buildRoutePattern
+        const scenarios = [
+            makeScenario({
+                name: 'Full Page Library',
+                url: '/library.html',
+                pageFilePath: 'src/library/FullPageLibrary.tsx',
+            }),
+        ];
+        const { pageGroups } = groupScenarios(scenarios);
+        expect(pageGroups.has('Library')).toBe(true);
+        expect(pageGroups.has('Home')).toBe(false);
+    });
+    it('should sort component groups alphabetically', () => {
+        const scenarios = [
+            makeScenario({ name: 'Z - Default', componentName: 'Zebra' }),
+            makeScenario({ name: 'A - Default', componentName: 'Apple' }),
+        ];
+        const { componentGroups } = groupScenarios(scenarios);
+        const keys = [...componentGroups.keys()];
+        expect(keys).toEqual(['Apple', 'Zebra']);
+    });
+});
+describe('buildEntityShaMap', () => {
+    it('should map group names to entity SHAs from scenarios', () => {
+        const pageGroups = new Map([
+            [
+                'Home',
+                [makeScenario({ name: 'Home - Default', entitySha: 'sha-home' })],
+            ],
+        ]);
+        const componentGroups = new Map([
+            [
+                'NavBar',
+                [makeScenario({ name: 'NavBar - Default', entitySha: 'sha-nav' })],
+            ],
+        ]);
+        const map = buildEntityShaMap(pageGroups, componentGroups);
+        expect(map.get('Home')).toBe('sha-home');
+        expect(map.get('NavBar')).toBe('sha-nav');
+    });
+    it('should skip groups where no scenario has entitySha', () => {
+        const pageGroups = new Map([
+            ['Home', [makeScenario({ name: 'Home - Default' })]],
+        ]);
+        const map = buildEntityShaMap(pageGroups, new Map());
+        expect(map.has('Home')).toBe(false);
+    });
+});
+describe('isEntityComplete', () => {
+    const allEntities = [
+        {
+            sha: 'sha-a',
+            name: 'App',
+            entityType: 'visual',
+            filePath: 'src/App.tsx',
+        },
+        {
+            sha: 'sha-b',
+            name: 'Lib',
+            entityType: 'visual',
+            filePath: 'src/Lib.tsx',
+        },
+    ];
+    it('should return true if SHA is in analyzedShas', () => {
+        const analyzedShas = new Set(['sha-a']);
+        const namesWithImports = new Set();
+        expect(isEntityComplete('sha-a', analyzedShas, allEntities, namesWithImports)).toBe(true);
+    });
+    it('should return true if entity name has imports', () => {
+        const analyzedShas = new Set();
+        const namesWithImports = new Set(['App']);
+        expect(isEntityComplete('sha-a', analyzedShas, allEntities, namesWithImports)).toBe(true);
+    });
+    it('should return false if entity has no analysis and no imports', () => {
+        const analyzedShas = new Set();
+        const namesWithImports = new Set();
+        expect(isEntityComplete('sha-b', analyzedShas, allEntities, namesWithImports)).toBe(false);
+    });
+    it('should return false for unknown SHA', () => {
+        expect(isEntityComplete('unknown', new Set(), allEntities, new Set())).toBe(false);
+    });
+});
+describe('buildEntityNamesFromImportGraph', () => {
+    it('should include entities that import others (keys)', () => {
+        const entityImports = {
+            Dashboard: ['Button', 'Header'],
+        };
+        const names = buildEntityNamesFromImportGraph(entityImports);
+        expect(names.has('Dashboard')).toBe(true);
+    });
+    it('should include entities that ARE imported (values)', () => {
+        // Bug repro: ExternalLinkIcon is imported by OpenLibraryButton but
+        // doesn't import anything itself. Using only keys misses it entirely.
+        const entityImports = {
+            OpenLibraryButton: ['Button', 'ExternalLinkIcon'],
+            EmptyLibrary: ['PopupShell', 'OpenLibraryButton'],
+        };
+        const names = buildEntityNamesFromImportGraph(entityImports);
+        expect(names.has('ExternalLinkIcon')).toBe(true);
+        expect(names.has('Button')).toBe(true);
+        expect(names.has('PopupShell')).toBe(true);
+    });
+    it('should return empty set for empty import graph', () => {
+        const names = buildEntityNamesFromImportGraph({});
+        expect(names.size).toBe(0);
+    });
+    it('leaf entity without analyses should be complete via import graph', () => {
+        // End-to-end: a leaf entity (no analyses, not an importer) should
+        // be recognized as complete if it appears in the import graph as
+        // a dependency of another entity.
+        const entities = [
+            {
+                sha: 'sha-lib',
+                name: 'EmptyLibrary',
+                entityType: 'visual',
+                filePath: 'src/EmptyLibrary.tsx',
+            },
+            {
+                sha: 'sha-icon',
+                name: 'ExternalLinkIcon',
+                entityType: 'visual',
+                filePath: 'src/ExternalLinkIcon.tsx',
+            },
+        ];
+        const entityImports = {
+            EmptyLibrary: ['OpenLibraryButton'],
+            OpenLibraryButton: ['Button', 'ExternalLinkIcon'],
+        };
+        const names = buildEntityNamesFromImportGraph(entityImports);
+        // ExternalLinkIcon has no analyses
+        const analyzedShas = new Set(['sha-lib']); // only EmptyLibrary analyzed
+        // ExternalLinkIcon should be complete because it's in the import graph
+        expect(isEntityComplete('sha-icon', analyzedShas, entities, names)).toBe(true);
+    });
+});
+describe('findBrokenEntities', () => {
+    it('should flag groups without entitySha as missing', () => {
+        const pageGroups = new Map([
+            ['Home', [makeScenario({ name: 'Home - Default' })]],
+        ]);
+        const entityShaMap = new Map();
+        const broken = findBrokenEntities(pageGroups, new Map(), entityShaMap, () => true);
+        expect(broken).toEqual([
+            { name: 'Home', scenarios: expect.any(Array), reason: 'missing' },
+        ]);
+    });
+    it('should flag groups with SHA but incomplete entity as incomplete', () => {
+        const scenarios = [
+            makeScenario({ name: 'Home - Default', entitySha: 'sha-a' }),
+        ];
+        const pageGroups = new Map([['Home', scenarios]]);
+        const entityShaMap = new Map([['Home', 'sha-a']]);
+        const broken = findBrokenEntities(pageGroups, new Map(), entityShaMap, () => false);
+        expect(broken).toEqual([{ name: 'Home', scenarios, reason: 'incomplete' }]);
+    });
+    it('should return empty for complete entities', () => {
+        const scenarios = [
+            makeScenario({ name: 'Home - Default', entitySha: 'sha-a' }),
+        ];
+        const pageGroups = new Map([['Home', scenarios]]);
+        const entityShaMap = new Map([['Home', 'sha-a']]);
+        const broken = findBrokenEntities(pageGroups, new Map(), entityShaMap, () => true);
+        expect(broken).toEqual([]);
+    });
+});
+describe('resolveClientFocusedEntity', () => {
+    const allEntities = [
+        {
+            sha: 'sha-app',
+            name: 'App',
+            entityType: 'visual',
+            filePath: 'src/App.tsx',
+        },
+        {
+            sha: 'sha-lib',
+            name: 'LibraryPage',
+            entityType: 'visual',
+            filePath: 'src/library/LibraryPage.tsx',
+        },
+    ];
+    it('should return null for null SHA', () => {
+        expect(resolveClientFocusedEntity(null, allEntities, [])).toBeNull();
+    });
+    it('should resolve entity by SHA', () => {
+        const result = resolveClientFocusedEntity('sha-app', allEntities, []);
+        expect(result?.name).toBe('App');
+        expect(result?.filePath).toBe('src/App.tsx');
+        expect(result?.sha).toBe('sha-app');
+    });
+    it('should use entity name as displayName, not scenario displayName', () => {
+        const scenarios = [
+            makeScenario({
+                name: 'Home - Default',
+                entitySha: 'sha-app',
+                displayName: 'Home',
+            }),
+        ];
+        const result = resolveClientFocusedEntity('sha-app', allEntities, scenarios);
+        // Entity page should show the entity's own name, not the scenario's display name
+        expect(result?.displayName).toBe('App');
+    });
+    it('should use entity name as displayName when no scenarios exist', () => {
+        const result = resolveClientFocusedEntity('sha-lib', allEntities, []);
+        expect(result?.displayName).toBe('LibraryPage');
+    });
+    it('should return null for unknown SHA', () => {
+        expect(resolveClientFocusedEntity('unknown', allEntities, [])).toBeNull();
+    });
+});
+// ── Stale entity SHA detection ────────────────────────────────────────
+describe('findBrokenEntities — stale entity SHA', () => {
+    it('should detect entity as broken when scenario points to old SHA not in analyzedShas', () => {
+        // Scenario: Library page was edited → file watcher created new entity version
+        // (sha-library-v2). Scenario still points to old version (sha-library-v1).
+        // analyzedEntities only contains sha-library-v2 (latest via getAllEntities).
+        // The old sha-library-v1 has analyses in the DB but isn't in the UI's
+        // analyzedShas set → isEntityComplete returns false → "missing data".
+        const scenario = makeScenario({
+            name: 'Library - Rich Data',
+            pageFilePath: 'app/library/page.tsx',
+            url: '/library',
+            displayName: 'Library',
+            entitySha: 'sha-library-v1', // OLD version
+        });
+        const { pageGroups, componentGroups } = groupScenarios([scenario]);
+        const entityShaMap = buildEntityShaMap(pageGroups, componentGroups);
+        // analyzedShas only has the latest version
+        const analyzedShas = new Set(['sha-library-v2']);
+        // allEntities has the latest version
+        const allEntities = [
+            {
+                sha: 'sha-library-v2',
+                name: 'LibraryPage',
+                entityType: 'visual',
+                filePath: 'app/library/page.tsx',
+            },
+        ];
+        // Import graph has the entity name
+        const entityNamesWithImports = buildEntityNamesFromImportGraph({
+            LibraryPage: ['ArticleTable', 'LibrarySidebar'],
+        });
+        const isComplete = (sha) => isEntityComplete(sha, analyzedShas, allEntities, entityNamesWithImports);
+        const broken = findBrokenEntities(pageGroups, componentGroups, entityShaMap, isComplete);
+        // The old SHA isn't in analyzedShas, and there's no allEntities entry
+        // for sha-library-v1, so isEntityComplete can't resolve the name →
+        // falls through → entity is "incomplete"
+        expect(broken.length).toBe(1);
+        expect(broken[0].name).toBe('Library');
+        expect(broken[0].reason).toBe('incomplete');
+    });
+    it('should NOT detect entity as broken when scenario SHA matches latest version', () => {
+        const scenario = makeScenario({
+            name: 'Library - Rich Data',
+            pageFilePath: 'app/library/page.tsx',
+            url: '/library',
+            displayName: 'Library',
+            entitySha: 'sha-library-v2', // CURRENT version
+        });
+        const { pageGroups, componentGroups } = groupScenarios([scenario]);
+        const entityShaMap = buildEntityShaMap(pageGroups, componentGroups);
+        const analyzedShas = new Set(['sha-library-v2']);
+        const allEntities = [
+            {
+                sha: 'sha-library-v2',
+                name: 'LibraryPage',
+                entityType: 'visual',
+                filePath: 'app/library/page.tsx',
+            },
+        ];
+        const entityNamesWithImports = new Set();
+        const isComplete = (sha) => isEntityComplete(sha, analyzedShas, allEntities, entityNamesWithImports);
+        const broken = findBrokenEntities(pageGroups, componentGroups, entityShaMap, isComplete);
+        expect(broken.length).toBe(0);
+    });
+});
+//# sourceMappingURL=editorEntityHelpers.test.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { simulationGateMiddleware } from "../simulationGateMiddleware.js";
+// We only need to test the editor guard logic — mock out the rest of the middleware
+// so it doesn't try to load projects or databases.
+jest.mock('../project', () => ({
+    findProjectRoot: () => null,
+}));
+jest.mock('../database', () => ({
+    initializeEnvironment: jest.fn(),
+    requireBranchAndProject: jest.fn(),
+}));
+jest.mock('../slugUtils', () => ({
+    generateProjectSlug: jest.fn(),
+}));
+describe('editor guard in simulationGateMiddleware', () => {
+    const originalEnv = process.env.CODEYAM_EDITOR_ACTIVE;
+    let exitSpy;
+    let errorSpy;
+    beforeEach(() => {
+        exitSpy = jest
+            .spyOn(process, 'exit')
+            .mockImplementation(() => undefined);
+        errorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        process.env.CODEYAM_EDITOR_ACTIVE = originalEnv;
+        if (process.env.CODEYAM_EDITOR_ACTIVE === undefined) {
+            delete process.env.CODEYAM_EDITOR_ACTIVE;
+        }
+        exitSpy.mockRestore();
+        errorSpy.mockRestore();
+    });
+    it('allows `editor` command when CODEYAM_EDITOR_ACTIVE=1', async () => {
+        process.env.CODEYAM_EDITOR_ACTIVE = '1';
+        await simulationGateMiddleware({ _: ['editor'] });
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+    it.each(['analyze', 'init', 'verify', 'start', 'stop', 'memory', 'debug'])('blocks `%s` command when CODEYAM_EDITOR_ACTIVE=1', async (command) => {
+        process.env.CODEYAM_EDITOR_ACTIVE = '1';
+        await simulationGateMiddleware({ _: [command] });
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('error message mentions `codeyam editor` subcommands', async () => {
+        process.env.CODEYAM_EDITOR_ACTIVE = '1';
+        await simulationGateMiddleware({ _: ['analyze'] });
+        const output = errorSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(output).toContain('codeyam editor');
+    });
+    it('error message mentions `codeyam editor steps`', async () => {
+        process.env.CODEYAM_EDITOR_ACTIVE = '1';
+        await simulationGateMiddleware({ _: ['analyze'] });
+        const output = errorSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(output).toContain('codeyam editor steps');
+    });
+    it('does not activate guard when CODEYAM_EDITOR_ACTIVE is not set', async () => {
+        delete process.env.CODEYAM_EDITOR_ACTIVE;
+        // A non-hidden command should pass through without exit
+        await simulationGateMiddleware({ _: ['editor'] });
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+    it('does not block non-hidden commands when env var is absent', async () => {
+        delete process.env.CODEYAM_EDITOR_ACTIVE;
+        // 'help' is not a hidden command and env var is absent — should pass through
+        await simulationGateMiddleware({ _: ['help'] });
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=editorGuardMiddleware.test.js.map

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

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