@codeyam/codeyam-cli 0.0.0 → 0.1.0-staging.036391e

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

@@ -0,0 +1,169 @@
+import path from 'path';
+import fs from 'fs';
+import { loadEntities, upsertEntities, upsertEntityBranches, deleteEntities, } from "../../../packages/database/index.js";
+import { getEntityMetadata, getUncommittedFiles } from "./fileMetadata.js";
+/**
+ * Sync entity metadata for uncommitted changes that were missed while the server was off.
+ * This function:
+ * 1. Finds all entities marked as isUncommitted or isBeingDeleted in the database
+ * 2. Checks their actual git status
+ * 3. Updates or deletes entities based on current state
+ */
+export async function syncUncommittedEntities(options) {
+    const { projectId, branchId, projectRootPath, projectAnalyzer } = options;
+    try {
+        console.log('[SyncUncommittedEntities] Starting sync of uncommitted entities...');
+        // Get current uncommitted files from git
+        const uncommittedFiles = getUncommittedFiles(projectRootPath);
+        const uncommittedTsFiles = Array.from(uncommittedFiles).filter((f) => /\.(ts|tsx|js|jsx)$/.test(f));
+        console.log(`[SyncUncommittedEntities] Found ${uncommittedTsFiles.length} uncommitted TypeScript/JavaScript files`);
+        if (uncommittedTsFiles.length === 0) {
+            console.log('[SyncUncommittedEntities] No uncommitted files to sync');
+            return;
+        }
+        // Load entities from uncommitted files
+        const entities = await loadEntities({
+            projectId,
+            branchId,
+            filePaths: uncommittedTsFiles,
+        });
+        if (!entities || entities.length === 0) {
+            console.log('[SyncUncommittedEntities] No entities found in uncommitted files');
+            return;
+        }
+        console.log(`[SyncUncommittedEntities] Found ${entities.length} entities in uncommitted files to check`);
+        // Also load entities that are marked as isUncommitted or isBeingDeleted
+        // to handle cases where files were committed
+        const allEntities = await loadEntities({
+            projectId,
+            branchId,
+        });
+        const previouslyMarkedEntities = (allEntities || []).filter((e) => (e.metadata?.isUncommitted || e.metadata?.isBeingDeleted) &&
+            !uncommittedFiles.has(e.filePath));
+        console.log(`[SyncUncommittedEntities] Found ${previouslyMarkedEntities.length} previously marked entities in now-committed files`);
+        // Combine both sets of entities to check
+        const affectedEntities = [...entities, ...previouslyMarkedEntities];
+        // Track entities to update and delete
+        const entitiesToUpdate = [];
+        const entitiesToDelete = [];
+        // Group entities by file for efficiency and deduplicate by SHA
+        const entitiesByFile = new Map();
+        for (const entity of affectedEntities) {
+            if (!entitiesByFile.has(entity.filePath)) {
+                entitiesByFile.set(entity.filePath, new Map());
+            }
+            entitiesByFile.get(entity.filePath).set(entity.sha, entity);
+        }
+        // Process each file
+        for (const [filePath, entityMap] of entitiesByFile) {
+            const fullPath = path.join(projectRootPath, filePath);
+            const fileExists = fs.existsSync(fullPath);
+            // Check if file is currently uncommitted
+            const fileIsUncommitted = uncommittedFiles.has(filePath);
+            for (const entity of entityMap.values()) {
+                // Case 1: File was deleted and deletion was committed
+                if (!fileExists && !fileIsUncommitted) {
+                    console.log(`[SyncUncommittedEntities] File ${filePath} was deleted and committed, removing entity ${entity.name}`);
+                    entitiesToDelete.push(entity.sha);
+                    continue;
+                }
+                // Case 2: File was deleted but not committed yet
+                if (!fileExists && fileIsUncommitted) {
+                    if (!entity.metadata?.isBeingDeleted) {
+                        console.log(`[SyncUncommittedEntities] File ${filePath} was deleted but not committed, marking entity ${entity.name} as isBeingDeleted`);
+                        entitiesToUpdate.push({
+                            ...entity,
+                            metadata: {
+                                ...entity.metadata,
+                                isBeingDeleted: true,
+                                editedAt: new Date().toISOString(),
+                            },
+                        });
+                    }
+                    // else: already marked as isBeingDeleted, no change needed
+                    continue;
+                }
+                // Case 3: File exists - check entity status
+                if (fileExists) {
+                    // Check if entity still exists in the file
+                    const fileAnalyzer = projectAnalyzer.getFileAnalyzerByPath(filePath);
+                    if (!fileAnalyzer) {
+                        console.log(`[SyncUncommittedEntities] No file analyzer for ${filePath}, skipping entity ${entity.name}`);
+                        continue;
+                    }
+                    const currentEntityNodes = fileAnalyzer.getAllEntityNodesOnlyAliases();
+                    const entityStillExists = entity.name in currentEntityNodes;
+                    // Case 3a: Entity was removed from file and changes committed
+                    if (!entityStillExists && !fileIsUncommitted) {
+                        console.log(`[SyncUncommittedEntities] Entity ${entity.name} was removed from ${filePath} and committed, deleting`);
+                        entitiesToDelete.push(entity.sha);
+                        continue;
+                    }
+                    // Case 3b: Entity was removed from file but not committed
+                    if (!entityStillExists && fileIsUncommitted) {
+                        if (!entity.metadata?.isBeingDeleted) {
+                            console.log(`[SyncUncommittedEntities] Entity ${entity.name} was removed from ${filePath} but not committed, marking as isBeingDeleted`);
+                            entitiesToUpdate.push({
+                                ...entity,
+                                metadata: {
+                                    ...entity.metadata,
+                                    isBeingDeleted: true,
+                                    editedAt: new Date().toISOString(),
+                                },
+                            });
+                        }
+                        continue;
+                    }
+                    // Case 3c: Entity exists - update its metadata based on current git status
+                    if (entityStillExists) {
+                        const entityMetadata = getEntityMetadata(filePath, projectRootPath, entity.name, projectAnalyzer);
+                        // Check if status changed
+                        const statusChanged = entity.metadata?.isUncommitted !== entityMetadata.isUncommitted ||
+                            entity.metadata?.isBeingDeleted === true;
+                        if (statusChanged) {
+                            console.log(`[SyncUncommittedEntities] Entity ${entity.name} in ${filePath} status changed: isUncommitted=${entityMetadata.isUncommitted}, was isBeingDeleted=${entity.metadata?.isBeingDeleted}`);
+                            entitiesToUpdate.push({
+                                ...entity,
+                                metadata: {
+                                    ...entity.metadata,
+                                    editedAt: entityMetadata.editedAt,
+                                    isUncommitted: entityMetadata.isUncommitted,
+                                    isBeingDeleted: false, // Clear deletion flag if entity is back
+                                },
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // Apply updates
+        if (entitiesToDelete.length > 0) {
+            await deleteEntities({
+                projectId,
+                shas: entitiesToDelete,
+            });
+            console.log(`[SyncUncommittedEntities] Deleted ${entitiesToDelete.length} entities`);
+        }
+        if (entitiesToUpdate.length > 0) {
+            await upsertEntities(entitiesToUpdate);
+            // Ensure entities are linked to the branch
+            await upsertEntityBranches(entitiesToUpdate.map((e) => ({
+                entitySha: e.sha,
+                branchId,
+                active: true,
+            })));
+            const nowCommitted = entitiesToUpdate.filter((e) => !e.metadata.isUncommitted).length;
+            const nowUncommitted = entitiesToUpdate.filter((e) => e.metadata.isUncommitted).length;
+            const noLongerDeleted = entitiesToUpdate.filter((e) => !e.metadata.isBeingDeleted).length;
+            console.log(`[SyncUncommittedEntities] Updated ${entitiesToUpdate.length} entities (${nowCommitted} now committed, ${nowUncommitted} still uncommitted, ${noLongerDeleted} no longer being deleted)`);
+        }
+        if (entitiesToDelete.length === 0 && entitiesToUpdate.length === 0) {
+            console.log('[SyncUncommittedEntities] No changes needed, all entities in sync');
+        }
+    }
+    catch (error) {
+        console.error('[SyncUncommittedEntities] Failed to sync uncommitted entities:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=syncUncommittedEntities.js.map

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

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

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

@@ -0,0 +1,284 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import ts from 'typescript';
+import { updateProjectMetadata } from "../../../packages/database/index.js";
+import { extractEntitiesFromContent } from "../../../packages/utils/index.js";
+const UNIVERSAL_MOCKS_DIR = 'universal-mocks';
+/**
+ * Sync universal mocks between local files and database.
+ *
+ * Logic:
+ * 1. If local folder doesn't exist but DB has mocks → create folder and write files from DB
+ * 2. If local folder exists → read files, parse exports, update DB if different
+ */
+export async function syncUniversalMocks(projectRoot, project) {
+    const mocksDir = path.join(projectRoot, '.codeyam', UNIVERSAL_MOCKS_DIR);
+    const dbMocks = project.metadata?.universalMocks ?? [];
+    // Check if local folder exists
+    const folderExists = fs.existsSync(mocksDir);
+    if (!folderExists && dbMocks.length > 0) {
+        // DB has mocks but no local folder → create files from DB
+        await writeMocksToFiles(mocksDir, dbMocks);
+        return { synced: true, mockCount: dbMocks.length };
+    }
+    if (!folderExists) {
+        // No folder and no DB mocks → nothing to do
+        return { synced: false, mockCount: 0 };
+    }
+    // Folder exists → read local files and sync to DB
+    const localMocks = readMocksFromFiles(mocksDir);
+    // Compare with DB mocks
+    const hasChanges = !areMocksEqual(localMocks, dbMocks);
+    if (hasChanges) {
+        // Update database with local mocks
+        await updateProjectMetadata({
+            projectId: project.id,
+            metadataUpdate: {
+                universalMocks: localMocks,
+            },
+        });
+        return { synced: true, mockCount: localMocks.length };
+    }
+    return { synced: false, mockCount: localMocks.length };
+}
+/**
+ * Read all mock files from the universal-mocks directory and convert to Mock objects.
+ */
+function readMocksFromFiles(mocksDir) {
+    const mocks = [];
+    if (!fs.existsSync(mocksDir)) {
+        return mocks;
+    }
+    const files = getAllFiles(mocksDir);
+    for (const fullPath of files) {
+        // Only process TypeScript/JavaScript files
+        if (!/\.(ts|tsx|js|jsx)$/.test(fullPath)) {
+            continue;
+        }
+        try {
+            const relativePath = path.relative(mocksDir, fullPath);
+            const isNodeModule = relativePath.startsWith('node_modules' + path.sep);
+            // The target file path (what this mock replaces)
+            const targetPath = isNodeModule
+                ? relativePath.replace(/^node_modules[\\/]/, '')
+                : relativePath;
+            // Read file content
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            // Use the lightweight entity extractor to find exports
+            const entities = extractEntitiesFromContent(content, fullPath);
+            if (entities.length === 0) {
+                console.warn(`Warning: No exports found in ${relativePath}, skipping`);
+                continue;
+            }
+            // Check for non-exported code that will be dropped
+            const nonExportedCode = detectNonExportedCode(content, fullPath);
+            if (nonExportedCode.length > 0) {
+                console.warn(`\n⚠️  Warning: Non-exported code found in ${relativePath}`);
+                console.warn(`   The following will be DROPPED (only exports are synced):`);
+                for (const item of nonExportedCode) {
+                    console.warn(`   - ${item.type}: ${item.name || '(anonymous)'}`);
+                }
+                console.warn(`   💡 Fix: Inline this code directly inside your exports.`);
+                console.warn(`   See: https://codeyam.com/docs/universal-mocks#self-contained-exports\n`);
+            }
+            // Create a Mock for each exported entity
+            for (const entity of entities) {
+                mocks.push({
+                    projectId: '', // Will be set by the database
+                    filePath: normalizeFilePath(targetPath, isNodeModule),
+                    entityName: entity.name,
+                    nodeModule: isNodeModule,
+                    content: entity.code, // Just the entity code, not full file content
+                    metadata: {
+                        defaultExport: entity.isDefault,
+                        notExported: false,
+                        llmCalls: {},
+                    },
+                });
+            }
+        }
+        catch (error) {
+            console.error(`Error parsing ${fullPath}:`, error);
+        }
+    }
+    return mocks;
+}
+/**
+ * Write Mock objects from the database to local files.
+ * Groups mocks by filePath to write multiple exports to the same file.
+ * Each mock's content is just the entity code, so we combine them into a single file.
+ */
+export async function writeMocksToFiles(mocksDir, mocks) {
+    // Group mocks by filePath
+    const mocksByPath = new Map();
+    for (const mock of mocks) {
+        const key = mock.filePath;
+        if (!mocksByPath.has(key)) {
+            mocksByPath.set(key, []);
+        }
+        mocksByPath.get(key).push(mock);
+    }
+    // Write each group to a file
+    for (const [filePath, fileMocks] of mocksByPath) {
+        const isNodeModule = fileMocks[0]?.nodeModule ?? false;
+        // For node_modules, filePath has no extension (to match imports), so add .tsx
+        // For project files, filePath already has the extension
+        let filePathWithExt = filePath;
+        if (isNodeModule && !filePath.match(/\.(ts|tsx|js|jsx)$/)) {
+            filePathWithExt = filePath + '.tsx';
+        }
+        const relativePath = isNodeModule
+            ? path.join('node_modules', filePathWithExt)
+            : filePathWithExt;
+        const fullPath = path.join(mocksDir, relativePath);
+        // Ensure directory exists
+        await fs.promises.mkdir(path.dirname(fullPath), { recursive: true });
+        // Combine all entity codes into a single file
+        // Each mock.content is just the entity code (e.g., "export const foo = ...")
+        const combinedContent = fileMocks
+            .map((mock) => mock.content ?? '')
+            .filter((content) => content.length > 0)
+            .join('\n\n');
+        await fs.promises.writeFile(fullPath, combinedContent, 'utf-8');
+    }
+}
+/**
+ * Recursively get all files in a directory.
+ */
+function getAllFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir)) {
+        return files;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllFiles(fullPath));
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Normalize file path to use forward slashes.
+ * For node_modules: removes extension (imports don't use extensions)
+ * For project files: preserves extension (matches actual file paths)
+ */
+function normalizeFilePath(filePath, isNodeModule) {
+    // Convert backslashes to forward slashes
+    let normalized = filePath.replace(/\\/g, '/');
+    if (isNodeModule) {
+        // For node_modules, remove extension to match import statements
+        // e.g., '@clerk/nextjs.tsx' -> '@clerk/nextjs'
+        normalized = normalized.replace(/\.(ts|tsx|js|jsx)$/, '');
+    }
+    // For project files, keep the extension as-is to match file paths
+    return normalized;
+}
+/**
+ * Compare two mock arrays for equality.
+ */
+function areMocksEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    // Create a map of mocks by filePath + entityName for comparison
+    const aMap = new Map();
+    for (const mock of a) {
+        aMap.set(`${mock.filePath}:${mock.entityName}`, mock);
+    }
+    for (const mock of b) {
+        const key = `${mock.filePath}:${mock.entityName}`;
+        const aMock = aMap.get(key);
+        if (!aMock) {
+            return false;
+        }
+        // Compare content
+        if (aMock.content !== mock.content) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Detect non-exported code in a mock file that will be dropped during sync.
+ * Returns a list of non-exported declarations that won't be included.
+ */
+function detectNonExportedCode(content, filePath) {
+    const nonExported = [];
+    try {
+        const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+        // Check each top-level statement
+        for (const statement of sourceFile.statements) {
+            // Skip import statements - those are fine
+            if (ts.isImportDeclaration(statement)) {
+                continue;
+            }
+            // Skip export statements
+            if (ts.isExportDeclaration(statement) ||
+                ts.isExportAssignment(statement)) {
+                continue;
+            }
+            // Check if the statement has an export modifier
+            const hasExport = ts.canHaveModifiers(statement) &&
+                ts
+                    .getModifiers(statement)
+                    ?.some((mod) => mod.kind === ts.SyntaxKind.ExportKeyword);
+            if (hasExport) {
+                continue;
+            }
+            // This is a non-exported statement - it will be dropped
+            if (ts.isVariableStatement(statement)) {
+                // Get all variable names
+                for (const decl of statement.declarationList.declarations) {
+                    if (ts.isIdentifier(decl.name)) {
+                        nonExported.push({
+                            type: 'variable',
+                            name: decl.name.text,
+                        });
+                    }
+                }
+            }
+            else if (ts.isFunctionDeclaration(statement)) {
+                nonExported.push({
+                    type: 'function',
+                    name: statement.name?.text || null,
+                });
+            }
+            else if (ts.isClassDeclaration(statement)) {
+                nonExported.push({
+                    type: 'class',
+                    name: statement.name?.text || null,
+                });
+            }
+            else if (ts.isInterfaceDeclaration(statement)) {
+                nonExported.push({
+                    type: 'interface',
+                    name: statement.name.text,
+                });
+            }
+            else if (ts.isTypeAliasDeclaration(statement)) {
+                nonExported.push({
+                    type: 'type',
+                    name: statement.name.text,
+                });
+            }
+            else if (ts.isEnumDeclaration(statement)) {
+                nonExported.push({
+                    type: 'enum',
+                    name: statement.name.text,
+                });
+            }
+            // Skip other statement types like expression statements (e.g., console.log)
+        }
+    }
+    catch (error) {
+        // If parsing fails, don't warn - the main extractor will handle errors
+    }
+    return nonExported;
+}
+export default syncUniversalMocks;
+//# sourceMappingURL=syncUniversalMocks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncUniversalMocks.js","sourceRoot":"","sources":["../../../../src/utils/syncUniversalMocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,cAAc,IAAI,EAAE,CAAC;IAEvD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,0DAA0D;QAC1D,MAAM,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,4CAA4C;QAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,kDAAkD;IAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEhD,wBAAwB;IACxB,MAAM,UAAU,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEvD,IAAI,UAAU,EAAE,CAAC;QACf,mCAAmC;QACnC,MAAM,qBAAqB,CAAC;YAC1B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,cAAc,EAAE;gBACd,cAAc,EAAE,UAAU;aAC3B;SACF,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,KAAK,GAAW,EAAE,CAAC;IAEzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,2CAA2C;QAC3C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAExE,iDAAiD;YACjD,MAAM,UAAU,GAAG,YAAY;gBAC7B,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;gBAChD,CAAC,CAAC,YAAY,CAAC;YAEjB,oBAAoB;YACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEnD,uDAAuD;YACvD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAE/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,gCAAgC,YAAY,YAAY,CAAC,CAAC;gBACvE,SAAS;YACX,CAAC;YAED,mDAAmD;YACnD,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CACV,6CAA6C,YAAY,EAAE,CAC5D,CAAC;gBACF,OAAO,CAAC,IAAI,CACV,6DAA6D,CAC9D,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,aAAa,EAAE,CAAC,CAAC;gBACnE,CAAC;gBACD,OAAO,CAAC,IAAI,CACV,2DAA2D,CAC5D,CAAC;gBACF,OAAO,CAAC,IAAI,CACV,2EAA2E,CAC5E,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC;oBACT,SAAS,EAAE,EAAE,EAAE,8BAA8B;oBAC7C,QAAQ,EAAE,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC;oBACrD,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,UAAU,EAAE,YAAY;oBACxB,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,8CAA8C;oBACpE,QAAQ,EAAE;wBACR,aAAa,EAAE,MAAM,CAAC,SAAS;wBAC/B,WAAW,EAAE,KAAK;wBAClB,QAAQ,EAAE,EAAE;qBACb;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,KAAa;IAEb,0BAA0B;IAC1B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC;QAEvD,8EAA8E;QAC9E,wDAAwD;QACxD,IAAI,eAAe,GAAG,QAAQ,CAAC;QAC/B,IAAI,YAAY,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC1D,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;QACtC,CAAC;QAED,MAAM,YAAY,GAAG,YAAY;YAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;YAC5C,CAAC,CAAC,eAAe,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEnD,0BAA0B;QAC1B,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,8CAA8C;QAC9C,6EAA6E;QAC7E,MAAM,eAAe,GAAG,SAAS;aAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;aACjC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;aACvC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,YAAqB;IAChE,yCAAyC;IACzC,IAAI,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE9C,IAAI,YAAY,EAAE,CAAC;QACjB,gEAAgE;QAChE,+CAA+C;QAC/C,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,kEAAkE;IAElE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,CAAS,EAAE,CAAS;IACzC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,kBAAkB;QAClB,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAOD;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,OAAe,EACf,QAAgB;IAEhB,MAAM,WAAW,GAAsB,EAAE,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,CACL,CAAC;QAEF,iCAAiC;QACjC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC9C,0CAA0C;YAC1C,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YAED,yBAAyB;YACzB,IACE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;gBACjC,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAChC,CAAC;gBACD,SAAS;YACX,CAAC;YAED,gDAAgD;YAChD,MAAM,SAAS,GACb,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC;gBAC9B,EAAE;qBACC,YAAY,CAAC,SAAS,CAAC;oBACxB,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAE9D,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,wDAAwD;YACxD,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,yBAAyB;gBACzB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;oBAC1D,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,UAAU;4BAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;yBACrB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/C,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI;iBACnC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5C,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI;iBACnC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,EAAE,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChD,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,EAAE,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChD,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3C,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;YACD,4EAA4E;QAC9E,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;IACzE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,eAAe,kBAAkB,CAAC"}

package/codeyam-cli/src/utils/universal-mocks.js

@@ -0,0 +1,152 @@
+import { runClaudeCode } from "./claude-code.js";
+export async function detectUniversalMocks(existingMocks = [], progressCallback) {
+    const claudeResult = await runClaudeCode({
+        prompt: getPrompt(existingMocks),
+        allowedTools: ['Bash(jq:*)'],
+        progressCallback,
+    });
+    if (!claudeResult) {
+        // Claude Code package failed to load, return empty mocks
+        return {
+            universalMocks: existingMocks,
+            duration_ms: 0,
+            total_cost_usd: 0,
+        };
+    }
+    let resultString = claudeResult.result;
+    // use regexp to extract ths ```json\n...\n``` block
+    const jsonMatch = resultString.match(/```json\n([\s\S]*?)\n```/);
+    if (jsonMatch && jsonMatch.length > 1) {
+        resultString = jsonMatch[1].trim();
+    }
+    else {
+        console.warn(`CodeYam Warning: Claude Code did not return markdown-wrapped JSON`);
+        // fall back to the entire result if no JSON block is found
+    }
+    const result = JSON.parse(resultString);
+    const universalMocks = result && result.universalMocks && Array.isArray(result.universalMocks)
+        ? result.universalMocks
+            .map((mock) => {
+            if (mock.content &&
+                typeof mock.content === 'string' &&
+                mock.filePath &&
+                typeof mock.filePath === 'string' &&
+                mock.entityName &&
+                typeof mock.entityName === 'string') {
+                return {
+                    content: mock.content,
+                    filePath: mock.filePath,
+                    entityName: mock.entityName,
+                };
+            }
+            console.warn(`CodeYam Warning: Invalid universal mock format`, mock);
+            return null;
+        })
+            .filter((mock) => mock !== null)
+        : [];
+    return {
+        universalMocks,
+        duration_ms: claudeResult.duration_ms,
+        total_cost_usd: claudeResult.total_cost_usd,
+    };
+}
+function getPrompt(existingMocks) {
+    const mocksString = JSON.stringify(existingMocks);
+    return `
+  Hi Claude! You should find in this directory a primarily TypeScript-based web application. If that doesn't seem to be the case, return an error object:
+\`\`\`
+{
+  "error": "<reason for failure>"
+}
+\`\`\`
+
+Now, your job is to explore the codebase and read enough source modules to determine if any of them rely on environment variables or external services in a way which **prevents startup**. You will MODIFY NO FILES. You are only gathering data, and you will finish by outputting a JSON object of these 'universal mocks'.
+
+**CRITICAL: Mocks should be MINIMAL** - just enough to prevent startup crashes, not comprehensive implementations.
+
+We will illustrate with examples:
+
+**Example 1: Class that's initialized on load**
+File: \`lib/dbNotifier.ts\`
+\`\`\`
+export class DbNotifier extends EventEmitter {
+  constructor() {
+    super();
+    this.db = connectToDatabase(process.env.DATABASE_URL!); // ❌ Crashes on load
+  }
+  async start() { /* ... */ }
+}
+\`\`\`
+
+**Minimal mock** (just enough to start):
+\`\`\`
+class DbNotifier extends EventEmitter { async start() {} }
+\`\`\`
+
+**Example 2: Client initialized on load**
+File: \`lib/supabase.ts\`
+\`\`\`
+import { createClient } from "@supabase/supabase-js"
+export const supabase = createClient(
+  process.env.NEXT_PUBLIC_SUPABASE_URL!,  // ❌ Crashes on load
+  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
+)
+\`\`\`
+
+**Minimal mock**:
+\`\`\`
+export const supabase = {
+  auth: {
+    getSession: async () => ({ data: { session: null } }),
+    onAuthStateChange: () => ({ data: { subscription: { unsubscribe: () => {} } } })
+  }
+};
+\`\`\`
+
+**Example 3: NO MOCK NEEDED**
+File: \`lib/client.ts\`
+\`\`\`
+export function getClient() {
+  return createClient(process.env.API_URL!);  // ✅ OK - not called on load
+}
+\`\`\`
+No mock needed - lazy initialization won't crash on startup.
+
+**Key principles:**
+1. Only mock things that are **executed during module load**
+2. Mocks should be **minimal** - empty methods/properties are fine
+3. We need the app to **compile and start**, not work correctly
+4. Return types should match what TypeScript expects (but values can be empty/null) When you've determined that a file requires a universal mock, you will include it in your output, which might look something like this:
+\`\`\`json
+{
+  "universalMocks": [
+    {
+      "entityName": "DbNotifier",
+      "filePath": "lib/dbNotifier.ts",
+      "content": "class DbNotifier extends EventEmitter { async start() {} }"
+    },
+    {
+      "entityName": "supabase",
+      "filePath": "lib/supabase.ts",
+      "content": "export const supabase = { auth: { getSession: async () => ({ data: { session: null } }) } };"
+    }
+  ]
+}
+\`\`\`
+
+Note: You MUST wrap the result JSON in \`\`\`json\n...\n\`\`\` so that it can later be extracted programmatically.
+
+So a "universal mock" object contains of a file path (\`/example/lib/supabase.ts\` in our case), an entity name (\`supabase\`), and the full text of the TypeScript with which to replace that entity in the mocked-up module.
+- There can be multiple mocks in the same file, for different entities. An entity is e.g. a function, a type, a variable, a React component, etc.
+- Each universal mock should contain ONLY the replacement content for a single entity. If a file exports multiple entities that need mocking, create separate mock objects for each entity.
+- Remember that the JSON string must be escaped.
+
+The current \`universalMocks\` array, which you should merge into / append to, is as follows:
+\`\`\`
+${mocksString}
+\`\`\`
+
+Now put on your best sleuthing cap and figure out how to scan this repository for likely signs of external dependencies that may need mocking, compile a list of universal mocks, and return it as JSON on the format shown above.
+  `;
+}
+//# sourceMappingURL=universal-mocks.js.map

package/codeyam-cli/src/utils/universal-mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-mocks.js","sourceRoot":"","sources":["../../../../src/utils/universal-mocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,gBAAmD,EAAE,EACrD,gBAAiD;IAMjD,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC;QACvC,MAAM,EAAE,SAAS,CAAC,aAAa,CAAC;QAChC,YAAY,EAAE,CAAC,YAAY,CAAC;QAC5B,gBAAgB;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,yDAAyD;QACzD,OAAO;YACL,cAAc,EAAE,aAAa;YAC7B,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,CAAC;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;IAEvC,oDAAoD;IACpD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACjE,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CACV,mEAAmE,CACpE,CAAC;QACF,2DAA2D;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,cAAc,GAClB,MAAM,IAAI,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;QACrE,CAAC,CAAC,MAAM,CAAC,cAAc;aAClB,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;YACjB,IACE,IAAI,CAAC,OAAO;gBACZ,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;gBAChC,IAAI,CAAC,QAAQ;gBACb,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;gBACjC,IAAI,CAAC,UAAU;gBACf,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EACnC,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CACV,gDAAgD,EAChD,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;QACjD,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,cAAc;QACd,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,cAAc,EAAE,YAAY,CAAC,cAAc;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,aAAqB;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAElD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2FP,WAAW;;;;GAIV,CAAC;AACJ,CAAC"}