claude-code-templates 1.21.0 → 1.21.1

package/cli-tool/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "claude-code-templates",
+  "version": "1.21.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": {
+    "create-claude-config": "bin/create-claude-config.js",
+    "claude-code-templates": "bin/create-claude-config.js",
+    "claude-code-template": "bin/create-claude-config.js",
+    "claude-init": "bin/create-claude-config.js",
+    "cctemplates": "bin/create-claude-config.js",
+    "cct": "bin/create-claude-config.js",
+    "claude-setup": "bin/create-claude-config.js",
+    "claude-config": "bin/create-claude-config.js"
+  },
+  "scripts": {
+    "start": "node bin/create-claude-config.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:e2e": "jest tests/e2e",
+    "test:analytics": "jest --testPathPattern=analytics",
+    "test:commands": "./test-commands.sh",
+    "test:detailed": "./test-detailed.sh",
+    "test:react": "make test-react",
+    "test:vue": "make test-vue",
+    "test:node": "make test-node",
+    "test:all": "npm run test:coverage && make test",
+    "dev:link": "npm link",
+    "dev:unlink": "npm unlink -g claude-code-templates",
+    "pretest:commands": "npm run dev:link",
+    "analytics:start": "node src/analytics.js",
+    "analytics:test": "npm run test:analytics"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "configuration",
+    "template",
+    "setup",
+    "cli",
+    "hooks",
+    "automation",
+    "javascript",
+    "typescript",
+    "react",
+    "vue",
+    "angular",
+    "nodejs",
+    "python",
+    "django",
+    "flask",
+    "fastapi",
+    "rust",
+    "go"
+  ],
+  "author": "Claude Code Templates",
+  "license": "MIT",
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.5.3",
+    "commander": "^11.1.0",
+    "express": "^4.18.2",
+    "fs-extra": "^11.1.1",
+    "inquirer": "^8.2.6",
+    "open": "^8.4.2",
+    "ora": "^5.4.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.3"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davila7/claude-code-templates.git"
+  },
+  "bugs": {
+    "url": "https://github.com/davila7/claude-code-templates/issues"
+  },
+  "homepage": "https://github.com/davila7/claude-code-templates#readme",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "devDependencies": {
+    "jest": "^30.0.4",
+    "jest-watch-typeahead": "^3.0.1"
+  }
+}

package/{src → cli-tool/src}/index.js

