import { z } from 'zod'; import { FileManager } from '../utils/file-manager.js'; const validateSchema = z.object({ projectPath: z.string().min(1, 'projectPath is required and must be absolute') }); export async function handleSpecValidate(args: any) { try { const { projectPath } = validateSchema.parse(args); const fileManager = new FileManager(projectPath); // Check all spec files const specFiles = await fileManager.listFiles(); const validation = { project: await validateProjectFile(fileManager), requirements: await validateRequirementsFile(fileManager), design: await validateDesignFile(fileManager), tasks: await validateTasksFile(fileManager) }; const totalFiles = Object.keys(validation).length; const validFiles = Object.values(validation).filter(v => v.isValid).length; const overallStatus = validFiles === totalFiles ? '✅ All files valid' : `⚠️ ${validFiles}/${totalFiles} files valid`; let resultText = `📊 Spec Validation Results\n\n${overallStatus}\n\n`; // Project validation resultText += `📋 Project.md: ${validation.project.isValid ? '✅ Valid' : '❌ Invalid'}\n`; if (!validation.project.isValid) { resultText += ` Errors: ${validation.project.errors.join(', ')}\n`; } // Requirements validation resultText += `📝 Requirements.md: ${validation.requirements.isValid ? '✅ Valid' : '❌ Invalid'}\n`; if (!validation.requirements.isValid) { resultText += ` Errors: ${validation.requirements.errors.join(', ')}\n`; } // Design validation resultText += `🏗️ Design.md: ${validation.design.isValid ? '✅ Valid' : '❌ Invalid'}\n`; if (!validation.design.isValid) { resultText += ` Errors: ${validation.design.errors.join(', ')}\n`; } // Tasks validation resultText += `✅ Tasks.md: ${validation.tasks.isValid ? '✅ Valid' : '❌ Invalid'}\n`; if (!validation.tasks.isValid) { resultText += ` Errors: ${validation.tasks.errors.join(', ')}\n`; } return { content: [{ type: "text", text: resultText }] }; } catch (error: any) { return { content: [{ type: "text", text: `❌ Error in spec-validate: ${error.message}` }] }; } } async function validateProjectFile(fileManager: FileManager): Promise<{ isValid: boolean; errors: string[] }> { const errors: string[] = []; try { const content = await fileManager.readFile('project.md'); // Check for required sections const requiredSections = ['# ', '## 📋 Project Overview', '## 🛠️ Technology Stack']; for (const section of requiredSections) { if (!content.includes(section)) { errors.push(`Missing section: ${section}`); } } return { isValid: errors.length === 0, errors }; } catch { return { isValid: false, errors: ['File not found'] }; } } async function validateRequirementsFile(fileManager: FileManager): Promise<{ isValid: boolean; errors: string[] }> { const errors: string[] = []; try { const content = await fileManager.readFile('requirements.md'); // Check for required sections const requiredSections = ['# ', '## 📋 Overview', '## 👥 User Stories', '## ⚙️ Functional Requirements']; for (const section of requiredSections) { if (!content.includes(section)) { errors.push(`Missing section: ${section}`); } } // Check for EARS format in functional requirements (warning only) const lines = content.split('\n'); let hasEARSFormat = false; let earsCount = 0; let totalRequirements = 0; for (const line of lines) { if (line.trim().startsWith('- ')) { totalRequirements++; if (line.match(/WHEN.*THEN.*SHALL/i) || line.match(/GIVEN.*WHEN.*THEN.*SHALL/i) || line.match(/WHERE.*IF.*THEN.*SHALL/i) || line.match(/O sistema SHALL/i)) { hasEARSFormat = true; earsCount++; } } } // Only add warning if no EARS format found, but don't fail validation if (!hasEARSFormat && totalRequirements > 0) { errors.push('No EARS format requirements found (consider using enhance-ears action)'); } return { isValid: errors.length === 0, errors }; } catch { return { isValid: false, errors: ['File not found'] }; } } async function validateDesignFile(fileManager: FileManager): Promise<{ isValid: boolean; errors: string[] }> { const errors: string[] = []; try { const content = await fileManager.readFile('design.md'); // Check for required sections const requiredSections = ['# ', '## 📋 Overview', '## 🏗️ Architecture', '## 🧩 Components']; for (const section of requiredSections) { if (!content.includes(section)) { errors.push(`Missing section: ${section}`); } } return { isValid: errors.length === 0, errors }; } catch { return { isValid: false, errors: ['File not found'] }; } } async function validateTasksFile(fileManager: FileManager): Promise<{ isValid: boolean; errors: string[] }> { const errors: string[] = []; try { const content = await fileManager.readFile('tasks.md'); // Check for required sections if (!content.includes('# Tasks')) { errors.push('Missing header: # Tasks'); } // Check for valid task format const lines = content.split('\n'); let hasValidTasks = false; for (const line of lines) { if (line.trim().match(/^- \[[ x]\] \d+\./)) { hasValidTasks = true; break; } } if (!hasValidTasks) { errors.push('No valid tasks found (format: - [ ] 1. Task description)'); } return { isValid: errors.length === 0, errors }; } catch { return { isValid: false, errors: ['File not found'] }; } } // Export the tool function export const specValidateTool = { name: "spec-validate", description: "Validate all spec files for consistency and format compliance", inputSchema: { type: "object", properties: { projectPath: { type: "string", description: "Absolute path to the project directory (must be full path, not relative)" } }, required: ["projectPath"] }, handler: handleSpecValidate };