claude-cli-advanced-starter-pack 1.1.0 → 1.8.0

package/src/commands/panel.js

@@ -0,0 +1,297 @@
+/**
+ * CCASP Panel - Persistent Control Panel for Claude Code
+ *
+ * Runs in a separate terminal and sends commands to Claude Code CLI
+ * via a queue file. Claude Code reads the queue via a hook.
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { spawn } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import {
+  queueCommand,
+  copyToClipboard,
+  getQueueStatus,
+  clearQueue,
+  getQueueFilePath,
+  ensureQueueDir,
+} from '../panel/queue.js';
+import { getVersion } from '../utils.js';
+
+// Panel ASCII Banner
+const PANEL_BANNER = `
+${chalk.cyan('╔═══════════════════════════════════════════════════════════════╗')}
+${chalk.cyan('║')}${chalk.bold.white('          CCASP Control Panel')}${chalk.dim('  v' + getVersion())}${' '.repeat(20)}${chalk.cyan('║')}
+${chalk.cyan('║')}${chalk.dim('      Commands are sent to Claude Code CLI')}${' '.repeat(19)}${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════════════════════════════╝')}`;
+
+// Command definitions with their slash command equivalents
+const PANEL_COMMANDS = {
+  // Agents & Skills
+  agents: {
+    header: 'Agents & Skills',
+    items: [
+      { key: 'A', label: 'Create Agent', command: '/create-agent', desc: 'L1/L2/L3 agent builder' },
+      { key: 'H', label: 'Create Hook', command: '/create-hook', desc: 'Enforcement hooks' },
+      { key: 'S', label: 'Create Skill', command: '/create-skill', desc: 'RAG skill packages' },
+      { key: 'M', label: 'Explore MCP', command: '/explore-mcp', desc: 'MCP server discovery' },
+      { key: 'C', label: 'Claude Audit', command: '/claude-audit', desc: 'Best practices check' },
+      { key: 'E', label: 'Explore Codebase', command: '/codebase-explorer', desc: 'Analyze structure' },
+    ]
+  },
+  // Project Resources
+  resources: {
+    header: 'Project Resources',
+    items: [
+      { key: '1', label: 'View Agents', command: '/view-agents', desc: 'List configured agents' },
+      { key: '2', label: 'View Skills', command: '/view-skills', desc: 'List available skills' },
+      { key: '3', label: 'View Hooks', command: '/view-hooks', desc: 'List enforcement hooks' },
+      { key: '4', label: 'View Commands', command: '/INDEX', desc: 'All slash commands' },
+      { key: '5', label: 'Settings', command: '/ccasp-settings', desc: 'Configuration' },
+      { key: '6', label: 'Documentation', command: '/README', desc: 'Help & guides' },
+    ]
+  },
+  // Quick Actions
+  quick: {
+    header: 'Quick Actions',
+    items: [
+      { key: 'P', label: 'Phase Dev Plan', command: '/phase-dev-plan', desc: '95%+ success plans' },
+      { key: 'G', label: 'GitHub Task', command: '/github-task', desc: 'Create GitHub issue' },
+      { key: 'T', label: 'Run E2E Tests', command: '/e2e-test', desc: 'Playwright tests' },
+      { key: 'U', label: 'Update Check', command: '/update-check', desc: 'Check for updates' },
+    ]
+  }
+};
+
+/**
+ * Display the panel menu
+ */
+function displayMenu() {
+  console.clear();
+  console.log(PANEL_BANNER);
+  console.log('');
+
+  // Get queue status
+  const status = getQueueStatus();
+  const statusIndicator = status.pending > 0
+    ? chalk.yellow(`[${status.pending} pending]`)
+    : chalk.green('[Ready]');
+
+  console.log(`  ${chalk.dim('Status:')} ${statusIndicator}`);
+  console.log('');
+
+  // Display each section
+  for (const [key, section] of Object.entries(PANEL_COMMANDS)) {
+    console.log(chalk.cyan(`  ${section.header}:`));
+    console.log(chalk.cyan('  ' + '─'.repeat(40)));
+
+    // Display items in rows of 3
+    const items = section.items;
+    for (let i = 0; i < items.length; i += 3) {
+      const row = items.slice(i, i + 3);
+      const formatted = row.map(item =>
+        `  ${chalk.yellow(`[${item.key}]`)} ${item.label.padEnd(14)}`
+      ).join('');
+      console.log(formatted);
+    }
+    console.log('');
+  }
+
+  // Bottom controls
+  console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+  console.log(`  ${chalk.yellow('[Q]')} Quit    ${chalk.yellow('[R]')} Refresh    ${chalk.yellow('[X]')} Clear Queue    ${chalk.yellow('[?]')} Help`);
+  console.log('');
+}
+
+/**
+ * Find command by key
+ */
+function findCommandByKey(key) {
+  const upperKey = key.toUpperCase();
+  for (const section of Object.values(PANEL_COMMANDS)) {
+    const found = section.items.find(item => item.key.toUpperCase() === upperKey);
+    if (found) return found;
+  }
+  return null;
+}
+
+/**
+ * Send command to Claude Code
+ */
+async function sendCommand(item) {
+  console.log('');
+  console.log(chalk.cyan(`  Sending: ${item.command}`));
+
+  // Queue the command
+  const entry = queueCommand(item.command, '', {
+    label: item.label,
+    source: 'panel'
+  });
+
+  // Also copy to clipboard as fallback
+  const copied = copyToClipboard(item.command);
+
+  console.log('');
+  console.log(chalk.green('  ✓ Command queued'));
+  if (copied) {
+    console.log(chalk.dim('  ✓ Also copied to clipboard'));
+  }
+  console.log('');
+  console.log(chalk.white.bold('  → In Claude Code, press Enter to execute'));
+  console.log(chalk.dim('    (or paste with Ctrl+V if hook not installed)'));
+  console.log('');
+
+  // Wait for user acknowledgment
+  await inquirer.prompt([{
+    type: 'input',
+    name: 'continue',
+    message: 'Press Enter to continue...',
+  }]);
+}
+
+/**
+ * Show help
+ */
+async function showHelp() {
+  console.clear();
+  console.log(chalk.cyan.bold('\n  CCASP Panel Help\n'));
+  console.log(chalk.white('  How it works:'));
+  console.log(chalk.dim('  1. Select a command from the menu'));
+  console.log(chalk.dim('  2. Command is queued for Claude Code'));
+  console.log(chalk.dim('  3. In Claude Code, press Enter to execute'));
+  console.log('');
+  console.log(chalk.white('  Queue File:'));
+  console.log(chalk.dim(`  ${getQueueFilePath()}`));
+  console.log('');
+  console.log(chalk.white('  Claude Code Hook:'));
+  console.log(chalk.dim('  Install with: ccasp install-panel-hook'));
+  console.log('');
+
+  await inquirer.prompt([{
+    type: 'input',
+    name: 'continue',
+    message: 'Press Enter to return to menu...',
+  }]);
+}
+
+/**
+ * Main panel loop
+ */
+export async function runPanel(options = {}) {
+  ensureQueueDir();
+
+  // Check if running inside Claude Code
+  if (process.env.CLAUDE_CODE_SESSION) {
+    console.log(chalk.yellow('\n  Warning: Panel should run in a SEPARATE terminal.'));
+    console.log(chalk.dim('  This terminal is already inside Claude Code.\n'));
+
+    const { proceed } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'proceed',
+      message: 'Continue anyway?',
+      default: false
+    }]);
+
+    if (!proceed) {
+      console.log(chalk.dim('\n  To use the panel:'));
+      console.log(chalk.dim('  1. Open a new terminal window'));
+      console.log(chalk.dim('  2. Run: ccasp panel\n'));
+      return;
+    }
+  }
+
+  // Main loop
+  while (true) {
+    displayMenu();
+
+    const { action } = await inquirer.prompt([{
+      type: 'input',
+      name: 'action',
+      message: 'Select option:',
+    }]);
+
+    const key = action.trim().toUpperCase();
+
+    if (key === 'Q') {
+      console.log(chalk.dim('\n  Goodbye!\n'));
+      process.exit(0);
+    }
+
+    if (key === 'R') {
+      continue; // Refresh - just redisplay
+    }
+
+    if (key === 'X') {
+      clearQueue();
+      console.log(chalk.green('\n  ✓ Queue cleared\n'));
+      await new Promise(r => setTimeout(r, 1000));
+      continue;
+    }
+
+    if (key === '?') {
+      await showHelp();
+      continue;
+    }
+
+    // Find and execute command
+    const item = findCommandByKey(key);
+    if (item) {
+      await sendCommand(item);
+    } else if (key) {
+      console.log(chalk.red(`\n  Unknown option: ${key}\n`));
+      await new Promise(r => setTimeout(r, 1000));
+    }
+  }
+}
+
+/**
+ * Launch panel in a new terminal window
+ */
+export async function launchPanel() {
+  console.log(chalk.cyan('\n  Launching CCASP Panel in new window...\n'));
+
+  const ccaspPath = join(process.cwd(), 'node_modules', '.bin', 'ccasp');
+  const globalPath = 'ccasp'; // Assume globally installed
+
+  try {
+    if (process.platform === 'win32') {
+      // Windows - use start command with PowerShell
+      spawn('cmd.exe', ['/c', 'start', 'powershell', '-NoExit', '-Command', 'ccasp panel'], {
+        detached: true,
+        stdio: 'ignore'
+      });
+    } else if (process.platform === 'darwin') {
+      // macOS - use osascript
+      spawn('osascript', [
+        '-e', `tell application "Terminal" to do script "ccasp panel"`
+      ], {
+        detached: true,
+        stdio: 'ignore'
+      });
+    } else {
+      // Linux - try various terminal emulators
+      const terminals = ['gnome-terminal', 'konsole', 'xterm', 'xfce4-terminal'];
+      for (const term of terminals) {
+        try {
+          if (term === 'gnome-terminal') {
+            spawn(term, ['--', 'ccasp', 'panel'], { detached: true, stdio: 'ignore' });
+          } else {
+            spawn(term, ['-e', 'ccasp panel'], { detached: true, stdio: 'ignore' });
+          }
+          break;
+        } catch {
+          continue;
+        }
+      }
+    }
+
+    console.log(chalk.green('  ✓ Panel window opened'));
+    console.log(chalk.dim('  You can now use this terminal for Claude Code\n'));
+  } catch (error) {
+    console.log(chalk.red('  Failed to open new terminal'));
+    console.log(chalk.dim(`  Run manually: ${chalk.white('ccasp panel')}\n`));
+  }
+}