@@ -1218,8 +1218,65 @@ function extractFrameworkFromAgent(content, agentName) {
  */
 async function getAvailableAgentsFromGitHub() {
   try {
+    // First try to use local components.json file which has all agents cached
+    const fs = require('fs');
+    const path = require('path');
+    const componentsPath = path.join(__dirname, '../../docs/components.json');
+    
+    if (fs.existsSync(componentsPath)) {
+      const componentsData = JSON.parse(fs.readFileSync(componentsPath, 'utf8'));
+      
+      if (componentsData.agents && Array.isArray(componentsData.agents)) {
+        const agents = [];
+        
+        for (const agent of componentsData.agents) {
+          // Extract category from path
+          const pathParts = agent.path.split('/');
+          const category = pathParts.length > 1 ? pathParts[0] : 'root';
+          const name = pathParts[pathParts.length - 1];
+          
+          agents.push({
+            name: name,
+            path: agent.path,
+            category: category
+          });
+        }
+        
+        console.log(chalk.green(`✅ Loaded ${agents.length} agents from local cache`));
+        return agents;
+      }
+    }
+    
+    // Fallback to GitHub API if local file not found
+    console.log(chalk.yellow('⚠️  Local components.json not found, using GitHub API...'));
+    
     const response = await fetch('https://api.github.com/repos/davila7/claude-code-templates/contents/cli-tool/components/agents');
     if (!response.ok) {
+      // Check for rate limit error
+      if (response.status === 403) {
+        const responseText = await response.text();
+        if (responseText.includes('rate limit')) {
+          console.log(chalk.red('❌ GitHub API rate limit exceeded'));
+          console.log(chalk.yellow('💡 Install locally with: npm install -g claude-code-templates'));
+          
+          // Return comprehensive fallback list
+          return [
+            { name: 'frontend-developer', path: 'development-team/frontend-developer', category: 'development-team' },
+            { name: 'backend-developer', path: 'development-team/backend-developer', category: 'development-team' },
+            { name: 'fullstack-developer', path: 'development-team/fullstack-developer', category: 'development-team' },
+            { name: 'devops-engineer', path: 'development-team/devops-engineer', category: 'development-team' },
+            { name: 'nextjs-architecture-expert', path: 'web-tools/nextjs-architecture-expert', category: 'web-tools' },
+            { name: 'react-developer', path: 'web-tools/react-developer', category: 'web-tools' },
+            { name: 'vue-developer', path: 'web-tools/vue-developer', category: 'web-tools' },
+            { name: 'data-scientist', path: 'data-analytics/data-scientist', category: 'data-analytics' },
+            { name: 'data-analyst', path: 'data-analytics/data-analyst', category: 'data-analytics' },
+            { name: 'security-auditor', path: 'security/security-auditor', category: 'security' },
+            { name: 'api-security-audit', path: 'api-security-audit', category: 'root' },
+            { name: 'database-optimization', path: 'database-optimization', category: 'root' },
+            { name: 'react-performance-optimization', path: 'react-performance-optimization', category: 'root' }
+          ];
+        }
+      }
       throw new Error(`GitHub API error: ${response.status}`);
     }
     
@@ -1258,9 +1315,12 @@ async function getAvailableAgentsFromGitHub() {
     
     return agents;
   } catch (error) {
-    console.warn('Warning: Could not fetch agents from GitHub, using fallback list');
-    // Fallback to basic list if GitHub API fails
+    console.warn('Warning: Could not fetch agents, using fallback list');
+    // Comprehensive fallback list if all methods fail
     return [
+      { name: 'frontend-developer', path: 'development-team/frontend-developer', category: 'development-team' },
+      { name: 'backend-developer', path: 'development-team/backend-developer', category: 'development-team' },
+      { name: 'fullstack-developer', path: 'development-team/fullstack-developer', category: 'development-team' },
       { name: 'api-security-audit', path: 'api-security-audit', category: 'root' },
       { name: 'database-optimization', path: 'database-optimization', category: 'root' },
       { name: 'react-performance-optimization', path: 'react-performance-optimization', category: 'root' }
@@ -2146,39 +2206,47 @@ async function executeSandbox(options, targetDir) {
     
     console.log(chalk.blue('\n🤖 Agent Selection'));
     console.log(chalk.cyan('═══════════════════════════════════════'));
-    console.log(chalk.gray('Select an agent for your task, or continue without one.\n'));
+    console.log(chalk.gray('Select one or more agents for your task (use SPACE to select, ENTER to confirm).\n'));
     
     // Fetch available agents
     console.log(chalk.gray('⏳ Fetching available agents...'));
     const agents = await getAvailableAgentsFromGitHub();
     
-    // Format agents for selection
+    // Format agents for selection with full path
     const agentChoices = agents.map(a => ({
       name: `${a.path} ${chalk.gray(`- ${a.category}`)}`,
-      value: a.path,
+      value: a.path,  // This already includes folder/agent-name format
       short: a.path
     }));
     
-    // Add option to continue without agent
-    agentChoices.unshift({
-      name: chalk.yellow('⚡ Continue without agent (use default Claude)'),
-      value: null,
-      short: 'No agent'
-    });
-    
-    const { selectedAgent } = await inquirer.prompt([{
-      type: 'list',
-      name: 'selectedAgent',
-      message: 'Select an agent for your task:',
-      choices: agentChoices,
-      pageSize: 15
+    // First ask if they want to select agents
+    const { wantAgents } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'wantAgents',
+      message: 'Do you want to select specific agents for this task?',
+      default: true
     }]);
     
-    if (selectedAgent) {
-      agent = selectedAgent;
-      console.log(chalk.green(`✅ Selected agent: ${chalk.cyan(agent)}`));
+    if (wantAgents) {
+      const { selectedAgents } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'selectedAgents',
+        message: 'Select agents (use SPACE to select, ENTER when done):',
+        choices: agentChoices,
+        pageSize: 15
+        // Removed validation - allow empty selection
+      }]);
+      
+      if (selectedAgents && selectedAgents.length > 0) {
+        // Join multiple agents with comma
+        agent = selectedAgents.join(',');
+        console.log(chalk.green(`✅ Selected agents: ${chalk.cyan(selectedAgents.join(', '))}`));
+      } else {
+        // User didn't select any agents but pressed Enter
+        console.log(chalk.yellow('⚠️ Continuing without specific agents'));
+      }
     } else {
-      console.log(chalk.yellow('⚠️ Continuing without specific agent'));
+      console.log(chalk.yellow('⚠️ Continuing without specific agents'));
     }
   }
   
@@ -2262,7 +2330,20 @@ async function executeSandbox(options, targetDir) {
   // Sandbox execution confirmation
   console.log(chalk.blue('\n☁️ E2B Sandbox Execution'));
   console.log(chalk.cyan('═══════════════════════════════════════'));
-  console.log(chalk.white(`📋 Agent: ${chalk.yellow(agent || 'default')}`));
+  
+  // Display agents properly (handle multiple agents)
+  if (agent) {
+    const agentList = agent.split(',');
+    if (agentList.length > 1) {
+      console.log(chalk.white(`📋 Agents (${agentList.length}):`));
+      agentList.forEach(a => console.log(chalk.yellow(`   • ${a.trim()}`)));
+    } else {
+      console.log(chalk.white(`📋 Agent: ${chalk.yellow(agent)}`));
+    }
+  } else {
+    console.log(chalk.white(`📋 Agent: ${chalk.yellow('default')}`));
+  }
+  
   const truncatedPrompt = prompt.length > 80 ? prompt.substring(0, 80) + '...' : prompt;
   console.log(chalk.white(`💭 Prompt: ${chalk.cyan('"' + truncatedPrompt + '"')}`));
   console.log(chalk.white(`🌐 Provider: ${chalk.green('E2B Cloud')}`));

package/cli-tool/templates/common/.claude/commands/git-workflow.md

@@ -0,0 +1,239 @@
+# Git Workflow Helper
+
+Manage Git workflows with best practices and common operations.
+
+## Purpose
+
+This command helps you perform common Git operations following best practices for collaborative development.
+
+## Usage
+
+```
+/git-workflow
+```
+
+## What this command does
+
+1. **Guides through Git operations** with proper workflow
+2. **Suggests best practices** for commits and branches
+3. **Helps with conflict resolution** and merging
+4. **Provides templates** for commit messages
+5. **Manages branching strategies** (Git Flow, GitHub Flow)
+
+## Common Workflows
+
+### Feature Development
+```bash
+# Create and switch to feature branch
+git checkout -b feature/user-authentication
+
+# Work on your feature
+# ... make changes ...
+
+# Stage and commit changes
+git add .
+git commit -m "feat: add user authentication system
+
+- Implement login/logout functionality
+- Add password validation
+- Create user session management
+- Add authentication middleware"
+
+# Push feature branch
+git push -u origin feature/user-authentication
+
+# Create pull request (via GitHub/GitLab interface)
+```
+
+### Hotfix Workflow
+```bash
+# Create hotfix branch from main
+git checkout main
+git checkout -b hotfix/security-patch
+
+# Fix the issue
+# ... make changes ...
+
+# Commit the fix
+git commit -m "fix: resolve security vulnerability in auth module
+
+- Patch XSS vulnerability in login form
+- Update input validation
+- Add CSRF protection"
+
+# Push and create urgent PR
+git push -u origin hotfix/security-patch
+```
+
+### Sync with Remote
+```bash
+# Update main branch
+git checkout main
+git pull origin main
+
+# Update feature branch with latest main
+git checkout feature/your-feature
+git rebase main
+# OR
+git merge main
+```
+
+## Commit Message Conventions
+
+### Conventional Commits Format
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Common Types
+- **feat**: New feature
+- **fix**: Bug fix
+- **docs**: Documentation changes
+- **style**: Code style changes (formatting, etc.)
+- **refactor**: Code refactoring
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks
+
+### Examples
+```bash
+# Feature
+git commit -m "feat(auth): add OAuth2 integration"
+
+# Bug fix
+git commit -m "fix(api): handle null response in user endpoint"
+
+# Documentation
+git commit -m "docs: update API documentation for v2.0"
+
+# Breaking change
+git commit -m "feat!: change API response format
+
+BREAKING CHANGE: API responses now use 'data' wrapper"
+```
+
+## Branch Management
+
+### Git Flow Strategy
+```bash
+# Main branches
+main        # Production-ready code
+develop     # Integration branch
+
+# Supporting branches
+feature/*   # New features
+release/*   # Release preparation
+hotfix/*    # Quick fixes to production
+```
+
+### GitHub Flow (Simplified)
+```bash
+# Only main branch + feature branches
+main        # Production-ready code
+feature/*   # All new work
+```
+
+## Conflict Resolution
+
+### When Conflicts Occur
+```bash
+# Start merge/rebase
+git merge feature-branch
+# OR
+git rebase main
+
+# If conflicts occur, Git will list conflicted files
+# Edit each file to resolve conflicts
+
+# Mark conflicts as resolved
+git add conflicted-file.js
+
+# Continue the merge/rebase
+git merge --continue
+# OR
+git rebase --continue
+```
+
+### Conflict Markers
+```javascript
+<<<<<<< HEAD
+// Your current branch code
+const user = getCurrentUser();
+=======
+// Incoming branch code
+const user = getAuthenticatedUser();
+>>>>>>> feature-branch
+```
+
+## Useful Git Commands
+
+### Status and Information
+```bash
+git status                    # Check working directory status
+git log --oneline            # View commit history
+git branch -a                # List all branches
+git remote -v                # List remote repositories
+```
+
+### Undoing Changes
+```bash
+git checkout -- file.js     # Discard changes to file
+git reset HEAD file.js       # Unstage file
+git reset --soft HEAD~1     # Undo last commit (keep changes)
+git reset --hard HEAD~1     # Undo last commit (discard changes)
+```
+
+### Stashing Work
+```bash
+git stash                    # Save current work
+git stash pop               # Apply and remove latest stash
+git stash list              # List all stashes
+git stash apply stash@{1}   # Apply specific stash
+```
+
+## Best Practices
+
+1. **Commit Often** - Make small, focused commits
+2. **Write Clear Messages** - Use conventional commit format
+3. **Test Before Committing** - Ensure code works
+4. **Pull Before Push** - Keep history clean
+5. **Use Branches** - Don't work directly on main
+6. **Review Code** - Use pull requests for collaboration
+7. **Keep History Clean** - Rebase feature branches when appropriate
+
+## Git Hooks (Optional)
+
+### Pre-commit Hook
+```bash
+#!/bin/sh
+# .git/hooks/pre-commit
+
+# Run linter
+npm run lint
+if [ $? -ne 0 ]; then
+  echo "Linting failed. Please fix errors before committing."
+  exit 1
+fi
+
+# Run tests
+npm test
+if [ $? -ne 0 ]; then
+  echo "Tests failed. Please fix tests before committing."
+  exit 1
+fi
+```
+
+### Commit Message Hook
+```bash
+#!/bin/sh
+# .git/hooks/commit-msg
+
+# Check commit message format
+if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .{1,50}" "$1"; then
+  echo "Invalid commit message format. Use conventional commits."
+  exit 1
+fi
+```