claude-notification-plugin 1.0.28 → 1.0.33

package/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "claude-notification-plugin",
+  "version": "1.0.33",
+  "description": "Telegram, Windows toast, sound, and voice notifications for Claude Code task completion",
+  "author": {
+    "name": "Viacheslav Makarov",
+    "email": "npmjs@bazilio.ru"
+  },
+  "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
+  "repository": "https://github.com/Bazilio-san/claude-notification-plugin",
+  "license": "MIT",
+  "keywords": ["notification", "telegram", "windows", "sound", "voice", "hooks"],
+  "hooks": "./hooks/hooks.json",
+  "commands": "./commands/"
+}

package/README.md

@@ -5,25 +5,51 @@ Notifications for Claude Code task completion. Sends alerts to Telegram and Wind
 ## Features
 
 - Windows desktop notifications (toast)
-- Telegram bot messages
-- Sound alert
-- Voice announcement (TTS)
+- Telegram bot messages with auto-delete
+- Sound alert (hidden PowerShell, no popup windows)
+- Voice announcement with number-to-words and pluralization (EN, RU)
 - Separate notifications for task completion and waiting-for-input events
 - Skips short tasks (< 15s by default)
 - Granular per-channel enable/disable (globally and per-project)
+- Debug mode with full hook event dump
 
 ## Install
 
+### Option A: Claude Code Plugin (recommended)
+
+Add the marketplace and install:
+
+```shell
+/plugin marketplace add Bazilio-san/claude-plugins
+/plugin install claude-notification-plugin@bazilio-plugins
+```
+
+Or load directly for testing:
+
+```bash
+claude --plugin-dir /path/to/claude-notification-plugin
+```
+
+Hooks are registered automatically. To configure Telegram credentials, run:
+
+```shell
+/claude-notification-plugin:setup
+```
+
+### Option B: npm global package
+
 ```bash
 npm install -g claude-notification-plugin
 claude-notify-install
 ```
 
 The installer will:
-1. Ask for Telegram bot credentials (optional)
-2. Create config at `~/.claude/notifier.config.json`
+1. Ask for Telegram bot credentials (or keep existing ones on re-run)
+2. Create/update config at `~/.claude/notifier.config.json`
 3. Register hooks in `~/.claude/settings.json`
 
+Re-running `claude-notify-install` after an update merges new config options without overwriting your existing settings.
+
 ## Configuration
 
 Config file: `~/.claude/notifier.config.json`
@@ -58,7 +84,7 @@ Each channel has an `enabled` flag (`true`/`false`) for global control.
 
 `notifyOnWaiting` — send notifications when Claude is waiting for user input, e.g. permission prompts (default: `false`, set `true` to enable).
 
-`debug` — include extra info in notifications for troubleshooting: voice phrase text when voice is enabled (default: `false`).
+`debug` — include extra info in notifications: voice phrase text, full hook event JSON (formatted as code block in Telegram). Default: `false`.
 
 Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
 
@@ -103,6 +129,28 @@ To disable all notifications for a project:
 }
 ```
 
+## Notification format
+
+Notifications include project name, duration, and the trigger event:
+
+```
+🤖 Claude finished coding
+
+Project: my-project
+Duration: 45s
+Trigger: Stop
+```
+
+When Claude is waiting for input (and `notifyOnWaiting` is enabled):
+
+```
+🤖 Claude waiting for input
+
+Project: my-project
+Duration: 30s
+Trigger: Notification
+```
+
 ## Telegram Setup
 
 1. Open Telegram, find **@BotFather**
@@ -117,6 +165,12 @@ Alternative for Chat ID: add **@userinfobot** to a chat and it will reply with t
 
 ## Uninstall
 
+### Plugin install
+
+Uninstall via the plugin manager or remove `--plugin-dir` flag.
+
+### npm install
+
 ```bash
 claude-notify-uninstall
 npm uninstall -g claude-notification-plugin

package/commands/setup.md

