claude-notification-plugin 1.0.3 → 1.0.6

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Michael Makarov
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Michael Makarov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,82 +1,113 @@
-# claude-notification-plugin
-
-Notifications for Claude Code task completion. Sends alerts to Telegram and Windows when Claude finishes working.
-
-## Features
-
-- Windows desktop notifications (toast)
-- Telegram bot messages
-- Sound alert
-- Voice announcement
-- Skips short tasks (< 15s by default)
-- Per-project disable
-
-## Install
-
-```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`
-3. Register hooks in `~/.claude/settings.json`
-
-## Configuration
-
-Config file: `~/.claude/notifier.config.json`
-
-```json
-{
-  "telegram": {
-    "token": "YOUR_BOT_TOKEN",
-    "chatId": "YOUR_CHAT_ID"
-  },
-  "sound": {
-    "enabled": true,
-    "file": "C:/Windows/Media/notify.wav"
-  },
-  "voice": {
-    "enabled": true
-  },
-  "minSeconds": 15
-}
-```
-
-Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
-
-### Disable per project
-
-Add to `.claude/settings.local.json` in the project root:
-
-```json
-{
-  "env": {
-    "DISABLE_CLAUDE_NOTIFIER": "1"
-  }
-}
-```
-
-## Telegram Setup
-
-1. Open Telegram, find **@BotFather**
-2. Send `/newbot`, follow prompts, pick a name
-3. Copy the bot token (format: `123456789:ABCdef...`)
-4. Send any message to your new bot
-5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
-6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
-7. Run `claude-notify-install` and enter the token and chat ID
-
-Alternative for Chat ID: add **@userinfobot** to a chat and it will reply with the ID.
-
-## Uninstall
-
-```bash
-claude-notify-uninstall
-npm uninstall -g claude-notification-plugin
-```
-
-## License
-
-MIT
+# claude-notification-plugin
+
+Notifications for Claude Code task completion. Sends alerts to Telegram and Windows when Claude finishes working.
+
+## Features
+
+- Windows desktop notifications (toast)
+- Telegram bot messages
+- Sound alert
+- Voice announcement (TTS)
+- Skips short tasks (< 15s by default)
+- Granular per-channel enable/disable (globally and per-project)
+
+## Install
+
+```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`
+3. Register hooks in `~/.claude/settings.json`
+
+## Configuration
+
+Config file: `~/.claude/notifier.config.json`
+
+```json
+{
+  "telegram": {
+    "enabled": true,
+    "token": "YOUR_BOT_TOKEN",
+    "chatId": "YOUR_CHAT_ID"
+  },
+  "windowsNotification": {
+    "enabled": true
+  },
+  "sound": {
+    "enabled": true,
+    "file": "C:/Windows/Media/notify.wav"
+  },
+  "voice": {
+    "enabled": true
+  },
+  "minSeconds": 15
+}
+```
+
+Each channel has an `enabled` flag (`true`/`false`) for global control.
+
+Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
+
+### Per-channel environment variables
+
+These env vars override the global config per channel (`"1"` = on, `"0"` = off):
+
+| Variable                 | Channel                    |
+|--------------------------|----------------------------|
+| `CLAUDE_NOTIFY_TELEGRAM` | Telegram messages          |
+| `CLAUDE_NOTIFY_WINDOWS`  | Windows toast notifications|
+| `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
+| `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
+
+### Per-project configuration
+
+Add to `.claude/settings.local.json` in the project root to control channels per project:
+
+```json
+{
+  "env": {
+    "DISABLE_CLAUDE_NOTIFIER": 0,
+    "CLAUDE_NOTIFY_TELEGRAM": 1,
+    "CLAUDE_NOTIFY_WINDOWS": 1,
+    "CLAUDE_NOTIFY_SOUND": 1,
+    "CLAUDE_NOTIFY_VOICE": 1
+  }
+}
+```
+
+To disable all notifications for a project:
+
+```json
+{
+  "env": {
+    "DISABLE_CLAUDE_NOTIFIER": "1"
+  }
+}
+```
+
+## Telegram Setup
+
+1. Open Telegram, find **@BotFather**
+2. Send `/newbot`, follow prompts, pick a name
+3. Copy the bot token (format: `123456789:ABCdef...`)
+4. **Send any message to your new bot**
+5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
+6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
+7. Run `claude-notify-install` and enter the token and chat ID
+
+Alternative for Chat ID: add **@userinfobot** to a chat and it will reply with the ID.
+
+## Uninstall
+
+```bash
+claude-notify-uninstall
+npm uninstall -g claude-notification-plugin
+```
+
+## License
+
+MIT