package/src/commands/setup-wizard.js

@@ -743,7 +743,8 @@ async function runQuickSetup() {
 
     // Run init with selected features
     // Features are already in init.js-compatible format (INDIVIDUAL_FEATURES uses correct names)
-    spinner.start('Initializing .claude folder...');
+    // Note: Don't use spinner here since runInit has its own console output
+    console.log('');
 
     // Check if any features require post-configuration
     const featuresRequiringConfig = features.filter((f) =>
@@ -757,7 +758,7 @@ async function runQuickSetup() {
       skipPrompts: true,
     });
 
-    spinner.succeed('.claude folder created!');
+    console.log(chalk.green('\n✓ .claude folder setup complete!'));
 
     // Show which features need post-configuration
     if (featuresRequiringConfig.length > 0) {
@@ -793,7 +794,7 @@ async function runQuickSetup() {
     showCompletionMessage();
     return true;
   } catch (error) {
-    spinner.fail('Setup failed');
+    console.error(chalk.red('\n✗ Setup failed'));
     console.error(chalk.red(error.message));
     return false;
   }

package/src/commands/test-setup.js

@@ -400,9 +400,9 @@ export async function runTestSetup(options) {
 
   // Save main config to tech-stack.json
   const configPath = saveTestingConfig(testingConfig);
-  spinner.text = 'Saved testing config to tech-stack.json';
+  spinner.succeed('Saved testing config to tech-stack.json');
 
-  // Save testing rules markdown
+  // Save testing rules markdown - ask user AFTER spinner is stopped
   const { generateRules } = await inquirer.prompt([
     {
       type: 'confirm',
@@ -414,12 +414,11 @@ export async function runTestSetup(options) {
 
   let rulesPath = null;
   if (generateRules) {
+    const rulesSpinner = ora('Generating TESTING_RULES.md...').start();
     rulesPath = saveTestingRules(testingConfig);
-    spinner.text = 'Saved TESTING_RULES.md to .claude/task-lists/';
+    rulesSpinner.succeed('Saved TESTING_RULES.md to .claude/task-lists/');
   }
 
-  spinner.succeed('Configuration files created');
-
   // Summary
   const details = [
     `Mode: ${TESTING_MODES[config.mode].name}`,

package/src/data/releases.json

@@ -1,5 +1,169 @@
 {
   "releases": [
+    {
+      "version": "1.5.0",
+      "date": "2026-01-30",
+      "summary": "Feature: Phase 5 of 85 Recommendations - Documentation Templates",
+      "highlights": [
+        "Added AI_ARCHITECTURE_CONSTITUTION.template.md - Non-negotiable project rules",
+        "Added PROGRESS_JSON_TEMPLATE.json - Phased development state tracking",
+        "Added DETAILED_GOTCHAS.template.md - Problem-solution patterns",
+        "Added background-agent.template.md - Production orchestration patterns",
+        "Added PHASE-DEV-CHECKLIST.template.md - L1/L2/L3 validation gates"
+      ],
+      "newFeatures": {
+        "commands": [],
+        "agents": [],
+        "skills": [],
+        "hooks": [],
+        "other": [
+          {
+            "name": "templates/docs/",
+            "description": "Documentation templates directory with 5 essential documents"
+          }
+        ]
+      },
+      "breaking": [],
+      "deprecated": []
+    },
+    {
+      "version": "1.4.0",
+      "date": "2026-01-30",
+      "summary": "Feature: Phase 4 of 85 Recommendations - Additional Commands",
+      "highlights": [
+        "Added refactor-check command - Fast pre-commit quality gate",
+        "Added refactor-cleanup command - Auto-fix lint, format, imports",
+        "Added refactor-prep command - Pre-refactoring safety checklist",
+        "Added ask-claude command - Natural language command discovery",
+        "Added create-smoke-test command - Auto-generate Playwright tests",
+        "New 'refactoring' optional feature - Quality tools suite",
+        "New 'testing' optional feature - Advanced test generation"
+      ],
+      "newFeatures": {
+        "commands": [
+          {
+            "name": "refactor-check",
+            "description": "Fast pre-commit quality gate - lint, type-check, test affected"
+          },
+          {
+            "name": "refactor-cleanup",
+            "description": "Daily maintenance automation - fix lint, remove unused imports"
+          },
+          {
+            "name": "refactor-prep",
+            "description": "Pre-refactoring safety checklist - ensure safe conditions"
+          },
+          {
+            "name": "ask-claude",
+            "description": "Natural language command discovery"
+          },
+          {
+            "name": "create-smoke-test",
+            "description": "Auto-generate Playwright smoke tests for critical flows"
+          }
+        ],
+        "agents": [],
+        "skills": [],
+        "hooks": [],
+        "other": []
+      },
+      "breaking": [],
+      "deprecated": []
+    },
+    {
+      "version": "1.3.0",
+      "date": "2026-01-30",
+      "summary": "Feature: Phase 3 of 85 Recommendations - Skills Infrastructure",
+      "highlights": [
+        "Added agent-creator skill template - Best practices for Claude Code agent creation",
+        "Added hook-creator skill template - Hook configuration and implementation patterns",
+        "Added rag-agent-creator skill template - RAG-enhanced knowledge base design",
+        "New 'skillTemplates' optional feature in init.js - Auto-deploys skill templates",
+        "New install-skill CLI command - Install skills post-init",
+        "Skills deployed via ccasp init with recursive directory copy",
+        "Tech-stack.json now tracks deployed skills"
+      ],
+      "newFeatures": {
+        "commands": [
+          {
+            "name": "install-skill",
+            "description": "Install skills to your project after initial setup"
+          }
+        ],
+        "agents": [],
+        "skills": [
+          {
+            "name": "agent-creator",
+            "description": "Create Claude Code agents with proper Task tool configuration"
+          },
+          {
+            "name": "hook-creator",
+            "description": "Create enforcement hooks with JSON schema and event handling"
+          },
+          {
+            "name": "rag-agent-creator",
+            "description": "Create RAG-enhanced agents with structured knowledge bases"
+          }
+        ],
+        "hooks": [],
+        "other": []
+      },
+      "breaking": [],
+      "deprecated": []
+    },
+    {
+      "version": "1.2.0",
+      "date": "2026-01-30",
+      "summary": "Feature: Phase 2 of 85 Recommendations - 7 Advanced Hook Templates",
+      "highlights": [
+        "Added session-id-generator.template.js - UUID sessions with PID-keyed registry",
+        "Added git-commit-tracker.template.js - Track commits per phase in PROGRESS.json",
+        "Added branch-merge-checker.template.js - Validate main branch sync before deployments",
+        "Added issue-completion-detector.template.js - Natural language completion detection",
+        "Added token-usage-monitor.template.js - Cumulative token tracking with respawn warning",
+        "Added autonomous-decision-logger.template.js - JSONL audit trail for agent decisions",
+        "Added phase-validation-gates.template.js - 5-gate validation before phase auto-chaining",
+        "New 'advancedHooks' optional feature in init.js"
+      ],
+      "newFeatures": {
+        "commands": [],
+        "agents": [],
+        "skills": [],
+        "hooks": [
+          {
+            "name": "session-id-generator",
+            "description": "Generates UUID sessions with PID-keyed registry for parallel session isolation"
+          },
+          {
+            "name": "git-commit-tracker",
+            "description": "Tracks git commits per phase and updates PROGRESS.json for rollback support"
+          },
+          {
+            "name": "branch-merge-checker",
+            "description": "Validates main branch sync status before deployments"
+          },
+          {
+            "name": "issue-completion-detector",
+            "description": "Detects completion phrases and triggers deployment pipeline"
+          },
+          {
+            "name": "token-usage-monitor",
+            "description": "Tracks cumulative token usage with auto-respawn warning at 90%"
+          },
+          {
+            "name": "autonomous-decision-logger",
+            "description": "Creates JSONL audit trail for all agent decisions"
+          },
+          {
+            "name": "phase-validation-gates",
+            "description": "5-gate validation before phase auto-chaining"
+          }
+        ],
+        "other": []
+      },
+      "breaking": [],
+      "deprecated": []
+    },
     {
       "version": "1.1.0",
       "date": "2026-01-30",