ai-sprint-kit 2.0.4 → 2.1.0

package/lib/validator.js

@@ -0,0 +1,264 @@
+const fs = require('fs/promises');
+const path = require('path');
+const chalk = require('chalk');
+
+/**
+ * Validation results
+ */
+class ValidationResult {
+  constructor() {
+    this.passed = [];
+    this.failed = [];
+    this.warnings = [];
+  }
+
+  addPass(check) {
+    this.passed.push(check);
+  }
+
+  addFail(check, suggestion) {
+    this.failed.push({ check, suggestion });
+  }
+
+  addWarning(check, message) {
+    this.warnings.push({ check, message });
+  }
+
+  isValid() {
+    return this.failed.length === 0;
+  }
+
+  summary() {
+    const { passed, failed, warnings } = this;
+    return {
+      total: passed.length + failed.length + warnings.length,
+      passed: passed.length,
+      failed: failed.length,
+      warnings: warnings.length
+    };
+  }
+}
+
+/**
+ * Validate AI Sprint Kit installation
+ * @param {string} targetDir - Directory to validate
+ * @returns {Promise<ValidationResult>}
+ */
+async function validateInstallation(targetDir = process.cwd()) {
+  const result = new ValidationResult();
+
+  // 1. Check .claude directory structure
+  await validateDirectoryStructure(targetDir, result);
+
+  // 2. Check required files
+  await validateRequiredFiles(targetDir, result);
+
+  // 3. Check configuration files
+  await validateConfiguration(targetDir, result);
+
+  // 4. Check agents
+  await validateAgents(targetDir, result);
+
+  // 5. Check commands
+  await validateCommands(targetDir, result);
+
+  // 6. Check hooks
+  await validateHooks(targetDir, result);
+
+  return result;
+}
+
+/**
+ * Validate directory structure
+ */
+async function validateDirectoryStructure(targetDir, result) {
+  const requiredDirs = [
+    '.claude',
+    '.claude/agents',
+    '.claude/commands',
+    '.claude/workflows',
+    'ai_context',
+    'ai_context/plans',
+    'ai_context/reports',
+    'ai_context/memory'
+  ];
+
+  for (const dir of requiredDirs) {
+    const dirPath = path.join(targetDir, dir);
+    try {
+      const stat = await fs.stat(dirPath);
+      if (stat.isDirectory()) {
+        result.addPass(`Directory exists: ${dir}/`);
+      } else {
+        result.addFail(`Directory exists but is not a directory: ${dir}/`, `Remove file and reinstall`);
+      }
+    } catch {
+      result.addFail(`Directory missing: ${dir}/`, `Run: ai-sprint repair`);
+    }
+  }
+}
+
+/**
+ * Validate required files
+ */
+async function validateRequiredFiles(targetDir, result) {
+  const requiredFiles = [
+    'CLAUDE.md',
+    '.claude/settings.json',
+    '.claude/.env.example'
+  ];
+
+  for (const file of requiredFiles) {
+    const filePath = path.join(targetDir, file);
+    try {
+      await fs.access(filePath);
+      result.addPass(`File exists: ${file}`);
+    } catch {
+      result.addFail(`File missing: ${file}`, `Run: ai-sprint repair`);
+    }
+  }
+}
+
+/**
+ * Validate configuration files
+ */
+async function validateConfiguration(targetDir, result) {
+  // Check settings.json is valid JSON
+  const settingsPath = path.join(targetDir, '.claude/settings.json');
+  try {
+    const content = await fs.readFile(settingsPath, 'utf8');
+    JSON.parse(content);
+    result.addPass('settings.json is valid JSON');
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      result.addFail('settings.json missing', 'Run: ai-sprint repair');
+    } else {
+      result.addFail('settings.json is invalid JSON', 'Fix JSON syntax or run: ai-sprint repair');
+    }
+  }
+
+  // Check .env.example
+  const envExamplePath = path.join(targetDir, '.claude/.env.example');
+  try {
+    await fs.access(envExamplePath);
+    result.addPass('.env.example exists');
+  } catch {
+    result.addWarning('.env.example missing', 'Create .env.example with environment variable templates');
+  }
+
+  // Check .mcp.json.example
+  const mcpExamplePath = path.join(targetDir, '.mcp.json.example');
+  try {
+    await fs.access(mcpExamplePath);
+    result.addPass('.mcp.json.example exists');
+  } catch {
+    result.addWarning('.mcp.json.example missing', 'Create .mcp.json.example with MCP configuration template');
+  }
+}
+
+/**
+ * Validate agents
+ */
+async function validateAgents(targetDir, result) {
+  const agentsDir = path.join(targetDir, '.claude/agents');
+  try {
+    const files = await fs.readdir(agentsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+
+    if (mdFiles.length >= 9) {
+      result.addPass(`Agents: ${mdFiles.length} agent files found`);
+    } else {
+      result.addWarning(`Agents: Only ${mdFiles.length} agent files (expected 9+)`, 'Consider adding missing agents');
+    }
+  } catch {
+    result.addFail('Agents directory missing', 'Run: ai-sprint repair');
+  }
+}
+
+/**
+ * Validate commands
+ */
+async function validateCommands(targetDir, result) {
+  const commandsDir = path.join(targetDir, '.claude/commands');
+  try {
+    const files = await fs.readdir(commandsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+
+    if (mdFiles.length >= 13) {
+      result.addPass(`Commands: ${mdFiles.length} command files found`);
+    } else {
+      result.addWarning(`Commands: Only ${mdFiles.length} command files (expected 13+)`, 'Consider adding missing commands');
+    }
+  } catch {
+    result.addFail('Commands directory missing', 'Run: ai-sprint repair');
+  }
+}
+
+/**
+ * Validate hooks
+ */
+async function validateHooks(targetDir, result) {
+  const hooksDir = path.join(targetDir, '.claude/hooks');
+  try {
+    const stat = await fs.stat(hooksDir);
+    if (stat.isDirectory()) {
+      const files = await fs.readdir(hooksDir);
+      if (files.length > 0) {
+        result.addPass(`Hooks: ${files.length} hook files found`);
+      } else {
+        result.addWarning('Hooks directory exists but is empty', 'Add PostToolUse, Stop hooks for automation');
+      }
+    }
+  } catch {
+    result.addWarning('Hooks directory missing', 'Add hooks for automated formatting and verification');
+  }
+}
+
+/**
+ * Format validation results for display
+ */
+function formatResults(result) {
+  const lines = [];
+  const summary = result.summary();
+
+  lines.push(chalk.bold('\n📋 AI Sprint Kit Validation\n'));
+
+  if (result.passed.length > 0) {
+    lines.push(chalk.green.bold('\n✅ Passed:'));
+    result.passed.forEach(check => {
+      lines.push(chalk.green(`  ✓ ${check}`));
+    });
+  }
+
+  if (result.warnings.length > 0) {
+    lines.push(chalk.yellow.bold('\n⚠️  Warnings:'));
+    result.warnings.forEach(({ check, message }) => {
+      lines.push(chalk.yellow(`  ! ${check}`));
+      lines.push(chalk.gray(`    → ${message}`));
+    });
+  }
+
+  if (result.failed.length > 0) {
+    lines.push(chalk.red.bold('\n❌ Failed:'));
+    result.failed.forEach(({ check, suggestion }) => {
+      lines.push(chalk.red(`  ✗ ${check}`));
+      lines.push(chalk.gray(`    → ${suggestion}`));
+    });
+  }
+
+  lines.push(chalk.bold(`\n📊 Summary: ${summary.passed} passed, ${summary.warnings} warnings, ${summary.failed} failed`));
+
+  if (result.isValid()) {
+    lines.push(chalk.green.bold('\n✅ Installation is valid!\n'));
+  } else {
+    lines.push(chalk.red.bold('\n❌ Installation has issues. Run: ai-sprint repair\n'));
+  }
+
+  return lines.join('\n');
+}
+
+module.exports = {
+  validateInstallation,
+  ValidationResult,
+  formatResults
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sprint-kit",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "description": "CLI installer for AI Sprint autonomous development framework - requires license",
   "main": "lib/installer.js",
   "bin": {
@@ -44,7 +44,8 @@
   "dependencies": {
     "commander": "^11.1.0",
     "chalk": "^4.1.2",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "semver": "^7.6.0"
   },
   "publishConfig": {
     "access": "public"