deepdebug-local-agent 1.0.5 → 1.0.8

package/bin/install.js

@@ -47,6 +47,35 @@ function getOsVersion() {
     return `${os.type()} ${os.release()}`;
 }
 
+function getDefaultProjectsPath() {
+    const home = os.homedir();
+    if (isWindows) {
+        // Check common Windows paths
+        const documentsProjects = path.join(home, 'Documents', 'Projects');
+        const projects = path.join(home, 'Projects');
+        const repos = path.join(home, 'repos');
+        const source = path.join(home, 'source', 'repos'); // Visual Studio default
+
+        if (fs.existsSync(documentsProjects)) return documentsProjects;
+        if (fs.existsSync(projects)) return projects;
+        if (fs.existsSync(repos)) return repos;
+        if (fs.existsSync(source)) return source;
+        return documentsProjects; // Default
+    } else {
+        // macOS / Linux
+        const projects = path.join(home, 'Projects');
+        const dev = path.join(home, 'dev');
+        const code = path.join(home, 'code');
+        const repos = path.join(home, 'repos');
+
+        if (fs.existsSync(projects)) return projects;
+        if (fs.existsSync(dev)) return dev;
+        if (fs.existsSync(code)) return code;
+        if (fs.existsSync(repos)) return repos;
+        return projects; // Default
+    }
+}
+
 // ============================================
 // Console colors (cross-platform)
 // ============================================
@@ -245,10 +274,67 @@ async function selectPermissions() {
     return granted;
 }
 
+// ============================================
+// Projects folder selection
+// ============================================
+async function selectProjectsFolder() {
+    console.log();
+    log('╔══════════════════════════════════════════════════════════════════╗', 'cyan');
+    log('║                    PROJECTS FOLDER SETUP                          ║', 'cyan');
+    log('╚══════════════════════════════════════════════════════════════════╝', 'cyan');
+    console.log();
+    log('DeepDebug needs access to your projects folder to:', 'bright');
+    log('  • Read source code for error analysis', 'reset');
+    log('  • Apply AI-suggested fixes (with your permission)', 'reset');
+    log('  • Monitor build outputs and logs', 'reset');
+    console.log();
+
+    const defaultPath = getDefaultProjectsPath();
+    log(`Detected default projects folder: ${defaultPath}`, 'cyan');
+    console.log();
+
+    const customPath = await prompt(`Enter your projects folder path [${defaultPath}]: `);
+    const selectedPath = customPath || defaultPath;
+
+    // Validate path exists
+    if (!fs.existsSync(selectedPath)) {
+        logWarning(`Folder does not exist: ${selectedPath}`);
+        const create = await promptYesNo('Create this folder?', true);
+        if (create) {
+            fs.mkdirSync(selectedPath, { recursive: true });
+            logSuccess(`Created folder: ${selectedPath}`);
+        } else {
+            logError('Projects folder is required for DeepDebug to function.');
+            process.exit(1);
+        }
+    }
+
+    // List subfolders (potential projects)
+    try {
+        const items = fs.readdirSync(selectedPath, { withFileTypes: true });
+        const folders = items.filter(i => i.isDirectory() && !i.name.startsWith('.')).map(i => i.name);
+
+        if (folders.length > 0) {
+            console.log();
+            log('Found projects in this folder:', 'green');
+            folders.slice(0, 10).forEach(f => log(`  📁 ${f}`, 'reset'));
+            if (folders.length > 10) {
+                log(`  ... and ${folders.length - 10} more`, 'reset');
+            }
+        }
+    } catch (e) {
+        // Ignore errors listing folder
+    }
+
+    console.log();
+    logSuccess(`Projects folder: ${selectedPath}`);
+    return selectedPath;
+}
+
 // ============================================
 // API functions
 // ============================================
-async function authorizeWithServer(apiKey, permissions) {
+async function authorizeWithServer(apiKey, permissions, projectsPath) {
     const machineId = getMachineId();
     const machineName = getMachineName();
     const osType = getOsType();
@@ -268,7 +354,7 @@ async function authorizeWithServer(apiKey, permissions) {
                 osType,
                 osVersion,
                 permissions,
-                workspacePaths: [], // Empty - workspaces configured in dashboard
+                workspacePaths: [projectsPath],
                 agentVersion
             })
         });
@@ -320,25 +406,48 @@ function isAgentContainerRunning() {
     } catch { return false; }
 }
 
