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

package/codeyam-cli/src/commands/debug.js

@@ -0,0 +1,251 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { error, header, info, success } from "../utils/progress.js";
+import { getProjectRoot } from "../state.js";
+import { initializeEnvironment, requireBranchAndProject, } from "../utils/database.js";
+import { getDatabase, loadAnalysis, updateFreshAnalysisStatus, } from "../../../packages/database/index.js";
+import { getWebappInfo, safeFileName, isFrameworkRoute, frameworkRouteFileNameToRoute, } from "../../../packages/utils/index.js";
+import getFrameworkForFile from "../../../packages/utils/src/lib/getFrameworkForFile.js";
+import { startBackgroundServer } from "../utils/backgroundServer.js";
+import { ensureFreshAnalyzer, resetProject } from "../utils/analyzer.js";
+import { getLogPath, getProjectPath } from "../utils/sandbox.js";
+const debugCommand = {
+    command: 'debug <id>',
+    describe: 'Setup debug environment for a specific analysis or scenario (auto-detects ID type)',
+    builder: {
+        id: {
+            type: 'string',
+            describe: 'The analysis ID or scenario ID to debug',
+            demandOption: true,
+        },
+    },
+    handler: async (argv) => {
+        header('CodeYam Debug Setup');
+        const { id } = argv;
+        let analysisId;
+        let scenarioId;
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        try {
+            await initializeEnvironment();
+            // Auto-detect whether the ID is a scenario or analysis
+            info(`Detecting ID type for ${id}...`);
+            const db = getDatabase();
+            // First check if it's a scenario ID
+            const scenarioRow = await db
+                .selectFrom('scenarios')
+                .select(['id', 'analysis_id'])
+                .where('id', '=', id)
+                .executeTakeFirst();
+            if (scenarioRow) {
+                scenarioId = id;
+                analysisId = scenarioRow.analysis_id;
+                info(`Found scenario, using analysis ${analysisId}`);
+            }
+            else {
+                // Check if it's an analysis ID
+                const analysisRow = await db
+                    .selectFrom('analyses')
+                    .select(['id'])
+                    .where('id', '=', id)
+                    .executeTakeFirst();
+                if (analysisRow) {
+                    analysisId = id;
+                    info(`Found analysis ${analysisId}`);
+                }
+                else {
+                    error(`ID ${id} not found as either a scenario or analysis`);
+                    return;
+                }
+            }
+            // Load the analysis
+            info(`Loading analysis ${analysisId}...`);
+            const analysis = await loadAnalysis({
+                id: analysisId,
+                includeScenarios: true,
+                includeCommitAndBranch: true,
+                includeFile: true,
+            });
+            if (!analysis) {
+                error(`Analysis ${analysisId} not found`);
+                return;
+            }
+            if (!analysis.commit) {
+                error(`Commit not found for analysis ${analysisId}`);
+                return;
+            }
+            info(`Found analysis for entity: ${analysis.entityName}`);
+            info(`File: ${analysis.filePath}`);
+            // Get project configuration
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                error('Project slug not found in config');
+                return;
+            }
+            // Reset project cache to ensure clean state (no leftover mocks from setup-sandbox)
+            info('Resetting project cache...');
+            await resetProject(projectSlug);
+            // Ensure analyzer is up-to-date before debug setup
+            info('Checking analyzer...');
+            await ensureFreshAnalyzer(projectSlug, {
+                update: (message) => info(message),
+            });
+            // Clear log file before starting debug setup
+            const logPath = getLogPath(projectSlug);
+            try {
+                fs.writeFileSync(logPath, '', 'utf8');
+            }
+            catch {
+                // Log file might not exist yet, that's fine
+            }
+            const { project, branch } = await requireBranchAndProject(projectSlug);
+            const packageManager = project.metadata?.packageManager || 'npm';
+            const port = 3112;
+            const projectPath = getProjectPath(projectSlug);
+            // Reset scenario capture status
+            info('Resetting scenario status...');
+            await updateFreshAnalysisStatus(analysisId, (freshStatus) => {
+                if (!freshStatus)
+                    return;
+                freshStatus.readyToBeCaptured = true;
+                if (freshStatus.scenarios) {
+                    for (const scenario of freshStatus.scenarios) {
+                        if (!scenarioId || scenario.name === scenarioId) {
+                            delete scenario.screenshotStartedAt;
+                            delete scenario.screenshotFinishedAt;
+                            delete scenario.interactiveStartedAt;
+                            delete scenario.interactiveFinishedAt;
+                            delete scenario.error;
+                            delete scenario.errorStack;
+                        }
+                    }
+                }
+            });
+            // Ensure web server is running (also handles version mismatch detection)
+            const { url: serverUrl, wasAlreadyRunning } = await startBackgroundServer({
+                port: 3111,
+                rootPath: projectRoot,
+                project,
+                branch,
+            });
+            if (wasAlreadyRunning) {
+                info(`Using web server at ${serverUrl}`);
+            }
+            else {
+                info(`Web server started at ${serverUrl}`);
+            }
+            info('Queueing debug setup job...');
+            // Enqueue the job via HTTP API
+            const enqueueResponse = await fetch(`${serverUrl}/api/queue`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    action: 'enqueue',
+                    type: 'debug-setup',
+                    commitSha: analysis.commit.sha,
+                    projectSlug,
+                    analysisId,
+                    scenarioId,
+                    prepOnly: true,
+                }),
+            });
+            if (!enqueueResponse.ok) {
+                const errData = await enqueueResponse.json();
+                error(`Failed to enqueue job: ${errData.error || enqueueResponse.statusText}`);
+                return;
+            }
+            const { jobId } = await enqueueResponse.json();
+            info(`Job queued: ${jobId.substring(0, 8)}`);
+            info('');
+            info('Waiting for setup to complete...');
+            info('(This may take a minute as files are prepared)');
+            info('');
+            // Poll for job completion via HTTP API
+            const pollInterval = 1000;
+            let completed = false;
+            while (!completed) {
+                await new Promise((resolve) => setTimeout(resolve, pollInterval));
+                const statusResponse = await fetch(`${serverUrl}/api/queue?queryType=job&jobId=${encodeURIComponent(jobId)}`);
+                if (!statusResponse.ok) {
+                    error(`Failed to check job status: ${statusResponse.statusText}`);
+                    return;
+                }
+                const statusData = await statusResponse.json();
+                if (statusData.status === 'failed') {
+                    error(`Debug setup failed: ${statusData.error || 'Unknown error'}`);
+                    return;
+                }
+                if (statusData.status === 'completed') {
+                    completed = true;
+                }
+            }
+            success('Debug environment ready!');
+            info('');
+            info('=== Next Steps ===');
+            info('');
+            info('1. Inspect the generated scenario files:');
+            info(`   ${projectPath}`);
+            info('');
+            info('2. Look at the generated layout/component files:');
+            info(`   ls ${projectPath}/app/static/`);
+            info('');
+            info('3. Start the development server:');
+            const webapps = project.metadata?.webapps || [];
+            const environmentVariables = config.environmentVariables || [];
+            const webappInfo = getWebappInfo({
+                filePath: analysis.filePath,
+                webapps,
+                environmentVariables,
+                port,
+                packageManager,
+            });
+            info(`   cd ${projectPath} && ${webappInfo.startCommand}`);
+            info('');
+            info(`4. View in browser (scenario urls):`);
+            // Output actual scenario URLs
+            const entitySlug = safeFileName(analysis.entityName);
+            if (analysis.scenarios && analysis.scenarios.length > 0) {
+                // Determine if this is a framework route to generate correct URLs
+                const framework = getFrameworkForFile(analysis.filePath, webapps);
+                const isRoute = framework &&
+                    analysis.file &&
+                    analysis.entity &&
+                    isFrameworkRoute(analysis.file, analysis.entity, framework);
+                // Filter to just the requested scenario if a specific scenarioId was provided
+                // (scenarioId is only set when the user passed a scenario ID, not an analysis ID)
+                const scenariosToShow = scenarioId
+                    ? analysis.scenarios.filter((s) => s.id === scenarioId)
+                    : analysis.scenarios;
+                for (const scenario of scenariosToShow) {
+                    const scenarioSlug = safeFileName(scenario.name);
+                    let scenarioPath;
+                    if (isRoute && analysis.file && framework) {
+                        // For framework routes, use the full route path generation
+                        scenarioPath = frameworkRouteFileNameToRoute(projectSlug, analysis.file, analysis, framework, scenario.name);
+                    }
+                    else {
+                        // For regular components, use the simple path
+                        scenarioPath = `static/${projectSlug}/${analysisId}/${entitySlug}/${scenarioSlug}/default`;
+                    }
+                    const scenarioUrl = `http://localhost:${port}/${scenarioPath}`;
+                    info(`   - ${scenario.name}: ${scenarioUrl}`);
+                }
+            }
+            info('');
+            info('5. Check logs for errors:');
+            info(`   tail -f ${logPath}`);
+        }
+        catch (err) {
+            error(`Debug setup failed: ${err.message}`);
+            console.error(err);
+        }
+    },
+};
+export default debugCommand;
+//# sourceMappingURL=debug.js.map

