hookstack-cli 0.1.16 → 0.1.18

package/bin/cli.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { readFileSync, writeFileSync, mkdirSync, existsSync, realpathSync } from 'fs'
-import { createInterface } from 'readline'
 import { homedir } from 'os'
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
 import pc from 'picocolors'
+import * as p from '@clack/prompts'
 import {
   parseArgs,
   resolveScopeRoot,
@@ -32,17 +32,18 @@ async function fetchHooks(slugs) {
   return res.json()
 }
 
-function ask(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout })
-  return new Promise(resolve => rl.question(question, a => { rl.close(); resolve(a.trim()) }))
-}
+// ── ASCII banner ──────────────────────────────────────────────────────────────
 
-// ── panel rendering ────────────────────────────────────────────────────────
+const BANNER = pc.cyan([
+  '██╗  ██╗ ██████╗  ██████╗ ██╗  ██╗███████╗████████╗ █████╗  ██████╗██╗  ██╗',
+  '██║  ██║██╔═══██╗██╔═══██╗██║ ██╔╝██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝',
+  '███████║██║   ██║██║   ██║█████╔╝ ███████╗   ██║   ███████║██║     █████╔╝ ',
+  '██╔══██║██║   ██║██║   ██║██╔═██╗ ╚════██║   ██║   ██╔══██║██║     ██╔═██╗ ',
+  '██║  ██║╚██████╔╝╚██████╔╝██║  ██╗███████║   ██║   ██║  ██║╚██████╗██║  ██╗',
+  '╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝',
+].join('\n'))
 
