mlgym-deploy 3.0.4 → 3.0.6

package/DEBUG.md

@@ -0,0 +1,78 @@
+# MCP Debug Mode
+
+## Debug Logging (Enabled by Default)
+
+**✨ Debug mode is ON by default!** You'll automatically see detailed messages when you start Cursor from a terminal.
+
+### To see debug output:
+```bash
+# Just start Cursor from terminal
+cd ~/your-project
+cursor .
+```
+
+### To DISABLE debug logging (if too verbose):
+```bash
+export MLGYM_DEBUG=false
+cursor .
+```
+
+Or:
+```bash
+export DEBUG=off
+cursor .
+```
+
+## What You'll See
+
+When debug mode is enabled, you'll see colored output in the terminal:
+
+```
+╔═══════════════════════════════════════════════════════╗
+║  MLGym MCP Server v3.0.6                              ║
+╚═══════════════════════════════════════════════════════╝
+Backend: https://backend.eu.ezb.net
+Debug mode: ENABLED
+✓ Server ready and waiting for requests...
+
+[12:34:56.789] ℹ INFO ═══════════════════════════════════════════════════
+[12:34:56.790] ℹ INFO Tool called: mlgym_deploy (MCP v3.0.6)
+[12:34:56.791] ⋯ DEBUG Arguments: {...}
+[12:34:56.792] ℹ INFO Starting deployment workflow...
+[12:34:58.123] ✓ SUCCESS Tool mlgym_deploy completed in 1331ms
+[12:34:58.124] ℹ INFO ═══════════════════════════════════════════════════
+```
+
+## Log Levels
+
+- **ℹ INFO** (cyan) - General information about operations
+- **✓ SUCCESS** (green) - Successful completions
+- **⚠ WARNING** (yellow) - Non-fatal issues (always shown)
+- **✗ ERROR** (red) - Errors and failures (always shown)
+- **⋯ DEBUG** (dim) - Detailed debugging info (only in debug mode)
+
+## Debugging Tips
+
+1. **Start Cursor from terminal** to see the output:
+   ```bash
+   cd ~/your-project
+   cursor .
+   ```
+
+2. **Check the terminal** where you launched Cursor - all MCP logs appear there
+
+3. **Errors and warnings** are always shown
+
+4. **Disable debug mode** if output is too verbose:
+   ```bash
+   export MLGYM_DEBUG=false
+   cursor .
+   ```
+
+## Troubleshooting
+
+If you don't see debug messages:
+1. Make sure you started Cursor from a terminal (not from GUI/Dock)
+2. Check that you're using MCP v3.0.6 or later
+3. Verify debug isn't explicitly disabled: `echo $MLGYM_DEBUG`
+4. Look at the terminal where you launched Cursor, not inside Cursor itself

package/index.js

@@ -17,9 +17,68 @@ import crypto from 'crypto';
 const execAsync = promisify(exec);
 
 // Current version of this MCP server - INCREMENT FOR WORKFLOW FIXES
-const CURRENT_VERSION = '3.0.4';  // Added administrator (chka@stratus5.com) as project member for debugging
+const CURRENT_VERSION = '3.0.6';  // Added debug logging with colored terminal output
 const PACKAGE_NAME = 'mlgym-deploy';
 
