claude-cli-advanced-starter-pack 1.8.5 → 1.8.6

package/package.json

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

package/src/cli/menu.js

@@ -799,7 +799,7 @@ export async function showMainMenu() {
       name: 'action',
       message: 'Select an option:',
       choices,
-      pageSize: 10,
+      pageSize: 20,
     },
   ]);
 

package/src/commands/explore-mcp/claude-md-updater.js

@@ -7,8 +7,33 @@
 
 import chalk from 'chalk';
 import ora from 'ora';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'fs';
+import { join, basename } from 'path';
+
+/**
+ * Create a backup of CLAUDE.md before modification
+ * @param {string} filePath - Path to CLAUDE.md
+ * @param {string} cwd - Working directory
+ * @returns {string|null} Backup path or null if failed
+ */
+function backupClaudeMd(filePath, cwd) {
+  if (!existsSync(filePath)) return null;
+
+  const backupDir = join(cwd, '.claude', 'backups');
+  if (!existsSync(backupDir)) {
+    mkdirSync(backupDir, { recursive: true });
+  }
+
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const backupPath = join(backupDir, `CLAUDE.md.${timestamp}.bak`);
+
+  try {
+    copyFileSync(filePath, backupPath);
+    return backupPath;
+  } catch {
+    return null;
+  }
+}
 
 /**
  * MCP section marker
@@ -158,6 +183,12 @@ ${mcpSection}
       };
     }
 
+    // Backup existing CLAUDE.md before modification
+    const backupPath = backupClaudeMd(claudeMdPath, cwd);
+    if (backupPath) {
+      spinner.text = 'Backed up CLAUDE.md...';
+    }
+
     // Check if MCP section exists
     const hasStartMarker = content.includes(MCP_SECTION_START);
     const hasEndMarker = content.includes(MCP_SECTION_END);
@@ -193,12 +224,13 @@ ${mcpSection}
     }
 
     writeFileSync(claudeMdPath, content, 'utf8');
-    spinner.succeed('Updated CLAUDE.md with MCP documentation');
+    spinner.succeed(`Updated CLAUDE.md with MCP documentation${backupPath ? ' (backup created)' : ''}`);
 
     return {
       success: true,
       action: hasStartMarker ? 'updated' : 'appended',
       path: claudeMdPath,
+      backupPath: backupPath || null,
     };
   } catch (error) {
     spinner.fail(`Failed to update CLAUDE.md: ${error.message}`);
@@ -225,6 +257,9 @@ export function removeMcpSection(cwd = process.cwd()) {
   const hasEndMarker = content.includes(MCP_SECTION_END);
 
   if (hasStartMarker && hasEndMarker) {
+    // Backup before removal
+    backupClaudeMd(claudeMdPath, cwd);
+
     const regex = new RegExp(
       `\\n?${MCP_SECTION_START}[\\s\\S]*?${MCP_SECTION_END}\\n?`,
       'g'

package/src/commands/init.js

@@ -219,6 +219,12 @@ const AVAILABLE_COMMANDS = [
     category: 'Claude Code',
     selected: true,
   },
+  {
+    name: 'detect-tech-stack',
+    description: 'Re-run tech stack detection and update configuration',
+    category: 'Analysis',
+    selected: true,
+  },
   {
     name: 'roadmap-sync',
     description: 'Sync roadmaps with GitHub Project Board',
@@ -2795,3 +2801,86 @@ npx claude-cli-advanced-starter-pack init --force
 
   return content;
 }
+
+/**
+ * Verify and fix legacy installations (pre-v1.0.8)
+ * Issue #8: Ensures update-check hook is properly configured
+ *
+ * @param {string} projectDir - Project directory to verify
+ * @returns {Object} Verification result with fixes applied
+ */
+export async function verifyLegacyInstallation(projectDir = process.cwd()) {
+  const fixes = [];
+  const issues = [];
+
+  const claudeDir = join(projectDir, '.claude');
+  const hooksDir = join(claudeDir, 'hooks');
+  const settingsPath = join(claudeDir, 'settings.json');
+  const updateCheckHookPath = join(hooksDir, 'ccasp-update-check.js');
+
+  // Check if this is a CCASP installation
+  if (!existsSync(claudeDir)) {
+    return { isLegacy: false, message: 'No .claude folder found' };
+  }
+
+  // Check 1: Does the update-check hook file exist?
+  if (!existsSync(updateCheckHookPath)) {
+    issues.push('Missing ccasp-update-check.js hook file');
+
+    // Fix: Create the hook file
+    if (!existsSync(hooksDir)) {
+      mkdirSync(hooksDir, { recursive: true });
+    }
+
+    const templatePath = join(__dirname, '..', '..', 'templates', 'hooks', 'ccasp-update-check.template.js');
+    if (existsSync(templatePath)) {
+      const hookContent = readFileSync(templatePath, 'utf8');
+      writeFileSync(updateCheckHookPath, hookContent, 'utf8');
+      fixes.push('Created ccasp-update-check.js hook file');
+    }
+  }
+
+  // Check 2: Is the hook registered in settings.json?
+  if (existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+
+      // Check if UserPromptSubmit hook exists with update-check
+      const hasUpdateHook = settings.hooks?.UserPromptSubmit?.some(
+        (h) => h.hooks?.some((hook) => hook.command?.includes('ccasp-update-check'))
+      );
+
+      if (!hasUpdateHook) {
+        issues.push('Update-check hook not registered in settings.json');
+
+        // Fix: Add the hook to settings.json
+        if (!settings.hooks) settings.hooks = {};
+        if (!settings.hooks.UserPromptSubmit) {
+          settings.hooks.UserPromptSubmit = [];
+        }
+
+        settings.hooks.UserPromptSubmit.push({
+          matcher: '',
+          hooks: [{
+            type: 'command',
+            command: 'node .claude/hooks/ccasp-update-check.js',
+          }],
+        });
+
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+        fixes.push('Registered update-check hook in settings.json');
+      }
+    } catch {
+      issues.push('Could not parse settings.json');
+    }
+  }
+
+  return {
+    isLegacy: issues.length > 0,
+    issues,
+    fixes,
+    message: fixes.length > 0
+      ? `Fixed ${fixes.length} legacy installation issue(s)`
+      : 'Installation is up to date',
+  };
+}