-function truncPad(value, width) {
-  const s = String(value ?? '')
-  return (s.length > width ? s.slice(0, width - 1) + '…' : s).padEnd(width)
-}
+// ── panel content builders ────────────────────────────────────────────────────
 
 export function summaryPanel(rows) {
   const lines = []
@@ -50,13 +51,19 @@ export function summaryPanel(rows) {
     lines.push(pc.cyan(r.path ?? `${r.name} (settings only)`))
     const meta = [
       r.category,
-      r.events.join(', ') + (r.blocking ? pc.yellow(' · can block') : ''),
+      r.events.join(', ') + (r.blocking ? pc.yellow(' · ⚡ can block') : ''),
       r.matcher ? `matcher: ${r.matcher}` : null,
     ].filter(Boolean).join(pc.dim(' · '))
-    lines.push('  ' + pc.dim(meta))
-    if (r.source) lines.push('  ' + pc.dim(`source: ${r.source}`))
+    lines.push(pc.dim('  ' + meta))
+    if (r.source) lines.push(pc.dim(`  source: ${r.source}`))
+    lines.push('')
   }
-  return lines.join('\n')
+  return lines.join('\n').trimEnd()
+}
+
+function truncPad(value, width) {
+  const s = String(value ?? '')
+  return (s.length > width ? s.slice(0, width - 1) + '…' : s).padEnd(width)
 }
 
 function capCell(on, width) {
@@ -67,10 +74,10 @@ function capCell(on, width) {
 const SNYK_COLOR = { high: pc.red, medium: pc.yellow, low: pc.cyan, safe: pc.green, unknown: pc.dim }
 
 export function securityPanel(rows) {
-  const W = { name: 26, cap: 8, snyk: 10 }
+  const W = { name: 28, cap: 8, snyk: 10 }
   const header = pc.dim(
     ''.padEnd(W.name) + 'Shell'.padEnd(W.cap) + 'Net'.padEnd(W.cap) +
-    'Writes'.padEnd(W.cap) + 'Snyk'.padEnd(W.snyk),
+    'Writes'.padEnd(W.cap) + 'Snyk',
   )
   const body = rows.map(r =>
     truncPad(r.name, W.name) +
@@ -89,7 +96,7 @@ export function securityPanel(rows) {
   return [header, ...body, footer].join('\n')
 }
 
-// ── install ──────────────────────────────────────────────────────────────
+// ── install ───────────────────────────────────────────────────────────────────
 
 function doInstall(hooks, dirs, scope, log) {
   mkdirSync(dirs.claudeDir, { recursive: true })
@@ -121,69 +128,101 @@ function doInstall(hooks, dirs, scope, log) {
   return { hookCount: hooks.length, scriptCount }
 }
 
-// ── flows ──────────────────────────────────────────────────────────────────
+// ── flows ─────────────────────────────────────────────────────────────────────
 
 const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`
 
+function onCancel() {
+  p.cancel('Installation cancelled.')
+  process.exit(0)
+}
+
 async function interactiveInstall(slugs, args) {
-  const isDefault = slugs.length === 0
-  console.log(pc.bgCyan(pc.black(' hookstack-cli ')))
-  console.log(isDefault ? '\nFetching default HookStack…' : `\nFetching ${plural(slugs.length, 'hook')}…`)
+  console.log('\n' + BANNER + '\n')
+  p.intro(pc.bold('hooks') + pc.dim(`  Claude Code hook installer  v${VERSION}`))
 
+  // Fetch
+  const spin = p.spinner()
+  spin.start(slugs.length === 0 ? 'Fetching default HookStack…' : `Fetching ${plural(slugs.length, 'hook')}…`)
   let data
   try {
     data = await fetchHooks(slugs)
   } catch (e) {
-    console.error(pc.red(`\n✗ Fetch failed: ${e.message}`))
+    spin.stop(pc.red(`Fetch failed: ${e.message}`), 1)
     process.exit(1)
   }
   const { hooks } = data
   const notFound = slugs.filter(slug => !hooks.find(h => h.slug === slug))
-  console.log(isDefault
-    ? `✓ Default HookStack — ${plural(hooks.length, 'hook')}`
-    : `✓ Fetched ${plural(hooks.length, 'hook')}`)
-  if (notFound.length) console.warn(`  ! Unknown slugs skipped: ${notFound.join(', ')}`)
-  if (hooks.length === 0) {
-    console.error('\n✗ No hooks to install.')
-    process.exit(1)
-  }
+  spin.stop(`Selected ${pc.bold(String(hooks.length))} hook${hooks.length === 1 ? '' : 's'}`)
+  if (notFound.length) p.log.warn(`Unknown slugs skipped: ${notFound.join(', ')}`)
+  if (hooks.length === 0) { p.cancel('No hooks to install.'); process.exit(1) }
 
-  // Scope selection
+  // Scope
   let scope = args.scope
-  console.log('\n  Where to install?')
-  console.log(`  ${pc.cyan('1')}  This project     ${pc.dim('./.claude — committed with your repo')}`)
-  console.log(`  ${pc.cyan('2')}  All my projects  ${pc.dim('~/.claude — every project on this machine')}`)
-  const scopeAnswer = await ask(`  → [${scope === 'global' ? '2' : '1'}]: `)
-  if (scopeAnswer === '2' || scopeAnswer === 'global') scope = 'global'
-  else if (scopeAnswer === 'q') { console.log('Cancelled.'); process.exit(0) }
-  else scope = 'project'
+  const scopeResult = await p.select({
+    message: 'Where to install?',
+    options: [
+      {
+        value: 'project',
+        label: 'This project',
+        hint: './.claude  —  committed with your repo',
+      },
+      {
+        value: 'global',
+        label: 'All my projects',
+        hint: '~/.claude  —  every project on this machine',
+      },
+      {
+        value: 'copilot',
+        label: 'GitHub Copilot project',
+        hint: './.claude  —  paths adapted for Copilot',
+      },
+    ],
+    initialValue: scope,
+  })
+  if (p.isCancel(scopeResult)) return onCancel()
+  scope = scopeResult
 
   const dirs = resolveScopeRoot(scope, { cwd: process.cwd(), home: homedir() })
-
-  console.log(`\n  ${pc.bold(`${plural(hooks.length, 'Hook')} to install`)}`)
-  console.log(summaryPanel(buildSummaryRows(hooks, { root: dirs.root })))
-  console.log(`\n  ${pc.bold('Security')}`)
-  console.log(securityPanel(buildSecurityRows(hooks)))
-
-  const confirmAnswer = await ask(`\n  Install ${plural(hooks.length, 'hook')} into ${scope === 'global' ? '~/.claude' : './.claude'}? [Y/n]: `)
-  if (confirmAnswer.toLowerCase() === 'n' || confirmAnswer.toLowerCase() === 'no') {
-    console.log('Cancelled.')
-    process.exit(0)
-  }
-
-  console.log('\nInstalling…')
+  const summaryRows = buildSummaryRows(hooks, { root: dirs.root })
+  const secRows = buildSecurityRows(hooks)
+
+  // Panels
+  p.note(summaryPanel(summaryRows), 'Installation Summary')
+  p.note(securityPanel(secRows), 'Security Assessment')
+
+  // Confirm
+  const scopeLabel = scope === 'global' ? '~/.claude' : scope === 'copilot' ? './.claude (Copilot mode)' : './.claude'
+  const confirmed = await p.confirm({
+    message: `Install ${plural(hooks.length, 'hook')} into ${pc.cyan(scopeLabel)}?`,
+  })
+  if (p.isCancel(confirmed) || !confirmed) return onCancel()
+
+  // Install
+  const spin2 = p.spinner()
+  spin2.start('Installing…')
   let result
   try {
-    result = doInstall(hooks, dirs, scope, { warn: m => console.warn(`  ! ${m}`) })
+    result = doInstall(hooks, dirs, scope, { warn: m => p.log.warn(m) })
   } catch (e) {
-    console.error(pc.red(`\n✗ Install failed: ${e.message}`))
+    spin2.stop(pc.red(`Install failed: ${e.message}`), 1)
     process.exit(1)
   }
+  spin2.stop(`Installed ${pc.bold(String(result.hookCount))} hook${result.hookCount === 1 ? '' : 's'}`)
+
+  // 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,
+    '',
+    `Browse more hooks  ${pc.cyan(`${API_BASE}/#catalogue`)}`,
+    `⭐  Star us         ${pc.cyan(REPO_URL)}`,
+  ].filter(v => v !== null).join('\n')
 
-  console.log(`  ✓ ${dirs.settingsPath}`)
-  console.log(`\n  Browse more hooks → ${pc.cyan(`${API_BASE}/#catalogue`)}`)
-  console.log(`  ⭐  star us → ${pc.cyan(REPO_URL)}`)
-  console.log(pc.green(`\n✓ ${plural(result.hookCount, 'hook')} installed — restart Claude Code to activate.\n`))
+  p.note(resultLines, 'Resume installation')
+  p.outro(pc.green('Done!') + pc.dim("  You've just HookStacked your agent workflow."))
 }
 
 async function directInstall(slugs, args) {
@@ -221,7 +260,8 @@ const HELP = `
   Options:
     --hooks <slugs>   Comma-separated list of hook slugs (omit for default set)
     --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"
     --yes, -y         Skip prompts (non-interactive install)
     --version, -v     Show version
     --help, -h        Show this help

package/bin/core.mjs

@@ -36,6 +36,7 @@ export function parseArgs(argv) {
     if (arg === '--yes' || arg === '-y') { result.yes = 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 }
     if (arg.startsWith('--scope=')) {
       const v = arg.slice('--scope='.length)
       if (v === 'global' || v === 'project') result.scope = v
@@ -98,7 +99,8 @@ export function mergeHooks(existing, incoming) {
 
 // Gathers the hook fragments from an API hook list into a single event→entries
 // map. For global scope, rewrites $CLAUDE_PROJECT_DIR to the absolute global
-// root so commands resolve outside any project.
+// root so commands resolve outside any project. For copilot scope, strips
+// $CLAUDE_PROJECT_DIR/ so paths become relative (GitHub Copilot compatible).
 export function collectIncomingHooks(hooks, { scope = 'project', globalRoot } = {}) {
   const incoming = {}
   for (const hook of hooks) {
@@ -107,14 +109,16 @@ export function collectIncomingHooks(hooks, { scope = 'project', globalRoot } =
     for (const [event, entries] of Object.entries(fragment)) {
       incoming[event] ??= []
       for (const entry of entries) {
-        const rewrite = scope === 'global' && globalRoot
         incoming[event].push({
           ...entry,
-          hooks: entry.hooks.map(h =>
-            rewrite && typeof h.command === 'string'
-              ? { ...h, command: h.command.replace(PROJECT_DIR_RE, globalRoot) }
-              : h,
-          ),
+          hooks: entry.hooks.map(h => {
+            if (!h.command || typeof h.command !== 'string') return h
+            if (scope === 'global' && globalRoot)
+              return { ...h, command: h.command.replace(PROJECT_DIR_RE, globalRoot) }
+            if (scope === 'copilot')
+              return { ...h, command: h.command.replace(/\$\{?CLAUDE_PROJECT_DIR\}?\//g, '') }
+            return h
+          }),
         })
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookstack-cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "CLI installer for the Hookstack catalogue of Claude Code hooks",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@clack/prompts": "^0.9.1",
     "picocolors": "^1.1.1"
   },
   "keywords": [