claude-code-templates 1.17.0 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.17.0",
+  "version": "1.18.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": {

package/src/index.js

@@ -586,17 +586,99 @@ async function installIndividualSetting(settingName, targetDir, options) {
       delete settingConfig.description;
     }
     
-    // Check if .claude/settings.json exists in target directory
+    // Ask user where to install the setting (unless in silent mode)
+    let settingsFile = 'settings.json'; // default
+    if (!options.silent) {
+      const inquirer = require('inquirer');
+      const { installLocation } = await inquirer.prompt([{
+        type: 'list',
+        name: 'installLocation',
+        message: 'Where would you like to install this setting?',
+        choices: [
+          {
+            name: '🏠 User settings (~/.claude/settings.json) - Applies to all projects',
+            value: 'user'
+          },
+          {
+            name: '📁 Project settings (.claude/settings.json) - Shared with team',
+            value: 'project'
+          },
+          {
+            name: '⚙️  Local settings (.claude/settings.local.json) - Personal, not committed',
+            value: 'local'
+          },
+          {
+            name: '🏢 Enterprise managed settings - System-wide policy (requires admin)',
+            value: 'enterprise'
+          }
+        ],
+        default: 'local'
+      }]);
+
+      if (installLocation === 'user') {
+        const os = require('os');
+        targetDir = os.homedir();
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'project') {
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'local') {
+        settingsFile = 'settings.local.json';
+      } else if (installLocation === 'enterprise') {
+        const os = require('os');
+        const platform = os.platform();
+        
+        if (platform === 'darwin') {
+          // macOS
+          targetDir = '/Library/Application Support/ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'linux' || (process.platform === 'win32' && process.env.WSL_DISTRO_NAME)) {
+          // Linux and WSL
+          targetDir = '/etc/claude-code';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'win32') {
+          // Windows
+          targetDir = 'C:\\ProgramData\\ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else {
+          console.log(chalk.yellow('⚠️  Platform not supported for enterprise settings. Using user settings instead.'));
+          const os = require('os');
+          targetDir = os.homedir();
+          settingsFile = 'settings.json';
+        }
+        
+        console.log(chalk.yellow(`⚠️  Enterprise settings require administrator privileges.`));
+        console.log(chalk.gray(`📍 Target path: ${path.join(targetDir, settingsFile)}`));
+      }
+    }
+    
+    // Determine target directory and file based on selection
     const claudeDir = path.join(targetDir, '.claude');
-    const targetSettingsFile = path.join(claudeDir, 'settings.json');
+    const targetSettingsFile = path.join(claudeDir, settingsFile);
     let existingConfig = {};
     
-    // Ensure .claude directory exists
-    await fs.ensureDir(claudeDir);
+    // For enterprise settings, create directory structure directly (not under .claude)
+    if (settingsFile === 'managed-settings.json') {
+      // Ensure enterprise directory exists (requires admin privileges)
+      try {
+        await fs.ensureDir(targetDir);
+      } catch (error) {
+        console.log(chalk.red(`❌ Failed to create enterprise directory: ${error.message}`));
+        console.log(chalk.yellow('💡 Try running with administrator privileges or choose a different installation location.'));
+        return;
+      }
+    } else {
+      // Ensure .claude directory exists for regular settings
+      await fs.ensureDir(claudeDir);
+    }
     
-    if (await fs.pathExists(targetSettingsFile)) {
-      existingConfig = await fs.readJson(targetSettingsFile);
-      console.log(chalk.yellow('📝 Existing .claude/settings.json found, merging configurations...'));
+    // Read existing configuration
+    const actualTargetFile = settingsFile === 'managed-settings.json' 
+      ? path.join(targetDir, settingsFile)
+      : targetSettingsFile;
+      
+    if (await fs.pathExists(actualTargetFile)) {
+      existingConfig = await fs.readJson(actualTargetFile);
+      console.log(chalk.yellow(`📝 Existing ${settingsFile} found, merging configurations...`));
     }
     
     // Check for conflicts before merging
@@ -680,11 +762,11 @@ async function installIndividualSetting(settingName, targetDir, options) {
     }
     
     // Write the merged configuration
-    await fs.writeJson(targetSettingsFile, mergedConfig, { spaces: 2 });
+    await fs.writeJson(actualTargetFile, mergedConfig, { spaces: 2 });
     
     if (!options.silent) {
       console.log(chalk.green(`✅ Setting "${settingName}" installed successfully!`));
-      console.log(chalk.cyan(`📁 Configuration merged into: ${path.relative(targetDir, targetSettingsFile)}`));
+      console.log(chalk.cyan(`📁 Configuration merged into: ${actualTargetFile}`));
       console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
     }
     
@@ -734,35 +816,107 @@ async function installIndividualHook(hookName, targetDir, options) {
       delete hookConfig.description;
     }
     
-    // Check if .claude/settings.json exists in target directory (hooks go in settings.json)
+    // Ask user where to install the hook (unless in silent mode)
+    let settingsFile = 'settings.json'; // default
+    if (!options.silent) {
+      const inquirer = require('inquirer');
+      const { installLocation } = await inquirer.prompt([{
+        type: 'list',
+        name: 'installLocation',
+        message: 'Where would you like to install this hook?',
+        choices: [
+          {
+            name: '🏠 User settings (~/.claude/settings.json) - Applies to all projects',
+            value: 'user'
+          },
+          {
+            name: '📁 Project settings (.claude/settings.json) - Shared with team',
+            value: 'project'
+          },
+          {
+            name: '⚙️  Local settings (.claude/settings.local.json) - Personal, not committed',
+            value: 'local'
+          },
+          {
+            name: '🏢 Enterprise managed settings - System-wide policy (requires admin)',
+            value: 'enterprise'
+          }
+        ],
+        default: 'local'
+      }]);
+
+      if (installLocation === 'user') {
+        const os = require('os');
+        targetDir = os.homedir();
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'project') {
+        settingsFile = 'settings.json';
+      } else if (installLocation === 'local') {
+        settingsFile = 'settings.local.json';
+      } else if (installLocation === 'enterprise') {
+        const os = require('os');
+        const platform = os.platform();
+        
+        if (platform === 'darwin') {
+          // macOS
+          targetDir = '/Library/Application Support/ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'linux' || (process.platform === 'win32' && process.env.WSL_DISTRO_NAME)) {
+          // Linux and WSL
+          targetDir = '/etc/claude-code';
+          settingsFile = 'managed-settings.json';
+        } else if (platform === 'win32') {
+          // Windows
+          targetDir = 'C:\\ProgramData\\ClaudeCode';
+          settingsFile = 'managed-settings.json';
+        } else {
+          console.log(chalk.yellow('⚠️  Platform not supported for enterprise settings. Using user settings instead.'));
+          const os = require('os');
+          targetDir = os.homedir();
+          settingsFile = 'settings.json';
+        }
+        
+        console.log(chalk.yellow(`⚠️  Enterprise settings require administrator privileges.`));
+        console.log(chalk.gray(`📍 Target path: ${path.join(targetDir, settingsFile)}`));
+      }
+    }
+    
+    // Determine target directory and file based on selection
     const claudeDir = path.join(targetDir, '.claude');
-    const targetSettingsFile = path.join(claudeDir, 'settings.json');
+    const targetSettingsFile = path.join(claudeDir, settingsFile);
     let existingConfig = {};
     
-    // Ensure .claude directory exists
-    await fs.ensureDir(claudeDir);
+    // For enterprise settings, create directory structure directly (not under .claude)
+    if (settingsFile === 'managed-settings.json') {
+      // Ensure enterprise directory exists (requires admin privileges)
+      try {
+        await fs.ensureDir(targetDir);
+      } catch (error) {
+        console.log(chalk.red(`❌ Failed to create enterprise directory: ${error.message}`));
+        console.log(chalk.yellow('💡 Try running with administrator privileges or choose a different installation location.'));
+        return;
+      }
+    } else {
+      // Ensure .claude directory exists for regular settings
+      await fs.ensureDir(claudeDir);
+    }
     
-    if (await fs.pathExists(targetSettingsFile)) {
-      existingConfig = await fs.readJson(targetSettingsFile);
-      console.log(chalk.yellow('📝 Existing .claude/settings.json found, merging hook configurations...'));
+    // Read existing configuration
+    const actualTargetFile = settingsFile === 'managed-settings.json' 
+      ? path.join(targetDir, settingsFile)
+      : targetSettingsFile;
+      
+    if (await fs.pathExists(actualTargetFile)) {
+      existingConfig = await fs.readJson(actualTargetFile);
+      console.log(chalk.yellow(`📝 Existing ${settingsFile} found, merging hook configurations...`));
     }
     
-    // Check for conflicts before merging
+    // Check for conflicts before merging (simplified for new array format)
     const conflicts = [];
     
-    // Check for conflicting hooks
-    if (existingConfig.hooks && hookConfig.hooks) {
-      ['PreToolUse', 'PostToolUse'].forEach(hookType => {
-        if (existingConfig.hooks[hookType] && hookConfig.hooks[hookType]) {
-          Object.keys(hookConfig.hooks[hookType]).forEach(toolName => {
-            if (existingConfig.hooks[hookType][toolName] && 
-                existingConfig.hooks[hookType][toolName] !== hookConfig.hooks[hookType][toolName]) {
-              conflicts.push(`Hook "${hookType}.${toolName}" (current: "${existingConfig.hooks[hookType][toolName]}", new: "${hookConfig.hooks[hookType][toolName]}")`);
-            }
-          });
-        }
-      });
-    }
+    // For the new array format, we'll allow appending rather than conflict detection
+    // This is because Claude Code's array format naturally supports multiple hooks
+    // Conflicts are less likely and generally hooks can coexist
     
     // Ask user about conflicts if any exist and not in silent mode
     if (conflicts.length > 0 && !options.silent) {
@@ -787,36 +941,57 @@ async function installIndividualHook(hookName, targetDir, options) {
       return;
     }
     
-    // Deep merge configurations
+    // Deep merge configurations with proper hook array structure
     const mergedConfig = {
-      ...existingConfig,
-      ...hookConfig
+      ...existingConfig
     };
     
-    // Deep merge hooks specifically (only if no conflicts or user approved overwrite)
-    if (existingConfig.hooks && hookConfig.hooks) {
-      mergedConfig.hooks = {
-        ...existingConfig.hooks,
-        ...hookConfig.hooks
-      };
-      
-      // Deep merge hook types (PreToolUse, PostToolUse)
-      ['PreToolUse', 'PostToolUse'].forEach(hookType => {
-        if (existingConfig.hooks[hookType] && hookConfig.hooks[hookType]) {
-          mergedConfig.hooks[hookType] = {
-            ...existingConfig.hooks[hookType],
-            ...hookConfig.hooks[hookType]
-          };
+    // Initialize hooks structure if it doesn't exist
+    if (!mergedConfig.hooks) {
+      mergedConfig.hooks = {};
+    }
+    
+    // Merge hook configurations properly (Claude Code expects arrays)
+    if (hookConfig.hooks) {
+      Object.keys(hookConfig.hooks).forEach(hookType => {
+        if (!mergedConfig.hooks[hookType]) {
+          // If hook type doesn't exist, just copy the array
+          mergedConfig.hooks[hookType] = hookConfig.hooks[hookType];
+        } else {
+          // If hook type exists, append to the array (Claude Code format)
+          if (Array.isArray(hookConfig.hooks[hookType])) {
+            // New format: array of hook objects
+            if (!Array.isArray(mergedConfig.hooks[hookType])) {
+              // Convert old format to new format
+              mergedConfig.hooks[hookType] = [];
+            }
+            // Append new hooks to existing array
+            mergedConfig.hooks[hookType] = mergedConfig.hooks[hookType].concat(hookConfig.hooks[hookType]);
+          } else {
+            // Old format compatibility: convert to new format
+            console.log(chalk.yellow(`⚠️  Converting old hook format to new Claude Code format for ${hookType}`));
+            if (!Array.isArray(mergedConfig.hooks[hookType])) {
+              mergedConfig.hooks[hookType] = [];
+            }
+            // Add old format hook as a single matcher
+            mergedConfig.hooks[hookType].push({
+              matcher: "*",
+              hooks: [{
+                type: "command",
+                command: hookConfig.hooks[hookType]
+              }]
+            });
+          }
         }
       });
     }
     
     // Write the merged configuration
-    await fs.writeJson(targetSettingsFile, mergedConfig, { spaces: 2 });
+    await fs.writeJson(actualTargetFile, mergedConfig, { spaces: 2 });
     
     if (!options.silent) {
       console.log(chalk.green(`✅ Hook "${hookName}" installed successfully!`));
-      console.log(chalk.cyan(`📁 Configuration merged into: ${path.relative(targetDir, targetSettingsFile)}`));
+      console.log(chalk.cyan(`📁 Configuration merged into: ${actualTargetFile}`));
       console.log(chalk.cyan(`📦 Downloaded from: ${githubUrl}`));
     }