hookstack-cli 0.1.38 → 0.1.40

package/bin/cli

@@ -13,6 +13,7 @@ import {
   assertSafeTarget,
   collectIncomingHooks,
   buildSecurityRows,
+  buildPostInstallHints,
   doInstallTests,
 } from './core.mjs'
 
@@ -234,6 +235,7 @@ async function interactiveInstall(slugs, args) {
   }
 
   // Result panel
+  const hints = buildPostInstallHints(hooks)
   const resultLines = [
     pc.green(`✓ ${dirs.settingsPath}`),
     result.scriptCount > 0
@@ -242,6 +244,8 @@ async function interactiveInstall(slugs, args) {
     testResult?.testCount > 0
       ? pc.green(`✓ ${testResult.testCount} test file${testResult.testCount === 1 ? '' : 's'} written to tests/hooks/`)
       : null,
+    hints.length > 0 ? '' : null,
+    ...hints.map(h => pc.yellow(`⚠  ${h.slug}: ${h.hint}`)),
     '',
     `Browse more hooks  ${pc.cyan(`${API_BASE}/#catalogue`)}`,
     `⭐  Star us         ${pc.cyan(REPO_URL)}`,
@@ -281,6 +285,10 @@ async function directInstall(slugs, args) {
       console.warn(`  ! Could not write tests: ${e.message}`)
     }
   }
+  const hints = buildPostInstallHints(hooks)
+  if (hints.length > 0) {
+    for (const h of hints) console.warn(`  ⚠  ${h.slug}: ${h.hint}`)
+  }
   console.log(`\n✅ ${plural(result.hookCount, 'hook')} installed · star us → ${REPO_URL}`)
   console.log('   Restart Claude Code to activate.\n')
 }

package/bin/core.mjs

@@ -211,6 +211,20 @@ export function buildSummaryRows(hooks, { root }) {
   })
 }
 
+// Maps hook slugs to post-install hints about required external tools.
+// Keep as a plain object so it's trivially testable without any async/fetch.
+export const PREREQ_HINTS = {
+  'stop-duplication-check': 'Requires jscpd:  pnpm add -D jscpd  (or npm install -g jscpd)',
+}
+
+// Returns one hint entry per installed hook that has an external prerequisite.
+export function buildPostInstallHints(hooks) {
+  return hooks.flatMap(h => {
+    const hint = PREREQ_HINTS[h.slug]
+    return hint ? [{ slug: h.slug, hint }] : []
+  })
+}
+
 // Display rows for the "Installation Summary" panel: description + static capabilities + verdicts.
 export function buildSecurityRows(hooks) {
   return hooks.map(h => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookstack-cli",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "CLI installer for the Hookstack catalogue of Claude Code hooks",
   "type": "module",
   "bin": {