@codeyam/codeyam-cli 0.1.0-staging.09652b8 → 0.1.0-staging.15d0f46

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

@@ -0,0 +1,205 @@
+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 } from "../../../packages/database/index.js";
+import { safeFileName } from "../../../packages/utils/index.js";
+import { isServerRunning } from "../utils/serverState.js";
+import { startBackgroundServer } from "../utils/backgroundServer.js";
+import { ensureFreshAnalyzer, resetProject } from "../utils/analyzer.js";
+import { getLogPath } from "../utils/sandbox.js";
+const recaptureCommand = {
+    command: 'recapture <id>',
+    describe: 'Re-run capture for a specific analysis or scenario (auto-detects ID type)',
+    builder: {
+        id: {
+            type: 'string',
+            describe: 'The analysis ID or scenario ID to recapture',
+            demandOption: true,
+        },
+        width: {
+            type: 'number',
+            describe: 'Override the default viewport width for screenshots',
+        },
+    },
+    handler: async (argv) => {
+        header('CodeYam Recapture');
+        const { id, width } = 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', 'name'])
+                .where('id', '=', id)
+                .executeTakeFirst();
+            if (scenarioRow) {
+                // Use the scenario name for the reset logic (status.scenarios uses name, not id)
+                scenarioId = scenarioRow.name;
+                analysisId = scenarioRow.analysis_id;
+                info(`Found scenario "${scenarioId}", 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,
+            });
+            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
+            info('Resetting project cache...');
+            await resetProject(projectSlug);
+            // Ensure analyzer is up-to-date
+            info('Checking analyzer...');
+            await ensureFreshAnalyzer(projectSlug, {
+                update: (message) => info(message),
+            });
+            // Clear log file before starting recapture
+            const logPath = getLogPath(projectSlug);
+            try {
+                fs.writeFileSync(logPath, '', 'utf8');
+            }
+            catch {
+                // Log file might not exist yet, that's fine
+            }
+            const { project } = await requireBranchAndProject(projectSlug);
+            // Ensure web server is running
+            const { running, state } = isServerRunning();
+            let serverUrl;
+            if (running && state) {
+                serverUrl = state.url;
+                info(`Using web server at ${serverUrl}`);
+            }
+            else {
+                info('Starting web server...');
+                const { project: dbProject, branch } = await requireBranchAndProject(projectSlug);
+                const { url } = await startBackgroundServer({
+                    port: 3111,
+                    rootPath: projectRoot,
+                    project: dbProject,
+                    branch,
+                });
+                serverUrl = url;
+                info(`Web server started at ${serverUrl}`);
+            }
+            info('Queueing recapture job...');
+            // Enqueue the recapture job via HTTP API
+            const enqueueResponse = await fetch(`${serverUrl}/api/queue`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    action: 'enqueue',
+                    type: 'recapture',
+                    commitSha: analysis.commit.sha,
+                    projectSlug,
+                    analysisId,
+                    scenarioId,
+                    defaultWidth: width,
+                }),
+            });
+            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 capture to complete...');
+            info('(This may take a few minutes)');
+            info('');
+            // Poll for job completion via HTTP API
+            const pollInterval = 2000;
+            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(`Recapture failed: ${statusData.error || 'Unknown error'}`);
+                    info('');
+                    info('Check logs for details:');
+                    info(`   tail -f ${logPath}`);
+                    return;
+                }
+                if (statusData.status === 'completed') {
+                    completed = true;
+                }
+            }
+            success('Recapture completed!');
+            info('');
+            // Output scenario URLs
+            const port = 3112;
+            const entitySlug = safeFileName(analysis.entityName);
+            if (analysis.scenarios && analysis.scenarios.length > 0) {
+                info('Scenario URLs:');
+                for (const scenario of analysis.scenarios) {
+                    if (!scenarioId || scenario.id === scenarioId) {
+                        const scenarioSlug = safeFileName(scenario.name);
+                        const scenarioUrl = `http://localhost:${port}/static/${projectSlug}/${analysisId}/${entitySlug}/${scenarioSlug}/default`;
+                        info(`   - ${scenario.name}: ${scenarioUrl}`);
+                    }
+                }
+            }
+            info('');
+            info('View results in the CodeYam dashboard:');
+            info(`   ${serverUrl}/analysis/${analysisId}`);
+        }
+        catch (err) {
+            error(`Recapture failed: ${err.message}`);
+            console.error(err);
+        }
+    },
+};
+export default recaptureCommand;
+//# sourceMappingURL=recapture.js.map

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

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

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