package/bin/install.js

@@ -1,165 +1,166 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import readline from 'readline';
-
-const home = os.homedir();
-const claudeDir = path.join(home, '.claude');
-const configPath = path.join(claudeDir, 'notifier.config.json');
-const settingsPath = path.join(claudeDir, 'settings.json');
-
-const HOOK_COMMAND = 'claude-notifier';
-
-// ----------------------
-// HELPERS
-// ----------------------
-
-function ask (rl, question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => resolve(answer.trim()));
-  });
-}
-
-async function fetchChatId (token) {
-  const url = `https://api.telegram.org/bot${token}/getUpdates`;
-
-  try {
-    const res = await fetch(url);
-    const data = await res.json();
-
-    if (!data.ok || !data.result?.length) {
-      return null;
-    }
-
-    const msg = data.result[data.result.length - 1].message;
-    if (msg?.chat?.id) {
-      return String(msg.chat.id);
-    }
-  } catch {
-    // silent fail
-  }
-
-  return null;
-}
-
-function addHook (settings, event) {
-  if (!settings.hooks[event]) {
-    settings.hooks[event] = [];
-  }
-
-  const exists = settings.hooks[event].some((matcher) =>
-    matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
-  );
-
-  if (!exists) {
-    settings.hooks[event].push({
-      hooks: [
-        {
-          type: 'command',
-          command: HOOK_COMMAND,
-        },
-      ],
-    });
-  }
-}
-
-// ----------------------
-// MAIN
-// ----------------------
-
-async function main () {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  console.log('');
-  console.log('Claude Notification Plugin - Setup');
-  console.log('==================================');
-  console.log('');
-
-  // Telegram setup
-  let token = '';
-  let chatId = '';
-
-  const useTelegram = await ask(rl, 'Configure Telegram? (y/N): ');
-
-  if (useTelegram.toLowerCase() === 'y') {
-    token = await ask(rl, 'Bot Token: ');
-
-    if (token) {
-      console.log('');
-      console.log('Send any message to your bot in Telegram, then press Enter.');
-      await ask(rl, '');
-
-      console.log('Fetching Chat ID...');
-      chatId = await fetchChatId(token);
-
-      if (chatId) {
-        console.log('Chat ID detected: ' + chatId);
-      } else {
-        console.log('Could not detect Chat ID automatically.');
-        chatId = await ask(rl, 'Enter Chat ID manually: ');
-      }
-    }
-  }
-
-  rl.close();
-
-  // Create config
-  fs.mkdirSync(claudeDir, { recursive: true });
-
-  const config = {
-    telegram: { token, chatId },
-    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
-    voice: { enabled: true },
-    minSeconds: 15,
-  };
-
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-  // Patch settings.json
-  let settings = {};
-
-  if (fs.existsSync(settingsPath)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-    } catch {
-      settings = {};
-    }
-  }
-
-  settings.hooks = settings.hooks || {};
-
-  addHook(settings, 'UserPromptSubmit');
-  addHook(settings, 'Stop');
-  addHook(settings, 'Notification');
-
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-
-  // Output
-  console.log('');
-  console.log('Installed!');
-  console.log('');
-  console.log('Hooks registered:');
-  console.log('  - UserPromptSubmit (start timer)');
-  console.log('  - Stop (task finished)');
-  console.log('  - Notification (waiting for input)');
-  console.log('');
-  console.log('Config: ' + configPath);
-
-  if (token) {
-    console.log('Telegram: configured');
-  } else {
-    console.log('Telegram: skipped (edit config later)');
-  }
-
-  console.log('');
-  console.log('To disable per project, add to .claude/settings.local.json:');
-  console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');
-  console.log('');
-}
-
-main().then(() => 0);
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import readline from 'readline';
+
+const home = os.homedir();
+const claudeDir = path.join(home, '.claude');
+const configPath = path.join(claudeDir, 'notifier.config.json');
+const settingsPath = path.join(claudeDir, 'settings.json');
+
+const HOOK_COMMAND = 'claude-notifier';
+
+// ----------------------
+// HELPERS
+// ----------------------
+
+function ask (rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+async function fetchChatId (token) {
+  const url = `https://api.telegram.org/bot${token}/getUpdates`;
+
+  try {
+    const res = await fetch(url);
+    const data = await res.json();
+
+    if (!data.ok || !data.result?.length) {
+      return null;
+    }
+
+    const msg = data.result[data.result.length - 1].message;
+    if (msg?.chat?.id) {
+      return String(msg.chat.id);
+    }
+  } catch {
+    // silent fail
+  }
+
+  return null;
+}
+
+function addHook (settings, event) {
+  if (!settings.hooks[event]) {
+    settings.hooks[event] = [];
+  }
+
+  const exists = settings.hooks[event].some((matcher) =>
+    matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
+  );
+
+  if (!exists) {
+    settings.hooks[event].push({
+      hooks: [
+        {
+          type: 'command',
+          command: HOOK_COMMAND,
+        },
+      ],
+    });
+  }
+}
+
+// ----------------------
+// MAIN
+// ----------------------
+
+async function main () {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log('');
+  console.log('Claude Notification Plugin - Setup');
+  console.log('==================================');
+  console.log('');
+
+  // Telegram setup
+  let token = '';
+  let chatId = '';
+
+  const useTelegram = await ask(rl, 'Configure Telegram? (y/N): ');
+
+  if (useTelegram.toLowerCase() === 'y') {
+    token = await ask(rl, 'Bot Token: ');
+
+    if (token) {
+      console.log('');
+      console.log('Send any message to your bot in Telegram, then press Enter.');
+      await ask(rl, '');
+
+      console.log('Fetching Chat ID...');
+      chatId = await fetchChatId(token);
+
+      if (chatId) {
+        console.log('Chat ID detected: ' + chatId);
+      } else {
+        console.log('Could not detect Chat ID automatically.');
+        chatId = await ask(rl, 'Enter Chat ID manually: ');
+      }
+    }
+  }
+
+  rl.close();
+
+  // Create config
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  const config = {
+    telegram: { enabled: true, token, chatId },
+    windowsNotification: { enabled: true },
+    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
+    voice: { enabled: true },
+    minSeconds: 15,
+  };
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  // Patch settings.json
+  let settings = {};
+
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    } catch {
+      settings = {};
+    }
+  }
+
+  settings.hooks = settings.hooks || {};
+
+  addHook(settings, 'UserPromptSubmit');
+  addHook(settings, 'Stop');
+  addHook(settings, 'Notification');
+
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+
+  // Output
+  console.log('');
+  console.log('Installed!');
+  console.log('');
+  console.log('Hooks registered:');
+  console.log('  - UserPromptSubmit (start timer)');
+  console.log('  - Stop (task finished)');
+  console.log('  - Notification (waiting for input)');
+  console.log('');
+  console.log('Config: ' + configPath);
+
+  if (token) {
+    console.log('Telegram: configured');
+  } else {
+    console.log('Telegram: skipped (edit config later)');
+  }
+
+  console.log('');
+  console.log('To disable per project, add to .claude/settings.local.json:');
+  console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');
+  console.log('');
+}
+
+main().then(() => 0);