package/src/commands/setup-wizard.js

@@ -578,43 +578,60 @@ function showSetupHeader() {
 }
 
 /**
- * Quick setup options - numbered for easy mobile input
+ * Streamlined setup options - 3 core paths for easy mobile input
+ * Issue #8: Simplified from 7 options to reduce scrolling
  */
 const SETUP_OPTIONS = [
   {
-    name: `${chalk.yellow('1.')} Quick Start ${chalk.dim('- Detect stack + init .claude')}`,
-    value: 'quick',
-    short: 'Quick Start',
+    name: `${chalk.green('1.')} Auto Install ${chalk.dim('- Full features + backup (recommended)')}`,
+    value: 'auto',
+    short: 'Auto Install',
   },
   {
-    name: `${chalk.yellow('2.')} Full Setup ${chalk.dim('- All features + customization')}`,
-    value: 'full',
-    short: 'Full Setup',
-  },
-  {
-    name: `${chalk.yellow('3.')} GitHub Setup ${chalk.dim('- Connect project board')}`,
+    name: `${chalk.yellow('2.')} GitHub Setup ${chalk.dim('- Connect project board')}`,
     value: 'github',
     short: 'GitHub',
   },
   {
-    name: `${chalk.yellow('4.')} View Templates ${chalk.dim('- Browse available items')}`,
+    name: `${chalk.dim('3.')} More Options ${chalk.dim('- Templates, releases, remove')}`,
+    value: 'more',
+    short: 'More',
+  },
+  {
+    name: `${chalk.dim('0.')} Exit`,
+    value: 'exit',
+    short: 'Exit',
+  },
+];
+
+/**
+ * Advanced options submenu - accessed via "More Options"
+ */
+const ADVANCED_OPTIONS = [
+  {
+    name: `${chalk.yellow('1.')} Custom Setup ${chalk.dim('- Choose specific features')}`,
+    value: 'custom',
+    short: 'Custom',
+  },
+  {
+    name: `${chalk.yellow('2.')} View Templates ${chalk.dim('- Browse available items')}`,
     value: 'templates',
     short: 'Templates',
   },
   {
-    name: `${chalk.yellow('5.')} Prior Releases ${chalk.dim('- Review & add features from past versions')}`,
+    name: `${chalk.yellow('3.')} Prior Releases ${chalk.dim('- Add features from past versions')}`,
     value: 'releases',
     short: 'Releases',
   },
   {
-    name: `${chalk.yellow('6.')} Remove CCASP ${chalk.dim('- Uninstall from this project')}`,
+    name: `${chalk.yellow('4.')} Remove CCASP ${chalk.dim('- Uninstall from this project')}`,
     value: 'remove',
     short: 'Remove',
   },
   {
-    name: `${chalk.yellow('0.')} Exit`,
-    value: 'exit',
-    short: 'Exit',
+    name: `${chalk.dim('0.')} Back`,
+    value: 'back',
+    short: 'Back',
   },
 ];
 