+// Debug logging configuration - ENABLED BY DEFAULT
+const DEBUG_ENABLED = process.env.MLGYM_DEBUG !== 'false' && process.env.DEBUG !== 'off';
+const DEBUG_COLORS = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m'
+};
+
+// Enhanced debug logging functions
+function debugLog(level, message, ...args) {
+  const timestamp = new Date().toISOString().split('T')[1].replace('Z', '');
+  let color = DEBUG_COLORS.reset;
+  let prefix = '';
+
+  switch(level) {
+    case 'info':
+      color = DEBUG_COLORS.cyan;
+      prefix = 'ℹ INFO';
+      break;
+    case 'success':
+      color = DEBUG_COLORS.green;
+      prefix = '✓ SUCCESS';
+      break;
+    case 'warning':
+      color = DEBUG_COLORS.yellow;
+      prefix = '⚠ WARNING';
+      break;
+    case 'error':
+      color = DEBUG_COLORS.red;
+      prefix = '✗ ERROR';
+      break;
+    case 'debug':
+      color = DEBUG_COLORS.dim;
+      prefix = '⋯ DEBUG';
+      break;
+    default:
+      prefix = '• LOG';
+  }
+
+  if (DEBUG_ENABLED || level === 'error' || level === 'warning') {
+    console.error(`${DEBUG_COLORS.dim}[${timestamp}]${DEBUG_COLORS.reset} ${color}${prefix}${DEBUG_COLORS.reset} ${message}`, ...args);
+  }
+}
+
+// Convenience logging functions
+const log = {
+  info: (msg, ...args) => debugLog('info', msg, ...args),
+  success: (msg, ...args) => debugLog('success', msg, ...args),
+  warning: (msg, ...args) => debugLog('warning', msg, ...args),
+  error: (msg, ...args) => debugLog('error', msg, ...args),
+  debug: (msg, ...args) => debugLog('debug', msg, ...args)
+};
+
 // Version check state
 let versionCheckResult = null;
 let lastVersionCheck = 0;
