claude-notification-plugin 1.0.59 → 1.0.65

package/bin/listener-cli.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PID_FILE = path.join(os.homedir(), '.claude', '.listener.pid');
+const LOG_FILE = path.join(os.homedir(), '.claude', '.listener.log');
+const CONFIG_FILE = path.join(os.homedir(), '.claude', 'notifier.config.json');
+const LISTENER_SCRIPT = path.join(__dirname, '..', 'listener', 'listener.js');
+
+const command = process.argv[2];
+
+switch (command) {
+  case 'start':
+    startDaemon();
+    break;
+  case 'stop':
+    stopDaemon();
+    break;
+  case 'status':
+    showStatus();
+    break;
+  case 'logs':
+    showLogs();
+    break;
+  case 'restart':
+    stopDaemon();
+    setTimeout(() => startDaemon(), 1000);
+    break;
+  default:
+    console.log('Usage: claude-notify-listener <start|stop|status|logs|restart>');
+    console.log('');
+    console.log('Commands:');
+    console.log('  start    Start the listener daemon');
+    console.log('  stop     Stop the listener daemon');
+    console.log('  status   Show daemon status');
+    console.log('  logs     Show recent log entries');
+    console.log('  restart  Restart the daemon');
+    process.exit(command ? 1 : 0);
+}
+
+function startDaemon () {
+  // Check if already running
+  const existingPid = readPid();
+  if (existingPid && isProcessAlive(existingPid)) {
+    console.log(`Listener is already running (PID: ${existingPid})`);
+    process.exit(1);
+  }
+
+  // Clean stale PID file
+  if (existingPid) {
+    try {
+      fs.unlinkSync(PID_FILE);
+    } catch {
+      // ignore
+    }
+  }
+
+  // Validate config
+  if (!fs.existsSync(CONFIG_FILE)) {
+    console.error(`Config not found: ${CONFIG_FILE}`);
+    console.error('Run claude-notify-install first, or create the config manually.');
+    process.exit(1);
+  }
+
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+  } catch (err) {
+    console.error(`Invalid config: ${err.message}`);
+    process.exit(1);
+  }
+
+  const token = process.env.CLAUDE_NOTIFY_TELEGRAM_TOKEN || config.telegramToken || config.telegram?.token;
+  const chatId = process.env.CLAUDE_NOTIFY_TELEGRAM_CHAT_ID || config.telegramChatId || config.telegram?.chatId;
+
+  if (!token || !chatId) {
+    console.error('Missing telegramToken or telegramChatId in config.');
+    console.error('These are required for the listener to receive messages.');
+    process.exit(1);
+  }
+
+  if (!config.listener?.projects || Object.keys(config.listener.projects).length === 0) {
+    console.error('No projects defined in config.listener.projects');
+    console.error('');
+    console.error('Add projects to your config:');
+    console.error(JSON.stringify({
+      listener: {
+        projects: {
+          default: { path: '/path/to/your/project' },
+        },
+      },
+    }, null, 2));
+    process.exit(1);
+  }
+
+  // Ensure log directory exists
+  fs.mkdirSync(path.dirname(LOG_FILE), { recursive: true });
+
+  // Open log file for child stdio
+  const logFd = fs.openSync(LOG_FILE, 'a');
+
+  // Spawn detached child
+  const child = spawn(process.execPath, [LISTENER_SCRIPT], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    env: { ...process.env },
+    windowsHide: true,
+  });
+
+  child.unref();
+  fs.closeSync(logFd);
+
+  // Write PID
+  fs.mkdirSync(path.dirname(PID_FILE), { recursive: true });
+  fs.writeFileSync(PID_FILE, String(child.pid));
+
+  console.log(`Listener started (PID: ${child.pid})`);
+  console.log(`Log: ${LOG_FILE}`);
+  console.log(`Projects: ${Object.keys(config.listener.projects).join(', ')}`);
+}
+
+function stopDaemon () {
+  const pid = readPid();
+  if (!pid) {
+    console.log('Listener is not running (no PID file)');
+    return;
+  }
+
+  if (!isProcessAlive(pid)) {
+    console.log(`Listener is not running (stale PID: ${pid})`);
+    cleanPid();
+    return;
+  }
+
+  console.log(`Stopping listener (PID: ${pid})...`);
+
+  try {
+    if (process.platform === 'win32') {
+      execSync(`taskkill /PID ${pid} /T /F`, {
+        stdio: 'ignore',
+        windowsHide: true,
+      });
+    } else {
+      process.kill(pid, 'SIGTERM');
+      // Wait for graceful shutdown
+      let tries = 10;
+      while (tries-- > 0 && isProcessAlive(pid)) {
+        execSync('sleep 0.5', { stdio: 'ignore' });
+      }
+      if (isProcessAlive(pid)) {
+        process.kill(pid, 'SIGKILL');
+      }
+    }
+  } catch {
+    // Process may already be dead
+  }
+
+  cleanPid();
+  console.log('Listener stopped');
+}
+
+function showStatus () {
+  const pid = readPid();
+  if (!pid) {
+    console.log('Status: not running');
+    return;
+  }
+
+  if (!isProcessAlive(pid)) {
+    console.log(`Status: not running (stale PID: ${pid})`);
+    cleanPid();
+    return;
+  }
+
+  console.log(`Status: running (PID: ${pid})`);
+  console.log(`Log: ${LOG_FILE}`);
+
+  // Show last few log lines
+  try {
+    if (fs.existsSync(LOG_FILE)) {
+      const content = fs.readFileSync(LOG_FILE, 'utf-8');
+      const lines = content.trim().split('\n');
+      const last = lines.slice(-5);
+      console.log('\nRecent log:');
+      for (const line of last) {
+        console.log(`  ${line}`);
+      }
+    }
+  } catch {
+    // ignore
+  }
+}
+
+function showLogs () {
+  try {
+    if (!fs.existsSync(LOG_FILE)) {
+      console.log('No log file found');
+      return;
+    }
+    const content = fs.readFileSync(LOG_FILE, 'utf-8');
+    const lines = content.trim().split('\n');
+    const last = lines.slice(-50);
+    for (const line of last) {
+      console.log(line);
+    }
+  } catch (err) {
+    console.error(`Failed to read log: ${err.message}`);
+  }
+}
+
+function readPid () {
+  try {
+    if (fs.existsSync(PID_FILE)) {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim(), 10);
+      return isNaN(pid) ? null : pid;
+    }
+  } catch {
+    // ignore
+  }
+  return null;
+}
+
+function cleanPid () {
+  try {
+    if (fs.existsSync(PID_FILE)) {
+      fs.unlinkSync(PID_FILE);
+    }
+  } catch {
+    // ignore
+  }
+}
+
+function isProcessAlive (pid) {
+  try {
+    if (process.platform === 'win32') {
+      const result = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+        encoding: 'utf-8',
+        windowsHide: true,
+        stdio: ['pipe', 'pipe', 'ignore'],
+      });
+      return result.includes(String(pid));
+    }
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/commands/listener.md