@@ -1292,7 +1309,7 @@ export async function runSetupWizard(options = {}) {
     console.log(chalk.green('✓ CLAUDE.md exists\n'));
   }
 
-  // Main menu loop
+  // Main menu loop - streamlined 3-path flow (Issue #8)
   let running = true;
   while (running) {
     const { action } = await inquirer.prompt([
@@ -1301,28 +1318,67 @@ export async function runSetupWizard(options = {}) {
         name: 'action',
         message: 'What would you like to do?',
         choices: SETUP_OPTIONS,
-        pageSize: 12,
+        pageSize: 6, // All options visible without scrolling
       },
     ]);
 
     switch (action) {
-      case 'quick':
-        const quickSuccess = await runQuickSetup();
-        if (quickSuccess) running = false;
-        break;
-
-      case 'full':
-        await runInit({ interactive: true });
+      case 'auto':
+        // Auto Install: Full features with mandatory backup (Issue #8 requirement)
+        console.log(chalk.cyan('\n📦 Auto Install Mode - Full features with backup\n'));
+        await runInit({
+          interactive: false,
+          backup: true,  // Mandatory backup
+          force: true,   // Overwrite enabled for testing phase
+          skipPrompts: true,
+          preset: 'full' // All features
+        });
         showRestartReminder();
         running = false;
         break;
 
       case 'github':
         await runGitHubSetup({});
-        // GitHub setup modifies .claude/ config
         showRestartReminder();
         break;
 
+      case 'more':
+        // Advanced options submenu
+        await showAdvancedOptions();
+        break;
+
+      case 'exit':
+        running = false;
+        console.log(chalk.dim('\nRun `ccasp wizard` anytime to return.\n'));
+        break;
+    }
+  }
+}
+
+/**
+ * Advanced options submenu - Issue #8: Moved less-used options here
+ */
+async function showAdvancedOptions() {
+  let inSubmenu = true;
+
+  while (inSubmenu) {
+    const { action } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'action',
+        message: 'Advanced Options:',
+        choices: ADVANCED_OPTIONS,
+        pageSize: 6,
+      },
+    ]);
+
+    switch (action) {
+      case 'custom':
+        await runInit({ interactive: true });
+        showRestartReminder();
+        inSubmenu = false;
+        break;
+
       case 'templates':
         await showTemplates();
         break;
@@ -1334,13 +1390,12 @@ export async function runSetupWizard(options = {}) {
       case 'remove':
         const removed = await runRemove();
         if (removed) {
-          running = false; // Exit wizard after removal
+          inSubmenu = false;
         }
         break;
 
-      case 'exit':
-        running = false;
-        console.log(chalk.dim('\nRun `ccasp wizard` anytime to return.\n'));
+      case 'back':
+        inSubmenu = false;
         break;
     }
   }

package/src/data/releases.json

