claude-code-templates 1.14.14 → 1.14.15

package/README.md

@@ -51,14 +51,14 @@ npx claude-code-templates@latest --health-check
 
 ## 📖 Documentation
 
-**[📚 Complete Documentation](https://aitmpl.com/docu/)** - Comprehensive guides, examples, and API reference
+**[📚 Complete Documentation](https://docs.aitmpl.com/)** - Comprehensive guides, examples, and API reference
 
 Quick links:
-- [Getting Started](https://aitmpl.com/docu/docs/intro) - Installation and first steps
-- [Project Setup](https://aitmpl.com/docu/docs/project-setup/interactive-setup) - Configure your projects
-- [Analytics Dashboard](https://aitmpl.com/docu/docs/analytics/overview) - Real-time monitoring
-- [Individual Components](https://aitmpl.com/docu/docs/components/overview) - Agents, Commands, MCPs
-- [CLI Options](https://aitmpl.com/docu/docs/cli-options) - All available commands
+- [Getting Started](https://docs.aitmpl.com/docs/intro) - Installation and first steps
+- [Project Setup](https://docs.aitmpl.com/docs/project-setup/interactive-setup) - Configure your projects
+- [Analytics Dashboard](https://docs.aitmpl.com/docs/analytics/overview) - Real-time monitoring
+- [Individual Components](https://docs.aitmpl.com/docs/components/overview) - Agents, Commands, MCPs
+- [CLI Options](https://docs.aitmpl.com/docs/cli-options) - All available commands
 
 ## 🤝 Contributing
 
@@ -71,7 +71,7 @@ MIT License - see the [LICENSE](LICENSE) file for details.
 ## 🔗 Links
 
 - **🌐 Browse Components**: [aitmpl.com](https://aitmpl.com)
-- **📚 Documentation**: [aitmpl.com/docu](https://aitmpl.com/docu)
+- **📚 Documentation**: [docs.aitmpl.com](https://docs.aitmpl.com)
 - **🐛 Issues**: [GitHub Issues](https://github.com/davila7/claude-code-templates/issues)
 - **💬 Discussions**: [GitHub Discussions](https://github.com/davila7/claude-code-templates/discussions)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.14.14",
+  "version": "1.14.15",
   "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
   "main": "src/index.js",
   "bin": {

package/src/health-check.js

@@ -16,7 +16,9 @@ class HealthChecker {
       system: [],
       claudeCode: [],
       project: [],
+      agents: [],
       commands: [],
+      mcps: [],
       hooks: []
     };
     this.totalChecks = 0;
@@ -42,6 +44,14 @@ class HealthChecker {
     await this.checkProjectSetupWithSpinner();
     await this.sleep(3000);
     
+    // Agents check
+    await this.checkAgentsWithSpinner();
+    await this.sleep(3000);
+    
+    // MCP servers check
+    await this.checkMCPServersWithSpinner();
+    await this.sleep(3000);
+    
     // Custom commands check
     await this.checkCustomCommandsWithSpinner();
     await this.sleep(3000);
@@ -165,6 +175,54 @@ class HealthChecker {
     localSettingsSpinner.succeed(`${this.getStatusIcon(localSettingsInfo.status)} Local Settings       │ ${localSettingsInfo.message}`);
   }
 
+  /**
+   * Check agents with spinner and immediate results
+   */
+  async checkAgentsWithSpinner() {
+    console.log(chalk.cyan('\n┌──────────┐'));
+    console.log(chalk.cyan('│  AGENTS  │'));
+    console.log(chalk.cyan('└──────────┘'));
+    
+    // Project agents
+    const projectSpinner = ora('Scanning Project Agents...').start();
+    const projectAgents = this.checkProjectAgents();
+    this.addResult('agents', 'Project Agents', projectAgents.status, projectAgents.message);
+    projectSpinner.succeed(`${this.getStatusIcon(projectAgents.status)} Project Agents      │ ${projectAgents.message}`);
+
+    // Personal agents
+    const personalSpinner = ora('Scanning Personal Agents...').start();
+    const personalAgents = this.checkPersonalAgents();
+    this.addResult('agents', 'Personal Agents', personalAgents.status, personalAgents.message);
+    personalSpinner.succeed(`${this.getStatusIcon(personalAgents.status)} Personal Agents     │ ${personalAgents.message}`);
+
+    // Agent syntax validation
+    const syntaxSpinner = ora('Validating Agent Syntax...').start();
+    const syntaxInfo = this.checkAgentSyntax();
+    this.addResult('agents', 'Agent Syntax', syntaxInfo.status, syntaxInfo.message);
+    syntaxSpinner.succeed(`${this.getStatusIcon(syntaxInfo.status)} Agent Syntax        │ ${syntaxInfo.message}`);
+  }
+
+  /**
+   * Check MCP servers with spinner and immediate results
+   */
+  async checkMCPServersWithSpinner() {
+    console.log(chalk.cyan('\n┌──────────────┐'));
+    console.log(chalk.cyan('│  MCP SERVERS │'));
+    console.log(chalk.cyan('└──────────────┘'));
+    
+    // Project MCP configuration
+    const projectMCPSpinner = ora('Scanning Project MCP Configuration...').start();
+    const projectMCP = this.checkProjectMCPConfiguration();
+    this.addResult('mcps', 'Project MCP Config', projectMCP.status, projectMCP.message);
+    projectMCPSpinner.succeed(`${this.getStatusIcon(projectMCP.status)} Project MCP Config   │ ${projectMCP.message}`);
+
+    // MCP configuration validation
+    const mcpValidationSpinner = ora('Validating MCP Configuration...').start();
+    const mcpValidation = this.checkMCPConfigurationSyntax();
+    this.addResult('mcps', 'MCP Config Syntax', mcpValidation.status, mcpValidation.message);
+    mcpValidationSpinner.succeed(`${this.getStatusIcon(mcpValidation.status)} MCP Config Syntax   │ ${mcpValidation.message}`);
+  }
+
   /**
    * Check custom commands with spinner and immediate results
    */
@@ -552,6 +610,123 @@ class HealthChecker {
     }
   }
 
+  checkProjectMCPConfiguration() {
+    const currentDir = process.cwd();
+    const mcpConfigPath = path.join(currentDir, '.mcp.json');
+    
+    if (fs.existsSync(mcpConfigPath)) {
+      try {
+        const mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
+        
+        if (mcpConfig.mcpServers && typeof mcpConfig.mcpServers === 'object') {
+          const serverCount = Object.keys(mcpConfig.mcpServers).length;
+          return {
+            status: 'pass',
+            message: `${serverCount} MCP servers configured in .mcp.json`
+          };
+        } else {
+          return {
+            status: 'warn',
+            message: 'No mcpServers found in .mcp.json'
+          };
+        }
+      } catch (error) {
+        return {
+          status: 'fail',
+          message: 'Invalid JSON syntax in .mcp.json'
+        };
+      }
+    } else {
+      return {
+        status: 'warn',
+        message: 'No project MCP configuration found (.mcp.json)'
+      };
+    }
+  }
+
+  checkMCPConfigurationSyntax() {
+    const configPaths = [
+      path.join(process.cwd(), '.mcp.json')
+    ];
+    
+    let totalServers = 0;
+    let validServers = 0;
+    let invalidServers = 0;
+    const issues = [];
+    
+    for (const configPath of configPaths) {
+      if (fs.existsSync(configPath)) {
+        try {
+          const mcpConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+          
+          if (mcpConfig.mcpServers && typeof mcpConfig.mcpServers === 'object') {
+            const servers = mcpConfig.mcpServers;
+            
+            for (const [serverName, serverConfig] of Object.entries(servers)) {
+              totalServers++;
+              
+              // Validate server configuration structure
+              if (!serverConfig || typeof serverConfig !== 'object') {
+                invalidServers++;
+                issues.push(`Invalid server config for ${serverName} in ${path.basename(configPath)}`);
+                continue;
+              }
+              
+              // Check required fields
+              if (!serverConfig.command) {
+                invalidServers++;
+                issues.push(`Missing command for ${serverName} in ${path.basename(configPath)}`);
+                continue;
+              }
+              
+              // Optional: Check if args is array when present
+              if (serverConfig.args && !Array.isArray(serverConfig.args)) {
+                invalidServers++;
+                issues.push(`Invalid args format for ${serverName} in ${path.basename(configPath)} (should be array)`);
+                continue;
+              }
+              
+              // Optional: Check if env is object when present
+              if (serverConfig.env && typeof serverConfig.env !== 'object') {
+                invalidServers++;
+                issues.push(`Invalid env format for ${serverName} in ${path.basename(configPath)} (should be object)`);
+                continue;
+              }
+              
+              validServers++;
+            }
+          }
+        } catch (error) {
+          // JSON parsing error already handled in other checks
+        }
+      }
+    }
+    
+    if (totalServers === 0) {
+      return {
+        status: 'warn',
+        message: 'No MCP servers configured'
+      };
+    }
+    
+    if (invalidServers === 0) {
+      return {
+        status: 'pass',
+        message: `All ${totalServers} MCP server configurations are valid`
+      };
+    } else if (validServers > 0) {
+      return {
+        status: 'warn',
+        message: `${validServers}/${totalServers} MCP servers valid, ${invalidServers} issues found`
+      };
+    } else {
+      return {
+        status: 'fail',
+        message: `All ${totalServers} MCP server configurations have issues`
+      };
+    }
+  }
+
   checkProjectCommands() {
     const currentDir = process.cwd();
     const commandsDir = path.join(currentDir, '.claude', 'commands');
@@ -625,6 +800,129 @@ class HealthChecker {
     }
   }
 
+  checkProjectAgents() {
+    const currentDir = process.cwd();
+    const agentsDir = path.join(currentDir, '.claude', 'agents');
+    
+    if (fs.existsSync(agentsDir)) {
+      const agents = this.countAgentsRecursively(agentsDir);
+      return {
+        status: 'pass',
+        message: `${agents} agents found in .claude/agents/`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: 'No project agents directory found'
+      };
+    }
+  }
+
+  checkPersonalAgents() {
+    const homeDir = os.homedir();
+    const agentsDir = path.join(homeDir, '.claude', 'agents');
+    
+    if (fs.existsSync(agentsDir)) {
+      const agents = this.countAgentsRecursively(agentsDir);
+      return {
+        status: 'pass',
+        message: `${agents} agents found in ~/.claude/agents/`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: 'No personal agents directory found'
+      };
+    }
+  }
+
+  countAgentsRecursively(dir) {
+    let count = 0;
+    try {
+      const items = fs.readdirSync(dir);
+      for (const item of items) {
+        const itemPath = path.join(dir, item);
+        const stat = fs.statSync(itemPath);
+        if (stat.isDirectory()) {
+          count += this.countAgentsRecursively(itemPath);
+        } else if (item.endsWith('.md')) {
+          count++;
+        }
+      }
+    } catch (error) {
+      // Handle permission or access errors
+    }
+    return count;
+  }
+
+  checkAgentSyntax() {
+    const currentDir = process.cwd();
+    const agentsDir = path.join(currentDir, '.claude', 'agents');
+    
+    if (!fs.existsSync(agentsDir)) {
+      return {
+        status: 'warn',
+        message: 'No agents to validate'
+      };
+    }
+    
+    const agents = this.getAgentFilesRecursively(agentsDir);
+    let issuesFound = 0;
+    let agentsChecked = 0;
+    
+    for (const agentPath of agents) {
+      try {
+        const content = fs.readFileSync(agentPath, 'utf8');
+        agentsChecked++;
+        
+        // Check for frontmatter (agent metadata)
+        if (!content.includes('---') || !content.includes('name:') || !content.includes('description:')) {
+          issuesFound++;
+        }
+      } catch (error) {
+        issuesFound++;
+      }
+    }
+    
+    if (agentsChecked === 0) {
+      return {
+        status: 'warn',
+        message: 'No agents to validate'
+      };
+    }
+    
+    if (issuesFound === 0) {
+      return {
+        status: 'pass',
+        message: `All ${agentsChecked} agents have proper syntax`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: `${issuesFound}/${agentsChecked} agents missing proper frontmatter`
+      };
+    }
+  }
+
+  getAgentFilesRecursively(dir) {
+    let files = [];
+    try {
+      const items = fs.readdirSync(dir);
+      for (const item of items) {
+        const itemPath = path.join(dir, item);
+        const stat = fs.statSync(itemPath);
+        if (stat.isDirectory()) {
+          files = files.concat(this.getAgentFilesRecursively(itemPath));
+        } else if (item.endsWith('.md')) {
+          files.push(itemPath);
+        }
+      }
+    } catch (error) {
+      // Handle permission or access errors
+    }
+    return files;
+  }
+
   checkUserHooks() {
     const homeDir = os.homedir();
     const settingsPath = path.join(homeDir, '.claude', 'settings.json');
@@ -1041,7 +1339,9 @@ class HealthChecker {
       ...this.results.system,
       ...this.results.claudeCode,
       ...this.results.project,
+      ...this.results.agents,
       ...this.results.commands,
+      ...this.results.mcps,
       ...this.results.hooks
     ];
     
@@ -1052,6 +1352,16 @@ class HealthChecker {
           recommendations.push('Consider switching to Zsh for better autocompletion and features');
         } else if (result.check === 'Command Syntax' && result.message.includes('$ARGUMENTS')) {
           recommendations.push('Add $ARGUMENTS placeholder to command files for proper parameter handling');
+        } else if (result.check === 'Agent Syntax' && result.message.includes('frontmatter')) {
+          recommendations.push('Add proper frontmatter (name, description) to agent files');
+        } else if (result.check === 'Project Agents' && result.message.includes('No project agents directory')) {
+          recommendations.push('Create .claude/agents/ directory to organize your custom agents');
+        } else if (result.check === 'Project MCP Config' && result.message.includes('No project MCP configuration')) {
+          recommendations.push('Create .mcp.json file to configure MCP servers for your project');
+        } else if (result.check === 'MCP Config Syntax' && result.message.includes('Invalid JSON')) {
+          recommendations.push('Fix JSON syntax errors in MCP configuration files');
+        } else if (result.check === 'MCP Config Syntax' && result.message.includes('Missing command')) {
+          recommendations.push('Add missing command fields to MCP server configurations');
         } else if (result.check === 'Local Hooks' && result.message.includes('Invalid JSON')) {
           recommendations.push('Fix JSON syntax error in .claude/settings.local.json');
         }

package/src/index.js

@@ -271,7 +271,7 @@ async function createClaudeConfig(options = {}) {
   console.log(chalk.white('  3. Start using Claude Code with: claude'));
   console.log('');
   console.log(chalk.blue('🌐 View all available templates at: https://aitmpl.com/'));
-  console.log(chalk.blue('📖 Read the complete documentation at: https://aitmpl.com/docu/'));
+  console.log(chalk.blue('📖 Read the complete documentation at: https://docs.aitmpl.com/'));
   
   if (config.language !== 'common') {
     console.log(chalk.yellow(`💡 Language-specific features for ${config.language} have been configured`));