@@ -1063,6 +1122,7 @@ async function initProject(args) {
 
   // Create initial commit and push (like CLI does)
   const gitSteps = [];
+  let pushSucceeded = false;
 
   try {
     // Check if there are any files to commit
@@ -1094,11 +1154,20 @@ async function initProject(args) {
 
     // Push to trigger webhook and deployment
     gitSteps.push('Pushing to GitLab to trigger deployment');
+    console.error('Executing: git push -u mlgym main');
     await execAsync('git push -u mlgym main', { cwd: absolutePath });
+    gitSteps.push('✅ Successfully pushed to GitLab');
+    pushSucceeded = true;
+    console.error('✅ Git push completed successfully');
 
   } catch (pushError) {
-    console.error('Git operations warning:', pushError.message);
-    gitSteps.push(`Warning: ${pushError.message}`);
+    console.error('❌ Git push failed:', pushError.message);
+    gitSteps.push(`❌ Push failed: ${pushError.message}`);
+    // Include stderr if available
+    if (pushError.stderr) {
+      console.error('Git push stderr:', pushError.stderr);
+      gitSteps.push(`Error details: ${pushError.stderr}`);
+    }
   }
 
   // Monitor deployment if enabled (like CLI does)
@@ -1145,8 +1214,10 @@ async function initProject(args) {
     content: [{
       type: 'text',
       text: JSON.stringify({
-        status: 'success',
-        message: 'Project created and pushed successfully',
+        status: pushSucceeded ? 'success' : 'partial_success',
+        message: pushSucceeded
+          ? 'Project created and pushed successfully'
+          : 'Project created but git push failed - please push manually',
         project: {
           id: project.id,
           name: project.name,
@@ -1157,13 +1228,23 @@ async function initProject(args) {
         },
         git_operations: gitSteps,
         deployment: deploymentStatus,
-        next_steps: enable_deployment && deploymentStatus?.status === 'deployed' ? [
-          `✅ Your application is live at: ${deploymentStatus.url}`,
-          'Future updates: git push mlgym main'
-        ] : [
-          'To update: git push mlgym main',
-          enable_deployment ? 'Deployment will trigger automatically' : null
-        ].filter(Boolean)
+        push_succeeded: pushSucceeded,
+        next_steps: pushSucceeded
+          ? (enable_deployment && deploymentStatus?.status === 'deployed' ? [
+              `✅ Your application is live at: ${deploymentStatus.url}`,
+              'Future updates: git push mlgym main'
+            ] : [
+              enable_deployment ? 'Deployment triggered - check URL in a few minutes' : 'Project ready',
+              enable_deployment ? `Expected URL: https://${hostname}.ezb.net` : null,
+              'To update: git push mlgym main'
+            ].filter(Boolean))
+          : [
+              '❌ Git push failed - deployment not triggered',
+              'Manual steps required:',
+              `1. cd ${local_path}`,
+              '2. git push mlgym main',
+              'Check the git_operations array above for error details'
+            ]
       }, null, 2)
     }]
   };
@@ -1841,27 +1922,47 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
 
-  console.error(`Tool called: ${name} (MCP v${CURRENT_VERSION})`);
+  log.info(`═══════════════════════════════════════════════════`);
+  log.info(`Tool called: ${DEBUG_COLORS.bright}${name}${DEBUG_COLORS.reset} (MCP v${CURRENT_VERSION})`);
+  log.debug(`Arguments:`, JSON.stringify(args, null, 2));
 
   try {
+    let result;
+    const startTime = Date.now();
+
     switch (name) {
       case 'mlgym_deploy':
-        return await deployProject(args);
+        log.info(`Starting deployment workflow...`);
+        result = await deployProject(args);
+        break;
 
       case 'mlgym_status':
-        return await getStatus(args);
+        log.info(`Checking status...`);
+        result = await getStatus(args);
+        break;
 
       case 'mlgym_user_create':
-        return await createUser(args);
+        log.info(`Creating user account...`);
+        result = await createUser(args);
+        break;
 
       case 'mlgym_auth_login':
-        return await loginUser(args);
+        log.info(`Authenticating user...`);
+        result = await loginUser(args);
+        break;
 
       default:
         throw new Error(`Unknown tool: ${name}. Available tools: mlgym_deploy, mlgym_status, mlgym_user_create, mlgym_auth_login`);
     }
+
+    const duration = Date.now() - startTime;
+    log.success(`Tool ${name} completed in ${duration}ms`);
+    log.info(`═══════════════════════════════════════════════════`);
+
+    return result;
   } catch (error) {
-    console.error(`Tool execution failed:`, error);
+    log.error(`Tool execution failed:`, error.message);
+    log.error(`Stack trace:`, error.stack);
     return {
       content: [{
         type: 'text',
@@ -1878,10 +1979,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`MLGym MCP Server v${CURRENT_VERSION} started`);
+
+  console.error(`\n${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}╔═══════════════════════════════════════════════════════╗${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}║${DEBUG_COLORS.reset}  ${DEBUG_COLORS.bright}MLGym MCP Server v${CURRENT_VERSION}${DEBUG_COLORS.reset}                        ${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}║${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}╚═══════════════════════════════════════════════════════╝${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.dim}Backend: ${CONFIG.backend_url}${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.dim}Debug mode: ${DEBUG_ENABLED ? DEBUG_COLORS.green + 'ENABLED (default)' : DEBUG_COLORS.yellow + 'DISABLED'}${DEBUG_COLORS.reset}`);
+
+  if (!DEBUG_ENABLED) {
+    console.error(`${DEBUG_COLORS.yellow}💡 Debug disabled. To re-enable: unset MLGYM_DEBUG${DEBUG_COLORS.reset}`);
+  } else {
+    console.error(`${DEBUG_COLORS.dim}💡 To disable debug: export MLGYM_DEBUG=false${DEBUG_COLORS.reset}`);
+  }
+
+  console.error(`${DEBUG_COLORS.green}✓ Server ready and waiting for requests...${DEBUG_COLORS.reset}\n`);
 }
 
 main().catch((error) => {
-  console.error('Server error:', error);
+  log.error('Server startup failed:', error);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mlgym-deploy",
-  "version": "3.0.4",
-  "description": "MCP server for MLGym - Added administrator as project member for debugging",
+  "version": "3.0.6",
+  "description": "MCP server for MLGym - Added debug logging with colored terminal output",
   "main": "index.js",
   "type": "module",
   "bin": {
@@ -51,3 +51,6 @@
     ]
   }
 }
+ 
+ 
+