package/codeyam-cli/src/commands/debug.js.map

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

package/codeyam-cli/src/commands/default.js

@@ -0,0 +1,84 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { error, withoutSpinner } from "../utils/progress.js";
+import { requireBranchAndProject, testEnvironment } from "../utils/database.js";
+import { startBackgroundServer } from "../utils/backgroundServer.js";
+import { getProjectRoot } from "../state.js";
+function logStartMessage(state) {
+    console.log();
+    console.log(`CodeYam is running a local server on port ${state.port}`);
+    console.log();
+    console.log('Run "codeyam stop" to stop this server from running');
+    console.log();
+    console.log('Run "codeyam help" for other CLI commands');
+    console.log();
+    console.log('Run "codeyam" at any time to display this information or re-open the local server');
+    console.log();
+    console.log(`Visit ${state.url} for the full CodeYam experience`);
+    console.log();
+}
+const defaultCommand = {
+    command: '$0',
+    describe: 'Run CodeYam',
+    builder: {
+        port: {
+            type: 'number',
+            alias: 'p',
+            describe: 'Port to run the web server on',
+            default: 3111,
+        },
+    },
+    handler: async (argv) => {
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        try {
+            // Load project configuration
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                error('Missing project slug. Try reinitializing with: codeyam init --force');
+                return;
+            }
+            // Test database connection
+            const connectionOk = await withoutSpinner(() => testEnvironment());
+            if (!connectionOk) {
+                error('Environment validation failed');
+                return;
+            }
+            // Load project and branch from database
+            const { project, branch } = await requireBranchAndProject(projectSlug);
+            // Start background server
+            const { url, wasAlreadyRunning } = await startBackgroundServer({
+                port: argv.port || 3111,
+                rootPath: projectRoot,
+                project,
+                branch,
+            });
+            if (!wasAlreadyRunning) {
+                console.log();
+                console.log(`✅ Started CodeYam server in background`);
+            }
+            logStartMessage({ port: argv.port || 3111, url, pid: process.pid });
+            // Auto-open browser
+            try {
+                const { execSync } = await import('child_process');
+                execSync(`open "${url}"`, { stdio: 'ignore' });
+            }
+            catch (e) {
+                // Silently fail if open command doesn't work
+            }
+        }
+        catch (err) {
+            error('Failed to start CodeYam server');
+            error(err);
+            process.exit(1);
+        }
+    },
+};
+export default defaultCommand;
+//# sourceMappingURL=default.js.map

