@programinglive/dev-workflow-mcp-server 1.8.1 → 1.10.0

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

@@ -1,63 +0,0 @@
-import { test, describe } from 'node:test';
-import assert from 'node:assert';
-import request from 'supertest';
-import express from 'express';
-
-describe('Workflow History API', () => {
-    let app;
-    let server;
-
-    test('setup app', () => {
-        // 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);
-
-        assert(response.body.history, 'History property should exist');
-        assert(Array.isArray(response.body.history), 'History should be an array');
-        assert(response.body.history.length > 0, 'History should not be empty');
-    });
-
-    test('History items have required fields', async () => {
-        const response = await request(app)
-            .get('/api/workflow/history')
-            .expect(200);
-
-        const item = response.body.history[0];
-        assert(item.id, 'Item should have id');
-        assert(item.task_type, 'Item should have task_type');
-        assert(item.description, 'Item should have description');
-        assert(item.commit_message, 'Item should have commit_message');
-        assert(item.completed_at, 'Item should have completed_at');
-        assert(item.tests_passed !== undefined, 'Item should have tests_passed');
-    });
-});

package/web/api-server.js

@@ -1,211 +0,0 @@
-import express from 'express';
-import cors from 'cors';
-import pg from 'pg';
-import dotenv from 'dotenv';
-import bcrypt from 'bcrypt';
-import jwt from 'jsonwebtoken';
-
-dotenv.config({ path: '../.env' });
-
-const app = express();
-const { Pool } = pg;
-
-const PORT = process.env.API_PORT || 8080;
-const dbUrl = process.env.DEV_WORKFLOW_DB_URL;
-const JWT_SECRET = process.env.JWT_SECRET || 'dev-workflow-jwt-secret-change-me';
-
-if (!dbUrl) {
-    console.error('❌ DEV_WORKFLOW_DB_URL is not set');
-    process.exit(1);
-}
-
-const pool = new Pool({ connectionString: dbUrl });
-
-// Authentication helper functions
-async function authenticateUser(pool, username, password) {
-    const result = await pool.query(
-        'SELECT * FROM users WHERE username = $1',
-        [username]
-    );
-
-    if (result.rows.length === 0) {
-        return null;
-    }
-
-    const user = result.rows[0];
-    const isValid = await bcrypt.compare(password, user.password_hash);
-
-    if (!isValid) {
-        return null;
-    }
-
-    return {
-        id: user.id,
-        username: user.username,
-        email: user.email,
-    };
-}
-
-async function getUserById(pool, userId) {
-    const result = await pool.query(
-        'SELECT id, username, email FROM users WHERE id = $1',
-        [userId]
-    );
-
-    return result.rows[0] || null;
-}
-
-// CORS configuration - allow Netlify domain
-const corsOptions = {
-    origin: [
-        'https://devworkflow.programinglive.com',
-        'http://localhost:3000',
-    ],
-    credentials: true,
-    methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
-    allowedHeaders: ['Content-Type', 'Authorization'],
-};
-
-app.use(cors(corsOptions));
-app.use(express.json());
-app.use(express.urlencoded({ extended: true }));
-app.set('trust proxy', 1);
-
-// Middleware to verify JWT
-const requireAuth = (req, res, next) => {
-    const authHeader = req.headers.authorization;
-
-    if (authHeader && authHeader.startsWith('Bearer ')) {
-        const token = authHeader.split(' ')[1];
-        try {
-            const decoded = jwt.verify(token, JWT_SECRET);
-            req.user = decoded;
-            return next();
-        } catch (err) {
-            return res.status(401).json({ error: 'Invalid token' });
-        }
-    }
-
-    return res.status(401).json({ error: 'Authentication required' });
-};
-
-// Health check endpoint
-app.get('/api/health', (req, res) => {
-    res.json({ status: 'ok', timestamp: new Date().toISOString() });
-});
-
-// Authentication endpoints
-app.post('/api/auth/login', async (req, res) => {
-    try {
-        const { username, password } = req.body;
-
-        if (!username || !password) {
-            return res.status(400).json({ error: 'Username and password are required' });
-        }
-
-        const user = await authenticateUser(pool, username, password);
-
-        if (!user) {
-            return res.status(401).json({ error: 'Invalid credentials' });
-        }
-
-        // Generate JWT Token
-        const token = jwt.sign(
-            { userId: user.id, username: user.username },
-            JWT_SECRET,
-            { expiresIn: '30d' }
-        );
-
-        res.json({
-            success: true,
-            token,
-            user: {
-                id: user.id,
-                username: user.username,
-                email: user.email,
-            },
-        });
-    } catch (error) {
-        console.error('Login error:', error);
-        res.status(500).json({ error: 'Internal server error' });
-    }
-});
-
-app.post('/api/auth/logout', (req, res) => {
-    // Client-side only action for JWT
-    res.json({ success: true });
-});
-
-app.get('/api/auth/me', requireAuth, async (req, res) => {
-    try {
-        const user = await getUserById(pool, req.user.userId);
-
-        if (!user) {
-            return res.status(404).json({ error: 'User not found' });
-        }
-
-        res.json({
-            id: user.id,
-            username: user.username,
-            email: user.email,
-        });
-    } catch (error) {
-        console.error('Get user error:', error);
-        res.status(500).json({ error: 'Internal server error' });
-    }
-});
-
-// Workflow history endpoints
-app.get('/api/history', requireAuth, async (req, res) => {
-    try {
-        const result = await pool.query(
-            `SELECT id, task_type, description, commit_message, completed_at, tests_passed, documentation_type
-             FROM workflow_history
-             WHERE user_id = $1
-             ORDER BY completed_at DESC
-             LIMIT 100`,
-            [req.user.userId]
-        );
-
-        res.json({
-            history: result.rows,
-        });
-    } catch (error) {
-        console.error('Get history error:', error);
-        res.status(500).json({ error: 'Failed to fetch history' });
-    }
-});
-
-app.post('/api/history', requireAuth, async (req, res) => {
-    try {
-        const { task_type, description, commit_message, tests_passed, documentation_type } = req.body;
-
-        const result = await pool.query(
-            `INSERT INTO workflow_history (user_id, task_type, description, commit_message, tests_passed, documentation_type, completed_at)
-             VALUES ($1, $2, $3, $4, $5, $6, NOW())
-             RETURNING *`,
-            [req.user.userId, task_type, description, commit_message, tests_passed, documentation_type]
-        );
-
-        res.json({
-            success: true,
-            history: result.rows[0],
-        });
-    } catch (error) {
-        console.error('Create history error:', error);
-        res.status(500).json({ error: 'Failed to create history entry' });
-    }
-});
-
-// Error handling middleware
-app.use((err, req, res, next) => {
-    console.error('Unhandled error:', err);
-    res.status(500).json({ error: 'Internal server error' });
-});
-
-// Start server
-app.listen(PORT, '0.0.0.0', () => {
-    console.log(`✅ API server running on port ${PORT}`);
-    console.log(`📊 Database: ${dbUrl.replace(/:[^:]*@/, ':****@')}`);
-    console.log(`🌐 CORS enabled for: ${corsOptions.origin.join(', ')}`);
-});