@@ -0,0 +1,100 @@
+---
+description: Manage the Telegram Listener daemon (start, stop, status, logs, restart)
+---
+
+# Listener Management
+
+Manage the Telegram Listener daemon that receives tasks from Telegram and executes them via `claude -p`.
+
+The user invokes this command as `/claude-notification-plugin:listener <action>`.
+
+## Actions
+
+Determine the action from the user's input. If no action is provided, show the help text below and ask which action they want.
+
+### start
+
+Start the listener daemon.
+
+1. Determine the plugin root path — use the directory where this command file lives: `${CLAUDE_PLUGIN_ROOT}`. The listener CLI script is at `${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js`.
+2. Run in a shell:
+   ```bash
+   node "${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js" start
+   ```
+3. Show the output to the user. If it says "Listener started", confirm success. If there is an error (missing config, missing projects, already running), explain what to do.
+
+### stop
+
+Stop the listener daemon.
+
+1. Run:
+   ```bash
+   node "${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js" stop
+   ```
+2. Show the output.
+
+### status
+
+Show the listener status.
+
+1. Run:
+   ```bash
+   node "${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js" status
+   ```
+2. Show the output.
+
+### logs
+
+Show recent log entries.
+
+1. Run:
+   ```bash
+   node "${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js" logs
+   ```
+2. Show the output.
+
+### restart
+
+Restart the listener daemon.
+
+1. Run:
+   ```bash
+   node "${CLAUDE_PLUGIN_ROOT}/bin/listener-cli.js" restart
+   ```
+2. Show the output.
+
+## Help text
+
+If the user doesn't specify an action, show:
+
+```
+Telegram Listener — receives tasks from Telegram and executes via claude -p.
+
+Usage:
+  /claude-notification-plugin:listener start    — Start the daemon
+  /claude-notification-plugin:listener stop     — Stop the daemon
+  /claude-notification-plugin:listener status   — Show status
+  /claude-notification-plugin:listener logs     — Show recent logs
+  /claude-notification-plugin:listener restart  — Restart the daemon
+
+Prerequisites:
+  1. Telegram bot configured (token + chatId in ~/.claude/notifier.config.json)
+  2. "listener.projects" section in config with at least one project
+
+See LISTENER.md for detailed documentation.
+```
+
+## Important
+
+- The `${CLAUDE_PLUGIN_ROOT}` variable resolves to the plugin installation directory. Always use it to build the path to `bin/listener-cli.js`.
+- If the config doesn't have a `listener.projects` section, tell the user to add one and show a minimal example:
+  ```json
+  {
+    "listener": {
+      "projects": {
+        "default": { "path": "/path/to/your/project" }
+      }
+    }
+  }
+  ```
+- If Telegram credentials are missing, suggest running `/claude-notification-plugin:setup` first.