package/codeyam-cli/src/commands/default.js.map

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

package/codeyam-cli/src/commands/detect-universal-mocks.js

@@ -0,0 +1,118 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { error, header, info, ProgressReporter, success, withoutSpinner, } from "../utils/progress.js";
+import { testEnvironment } from "../utils/database.js";
+import { detectUniversalMocks } from "../utils/universal-mocks.js";
+import { loadProject, upsertProjects } from "../../../packages/database/index.js";
+import { writeMocksToFiles } from "../utils/syncUniversalMocks.js";
+import { getProjectRoot } from "../state.js";
+const UNIVERSAL_MOCKS_DIR = 'universal-mocks';
+const detectUniversalMocksCommand = {
+    command: 'detect-universal-mocks',
+    describe: 'Analyze codebase to detect universal mocks needed for unconfigured startup',
+    handler: async () => {
+        header('CodeYam Universal Mocks Detection');
+        const progress = new ProgressReporter();
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        try {
+            // Load project configuration
+            progress.start('Loading project configuration...');
+            const config = JSON.parse(await fs.readFile(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                progress.fail('Invalid project configuration');
+                error('Missing project slug. Try reinitializing with: codeyam init --force');
+                return;
+            }
+            progress.succeed('Loaded project configuration');
+            // Test database connection
+            progress.start('Validating environment...');
+            const connectionOk = await withoutSpinner(() => testEnvironment());
+            if (!connectionOk) {
+                progress.fail('Environment validation failed');
+                return;
+            }
+            progress.succeed('Environment validated');
+            // Load project from database
+            progress.start('Loading project from database...');
+            const project = await loadProject({ slug: projectSlug });
+            if (!project) {
+                progress.fail('Project not found in database');
+                error(`Project "${projectSlug}" not found. Try reinitializing.`);
+                return;
+            }
+            progress.succeed('Loaded project from database');
+            // Run universal mocks detection
+            progress.start('Analyzing codebase...');
+            const existingMocks = project.metadata?.universalMocks || [];
+            info(`Found ${existingMocks.length} existing universal mocks`);
+            // Create progress callback to update the spinner with message count
+            const progressCallback = (messageCount) => {
+                progress.update(`Analyzing codebase... (${messageCount} Claude Code messages processed)`);
+            };
+            const result = await detectUniversalMocks(existingMocks, progressCallback);
+            progress.succeed('Universal mocks detection completed');
+            // Log the completion info now that the spinner is done
+            info(`Claude Code finished in ${result.duration_ms}ms, cost $${result.total_cost_usd.toFixed(4)}`);
+            info(`Detected ${result.universalMocks.length} universal mocks`);
+            if (result.universalMocks.length === 0) {
+                success('No universal mocks detected. Your codebase appears to be already compatible with unconfigured startup.');
+                return;
+            }
+            // Write mocks to local files
+            progress.start('Writing mocks to local files...');
+            const mocksDir = path.join(projectRoot, '.codeyam', UNIVERSAL_MOCKS_DIR);
+            await writeMocksToFiles(mocksDir, result.universalMocks);
+            progress.succeed(`Wrote mocks to .codeyam/${UNIVERSAL_MOCKS_DIR}/`);
+            // Update project metadata with new universal mocks
+            progress.start('Updating project metadata...');
+            // Re-read the project to minimize race conditions
+            const freshProject = await loadProject({ slug: projectSlug });
+            if (!freshProject) {
+                progress.fail('Project no longer exists');
+                error('Project was deleted while processing. Please try again.');
+                return;
+            }
+            // Create updated project with new universal mocks
+            const updatedProject = {
+                ...freshProject,
+                metadata: {
+                    ...freshProject.metadata,
+                    universalMocks: result.universalMocks,
+                },
+            };
+            // Use upsertProjects to save the updated project
+            await upsertProjects([updatedProject]);
+            progress.succeed('Project metadata updated');
+            // Display results
+            console.log();
+            success('Universal mocks detection completed successfully!');
+            info(`Updated project with ${result.universalMocks.length} universal mocks`);
+            // Show summary of detected mocks
+            console.log();
+            info('Detected universal mocks:');
+            result.universalMocks.forEach((mock, index) => {
+                info(`  ${index + 1}. ${mock.entityName} in ${mock.filePath}`);
+            });
+            console.log();
+            info(`Edit mock files in: .codeyam/${UNIVERSAL_MOCKS_DIR}/`);
+            info('Changes will sync to the database automatically on next command.');
+        }
+        catch (err) {
+            progress.fail('Universal mocks detection failed');
+            error(`Error: ${err.message}`);
+            if (err.stack) {
+                console.error('Stack trace:', err.stack);
+            }
+            process.exit(1);
+        }
+    },
+};
+export default detectUniversalMocksCommand;
+//# sourceMappingURL=detect-universal-mocks.js.map

package/codeyam-cli/src/commands/detect-universal-mocks.js.map

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

package/codeyam-cli/src/commands/entities.js

@@ -0,0 +1,102 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { error, header, info, ProgressReporter, withoutSpinner, } from "../utils/progress.js";
+import { testEnvironment, initializeEnvironment } from "../utils/database.js";
+import { getProjectRoot } from "../state.js";
+import { getDatabase } from "../../../packages/database/index.js";
+const entitiesCommand = {
+    command: 'entities [name]',
+    describe: 'Search for entities in the project by name',
+    builder: {
+        name: {
+            type: 'string',
+            describe: 'Entity name to search for (optional - lists all if not provided)',
+        },
+    },
+    handler: async (argv) => {
+        const searchTerm = argv.name;
+        header(searchTerm
+            ? `Searching for entities matching "${searchTerm}"`
+            : 'Listing all entities');
+        const progress = new ProgressReporter();
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        try {
+            // Load project configuration
+            progress.start('Loading project configuration...');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                progress.fail('Invalid project configuration');
+                error('Missing project slug. Try reinitializing with: codeyam init --force');
+                return;
+            }
+            progress.succeed('Loaded project configuration');
+            // Test database connection
+            progress.start('Connecting to database...');
+            const connectionOk = await withoutSpinner(() => testEnvironment());
+            if (!connectionOk) {
+                progress.fail('Database connection failed');
+                return;
+            }
+            progress.succeed('Connected to database');
+            // Search for entities
+            progress.start('Searching entities...');
+            await initializeEnvironment();
+            const db = getDatabase();
+            let query = db
+                .selectFrom('entities')
+                .innerJoin('files', 'entities.file_id', 'files.id')
+                .innerJoin('projects', 'files.project_id', 'projects.id')
+                .select([
+                'entities.sha',
+                'entities.name',
+                'entities.entity_type as entityType',
+                'entities.file_path as filePath',
+            ])
+                .where('projects.slug', '=', projectSlug);
+            // Filter by name if provided
+            if (searchTerm) {
+                query = query.where('entities.name', '=', searchTerm);
+            }
+            const entities = await query.execute();
+            progress.succeed('Search complete');
+            // Display results
+            console.log();
+            if (entities.length === 0) {
+                if (searchTerm) {
+                    info(`No entities found matching "${searchTerm}"`);
+                }
+                else {
+                    info('No entities found in this project yet.');
+                }
+                return;
+            }
+            if (searchTerm) {
+                console.log(`Found ${entities.length} entity${entities.length === 1 ? '' : 'ies'} matching "${searchTerm}":\n`);
+            }
+            else {
+                console.log(`Found ${entities.length} entity${entities.length === 1 ? '' : 'ies'}:\n`);
+            }
+            for (const entity of entities) {
+                console.log(`  • ${entity.name} (${entity.entityType})`);
+                console.log(`    ${entity.filePath}`);
+                console.log(`    SHA: ${entity.sha}`);
+                console.log();
+            }
+        }
+        catch (err) {
+            progress.fail('Search failed');
+            error(err.message);
+            console.error(err);
+            process.exit(1);
+        }
+    },
+};
+export default entitiesCommand;
+//# sourceMappingURL=entities.js.map

package/codeyam-cli/src/commands/entities.js.map

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