@champpaba/claude-agent-kit 1.4.1 → 1.4.2

package/bin/cli.js

@@ -1,59 +1,59 @@
-#!/usr/bin/env node
-
-/**
- * Claude Agent Kit - CLI Entry Point
- *
- * This is the main CLI file that handles all commands:
- * - cak init        → Initialize template in current project
- * - cak update      → Update template to latest version
- * - cak --version   → Show version
- * - cak --help      → Show help
- */
-
-const { program } = require('commander');
-const chalk = require('chalk');
-const pkg = require('../package.json');
-
-// Import command handlers
-const initCommand = require('../lib/init');
-const updateCommand = require('../lib/update');
-
-// Configure CLI
-program
-  .name('cak')
-  .description(chalk.cyan('🤖 Claude Agent Kit - Universal Multi-Agent Template'))
-  .version(pkg.version, '-v, --version', 'Show version number');
-
-// Command: cak init
-program
-  .command('init')
-  .description('Initialize Claude Agent Kit template in current project')
-  .action(async (options) => {
-    try {
-      await initCommand(options);
-    } catch (error) {
-      console.error(chalk.red('❌ Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Command: cak update
-program
-  .command('update')
-  .description('Update template files to latest version')
-  .action(async (options) => {
-    try {
-      await updateCommand(options);
-    } catch (error) {
-      console.error(chalk.red('❌ Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Show help if no command provided
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
-}
-
-// Parse command line arguments
-program.parse(process.argv);
+#!/usr/bin/env node
+
+/**
+ * Claude Agent Kit - CLI Entry Point
+ *
+ * This is the main CLI file that handles all commands:
+ * - cak init        → Initialize template in current project
+ * - cak update      → Update template to latest version
+ * - cak --version   → Show version
+ * - cak --help      → Show help
+ */
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const pkg = require('../package.json');
+
+// Import command handlers
+const initCommand = require('../lib/init');
+const updateCommand = require('../lib/update');
+
+// Configure CLI
+program
+  .name('cak')
+  .description(chalk.cyan('🤖 Claude Agent Kit - Universal Multi-Agent Template'))
+  .version(pkg.version, '-v, --version', 'Show version number');
+
+// Command: cak init
+program
+  .command('init')
+  .description('Initialize Claude Agent Kit template in current project')
+  .action(async (options) => {
+    try {
+      await initCommand(options);
+    } catch (error) {
+      console.error(chalk.red('❌ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Command: cak update
+program
+  .command('update')
+  .description('Update template files to latest version')
+  .action(async (options) => {
+    try {
+      await updateCommand(options);
+    } catch (error) {
+      console.error(chalk.red('❌ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}
+
+// Parse command line arguments
+program.parse(process.argv);

package/lib/helpers.js

@@ -28,16 +28,52 @@ async function promptUser(question) {
 }
 
 /**
- * Merge template files into target directory
- * - Overwrites files with same name
+ * Merge template files into target directory with smart comparison
+ * - Only overwrites if content actually differs
  * - Keeps existing files that don't exist in template
+ * - Skips identical files (prevents Git showing unnecessary changes)
  * @param {string} templatePath - Source template directory
  * @param {string} targetPath - Target directory
  */
 async function mergeTemplateFiles(templatePath, targetPath) {
+  const crypto = require('crypto');
+
+  // Helper: Calculate file hash
+  function getFileHash(filePath) {
+    try {
+      const content = fs.readFileSync(filePath);
+      return crypto.createHash('md5').update(content).digest('hex');
+    } catch (error) {
+      return null;
+    }
+  }
+
+  // Custom filter function
+  const filter = (src, dest) => {
+    const srcStat = fs.statSync(src);
+
+    // Always copy directories
+    if (srcStat.isDirectory()) {
+      return true;
+    }
+
+    // If destination doesn't exist, copy it
+    if (!fs.existsSync(dest)) {
+      return true;
+    }
+
+    // Compare file hashes (content-based comparison)
+    const srcHash = getFileHash(src);
+    const destHash = getFileHash(dest);
+
+    // Only copy if content differs
+    return srcHash !== destHash;
+  };
+
   await fs.copy(templatePath, targetPath, {
     overwrite: true,
-    errorOnExist: false
+    errorOnExist: false,
+    filter: filter
   });
 }
 

package/lib/init.js

@@ -1,57 +1,57 @@
-/**
- * Init Command - Initialize Claude Agent Kit template
- *
- * This function merges the .claude/ template folder into the current project.
- * - Overwrites files with same name
- * - Keeps existing files that don't exist in template
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-const { promptUser, mergeTemplateFiles } = require('./helpers');
-
-module.exports = async function init(options = {}) {
-  // Paths
-  const templatePath = path.join(__dirname, '../.claude');
-  const targetPath = path.join(process.cwd(), '.claude');
-
-  console.log(chalk.cyan('\n🤖 Claude Agent Kit - Initializing...\n'));
-
-  // Check if template exists
-  if (!fs.existsSync(templatePath)) {
-    throw new Error('Template folder not found. Please reinstall the package.');
-  }
-
-  // Check if .claude/ already exists
-  if (fs.existsSync(targetPath)) {
-    console.log(chalk.yellow('⚠️  .claude/ already exists in this project.'));
-    console.log(chalk.gray('   Existing files will be preserved, template files will be merged.\n'));
-
-    const shouldContinue = await promptUser(
-      chalk.cyan('❓ Merge with template files? (y/N): ')
-    );
-
-    if (!shouldContinue) {
-      console.log(chalk.gray('\n❌ Initialization cancelled.\n'));
-      return;
-    }
-
-    console.log(chalk.gray('\n📦 Merging template files...\n'));
-  }
-
-  // Merge template files
-  try {
-    await mergeTemplateFiles(templatePath, targetPath);
-
-    console.log(chalk.green('✅ Successfully initialized Claude Agent Kit!\n'));
-    console.log(chalk.white('📁 Files merged to: ') + chalk.cyan(targetPath));
-    console.log(chalk.white('\n📚 Next steps:\n'));
-    console.log(chalk.gray('   1. Review the .claude/ folder'));
-    console.log(chalk.gray('   2. Run: ') + chalk.cyan('/psetup') + chalk.gray(' (one-time project setup)'));
-    console.log(chalk.gray('   3. Start using agents with Claude Code\n'));
-
-  } catch (error) {
-    throw new Error(`Failed to merge template: ${error.message}`);
-  }
-};
+/**
+ * Init Command - Initialize Claude Agent Kit template
+ *
+ * This function merges the .claude/ template folder into the current project.
+ * - Overwrites files with same name
+ * - Keeps existing files that don't exist in template
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { promptUser, mergeTemplateFiles } = require('./helpers');
+
+module.exports = async function init(options = {}) {
+  // Paths
+  const templatePath = path.join(__dirname, '../.claude');
+  const targetPath = path.join(process.cwd(), '.claude');
+
+  console.log(chalk.cyan('\n🤖 Claude Agent Kit - Initializing...\n'));
+
+  // Check if template exists
+  if (!fs.existsSync(templatePath)) {
+    throw new Error('Template folder not found. Please reinstall the package.');
+  }
+
+  // Check if .claude/ already exists
+  if (fs.existsSync(targetPath)) {
+    console.log(chalk.yellow('⚠️  .claude/ already exists in this project.'));
+    console.log(chalk.gray('   Existing files will be preserved, template files will be merged.\n'));
+
+    const shouldContinue = await promptUser(
+      chalk.cyan('❓ Merge with template files? (y/N): ')
+    );
+
+    if (!shouldContinue) {
+      console.log(chalk.gray('\n❌ Initialization cancelled.\n'));
+      return;
+    }
+
+    console.log(chalk.gray('\n📦 Merging template files...\n'));
+  }
+
+  // Merge template files
+  try {
+    await mergeTemplateFiles(templatePath, targetPath);
+
+    console.log(chalk.green('✅ Successfully initialized Claude Agent Kit!\n'));
+    console.log(chalk.white('📁 Files merged to: ') + chalk.cyan(targetPath));
+    console.log(chalk.white('\n📚 Next steps:\n'));
+    console.log(chalk.gray('   1. Review the .claude/ folder'));
+    console.log(chalk.gray('   2. Run: ') + chalk.cyan('/psetup') + chalk.gray(' (one-time project setup)'));
+    console.log(chalk.gray('   3. Start using agents with Claude Code\n'));
+
+  } catch (error) {
+    throw new Error(`Failed to merge template: ${error.message}`);
+  }
+};

package/lib/update.js

@@ -1,90 +1,90 @@
-/**
- * Update Command - Update Claude Agent Kit template to latest version
- *
- * This function:
- * 1. Checks for new version in npm registry
- * 2. Optionally updates the global package
- * 3. Merges latest template files into .claude/
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-const pkg = require('../package.json');
-const {
-  promptUser,
-  mergeTemplateFiles,
-  getLatestVersion,
-  getCurrentVersion,
-  installGlobalPackage
-} = require('./helpers');
-
-module.exports = async function update(options = {}) {
-  const packageName = pkg.name;
-
-  // Paths
-  const templatePath = path.join(__dirname, '../.claude');
-  const targetPath = path.join(process.cwd(), '.claude');
-
-  console.log(chalk.cyan('\n🤖 Claude Agent Kit - Updating...\n'));
-
-  // Check if .claude/ exists
-  if (!fs.existsSync(targetPath)) {
-    console.log(chalk.yellow('⚠️  .claude/ not found in this project.'));
-    console.log(chalk.gray('   Run init first:\n'));
-    console.log(chalk.cyan('   cak init\n'));
-    return;
-  }
-
-  // STEP 1: Check version
-  console.log(chalk.gray('🔍 Checking for updates...\n'));
-
-  const currentVersion = getCurrentVersion(packageName) || pkg.version;
-  const latestVersion = await getLatestVersion(packageName);
-
-  if (!latestVersion) {
-    console.log(chalk.yellow('⚠️  Unable to check npm registry. Continuing with local version.\n'));
-  } else if (currentVersion === latestVersion) {
-    console.log(chalk.green(`✅ Already on latest version (${latestVersion})\n`));
-  } else {
-    console.log(chalk.cyan(`📦 New version available: ${chalk.bold(latestVersion)} (current: ${currentVersion})\n`));
-
-    const shouldUpdatePackage = await promptUser(
-      chalk.cyan('❓ Update package globally first? (y/N): ')
-    );
-
-    // STEP 2: Update package globally
-    if (shouldUpdatePackage) {
-      const success = await installGlobalPackage(packageName, latestVersion);
-
-      if (!success) {
-        console.log(chalk.yellow('⚠️  Package update failed. Continuing with current version.\n'));
-      }
-    } else {
-      console.log(chalk.gray('\n⏭️  Skipping package update. Using current version.\n'));
-    }
-  }
-
-  // Check if template exists
-  if (!fs.existsSync(templatePath)) {
-    throw new Error('Template folder not found. Please reinstall the package.');
-  }
-
-  // STEP 3: Update files (merge mode)
-  console.log(chalk.gray('📦 Merging template files...\n'));
-
-  try {
-    await mergeTemplateFiles(templatePath, targetPath);
-
-    console.log(chalk.green('✅ Successfully updated Claude Agent Kit!\n'));
-    console.log(chalk.white('📁 Updated files in: ') + chalk.cyan(targetPath));
-    console.log(chalk.gray('   (Existing files preserved, template files merged)\n'));
-
-    console.log(chalk.white('📚 What\'s new:\n'));
-    console.log(chalk.gray('   Check CHANGELOG.md for latest changes'));
-    console.log(chalk.gray('   Or visit: ') + chalk.cyan('https://github.com/ChampPABA/claude-multi-agent-template\n'));
-
-  } catch (error) {
-    throw new Error(`Failed to update template: ${error.message}`);
-  }
-};
+/**
+ * Update Command - Update Claude Agent Kit template to latest version
+ *
+ * This function:
+ * 1. Checks for new version in npm registry
+ * 2. Optionally updates the global package
+ * 3. Merges latest template files into .claude/
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const pkg = require('../package.json');
+const {
+  promptUser,
+  mergeTemplateFiles,
+  getLatestVersion,
+  getCurrentVersion,
+  installGlobalPackage
+} = require('./helpers');
+
+module.exports = async function update(options = {}) {
+  const packageName = pkg.name;
+
+  // Paths
+  const templatePath = path.join(__dirname, '../.claude');
+  const targetPath = path.join(process.cwd(), '.claude');
+
+  console.log(chalk.cyan('\n🤖 Claude Agent Kit - Updating...\n'));
+
+  // Check if .claude/ exists
+  if (!fs.existsSync(targetPath)) {
+    console.log(chalk.yellow('⚠️  .claude/ not found in this project.'));
+    console.log(chalk.gray('   Run init first:\n'));
+    console.log(chalk.cyan('   cak init\n'));
+    return;
+  }
+
+  // STEP 1: Check version
+  console.log(chalk.gray('🔍 Checking for updates...\n'));
+
+  const currentVersion = getCurrentVersion(packageName) || pkg.version;
+  const latestVersion = await getLatestVersion(packageName);
+
+  if (!latestVersion) {
+    console.log(chalk.yellow('⚠️  Unable to check npm registry. Continuing with local version.\n'));
+  } else if (currentVersion === latestVersion) {
+    console.log(chalk.green(`✅ Already on latest version (${latestVersion})\n`));
+  } else {
+    console.log(chalk.cyan(`📦 New version available: ${chalk.bold(latestVersion)} (current: ${currentVersion})\n`));
+
+    const shouldUpdatePackage = await promptUser(
+      chalk.cyan('❓ Update package globally first? (y/N): ')
+    );
+
+    // STEP 2: Update package globally
+    if (shouldUpdatePackage) {
+      const success = await installGlobalPackage(packageName, latestVersion);
+
+      if (!success) {
+        console.log(chalk.yellow('⚠️  Package update failed. Continuing with current version.\n'));
+      }
+    } else {
+      console.log(chalk.gray('\n⏭️  Skipping package update. Using current version.\n'));
+    }
+  }
+
+  // Check if template exists
+  if (!fs.existsSync(templatePath)) {
+    throw new Error('Template folder not found. Please reinstall the package.');
+  }
+
+  // STEP 3: Update files (merge mode)
+  console.log(chalk.gray('📦 Merging template files...\n'));
+
+  try {
+    await mergeTemplateFiles(templatePath, targetPath);
+
+    console.log(chalk.green('✅ Successfully updated Claude Agent Kit!\n'));
+    console.log(chalk.white('📁 Updated files in: ') + chalk.cyan(targetPath));
+    console.log(chalk.gray('   (Existing files preserved, template files merged)\n'));
+
+    console.log(chalk.white('📚 What\'s new:\n'));
+    console.log(chalk.gray('   Check CHANGELOG.md for latest changes'));
+    console.log(chalk.gray('   Or visit: ') + chalk.cyan('https://github.com/ChampPABA/claude-multi-agent-template\n'));
+
+  } catch (error) {
+    throw new Error(`Failed to update template: ${error.message}`);
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champpaba/claude-agent-kit",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
   "main": "bin/cli.js",
   "bin": {