hookstack-cli 0.1.19 → 0.1.20

package/README.md

@@ -24,7 +24,9 @@ npx hookstack-cli@latest install --hooks=<slug1>,<slug2>,...
 Options:
   --hooks <slugs>   Comma-separated hook slugs (required)
   --global, -g      Install into ~/.claude instead of ./.claude
-  --scope <s>       "project" (default) or "global"
+  --copilot         Install into ./.claude with paths adapted for GitHub Copilot
+  --scope <s>       "project" (default), "global", or "copilot"
+  --with-tests      Also install vitest unit tests into tests/hooks/ (project scope only)
   --yes, -y         Skip prompts (non-interactive / CI)
   --version, -v     Print version
   --help, -h        Show help
@@ -46,6 +48,9 @@ Skips all prompts — useful in CI or dotfile bootstrap scripts.
 ```bash
 # CI bootstrap
 npx hookstack-cli@latest install --hooks=secret-detection,git-push-guard --yes --scope=project
+
+# CI bootstrap with unit tests (avoids SonarQube gating on new files without tests)
+npx hookstack-cli@latest install --hooks=secret-detection,git-push-guard --yes --with-tests
 ```
 
 ---
@@ -56,6 +61,7 @@ For each hook the CLI:
 
 - Writes the `.mjs` script to `.claude/hooks/` (or `~/.claude/hooks/` for global scope)
 - Patches `.claude/settings.json` to register the hook on the right lifecycle event
+- Optionally writes vitest unit tests to `tests/hooks/` when `--with-tests` is passed (or confirmed interactively)
 
 No new dependencies are added to your project. Hooks are plain Node.js scripts — no SDK, no agent modification.
 

package/bin/cli.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { readFileSync, writeFileSync, mkdirSync, existsSync, realpathSync } from 'fs'
+import { join as pathJoin } from 'path'
 import { homedir } from 'os'
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
@@ -12,6 +13,7 @@ import {
   assertSafeTarget,
   collectIncomingHooks,
   buildSecurityRows,
+  doInstallTests,
 } from './core.mjs'
 
 const API_BASE = process.env.HOOKSTACK_API_BASE || 'https://hookstack.vercel.app'
@@ -214,12 +216,32 @@ async function interactiveInstall(slugs, args) {
   }
   spin2.stop(`Installed ${pc.bold(String(result.hookCount))} hook${result.hookCount === 1 ? '' : 's'}`)
 
+  // Unit tests prompt (project/copilot scope only)
+  let testResult = null
+  const hooksWithTests = hooks.filter(h => h.test_snippet)
+  if (scope !== 'global' && hooksWithTests.length > 0) {
+    const wantTests = await p.confirm({
+      message: `Install unit tests for ${plural(hooksWithTests.length, 'hook')} into ${pc.cyan('tests/hooks/')}? ${pc.dim('(vitest — helps SonarQube gating)')}`,
+      initialValue: true,
+    })
+    if (!p.isCancel(wantTests) && wantTests) {
+      try {
+        testResult = doInstallTests(hooks, process.cwd(), { mkdirSync, writeFileSync, join: pathJoin })
+      } catch (e) {
+        p.log.warn(`Could not write tests: ${e.message}`)
+      }
+    }
+  }
+
   // Result panel
   const resultLines = [
     pc.green(`✓ ${dirs.settingsPath}`),
     result.scriptCount > 0
       ? pc.green(`✓ ${result.scriptCount} script${result.scriptCount === 1 ? '' : 's'} written to ${dirs.hooksDir}`)
       : null,
+    testResult?.testCount > 0
+      ? pc.green(`✓ ${testResult.testCount} test file${testResult.testCount === 1 ? '' : 's'} written to tests/hooks/`)
+      : null,
     '',
     `Browse more hooks  ${pc.cyan(`${API_BASE}/#catalogue`)}`,
     `⭐  Star us         ${pc.cyan(REPO_URL)}`,
@@ -250,6 +272,15 @@ async function directInstall(slugs, args) {
   const log = { warn: m => console.warn(`  ! ${m}`) }
   const result = doInstall(hooks, dirs, args.scope, log)
   console.log(`  ✓ ${dirs.settingsPath}`)
+  if (args.withTests && args.scope !== 'global') {
+    try {
+      const testResult = doInstallTests(hooks, process.cwd(), { mkdirSync, writeFileSync, join: pathJoin })
+      if (testResult.testCount > 0)
+        console.log(`  ✓ ${testResult.testCount} test file${testResult.testCount === 1 ? '' : 's'} written to tests/hooks/`)
+    } catch (e) {
+      console.warn(`  ! Could not write tests: ${e.message}`)
+    }
+  }
   console.log(`\n✅ ${plural(result.hookCount, 'hook')} installed · star us → ${REPO_URL}`)
   console.log('   Restart Claude Code to activate.\n')
 }
@@ -266,6 +297,7 @@ const HELP = `
     --global, -g      Install into ~/.claude instead of ./.claude
     --copilot         Install into ./.claude with paths adapted for GitHub Copilot
     --scope <s>       "project" (default), "global", or "copilot"
+    --with-tests      Also install vitest unit tests into tests/hooks/ (project scope only)
     --yes, -y         Skip prompts (non-interactive install)
     --version, -v     Show version
     --help, -h        Show this help

package/bin/core.mjs

@@ -27,6 +27,7 @@ export function parseArgs(argv) {
     version: false,
     scope: 'project',
     yes: false,
+    withTests: false,
   }
 
   for (let i = 0; i < args.length; i++) {
@@ -34,6 +35,7 @@ export function parseArgs(argv) {
     if (arg === '--help' || arg === '-h') { result.help = true; continue }
     if (arg === '--version' || arg === '-v') { result.version = true; continue }
     if (arg === '--yes' || arg === '-y') { result.yes = true; continue }
+    if (arg === '--with-tests') { result.withTests = true; continue }
     if (arg === '--global' || arg === '-g') { result.scope = 'global'; continue }
     if (arg === '--project') { result.scope = 'project'; continue }
     if (arg === '--copilot') { result.scope = 'copilot'; continue }
@@ -177,6 +179,21 @@ export function shortRepo(url) {
     .replace(/\/$/, '')
 }
 
+// Writes test files for installed hooks into <projectRoot>/tests/hooks/.
+// Only hooks that have a test_snippet are written; others are silently skipped.
+export function doInstallTests(hooks, projectRoot, { mkdirSync, writeFileSync, join }) {
+  const testsDir = join(projectRoot, 'tests', 'hooks')
+  mkdirSync(testsDir, { recursive: true })
+  let testCount = 0
+  for (const hook of hooks) {
+    if (!hook.test_snippet) continue
+    const dest = join(testsDir, `${hook.slug}.test.mjs`)
+    writeFileSync(dest, hook.test_snippet, 'utf8')
+    testCount++
+  }
+  return { testCount }
+}
+
 // Display rows for the "Installation Summary" panel.
 export function buildSummaryRows(hooks, { root }) {
   return hooks.map(h => {

package/package.json

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