claude-code-templates 1.8.3 → 1.10.0

package/README.md

@@ -28,6 +28,16 @@ Monitor and optimize your Claude Code agents with our comprehensive analytics da
 - **Performance Monitoring**: Track Claude Code agent performance and optimization opportunities
 - **Web Interface**: Clean, terminal-style dashboard at `http://localhost:3333`
 
+### 🔍 Comprehensive Health Check
+Complete system validation and configuration verification:
+- **System Requirements**: Validate OS, Node.js, memory, and network connectivity
+- **Claude Code Setup**: Verify installation, authentication, and permissions
+- **Project Configuration**: Check project structure and configuration files
+- **Custom Commands**: Validate slash commands and syntax
+- **Hooks Configuration**: Verify automation hooks and command availability
+- **Interactive Results**: Real-time progress with immediate feedback and recommendations
+- **Health Score**: Overall system health percentage with actionable insights
+
 ### 📋 Smart Project Setup
 Intelligent project configuration with framework-specific commands:
 - **Auto-Detection**: Automatically detect your project type and suggest optimal configurations
@@ -59,7 +69,7 @@ Intelligent project configuration with framework-specific commands:
 ```bash
 cd my-react-app
 npx claude-code-templates
-# Choose between Analytics Dashboard or Project Setup
+# Choose between Analytics Dashboard, Health Check, or Project Setup
 ```
 
 ### Analytics Dashboard
@@ -68,6 +78,15 @@ npx claude-code-templates
 npx claude-code-templates --analytics
 ```
 
+### Health Check
+```bash
+# Run comprehensive system validation
+npx claude-code-templates --health-check
+npx claude-code-templates --health
+npx claude-code-templates --check
+npx claude-code-templates --verify
+```
+
 ### Framework-Specific Quick Setup
 ```bash
 # React + TypeScript project
@@ -109,6 +128,10 @@ npx create-claude-config     # Create-style command
 | `-y, --yes` | Skip prompts and use defaults | `--yes` |
 | `--dry-run` | Show what would be installed | `--dry-run` |
 | `--analytics` | Launch real-time analytics dashboard | `--analytics` |
+| `--health-check` | Run comprehensive system validation | `--health-check` |
+| `--health` | Run system health check (alias) | `--health` |
+| `--check` | Run system validation (alias) | `--check` |
+| `--verify` | Verify system configuration (alias) | `--verify` |
 | `--commands-stats` | Analyze existing commands | `--commands-stats` |
 | `--hooks-stats` | Analyze automation hooks | `--hooks-stats` |
 | `--mcps-stats` | Analyze MCP server configurations | `--mcps-stats` |

package/bin/create-claude-config.js

@@ -3,7 +3,7 @@
 const { program } = require('commander');
 const chalk = require('chalk');
 const boxen = require('boxen');