@@ -1,5 +1,20 @@
 {
   "releases": [
+    {
+      "version": "1.8.6",
+      "date": "2026-01-31",
+      "summary": "Release notes pending",
+      "highlights": [],
+      "newFeatures": {
+        "commands": [],
+        "agents": [],
+        "skills": [],
+        "hooks": [],
+        "other": []
+      },
+      "breaking": [],
+      "deprecated": []
+    },
     {
       "version": "1.8.5",
       "date": "2026-01-31",

package/src/utils/version-check.js

@@ -19,8 +19,9 @@ const PACKAGE_NAME = 'claude-cli-advanced-starter-pack';
 // Cache duration: 1 hour (in milliseconds)
 const CACHE_DURATION = 60 * 60 * 1000;
 
-// Update notification duration: 1 day (in milliseconds)
-const UPDATE_NOTIFICATION_DURATION = 24 * 60 * 60 * 1000;
+// Update notification reminder: Show reminder again after 7 days
+// Issue #8: Changed from 1-day suppression to 7-day reminder
+const UPDATE_NOTIFICATION_REMINDER = 7 * 24 * 60 * 60 * 1000;
 
 /**
  * Get the current installed version from package.json
@@ -313,19 +314,52 @@ export function compareVersions(v1, v2) {
 /**
  * Check npm registry for the latest version
  * Returns null if check fails (network error, etc.)
+ * Issue #8: Added npm registry API fallback for Windows compatibility
  */
 export async function checkLatestVersion() {
+  // Try npm CLI first
   try {
-    // Use npm view command to get latest version
     const result = execSync(`npm view ${PACKAGE_NAME} version`, {
       encoding: 'utf8',
-      timeout: 10000, // 10 second timeout
+      timeout: 10000,
       stdio: ['pipe', 'pipe', 'pipe'],
     });
 
-    return result.trim();
+    const version = result.trim();
+    if (version && /^\d+\.\d+\.\d+/.test(version)) {
+      return version;
+    }
+  } catch {
+    // npm CLI failed, try fallback
+  }
+
+  // Fallback: Direct npm registry API call (Issue #8 fix)
+  try {
+    const https = await import('https');
+    return new Promise((resolve) => {
+      const req = https.default.get(
+        `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
+        { timeout: 8000 },
+        (res) => {
+          let data = '';
+          res.on('data', (chunk) => (data += chunk));
+          res.on('end', () => {
+            try {
+              const pkg = JSON.parse(data);
+              resolve(pkg.version || null);
+            } catch {
+              resolve(null);
+            }
+          });
+        }
+      );
+      req.on('error', () => resolve(null));
+      req.on('timeout', () => {
+        req.destroy();
+        resolve(null);
+      });
+    });
   } catch {
-    // Silently fail - network might be unavailable
     return null;
   }
 }
@@ -436,17 +470,9 @@ export function shouldShowUpdateNotification(state, latestVersion) {
     return false;
   }
 
-  // Check if we have a cached check result with timestamp
-  if (state.lastCheckResult && state.lastCheckTimestamp) {
-    const timeSinceCheck = Date.now() - state.lastCheckTimestamp;
-
-    // If check is more than 1 day old, don't show notification
-    // (user needs to run check again to see new updates)
-    if (timeSinceCheck > UPDATE_NOTIFICATION_DURATION) {
-      return false;
-    }
-  }
-
+  // Issue #8: Always show notification if update is available
+  // The old logic suppressed notifications after 1 day, which was counterproductive
+  // Now we always show if there's an update, regardless of cache age
   return true;
 }
 

package/templates/commands/create-task-list-for-issue.template.md

@@ -197,6 +197,78 @@ gh issue edit [NUMBER] --body "$(gh issue view [NUMBER] --json body -q .body)
 
 ---
 
+### Step 7: After Task Completion - Close Issue Prompt
+
+**CRITICAL: After ALL TodoWrite tasks are marked complete AND a commit is created, ALWAYS offer to close the issue.**
+
+This step triggers when:
+1. All tasks in TodoWrite are marked `completed`
+2. A git commit has been made with changes
+
+Display completion summary:
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  ✅ All Tasks Completed                                       ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  Issue: #[NUMBER] - [TITLE]                                   ║
+║  Commit: [SHORT_SHA] - [COMMIT_MSG_FIRST_LINE]                ║
+║  Tasks: [X] completed                                         ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  [C] Close issue with comment                                 ║
+║  [P] Push to origin + close issue                             ║
+║  [K] Keep issue open                                          ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+Then ask:
+
+```
+header: "Issue"
+question: "All tasks complete. Close issue #[NUMBER]?"
+options:
+  - label: "C - Close with comment"
+    description: "Add completion summary and close"
+  - label: "P - Push + Close"
+    description: "Push commit to origin, then close"
+  - label: "K - Keep open"
+    description: "Leave issue open for follow-up"
+```
+
+**Handle Close Actions:**
+
+**C (Close with comment):**
+```bash
+gh issue close [NUMBER] --comment "All tasks completed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**P (Push + Close):**
+```bash
+git push origin HEAD
+gh issue close [NUMBER] --comment "All tasks completed and pushed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**K (Keep open):**
+Display: "Issue #[NUMBER] kept open for follow-up."
+
+---
+
 ## ERROR HANDLING
 
 | Error | Action |

package/templates/commands/create-task-list.template.md

@@ -874,6 +874,79 @@ After all tasks are complete, display a summary:
 
 ---
 
+## CLOSE ISSUE PROMPT (When Working From GitHub Issue)
+
+**CRITICAL: If this task list was created for a GitHub issue, ALWAYS offer to close the issue after ALL TodoWrite tasks are marked complete AND a commit is created.**
+
+This step triggers when:
+1. The task list originated from a GitHub issue (via `/create-task-list for issue #N` or `/menu-issues-list`)
+2. All tasks in TodoWrite are marked `completed`
+3. A git commit has been made with changes
+
+Display completion summary:
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  ✅ All Tasks Completed                                       ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  Issue: #[NUMBER] - [TITLE]                                   ║
+║  Commit: [SHORT_SHA] - [COMMIT_MSG_FIRST_LINE]                ║
+║  Tasks: [X] completed                                         ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  [C] Close issue with comment                                 ║
+║  [P] Push to origin + close issue                             ║
+║  [K] Keep issue open                                          ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+Then ask:
+
+```
+header: "Issue"
+question: "All tasks complete. Close issue #[NUMBER]?"
+options:
+  - label: "C - Close with comment"
+    description: "Add completion summary and close"
+  - label: "P - Push + Close"
+    description: "Push commit to origin, then close"
+  - label: "K - Keep open"
+    description: "Leave issue open for follow-up"
+```
+
+**Handle Close Actions:**
+
+**C (Close with comment):**
+```bash
+gh issue close [NUMBER] --comment "All tasks completed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**P (Push + Close):**
+```bash
+git push origin HEAD
+gh issue close [NUMBER] --comment "All tasks completed and pushed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**K (Keep open):**
+Display: "Issue #[NUMBER] kept open for follow-up."
+
+---
+
 ## ERROR HANDLING
 
 | Situation | Action |

package/templates/commands/detect-tech-stack.template.md

@@ -0,0 +1,137 @@
+---
+description: Re-run tech stack detection and update configuration
+---
+
+# /detect-tech-stack - Tech Stack Analysis
+
+Re-analyze the project's tech stack and update `.claude/config/tech-stack.json`.
+
+## Purpose
+
+Issue #8: Tech stack detection previously only ran during terminal phase (ccasp init).
+This command allows re-running detection from within Claude CLI to:
+- Detect new dependencies added since initial setup
+- Update framework versions
+- Refresh configuration for agents, skills, and hooks
+
+## Execution Steps
+
+### Step 1: Read Current Tech Stack
+
+```bash
+cat .claude/config/tech-stack.json 2>/dev/null || echo "{}"
+```
+
+Save as `previousStack` for comparison.
+
+### Step 2: Detect Current Stack
+
+Analyze the following files to build the new tech stack:
+
+**Package Managers:**
+- `package.json` → Node.js/npm project
+- `pyproject.toml` or `requirements.txt` → Python project
+- `Cargo.toml` → Rust project
+- `go.mod` → Go project
+- `pom.xml` or `build.gradle` → Java project
+
+**Frontend Frameworks (from package.json):**
+- `react` → React
+- `vue` → Vue.js
+- `@angular/core` → Angular
+- `svelte` → Svelte
+- `next` → Next.js
+- `nuxt` → Nuxt.js
+- `vite` → Vite bundler
+
+**Backend Frameworks:**
+- `express` → Express.js
+- `fastify` → Fastify
+- `@nestjs/core` → NestJS
+- `fastapi` (Python) → FastAPI
+- `django` (Python) → Django
+- `flask` (Python) → Flask
+
+**Testing Frameworks:**
+- `jest` → Jest
+- `vitest` → Vitest
+- `playwright` → Playwright
+- `cypress` → Cypress
+- `pytest` (Python) → Pytest
+
+**Database:**
+- `prisma` → Prisma ORM
+- `drizzle-orm` → Drizzle
+- `mongoose` → MongoDB
+- `pg` or `postgres` → PostgreSQL
+- `mysql2` → MySQL
+
+**Deployment:**
+Check for config files:
+- `wrangler.toml` → Cloudflare
+- `railway.json` or `railway.toml` → Railway
+- `vercel.json` → Vercel
+- `netlify.toml` → Netlify
+- `Dockerfile` → Docker
+
+### Step 3: Compare and Report Changes
+
+Compare `previousStack` with newly detected stack:
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  📊 Tech Stack Analysis                                       ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  Language: {{language}}                                       ║
+║  Frontend: {{frontend.framework}} + {{frontend.bundler}}      ║
+║  Backend:  {{backend.framework}}                              ║
+║  Database: {{database.type}}                                  ║
+║  Testing:  {{testing.frameworks}}                             ║
+║  Deploy:   {{deployment.platform}}                            ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Changes Detected:                                            ║
+║  [+] Added: (list new dependencies)                           ║
+║  [-] Removed: (list removed dependencies)                     ║
+║  [~] Updated: (list version changes)                          ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+### Step 4: Update tech-stack.json
+
+Write the updated configuration:
+
+```bash
+# Backup current config
+cp .claude/config/tech-stack.json .claude/config/tech-stack.json.bak
+
+# Write new config (use actual detected values)
+```
+
+### Step 5: Suggest Agent/Skill Updates
+
+Based on detected changes, recommend:
+
+| Change | Recommendation |
+|--------|----------------|
+| Added Playwright | Enable E2E testing skill |
+| Added Prisma | Enable database agent |
+| Added React 19 | Update component patterns |
+| New test framework | Configure test runner |
+
+## Output
+
+After completion, display:
+
+1. **Summary** of detected tech stack
+2. **Diff** showing what changed since last detection
+3. **Recommendations** for updating CCASP configuration
+4. **Restart reminder** if significant changes detected
+
+## Related Commands
+
+- `/claude-audit` - Audit CLAUDE.md configuration
+- `/update-smart` - Smart update manager
+- `/project-impl` - Project implementation agent

package/templates/commands/menu-issues-list.template.md

@@ -260,6 +260,78 @@ gh issue edit [NUMBER] --body "$(gh issue view [NUMBER] --json body -q .body)
 
 ---
 
+### Step 6: After Task Completion - Close Issue Prompt
+
+**CRITICAL: After ALL TodoWrite tasks are marked complete AND a commit is created, ALWAYS offer to close the issue.**
+
+This step triggers when:
+1. All tasks in TodoWrite are marked `completed`
+2. A git commit has been made with changes
+
+Display completion summary:
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  ✅ All Tasks Completed                                       ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  Issue: #[NUMBER] - [TITLE]                                   ║
+║  Commit: [SHORT_SHA] - [COMMIT_MSG_FIRST_LINE]                ║
+║  Tasks: [X] completed                                         ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  [C] Close issue with comment                                 ║
+║  [P] Push to origin + close issue                             ║
+║  [K] Keep issue open                                          ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+Then ask:
+
+```
+header: "Issue"
+question: "All tasks complete. Close issue #[NUMBER]?"
+options:
+  - label: "C - Close with comment"
+    description: "Add completion summary and close"
+  - label: "P - Push + Close"
+    description: "Push commit to origin, then close"
+  - label: "K - Keep open"
+    description: "Leave issue open for follow-up"
+```
+
+**Handle Close Actions:**
+
+**C (Close with comment):**
+```bash
+gh issue close [NUMBER] --comment "All tasks completed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**P (Push + Close):**
+```bash
+git push origin HEAD
+gh issue close [NUMBER] --comment "All tasks completed and pushed in commit [SHA].
+
+## Completed Tasks
+- ✅ Task 1
+- ✅ Task 2
+...
+
+Ready for release."
+```
+
+**K (Keep open):**
+Display: "Issue #[NUMBER] kept open for follow-up."
+
+---
+
 ## MOBILE OPTIMIZATION
 
 - Single character inputs (A, B, C, S, V, X)

package/templates/hooks/ccasp-update-check.template.js

@@ -89,15 +89,50 @@ function getCurrentVersion() {
 
 /**
  * Check npm for latest version
+ * Issue #8: Added npm registry API fallback for Windows compatibility
  */
 function checkLatestVersion() {
+  // Try npm CLI first
   try {
     const result = execSync(`npm view ${PACKAGE_NAME} version`, {
       encoding: 'utf8',
       timeout: 10000,
       stdio: ['pipe', 'pipe', 'pipe'],
     });
-    return result.trim();
+    const version = result.trim();
+    if (version && /^\d+\.\d+\.\d+/.test(version)) {
+      return version;
+    }
+  } catch {
+    // npm CLI failed, try fallback
+  }
+
+  // Fallback: Direct npm registry API call
+  try {
+    const https = require('https');
+    return new Promise((resolve) => {
+      const req = https.get(
+        `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
+        { timeout: 8000 },
+        (res) => {
+          let data = '';
+          res.on('data', (chunk) => (data += chunk));
+          res.on('end', () => {
+            try {
+              const pkg = JSON.parse(data);
+              resolve(pkg.version || null);
+            } catch {
+              resolve(null);
+            }
+          });
+        }
+      );
+      req.on('error', () => resolve(null));
+      req.on('timeout', () => {
+        req.destroy();
+        resolve(null);
+      });
+    });
   } catch {
     return null;
   }