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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-cli-advanced-starter-pack",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "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

@@ -355,328 +355,87 @@ const AVAILABLE_COMMANDS = [
 ];
 
 /**
- * Generate the sophisticated /menu command
+ * Generate the /menu command - launches CCASP Panel in new terminal
  */
 function generateMenuCommand(projectName, installedCommands, installedAgents, installedSkills, installedHooks) {
   const date = new Date().toISOString().split('T')[0];
 
-  // Group commands by category
-  const commandsByCategory = {};
+  // Build command list for reference
+  let commandList = '';
   for (const cmdName of installedCommands) {
     const cmd = AVAILABLE_COMMANDS.find((c) => c.name === cmdName);
     if (cmd && cmd.name !== 'menu') {
-      if (!commandsByCategory[cmd.category]) {
-        commandsByCategory[cmd.category] = [];
-      }
-      commandsByCategory[cmd.category].push(cmd);
-    }
-  }
-
-  // Build category sections for the menu
-  let categoryMenuItems = '';
-  let categoryInstructions = '';
-  let keyIndex = 1;
-  const keyMap = {};
-
-  for (const [category, cmds] of Object.entries(commandsByCategory)) {
-    categoryMenuItems += `\n### ${category}\n`;
-    for (const cmd of cmds) {
-      const key = keyIndex <= 9 ? keyIndex.toString() : String.fromCharCode(65 + keyIndex - 10); // 1-9, then A-Z
-      keyMap[key] = cmd.name;
-      categoryMenuItems += `- **[${key}]** \`/${cmd.name}\` - ${cmd.description}\n`;
-      keyIndex++;
-    }
-  }
-
-  // Build agents section
-  let agentsSection = '';
-  if (installedAgents.length > 0) {
-    agentsSection = `\n### Agents\n`;
-    for (const agent of installedAgents) {
-      agentsSection += `- **${agent}** - Custom agent\n`;
+      commandList += `| /${cmd.name} | ${cmd.description} |\n`;
     }
   }
 
-  // Build skills section
-  let skillsSection = '';
-  if (installedSkills.length > 0) {
-    skillsSection = `\n### Skills\n`;
-    for (const skill of installedSkills) {
-      skillsSection += `- **${skill}** - Custom skill\n`;
-    }
-  }
-
-  // Build hooks section
-  let hooksSection = '';
-  if (installedHooks.length > 0) {
-    hooksSection = `\n### Active Hooks\n`;
-    for (const hook of installedHooks) {
-      hooksSection += `- **${hook}**\n`;
-    }
-  }
-
-  const ccaspVersion = getVersion();
-
   return `---
-description: Interactive project menu - Quick access to all commands, agents, skills, and tools
+description: Launch CCASP Control Panel - Interactive menu in separate terminal
 ---
 
-# ${projectName} - Project Menu
-
-## CRITICAL FIRST STEP: Check for Updates
-
-**BEFORE doing anything else**, you MUST read the update state file:
-
-\`\`\`
-Read file: .claude/config/ccasp-state.json
-\`\`\`
-
-Use the Read tool NOW to read \`.claude/config/ccasp-state.json\`. If it doesn't exist, that's fine - proceed without update banner.
-
-If the file exists and contains \`"updateAvailable": true\`, you MUST display the update banner BEFORE the menu.
-
-Example state file contents:
-\`\`\`javascript
-{
-  "currentVersion": "1.0.5",
-  "latestVersion": "1.0.6",
-  "updateAvailable": true,
-  "updateHighlights": [...],
-  "updateFirstDisplayed": false
-}
-\`\`\`
-
-## Dynamic Menu Header
-
-Build the header based on update state. Replace \`{{VERSION}}\` and \`{{UPDATE_STATUS}}\` dynamically:
-
-\`\`\`
-╔═══════════════════════════════════════════════════════════════════════════════╗
-║                                                                               ║
-║   ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔╦╗╦  ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗  ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗       ║
-║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
-║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
-║                                                                               ║
-║   ${projectName.padEnd(35)}  v{{VERSION}} {{UPDATE_STATUS}}     ║
-║                                                                               ║
-╠═══════════════════════════════════════════════════════════════════════════════╣
-\`\`\`
-
-**If update is available**, replace:
-- \`{{VERSION}}\` with current version (e.g., "1.0.5")
-- \`{{UPDATE_STATUS}}\` with \`[NEW UPDATE]\` in bold/highlighted
-
-**If up to date**, replace:
-- \`{{VERSION}}\` with current version
-- \`{{UPDATE_STATUS}}\` with empty string
-
-## Update Banner (Show When Update Available)
-
-If \`updateAvailable: true\`, display this banner BEFORE the main menu:
-
-\`\`\`
-┌─────────────────────────────────────────────────────────────────────────────┐
-│  📦 NEW UPDATE AVAILABLE: v{{currentVersion}} → v{{latestVersion}}          │
-├─────────────────────────────────────────────────────────────────────────────┤
-│  What's New:                                                                │
-│  {{#each updateHighlights}}                                                 │
-│    • {{summary}}                                                            │
-│  {{/each}}                                                                  │
-├─────────────────────────────────────────────────────────────────────────────┤
-│  Press [N] to update now  │  Press [U] for details  │  Press any to dismiss │
-└─────────────────────────────────────────────────────────────────────────────┘
-\`\`\`
-
-**IMPORTANT**: After displaying the update banner for the first time, update the state file:
-\`updateFirstDisplayed: true\` - This prevents showing the full highlights again.
-
-On subsequent displays (when \`updateFirstDisplayed: true\`), show a compact banner:
-
-\`\`\`
-┌──────────────────────────────────────────────────────────────┐
-│ 📦 Update available: v{{currentVersion}} → v{{latestVersion}} │ [N] Update │
-└──────────────────────────────────────────────────────────────┘
-\`\`\`
-
-## Main Menu Body
-
-\`\`\`
-║                                                                               ║
-║   Quick Actions:                                                              ║
-║   ─────────────                                                               ║
-║   [T] Run Tests          [G] GitHub Task        [P] Phase Dev Plan            ║
-║   [A] Create Agent       [H] Create Hook        [S] Create Skill              ║
-║   [M] Explore MCP        [C] Claude Audit       [E] Explore Codebase          ║
-║   [⚡] Launch Panel      Open control panel in new terminal window            ║
-║                                                                               ║
-║   Project Resources:                                                          ║
-║   ──────────────────                                                          ║
-║   [1] View Agents        [2] View Skills        [3] View Hooks                ║
-║   [4] View Commands      [5] Settings           [6] Documentation             ║
-║                                                                               ║
-║   Project Implementation:                                                     ║
-║   ───────────────────────                                                     ║
-║   [I] /project-impl      Agent-powered setup & configuration                  ║
-║                                                                               ║
-║   Navigation:                                                                 ║
-║   ───────────                                                                 ║
-║   [U] Check for Updates  [R] Refresh Menu       [?] Help       [Q] Exit      ║
-{{#if updateAvailable}}
-║   [N] UPDATE NOW         Run: npm update -g claude-cli-advanced-starter-pack  ║
-{{/if}}
-║                                                                               ║
-╚═══════════════════════════════════════════════════════════════════════════════╝
-\`\`\`
-
-## How to Use This Menu
-
-When the user invokes \`/menu\`:
-
-1. **Read update state**: Check \`.claude/config/ccasp-state.json\` for cached update info
-2. **Build dynamic header**: Include version number and update status
-3. **Show update banner**: If updates available, show banner with highlights (first time) or compact (subsequent)
-4. **Display the menu**: Show the ASCII art menu with dynamic content
-5. **Wait for input**: Accept single character or command name
-
-### Key Bindings
-
-| Key | Action | Command |
-|-----|--------|---------|
-| **T** | Run E2E Tests | \`/e2e-test\` |
-| **G** | Create GitHub Task | \`/github-task\` |
-| **P** | Create Phase Dev Plan | \`/phase-dev-plan\` |
-| **A** | Create Agent | \`/create-agent\` |
-| **H** | Create Hook | \`/create-hook\` |
-| **S** | Create Skill | \`/create-skill\` |
-| **M** | Explore MCP Servers | \`/explore-mcp\` |
-| **C** | Claude Audit | \`/claude-audit\` |
-| **E** | Explore Codebase | \`/codebase-explorer\` |
-| **⚡** or **L** | Launch Panel | \`/ccasp-panel\` (opens in new terminal) |
-| **1** | List project agents | Read \`.claude/agents/\` |
-| **2** | List project skills | Read \`.claude/skills/\` |
-| **3** | List active hooks | Read \`.claude/hooks/\` |
-| **4** | List all commands | Read \`.claude/commands/INDEX.md\` |
-| **5** | View/edit settings | Read \`.claude/settings.json\` |
-| **6** | Open documentation | Read \`.claude/docs/\` |
-| **I** | Project Implementation | \`/project-impl\` |
-| **U** | Check for Updates | \`/update-check\` |
-| **N** | Update Now | Run npm update (only shown when update available) |
-| **R** | Refresh and redisplay menu | Re-invoke \`/menu\` |
-| **?** | Show help | Display command descriptions |
-| **Q** | Exit menu | End menu interaction |
-
-## Installed Commands
-${categoryMenuItems}
-${agentsSection}
-${skillsSection}
-${hooksSection}
+# ${projectName} - Menu
 
 ## Instructions for Claude
 
-When this command is invoked:
+**EXECUTE IMMEDIATELY**: Launch the CCASP Control Panel in a new terminal window.
 
-### Step 1: Read Update State
+### Step 1: Launch Panel
 
-Read \`.claude/config/ccasp-state.json\`:
+Use the Bash tool to run this command:
 
+**Windows:**
 \`\`\`bash
-cat .claude/config/ccasp-state.json 2>/dev/null || echo "{}"
+start powershell -NoExit -Command "ccasp panel"
 \`\`\`
 
-Parse the JSON to extract:
-- \`currentVersion\`: Installed CCASP version
-- \`latestVersion\`: Latest version on npm
-- \`updateAvailable\`: Boolean indicating if update exists
-- \`updateHighlights\`: Array of release summaries
-- \`updateFirstDisplayed\`: Whether full highlights have been shown
-- \`projectImplCompleted\`: Whether user has run /project-impl (default: false)
-
-### Step 2: Build Dynamic Menu
-
-Replace template variables in the menu:
-- \`{{VERSION}}\` → currentVersion (e.g., "1.0.6")
-- \`{{UPDATE_STATUS}}\` → "[NEW UPDATE]" if updateAvailable, else ""
-
-### Step 3: Display Update Banner (If Applicable)
-
-**First time showing update** (\`updateAvailable && !updateFirstDisplayed\`):
-Show full banner with highlights, then update state:
-
+**macOS:**
 \`\`\`bash
-# After displaying, update the state file to mark as displayed
+osascript -e 'tell application "Terminal" to do script "ccasp panel"'
 \`\`\`
 
-Set \`updateFirstDisplayed: true\` in ccasp-state.json using Edit tool.
-
-**Subsequent displays** (\`updateAvailable && updateFirstDisplayed\`):
-Show compact banner only.
-
-### Step 3b: Show Setup Recommendation (If Applicable)
-
-If \`projectImplCompleted\` is \`false\` or missing, display this banner at the BOTTOM of the menu (after the closing box but before the input prompt):
-
-\`\`\`
-💡 Tip: Run /project-impl to configure your project (audit CLAUDE.md, detect tech stack, set up deployment)
+**Linux:**
+\`\`\`bash
+gnome-terminal -- ccasp panel &
 \`\`\`
 
-This banner should be subtle - just a single line tip. Once the user runs any option in /project-impl, update the state file to set \`projectImplCompleted: true\` and this banner will no longer appear.
-
-### Step 4: Display Menu and Wait for Input
-
-Ask: "What would you like to do? Enter a key:"
-
-### Step 5: Handle User Selection
+### Step 2: Confirm Launch
 
-| Key | Action |
-|-----|--------|
-| **N** | **Update Now**: Run \`npm update -g claude-cli-advanced-starter-pack\` via Bash, then show: "Update complete! Restart Claude Code CLI to use new features." |
-| **U** | Invoke \`/update-check\` for detailed update info and feature management |
-| **I** | Invoke \`/project-impl\` for project implementation |
-| **⚡** or **L** | **Launch Panel**: Run \`start powershell -NoExit -Command "ccasp panel"\` (Windows) or equivalent to open control panel in new terminal |
-| **R** | Re-invoke \`/menu\` (refresh) |
-| **Q** | End menu session |
-| **1-6** | Read and display the corresponding resource |
-| **Other** | Invoke the corresponding slash command |
-
-### Example: Update Now Flow
+After running the command, display this confirmation:
 
 \`\`\`
-User: N
-
-Claude: Updating CCASP...
-
-[Runs: npm update -g claude-cli-advanced-starter-pack]
-
-Claude:
-┌─────────────────────────────────────────────────────────────┐
-│  ✅ Update Complete!                                         │
-│                                                              │
-│  Updated: v1.0.5 → v1.0.6                                   │
-│                                                              │
-│  ⚠️  RESTART REQUIRED                                        │
-│  Exit and restart Claude Code CLI to use new features.      │
-│                                                              │
-│  Then run: ccasp wizard → select "Prior Releases" to add    │
-│  any new commands to this project.                          │
-└─────────────────────────────────────────────────────────────┘
+✅ CCASP Control Panel launched in a new terminal window!
+
+┌─────────────────────────────────────────────────────────────────┐
+│ CCASP Control Panel (NEW WINDOW)                                │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  Agents & Skills:                                               │
+│    [A] Create Agent     [H] Create Hook      [S] Create Skill  │
+│    [M] Explore MCP      [C] Claude Audit     [E] Explore Code  │
+│                                                                 │
+│  Quick Actions:                                                 │
+│    [P] Phase Dev Plan   [G] GitHub Task      [T] Run E2E Tests │
+│    [U] Update Check                                             │
+│                                                                 │
+│  Controls:                                                      │
+│    [Q] Quit   [R] Refresh   [X] Clear Queue   [?] Help         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+
+How to use:
+1. Switch to the new PowerShell window with the panel
+2. Press a single key to select a command (e.g., 'A' for Create Agent)
+3. Return to this Claude Code session
+4. Press Enter on an empty prompt - the command will execute automatically
 \`\`\`
 
-### Update Check Behavior
-
-- The startup hook (\`ccasp-update-check.js\`) runs automatically on first prompt
-- Checks npm registry with 1-hour cache
-- Stores result in \`.claude/config/ccasp-state.json\`
-- Menu reads this cached state (no network call needed)
+## Direct Commands (Alternative)
 
-### Dynamic Content
+If the panel doesn't work, you can invoke these commands directly:
 
-When displaying resource views (1-6), read the actual contents from:
-- Agents: \`.claude/agents/*.md\` files
-- Skills: \`.claude/skills/*/skill.md\` files
-- Hooks: \`.claude/hooks/*.js\` files
-- Commands: \`.claude/commands/INDEX.md\`
-- Settings: \`.claude/settings.json\` and \`.claude/settings.local.json\`
-- Docs: \`.claude/docs/\` directory listing
+| Command | Description |
+|---------|-------------|
+${commandList}
 
 ---
 

package/src/commands/install-panel-hook.js

@@ -66,24 +66,34 @@ export async function runInstallPanelHook(options = {}) {
     }
   }
 
-  // Ensure hooks array exists
+  // Ensure hooks object exists (new v2.x format)
   if (!settings.hooks) {
-    settings.hooks = [];
+    settings.hooks = {};
   }
 
-  // Check if hook already registered
-  const hookConfig = {
-    event: 'UserPromptSubmit',
-    command: `node ${hookPath}`
-  };
+  // Ensure UserPromptSubmit array exists
+  if (!settings.hooks.UserPromptSubmit) {
+    settings.hooks.UserPromptSubmit = [];
+  }
 
-  const existingHook = settings.hooks.find(h =>
-    h.event === 'UserPromptSubmit' &&
-    h.command?.includes('panel-queue-reader')
+  // Check if hook already registered (new v2.x format)
+  const existingHook = settings.hooks.UserPromptSubmit.find(h =>
+    h.hooks?.some(hook => hook.command?.includes('panel-queue-reader'))
   );
 
   if (!existingHook) {
-    settings.hooks.push(hookConfig);
+    // New Claude Code v2.x hooks format
+    const hookConfig = {
+      matcher: '',  // Empty string = match all (NOT empty object!)
+      hooks: [
+        {
+          type: 'command',
+          command: `node ${hookPath}`
+        }
+      ]
+    };
+
+    settings.hooks.UserPromptSubmit.push(hookConfig);
 
     // Ensure settings directory exists
     const settingsDir = dirname(settingsPath);