@programinglive/dev-workflow-mcp-server 1.7.11 → 1.7.13

package/scripts/create-admin.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import pg from 'pg';
+import { createUser } from '../web/lib/auth.js';
+
+const { Pool } = pg;
+
+// Get database configuration from environment
+const dbUrl = process.env.DEV_WORKFLOW_DB_URL;
+
+if (!dbUrl) {
+    console.error('Error: DEV_WORKFLOW_DB_URL environment variable is not set');
+    process.exit(1);
+}
+
+const pool = new Pool({ connectionString: dbUrl });
+
+async function createAdminUser() {
+    const username = process.env.ADMIN_USERNAME || 'admin';
+    const password = process.env.ADMIN_PASSWORD || 'admin123';
+    const email = process.env.ADMIN_EMAIL || 'admin@example.com';
+
+    try {
+        // Check if admin user already exists
+        const existing = await pool.query('SELECT id FROM users WHERE username = $1', [username]);
+
+        if (existing.rows.length > 0) {
+            console.log(`✓ Admin user '${username}' already exists`);
+            process.exit(0);
+        }
+
+        // Create admin user
+        const user = await createUser(pool, username, password, email);
+        console.log(`✓ Created admin user: ${user.username}`);
+        console.log(`  Email: ${user.email}`);
+        console.log(`  Password: ${password}`);
+        console.log('\n⚠️  Please change the password after first login!');
+
+    } catch (error) {
+        console.error('Error creating admin user:', error.message);
+        process.exit(1);
+    } finally {
+        await pool.end();
+    }
+}
+
+createAdminUser();

package/scripts/deploy-gcloud.ps1