+function convertToDockerPath(windowsPath) {
+    if (!isWindows) return windowsPath;
+    // Convert C:\Users\foo to /c/Users/foo for Docker
+    return windowsPath.replace(/\\/g, '/').replace(/^([A-Za-z]):/, (_, letter) => `/${letter.toLowerCase()}`);
+}
+
 function startDockerAgent(config) {
     try {
-        try { execSync('docker stop deepdebug-agent', { stdio: 'ignore' }); execSync('docker rm deepdebug-agent', { stdio: 'ignore' }); } catch {}
+        // Stop existing container
+        try {
+            execSync('docker stop deepdebug-agent', { stdio: 'ignore' });
+            execSync('docker rm deepdebug-agent', { stdio: 'ignore' });
+        } catch {}
+
         logInfo('Pulling latest DeepDebug Local Agent image...');
         execSync(`docker pull ${DOCKER_IMAGE}`, { stdio: 'inherit' });
 
+        // Prepare paths for Docker
         let configMount = CONFIG_DIR;
+        let projectsMount = config.projectsPath;
+
         if (isWindows) {
-            configMount = configMount.replace(/\\/g, '/').replace(/^([A-Za-z]):/, '/$1');
+            configMount = convertToDockerPath(configMount);
+            projectsMount = convertToDockerPath(projectsMount);
         }
 
+        // Build docker run command
         const dockerArgs = [
-            'run', '-d', '--name', 'deepdebug-agent', '-p', '5055:5055',
+            'run', '-d',
+            '--name', 'deepdebug-agent',
+            '-p', '5055:5055',
             '-v', `${configMount}:/home/deepdebug/.deepdebug:ro`,
-            '-e', `DEEPDEBUG_GATEWAY_URL=${config.gatewayUrl}`,
-            '-e', `DEEPDEBUG_TENANT_ID=${config.tenantId}`,
-            '-e', `DEEPDEBUG_AUTH_TOKEN=${config.authorizationToken}`,
-            '--restart', 'unless-stopped', DOCKER_IMAGE
+            '-v', `${projectsMount}:/workspace:rw`,
+            '-e', `GATEWAY_URL=${config.gatewayUrl}`,
+            '-e', `TENANT_ID=${config.tenantId}`,
+            '-e', `AUTH_TOKEN=${config.authorizationToken}`,
+            '-e', `WORKSPACE_ROOT=/workspace`,
+            '--restart', 'unless-stopped',
+            DOCKER_IMAGE
         ];
+
+        logInfo('Starting Docker container with workspace mounted...');
         execSync(`docker ${dockerArgs.join(' ')}`, { stdio: 'inherit' });
         logSuccess('DeepDebug Local Agent started successfully!');
         return true;
@@ -364,12 +473,16 @@ async function install(options = {}) {
     if (isConfigured() && !options.force) {
         const config = loadConfig();
         logInfo(`Already configured for tenant: ${config.tenantName || config.tenantId}`);
+        if (config.projectsPath) {
+            logInfo(`Projects folder: ${config.projectsPath}`);
+        }
         if (!await promptYesNo('Do you want to reconfigure?', false)) {
             logInfo('Run "npx deepdebug-local-agent start" to start the agent.');
             return;
         }
     }
 
+    // Step 1: API Key
     let apiKey = options.apiKey;
     if (!apiKey) {
         console.log();
@@ -381,20 +494,30 @@ async function install(options = {}) {
     }
     if (!apiKey) { logError('API Key is required'); process.exit(1); }
 
+    // Step 2: Authorization terms
     displayAuthorizationTerms();
     if (!await promptYesNo('Do you authorize the DeepDebug Local Agent with these permissions?', false)) {
         logWarning('Authorization declined. Installation cancelled.');
         process.exit(0);
     }
 
+    // Step 3: Select permissions
     const permissions = await selectPermissions();
     logInfo(`Selected permissions: ${permissions.join(', ')}`);
 
+    // Step 4: Projects folder
+    const projectsPath = await selectProjectsFolder();
+
+    // Step 5: Authorize with server
     console.log();
-    const authResult = await authorizeWithServer(apiKey, permissions);
-    if (!authResult.success) { logError(`Authorization failed: ${authResult.error}`); process.exit(1); }
+    const authResult = await authorizeWithServer(apiKey, permissions, projectsPath);
+    if (!authResult.success) {
+        logError(`Authorization failed: ${authResult.error}`);
+        process.exit(1);
+    }
     logSuccess(`Authorized for tenant: ${authResult.tenantName}`);
 
+    // Step 6: Save config
     const config = {
         authorizationToken: authResult.authorizationToken,
         authorizationId: authResult.authorizationId,
@@ -403,6 +526,7 @@ async function install(options = {}) {
         gatewayUrl: authResult.gatewayUrl,
         websocketUrl: authResult.websocketUrl,
         permissions,
+        projectsPath,
         machineId: getMachineId(),
         machineName: getMachineName(),
         osType: getOsType(),
@@ -411,6 +535,7 @@ async function install(options = {}) {
     };
     saveConfig(config);
 
+    // Step 7: Docker check
     console.log();
     logInfo('Checking Docker installation...');
     if (!isDockerInstalled()) {
@@ -426,6 +551,7 @@ async function install(options = {}) {
     }
     logSuccess('Docker is installed and running');
 
+    // Step 8: Start agent
     console.log();
     if (await promptYesNo('Start DeepDebug Local Agent now?', true)) {
         await start();
@@ -433,12 +559,14 @@ async function install(options = {}) {
         logInfo('To start later: npx deepdebug-local-agent start');
     }
 
+    // Done!
     console.log();
     log('╔══════════════════════════════════════════════════════════════════╗', 'green');
     log('║                    Installation Complete! 🎉                      ║', 'green');
     log('╚══════════════════════════════════════════════════════════════════╝', 'green');
     console.log();
-    logInfo('Workspaces can be configured in the DeepDebug dashboard.');
+    logInfo(`Projects folder mounted: ${projectsPath}`);
+    logInfo('All projects in this folder are now accessible to DeepDebug.');
     log('Dashboard: https://deepdebug.ai/settings/agent', 'blue');
     console.log();
 }
@@ -447,11 +575,23 @@ async function start() {
     console.log();
     log('🚀 Starting DeepDebug Local Agent...', 'cyan');
     const config = loadConfig();
-    if (!config?.authorizationToken) { logError('Not configured. Run "npx deepdebug-local-agent install" first.'); process.exit(1); }
+    if (!config?.authorizationToken) {
+        logError('Not configured. Run "npx deepdebug-local-agent install" first.');
+        process.exit(1);
+    }
+
+    if (!config.projectsPath) {
+        logWarning('No projects folder configured.');
+        logInfo('Run "npx deepdebug-local-agent install --force" to reconfigure.');
+        process.exit(1);
+    }
 
     logInfo('Validating authorization...');
     const validation = await validateAuthorization(config.authorizationToken, config.machineId);
-    if (!validation.valid) { logError(`Authorization invalid: ${validation.message}`); process.exit(1); }
+    if (!validation.valid) {
+        logError(`Authorization invalid: ${validation.message}`);
+        process.exit(1);
+    }
     logSuccess('Authorization valid');
 
     if (!isDockerInstalled()) { logError('Docker is not installed.'); process.exit(1); }
@@ -465,6 +605,7 @@ async function start() {
     if (startDockerAgent(config)) {
         console.log();
         logSuccess('Agent is running!');
+        logInfo(`Projects folder: ${config.projectsPath}`);
         logInfo('Dashboard: https://deepdebug.ai/monitoring');
         logInfo('Local API: http://localhost:5055/health');
         logInfo('Logs: docker logs -f deepdebug-agent');
@@ -473,8 +614,12 @@ async function start() {
 
 async function stop() {
     log('🛑 Stopping DeepDebug Local Agent...', 'yellow');
-    try { execSync('docker stop deepdebug-agent', { stdio: 'inherit' }); logSuccess('Agent stopped.'); }
-    catch { logWarning('Agent is not running.'); }
+    try {
+        execSync('docker stop deepdebug-agent', { stdio: 'inherit' });
+        logSuccess('Agent stopped.');
+    } catch {
+        logWarning('Agent is not running.');
+    }
 }
 
 async function status() {
@@ -488,6 +633,7 @@ async function status() {
     const config = loadConfig();
     if (config) {
         logSuccess(`Configured for: ${config.tenantName || config.tenantId}`);
+        logInfo(`Projects folder: ${config.projectsPath || 'Not configured'}`);
         logInfo(`Permissions: ${config.permissions?.join(', ') || 'N/A'}`);
     } else {
         logWarning('Not configured. Run: npx deepdebug-local-agent install');
@@ -498,7 +644,9 @@ async function status() {
         try {
             const resp = await fetch('http://localhost:5055/health');
             logSuccess(resp.ok ? 'Health: OK' : 'Health: Degraded');
-        } catch { logWarning('Health: Cannot connect'); }
+        } catch {
+            logWarning('Health: Cannot connect');
+        }
     } else {
         logWarning('Agent: Not running');
     }
@@ -511,7 +659,10 @@ async function logs() {
 
 async function uninstall() {
     if (!await promptYesNo('Uninstall DeepDebug Local Agent?', false)) return;
-    try { execSync('docker stop deepdebug-agent', { stdio: 'ignore' }); execSync('docker rm deepdebug-agent', { stdio: 'ignore' }); } catch {}
+    try {
+        execSync('docker stop deepdebug-agent', { stdio: 'ignore' });
+        execSync('docker rm deepdebug-agent', { stdio: 'ignore' });
+    } catch {}
     if (fs.existsSync(CONFIG_FILE)) fs.unlinkSync(CONFIG_FILE);
     if (fs.existsSync(MACHINE_ID_FILE)) fs.unlinkSync(MACHINE_ID_FILE);
     try { fs.rmdirSync(CONFIG_DIR); } catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepdebug-local-agent",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "DeepDebug Local Agent - AI-powered code debugging assistant",
   "private": false,
   "type": "module",