package/bin/uninstall.js

@@ -1,53 +1,53 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-
-const home = os.homedir();
-const claudeDir = path.join(home, '.claude');
-const configPath = path.join(claudeDir, 'notifier.config.json');
-const settingsPath = path.join(claudeDir, 'settings.json');
-const statePath = path.join(claudeDir, '.notifier_state.json');
-
-const HOOK_COMMAND = 'claude-notifier';
-
-// Remove hooks from settings.json
-if (fs.existsSync(settingsPath)) {
-  try {
-    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-
-    if (settings.hooks) {
-      for (const event of Object.keys(settings.hooks)) {
-        settings.hooks[event] = settings.hooks[event].filter((matcher) =>
-          !matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
-        );
-
-        if (settings.hooks[event].length === 0) {
-          delete settings.hooks[event];
-        }
-      }
-
-      if (Object.keys(settings.hooks).length === 0) {
-        delete settings.hooks;
-      }
-    }
-
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-  } catch {
-    // ignore
-  }
-}
-
-// Remove config and state files
-for (const file of [configPath, statePath]) {
-  if (fs.existsSync(file)) {
-    fs.unlinkSync(file);
-  }
-}
-
-console.log('');
-console.log('Claude Notification Plugin uninstalled.');
-console.log('Hooks removed from settings.json');
-console.log('Config files deleted.');
-console.log('');
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const home = os.homedir();
+const claudeDir = path.join(home, '.claude');
+const configPath = path.join(claudeDir, 'notifier.config.json');
+const settingsPath = path.join(claudeDir, 'settings.json');
+const statePath = path.join(claudeDir, '.notifier_state.json');
+
+const HOOK_COMMAND = 'claude-notifier';
+
+// Remove hooks from settings.json
+if (fs.existsSync(settingsPath)) {
+  try {
+    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+
+    if (settings.hooks) {
+      for (const event of Object.keys(settings.hooks)) {
+        settings.hooks[event] = settings.hooks[event].filter((matcher) =>
+          !matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
+        );
+
+        if (settings.hooks[event].length === 0) {
+          delete settings.hooks[event];
+        }
+      }
+
+      if (Object.keys(settings.hooks).length === 0) {
+        delete settings.hooks;
+      }
+    }
+
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+  } catch {
+    // ignore
+  }
+}
+
+// Remove config and state files
+for (const file of [configPath, statePath]) {
+  if (fs.existsSync(file)) {
+    fs.unlinkSync(file);
+  }
+}
+
+console.log('');
+console.log('Claude Notification Plugin uninstalled.');
+console.log('Hooks removed from settings.json');
+console.log('Config files deleted.');
+console.log('');