@@ -0,0 +1,160 @@
+# GCP Deployment Script using gcloud CLI (PowerShell)
+# This script deploys the dev-workflow MCP server to a GCP Compute Engine instance
+
+$ErrorActionPreference = "Stop"
+
+# Configuration - Update these values
+$PROJECT_ID = if ($env:GCP_PROJECT_ID) { $env:GCP_PROJECT_ID } else { "edmee-project" }
+$INSTANCE_NAME = if ($env:GCP_INSTANCE_NAME) { $env:GCP_INSTANCE_NAME } else { "docker-almi" }
+$ZONE = if ($env:GCP_ZONE) { $env:GCP_ZONE } else { "asia-southeast2-a" }
+$INSTANCE_USER = if ($env:GCP_INSTANCE_USER) { $env:GCP_INSTANCE_USER } else { "dhika" }
+
+Write-Host "🚀 Deploying dev-workflow MCP server to GCP..." -ForegroundColor Cyan
+Write-Host "Project: $PROJECT_ID"
+Write-Host "Instance: $INSTANCE_NAME"
+Write-Host "Zone: $ZONE"
+Write-Host ""
+
+# Check if gcloud is installed
+if (!(Get-Command gcloud -ErrorAction SilentlyContinue)) {
+    Write-Host "❌ gcloud CLI is not installed" -ForegroundColor Red
+    Write-Host "Please install it from: https://cloud.google.com/sdk/docs/install"
+    exit 1
+}
+
+# Set the project
+Write-Host "📋 Setting GCP project..." -ForegroundColor Yellow
+gcloud config set project $PROJECT_ID
+
+# Get instance external IP
+Write-Host "🔍 Getting instance external IP..." -ForegroundColor Yellow
+$EXTERNAL_IP = gcloud compute instances describe $INSTANCE_NAME `
+    --zone=$ZONE `
+    --format="get(networkInterfaces[0].accessConfigs[0].natIP)"
+
+if ([string]::IsNullOrEmpty($EXTERNAL_IP)) {
+    Write-Host "❌ Could not get instance external IP" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "✅ Instance IP: $EXTERNAL_IP" -ForegroundColor Green
+Write-Host ""
+
+# Test SSH connection
+Write-Host "🔐 Testing SSH connection..." -ForegroundColor Yellow
+try {
+    $testResult = gcloud compute ssh "$INSTANCE_USER@$INSTANCE_NAME" `
+        --zone=$ZONE `
+        --command="echo 'Connection successful'" 2>&1
+    Write-Host "✅ SSH connection successful" -ForegroundColor Green
+} catch {
+    Write-Host "❌ Cannot connect to instance via SSH" -ForegroundColor Red
+    Write-Host "Please ensure:"
+    Write-Host "  1. SSH keys are configured in GCP"
+    Write-Host "  2. Firewall allows SSH (port 22)"
+    Write-Host "  3. Instance is running"
+    exit 1
+}
+Write-Host ""
+
+# Copy files to instance
+Write-Host "📦 Copying project files to instance..." -ForegroundColor Yellow
+gcloud compute scp --recurse `
+    --zone=$ZONE `
+    . "$INSTANCE_USER@${INSTANCE_NAME}:~/dev-workflow-mcp-server/" `
+    --exclude=".git" `
+    --exclude="node_modules" `
+    --exclude=".state" `
+    --exclude="dist"
+
+Write-Host "✅ Files copied successfully" -ForegroundColor Green
+Write-Host ""
+
+# Create deployment script for remote execution
+$deployScript = @'
+set -e
+
+cd ~/dev-workflow-mcp-server
+
+echo "📥 Installing Docker if not present..."
+if ! command -v docker &> /dev/null; then
+    curl -fsSL https://get.docker.com -o get-docker.sh
+    sudo sh get-docker.sh
+    sudo usermod -aG docker $USER
+    rm get-docker.sh
+    echo "✅ Docker installed"
+else
+    echo "✅ Docker already installed"
+fi
+
+echo "📥 Installing Docker Compose if not present..."
+if ! command -v docker-compose &> /dev/null; then
+    sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+    sudo chmod +x /usr/local/bin/docker-compose
+    echo "✅ Docker Compose installed"
+else
+    echo "✅ Docker Compose already installed"
+fi
+
+echo "⚙️  Configuring environment..."
+if [ ! -f .env ]; then
+    cp .env.production .env
+    echo "⚠️  Created .env file from template"
+    echo "⚠️  Please update the passwords in .env before production use!"
+fi
+
+echo "🛑 Stopping existing containers..."
+docker-compose down 2>/dev/null || true
+
+echo "🏗️  Building Docker images..."
+docker-compose build --no-cache
+
+echo "🚀 Starting containers..."
+docker-compose up -d
+
+echo "⏳ Waiting for services to be healthy..."
+sleep 15
+
+echo "📊 Checking container status..."
+docker-compose ps
+
+echo ""
+echo "✅ Deployment complete!"
+echo ""
+echo "Container logs:"
+docker-compose logs --tail=20
+'@
+
+# Run deployment commands on the instance
+Write-Host "🚀 Running deployment on instance..." -ForegroundColor Yellow
+$deployScript | gcloud compute ssh "$INSTANCE_USER@$INSTANCE_NAME" `
+    --zone=$ZONE `
+    --command="bash -s"
+
+Write-Host ""
+Write-Host "🎉 Deployment successful!" -ForegroundColor Green
+Write-Host ""
+Write-Host "📝 Next steps:" -ForegroundColor Cyan
+Write-Host "1. SSH into instance and update .env with secure passwords:"
+Write-Host "   gcloud compute ssh $INSTANCE_USER@$INSTANCE_NAME --zone=$ZONE"
+Write-Host "   cd ~/dev-workflow-mcp-server"
+Write-Host "   nano .env"
+Write-Host ""
+Write-Host "2. Update your local MCP client config:" -ForegroundColor Cyan
+Write-Host @"
+   {
+     "mcpServers": {
+       "dev-workflow": {
+         "command": "gcloud",
+         "args": [
+           "compute", "ssh", "$INSTANCE_USER@$INSTANCE_NAME",
+           "--zone=$ZONE",
+           "--command=docker exec -i dev-workflow-mcp node /app/index.js"
+         ]
+       }
+     }
+   }
+"@
+Write-Host ""
+Write-Host "3. Test the connection:" -ForegroundColor Cyan
+Write-Host "   gcloud compute ssh $INSTANCE_USER@$INSTANCE_NAME --zone=$ZONE --command='docker exec -i dev-workflow-mcp node /app/index.js call get_workflow_status'"

package/scripts/deploy-gcloud.sh

@@ -0,0 +1,154 @@
+#!/bin/bash
+# GCP Deployment Script using gcloud CLI
+# This script deploys the dev-workflow MCP server to a GCP Compute Engine instance
+
+set -e
+
+# Configuration - Update these values
+PROJECT_ID="${GCP_PROJECT_ID:-edmee-project}"
+INSTANCE_NAME="${GCP_INSTANCE_NAME:-docker-almi}"
+ZONE="${GCP_ZONE:-asia-southeast2-a}"
+INSTANCE_USER="${GCP_INSTANCE_USER:-dhika}"
+
+echo "🚀 Deploying dev-workflow MCP server to GCP..."
+echo "Project: $PROJECT_ID"
+echo "Instance: $INSTANCE_NAME"
+echo "Zone: $ZONE"
+echo ""
+
+# Check if gcloud is installed
+if ! command -v gcloud &> /dev/null; then
+    echo "❌ gcloud CLI is not installed"
+    echo "Please install it from: https://cloud.google.com/sdk/docs/install"
+    exit 1
+fi
+
+# Set the project
+echo "📋 Setting GCP project..."
+gcloud config set project "$PROJECT_ID"
+
+# Get instance external IP
+echo "🔍 Getting instance external IP..."
+EXTERNAL_IP=$(gcloud compute instances describe "$INSTANCE_NAME" \
+    --zone="$ZONE" \
+    --format="get(networkInterfaces[0].accessConfigs[0].natIP)")
+
+if [ -z "$EXTERNAL_IP" ]; then
+    echo "❌ Could not get instance external IP"
+    exit 1
+fi
+
+echo "✅ Instance IP: $EXTERNAL_IP"
+echo ""
+
+# Test SSH connection
+echo "🔐 Testing SSH connection..."
+if ! gcloud compute ssh "$INSTANCE_USER@$INSTANCE_NAME" \
+    --zone="$ZONE" \
+    --command="echo 'Connection successful'" &> /dev/null; then
+    echo "❌ Cannot connect to instance via SSH"
+    echo "Please ensure:"
+    echo "  1. SSH keys are configured in GCP"
+    echo "  2. Firewall allows SSH (port 22)"
+    echo "  3. Instance is running"
+    exit 1
+fi
+echo "✅ SSH connection successful"
+echo ""
+
+# Copy files to instance
+echo "📦 Copying project files to instance..."
+gcloud compute scp --recurse \
+    --zone="$ZONE" \
+    . "$INSTANCE_USER@$INSTANCE_NAME:~/dev-workflow-mcp-server/" \
+    --exclude=".git" \
+    --exclude="node_modules" \
+    --exclude=".state" \
+    --exclude="dist"
+
+echo "✅ Files copied successfully"
+echo ""
+
+# Run deployment commands on the instance
+echo "🚀 Running deployment on instance..."
+gcloud compute ssh "$INSTANCE_USER@$INSTANCE_NAME" \
+    --zone="$ZONE" \
+    --command="bash -s" << 'ENDSSH'
+set -e
+
+cd ~/dev-workflow-mcp-server
+
+echo "📥 Installing Docker if not present..."
+if ! command -v docker &> /dev/null; then
+    curl -fsSL https://get.docker.com -o get-docker.sh
+    sudo sh get-docker.sh
+    sudo usermod -aG docker $USER
+    rm get-docker.sh
+    echo "✅ Docker installed"
+else
+    echo "✅ Docker already installed"
+fi
+
+echo "📥 Installing Docker Compose if not present..."
+if ! command -v docker-compose &> /dev/null; then
+    sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+    sudo chmod +x /usr/local/bin/docker-compose
+    echo "✅ Docker Compose installed"
+else
+    echo "✅ Docker Compose already installed"
+fi
+
+echo "⚙️  Configuring environment..."
+if [ ! -f .env ]; then
+    cp .env.production .env
+    echo "⚠️  Created .env file from template"
+    echo "⚠️  Please update the passwords in .env before production use!"
+fi
+
+echo "🛑 Stopping existing containers..."
+docker-compose down 2>/dev/null || true
+
+echo "🏗️  Building Docker images..."
+docker-compose build --no-cache
+
+echo "🚀 Starting containers..."
+docker-compose up -d
+
+echo "⏳ Waiting for services to be healthy..."
+sleep 15
+
+echo "📊 Checking container status..."
+docker-compose ps
+
+echo ""
+echo "✅ Deployment complete!"
+echo ""
+echo "Container logs:"
+docker-compose logs --tail=20
+ENDSSH
+
+echo ""
+echo "🎉 Deployment successful!"
+echo ""
+echo "📝 Next steps:"
+echo "1. SSH into instance and update .env with secure passwords:"
+echo "   gcloud compute ssh $INSTANCE_USER@$INSTANCE_NAME --zone=$ZONE"
+echo "   cd ~/dev-workflow-mcp-server"
+echo "   nano .env"
+echo ""
+echo "2. Update your local MCP client config:"
+echo "   {"
+echo "     \"mcpServers\": {"
+echo "       \"dev-workflow\": {"
+echo "         \"command\": \"gcloud\","
+echo "         \"args\": ["
+echo "           \"compute\", \"ssh\", \"$INSTANCE_USER@$INSTANCE_NAME\","
+echo "           \"--zone=$ZONE\","
+echo "           \"--command=docker exec -i dev-workflow-mcp node /app/index.js\""
+echo "         ]"
+echo "       }"
+echo "     }"
+echo "   }"
+echo ""
+echo "3. Test the connection:"
+echo "   gcloud compute ssh $INSTANCE_USER@$INSTANCE_NAME --zone=$ZONE --command='docker exec -i dev-workflow-mcp node /app/index.js call get_workflow_status'"

package/scripts/health-check.js

@@ -0,0 +1,50 @@
+
+import pg from 'pg';
+const { Client } = pg;
+import path from 'path';
+import fs from 'fs';
+import dotenv from 'dotenv';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Load env from root
+const envPath = path.resolve(__dirname, '../.env');
+if (fs.existsSync(envPath)) {
+    dotenv.config({ path: envPath });
+}
+
+async function healthCheck() {
+    console.log('--- Database Health Check ---');
+
+    if (!process.env.DEV_WORKFLOW_DB_URL) {
+        console.error('❌ DEV_WORKFLOW_DB_URL is missing!');
+        process.exit(1);
+    }
+
+    const client = new Client({
+        connectionString: process.env.DEV_WORKFLOW_DB_URL,
+    });
+
+    try {
+        await client.connect();
+        console.log('✅ Connectivity: OK');
+
+        // Simple query to verify schema access
+        const res = await client.query('SELECT count(*) as count FROM workflow_history');
+        console.log(`✅ Schema Access: OK (Found ${res.rows[0].count} history entries)`);
+
+        // Check users table
+        const users = await client.query('SELECT count(*) as count FROM users');
+        console.log(`✅ Auth Table: OK (Found ${users.rows[0].count} users)`);
+
+    } catch (err) {
+        console.error('❌ Health Check Failed:', err.message);
+        process.exit(1);
+    } finally {
+        await client.end();
+    }
+}
+
+healthCheck();

package/scripts/test-history.js

@@ -0,0 +1,56 @@
+
+import { exec } from 'child_process';
+import path from 'path';
+import util from 'util';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const execPromise = util.promisify(exec);
+
+async function testHistoryScript() {
+    console.log('--- Testing db-query-history.js execution ---');
+
+    // Simulate what route.ts does:
+    // 1. Path to script
+    // 2. Env vars
+    // 3. Child process exec
+
+    const scriptPath = path.join(__dirname, '../web/scripts/db-query-history.js');
+    console.log('Script Path:', scriptPath);
+
+    // Simulate "programinglive" session if possible, or empty string (fallback to admin)
+    // We don't have a valid session ID handy without login, so let's pass empty, which triggers the fallback logic (find admin/any user)
+    const sid = '';
+
+    try {
+        const { stdout, stderr } = await execPromise(`node "${scriptPath}" "${sid}"`, {
+            env: { ...process.env, DEV_WORKFLOW_DB_URL: process.env.DEV_WORKFLOW_DB_URL }
+        });
+
+        console.log('STDOUT:', stdout);
+        if (stderr) console.error('STDERR:', stderr);
+
+        try {
+            const data = JSON.parse(stdout);
+            console.log('✅ Success! Parsed JSON:', data);
+            if (data.history && data.history.length === 0) {
+                console.warn('⚠️  History is empty (check user_id linkage)');
+            }
+        } catch (e) {
+            console.error('❌ Failed to parse JSON:', e.message);
+        }
+
+    } catch (err) {
+        console.error('❌ Execution Failed:', err.message);
+        console.error('STDOUT:', err.stdout);
+        console.error('STDERR:', err.stderr);
+    }
+}
+
+// We need to load .env for this test script itself to run?
+// Actually the exec inherits process.env.
+// But we are running THIS script with node, so we need dotenv here if relying on process.env passing through.
+import 'dotenv/config'; // simplistic load
+
+testHistoryScript();

package/web/__tests__/api/workflow-history.test.js

@@ -0,0 +1,61 @@
+const request = require('supertest');
+const express = require('express');
+
+describe('Workflow History API', () => {
+    let app;
+    let server;
+
+    beforeAll(() => {
+        // Mock Express app for testing
+        app = express();
+        app.use(express.json());
+
+        // Mock session middleware
+        app.use((req, res, next) => {
+            req.session = { userId: 1 };
+            next();
+        });
+
+        // Mock history endpoint
+        app.get('/api/workflow/history', async (req, res) => {
+            // Mock response
+            res.json({
+                history: [
+                    {
+                        id: 1,
+                        task_type: 'feature',
+                        description: 'Test feature',
+                        commit_message: 'feat: test commit',
+                        completed_at: new Date().toISOString(),
+                        tests_passed: true,
+                        documentation_type: 'README'
+                    }
+                ]
+            });
+        });
+    });
+
+    test('GET /api/workflow/history returns workflow history', async () => {
+        const response = await request(app)
+            .get('/api/workflow/history')
+            .expect(200);
+
+        expect(response.body).toHaveProperty('history');
+        expect(Array.isArray(response.body.history)).toBe(true);
+        expect(response.body.history.length).toBeGreaterThan(0);
+    });
+
+    test('History items have required fields', async () => {
+        const response = await request(app)
+            .get('/api/workflow/history')
+            .expect(200);
+
+        const item = response.body.history[0];
+        expect(item).toHaveProperty('id');
+        expect(item).toHaveProperty('task_type');
+        expect(item).toHaveProperty('description');
+        expect(item).toHaveProperty('commit_message');
+        expect(item).toHaveProperty('completed_at');
+        expect(item).toHaveProperty('tests_passed');
+    });
+});

package/web/app/api/history-fallback/route.ts

@@ -0,0 +1,56 @@
+import { NextResponse } from 'next/server';
+import { cookies } from 'next/headers';
+import { exec } from 'child_process';
+import path from 'path';
+import util from 'util';
+
+const execPromise = util.promisify(exec);
+
+export const dynamic = 'force-dynamic';
+
+export async function GET(request: Request) {
+    try {
+        const cookieStore = await cookies();
+        const sidCookie = cookieStore.get('connect.sid');
+
+        // Pass SID (even if undefined, script has fallback)
+        const sid = sidCookie ? sidCookie.value : '';
+
+        const scriptPath = path.join(process.cwd(), 'scripts', 'db-query-history.js');
+        const env = { ...process.env };
+
+        // Execute node script, passing SID as argument
+        const { stdout, stderr } = await execPromise(`node "${scriptPath}" "${sid}"`, { env });
+
+        try {
+            // Find start of JSON by looking for specific signature
+            const jsonStart = stdout.indexOf('{"history":');
+            const jsonEnd = stdout.lastIndexOf('}');
+
+            if (jsonStart === -1 || jsonEnd === -1) {
+                throw new Error('No valid history JSON found in output');
+            }
+
+            const jsonStr = stdout.substring(jsonStart, jsonEnd + 1);
+            const data = JSON.parse(jsonStr);
+
+            if (data.error) {
+                console.error('History Script Error:', data.error);
+                return NextResponse.json(data, { status: 500 });
+            }
+            return NextResponse.json(data);
+        } catch (e: any) {
+            console.error('History API Parse Error:', e.message);
+            console.error('STDOUT:', stdout);
+            console.error('STDERR:', stderr);
+            return NextResponse.json({
+                error: 'Failed to parse script output',
+                details: e.message,
+                stdoutSnippet: stdout.slice(0, 200)
+            }, { status: 500 });
+        }
+
+    } catch (error: any) {
+        return NextResponse.json({ error: error.message }, { status: 500 });
+    }
+}

package/web/app/docs/page.tsx

@@ -22,7 +22,7 @@ export default function DocsPage() {
                     </p>
 
                     <div className="bg-emerald-50 dark:bg-emerald-500/10 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-8">
-                        <p className="text-emerald-700 dark:text-emerald-400 font-semibold">Version: 1.6.2</p>
+                        <p className="text-emerald-700 dark:text-emerald-400 font-semibold">Version: 1.7.11</p>
                     </div>
 
                     <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Features</h2>