cc-hook-registry 2.1.0 → 3.1.0

package/README.md

@@ -19,11 +19,39 @@ npx cc-hook-registry search database
 ```bash
 npx cc-hook-registry search <keyword>   # Find hooks by keyword
 npx cc-hook-registry browse [category]  # Browse by category
-npx cc-hook-registry install <id>       # Install a hook
+npx cc-hook-registry install <id>       # Install a hook (direct download)
+npx cc-hook-registry recommend          # Recommend hooks for your project
 npx cc-hook-registry info <id>          # Show hook details
 npx cc-hook-registry stats              # Registry statistics
 ```
 
+### recommend
+
+Scans your project for `package.json`, `requirements.txt`, `Dockerfile`, `.env`, `Gemfile`, `artisan` and recommends hooks based on your tech stack:
+
+```
+npx cc-hook-registry recommend
+
+  ✓ destructive-guard (installed)
+    Essential — prevents rm -rf disasters
+
+  ○ auto-approve-build
+    Node.js project detected
+    Install: npx cc-hook-registry install auto-approve-build
+
+  ○ block-database-wipe
+    Prisma detected — protect against migrate reset
+```
+
+### install (direct download)
+
+Hooks are downloaded directly from GitHub — no `cc-safe-setup` dependency needed:
+
+```bash
+npx cc-hook-registry install block-database-wipe
+# Downloads script, saves to ~/.claude/hooks/, registers in settings.json
+```
+
 ## Categories
 
 | Category | Hooks | What They Do |

package/index.mjs