@@ -0,0 +1,46 @@
+---
+description: Configure Telegram credentials and notification settings
+---
+
+# Setup claude-notification-plugin
+
+Help the user configure the notification plugin. The config file is `~/.claude/notifier.config.json`.
+
+## Steps
+
+1. **Read existing config** (if it exists) from `~/.claude/notifier.config.json` to preserve current settings.
+
+2. **Ask for Telegram bot token**. If a token already exists in the config, show a masked version (first 6 and last 4 characters) and ask if the user wants to keep it. If they want a new one, ask them to provide it.
+
+3. **Get the Chat ID**. If the token is available and Chat ID is missing:
+   - Ask the user to send any message to their bot in Telegram.
+   - Fetch `https://api.telegram.org/bot<TOKEN>/getUpdates` to auto-detect the Chat ID.
+   - If auto-detection fails, ask the user to enter the Chat ID manually.
+   - If Chat ID already exists, show it and ask if the user wants to keep it.
+
+4. **Write the config** to `~/.claude/notifier.config.json`. Merge with existing config — do NOT overwrite settings that already exist (`minSeconds`, `notifyOnWaiting`, `debug`, channel `enabled` flags, etc.). Only update `telegram.token` and `telegram.chatId` with the values from this session.
+
+   Default config structure (for new installs):
+   ```json
+   {
+     "telegram": {
+       "enabled": true,
+       "token": "<TOKEN>",
+       "chatId": "<CHAT_ID>",
+       "deleteAfterHours": 24
+     },
+     "windowsNotification": { "enabled": true },
+     "sound": { "enabled": true, "file": "C:/Windows/Media/notify.wav" },
+     "voice": { "enabled": true },
+     "minSeconds": 15,
+     "notifyOnWaiting": false,
+     "debug": false
+   }
+   ```
+
+5. **Confirm** — show the user a summary of what was saved.
+
+## Important
+
+- NEVER log or display the full token. Always mask it.
+- Preserve all existing config values when writing — only update token and chatId.

package/hooks/hooks.json

@@ -0,0 +1,34 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/notifier/notifier.js"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/notifier/notifier.js"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/notifier/notifier.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/notifier/notifier.js

@@ -145,13 +145,17 @@ async function sendTelegram (config, state) {
 
   // Send new message and store its id
   try {
+    const body = {
+      chat_id: config.telegram.chatId,
+      text: state._telegramText,
+    };
+    if (config.debug) {
+      body.parse_mode = 'Markdown';
+    }
     const res = await fetch(`${baseUrl}/sendMessage`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        chat_id: config.telegram.chatId,
-        text: state._telegramText,
-      }),
+      body: JSON.stringify(body),
     });
     const data = await res.json();
     if (data.ok && data.result?.message_id) {
@@ -449,8 +453,12 @@ process.stdin.on('end', async () => {
   let message =
     `${title}\n\nProject: ${project}\nDuration: ${duration}s\nTrigger: ${eventType}`;
 
-  if (config.debug && config.voice.enabled) {
-    message += `\nVoice: ${getVoicePhrase(duration)}`;
+  if (config.debug) {
+    message += '\n\n*Debug:*\n';
+    if (config.voice.enabled) {
+      message += `\nVoice: ${getVoicePhrase(duration)}`;
+    }
+    message += `\n\nHook input:\n\`\`\`json\n${JSON.stringify(event, null, 2)}\n\`\`\``;
   }
 
   state._telegramText = `\u{1F916} ${message}`;

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.0.28",
-  "description": "Telegram and Windows notifications for Claude Code task completion",
+  "version": "1.0.33",
+  "description": "Telegram, Windows toast, sound, and voice notifications for Claude Code task completion",
   "type": "module",
   "engines": {
     "node": ">=18.0.0"
   },
   "files": [
+    ".claude-plugin/",
     "bin/",
+    "commands/",
+    "hooks/",
     "notifier/",
     "README.md",
     "LICENSE"