@piecemaker-legal/piecemaker 1.0.0

package/server/modules/taskmaster/taskmaster.routes.ts

@@ -0,0 +1,1472 @@
+// @ts-nocheck -- temporary while Taskmaster workflows are extracted into the injected service.
+/**
+ * TASKMASTER API ROUTES
+ * ====================
+ *
+ * This module provides API endpoints for TaskMaster integration including:
+ * - .taskmaster folder detection in project directories
+ * - MCP server configuration detection
+ * - TaskMaster state and metadata management
+ */
+
+import path from 'path';
+
+import express from 'express';
+
+import { WS_OPEN_STATE, connectedClients } from '@/modules/websocket/index.js';
+
+import type { createTaskmasterService } from './taskmaster.service.js';
+// cross-spawn: drop-in spawn with Windows .cmd/PATHEXT resolution — required
+// here since task-master/npx are .cmd shims on Windows.
+
+type TaskmasterRouterDependencies = {
+    fileSystem: typeof import('node:fs');
+    fileSystemPromises: typeof import('node:fs/promises');
+    spawnProcess: typeof import('cross-spawn').default;
+    resolveProjectPathById(projectId: string): string | null;
+    taskmasterService: ReturnType<typeof createTaskmasterService>;
+};
+
+/**
+ * These frames are `type`-keyed and only TaskMasterContext, which lives on the
+ * `/ws` chat socket, knows what to do with them. Broadcasting over the raw
+ * `wss.clients` set instead delivered them to every `/shell`, `/plugin-ws` and
+ * `/desktop-notifications` socket as well, where they were parsed and dropped —
+ * and, on `/plugin-ws`, handed to third-party plugin frontends that have no
+ * business seeing them. `connectedClients` is the `/ws`-only set every other
+ * broadcast in the server already uses.
+ */
+function broadcastTaskMasterUpdate(type, projectId, payloadKey, payload) {
+    if (!projectId) return;
+    const message = JSON.stringify({
+        type,
+        projectId,
+        ...(payload === undefined ? {} : { [payloadKey]: payload }),
+        timestamp: new Date().toISOString(),
+    });
+    connectedClients.forEach((client) => {
+        if (client.readyState === WS_OPEN_STATE) client.send(message);
+    });
+}
+
+function broadcastTaskMasterProjectUpdate(projectId, taskMasterData) {
+    broadcastTaskMasterUpdate(
+        'taskmaster-project-updated',
+        projectId,
+        'taskMasterData',
+        taskMasterData,
+    );
+}
+
+function broadcastTaskMasterTasksUpdate(projectId, tasksData) {
+    broadcastTaskMasterUpdate('taskmaster-tasks-updated', projectId, 'tasksData', tasksData);
+}
+
+/**
+ * Resolve the absolute project directory from a DB-assigned `projectId`.
+ *
+ * TaskMaster routes used to accept a Claude-encoded folder name (`projectName`)
+ * and derive the path from JSONL history. After the projectId migration the
+ * only identifier we accept is the primary key of the `projects` table, so
+ * every handler calls this helper and 404s when the id is unknown.
+ */
+/** Creates Taskmaster routes around explicit filesystem, process, MCP, and project adapters. */
+export function createTaskmasterRouter(dependencies: TaskmasterRouterDependencies): express.Router {
+    const fs = dependencies.fileSystem;
+    const fsPromises = dependencies.fileSystemPromises;
+    const spawn = dependencies.spawnProcess;
+    const taskmasterService = dependencies.taskmasterService;
+    const resolveProjectPathFromId = async (projectId) => projectId
+        ? dependencies.resolveProjectPathById(projectId)
+        : null;
+    const router = express.Router();
+
+    function runTaskmasterProcess(command, args, options, onComplete) {
+        const child = spawn(command, args, options);
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+
+        const settle = (code, error = null) => {
+            if (settled) return;
+            settled = true;
+            onComplete({ code, error, stdout, stderr });
+        };
+
+        child.once('error', (error) => settle(null, error));
+        child.once('close', (code) => settle(code));
+        return child;
+    }
+
+    /**
+     * Check if TaskMaster CLI is installed globally
+     * @returns {Promise<Object>} Installation status result
+     */
+    async function checkTaskMasterInstallation() {
+        return new Promise((resolve) => {
+            // Check if task-master command is available
+            const child = spawn('which', ['task-master'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                shell: true
+            });
+
+            let output = '';
+            let errorOutput = '';
+
+            child.stdout.on('data', (data) => {
+                output += data.toString();
+            });
+
+            child.stderr.on('data', (data) => {
+                errorOutput += data.toString();
+            });
+
+            child.on('close', (code) => {
+                if (code === 0 && output.trim()) {
+                    // TaskMaster is installed, get version
+                    const versionChild = spawn('task-master', ['--version'], {
+                        stdio: ['ignore', 'pipe', 'pipe'],
+                        shell: true
+                    });
+
+                    let versionOutput = '';
+
+                    versionChild.stdout.on('data', (data) => {
+                        versionOutput += data.toString();
+                    });
+
+                    versionChild.on('close', (versionCode) => {
+                        resolve({
+                            isInstalled: true,
+                            installPath: output.trim(),
+                            version: versionCode === 0 ? versionOutput.trim() : 'unknown',
+                            reason: null
+                        });
+                    });
+
+                    versionChild.on('error', () => {
+                        resolve({
+                            isInstalled: true,
+                            installPath: output.trim(),
+                            version: 'unknown',
+                            reason: null
+                        });
+                    });
+                } else {
+                    resolve({
+                        isInstalled: false,
+                        installPath: null,
+                        version: null,
+                        reason: 'TaskMaster CLI not found in PATH'
+                    });
+                }
+            });
+
+            child.on('error', (error) => {
+                resolve({
+                    isInstalled: false,
+                    installPath: null,
+                    version: null,
+                    reason: `Error checking installation: ${error.message}`
+                });
+            });
+        });
+    }
+
+    // API Routes
+
+    /**
+     * GET /api/taskmaster/installation-status
+     * Check if TaskMaster CLI is installed on the system
+     */
+    router.get('/installation-status', async (req, res) => {
+        try {
+            const installationStatus = await checkTaskMasterInstallation();
+
+            // Also check for MCP server configuration
+            const mcpStatus = await taskmasterService.detectMcpServer();
+
+            res.json({
+                success: true,
+                installation: installationStatus,
+                mcpServer: mcpStatus,
+                isReady: installationStatus.isInstalled && mcpStatus.hasMCPServer
+            });
+        } catch (error) {
+            console.error('Error checking TaskMaster installation:', error);
+            res.status(500).json({
+                success: false,
+                error: 'Failed to check TaskMaster installation status',
+                installation: {
+                    isInstalled: false,
+                    reason: `Server error: ${error.message}`
+                },
+                mcpServer: {
+                    hasMCPServer: false,
+                    reason: `Server error: ${error.message}`
+                },
+                isReady: false
+            });
+        }
+    });
+
+    /**
+     * GET /api/taskmaster/mcp-status
+     * Check whether TaskMaster is configured in the user's Claude MCP settings.
+     */
+    router.get('/mcp-status', async (_req, res) => {
+        try {
+            res.json(await taskmasterService.detectMcpServer());
+        } catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.error('TaskMaster MCP detection error:', error);
+            res.status(500).json({
+                error: 'Failed to detect TaskMaster MCP server',
+                message
+            });
+        }
+    });
+
+    /**
+     * GET /api/taskmaster/tasks/:projectId
+     * Load actual tasks from .taskmaster/tasks/tasks.json
+     *
+     * `projectId` is the DB primary key of the project; the folder is resolved via
+     * the projects table rather than extracted from Claude JSONL history.
+     */
+    router.get('/tasks/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+
+            // Get project path via the DB; the legacy JSONL-based resolver is gone.
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            const taskMasterPath = path.join(projectPath, '.taskmaster');
+            const tasksFilePath = path.join(taskMasterPath, 'tasks', 'tasks.json');
+
+            // Check if tasks file exists
+            try {
+                await fsPromises.access(tasksFilePath);
+            } catch (error) {
+                return res.json({
+                    projectId,
+                    tasks: [],
+                    message: 'No tasks.json file found'
+                });
+            }
+
+            // Read and parse tasks file
+            try {
+                const tasksContent = await fsPromises.readFile(tasksFilePath, 'utf8');
+                const tasksData = JSON.parse(tasksContent);
+
+                let tasks = [];
+                let currentTag = 'master';
+
+                // Handle both tagged and legacy formats
+                if (Array.isArray(tasksData)) {
+                    // Legacy format
+                    tasks = tasksData;
+                } else if (tasksData.tasks) {
+                    // Simple format with tasks array
+                    tasks = tasksData.tasks;
+                } else {
+                    // Tagged format - get tasks from current tag or master
+                    if (tasksData[currentTag] && tasksData[currentTag].tasks) {
+                        tasks = tasksData[currentTag].tasks;
+                    } else if (tasksData.master && tasksData.master.tasks) {
+                        tasks = tasksData.master.tasks;
+                    } else {
+                        // Get tasks from first available tag
+                        const firstTag = Object.keys(tasksData).find(key =>
+                            tasksData[key].tasks && Array.isArray(tasksData[key].tasks)
+                        );
+                        if (firstTag) {
+                            tasks = tasksData[firstTag].tasks;
+                            currentTag = firstTag;
+                        }
+                    }
+                }
+
+                // Transform tasks to ensure all have required fields
+                const transformedTasks = tasks.map(task => ({
+                    id: task.id,
+                    title: task.title || 'Untitled Task',
+                    description: task.description || '',
+                    status: task.status || 'pending',
+                    priority: task.priority || 'medium',
+                    dependencies: task.dependencies || [],
+                    createdAt: task.createdAt || task.created || new Date().toISOString(),
+                    updatedAt: task.updatedAt || task.updated || new Date().toISOString(),
+                    details: task.details || '',
+                    testStrategy: task.testStrategy || task.test_strategy || '',
+                    subtasks: task.subtasks || []
+                }));
+
+                res.json({
+                    projectId,
+                    projectPath,
+                    tasks: transformedTasks,
+                    currentTag,
+                    totalTasks: transformedTasks.length,
+                    tasksByStatus: {
+                        pending: transformedTasks.filter(t => t.status === 'pending').length,
+                        'in-progress': transformedTasks.filter(t => t.status === 'in-progress').length,
+                        done: transformedTasks.filter(t => t.status === 'done').length,
+                        review: transformedTasks.filter(t => t.status === 'review').length,
+                        deferred: transformedTasks.filter(t => t.status === 'deferred').length,
+                        cancelled: transformedTasks.filter(t => t.status === 'cancelled').length
+                    },
+                    timestamp: new Date().toISOString()
+                });
+
+            } catch (parseError) {
+                console.error('Failed to parse tasks.json:', parseError);
+                return res.status(500).json({
+                    error: 'Failed to parse tasks file',
+                    message: parseError.message
+                });
+            }
+
+        } catch (error) {
+            console.error('TaskMaster tasks loading error:', error);
+            res.status(500).json({
+                error: 'Failed to load TaskMaster tasks',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * GET /api/taskmaster/prd/:projectId
+     * List all PRD files in the project's .taskmaster/docs directory
+     */
+    router.get('/prd/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+
+            // projectId → projectPath lookup through the DB (post-migration).
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            const docsPath = path.join(projectPath, '.taskmaster', 'docs');
+
+            // Check if docs directory exists
+            try {
+                await fsPromises.access(docsPath, fs.constants.R_OK);
+            } catch (error) {
+                return res.json({
+                    projectId,
+                    prdFiles: [],
+                    message: 'No .taskmaster/docs directory found'
+                });
+            }
+
+            // Read directory and filter for PRD files
+            try {
+                const files = await fsPromises.readdir(docsPath);
+                const prdFiles = [];
+
+                for (const file of files) {
+                    const filePath = path.join(docsPath, file);
+                    const stats = await fsPromises.stat(filePath);
+
+                    if (stats.isFile() && (file.endsWith('.txt') || file.endsWith('.md'))) {
+                        prdFiles.push({
+                            name: file,
+                            path: path.relative(projectPath, filePath),
+                            size: stats.size,
+                            modified: stats.mtime.toISOString(),
+                            created: stats.birthtime.toISOString()
+                        });
+                    }
+                }
+
+                res.json({
+                    projectId,
+                    projectPath,
+                    prdFiles: prdFiles.sort((a, b) => new Date(b.modified) - new Date(a.modified)),
+                    timestamp: new Date().toISOString()
+                });
+
+            } catch (readError) {
+                console.error('Error reading docs directory:', readError);
+                return res.status(500).json({
+                    error: 'Failed to read PRD files',
+                    message: readError.message
+                });
+            }
+
+        } catch (error) {
+            console.error('PRD list error:', error);
+            res.status(500).json({
+                error: 'Failed to list PRD files',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * POST /api/taskmaster/prd/:projectId
+     * Create or update a PRD file in the project's .taskmaster/docs directory
+     */
+    router.post('/prd/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+            const { fileName, content } = req.body;
+
+            if (!fileName || !content) {
+                return res.status(400).json({
+                    error: 'Missing required fields',
+                    message: 'fileName and content are required'
+                });
+            }
+
+            // Validate filename
+            if (!fileName.match(/^[\w\-. ]+\.(txt|md)$/)) {
+                return res.status(400).json({
+                    error: 'Invalid filename',
+                    message: 'Filename must end with .txt or .md and contain only alphanumeric characters, spaces, dots, and dashes'
+                });
+            }
+
+            // Resolve the project folder through the DB using the projectId param.
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            const docsPath = path.join(projectPath, '.taskmaster', 'docs');
+            const filePath = path.join(docsPath, fileName);
+
+            // Ensure docs directory exists
+            try {
+                await fsPromises.mkdir(docsPath, { recursive: true });
+            } catch (error) {
+                console.error('Failed to create docs directory:', error);
+                return res.status(500).json({
+                    error: 'Failed to create directory',
+                    message: error.message
+                });
+            }
+
+            // Write the PRD file
+            try {
+                await fsPromises.writeFile(filePath, content, 'utf8');
+
+                // Get file stats
+                const stats = await fsPromises.stat(filePath);
+
+                res.json({
+                    projectId,
+                    projectPath,
+                    fileName,
+                    filePath: path.relative(projectPath, filePath),
+                    size: stats.size,
+                    created: stats.birthtime.toISOString(),
+                    modified: stats.mtime.toISOString(),
+                    message: 'PRD file saved successfully',
+                    timestamp: new Date().toISOString()
+                });
+
+            } catch (writeError) {
+                console.error('Failed to write PRD file:', writeError);
+                return res.status(500).json({
+                    error: 'Failed to write PRD file',
+                    message: writeError.message
+                });
+            }
+
+        } catch (error) {
+            console.error('PRD create/update error:', error);
+            res.status(500).json({
+                error: 'Failed to create/update PRD file',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * GET /api/taskmaster/prd/:projectId/:fileName
+     * Get content of a specific PRD file
+     */
+    router.get('/prd/:projectId/:fileName', async (req, res) => {
+        try {
+            const { projectId, fileName } = req.params;
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            const filePath = path.join(projectPath, '.taskmaster', 'docs', fileName);
+
+            // Check if file exists
+            try {
+                await fsPromises.access(filePath, fs.constants.R_OK);
+            } catch (error) {
+                return res.status(404).json({
+                    error: 'PRD file not found',
+                    message: `File "${fileName}" does not exist`
+                });
+            }
+
+            // Read file content
+            try {
+                const content = await fsPromises.readFile(filePath, 'utf8');
+                const stats = await fsPromises.stat(filePath);
+
+                res.json({
+                    projectId,
+                    projectPath,
+                    fileName,
+                    filePath: path.relative(projectPath, filePath),
+                    content,
+                    size: stats.size,
+                    created: stats.birthtime.toISOString(),
+                    modified: stats.mtime.toISOString(),
+                    timestamp: new Date().toISOString()
+                });
+
+            } catch (readError) {
+                console.error('Failed to read PRD file:', readError);
+                return res.status(500).json({
+                    error: 'Failed to read PRD file',
+                    message: readError.message
+                });
+            }
+
+        } catch (error) {
+            console.error('PRD read error:', error);
+            res.status(500).json({
+                error: 'Failed to read PRD file',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * POST /api/taskmaster/init/:projectId
+     * Initialize TaskMaster in a project
+     */
+    router.post('/init/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            // Check if TaskMaster is already initialized
+            const taskMasterPath = path.join(projectPath, '.taskmaster');
+            try {
+                await fsPromises.access(taskMasterPath, fs.constants.F_OK);
+                return res.status(400).json({
+                    error: 'TaskMaster already initialized',
+                    message: 'TaskMaster is already configured for this project'
+                });
+            } catch (error) {
+                // Directory doesn't exist, we can proceed
+            }
+
+            // Run taskmaster init command
+            const initProcess = runTaskmasterProcess('npx', ['task-master', 'init'], {
+                cwd: projectPath,
+                stdio: ['pipe', 'pipe', 'pipe']
+            }, ({ code, error, stdout, stderr }) => {
+                if (code === 0) {
+                    // Broadcast TaskMaster project update via WebSocket. The
+                    // WebSocket payload keeps using `projectId` so the frontend
+                    // can match notifications against the current selection.
+                    broadcastTaskMasterProjectUpdate(projectId, { hasTaskmaster: true, status: 'initialized' });
+
+                    res.json({
+                        projectId,
+                        projectPath,
+                        message: 'TaskMaster initialized successfully',
+                        output: stdout,
+                        timestamp: new Date().toISOString()
+                    });
+                } else {
+                    console.error('TaskMaster init failed:', stderr);
+                    res.status(500).json({
+                        error: 'Failed to initialize TaskMaster',
+                        message: error?.message || stderr || stdout,
+                        code
+                    });
+                }
+            });
+
+            // Send 'yes' responses to automated prompts
+            initProcess.stdin.write('yes\n');
+            initProcess.stdin.end();
+
+        } catch (error) {
+            console.error('TaskMaster init error:', error);
+            res.status(500).json({
+                error: 'Failed to initialize TaskMaster',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * POST /api/taskmaster/add-task/:projectId
+     * Add a new task to the project
+     */
+    router.post('/add-task/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+            const { prompt, title, description, priority = 'medium', dependencies } = req.body;
+
+            if (!prompt && (!title || !description)) {
+                return res.status(400).json({
+                    error: 'Missing required parameters',
+                    message: 'Either "prompt" or both "title" and "description" are required'
+                });
+            }
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            // Build the task-master add-task command
+            const args = ['task-master-ai', 'add-task'];
+
+            if (prompt) {
+                args.push('--prompt', prompt);
+                args.push('--research'); // Use research for AI-generated tasks
+            } else {
+                args.push('--prompt', `Create a task titled "${title}" with description: ${description}`);
+            }
+
+            if (priority) {
+                args.push('--priority', priority);
+            }
+
+            if (dependencies) {
+                args.push('--dependencies', dependencies);
+            }
+
+            // Run task-master add-task command
+            const addTaskProcess = runTaskmasterProcess('npx', args, {
+                cwd: projectPath,
+                stdio: ['pipe', 'pipe', 'pipe']
+            }, ({ code, error, stdout, stderr }) => {
+                console.log('Add task process completed with code:', code);
+                console.log('Stdout:', stdout);
+                console.log('Stderr:', stderr);
+
+                if (code === 0) {
+                    // Broadcast task update via WebSocket using the projectId so
+                    // clients subscribed to this project get notified immediately.
+                    broadcastTaskMasterTasksUpdate(projectId);
+
+                    res.json({
+                        projectId,
+                        projectPath,
+                        message: 'Task added successfully',
+                        output: stdout,
+                        timestamp: new Date().toISOString()
+                    });
+                } else {
+                    console.error('Add task failed:', stderr);
+                    res.status(500).json({
+                        error: 'Failed to add task',
+                        message: error?.message || stderr || stdout,
+                        code
+                    });
+                }
+            });
+
+            addTaskProcess.stdin.end();
+
+        } catch (error) {
+            console.error('Add task error:', error);
+            res.status(500).json({
+                error: 'Failed to add task',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * PUT /api/taskmaster/update-task/:projectId/:taskId
+     * Update a specific task using TaskMaster CLI
+     */
+    router.put('/update-task/:projectId/:taskId', async (req, res) => {
+        try {
+            const { projectId, taskId } = req.params;
+            const { title, description, status, priority, details } = req.body;
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            // If only updating status, use set-status command
+            if (status && Object.keys(req.body).length === 1) {
+                const setStatusProcess = runTaskmasterProcess('npx', ['task-master-ai', 'set-status', `--id=${taskId}`, `--status=${status}`], {
+                    cwd: projectPath,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                }, ({ code, error, stdout, stderr }) => {
+                    if (code === 0) {
+                        // Broadcast task update via WebSocket
+                        broadcastTaskMasterTasksUpdate(projectId);
+
+                        res.json({
+                            projectId,
+                            projectPath,
+                            taskId,
+                            message: 'Task status updated successfully',
+                            output: stdout,
+                            timestamp: new Date().toISOString()
+                        });
+                    } else {
+                        console.error('Set task status failed:', stderr);
+                        res.status(500).json({
+                            error: 'Failed to update task status',
+                            message: error?.message || stderr || stdout,
+                            code
+                        });
+                    }
+                });
+
+                setStatusProcess.stdin.end();
+            } else {
+                // For other updates, use update-task command with a prompt describing the changes
+                const updates = [];
+                if (title) updates.push(`title: "${title}"`);
+                if (description) updates.push(`description: "${description}"`);
+                if (priority) updates.push(`priority: "${priority}"`);
+                if (details) updates.push(`details: "${details}"`);
+
+                const prompt = `Update task with the following changes: ${updates.join(', ')}`;
+
+                const updateProcess = runTaskmasterProcess('npx', ['task-master-ai', 'update-task', `--id=${taskId}`, `--prompt=${prompt}`], {
+                    cwd: projectPath,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                }, ({ code, error, stdout, stderr }) => {
+                    if (code === 0) {
+                        // Broadcast task update via WebSocket
+                        broadcastTaskMasterTasksUpdate(projectId);
+
+                        res.json({
+                            projectId,
+                            projectPath,
+                            taskId,
+                            message: 'Task updated successfully',
+                            output: stdout,
+                            timestamp: new Date().toISOString()
+                        });
+                    } else {
+                        console.error('Update task failed:', stderr);
+                        res.status(500).json({
+                            error: 'Failed to update task',
+                            message: error?.message || stderr || stdout,
+                            code
+                        });
+                    }
+                });
+
+                updateProcess.stdin.end();
+            }
+
+        } catch (error) {
+            console.error('Update task error:', error);
+            res.status(500).json({
+                error: 'Failed to update task',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * POST /api/taskmaster/parse-prd/:projectId
+     * Parse a PRD file to generate tasks
+     */
+    router.post('/parse-prd/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+            const { fileName = 'prd.txt', numTasks, append = false } = req.body;
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            const prdPath = path.join(projectPath, '.taskmaster', 'docs', fileName);
+
+            // Check if PRD file exists
+            try {
+                await fsPromises.access(prdPath, fs.constants.F_OK);
+            } catch (error) {
+                return res.status(404).json({
+                    error: 'PRD file not found',
+                    message: `File "${fileName}" does not exist in .taskmaster/docs/`
+                });
+            }
+
+            // Build the command args
+            const args = ['task-master-ai', 'parse-prd', prdPath];
+
+            if (numTasks) {
+                args.push('--num-tasks', numTasks.toString());
+            }
+
+            if (append) {
+                args.push('--append');
+            }
+
+            args.push('--research'); // Use research for better PRD parsing
+
+            // Run task-master parse-prd command
+            const parsePRDProcess = runTaskmasterProcess('npx', args, {
+                cwd: projectPath,
+                stdio: ['pipe', 'pipe', 'pipe']
+            }, ({ code, error, stdout, stderr }) => {
+                if (code === 0) {
+                    // Broadcast task update via WebSocket
+                    broadcastTaskMasterTasksUpdate(projectId);
+
+                    res.json({
+                        projectId,
+                        projectPath,
+                        prdFile: fileName,
+                        message: 'PRD parsed and tasks generated successfully',
+                        output: stdout,
+                        timestamp: new Date().toISOString()
+                    });
+                } else {
+                    console.error('Parse PRD failed:', stderr);
+                    res.status(500).json({
+                        error: 'Failed to parse PRD',
+                        message: error?.message || stderr || stdout,
+                        code
+                    });
+                }
+            });
+
+            parsePRDProcess.stdin.end();
+
+        } catch (error) {
+            console.error('Parse PRD error:', error);
+            res.status(500).json({
+                error: 'Failed to parse PRD',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * GET /api/taskmaster/prd-templates
+     * Get available PRD templates
+     */
+    router.get('/prd-templates', async (req, res) => {
+        try {
+            // Return built-in templates
+            const templates = [
+                {
+                    id: 'web-app',
+                    name: 'Web Application',
+                    description: 'Template for web application projects with frontend and backend components',
+                    category: 'web',
+                    content: `# Product Requirements Document - Web Application
+
+## Overview
+**Product Name:** [Your App Name]
+**Version:** 1.0
+**Date:** ${new Date().toISOString().split('T')[0]}
+**Author:** [Your Name]
+
+## Executive Summary
+Brief description of what this web application will do and why it's needed.
+
+## Product Goals
+- Goal 1: [Specific measurable goal]
+- Goal 2: [Specific measurable goal]
+- Goal 3: [Specific measurable goal]
+
+## User Stories
+### Core Features
+1. **User Registration & Authentication**
+   - As a user, I want to create an account so I can access personalized features
+   - As a user, I want to log in securely so my data is protected
+   - As a user, I want to reset my password if I forget it
+
+2. **Main Application Features**
+   - As a user, I want to [core feature 1] so I can [benefit]
+   - As a user, I want to [core feature 2] so I can [benefit]
+   - As a user, I want to [core feature 3] so I can [benefit]
+
+3. **User Interface**
+   - As a user, I want a responsive design so I can use the app on any device
+   - As a user, I want intuitive navigation so I can easily find features
+
+## Technical Requirements
+### Frontend
+- Framework: React/Vue/Angular or vanilla JavaScript
+- Styling: CSS framework (Tailwind, Bootstrap, etc.)
+- State Management: Redux/Vuex/Context API
+- Build Tools: Webpack/Vite
+- Testing: Jest/Vitest for unit tests
+
+### Backend
+- Runtime: Node.js/Python/Java
+- Database: PostgreSQL/MySQL/MongoDB
+- API: RESTful API or GraphQL
+- Authentication: JWT tokens
+- Testing: Integration and unit tests
+
+### Infrastructure
+- Hosting: Cloud provider (AWS, Azure, GCP)
+- CI/CD: GitHub Actions/GitLab CI
+- Monitoring: Application monitoring tools
+- Security: HTTPS, input validation, rate limiting
+
+## Success Metrics
+- User engagement metrics
+- Performance benchmarks (load time < 2s)
+- Error rates < 1%
+- User satisfaction scores
+
+## Timeline
+- Phase 1: Core functionality (4-6 weeks)
+- Phase 2: Advanced features (2-4 weeks)
+- Phase 3: Polish and launch (2 weeks)
+
+## Constraints & Assumptions
+- Budget constraints
+- Technical limitations
+- Team size and expertise
+- Timeline constraints`
+                },
+                {
+                    id: 'api',
+                    name: 'REST API',
+                    description: 'Template for REST API development projects',
+                    category: 'backend',
+                    content: `# Product Requirements Document - REST API
+
+## Overview
+**API Name:** [Your API Name]
+**Version:** v1.0
+**Date:** ${new Date().toISOString().split('T')[0]}
+**Author:** [Your Name]
+
+## Executive Summary
+Description of the API's purpose, target users, and primary use cases.
+
+## API Goals
+- Goal 1: Provide secure data access
+- Goal 2: Ensure scalable architecture
+- Goal 3: Maintain high availability (99.9% uptime)
+
+## Functional Requirements
+### Core Endpoints
+1. **Authentication Endpoints**
+   - POST /api/auth/login - User authentication
+   - POST /api/auth/logout - User logout
+   - POST /api/auth/refresh - Token refresh
+   - POST /api/auth/register - User registration
+
+2. **Data Management Endpoints**
+   - GET /api/resources - List resources with pagination
+   - GET /api/resources/{id} - Get specific resource
+   - POST /api/resources - Create new resource
+   - PUT /api/resources/{id} - Update existing resource
+   - DELETE /api/resources/{id} - Delete resource
+
+3. **Administrative Endpoints**
+   - GET /api/admin/users - Manage users (admin only)
+   - GET /api/admin/analytics - System analytics
+   - POST /api/admin/backup - Trigger system backup
+
+## Technical Requirements
+### API Design
+- RESTful architecture following OpenAPI 3.0 specification
+- JSON request/response format
+- Consistent error response format
+- API versioning strategy
+
+### Authentication & Security
+- JWT token-based authentication
+- Role-based access control (RBAC)
+- Rate limiting (100 requests/minute per user)
+- Input validation and sanitization
+- HTTPS enforcement
+
+### Database
+- Database type: [PostgreSQL/MongoDB/MySQL]
+- Connection pooling
+- Database migrations
+- Backup and recovery procedures
+
+### Performance Requirements
+- Response time: < 200ms for 95% of requests
+- Throughput: 1000+ requests/second
+- Concurrent users: 10,000+
+- Database query optimization
+
+### Documentation
+- Auto-generated API documentation (Swagger/OpenAPI)
+- Code examples for common use cases
+- SDK development for major languages
+- Postman collection for testing
+
+## Error Handling
+- Standardized error codes and messages
+- Proper HTTP status codes
+- Detailed error logging
+- Graceful degradation strategies
+
+## Testing Strategy
+- Unit tests (80%+ coverage)
+- Integration tests for all endpoints
+- Load testing and performance testing
+- Security testing (OWASP compliance)
+
+## Monitoring & Logging
+- Application performance monitoring
+- Error tracking and alerting
+- Access logs and audit trails
+- Health check endpoints
+
+## Deployment
+- Containerized deployment (Docker)
+- CI/CD pipeline setup
+- Environment management (dev, staging, prod)
+- Blue-green deployment strategy
+
+## Success Metrics
+- API uptime > 99.9%
+- Average response time < 200ms
+- Zero critical security vulnerabilities
+- Developer adoption metrics`
+                },
+                {
+                    id: 'mobile-app',
+                    name: 'Mobile Application',
+                    description: 'Template for mobile app development projects (iOS/Android)',
+                    category: 'mobile',
+                    content: `# Product Requirements Document - Mobile Application
+
+## Overview
+**App Name:** [Your App Name]
+**Platform:** iOS / Android / Cross-platform
+**Version:** 1.0
+**Date:** ${new Date().toISOString().split('T')[0]}
+**Author:** [Your Name]
+
+## Executive Summary
+Brief description of the mobile app's purpose, target audience, and key value proposition.
+
+## Product Goals
+- Goal 1: [Specific user engagement goal]
+- Goal 2: [Specific functionality goal]
+- Goal 3: [Specific performance goal]
+
+## User Stories
+### Core Features
+1. **Onboarding & Authentication**
+   - As a new user, I want a simple onboarding process
+   - As a user, I want to sign up with email or social media
+   - As a user, I want biometric authentication for security
+
+2. **Main App Features**
+   - As a user, I want [core feature 1] accessible from home screen
+   - As a user, I want [core feature 2] to work offline
+   - As a user, I want to sync data across devices
+
+3. **User Experience**
+   - As a user, I want intuitive navigation patterns
+   - As a user, I want fast loading times
+   - As a user, I want accessibility features
+
+## Technical Requirements
+### Mobile Development
+- **Cross-platform:** React Native / Flutter / Xamarin
+- **Native:** Swift (iOS) / Kotlin (Android)
+- **State Management:** Redux / MobX / Provider
+- **Navigation:** React Navigation / Flutter Navigation
+
+### Backend Integration
+- REST API or GraphQL integration
+- Real-time features (WebSockets/Push notifications)
+- Offline data synchronization
+- Background processing
+
+### Device Features
+- Camera and photo library access
+- GPS location services
+- Push notifications
+- Biometric authentication
+- Device storage
+
+### Performance Requirements
+- App launch time < 3 seconds
+- Screen transition animations < 300ms
+- Memory usage optimization
+- Battery usage optimization
+
+## Platform-Specific Considerations
+### iOS Requirements
+- iOS 13.0+ minimum version
+- App Store guidelines compliance
+- iOS design guidelines (Human Interface Guidelines)
+- TestFlight beta testing
+
+### Android Requirements
+- Android 8.0+ (API level 26) minimum
+- Google Play Store guidelines
+- Material Design guidelines
+- Google Play Console testing
+
+## User Interface Design
+- Responsive design for different screen sizes
+- Dark mode support
+- Accessibility compliance (WCAG 2.1)
+- Consistent design system
+
+## Security & Privacy
+- Secure data storage (Keychain/Keystore)
+- API communication encryption
+- Privacy policy compliance (GDPR/CCPA)
+- App security best practices
+
+## Testing Strategy
+- Unit testing (80%+ coverage)
+- UI/E2E testing (Detox/Appium)
+- Device testing on multiple screen sizes
+- Performance testing
+- Security testing
+
+## App Store Deployment
+- App store optimization (ASO)
+- App icons and screenshots
+- Store listing content
+- Release management strategy
+
+## Analytics & Monitoring
+- User analytics (Firebase/Analytics)
+- Crash reporting (Crashlytics/Sentry)
+- Performance monitoring
+- User feedback collection
+
+## Success Metrics
+- App store ratings > 4.0
+- User retention rates
+- Daily/Monthly active users
+- App performance metrics
+- Conversion rates`
+                },
+                {
+                    id: 'data-analysis',
+                    name: 'Data Analysis Project',
+                    description: 'Template for data analysis and visualization projects',
+                    category: 'data',
+                    content: `# Product Requirements Document - Data Analysis Project
+
+## Overview
+**Project Name:** [Your Analysis Project]
+**Analysis Type:** [Descriptive/Predictive/Prescriptive]
+**Date:** ${new Date().toISOString().split('T')[0]}
+**Author:** [Your Name]
+
+## Executive Summary
+Description of the business problem, data sources, and expected insights.
+
+## Project Goals
+- Goal 1: [Specific business question to answer]
+- Goal 2: [Specific prediction to make]
+- Goal 3: [Specific recommendation to provide]
+
+## Business Requirements
+### Key Questions
+1. What patterns exist in the current data?
+2. What factors influence [target variable]?
+3. What predictions can be made for [future outcome]?
+4. What recommendations can improve [business metric]?
+
+### Success Criteria
+- Actionable insights for stakeholders
+- Statistical significance in findings
+- Reproducible analysis pipeline
+- Clear visualization and reporting
+
+## Data Requirements
+### Data Sources
+1. **Primary Data**
+   - Source: [Database/API/Files]
+   - Format: [CSV/JSON/SQL]
+   - Size: [Volume estimate]
+   - Update frequency: [Real-time/Daily/Monthly]
+
+2. **External Data**
+   - Third-party APIs
+   - Public datasets
+   - Market research data
+
+### Data Quality Requirements
+- Data completeness (< 5% missing values)
+- Data accuracy validation
+- Data consistency checks
+- Historical data availability
+
+## Technical Requirements
+### Data Pipeline
+- Data extraction and ingestion
+- Data cleaning and preprocessing
+- Data transformation and feature engineering
+- Data validation and quality checks
+
+### Analysis Tools
+- **Programming:** Python/R/SQL
+- **Libraries:** pandas, numpy, scikit-learn, matplotlib
+- **Visualization:** Tableau, PowerBI, or custom dashboards
+- **Version Control:** Git for code and DVC for data
+
+### Computing Resources
+- Local development environment
+- Cloud computing (AWS/GCP/Azure) if needed
+- Database access and permissions
+- Storage requirements
+
+## Analysis Methodology
+### Data Exploration
+1. Descriptive statistics and data profiling
+2. Data visualization and pattern identification
+3. Correlation analysis
+4. Outlier detection and handling
+
+### Statistical Analysis
+1. Hypothesis formulation
+2. Statistical testing
+3. Confidence intervals
+4. Effect size calculations
+
+### Machine Learning (if applicable)
+1. Feature selection and engineering
+2. Model selection and training
+3. Cross-validation and evaluation
+4. Model interpretation and explainability
+
+## Deliverables
+### Reports
+- Executive summary for stakeholders
+- Technical analysis report
+- Data quality report
+- Methodology documentation
+
+### Visualizations
+- Interactive dashboards
+- Static charts and graphs
+- Data story presentations
+- Key findings infographics
+
+### Code & Documentation
+- Reproducible analysis scripts
+- Data pipeline code
+- Documentation and comments
+- Testing and validation code
+
+## Timeline
+- Phase 1: Data collection and exploration (2 weeks)
+- Phase 2: Analysis and modeling (3 weeks)
+- Phase 3: Reporting and visualization (1 week)
+- Phase 4: Stakeholder presentation (1 week)
+
+## Risks & Assumptions
+- Data availability and quality risks
+- Technical complexity assumptions
+- Resource and timeline constraints
+- Stakeholder engagement assumptions
+
+## Success Metrics
+- Stakeholder satisfaction with insights
+- Accuracy of predictions (if applicable)
+- Business impact of recommendations
+- Reproducibility of results`
+                }
+            ];
+
+            res.json({
+                templates,
+                timestamp: new Date().toISOString()
+            });
+
+        } catch (error) {
+            console.error('PRD templates error:', error);
+            res.status(500).json({
+                error: 'Failed to get PRD templates',
+                message: error.message
+            });
+        }
+    });
+
+    /**
+     * POST /api/taskmaster/apply-template/:projectId
+     * Apply a PRD template to create a new PRD file
+     */
+    router.post('/apply-template/:projectId', async (req, res) => {
+        try {
+            const { projectId } = req.params;
+            const { templateId, fileName = 'prd.txt', customizations = {} } = req.body;
+
+            if (!templateId) {
+                return res.status(400).json({
+                    error: 'Missing required parameter',
+                    message: 'templateId is required'
+                });
+            }
+
+            const projectPath = await resolveProjectPathFromId(projectId);
+            if (!projectPath) {
+                return res.status(404).json({
+                    error: 'Project not found',
+                    message: `Project "${projectId}" does not exist`
+                });
+            }
+
+            // Get the template content (this would normally fetch from the templates list)
+            const templates = await getAvailableTemplates();
+            const template = templates.find(t => t.id === templateId);
+
+            if (!template) {
+                return res.status(404).json({
+                    error: 'Template not found',
+                    message: `Template "${templateId}" does not exist`
+                });
+            }
+
+            // Apply customizations to template content
+            let content = template.content;
+
+            // Replace placeholders with customizations
+            for (const [key, value] of Object.entries(customizations)) {
+                const placeholder = `[${key}]`;
+                content = content.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g'), value);
+            }
+
+            // Ensure .taskmaster/docs directory exists
+            const docsDir = path.join(projectPath, '.taskmaster', 'docs');
+            try {
+                await fsPromises.mkdir(docsDir, { recursive: true });
+            } catch (error) {
+                console.error('Failed to create docs directory:', error);
+            }
+
+            const filePath = path.join(docsDir, fileName);
+
+            // Write the template content to the file
+            try {
+                await fsPromises.writeFile(filePath, content, 'utf8');
+
+                res.json({
+                    projectId,
+                    projectPath,
+                    templateId,
+                    templateName: template.name,
+                    fileName,
+                    filePath: filePath,
+                    message: 'PRD template applied successfully',
+                    timestamp: new Date().toISOString()
+                });
+
+            } catch (writeError) {
+                console.error('Failed to write PRD template:', writeError);
+                return res.status(500).json({
+                    error: 'Failed to write PRD template',
+                    message: writeError.message
+                });
+            }
+
+        } catch (error) {
+            console.error('Apply template error:', error);
+            res.status(500).json({
+                error: 'Failed to apply PRD template',
+                message: error.message
+            });
+        }
+    });
+
+    // Helper function to get available templates
+    async function getAvailableTemplates() {
+        // This could be extended to read from files or database
+        return [
+            {
+                id: 'web-app',
+                name: 'Web Application',
+                description: 'Template for web application projects',
+                category: 'web',
+                content: `# Product Requirements Document - Web Application
+
+## Overview
+**Product Name:** [Your App Name]
+**Version:** 1.0
+**Date:** ${new Date().toISOString().split('T')[0]}
+**Author:** [Your Name]
+
+## Executive Summary
+Brief description of what this web application will do and why it's needed.
+
+## User Stories
+1. As a user, I want [feature] so I can [benefit]
+2. As a user, I want [feature] so I can [benefit]
+3. As a user, I want [feature] so I can [benefit]
+
+## Technical Requirements
+- Frontend framework
+- Backend services
+- Database requirements
+- Security considerations
+
+## Success Metrics
+- User engagement metrics
+- Performance benchmarks
+- Business objectives`
+            },
+            // Add other templates here if needed
+        ];
+    }
+
+    return router;
+}