@@ -0,0 +1,102 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { error, header, info, ProgressReporter, success, warn, } from "../utils/progress.js";
+import { getProjectRoot } from "../state.js";
+import { generateReportArchive, uploadReport, formatBytes, } from "../utils/generateReport.js";
+const reportCommand = {
+    command: 'report',
+    describe: 'Create a debug report archive for sharing with the CodeYam team',
+    builder: {
+        output: {
+            type: 'string',
+            alias: 'o',
+            describe: 'Output path for the report archive (default: /tmp/codeyam/report-*.tar.gz)',
+        },
+        upload: {
+            type: 'boolean',
+            alias: 'u',
+            default: false,
+            describe: 'Upload the report to CodeYam servers after creating it',
+        },
+    },
+    handler: async (argv) => {
+        header('CodeYam Report');
+        const progress = new ProgressReporter();
+        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...');
+            if (!fs.existsSync(configPath)) {
+                progress.fail('No CodeYam configuration found');
+                error('Run: codeyam init');
+                return;
+            }
+            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');
+            // Generate report archive
+            const result = await generateReportArchive({
+                projectRoot,
+                projectSlug,
+                outputPath: argv.output,
+                feedback: { source: 'cli', issueType: 'other' },
+                onProgress: (message) => {
+                    progress.start(message);
+                },
+            });
+            progress.succeed('Created archive');
+            // Success!
+            console.log();
+            success('Report created successfully');
+            info(`Path: ${result.path}`);
+            info(`Size: ${formatBytes(result.size)}`);
+            if (result.metadata.git.isDirty) {
+                warn('Note: Working directory has uncommitted changes');
+            }
+            // Upload if requested
+            if (argv.upload) {
+                console.log();
+                try {
+                    const uploadResult = await uploadReport({
+                        archivePath: result.path,
+                        projectSlug,
+                        metadata: result.metadata,
+                        onProgress: (message) => {
+                            progress.start(message);
+                        },
+                    });
+                    progress.succeed('Upload confirmed');
+                    console.log();
+                    success(`Report uploaded! ID: ${uploadResult.reportId}`);
+                }
+                catch (uploadError) {
+                    progress.fail('Upload failed');
+                    error(uploadError.message);
+                    info('The local report file is still available at the path above.');
+                }
+            }
+            else {
+                console.log();
+                info('Share this file with the CodeYam team for debugging assistance.');
+                info('Or use --upload to upload directly to CodeYam servers.');
+            }
+        }
+        catch (err) {
+            progress.fail('Report generation failed');
+            error(err.message);
+            process.exit(1);
+        }
+    },
+};
+export default reportCommand;
+//# sourceMappingURL=report.js.map

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

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

package/codeyam-cli/src/commands/setup-sandbox.js