@@ -112,6 +112,8 @@ if (!command || command === '--help' || command === '-h') {
     browse [category]    Browse by category (safety, quality, approve, utility, monitoring, ux)
     install <id>         Install a hook
     info <id>            Show hook details
+    recommend            Recommend hooks for current project
+    outdated             Check installed hooks for updates
     stats                Registry statistics
 
   Examples:
@@ -272,6 +274,160 @@ else if (command === 'info') {
   console.log();
 }
 
+else if (command === 'recommend') {
+  console.log();
+  console.log(c.bold + '  Recommended hooks for this project' + c.reset);
+  console.log();
+
+  const cwd = process.cwd();
+  const recommendations = [];
+
+  // Always recommend safety essentials
+  recommendations.push({ id: 'destructive-guard', reason: 'Essential — prevents rm -rf disasters', priority: 1 });
+  recommendations.push({ id: 'branch-guard', reason: 'Essential — prevents push to main', priority: 1 });
+  recommendations.push({ id: 'secret-guard', reason: 'Essential — prevents .env commits', priority: 1 });
+
+  // Detect tech stack
+  if (existsSync(join(cwd, 'package.json'))) {
+    const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+    recommendations.push({ id: 'auto-approve-build', reason: 'Node.js project detected', priority: 2 });
+    if (pkg.dependencies?.prisma || pkg.devDependencies?.prisma) {
+      recommendations.push({ id: 'block-database-wipe', reason: 'Prisma detected — protect against migrate reset', priority: 1 });
+    }
+    if (pkg.scripts?.deploy || pkg.scripts?.['vercel-build']) {
+      recommendations.push({ id: 'deploy-guard', reason: 'Deploy script detected', priority: 2 });
+    }
+  }
+
+  if (existsSync(join(cwd, 'requirements.txt')) || existsSync(join(cwd, 'pyproject.toml'))) {
+    recommendations.push({ id: 'auto-approve-python', reason: 'Python project detected', priority: 2 });
+  }
+
+  if (existsSync(join(cwd, 'Dockerfile')) || existsSync(join(cwd, 'docker-compose.yml'))) {
+    recommendations.push({ id: 'auto-approve-docker', reason: 'Docker detected', priority: 2 });
+  }
+
+  if (existsSync(join(cwd, '.env')) || existsSync(join(cwd, '.env.local'))) {
+    recommendations.push({ id: 'env-source-guard', reason: '.env file present — prevent sourcing', priority: 1 });
+  }
+
+  if (existsSync(join(cwd, 'Gemfile'))) {
+    recommendations.push({ id: 'block-database-wipe', reason: 'Rails detected — protect against db:drop', priority: 1 });
+  }
+
+  if (existsSync(join(cwd, 'artisan'))) {
+    recommendations.push({ id: 'block-database-wipe', reason: 'Laravel detected — protect against migrate:fresh', priority: 1 });
+  }
+
+  // Always useful
+  recommendations.push({ id: 'compound-command-approver', reason: 'Fixes permission matching for cd && commands', priority: 2 });
+  recommendations.push({ id: 'loop-detector', reason: 'Prevents infinite command loops', priority: 3 });
+  recommendations.push({ id: 'session-handoff', reason: 'Saves state for next session', priority: 3 });
+  recommendations.push({ id: 'cost-tracker', reason: 'Track session costs', priority: 3 });
+
+  // Deduplicate and sort by priority
+  const seen = new Set();
+  const unique = recommendations.filter(r => { if (seen.has(r.id)) return false; seen.add(r.id); return true; });
+  unique.sort((a, b) => a.priority - b.priority);
+
+  // Check what's already installed
+  let installed = new Set();
+  if (existsSync(SETTINGS_PATH)) {
+    try {
+      const s = JSON.parse(readFileSync(SETTINGS_PATH, 'utf-8'));
+      for (const entries of Object.values(s.hooks || {})) {
+        for (const e of entries) {
+          for (const h of (e.hooks || [])) {
+            if (h.command) installed.add(h.command.split('/').pop().replace('.sh', ''));
+          }
+        }
+      }
+    } catch {}
+  }
+
+  for (const rec of unique) {
+    const hook = REGISTRY.find(h => h.id === rec.id);
+    if (!hook) continue;
+    const isInstalled = installed.has(rec.id);
+    const icon = isInstalled ? c.green + '✓' + c.reset : c.yellow + '○' + c.reset;
+    const status = isInstalled ? c.dim + '(installed)' + c.reset : '';
+    console.log('  ' + icon + ' ' + c.bold + rec.id + c.reset + ' ' + status);
+    console.log('    ' + c.dim + rec.reason + c.reset);
+    if (!isInstalled) {
+      console.log('    ' + c.dim + 'Install: npx cc-hook-registry install ' + rec.id + c.reset);
+    }
+    console.log();
+  }
+
+  const notInstalled = unique.filter(r => !installed.has(r.id));
+  if (notInstalled.length === 0) {
+    console.log(c.green + '  All recommended hooks are installed!' + c.reset);
+  } else {
+    console.log(c.dim + '  ' + notInstalled.length + ' recommended hook(s) not yet installed.' + c.reset);
+  }
+  console.log();
+}
+
+else if (command === 'outdated') {
+  console.log();
+  console.log(c.bold + '  Checking installed hooks for updates...' + c.reset);
+  console.log();
+
+  if (!existsSync(HOOKS_DIR)) {
+    console.log(c.dim + '  No hooks installed.' + c.reset);
+    process.exit(0);
+  }
+
+  const { readdirSync } = await import('fs');
+  const installed = readdirSync(HOOKS_DIR).filter(f => f.endsWith('.sh'));
+  let outdated = 0;
+  let upToDate = 0;
+  let unknown = 0;
+
+  for (const file of installed) {
+    const name = file.replace('.sh', '');
+    const hook = REGISTRY.find(h => h.id === name);
+    const localContent = readFileSync(join(HOOKS_DIR, file), 'utf-8');
+    const localLines = localContent.split('\n').length;
+
+    if (!hook) {
+      // Custom hook, not in registry
+      console.log('  ' + c.dim + '?' + c.reset + ' ' + file + c.dim + ' (custom, not in registry)' + c.reset);
+      unknown++;
+      continue;
+    }
+
+    // Check against GitHub for cc-safe-setup hooks
+    if (hook.source === 'cc-safe-setup' && hook.install.includes('--install-example')) {
+      try {
+        const rawUrl = `https://raw.githubusercontent.com/yurukusa/cc-safe-setup/main/examples/${name}.sh`;
+        const remote = execSync(`curl -sL "${rawUrl}" 2>/dev/null`, { encoding: 'utf-8', timeout: 5000 });
+        const remoteLines = remote.split('\n').length;
+
+        if (remote.trim() === localContent.trim()) {
+          console.log('  ' + c.green + '✓' + c.reset + ' ' + file + c.dim + ' (up to date)' + c.reset);
+          upToDate++;
+        } else {
+          const diff = remoteLines - localLines;
+          console.log('  ' + c.yellow + '↑' + c.reset + ' ' + file + c.yellow + ' (update available: ' + (diff > 0 ? '+' : '') + diff + ' lines)' + c.reset);
+          console.log('    ' + c.dim + 'Update: npx cc-hook-registry install ' + name + c.reset);
+          outdated++;
+        }
+      } catch {
+        console.log('  ' + c.dim + '?' + c.reset + ' ' + file + c.dim + ' (could not check)' + c.reset);
+        unknown++;
+      }
+    } else {
+      console.log('  ' + c.dim + '—' + c.reset + ' ' + file + c.dim + ' (external: ' + hook.source + ')' + c.reset);
+      unknown++;
+    }
+  }
+
+  console.log();
+  console.log('  ' + c.green + upToDate + ' up to date' + c.reset + '  ' + c.yellow + outdated + ' outdated' + c.reset + '  ' + c.dim + unknown + ' unchecked' + c.reset);
+  console.log();
+}
+
 else if (command === 'stats') {
   const categories = {};
   const sources = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hook-registry",
-  "version": "2.1.0",
+  "version": "3.1.0",
   "description": "Search, browse, and install Claude Code hooks from the community. GitHub-based registry, no server needed.",
   "main": "index.mjs",
   "bin": {