@claude-code-hooks/cli 0.1.8 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-code-hooks/cli",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Wizard CLI to set up and manage @claude-code-hooks packages for Claude Code.",
   "license": "MIT",
   "homepage": "https://github.com/beefiker/claude-code-hooks/tree/main/packages/cli",
@@ -30,7 +30,7 @@
     "@claude-code-hooks/core": "0.1.3",
     "@claude-code-hooks/security": "0.1.7",
     "@claude-code-hooks/secrets": "0.1.8",
-    "@claude-code-hooks/sound": "0.2.10",
+    "@claude-code-hooks/sound": "0.2.11",
     "@claude-code-hooks/notification": "0.1.5"
   },
   "keywords": [

package/src/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import process from 'node:process';
+import readline from 'node:readline';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
@@ -16,6 +17,11 @@ import {
   spinner
 } from '@clack/prompts';
 
+// Enable keypress events so we can intercept Backspace
+if (process.stdin.isTTY) {
+  readline.emitKeypressEvents(process.stdin);
+}
+
 import {
   ansi as pc,
   configPathForScope,
@@ -25,7 +31,9 @@ import {
   configFilePath,
   readProjectConfig,
   writeProjectConfig,
-  removeLegacyClaudeSoundHooks
+  removeLegacyClaudeSoundHooks,
+  t,
+  detectLanguage
 } from '@claude-code-hooks/core';
 
 import { buildSettingsSnippet } from './snippet.js';
@@ -37,14 +45,37 @@ import { planInteractiveSetup as planSecretsSetup } from '@claude-code-hooks/sec
 import { planInteractiveSetup as planSoundSetup } from '@claude-code-hooks/sound/src/plan.js';
 import { planInteractiveSetup as planNotificationSetup } from '@claude-code-hooks/notification/src/plan.js';
 
-function dieCancelled(msg = 'Cancelled') {
-  cancel(msg);
+function dieCancelled(msg) {
+  cancel(msg ?? t('cli.cancelled'));
   process.exit(0);
 }
 
+/**
+ * Run a prompt with Backspace = go back. When Backspace is pressed, aborts and returns
+ * { wentBack: true }. ESC still exits. Caller must handle wentBack by continuing the loop.
+ * @param {AbortController} controller
+ * @param {() => Promise<T>} runPrompt - async function that runs the prompt (receives no args)
+ * @returns {Promise<{ result: T; wentBack: boolean }>}
+ */
+async function withBackspaceBack(controller, runPrompt) {
+  let wentBack = false;
+  const handler = (_str, key) => {
+    if (key?.name === 'backspace') {
+      wentBack = true;
+      controller.abort();
+    }
+  };
+  process.stdin.on('keypress', handler);
+  try {
+    const result = await runPrompt();
+    return { result, wentBack };
+  } finally {
+    process.stdin.off('keypress', handler);
+  }
+}
+
 function usage(exitCode = 0) {
-  process.stdout.write(`\
-claude-code-hooks\n\nUsage:\n  claude-code-hooks\n  npx @claude-code-hooks/cli@latest\n\nWhat it does:\n  - Update Claude Code settings (global), or generate a project-only config + pasteable snippet.\n`);
+  process.stdout.write(t('cli.usage') + '\n');
   process.exit(exitCode);
 }
 
@@ -67,7 +98,7 @@ async function ensureProjectOnlyConfig(projectDir, selected, perPackageConfig) {
 
 async function maybeWriteSnippet(projectDir, snippetObj) {
   const ok = await confirm({
-    message: `Write snippet file (${pc.bold('claude-code-hooks.snippet.json')}) to this project?`,
+    message: t('cli.writeSnippet'),
     initialValue: false
   });
   if (isCancel(ok)) return;
@@ -75,130 +106,209 @@ async function maybeWriteSnippet(projectDir, snippetObj) {
 
   const filePath = path.join(projectDir, 'claude-code-hooks.snippet.json');
   await fs.writeFile(filePath, JSON.stringify(snippetObj, null, 2) + '\n');
-  note(filePath, 'Wrote snippet');
+  note(filePath, t('cli.wroteSnippet'));
 }
 
 async function main() {
   const args = process.argv.slice(2);
   if (args.includes('-h') || args.includes('--help')) usage(0);
 
+  // i18n: --lang ko or env CLAUDE_CODE_HOOKS_LANG
+  const langIdx = args.indexOf('--lang');
+  if (langIdx !== -1 && args[langIdx + 1]) {
+    process.env.CLAUDE_CODE_HOOKS_LANG = args[langIdx + 1].toLowerCase().slice(0, 2);
+  }
+
   const projectDir = process.cwd();
 
   intro('claude-code-hooks');
+  note(t('cli.navHint'), t('cli.navTitle'));
 
-  // ── Step 1–3: action, target, packages (with simple back navigation) ──
+  // ── Step 1–3: action, target, packages (Backspace = go to previous step) ──
   let action;
   let target;
   let selected;
+  let step = 1;
+  /** @type {{ security: unknown; secrets: unknown; sound: unknown; notification: unknown }} */
+  let perPackage = { security: null, secrets: null, sound: null, notification: null };
 
-  while (true) {
-    action = await select({
-      message: `${pc.dim('Step 1/5')}  Choose an action`,
-      options: [
-        { value: 'setup', label: 'Install / update packages' },
-        { value: 'uninstall', label: 'Uninstall (remove managed hooks)' },
-        { value: 'exit', label: 'Exit' }
-      ]
-    });
-    if (isCancel(action) || action === 'exit') dieCancelled('Bye');
-
-    target = await select({
-      message: `${pc.dim('Step 2/5')}  Choose a target`,
-      options: [
-        { value: 'global', label: `Global (default): ${pc.dim('~/.claude/settings.json')}` },
-        { value: 'projectOnly', label: `Project-only: write ${pc.bold(CONFIG_FILENAME)} + print a snippet` },
-        { value: '__back__', label: 'Back' }
-      ]
-    });
-    if (isCancel(target)) dieCancelled();
-    if (target === '__back__') continue;
-
-    selected = await multiselect({
-      message: `${pc.dim('Step 3/5')}  Select packages`,
-      options: [
-        { value: 'security', label: '@claude-code-hooks/security', hint: 'Warn/block risky commands' },
-        { value: 'secrets', label: '@claude-code-hooks/secrets', hint: 'Detect secret-like tokens' },
-        { value: 'sound', label: '@claude-code-hooks/sound', hint: 'Play sounds for key events' },
-        { value: 'notification', label: '@claude-code-hooks/notification', hint: 'OS notifications for key events' }
-      ],
-      required: true
-    });
-    if (isCancel(selected)) dieCancelled();
+  const packageOptions = [
+    { value: 'security', label: t('cli.pkgSecurity'), hint: t('cli.pkgSecurityHint') },
+    { value: 'secrets', label: t('cli.pkgSecrets'), hint: t('cli.pkgSecretsHint') },
+    { value: 'sound', label: t('cli.pkgSound'), hint: t('cli.pkgSoundHint') },
+    { value: 'notification', label: t('cli.pkgNotification'), hint: t('cli.pkgNotificationHint') }
+  ];
 
-    const proceed = await confirm({ message: 'Configure these packages now?', initialValue: true });
-    if (isCancel(proceed)) dieCancelled();
-    if (!proceed) continue;
+  while (true) {
+    if (step === 1) {
+      action = await select({
+        message: `${pc.dim(t('cli.stepFormat', { n: 1 }))}  ${t('cli.step1ChooseAction')}`,
+        options: [
+          { value: 'setup', label: t('cli.actionSetup') },
+          { value: 'uninstall', label: t('cli.actionUninstall') },
+          { value: 'exit', label: t('cli.actionExit') }
+        ]
+      });
+      if (isCancel(action) || action === 'exit') dieCancelled(t('cli.bye'));
+      step = 2;
+    }
+
+    if (step === 2) {
+      const targetCtrl = new AbortController();
+      const { result: targetResult, wentBack: targetBack } = await withBackspaceBack(targetCtrl, () =>
+        select({
+          message: `${pc.dim(t('cli.stepFormat', { n: 2 }))}  ${t('cli.step2ChooseTarget')}`,
+          options: [
+            { value: 'global', label: t('cli.targetGlobal') },
+            { value: 'projectOnly', label: t('cli.targetProjectOnly').replace(CONFIG_FILENAME, pc.bold(CONFIG_FILENAME)) }
+          ],
+          signal: targetCtrl.signal
+        })
+      );
+      if (targetBack) {
+        step = 1;
+        continue;
+      }
+      if (isCancel(targetResult)) dieCancelled();
+      target = targetResult;
+      step = 3;
+    }
+
+    if (step === 3) {
+      const pkgsCtrl = new AbortController();
+      const { result: pkgsResult, wentBack: pkgsBack } = await withBackspaceBack(pkgsCtrl, () =>
+        multiselect({
+          message: `${pc.dim(t('cli.stepFormat', { n: 3 }))}  ${t('cli.step3SelectPackages')}`,
+          options: packageOptions,
+          required: true,
+          signal: pkgsCtrl.signal
+        })
+      );
+      if (pkgsBack) {
+        step = 2;
+        continue;
+      }
+      if (isCancel(pkgsResult)) dieCancelled();
+      selected = pkgsResult;
+      step = 4;
+    }
+
+    if (step === 4) {
+      const proceedCtrl = new AbortController();
+      const { result: proceedResult, wentBack: proceedBack } = await withBackspaceBack(proceedCtrl, () =>
+        confirm({ message: t('cli.configureNow'), initialValue: true, signal: proceedCtrl.signal })
+      );
+      if (proceedBack) {
+        step = 3;
+        continue;
+      }
+      if (isCancel(proceedResult)) dieCancelled();
+      if (!proceedResult) {
+        step = 2;
+        continue;
+      }
+      step = 5;
+    }
+
+    if (step !== 5) continue;
+
+    // Build per-package plan/config
+    perPackage = { security: null, secrets: null, sound: null, notification: null };
+
+    const packageDescs = {
+      security: t('cli.pkgSecurityHint'),
+      secrets: t('cli.pkgSecretsHint'),
+      sound: t('cli.pkgSoundHint'),
+      notification: t('cli.pkgNotificationHint')
+    };
+
+    const formatPackageList = (/** @type {string | null} */ highlightKey) =>
+      selected
+        .map(
+          (k) => {
+            const desc = pc.dim(packageDescs[k] || '');
+            const label = highlightKey === k ? pc.cyan(pc.bold(k)) : pc.bold(k);
+            return `${label}: ${desc}`;
+          }
+        )
+        .join('\n');
+
+    // ── Step 4/5: configure (highlight current package) ──
+    if (selected.includes('security')) {
+      note(formatPackageList('security'), `${pc.dim(t('cli.stepFormat', { n: 4 }))}  ${t('cli.step4Configure')}`);
+      perPackage.security = await planSecuritySetup({ action, projectDir, ui: 'umbrella' });
+    }
+    if (selected.includes('secrets')) {
+      note(formatPackageList('secrets'), `${pc.dim(t('cli.stepFormat', { n: 4 }))}  ${t('cli.step4Configure')}`);
+      perPackage.secrets = await planSecretsSetup({ action, projectDir, ui: 'umbrella' });
+    }
+    if (selected.includes('sound')) {
+      note(formatPackageList('sound'), `${pc.dim(t('cli.stepFormat', { n: 4 }))}  ${t('cli.step4Configure')}`);
+      perPackage.sound = await planSoundSetup({ action, projectDir, ui: 'umbrella' });
+    }
+    if (selected.includes('notification')) {
+      note(formatPackageList('notification'), `${pc.dim(t('cli.stepFormat', { n: 4 }))}  ${t('cli.step4Configure')}`);
+      perPackage.notification = await planNotificationSetup({ action, projectDir, ui: 'umbrella' });
+    }
+
+    // ── Step 5/5: review ──
+    const files = [];
+    if (target === 'global') files.push(configPathForScope('global', projectDir));
+    if (target === 'projectOnly') {
+      files.push(path.join(projectDir, CONFIG_FILENAME));
+      files.push(path.join(projectDir, 'claude-code-hooks.snippet.json (optional)'));
+    }
+
+    function summarizePlan(key, plan) {
+      if (!plan) return `${key}: ${t('cli.summarySkipped')}`;
+      if (action === 'uninstall') return `${key}: ${t('cli.summaryRemoveHooks')}`;
+
+      const events = plan.snippetHooks ? Object.keys(plan.snippetHooks) : [];
+      const list = events.slice(0, 5);
+      const tail = events.length > 5 ? ` +${events.length - 5} more` : '';
+      return `${key}: ${t('cli.summaryEvents', { count: events.length })}${events.length ? ` (${list.join(', ')}${tail})` : ''}`;
+    }
+
+    note(
+      [
+        `${pc.dim(t('cli.stepFormat', { n: 5 }))}  ${t('cli.step5Review')}`,
+        '',
+        `${t('cli.reviewAction')}: ${pc.bold(action)}`,
+        `${t('cli.reviewTarget')}: ${pc.bold(target === 'global' ? t('cli.reviewTargetGlobal') : t('cli.reviewTargetProjectOnly'))}`,
+        '',
+        `${pc.bold(t('cli.reviewPackages'))}`,
+        ...selected.map((k) => `  - ${summarizePlan(k, perPackage[k])}`),
+        '',
+        `${pc.bold(t('cli.reviewFiles'))}`,
+        ...files.map((f) => `  - ${f}`)
+      ].join('\n'),
+      t('cli.step5Review')
+    );
+
+    const applyCtrl = new AbortController();
+    const { result: applyResult, wentBack: applyBack } = await withBackspaceBack(applyCtrl, () =>
+      select({
+        message: t('cli.applyChanges'),
+        options: [
+          { value: 'yes', label: t('cli.applyYes') },
+          { value: 'cancel', label: t('cli.applyCancel') }
+        ],
+        signal: applyCtrl.signal
+      })
+    );
+    if (applyBack) {
+      step = 3;
+      continue;
+    }
+    if (isCancel(applyResult) || applyResult === 'cancel') dieCancelled(t('cli.noChanges'));
 
     break;
   }
 
-  // Build per-package plan/config
-  const perPackage = { security: null, secrets: null, sound: null, notification: null };
-
-  // ── Step 4/5: configure ──
-  note(
-    selected
-      .map(
-        (k) =>
-          `${pc.bold(k)}: ${pc.dim(
-            {
-              security: 'Warn/block risky commands',
-              secrets: 'Detect secret-like tokens',
-              sound: 'Play sounds for key events',
-              notification: 'OS notifications for key events'
-            }[k] || ''
-          )}`
-      )
-      .join('\n'),
-    `${pc.dim('Step 4/5')}  Configure packages`
-  );
-
-  if (selected.includes('security')) perPackage.security = await planSecuritySetup({ action, projectDir, ui: 'umbrella' });
-  if (selected.includes('secrets')) perPackage.secrets = await planSecretsSetup({ action, projectDir, ui: 'umbrella' });
-  if (selected.includes('sound')) perPackage.sound = await planSoundSetup({ action, projectDir, ui: 'umbrella' });
-  if (selected.includes('notification')) perPackage.notification = await planNotificationSetup({ action, projectDir, ui: 'umbrella' });
-
-  // ── Step 5/5: review ──
-  const files = [];
-  if (target === 'global') files.push(configPathForScope('global', projectDir));
-  if (target === 'projectOnly') {
-    files.push(path.join(projectDir, CONFIG_FILENAME));
-    files.push(path.join(projectDir, 'claude-code-hooks.snippet.json (optional)'));
-  }
-
-  function summarizePlan(key, plan) {
-    if (!plan) return `${key}: (skipped)`;
-    if (action === 'uninstall') return `${key}: remove managed hooks`;
-
-    const events = plan.snippetHooks ? Object.keys(plan.snippetHooks) : [];
-    const list = events.slice(0, 5);
-    const tail = events.length > 5 ? ` +${events.length - 5} more` : '';
-    return `${key}: ${events.length} event(s)${events.length ? ` (${list.join(', ')}${tail})` : ''}`;
-  }
-
-  note(
-    [
-      `${pc.dim('Step 5/5')}  Review`,
-      '',
-      `Action: ${pc.bold(action)}`,
-      `Target: ${pc.bold(target === 'global' ? 'global settings' : 'project-only')}`,
-      '',
-      `${pc.bold('Packages')}`,
-      ...selected.map((k) => `  - ${summarizePlan(k, perPackage[k])}`),
-      '',
-      `${pc.bold('Files')}`,
-      ...files.map((f) => `  - ${f}`)
-    ].join('\n'),
-    'Review'
-  );
-
-  const ok = await confirm({ message: 'Apply changes?', initialValue: true });
-  if (isCancel(ok) || !ok) dieCancelled('No changes made');
-
   if (target === 'projectOnly') {
     // Write project config
     const s = spinner();
-    s.start('Writing project config...');
+    s.start(t('cli.writingProjectConfig'));
 
     // perPackage.*.projectConfigSection is shaped for claude-code-hooks.config.json sections.
     const projectCfg = await ensureProjectOnlyConfig(projectDir, selected, {
@@ -220,12 +330,12 @@ async function main() {
       }
     });
 
-    s.stop('Done');
+    s.stop(t('cli.done'));
 
-    note(JSON.stringify(snippetObj, null, 2), 'Paste into ~/.claude/settings.json (global)');
+    note(JSON.stringify(snippetObj, null, 2), t('cli.pasteSnippet'));
     await maybeWriteSnippet(projectDir, snippetObj);
 
-    outro(`Project config written: ${pc.bold(configFilePath(projectDir))}`);
+    outro(`${t('cli.projectConfigWritten')}: ${pc.bold(configFilePath(projectDir))}`);
     return;
   }
 
@@ -233,14 +343,14 @@ async function main() {
   const settingsPath = configPathForScope('global', projectDir);
   const res = await readJsonIfExists(settingsPath);
   if (!res.ok) {
-    cancel(`Could not read/parse JSON at ${settingsPath}`);
+    cancel(t('cli.couldNotReadJson', { path: settingsPath }));
     process.exit(1);
   }
 
   let settings = res.value;
 
   const s = spinner();
-  s.start('Applying changes to global settings...');
+  s.start(t('cli.applyingChanges'));
 
   for (const key of selected) {
     const plan = perPackage[key];
@@ -263,8 +373,8 @@ async function main() {
     });
   }
 
-  s.stop('Done');
-  outro(`Saved: ${pc.bold(settingsPath)}`);
+  s.stop(t('cli.done'));
+  outro(`${t('cli.saved')}: ${pc.bold(settingsPath)}`);
 }
 
 main().catch((err) => {