package/notifier/notifier.js

@@ -1,231 +1,252 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import process from 'process';
-import notifier from 'node-notifier';
-import player from 'play-sound';
-import say from 'say';
-
-const audio = player({});
-
-// ----------------------
-// CONFIG
-// ----------------------
-
-function loadConfig () {
-  const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
-
-  const config = {
-    telegram: { token: '', chatId: '' },
-    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
-    voice: { enabled: true },
-    minSeconds: 15,
-  };
-
-  if (fs.existsSync(configPath)) {
-    try {
-      const raw = fs.readFileSync(configPath, 'utf-8');
-      const user = JSON.parse(raw);
-      if (user.telegram) {
-        config.telegram = { ...config.telegram, ...user.telegram };
-      }
-      if (user.sound) {
-        config.sound = { ...config.sound, ...user.sound };
-      }
-      if (user.voice) {
-        config.voice = { ...config.voice, ...user.voice };
-      }
-      if (typeof user.minSeconds === 'number') {
-        config.minSeconds = user.minSeconds;
-      }
-    } catch {
-      // ignore malformed config
-    }
-  }
-
-  if (process.env.TELEGRAM_TOKEN) {
-    config.telegram.token = process.env.TELEGRAM_TOKEN;
-  }
-  if (process.env.TELEGRAM_CHAT_ID) {
-    config.telegram.chatId = process.env.TELEGRAM_CHAT_ID;
-  }
-
-  return config;
-}
-
-// ----------------------
-// PROJECT-LEVEL DISABLE
-// ----------------------
-
-function isNotifierDisabled () {
-  return process.env.DISABLE_CLAUDE_NOTIFIER === '1'
-    || process.env.DISABLE_CLAUDE_NOTIFIER === 'true';
-}
-
-// ----------------------
-// STATE FILE
-// ----------------------
-
-const STATE_FILE = path.join(
-  os.homedir(),
-  '.claude',
-  '.notifier_state.json',
-);
-
-function loadState () {
-  if (fs.existsSync(STATE_FILE)) {
-    try {
-      return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
-    } catch {
-      return {};
-    }
-  }
-  return {};
-}
-
-function saveState (state) {
-  const dir = path.dirname(STATE_FILE);
-  fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(STATE_FILE, JSON.stringify(state));
-}
-
-// ----------------------
-// TELEGRAM
-// ----------------------
-
-async function sendTelegram (config, text) {
-  if (!config.telegram.token || !config.telegram.chatId) {
-    return;
-  }
-
-  const url =
-    `https://api.telegram.org/bot${config.telegram.token}/sendMessage`;
-
-  try {
-    await fetch(url, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        chat_id: config.telegram.chatId,
-        text,
-      }),
-    });
-  } catch {
-    // silent fail
-  }
-}
-
-// ----------------------
-// WINDOWS NOTIFICATION
-// ----------------------
-
-function sendWindowsNotification (message) {
-  notifier.notify({
-    title: 'Claude Code',
-    message,
-    sound: true,
-    wait: false,
-  });
-}
-
-// ----------------------
-// SOUND & VOICE
-// ----------------------
-
-function playSound (config) {
-  if (!config.sound.enabled) {
-    return;
-  }
-  try {
-    audio.play(config.sound.file);
-  } catch {
-    // silent fail
-  }
-}
-
-function speakResult (config, duration) {
-  if (!config.voice.enabled) {
-    return;
-  }
-  try {
-    say.speak(`Claude finished coding in ${duration} seconds`);
-  } catch {
-    // silent fail
-  }
-}
-
-// ----------------------
-// READ HOOK INPUT
-// ----------------------
-
-let input = '';
-
-process.stdin.on('data', (chunk) => {
-  input += chunk;
-});
-
-process.stdin.on('end', async () => {
-  const config = loadConfig();
-
-  let event = {};
-  try {
-    event = JSON.parse(input);
-  } catch {
-    // ignore
-  }
-
-  const eventType = event.hook_event_name || 'unknown';
-  const cwd = event.cwd || process.cwd();
-  const project = path.basename(cwd);
-
-  if (isNotifierDisabled()) {
-    process.exit(0);
-  }
-
-  const state = loadState();
-
-  // ----------------------
-  // START TIMER
-  // ----------------------
-
-  if (eventType === 'UserPromptSubmit') {
-    state.start = Date.now();
-    saveState(state);
-    process.exit(0);
-  }
-
-  // ----------------------
-  // STOP / NOTIFICATION EVENT
-  // ----------------------
-
-  if (eventType !== 'Stop' && eventType !== 'Notification') {
-    process.exit(0);
-  }
-
-  let duration = 0;
-  if (state.start) {
-    duration = Math.round((Date.now() - state.start) / 1000);
-  }
-
-  if (duration < config.minSeconds) {
-    process.exit(0);
-  }
-
-  let status = 'success';
-  if (event.error) {
-    status = 'error';
-  }
-  if (eventType === 'Notification') {
-    status = 'waiting';
-  }
-
-  const message =
-    `Claude finished coding\n\nProject: ${project}\nDuration: ${duration}s\nStatus: ${status}`;
-
-  await sendTelegram(config, `\u{1F916} ${message}`);
-  sendWindowsNotification(message);
-  playSound(config);
-  speakResult(config, duration);
-});
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import process from 'process';
+import notifier from 'node-notifier';
+import player from 'play-sound';
+import say from 'say';
+
+const audio = player({});
+
+// ----------------------
+// CONFIG
+// ----------------------
+
+function loadConfig () {
+  const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
+
+  const config = {
+    telegram: { enabled: true, token: '', chatId: '' },
+    windowsNotification: { enabled: true },
+    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
+    voice: { enabled: true },
+    minSeconds: 15,
+  };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      const raw = fs.readFileSync(configPath, 'utf-8');
+      const user = JSON.parse(raw);
+      if (user.telegram) {
+        config.telegram = { ...config.telegram, ...user.telegram };
+      }
+      if (user.windowsNotification) {
+        config.windowsNotification = { ...config.windowsNotification, ...user.windowsNotification };
+      }
+      if (user.sound) {
+        config.sound = { ...config.sound, ...user.sound };
+      }
+      if (user.voice) {
+        config.voice = { ...config.voice, ...user.voice };
+      }
+      if (typeof user.minSeconds === 'number') {
+        config.minSeconds = user.minSeconds;
+      }
+    } catch {
+      // ignore malformed config
+    }
+  }
+
+  if (process.env.TELEGRAM_TOKEN) {
+    config.telegram.token = process.env.TELEGRAM_TOKEN;
+  }
+  if (process.env.TELEGRAM_CHAT_ID) {
+    config.telegram.chatId = process.env.TELEGRAM_CHAT_ID;
+  }
+
+  // Per-channel env overrides (0 = off, 1 = on)
+  if (process.env.CLAUDE_NOTIFY_TELEGRAM !== undefined) {
+    config.telegram.enabled = process.env.CLAUDE_NOTIFY_TELEGRAM === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_WINDOWS !== undefined) {
+    config.windowsNotification.enabled = process.env.CLAUDE_NOTIFY_WINDOWS === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_SOUND !== undefined) {
+    config.sound.enabled = process.env.CLAUDE_NOTIFY_SOUND === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_VOICE !== undefined) {
+    config.voice.enabled = process.env.CLAUDE_NOTIFY_VOICE === '1';
+  }
+
+  return config;
+}
+
+// ----------------------
+// PROJECT-LEVEL DISABLE
+// ----------------------
+
+function isNotifierDisabled () {
+  return process.env.DISABLE_CLAUDE_NOTIFIER === '1'
+    || process.env.DISABLE_CLAUDE_NOTIFIER === 'true';
+}
+
+// ----------------------
+// STATE FILE
+// ----------------------
+
+const STATE_FILE = path.join(
+  os.homedir(),
+  '.claude',
+  '.notifier_state.json',
+);
+
+function loadState () {
+  if (fs.existsSync(STATE_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+function saveState (state) {
+  const dir = path.dirname(STATE_FILE);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(STATE_FILE, JSON.stringify(state));
+}
+
+// ----------------------
+// TELEGRAM
+// ----------------------
+
+async function sendTelegram (config, text) {
+  if (!config.telegram.enabled || !config.telegram.token || !config.telegram.chatId) {
+    return;
+  }
+
+  const url =
+    `https://api.telegram.org/bot${config.telegram.token}/sendMessage`;
+
+  try {
+    await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        chat_id: config.telegram.chatId,
+        text,
+      }),
+    });
+  } catch {
+    // silent fail
+  }
+}
+
+// ----------------------
+// WINDOWS NOTIFICATION
+// ----------------------
+
+function sendWindowsNotification (config, message) {
+  if (!config.windowsNotification.enabled) {
+    return;
+  }
+  notifier.notify({
+    title: 'Claude Code',
+    message,
+    sound: true,
+    wait: false,
+  });
+}
+
+// ----------------------
+// SOUND & VOICE
+// ----------------------
+
+function playSound (config) {
+  if (!config.sound.enabled) {
+    return;
+  }
+  try {
+    audio.play(config.sound.file);
+  } catch {
+    // silent fail
+  }
+}
+
+function speakResult (config, duration) {
+  if (!config.voice.enabled) {
+    return;
+  }
+  try {
+    say.speak(`Claude finished coding in ${duration} seconds`);
+  } catch {
+    // silent fail
+  }
+}
+
+// ----------------------
+// READ HOOK INPUT
+// ----------------------
+
+let input = '';
+
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
+
+process.stdin.on('end', async () => {
+  const config = loadConfig();
+
+  let event = {};
+  try {
+    event = JSON.parse(input);
+  } catch {
+    // ignore
+  }
+
+  const eventType = event.hook_event_name || 'unknown';
+  const cwd = event.cwd || process.cwd();
+  const project = path.basename(cwd);
+
+  if (isNotifierDisabled()) {
+    process.exit(0);
+  }
+
+  const state = loadState();
+
+  // ----------------------
+  // START TIMER
+  // ----------------------
+
+  if (eventType === 'UserPromptSubmit') {
+    state.start = Date.now();
+    saveState(state);
+    process.exit(0);
+  }
+
+  // ----------------------
+  // STOP / NOTIFICATION EVENT
+  // ----------------------
+
+  if (eventType !== 'Stop' && eventType !== 'Notification') {
+    process.exit(0);
+  }
+
+  let duration = 0;
+  if (state.start) {
+    duration = Math.round((Date.now() - state.start) / 1000);
+  }
+
+  if (duration < config.minSeconds) {
+    process.exit(0);
+  }
+
+  let status = 'success';
+  if (event.error) {
+    status = 'error';
+  }
+  if (eventType === 'Notification') {
+    status = 'waiting';
+  }
+
+  const message =
+    `Claude finished coding\n\nProject: ${project}\nDuration: ${duration}s\nStatus: ${status}`;
+
+  await sendTelegram(config, `\u{1F916} ${message}`);
+  sendWindowsNotification(config, message);
+  playSound(config);
+  speakResult(config, duration);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "description": "Telegram and Windows notifications for Claude Code task completion",
   "type": "module",
   "engines": {
@@ -39,6 +39,9 @@
     "url": "git+https://github.com/Bazilio-san/claude-notification-plugin.git"
   },
   "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
+  "publishConfig": {
+    "provenance": true
+  },
   "dependencies": {
     "node-notifier": "^10.0.1",
     "play-sound": "^1.1.6",