claude-cli-advanced-starter-pack 1.8.2 → 1.8.4

package/README.md

@@ -9,7 +9,7 @@
 ║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
 ║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
 ║                                                                               ║
-║                          v1.8.0  •  Production Ready                          ║
+║                          v1.8.3  •  Production Ready                          ║
 ║                                                                               ║
 ╚═══════════════════════════════════════════════════════════════════════════════╝
 ```
@@ -65,7 +65,11 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
 
 ---
 
-## What's New in v1.8.0
+## What's New in v1.8.3
+
+**Latest updates:**
+- **`ccasp init --dev`**: Dev mode for rapid template testing - reuses existing tech-stack.json, processes all templates, preserves custom commands
+- **`npm-deploy.js --auto`**: Auto mode for CI/CD - skips confirmation prompts for automation
 
 **60+ components** across 8 implementation phases:
 

package/bin/gtask.js

@@ -35,6 +35,9 @@ import { installSkillCommand, listSkills } from '../src/commands/install-skill.j
 import { runInstallScripts } from '../src/commands/install-scripts.js';
 import { runPanel, launchPanel } from '../src/commands/panel.js';
 import { runInstallPanelHook } from '../src/commands/install-panel-hook.js';
+import { runUninstall } from '../src/commands/uninstall.js';
+import { runGlobalUninstall } from '../src/commands/global-uninstall.js';
+import { runGlobalReinstall } from '../src/commands/global-reinstall.js';
 import { getVersion, checkPrerequisites } from '../src/utils.js';
 
 program
@@ -47,10 +50,42 @@ program
   .command('init')
   .description('Deploy Claude CLI Advanced Starter Pack to current project')
   .option('--force', 'Overwrite existing commands')
+  .option('--no-register', 'Do not register project in global registry')
+  .option('--dev', 'Development mode: reuse existing tech-stack.json, process templates, skip prompts')
   .action(async (options) => {
     await runInit(options);
   });
 
+// Uninstall command - remove CCASP from project
+program
+  .command('uninstall')
+  .description('Remove CCASP from current project and restore backups')
+  .option('--force', 'Skip confirmation prompts')
+  .option('--all', 'Remove entire .claude/ directory')
+  .action(async (options) => {
+    await runUninstall(options);
+  });
+
+// Global uninstall command - remove CCASP from ALL projects
+program
+  .command('global-uninstall')
+  .description('Remove CCASP from all registered projects and clear global config')
+  .option('--force', 'Skip confirmation prompts')
+  .option('--all', 'Remove entire .claude/ directory from each project')
+  .action(async (options) => {
+    await runGlobalUninstall(options);
+  });
+
+// Global reinstall command - reinstall CCASP across all projects
+program
+  .command('global-reinstall')
+  .description('Reinstall CCASP globally (use --projects to reinstall in all projects)')
+  .option('--force', 'Skip confirmation prompts')
+  .option('--projects', 'Reinstall CCASP in all registered projects')
+  .action(async (options) => {
+    await runGlobalReinstall(options);
+  });
+
 // Interactive menu (default when no command)
 program
   .command('menu', { isDefault: true })

package/package.json

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

package/src/commands/global-reinstall.js

@@ -0,0 +1,243 @@
+/**
+ * Global Reinstall Command
+ *
+ * Reinstalls CCASP globally:
+ * - Without --projects: Just refreshes the npm package (user must run manually)
+ * - With --projects: Uninstalls from all projects, then re-runs init on each
+ *
+ * Useful for:
+ * - Upgrading to a new version across all projects
+ * - Resetting CCASP configuration to defaults
+ * - Recovering from corrupted installations
+ */
+
+import chalk from 'chalk';
+import { existsSync } from 'fs';
+import { createInterface } from 'readline';
+import {
+  loadRegistry,
+  getRegistryStats,
+  saveRegistry
+} from '../utils/global-registry.js';
+import { runGlobalUninstall } from './global-uninstall.js';
+import { runInit } from './init.js';
+import { getVersion } from '../utils.js';
+
+/**
+ * Prompt user for confirmation
+ */
+function confirm(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+/**
+ * Run init in a specific project directory
+ */
+async function initProject(projectPath, options = {}) {
+  const originalCwd = process.cwd();
+
+  try {
+    // Change to project directory
+    process.chdir(projectPath);
+
+    // Run init with skipPrompts to avoid interactive questions
+    await runInit({ skipPrompts: true, force: true, ...options });
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, error: err.message };
+  } finally {
+    // Restore original cwd
+    process.chdir(originalCwd);
+  }
+}
+
+/**
+ * Main global reinstall function
+ */
+export async function runGlobalReinstall(options = {}) {
+  console.log(chalk.cyan('\n  ╔══════════════════════════════════════════════════════════════╗'));
+  console.log(chalk.cyan('  ║') + chalk.bold.white('             CCASP Global Reinstall                         ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ╚══════════════════════════════════════════════════════════════╝\n'));
+
+  const version = getVersion();
+  console.log(chalk.dim(`  CCASP Version: ${version}\n`));
+
+  // Get current registry state
+  const stats = getRegistryStats();
+  const registry = loadRegistry();
+
+  // Store project list before uninstall (for --projects mode)
+  const projectsToReinstall = registry.projects.map(p => ({
+    path: p.path,
+    name: p.name,
+    features: p.features || []
+  }));
+
+  // Check if --projects flag is set
+  if (!options.projects) {
+    console.log(chalk.bold('  Reinstall Mode: Package Only\n'));
+    console.log(chalk.dim('  This mode refreshes the npm package but does NOT touch project installations.'));
+    console.log(chalk.dim('  Use --projects flag to reinstall CCASP in all registered projects.\n'));
+
+    if (stats.total > 0) {
+      console.log(chalk.yellow(`  📁 ${stats.total} project(s) currently registered:`));
+      for (const project of registry.projects) {
+        const exists = existsSync(project.path);
+        const statusIcon = exists ? chalk.green('✓') : chalk.red('✗');
+        console.log(`     ${statusIcon} ${project.name}`);
+      }
+      console.log('');
+    }
+
+    console.log(chalk.bold('  To reinstall the npm package:\n'));
+    console.log(chalk.cyan('    npm uninstall -g claude-cli-advanced-starter-pack'));
+    console.log(chalk.cyan('    npm install -g claude-cli-advanced-starter-pack@latest\n'));
+
+    console.log(chalk.dim('  Or use --projects to reinstall in all projects:'));
+    console.log(chalk.cyan('    ccasp global-reinstall --projects\n'));
+
+    return;
+  }
+
+  // --projects mode: Full reinstall
+  console.log(chalk.bold('  Reinstall Mode: Full (Projects)\n'));
+
+  if (stats.total === 0) {
+    console.log(chalk.yellow('  No projects registered in global registry.\n'));
+    console.log(chalk.dim('  To register a project, run: cd /path/to/project && ccasp init\n'));
+    return;
+  }
+
+  console.log(chalk.yellow(`  📁 ${stats.total} project(s) will be reinstalled:`));
+  for (const project of projectsToReinstall) {
+    const exists = existsSync(project.path);
+    const statusIcon = exists ? chalk.green('✓') : chalk.red('✗');
+    const statusText = exists ? '' : chalk.dim(' (will be skipped)');
+    console.log(`     ${statusIcon} ${project.name}${statusText}`);
+  }
+  console.log('');
+
+  // Count existing projects
+  const existingProjects = projectsToReinstall.filter(p => existsSync(p.path));
+
+  if (existingProjects.length === 0) {
+    console.log(chalk.red('  No project directories found. Nothing to reinstall.\n'));
+    return;
+  }
+
+  // Confirm unless --force
+  if (!options.force) {
+    console.log(chalk.yellow.bold('  ⚠️  This will:'));
+    console.log(chalk.yellow(`     1. Uninstall CCASP from ${existingProjects.length} project(s)`));
+    console.log(chalk.yellow('     2. Restore any backed-up files'));
+    console.log(chalk.yellow(`     3. Reinstall CCASP v${version} in each project`));
+    console.log('');
+
+    const shouldContinue = await confirm(chalk.yellow('  Proceed with global reinstall? (y/N): '));
+    if (!shouldContinue) {
+      console.log(chalk.dim('\n  Cancelled. No changes made.\n'));
+      return;
+    }
+    console.log('');
+  }
+
+  // Track results
+  const results = {
+    uninstalled: 0,
+    reinstalled: 0,
+    failed: [],
+    skipped: 0
+  };
+
+  // Phase 1: Uninstall from all projects
+  console.log(chalk.bold('  Phase 1: Uninstalling from all projects...\n'));
+
+  // Run global uninstall but preserve project list for reinstall
+  // We don't call runGlobalUninstall directly because it clears the registry
+  for (const project of projectsToReinstall) {
+    process.stdout.write(`  ${chalk.dim('○')} Uninstalling from ${project.name}... `);
+
+    if (!existsSync(project.path)) {
+      console.log(chalk.yellow('skipped'));
+      results.skipped++;
+      continue;
+    }
+
+    const originalCwd = process.cwd();
+    try {
+      process.chdir(project.path);
+
+      // Import and run uninstall dynamically to avoid circular dependency issues
+      const { runUninstall } = await import('./uninstall.js');
+      await runUninstall({ force: true });
+
+      console.log(chalk.green('✓'));
+      results.uninstalled++;
+    } catch (err) {
+      console.log(chalk.red(`✗ ${err.message}`));
+      results.failed.push({ project: project.name, phase: 'uninstall', error: err.message });
+    } finally {
+      process.chdir(originalCwd);
+    }
+  }
+
+  console.log('');
+
+  // Phase 2: Reinstall in all projects
+  console.log(chalk.bold('  Phase 2: Reinstalling CCASP in all projects...\n'));
+
+  for (const project of projectsToReinstall) {
+    process.stdout.write(`  ${chalk.dim('○')} Installing in ${project.name}... `);
+
+    if (!existsSync(project.path)) {
+      console.log(chalk.yellow('skipped'));
+      continue;
+    }
+
+    const result = await initProject(project.path, { skipPrompts: true });
+
+    if (result.success) {
+      console.log(chalk.green('✓'));
+      results.reinstalled++;
+    } else {
+      console.log(chalk.red(`✗ ${result.error}`));
+      results.failed.push({ project: project.name, phase: 'reinstall', error: result.error });
+    }
+  }
+
+  // Summary
+  console.log(chalk.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+  if (results.failed.length === 0) {
+    console.log(chalk.green.bold('  ✓ Global reinstall complete!\n'));
+  } else {
+    console.log(chalk.yellow.bold('  ⚠️  Global reinstall completed with errors\n'));
+  }
+
+  console.log(chalk.dim(`  Projects reinstalled: ${results.reinstalled}`));
+  if (results.skipped > 0) {
+    console.log(chalk.dim(`  Projects skipped (not found): ${results.skipped}`));
+  }
+
+  if (results.failed.length > 0) {
+    console.log(chalk.yellow(`  Projects with errors: ${results.failed.length}`));
+    for (const failure of results.failed) {
+      console.log(chalk.red(`    • ${failure.project} (${failure.phase}): ${failure.error}`));
+    }
+  }
+
+  console.log('');
+  console.log(chalk.dim('  Each project now has the latest CCASP commands.'));
+  console.log(chalk.dim('  Restart Claude Code CLI to use the updated commands.\n'));
+}

package/src/commands/global-uninstall.js

@@ -0,0 +1,229 @@
+/**
+ * Global Uninstall Command
+ *
+ * Removes CCASP from ALL registered projects and cleans up global configuration.
+ * - Restores backups in each project
+ * - Removes CCASP files from each project
+ * - Clears the global registry
+ * - Removes global CCASP cache/config files
+ */
+
+import chalk from 'chalk';
+import { existsSync, rmSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { createInterface } from 'readline';
+import {
+  loadRegistry,
+  clearRegistry,
+  getRegistryStats,
+  getGlobalClaudeDir,
+  getRegistryPath
+} from '../utils/global-registry.js';
+import { runUninstall } from './uninstall.js';
+
+/**
+ * Prompt user for confirmation
+ */
+function confirm(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+/**
+ * Run uninstall in a specific project directory
+ */
+async function uninstallProject(projectPath, options = {}) {
+  const originalCwd = process.cwd();
+
+  try {
+    // Change to project directory
+    process.chdir(projectPath);
+
+    // Run uninstall with force flag to skip prompts
+    await runUninstall({ force: true, ...options });
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, error: err.message };
+  } finally {
+    // Restore original cwd
+    process.chdir(originalCwd);
+  }
+}
+
+/**
+ * Get global CCASP files/directories to clean up
+ */
+function getGlobalCcaspFiles() {
+  const globalClaudeDir = getGlobalClaudeDir();
+  const files = [];
+
+  if (!existsSync(globalClaudeDir)) {
+    return files;
+  }
+
+  // CCASP-specific files in ~/.claude/
+  const ccaspFiles = [
+    'ccasp-registry.json',
+    'ccasp-panel',  // Panel queue directory
+  ];
+
+  for (const file of ccaspFiles) {
+    const filePath = join(globalClaudeDir, file);
+    if (existsSync(filePath)) {
+      files.push({
+        path: filePath,
+        name: file,
+        type: statSync(filePath).isDirectory() ? 'directory' : 'file'
+      });
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Main global uninstall function
+ */
+export async function runGlobalUninstall(options = {}) {
+  console.log(chalk.cyan('\n  ╔══════════════════════════════════════════════════════════════╗'));
+  console.log(chalk.cyan('  ║') + chalk.bold.white('             CCASP Global Uninstall                         ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ╚══════════════════════════════════════════════════════════════╝\n'));
+
+  // Get registry stats
+  const stats = getRegistryStats();
+  const registry = loadRegistry();
+  const globalFiles = getGlobalCcaspFiles();
+
+  // Show what will be affected
+  console.log(chalk.bold('  What will be removed:\n'));
+
+  // Projects
+  if (stats.total > 0) {
+    console.log(chalk.yellow(`  📁 ${stats.total} registered project(s):`));
+    for (const project of registry.projects) {
+      const exists = existsSync(project.path);
+      const statusIcon = exists ? chalk.green('✓') : chalk.red('✗');
+      const statusText = exists ? '' : chalk.dim(' (not found)');
+      console.log(`     ${statusIcon} ${project.name} - ${chalk.dim(project.path)}${statusText}`);
+    }
+    console.log('');
+  } else {
+    console.log(chalk.dim('  📁 No projects registered\n'));
+  }
+
+  // Global files
+  if (globalFiles.length > 0) {
+    console.log(chalk.yellow('  🗂️  Global CCASP files:'));
+    for (const file of globalFiles) {
+      console.log(`     • ~/.claude/${file.name}`);
+    }
+    console.log('');
+  }
+
+  // npm package note
+  console.log(chalk.dim('  📦 Note: The npm package itself is NOT uninstalled.'));
+  console.log(chalk.dim('     To fully remove: npm uninstall -g claude-cli-advanced-starter-pack\n'));
+
+  // Nothing to do?
+  if (stats.total === 0 && globalFiles.length === 0) {
+    console.log(chalk.green('  ✓ Nothing to uninstall - CCASP is not configured globally.\n'));
+    return;
+  }
+
+  // Confirm unless --force
+  if (!options.force) {
+    console.log(chalk.red.bold('  ⚠️  This will:'));
+    if (stats.existing > 0) {
+      console.log(chalk.red(`     • Uninstall CCASP from ${stats.existing} project(s)`));
+      console.log(chalk.red('     • Restore any backed-up files'));
+    }
+    if (globalFiles.length > 0) {
+      console.log(chalk.red('     • Delete global CCASP configuration'));
+    }
+    console.log('');
+
+    const shouldContinue = await confirm(chalk.yellow('  Proceed with global uninstall? (y/N): '));
+    if (!shouldContinue) {
+      console.log(chalk.dim('\n  Cancelled. No changes made.\n'));
+      return;
+    }
+    console.log('');
+  }
+
+  // Track results
+  const results = {
+    projectsUninstalled: 0,
+    projectsFailed: 0,
+    projectsSkipped: 0,
+    globalFilesRemoved: 0
+  };
+
+  // Uninstall from each project
+  if (stats.total > 0) {
+    console.log(chalk.bold('  Uninstalling from projects...\n'));
+
+    for (const project of registry.projects) {
+      process.stdout.write(`  ${chalk.dim('○')} ${project.name}... `);
+
+      if (!existsSync(project.path)) {
+        console.log(chalk.yellow('skipped (not found)'));
+        results.projectsSkipped++;
+        continue;
+      }
+
+      const result = await uninstallProject(project.path, { all: options.all });
+
+      if (result.success) {
+        console.log(chalk.green('✓'));
+        results.projectsUninstalled++;
+      } else {
+        console.log(chalk.red(`✗ ${result.error}`));
+        results.projectsFailed++;
+      }
+    }
+    console.log('');
+  }
+
+  // Clear global registry
+  clearRegistry();
+  console.log(chalk.green('  ✓ Cleared global project registry'));
+
+  // Remove global CCASP files
+  for (const file of globalFiles) {
+    try {
+      rmSync(file.path, { recursive: true, force: true });
+      console.log(chalk.green(`  ✓ Removed ~/.claude/${file.name}`));
+      results.globalFilesRemoved++;
+    } catch (err) {
+      console.log(chalk.red(`  ✗ Failed to remove ~/.claude/${file.name}: ${err.message}`));
+    }
+  }
+
+  // Summary
+  console.log(chalk.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+  console.log(chalk.green.bold('  ✓ Global uninstall complete!\n'));
+
+  if (results.projectsUninstalled > 0) {
+    console.log(chalk.dim(`  Projects uninstalled: ${results.projectsUninstalled}`));
+  }
+  if (results.projectsSkipped > 0) {
+    console.log(chalk.dim(`  Projects skipped (not found): ${results.projectsSkipped}`));
+  }
+  if (results.projectsFailed > 0) {
+    console.log(chalk.yellow(`  Projects failed: ${results.projectsFailed}`));
+  }
+
+  console.log('');
+  console.log(chalk.dim('  To reinstall globally: ccasp global-reinstall'));
+  console.log(chalk.dim('  To reinstall in a project: cd /path/to/project && ccasp init\n'));
+}