claude-cli-advanced-starter-pack 1.0.13 → 1.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-cli-advanced-starter-pack",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Advanced Claude Code CLI toolkit - agents, hooks, skills, MCP servers, phased development, and GitHub integration",
   "main": "src/index.js",
   "bin": {

package/src/commands/init.js

@@ -42,25 +42,27 @@ const OPTIONAL_FEATURES = [
     label: 'Token Budget Management',
     description: 'Monitor and manage Claude API token usage with automatic compaction warnings, archive suggestions, and respawn thresholds. Includes hooks that track usage per session.',
     commands: ['context-audit'],
-    hooks: ['token-budget-loader', 'context-guardian', 'tool-output-cacher'],
+    hooks: ['context-guardian'],  // Only include hooks with templates
     default: false,
     requiresPostConfig: false,
   },
   {
     name: 'happyMode',
     label: 'Happy Engineering Integration',
-    description: 'Integration with Happy Coder mobile app for remote session control, checkpoint management, and mobile-optimized responses. Requires Happy Coder app installed separately.',
+    description: 'Integration with Happy Coder mobile app for remote session control, checkpoint management, and mobile-optimized responses.',
     commands: ['happy-start'],
-    hooks: ['happy-checkpoint-manager', 'happy-title-generator', 'happy-mode-detector'],
+    hooks: ['happy-checkpoint-manager'],  // Only include hooks with templates
     default: false,
     requiresPostConfig: true,
+    npmPackage: 'happy-coder',  // Optional npm package to install
+    npmInstallPrompt: 'Install Happy Coder CLI globally? (npm i -g happy-coder)',
   },
   {
     name: 'githubIntegration',
     label: 'GitHub Project Board Integration',
     description: 'Connect Claude to your GitHub Project Board for automated issue creation, progress tracking, and PR merge automation. Requires gh CLI authentication.',
     commands: ['github-update', 'github-task-start'],
-    hooks: ['github-progress-hook', 'issue-completion-detector'],
+    hooks: ['github-progress-hook'],  // Only include hooks with templates
     default: true,
     requiresPostConfig: true,
   },
@@ -1818,6 +1820,25 @@ export async function runInit(options = {}) {
   const enabledFeatures = OPTIONAL_FEATURES.filter((f) => selectedFeatures.includes(f.name));
   const featuresRequiringConfig = enabledFeatures.filter((f) => f.requiresPostConfig);
 
+  // Collect feature-specific commands and hooks to deploy
+  const featureCommands = [];
+  const featureHooks = [];
+  for (const feature of enabledFeatures) {
+    featureCommands.push(...feature.commands);
+    featureHooks.push(...feature.hooks);
+  }
+
+  if (featureCommands.length > 0) {
+    console.log('');
+    console.log(chalk.green(`  ✓ Selected features will add ${featureCommands.length} command(s):`));
+    console.log(chalk.dim(`    ${featureCommands.map(c => '/' + c).join(', ')}`));
+  }
+
+  if (featureHooks.length > 0) {
+    console.log(chalk.green(`  ✓ Selected features will add ${featureHooks.length} hook(s):`));
+    console.log(chalk.dim(`    ${featureHooks.join(', ')}`));
+  }
+
   if (featuresRequiringConfig.length > 0) {
     console.log('');
     console.log(chalk.yellow('  ℹ The following features require configuration after installation:'));
@@ -1827,6 +1848,42 @@ export async function runInit(options = {}) {
     console.log(chalk.dim('    Run /menu → Project Settings after installation to complete setup.'));
   }
 
+  // Check for optional npm package installs from selected features
+  const featuresWithNpm = enabledFeatures.filter((f) => f.npmPackage);
+  if (featuresWithNpm.length > 0) {
+    console.log('');
+    console.log(chalk.bold('  Optional Package Installation\n'));
+
+    for (const feature of featuresWithNpm) {
+      const { installPackage } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'installPackage',
+          message: feature.npmInstallPrompt || `Install ${feature.npmPackage} globally?`,
+          default: true,
+        },
+      ]);
+
+      if (installPackage) {
+        const npmSpinner = ora(`Installing ${feature.npmPackage}...`).start();
+        try {
+          const { execSync } = await import('child_process');
+          execSync(`npm install -g ${feature.npmPackage}`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 120000, // 2 minutes timeout
+          });
+          npmSpinner.succeed(`Installed ${feature.npmPackage} globally`);
+        } catch (error) {
+          npmSpinner.fail(`Failed to install ${feature.npmPackage}`);
+          console.log(chalk.dim(`    Run manually: npm install -g ${feature.npmPackage}`));
+        }
+      } else {
+        console.log(chalk.dim(`  Skipped. Install later with: npm install -g ${feature.npmPackage}`));
+      }
+    }
+  }
+
   console.log('');
 
   // Step 5: Select slash commands to install
@@ -1878,15 +1935,21 @@ export async function runInit(options = {}) {
     },
   ]);
 
-  // Always include required commands
+  // Always include required commands AND feature-specific commands
   const requiredCommands = AVAILABLE_COMMANDS.filter(c => c.required).map(c => c.name);
