claude-cli-advanced-starter-pack 1.0.4 → 1.0.7

package/src/commands/init.js

@@ -233,6 +233,18 @@ const AVAILABLE_COMMANDS = [
     selected: false,
     feature: 'deploymentAutomation',
   },
+  {
+    name: 'project-impl',
+    description: 'Agent-powered project implementation (audit, enhance, detect, configure)',
+    category: 'Setup',
+    selected: true,
+  },
+  {
+    name: 'update-check',
+    description: 'Check for CCASP updates and add new features to your project',
+    category: 'Maintenance',
+    selected: true,
+  },
 ];
 
 /**
@@ -296,12 +308,32 @@ function generateMenuCommand(projectName, installedCommands, installedAgents, in
     }
   }
 
+  const ccaspVersion = getVersion();
+
   return `---
 description: Interactive project menu - Quick access to all commands, agents, skills, and tools
 ---
 
 # ${projectName} - Project Menu
 
+## IMPORTANT: Check Update State First
+
+Before displaying the menu, read \`.claude/config/ccasp-state.json\` to check for updates:
+
+\`\`\`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:
+
 \`\`\`
 ╔═══════════════════════════════════════════════════════════════════════════════╗
 ║                                                                               ║
@@ -309,9 +341,50 @@ description: Interactive project menu - Quick access to all commands, agents, sk
 ║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
 ║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
 ║                                                                               ║
-║                    ${projectName.padEnd(40)}                    ║
+║   ${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:                                                              ║
 ║   ─────────────                                                               ║
@@ -324,16 +397,29 @@ description: Interactive project menu - Quick access to all commands, agents, sk
 ║   [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:                                                                 ║
 ║   ───────────                                                                 ║
-║   [R] Refresh Menu       [?] Help               [Q] Exit Menu                 ║
+║   [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\`, display the ASCII menu above and wait for their selection.
+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
 
@@ -354,6 +440,9 @@ When the user invokes \`/menu\`, display the ASCII menu above and wait for their
 | **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 |
@@ -368,26 +457,87 @@ ${hooksSection}
 
 When this command is invoked:
 
-1. **Display the ASCII menu** exactly as shown above
-2. **Ask the user** what they would like to do (show the key bindings)
-3. **Wait for user input** - a single character or command name
-4. **Execute the corresponding action**:
-   - For slash commands: Invoke the command directly
-   - For resource views: Read and display the contents
-   - For R: Redisplay the menu
-   - For Q: End the menu session
+### Step 1: Read Update State
+
+Read \`.claude/config/ccasp-state.json\`:
+
+\`\`\`bash
+cat .claude/config/ccasp-state.json 2>/dev/null || echo "{}"
+\`\`\`
+
+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
+
+### Step 2: Build Dynamic Menu
 
-### Example Interaction
+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:
+
+\`\`\`bash
+# After displaying, update the state file to mark as displayed
 \`\`\`
-User: /menu
-Claude: [Displays ASCII menu]
-Claude: What would you like to do? Enter a key (T/G/P/A/H/S/M/C/E/1-6/R/?/Q):
 
-User: T
-Claude: Running E2E tests... [Invokes /e2e-test]
+Set \`updateFirstDisplayed: true\` in ccasp-state.json using Edit tool.
+
+**Subsequent displays** (\`updateAvailable && updateFirstDisplayed\`):
+Show compact banner only.
+
+### Step 4: Display Menu and Wait for Input
+
+Ask: "What would you like to do? Enter a key:"
+
+### Step 5: Handle User Selection
+
+| 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 |
+| **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
+
+\`\`\`
+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.                          │
+└─────────────────────────────────────────────────────────────┘
 \`\`\`
 
+### 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)
+
 ### Dynamic Content
 
 When displaying resource views (1-6), read the actual contents from:
@@ -1023,10 +1173,8 @@ options:
     description: "Auto-detect + init"
   - label: "Full Setup"
     description: "All features"
-  - label: "Audit"
-    description: "Check CLAUDE.md"
-  - label: "Enhance"
-    description: "Generate CLAUDE.md"
+  - label: "Prior Releases"
+    description: "Add features from updates"
 ---
 
 # CCASP Setup Wizard
@@ -1035,17 +1183,17 @@ Interactive setup wizard for Claude Code CLI enhancement.
 
 ## Quick Options
 
-Reply with a **number** or **letter** to select:
+Reply with a **number** to select:
 
 | # | Action | Description |
 |---|--------|-------------|
 | **1** | Quick Start | Auto-detect stack + init .claude |
 | **2** | Full Setup | All features with customization |
 | **3** | GitHub | Connect project board |
-| **4** | Audit | Check existing CLAUDE.md |
-| **5** | Enhance | Generate/improve CLAUDE.md |
-| **6** | Detect | Show detected tech stack |
-| **7** | Templates | Browse available items |
+| **4** | Templates | Browse available items |
+| **5** | Prior Releases | Review & add features from past versions |
+| **6** | Remove CCASP | Uninstall from this project |
+| **0** | Exit | Close wizard |
 
 ## Feature Presets
 
@@ -1056,6 +1204,11 @@ Reply with a **number** or **letter** to select:
 | **C** | Full | Everything including agents |
 | **D** | Custom | Pick individual features |
 
+## Related Commands
+
+- \`/project-impl\` - Agent-powered project implementation (audit, enhance, detect, configure)
+- \`/update-check\` - Check for updates and add new features to your project
+
 ## Instructions for Claude
 
 When this command is invoked:
@@ -1065,22 +1218,23 @@ When this command is invoked:
    - Does \`CLAUDE.md\` exist? (check with Bash: ls -la CLAUDE.md 2>/dev/null)
    - Is tech stack detected? (check for package.json, pyproject.toml, etc.)
 
-2. **Present the quick options menu** and wait for user selection
+2. **Check for updates** (display banner if new version available)
 
-3. **Handle user selection**:
-   - If user types a number (1-7), execute that action
+3. **Present the quick options menu** and wait for user selection
+
+4. **Handle user selection**:
+   - If user types a number (1-6), execute that action
    - If user types a letter (A-D), apply that preset
    - For "1" (Quick Start): run tech detection, show results, apply Standard preset
-   - For "4" (Audit): check CLAUDE.md against best practices
-   - For "5" (Enhance): offer to generate missing sections
+   - For "5" (Prior Releases): show release history and feature management
 
-4. **For Quick Start**:
+5. **For Quick Start**:
    - Detect tech stack from package.json, config files
    - Show summary of detected stack
    - Create .claude/ folder with commands, settings
    - Generate CLAUDE.md with detected stack info
 
-5. **CRITICAL - Session Restart Reminder**:
+6. **CRITICAL - Session Restart Reminder**:
    After ANY action that modifies \`.claude/\` or \`CLAUDE.md\`, display:
 
    ⚠️  RESTART REQUIRED
@@ -1092,8 +1246,8 @@ When this command is invoked:
    2. Restart: claude or claude .
    3. New commands will be available
 
-   Actions requiring restart: 1, 2, 3, 5
-   Actions NOT requiring restart: 4 (audit), 6 (detect), 7 (templates)
+   Actions requiring restart: 1, 2, 3, 5 (if features added)
+   Actions NOT requiring restart: 4 (templates)
 
 ## Vibe-Code Design
 
@@ -1223,7 +1377,101 @@ export default async function ${hookName.replace(/-/g, '_')}(context) {
 }
 
 /**
- * Generate settings.json
+ * Generate CCASP update check hook (fallback if template not found)
+ */
+function generateUpdateCheckHook() {
+  return `/**
+ * CCASP Update Check Hook
+ *
+ * Checks for npm updates when Claude Code starts.
+ * Runs on first UserPromptSubmit per session, caches results for 1 hour.
+ *
+ * Event: UserPromptSubmit
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_NAME = 'claude-cli-advanced-starter-pack';
+const CACHE_DURATION = 60 * 60 * 1000;
+const STATE_FILE = '.claude/config/ccasp-state.json';
+const SESSION_MARKER = '.claude/config/.ccasp-session-checked';
+
+function loadState() {
+  const statePath = path.join(process.cwd(), STATE_FILE);
+  if (fs.existsSync(statePath)) {
+    try { return JSON.parse(fs.readFileSync(statePath, 'utf8')); } catch {}
+  }
+  return { lastCheckTimestamp: 0, updateAvailable: false };
+}
+
+function saveState(state) {
+  const statePath = path.join(process.cwd(), STATE_FILE);
+  const stateDir = path.dirname(statePath);
+  if (!fs.existsSync(stateDir)) fs.mkdirSync(stateDir, { recursive: true });
+  fs.writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
+}
+
+function hasCheckedThisSession() {
+  const markerPath = path.join(process.cwd(), SESSION_MARKER);
+  if (fs.existsSync(markerPath)) {
+    try {
+      const timestamp = parseInt(fs.readFileSync(markerPath, 'utf8'), 10);
+      if (Date.now() - timestamp < 4 * 60 * 60 * 1000) return true;
+    } catch {}
+  }
+  return false;
+}
+
+function markSessionChecked() {
+  const markerPath = path.join(process.cwd(), SESSION_MARKER);
+  const markerDir = path.dirname(markerPath);
+  if (!fs.existsSync(markerDir)) fs.mkdirSync(markerDir, { recursive: true });
+  fs.writeFileSync(markerPath, Date.now().toString(), 'utf8');
+}
+
+function compareVersions(v1, v2) {
+  if (!v1 || !v2) return 0;
+  const p1 = v1.split('.').map(Number), p2 = v2.split('.').map(Number);
+  for (let i = 0; i < Math.max(p1.length, p2.length); i++) {
+    if ((p1[i] || 0) > (p2[i] || 0)) return 1;
+    if ((p1[i] || 0) < (p2[i] || 0)) return -1;
+  }
+  return 0;
+}
+
+module.exports = async function ccaspUpdateCheck(context) {
+  if (hasCheckedThisSession()) return { continue: true };
+  markSessionChecked();
+
+  const state = loadState();
+  const now = Date.now();
+
+  if (state.lastCheckTimestamp && (now - state.lastCheckTimestamp) < CACHE_DURATION) {
+    return { continue: true };
+  }
+
+  try {
+    const current = execSync('npm list -g ' + PACKAGE_NAME + ' --json 2>/dev/null', { encoding: 'utf8', timeout: 5000 });
+    const currentVersion = JSON.parse(current).dependencies?.[PACKAGE_NAME]?.version;
+
+    const latest = execSync('npm view ' + PACKAGE_NAME + ' version', { encoding: 'utf8', timeout: 10000 }).trim();
+
+    state.lastCheckTimestamp = now;
+    state.currentVersion = currentVersion;
+    state.latestVersion = latest;
+    state.updateAvailable = compareVersions(latest, currentVersion) > 0;
+    saveState(state);
+  } catch {}
+
+  return { continue: true };
+};
+`;
+}
+
+/**
+ * Generate settings.json with CCASP update check hook
  */
 function generateSettingsJson(projectName) {
   return JSON.stringify({
@@ -1232,7 +1480,19 @@ function generateSettingsJson(projectName) {
       "allow": [],
       "deny": []
     },
-    "hooks": {}
+    "hooks": {
+      "UserPromptSubmit": [
+        {
+          "matcher": "",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "node .claude/hooks/ccasp-update-check.js"
+            }
+          ]
+        }
+      ]
+    }
   }, null, 2);
 }
 