package/web/app/docs/page.tsx

@@ -1,202 +0,0 @@
-import Link from "next/link";
-import { ArrowLeft, CheckCircle, GitBranch, FileText, TestTube, Rocket } from "lucide-react";
-
-export default function DocsPage() {
-    return (
-        <div className="min-h-screen bg-white dark:bg-[#0a0a0f] text-gray-900 dark:text-white pt-20 px-4 pb-12 transition-colors duration-300">
-            <div className="max-w-4xl mx-auto">
-                <div className="mb-8">
-                    <Link href="/" className="inline-flex items-center gap-2 text-indigo-600 dark:text-indigo-400 hover:text-indigo-700 dark:hover:text-indigo-300 transition">
-                        <ArrowLeft className="w-4 h-4" />
-                        Back to Dashboard
-                    </Link>
-                </div>
-
-                <div className="prose dark:prose-invert max-w-none">
-                    <h1 className="text-5xl font-bold mb-4 bg-gradient-to-r from-indigo-600 dark:from-indigo-400 via-purple-600 dark:via-purple-400 to-pink-600 dark:to-pink-400 bg-clip-text text-transparent">
-                        Dev Workflow MCP Server
-                    </h1>
-                    <p className="text-xl text-gray-600 dark:text-gray-400 mb-8">
-                        An MCP server that acts as your coding conscience. Enforce test-driven development, ensure documentation,
-                        and never skip a step in your release process.
-                    </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.7.15</p>
-                    </div>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Features</h2>
-                    <div className="grid md:grid-cols-2 gap-4 mb-8">
-                        <div className="p-4 rounded-lg bg-gray-50 dark:bg-white/5 border border-gray-200 dark:border-white/10">
-                            <div className="flex items-center gap-3 mb-2">
-                                <CheckCircle className="w-5 h-5 text-indigo-600 dark:text-indigo-400" />
-                                <h3 className="text-lg font-semibold text-gray-900 dark:text-white">Enforced Discipline</h3>
-                            </div>
-                            <p className="text-gray-600 dark:text-gray-400 text-sm">Won't let you skip important steps. Follows a strict, proven development workflow.</p>
-                        </div>
-                        <div className="p-4 rounded-lg bg-gray-50 dark:bg-white/5 border border-gray-200 dark:border-white/10">
-                            <div className="flex items-center gap-3 mb-2">
-                                <TestTube className="w-5 h-5 text-purple-600 dark:text-purple-400" />
-                                <h3 className="text-lg font-semibold text-gray-900 dark:text-white">Test-Driven</h3>
-                            </div>
-                            <p className="text-gray-600 dark:text-gray-400 text-sm">Blocks commits if tests fail. Encourages writing tests before marking tasks complete.</p>
-                        </div>
-                        <div className="p-4 rounded-lg bg-gray-50 dark:bg-white/5 border border-gray-200 dark:border-white/10">
-                            <div className="flex items-center gap-3 mb-2">
-                                <FileText className="w-5 h-5 text-emerald-600 dark:text-emerald-400" />
-                                <h3 className="text-lg font-semibold text-gray-900 dark:text-white">Documentation</h3>
-                            </div>
-                            <p className="text-gray-600 dark:text-gray-400 text-sm">Reminds you to update documentation (README, docs, changelog) for every change.</p>
-                        </div>
-                        <div className="p-4 rounded-lg bg-gray-50 dark:bg-white/5 border border-gray-200 dark:border-white/10">
-                            <div className="flex items-center gap-3 mb-2">
-                                <GitBranch className="w-5 h-5 text-orange-600 dark:text-orange-400" />
-                                <h3 className="text-lg font-semibold text-gray-900 dark:text-white">State Tracking</h3>
-                            </div>
-                            <p className="text-gray-600 dark:text-gray-400 text-sm">Remembers exactly where you are in the workflow, even across sessions.</p>
-                        </div>
-                    </div>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Installation</h2>
-                    <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-6 border border-gray-300 dark:border-white/10 mb-8">
-                        <pre className="text-sm overflow-x-auto">
-                            <code className="text-gray-700 dark:text-gray-300">npm install -g @programinglive/dev-workflow-mcp-server</code>
-                        </pre>
-                    </div>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Quick Start</h2>
-                    <ol className="space-y-4 mb-8">
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-indigo-100 dark:bg-indigo-500/20 flex items-center justify-center text-indigo-600 dark:text-indigo-400 font-bold">1</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Start a Task</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Begin your coding session by defining what you're working on.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">start_task</code>
-                                </div>
-                            </div>
-                        </li>
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-purple-100 dark:bg-purple-500/20 flex items-center justify-center text-purple-600 dark:text-purple-400 font-bold">2</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Mark Bug Fixed</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Once you've implemented your feature or fix, mark it as complete.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">mark_bug_fixed</code>
-                                </div>
-                            </div>
-                        </li>
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-emerald-100 dark:bg-emerald-500/20 flex items-center justify-center text-emerald-600 dark:text-emerald-400 font-bold">3</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Create Tests</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Write tests to verify your changes work correctly.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">create_tests</code>
-                                </div>
-                            </div>
-                        </li>
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-orange-100 dark:bg-orange-500/20 flex items-center justify-center text-orange-600 dark:text-orange-400 font-bold">4</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Run Tests</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Execute your test suite and ensure everything passes.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">run_tests</code>
-                                </div>
-                            </div>
-                        </li>
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-pink-100 dark:bg-pink-500/20 flex items-center justify-center text-pink-600 dark:text-pink-400 font-bold">5</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Create Documentation</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Update relevant documentation for your changes.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">create_documentation</code>
-                                </div>
-                            </div>
-                        </li>
-                        <li className="flex gap-4">
-                            <span className="flex-shrink-0 w-8 h-8 rounded-full bg-blue-100 dark:bg-blue-500/20 flex items-center justify-center text-blue-600 dark:text-blue-400 font-bold">6</span>
-                            <div>
-                                <h3 className="font-semibold mb-1 text-gray-900 dark:text-white">Commit and Push</h3>
-                                <p className="text-gray-600 dark:text-gray-400">Commit your changes and push to the repository.</p>
-                                <div className="bg-gray-100 dark:bg-[#1a1a24] rounded-lg p-3 mt-2 border border-gray-300 dark:border-white/10">
-                                    <code className="text-sm text-gray-700 dark:text-gray-300">commit_and_push</code>
-                                </div>
-                            </div>
-                        </li>
-                    </ol>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Available Commands</h2>
-                    <div className="space-y-3 mb-8">
-                        {[
-                            { cmd: "start_task", desc: "Begin a new coding task" },
-                            { cmd: "mark_bug_fixed", desc: "Mark feature/bugfix as complete" },
-                            { cmd: "create_tests", desc: "Record that tests have been created" },
-                            { cmd: "run_tests", desc: "Execute and record test results" },
-                            { cmd: "skip_tests", desc: "Skip tests with justification" },
-                            { cmd: "create_documentation", desc: "Record documentation updates" },
-                            { cmd: "commit_and_push", desc: "Commit and push changes" },
-                            { cmd: "perform_release", desc: "Execute release process" },
-                            { cmd: "complete_task", desc: "Mark task as complete" },
-                            { cmd: "get_workflow_status", desc: "Check current workflow state" },
-                            { cmd: "view_history", desc: "View completed tasks" },
-                        ].map((item) => (
-                            <div key={item.cmd} className="p-4 rounded-lg bg-gray-50 dark:bg-white/5 border border-gray-200 dark:border-white/10 hover:bg-gray-100 dark:hover:bg-white/10 transition">
-                                <code className="text-indigo-600 dark:text-indigo-400 font-mono">{item.cmd}</code>
-                                <p className="text-gray-600 dark:text-gray-400 text-sm mt-1">{item.desc}</p>
-                            </div>
-                        ))}
-                    </div>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Configuration</h2>
-                    <p className="text-gray-600 dark:text-gray-400 mb-4">
-                        The server stores workflow state in a SQLite database located at <code className="text-indigo-600 dark:text-indigo-400 bg-gray-100 dark:bg-white/5 px-2 py-1 rounded">.state/dev-workflow.db</code>
-                    </p>
-                    <p className="text-gray-600 dark:text-gray-400 mb-8">
-                        Set the <code className="text-indigo-600 dark:text-indigo-400 bg-gray-100 dark:bg-white/5 px-2 py-1 rounded">DEV_WORKFLOW_USER_ID</code> environment variable to isolate workflow state per user.
-                    </p>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">Requirements</h2>
-                    <ul className="space-y-2 mb-8">
-                        <li className="flex items-center gap-2 text-gray-600 dark:text-gray-400">
-                            <CheckCircle className="w-4 h-4 text-emerald-600 dark:text-emerald-400" />
-                            Node.js 18 or higher
-                        </li>
-                        <li className="flex items-center gap-2 text-gray-600 dark:text-gray-400">
-                            <CheckCircle className="w-4 h-4 text-emerald-600 dark:text-emerald-400" />
-                            Git installed and configured
-                        </li>
-                        <li className="flex items-center gap-2 text-gray-600 dark:text-gray-400">
-                            <CheckCircle className="w-4 h-4 text-emerald-600 dark:text-emerald-400" />
-                            MCP-compatible AI assistant (e.g., Claude Desktop)
-                        </li>
-                    </ul>
-
-                    <h2 className="text-3xl font-bold mt-12 mb-6 text-gray-900 dark:text-white">License</h2>
-                    <p className="text-gray-600 dark:text-gray-400 mb-8">
-                        MIT License - Free to use for personal and commercial projects.
-                    </p>
-
-                    <div className="bg-gradient-to-r from-indigo-50 dark:from-indigo-500/10 via-purple-50 dark:via-purple-500/10 to-pink-50 dark:to-pink-500/10 border border-gray-300 dark:border-white/10 rounded-lg p-6 mt-12">
-                        <div className="flex items-center gap-3 mb-3">
-                            <Rocket className="w-6 h-6 text-pink-600 dark:text-pink-400" />
-                            <h3 className="text-xl font-bold text-gray-900 dark:text-white">Ready to get started?</h3>
-                        </div>
-                        <p className="text-gray-600 dark:text-gray-400 mb-4">
-                            Install the MCP server and start enforcing best practices in your development workflow today!
-                        </p>
-                        <Link
-                            href="https://github.com/programinglive/dev-workflow-mcp-server"
-                            target="_blank"
-                            className="inline-flex items-center gap-2 px-6 py-3 bg-gradient-to-r from-indigo-600 to-purple-600 dark:from-indigo-600 dark:to-purple-600 rounded-lg font-semibold text-white hover:shadow-lg hover:shadow-indigo-500/50 transition"
-                        >
-                            View on GitHub
-                        </Link>
-                    </div>
-                </div>
-            </div>
-        </div>
-    );
-}