-  const finalCommands = [...new Set([...requiredCommands, ...selectedCommands])];
+  const finalCommands = [...new Set([...requiredCommands, ...selectedCommands, ...featureCommands])];
 
   if (finalCommands.length === 0) {
     showWarning('No commands selected. Nothing to install.');
     return;
   }
 
+  // Show what feature commands were auto-added
+  const autoAddedCommands = featureCommands.filter(c => !selectedCommands.includes(c) && !requiredCommands.includes(c));
+  if (autoAddedCommands.length > 0) {
+    console.log(chalk.cyan(`  ℹ Auto-including ${autoAddedCommands.length} feature command(s): ${autoAddedCommands.map(c => '/' + c).join(', ')}`));
+  }
+
   console.log('');
 
   // Step 6: Check for existing commands that would be overwritten
@@ -2181,6 +2244,45 @@ export async function runInit(options = {}) {
     console.log(chalk.cyan(`\n  📁 Backed up ${backedUpFiles.length} file(s) to .claude/backups/`));
   }
 
+  // Step 6b: Deploy feature-specific hooks
+  const deployedHooks = [];
+  const failedHooks = [];
+
+  if (featureHooks.length > 0) {
+    console.log(chalk.bold('\nStep 6b: Deploying feature hooks\n'));
+
+    for (const hookName of featureHooks) {
+      try {
+        const hookPath = join(hooksDir, `${hookName}.js`);
+
+        // Skip if already exists
+        if (existsSync(hookPath)) {
+          console.log(chalk.blue(`  ○ hooks/${hookName}.js exists (preserved)`));
+          continue;
+        }
+
+        // Try to load from templates/hooks/ folder
+        const templatePath = join(__dirname, '..', '..', 'templates', 'hooks', `${hookName}.template.js`);
+        if (existsSync(templatePath)) {
+          const hookContent = readFileSync(templatePath, 'utf8');
+          writeFileSync(hookPath, hookContent, 'utf8');
+          deployedHooks.push(hookName);
+          console.log(chalk.green(`  ✓ Created hooks/${hookName}.js`));
+        } else {
+          failedHooks.push({ name: hookName, error: 'No template found' });
+          console.log(chalk.yellow(`  ⚠ Skipped hooks/${hookName}.js (no template)`));
+        }
+      } catch (error) {
+        failedHooks.push({ name: hookName, error: error.message });
+        console.log(chalk.red(`  ✗ Failed: hooks/${hookName}.js - ${error.message}`));
+      }
+    }
+
+    if (deployedHooks.length > 0) {
+      console.log(chalk.green(`\n  ✓ Deployed ${deployedHooks.length} feature hook(s)`));
+    }
+  }
+
   // Step 7: Generate INDEX.md
   const indexPath = join(commandsDir, 'INDEX.md');
   const indexContent = generateIndexFile(installed, projectName);
@@ -2308,6 +2410,15 @@ export async function runInit(options = {}) {
     },
     // Track which features need post-install configuration
     _pendingConfiguration: featuresRequiringConfig.map((f) => f.name),
+    // Track what was deployed for verification
+    _deployment: {
+      commands: installed,
+      featureCommands: featureCommands.filter(c => installed.includes(c)),
+      hooks: deployedHooks,
+      featureHooks: featureHooks,
+      enabledFeatures: selectedFeatures,
+      timestamp: new Date().toISOString(),
+    },
   };
 
   if (!existsSync(techStackPath)) {

package/src/data/releases.json

@@ -1,5 +1,60 @@
 {
   "releases": [
+    {
+      "version": "1.0.15",
+      "date": "2026-01-30",
+      "summary": "Feature: Optional npm package installation for features (Happy Coder support)",
+      "highlights": [
+        "Features can now define optional npm packages to install globally",
+        "Happy Mode feature prompts to install happy-coder CLI during init",
+        "Graceful fallback with manual install instructions on failure",
+        "2-minute timeout for npm install operations"
+      ],
+      "newFeatures": {
+        "commands": [],
+        "agents": [],
+        "skills": [],
+        "hooks": [],
+        "other": [
+          {
+            "name": "npm-package-install",
+            "description": "Features can specify npmPackage and npmInstallPrompt for optional global installs"
+          }
+        ]
+      },
+      "breaking": [],
+      "deprecated": []
+    },
+    {
+      "version": "1.0.14",
+      "date": "2026-01-30",
+      "summary": "Fix: Complete feature deployment - hooks, commands, and auto-selection now work correctly",
+      "highlights": [
+        "Feature commands are now auto-included when a feature is selected",
+        "Feature hooks are now properly deployed during init",
+        "OPTIONAL_FEATURES cleaned up to only reference existing templates",
+        "tech-stack.json now tracks deployed commands and hooks for verification",
+        "Step 6b added to show feature hook deployment progress"
+      ],
+      "newFeatures": {
+        "commands": [],
+        "agents": [],
+        "skills": [],
+        "hooks": [],
+        "other": [
+          {
+            "name": "feature-auto-deployment",
+            "description": "When selecting a feature, its commands and hooks are automatically deployed"
+          },
+          {
+            "name": "deployment-tracking",
+            "description": "tech-stack.json now includes _deployment section tracking what was installed"
+          }
+        ]
+      },
+      "breaking": [],
+      "deprecated": []
+    },
     {
       "version": "1.0.13",
       "date": "2026-01-30",