@@ -1398,6 +1658,24 @@ export async function runInit(options = {}) {
     console.log(chalk.blue(`  ○ hooks/ has ${hookFiles.length} existing hook(s) (preserved)`));
   }
 
+  // Always deploy the CCASP update check hook (essential for update notifications)
+  const updateCheckHookPath = join(hooksDir, 'ccasp-update-check.js');
+  if (!existsSync(updateCheckHookPath)) {
+    // Try to read from template
+    const templatePath = join(__dirname, '..', '..', 'templates', 'hooks', 'ccasp-update-check.template.js');
+    if (existsSync(templatePath)) {
+      const hookContent = readFileSync(templatePath, 'utf8');
+      writeFileSync(updateCheckHookPath, hookContent, 'utf8');
+      console.log(chalk.green('  ✓ Created hooks/ccasp-update-check.js (update notifications)'));
+    } else {
+      // Fallback: create minimal version
+      writeFileSync(updateCheckHookPath, generateUpdateCheckHook(), 'utf8');
+      console.log(chalk.green('  ✓ Created hooks/ccasp-update-check.js (update notifications)'));
+    }
+  } else {
+    console.log(chalk.blue('  ○ hooks/ccasp-update-check.js exists (preserved)'));
+  }
+
   console.log('');
 
   // Step 4: Select optional features