@landienzla/claude-code-notify 1.0.2 → 1.0.4

package/README.md

@@ -54,10 +54,13 @@ Plugin mode requires no changes to your `settings.json` — the hook is loaded a
 | Command | Description |
 |---------|-------------|
 | `claude-code-notify setup` | Install notification hook into `~/.claude/` |
+| `claude-code-notify dry-run` | Preview what setup will change (no writes) |
 | `claude-code-notify test` | Send a test notification |
 | `claude-code-notify uninstall` | Remove notification hook and script |
 | `claude-code-notify help` | Show usage info |
 
+Run `dry-run` first to see exactly what files will be created/modified before committing.
+
 ## How It Works
 
 Claude Code fires a [`Notification`](https://docs.anthropic.com/en/docs/claude-code/hooks) hook whenever it needs your attention. This package provides a handler that:

package/bin/cli.js

@@ -28,12 +28,55 @@ const HOOK_CONFIG = {
   ]
 };
 
+function dryRun() {
+  console.log('Dry run — no changes will be made.\n');
+  console.log('The following changes would be applied:\n');
+  console.log(`  1. Copy notification script to:`);
+  console.log(`     ${NOTIFY_DEST}\n`);
+  console.log(`  2. Add Notification hook to:`);
+  console.log(`     ${SETTINGS_PATH}\n`);
+  console.log('     Hook config:');
+  console.log(JSON.stringify(HOOK_CONFIG, null, 2).split('\n').map(l => '     ' + l).join('\n'));
+
+  if (fs.existsSync(SETTINGS_PATH)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'));
+      if (settings.hooks && settings.hooks.Notification) {
+        console.log('\n  Warning: Existing Notification hook will be replaced.');
+      }
+    } catch (e) {
+      console.log(`\n  Warning: ${SETTINGS_PATH} is invalid JSON and will be backed up.`);
+    }
+  }
+
+  // Check python3
+  const { spawnSync } = require('child_process');
+  const py = spawnSync('python3', ['--version'], { stdio: 'pipe' });
+  if (py.status !== 0) {
+    console.log('\n  Warning: Python 3 not found. Notifications will work but show');
+    console.log('  generic messages instead of contextual ones.');
+  } else {
+    console.log(`\n  Python 3: ${py.stdout.toString().trim()}`);
+  }
+
+  console.log('\nRun "claude-code-notify setup" to apply these changes.');
+}
+
 function setup() {
   if (!fs.existsSync(CLAUDE_DIR)) {
     console.error(`Error: ${CLAUDE_DIR} does not exist. Is Claude Code installed?`);
     process.exit(1);
   }
 
+  // Check python3 availability
+  const { spawnSync } = require('child_process');
+  const py = spawnSync('python3', ['--version'], { stdio: 'pipe' });
+  if (py.status !== 0) {
+    console.log('  Warning: Python 3 not found. Notifications will work but show');
+    console.log('  generic messages instead of contextual ones.');
+    console.log('  Install Python 3 for full functionality.\n');
+  }
+
   // Copy notify.sh
   fs.mkdirSync(SCRIPTS_DIR, { recursive: true });
   fs.copyFileSync(NOTIFY_SRC, NOTIFY_DEST);
@@ -53,6 +96,10 @@ function setup() {
     }
   }
 
+  if (settings.hooks && settings.hooks.Notification) {
+    console.log('  Replacing existing Notification hook.');
+  }
+
   if (!settings.hooks) settings.hooks = {};
   settings.hooks.Notification = HOOK_CONFIG.Notification;
 
@@ -90,7 +137,13 @@ function uninstall() {
 function test() {
   const input = JSON.stringify({ notification_message: 'Test notification from claude-code-notify' });
   try {
-    execSync(`echo '${input}' | bash "${NOTIFY_SRC}"`, { stdio: 'inherit', timeout: 15000 });
+    const { spawnSync } = require('child_process');
+    const result = spawnSync('bash', [NOTIFY_SRC], {
+      input,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      timeout: 15000
+    });
+    if (result.status !== 0) throw new Error(`exit code ${result.status}`);
     console.log('Test notification sent!');
   } catch (e) {
     console.error('Test failed:', e.message);
@@ -104,6 +157,7 @@ claude-code-notify - Desktop notifications for Claude Code
 
 Usage:
   claude-code-notify setup       Install notification hook into ~/.claude/
+  claude-code-notify dry-run     Preview what setup will change (no writes)
   claude-code-notify uninstall   Remove notification hook from ~/.claude/
   claude-code-notify test        Send a test notification
   claude-code-notify help        Show this help
@@ -117,6 +171,7 @@ const command = process.argv[2];
 
 switch (command) {
   case 'setup':    setup(); break;
+  case 'dry-run':  dryRun(); break;
   case 'uninstall': uninstall(); break;
   case 'test':     test(); break;
   case 'help': case '--help': case '-h': case undefined: help(); break;

package/hooks/scripts/notify.sh

@@ -7,7 +7,7 @@ INPUT=$(cat)
 # Parse JSON and sanitize for safe shell usage
 # - Strip characters that could break shell/PowerShell/XML/AppleScript interpolation
 # - Truncate to 200 chars (OS notification display limit)
-MESSAGE=$(echo "$INPUT" | python3 -c "
+MESSAGE=$(printf '%s' "$INPUT" | python3 -c "
 import sys, json, re
 data = json.load(sys.stdin)
 message = data.get('notification_message', data.get('message', 'Needs your attention'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@landienzla/claude-code-notify",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Cross-platform desktop notifications for Claude Code — plugin and CLI setup tool",
   "author": "Talha <landienzla@gmail.com>",
   "license": "MIT",