fix: railway deployment pipeline - improved CLI installation and error handling

- Fixed Railway CLI installation with multiple fallback methods
- Added robust error handling and file validation
- Created standalone installation script for debugging
- Improved authentication and deployment process
- Added comprehensive logging for troubleshooting

Author: Neil Munoz

.github/workflows/production-pipeline.yml

@@ -321,67 +321,110 @@ jobs:
     environment:
       name: production
       url: ${{ steps.deploy.outputs.url }}
-    
+
     steps:
       - name: 📥 Checkout Repository
         uses: actions/checkout@v4
 
+      - name: 🐍 Setup Node.js for Railway CLI
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
       - name: 🚂 Deploy to Railway
         id: deploy
         env:
           RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
         run: |
-          echo "Installing Railway CLI..."
-          # Use specific version that is known to work
-          RAILWAY_VERSION="v3.17.1"
-          curl -L -o railway "https://github.com/railwayapp/cli/releases/download/${RAILWAY_VERSION}/railway-linux-amd64" || {
-            echo "Failed to download specific version, trying alternative..."
-            # Alternative: Use npm installation
-            npm install -g @railway/cli
-            ln -sf $(npm root -g)/@railway/cli/bin/railway /usr/local/bin/railway
-          }
-          
-          # Make executable if downloaded directly
-          if [ -f "railway" ]; then
+          echo "🚀 Starting Railway deployment process..."
+
+          # Method 1: Try npm installation first (most reliable)
+          echo "📦 Installing Railway CLI via npm..."
+          npm install -g @railway/cli || {
+            echo "❌ npm installation failed, trying alternative method..."
+
+            # Method 2: Download from GitHub releases with better error handling
+            echo "⬇️ Downloading Railway CLI from GitHub releases..."
+            RAILWAY_VERSION="v3.17.1"
+
+            # Try multiple download URLs
+            if curl -L -o railway "https://github.com/railwayapp/cli/releases/download/${RAILWAY_VERSION}/railway-linux-amd64"; then
+              echo "✅ Download successful"
+            elif curl -L -o railway "https://github.com/railwayapp/cli/releases/download/${RAILWAY_VERSION}/railway_linux_amd64"; then
+              echo "✅ Download successful (alternative URL)"
+            else
+              echo "❌ All download methods failed"
+              exit 1
+            fi
+
+            # Verify the downloaded file
+            if [ ! -f "railway" ]; then
+              echo "❌ Downloaded file not found"
+              exit 1
+            fi
+
+            # Check if file is a valid binary (not HTML error page)
+            if head -n 1 railway | grep -q "Not Found\|404\|HTML"; then
+              echo "❌ Downloaded file appears to be an error page, not a binary"
+              cat railway
+              exit 1
+            fi
+
+            # Make executable and move to PATH
             chmod +x railway
             sudo mv railway /usr/local/bin/railway
+          }
+
+          # Verify installation
+          echo "🔍 Verifying Railway CLI installation..."
+          if ! command -v railway &> /dev/null; then
+            echo "❌ Railway CLI not found in PATH"
+            which railway || echo "railway command not found"
+            exit 1
           fi
-          
-          echo "Verifying Railway CLI installation..."
-          which railway
+
+          echo "✅ Railway CLI installed successfully"
           railway --version || railway version
-          
-          echo "Checking Railway authentication..."
+
+          # Authenticate with Railway
+          echo "🔐 Authenticating with Railway..."
           if [ -z "$RAILWAY_TOKEN" ]; then
-            echo "❌ RAILWAY_TOKEN is not set"
+            echo "❌ RAILWAY_TOKEN environment variable is not set"
             exit 1
           fi
-          echo "✅ RAILWAY_TOKEN is configured"
-          
-          echo "Deploying to Railway..."
-          # Use railway up without specific service first
-          railway up --detach || {
-            echo "❌ Basic deployment failed, trying with project linking..."
-            # Try to link to existing project if needed
-            railway login --token "$RAILWAY_TOKEN" 2>/dev/null || true
-            railway up --detach
-          }
-          
-          echo "✅ Deployment initiated successfully!"
+
+          # Login with token
+          if ! railway login --token "$RAILWAY_TOKEN"; then
+            echo "❌ Railway authentication failed"
+            exit 1
+          fi
+
+          echo "✅ Successfully authenticated with Railway"
+
+          # Deploy to Railway
+          echo "🚀 Deploying application to Railway..."
+          if ! railway up --detach; then
+            echo "❌ Railway deployment failed"
+            railway status || echo "Could not get deployment status"
+            exit 1
+          fi
+
+          echo "✅ Railway deployment initiated successfully!"
+
+          # Get deployment URL
+          echo "🔗 Getting deployment URL..."
+          sleep 10
+          railway status || echo "Could not get deployment status"
 
       - name: 🏥 Post-Deployment Health Check
         run: |
-          echo "Waiting for deployment to stabilize..."
+          echo "⏳ Waiting for deployment to stabilize..."
           sleep 60
-          
-          echo "Checking Railway deployment status..."
-          railway status --service neurobank-fastapi || echo "Status check completed"
-          
-          echo "✅ Railway deployment initiated successfully!"
-          echo "🏥 Application will be available shortly at your Railway domain"
-          echo "📋 Check Railway dashboard for deployment progress and URL"
-        env:
-          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
+
+          echo "🔍 Checking Railway deployment status..."
+          railway status || echo "⚠️ Could not retrieve deployment status"
+
+          echo "✅ Railway deployment process completed!"
 
       - name: 📢 Deployment Notification
         if: always()