@@ -0,0 +1,165 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { error, header, info, success, ProgressReporter, } from "../utils/progress.js";
+import { initializeEnvironment, requireBranchAndProject, } from "../utils/database.js";
+import { findProjectRoot } from "../utils/project.js";
+import { setProjectRoot } from "../state.js";
+import { copyNodeRepoQuickly, sanitizeEnvFiles } from "../../../packages/utils/server.js";
+import { applyUniversalMocks } from "../../../packages/utils/index.js";
+import { getProjectPath } from "../utils/sandbox.js";
+const DEFAULT_PORT = 9999;
+const setupSandboxCommand = {
+    command: 'setup-sandbox',
+    describe: 'Create a sandbox copy of the project for iterating on startup fixes',
+    builder: {
+        port: {
+            type: 'number',
+            alias: 'p',
+            describe: 'Port to suggest for dev servers',
+            default: DEFAULT_PORT,
+        },
+    },
+    handler: async (argv) => {
+        header('Setting up sandbox environment');
+        const projectRoot = findProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run "codeyam init" first.');
+            process.exit(1);
+        }
+        setProjectRoot(projectRoot);
+        const progress = new ProgressReporter();
+        try {
+            // Read project configuration
+            progress.start('Loading project configuration...');
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            if (!fs.existsSync(configPath)) {
+                progress.fail('Configuration file not found');
+                error('Run "codeyam init" to initialize the project first');
+                return;
+            }
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                progress.fail('Project slug not found in config');
+                return;
+            }
+            progress.succeed('Configuration loaded');
+            // Initialize environment
+            progress.start('Initializing environment...');
+            await initializeEnvironment();
+            progress.succeed('Environment initialized');
+            // Get project from database
+            progress.start('Loading project from database...');
+            const { project } = await requireBranchAndProject(projectSlug);
+            progress.succeed('Project loaded');
+            const packageManager = project.metadata?.packageManager || 'npm';
+            const webapps = project.metadata?.webapps || [];
+            const sandboxPath = getProjectPath(projectSlug);
+            const port = argv.port || DEFAULT_PORT;
+            progress.start('Copying project to sandbox...');
+            // Copy project to temp directory
+            await fs.promises.mkdir(path.dirname(sandboxPath), { recursive: true });
+            await copyNodeRepoQuickly({
+                sourcePath: projectRoot,
+                destinationPath: sandboxPath,
+                excludes: ['.codeyam'],
+                silent: true,
+            });
+            progress.succeed('Project copied');
+            // Sanitize env files - replace real values with dummies
+            progress.start('Sanitizing environment files...');
+            const envResult = await sanitizeEnvFiles({
+                projectPath: sandboxPath,
+            });
+            if (envResult.createdFiles.length > 0 ||
+                envResult.sanitizedFiles.length > 0) {
+                const created = envResult.createdFiles.length;
+                const sanitized = envResult.sanitizedFiles.length;
+                progress.succeed(`Sanitized env files (${created} created, ${sanitized} sanitized)`);
+            }
+            else {
+                progress.succeed('No env files to sanitize');
+            }
+            // Apply universal mocks to the sandbox
+            const universalMocks = project.metadata?.universalMocks ?? [];
+            if (universalMocks.length > 0) {
+                progress.start(`Applying ${universalMocks.length} universal mock(s)...`);
+                const mockResult = await applyUniversalMocks({
+                    mocks: universalMocks,
+                    projectPath: sandboxPath,
+                    log: (msg) => info(msg),
+                });
+                if (mockResult.failed > 0) {
+                    progress.fail(`Failed to apply ${mockResult.failed} mock(s)`);
+                    for (const err of mockResult.errors) {
+                        error(`  ${err.filePath}:${err.entityName} - ${err.error}`);
+                    }
+                }
+                else {
+                    progress.succeed(`Applied ${mockResult.applied} universal mock(s)`);
+                }
+            }
+            // Output success message with instructions
+            console.log();
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            success('SANDBOX READY');
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            console.log();
+            info(`Sandbox path: ${sandboxPath}`);
+            console.log();
+            // Show start commands for each webapp
+            if (webapps.length > 0) {
+                console.log('Configured webapps:');
+                for (const webapp of webapps) {
+                    const webappName = webapp.path === '.' ? 'Root' : webapp.path;
+                    console.log(`  - ${webappName} (${webapp.framework})`);
+                    if (webapp.startCommand) {
+                        const cmd = webapp.startCommand.command || packageManager;
+                        let args = webapp.startCommand.args || ['dev'];
+                        // Substitute $PORT
+                        args = args.map((arg) => arg.includes('$PORT')
+                            ? arg.replace('$PORT', port.toString())
+                            : arg);
+                        // Build env prefix
+                        const envVars = [];
+                        if (webapp.startCommand.env) {
+                            for (const [key, value] of Object.entries(webapp.startCommand.env)) {
+                                if (typeof value === 'string' && value.includes('$PORT')) {
+                                    envVars.push(`${key}=${value.replace('$PORT', port.toString())}`);
+                                }
+                                else {
+                                    envVars.push(`${key}=${value}`);
+                                }
+                            }
+                        }
+                        const envPrefix = envVars.length > 0 ? envVars.join(' ') + ' ' : '';
+                        console.log(`    Start: cd ${sandboxPath} && ${envPrefix}${cmd} ${args.join(' ')}`);
+                    }
+                    else {
+                        console.log(`    Start: (no startCommand configured)`);
+                    }
+                }
+                console.log();
+            }
+            console.log('To test, start a server and then:');
+            console.log(`  curl http://localhost:${port}`);
+            console.log();
+            console.log('Fix any errors directly in the sandbox files.');
+            console.log('Once each fix works, also write it to .codeyam/universal-mocks/');
+            console.log();
+            console.log('When done, verify all webapps with:');
+            for (const webapp of webapps) {
+                console.log(`  codeyam test-startup --webappPath ${webapp.path} --debug`);
+            }
+            console.log();
+        }
+        catch (err) {
+            progress.fail('Setup failed');
+            const message = err instanceof Error ? err.message : String(err);
+            error(message);
+            process.exit(1);
+        }
+    },
+};
+export default setupSandboxCommand;
+//# sourceMappingURL=setup-sandbox.js.map