package/web/app/globals.css

@@ -1,91 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-:root {
-  --background: #0a0a0f;
-  --foreground: #ffffff;
-}
-
-body {
-  color: var(--foreground);
-  background: var(--background);
-  font-family: Arial, Helvetica, sans-serif;
-}
-
-@layer utilities {
-  @keyframes fadeInUp {
-    0% {
-      opacity: 0;
-      transform: translateY(20px);
-    }
-
-    100% {
-      opacity: 1;
-      transform: translateY(0px);
-    }
-  }
-
-  @keyframes fadeInRight {
-    0% {
-      opacity: 0;
-      transform: translateY(-50%) translateX(40px);
-    }
-
-    100% {
-      opacity: 1;
-      transform: translateY(-50%) translateX(0px);
-    }
-  }
-
-  @keyframes fadeIn {
-    0% {
-      opacity: 0;
-      transform: translateX(-10px);
-    }
-
-    100% {
-      opacity: 1;
-      transform: translateX(0px);
-    }
-  }
-
-  .animate-fade-in-up {
-    animation: fadeInUp 0.8s ease-out forwards;
-    opacity: 0;
-  }
-
-  .animate-fade-in-right {
-    animation: fadeInRight 0.8s ease-out forwards;
-    opacity: 0;
-  }
-
-  .terminal-line {
-    opacity: 0;
-    display: flex;
-  }
-
-  .terminal-line.visible {
-    opacity: 1;
-    transition: opacity 0.1s;
-  }
-
-  .typing-cursor::after {
-    content: '▋';
-    animation: blink 1s step-end infinite;
-    margin-left: 4px;
-    color: #a855f7;
-  }
-
-  @keyframes blink {
-
-    0%,
-    100% {
-      opacity: 1;
-    }
-
-    50% {
-      opacity: 0;
-    }
-  }
-}