-const createClaudeConfig = require('../src/index');
+const { createClaudeConfig } = require('../src/index');
 
 // ASCII Art for Claude Code Templates
 const banner = chalk.hex('#D97706')(`
@@ -45,6 +45,7 @@ program
   .option('--hook-stats, --hooks-stats', 'analyze existing automation hooks and offer optimization')
   .option('--mcp-stats, --mcps-stats', 'analyze existing MCP server configurations and offer optimization')
   .option('--analytics', 'launch real-time Claude Code analytics dashboard')
+  .option('--health-check, --health, --check, --verify', 'run comprehensive health check to verify Claude Code setup')
   .action(async (options) => {
     try {
       await createClaudeConfig(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.8.3",
+  "version": "1.10.0",
   "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": {
@@ -31,7 +31,7 @@
     "dev:link": "npm link",
     "dev:unlink": "npm unlink -g claude-code-templates",
     "pretest:commands": "npm run dev:link",
-    "prepublishOnly-disabled": "npm run test:coverage",
+    "prepublishOnly": "echo 'Skipping tests for Health Check release'",
     "analytics:start": "node src/analytics.js",
     "analytics:test": "npm run test:analytics"
   },

package/src/analytics/core/ConversationAnalyzer.js

@@ -110,6 +110,9 @@ class ConversationAnalyzer {
           const tokenUsage = await this.getCachedTokenUsage(filePath, parsedMessages);
           const modelInfo = await this.getCachedModelInfo(filePath, parsedMessages);
 
+          // Calculate tool usage data with caching
+          const toolUsage = await this.getCachedToolUsage(filePath, parsedMessages);
+
           const conversation = {
             id: filename.replace('.jsonl', ''),
             filename: filename,
@@ -121,6 +124,7 @@ class ConversationAnalyzer {
             tokens: tokenUsage.total > 0 ? tokenUsage.total : this.estimateTokens(await this.getFileContent(filePath)),
             tokenUsage: tokenUsage,
             modelInfo: modelInfo,
+            toolUsage: toolUsage,
             project: projectFromPath || this.extractProjectFromConversation(parsedMessages),
             status: stateCalculator.determineConversationStatus(parsedMessages, stats.mtime),
             conversationState: stateCalculator.determineConversationState(parsedMessages, stats.mtime),
@@ -279,6 +283,21 @@ class ConversationAnalyzer {
     return this.generateStatusSquares(parsedMessages);
   }
 
+  /**
+   * Get cached tool usage analysis
+   * @param {string} filepath - File path
+   * @param {Array} parsedMessages - Parsed messages array
+   * @returns {Promise<Object>} Tool usage data
+   */
+  async getCachedToolUsage(filepath, parsedMessages) {
+    if (this.dataCache) {
+      return await this.dataCache.getCachedToolUsage(filepath, () => {
+        return this.extractToolUsage(parsedMessages);
+      });
+    }
+    return this.extractToolUsage(parsedMessages);
+  }
+
   /**
    * Calculate real token usage from message usage data
    * @param {Array} parsedMessages - Array of parsed message objects
@@ -387,6 +406,65 @@ class ConversationAnalyzer {
     return 'Unknown';
   }
 
+  /**
+   * Extract tool usage statistics from parsed messages
+   * @param {Array} parsedMessages - Array of parsed message objects
+   * @returns {Object} Tool usage statistics
+   */
+  extractToolUsage(parsedMessages) {
+    const toolStats = {};
+    const toolTimeline = [];
+    let totalToolCalls = 0;
+
+    parsedMessages.forEach(message => {
+      if (message.role === 'assistant' && message.content) {
+        const content = message.content;
+        const timestamp = message.timestamp;
+
+        // Handle string content with tool indicators
+        if (typeof content === 'string') {
+          const toolMatches = content.match(/\[Tool:\s*([^\]]+)\]/g);
+          if (toolMatches) {
+            toolMatches.forEach(match => {
+              const toolName = match.replace(/\[Tool:\s*([^\]]+)\]/, '$1').trim();
+              toolStats[toolName] = (toolStats[toolName] || 0) + 1;
+              totalToolCalls++;
+              toolTimeline.push({
+                tool: toolName,
+                timestamp: timestamp,
+                type: 'usage'
+              });
+            });
+          }
+        }
+
+        // Handle array content with tool_use blocks
+        if (Array.isArray(content)) {
+          content.forEach(block => {
+            if (block.type === 'tool_use') {
+              const toolName = block.name || 'Unknown Tool';
+              toolStats[toolName] = (toolStats[toolName] || 0) + 1;
+              totalToolCalls++;
+              toolTimeline.push({
+                tool: toolName,
+                timestamp: timestamp,
+                type: 'usage',
+                parameters: block.input || {}
+              });
+            }
+          });
+        }
+      }
+    });
+
+    return {
+      toolStats,
+      toolTimeline: toolTimeline.sort((a, b) => new Date(a.timestamp) - new Date(b.timestamp)),
+      totalToolCalls,
+      uniqueTools: Object.keys(toolStats).length
+    };
+  }
+
   /**
    * Generate status indicators for conversation messages
    * @param {Array} messages - Array of message objects

package/src/analytics/data/DataCache.js

@@ -19,6 +19,7 @@ class DataCache {
       tokenUsage: new Map(), // filepath -> { usage, timestamp }
       modelInfo: new Map(), // filepath -> { info, timestamp }
       statusSquares: new Map(), // filepath -> { squares, timestamp }
+      toolUsage: new Map(), // filepath -> { usage, timestamp }
       
       // Expensive computations cache
       sessions: { data: null, timestamp: 0, dependencies: new Set() },
@@ -319,6 +320,32 @@ class DataCache {
     return squares;
   }
 
+  /**
+   * Cache tool usage analysis
+   * @param {string} filepath - File path
+   * @param {Function} extractFn - Tool usage extraction function
+   * @returns {Promise<Object>} Tool usage data
+   */
+  async getCachedToolUsage(filepath, extractFn) {
+    const cached = this.caches.toolUsage.get(filepath);
+    const fileStats = await this.getFileStats(filepath);
+    
+    if (cached && cached.timestamp >= fileStats.mtime.getTime()) {
+      this.metrics.hits++;
+      return cached.usage;
+    }
+    
+    this.metrics.misses++;
+    const usage = await extractFn();
+    
+    this.caches.toolUsage.set(filepath, {
+      usage,
+      timestamp: fileStats.mtime.getTime()
+    });
+    
+    return usage;
+  }
+
   /**
    * Smart invalidation based on file changes
    * @param {string} filepath - Path of changed file
@@ -332,6 +359,7 @@ class DataCache {
     this.caches.tokenUsage.delete(filepath);
     this.caches.modelInfo.delete(filepath);
     this.caches.statusSquares.delete(filepath);
+    this.caches.toolUsage.delete(filepath);
     this.caches.fileStats.delete(filepath);
     
     // Invalidate computations that depend on this file
@@ -450,6 +478,7 @@ class DataCache {
       ['tokenUsage', this.caches.tokenUsage],
       ['modelInfo', this.caches.modelInfo],
       ['statusSquares', this.caches.statusSquares],
+      ['toolUsage', this.caches.toolUsage],
       ['fileStats', this.caches.fileStats],
       ['projectStats', this.caches.projectStats]
     ];
@@ -507,6 +536,7 @@ class DataCache {
         tokenUsage: this.caches.tokenUsage.size,
         modelInfo: this.caches.modelInfo.size,
         statusSquares: this.caches.statusSquares.size,
+        toolUsage: this.caches.toolUsage.size,
         fileStats: this.caches.fileStats.size,
         projectStats: this.caches.projectStats.size,
       },