package/codeyam-cli/src/commands/setup-sandbox.js.map

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

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

@@ -3,7 +3,7 @@ import * as path from 'path';
 import { error, header, info, ProgressReporter, withoutSpinner, } from "../utils/progress.js";
 import { testEnvironment, initializeEnvironment, requireBranchAndProject, } from "../utils/database.js";
 import { getProjectRoot } from "../state.js";
-import { getDatabase } from "../../../packages/supabase/index.js";
+import { getDatabase } from "../../../packages/database/index.js";
 import { ProjectFramework } from "../../../packages/types/index.js";
 import { runAnalysisForEntities } from "../utils/analysisRunner.js";
 import { isRoute } from "../utils/routeIdentification.js";

package/codeyam-cli/src/commands/test-startup.js

@@ -8,6 +8,7 @@ import { setProjectRoot } from "../state.js";
 import { copyNodeRepoQuickly, sanitizeEnvFiles } from "../../../packages/utils/server.js";
 import { applyUniversalMocks } from "../../../packages/utils/index.js";
 import { getGlobalProcessManager, ProcessType, } from "../../../background/src/lib/process/index.js";
+import { resetSandbox, getProjectPath } from "../utils/sandbox.js";
 const testStartupCommand = {
     command: 'test-startup',
     describe: 'Test if project can start without environment variables or external services',
@@ -90,13 +91,24 @@ const testStartupCommand = {
             const webapp = webapps[webAppIndex];
             const framework = webapp.framework;
             const startCommand = webapp.startCommand;
-            const projectPath = `/tmp/codeyam/local-dev/${projectSlug}/project`;
+            const projectPath = getProjectPath(projectSlug);
+            // Use a specific test port to verify $PORT substitution works
+            // This mimics what the actual analysis/capture process does
+            const testPort = 19999;
             console.log();
             info(`Project will be copied to: ${projectPath}`);
             info(`Testing webapp: ${webapp.path === '.' ? 'Root' : webapp.path} (${framework})`);
             info(`Timeout: ${argv.timeout}s`);
             console.log();
-            progress.start('Copying project and attempting startup...');
+            progress.start('Cleaning up and copying project...');
+            // Reset sandbox to clean state (kills processes, removes generated files)
+            const resetResult = await resetSandbox(projectSlug, {
+                port: testPort,
+                silent: !argv.debug,
+            });
+            if (argv.debug && resetResult.removed.length > 0) {
+                info(`Cleaned up: ${resetResult.removed.join(', ')}`);
+            }
             // Copy project to temp directory
             await fs.promises.mkdir(path.dirname(projectPath), { recursive: true });
             await copyNodeRepoQuickly({
@@ -161,9 +173,6 @@ const testStartupCommand = {
             const command = startCommand?.command || packageManager;
             let args = startCommand?.args ||
                 (packageManager === 'npm' ? ['run', 'dev'] : ['dev']);
-            // Use a specific test port to verify $PORT substitution works
-            // This mimics what the actual analysis/capture process does
-            const testPort = 19999;
             let hasPortPlaceholder = false;
             // Clone and process args to substitute $PORT
             args = [...args];